home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1994 March / Source_Code_CD-ROM_Walnut_Creek_March_1994.iso / netsrcs / refer.mac < prev    next >
Encoding:
Internet Message Format  |  1987-03-01  |  39.5 KB
  1. From papowell@umn-cs.UUCP Sat Feb 28 09:58:19 1987
  2. Path: beno!seismo!ut-sally!husc6!uwvax!rutgers!dayton!umn-cs!papowell
  3. From: papowell@umn-cs.UUCP (Patrick Powell)
  4. Newsgroups: comp.arch
  5. Subject: refer macro package
  6. Message-ID: <1346@umn-cs.UUCP>
  7. Date: 28 Feb 87 14:58:19 GMT
  8. Organization: University of Minnesota, Minneapolis
  9. Lines: 1594
  10. Posted: Sat Feb 28 08:58:19 1987
  11.  
  12. #! /bin/sh
  13. # This is a shell archive, meaning:
  14. # 1. Remove everything above the #! /bin/sh line.
  15. # 2. Save the resulting text in a file.
  16. # 3. Execute the file with /bin/sh (not csh) to create:
  17. #    refer.src
  18. #    refer.text
  19. #    tmac.ref.7.tex
  20. #    tmac.refCACM
  21. #    tmac.refDEF
  22. # This archive created: Sat Feb 28 08:55:28 1987
  23. export PATH; PATH=/bin:/usr/bin:$PATH
  24. if test -f 'refer.src'
  25. then
  26.     echo shar: "will not over-write existing file 'refer.src'"
  27. else
  28. cat << \SHAR_EOF > 'refer.src'
  29. .\"        Documentation for Refer macros (October 28, 1982)
  30. .\"        R. Goebel
  31. .\"        Department of Computer Science
  32. .\"        University of Waterloo
  33. .\"        Waterloo, Ontario
  34. .\"        Canada N2L 3G1   (519) 885-1211 x3512
  35. .\"        UUCP: watmath!rggoebel
  36. .\"        ------------------------------------------------
  37. .\"
  38. .\"        To produce hard copies:
  39. .\"
  40. .\"        cd /u/rggoebel/pub/doc
  41. .\"        versatec: make vpr INPUT=refer
  42. .\"        imagen:   make dipr INPUT=refer
  43. .\"        printer:  make hpr INPUT=refer
  44. .\"             ________________________________________________
  45. .\"
  46. .ds nt \fInroff\fR(1)/\fItroff\fR(1)
  47. .ds rf \fIrefer\fR(1)
  48. .RP
  49. .TL
  50. Reference Formatting Macros
  51. .AU
  52. Randy Goebel
  53. .AI
  54. Computer Science Department
  55. University of Waterloo
  56. Waterloo, Ontario
  57. Canada N2L 3G1
  58. .AB
  59. This brief document describes the use of a set of \*(nt macros
  60. for formatting bibliographic entries maintained with the inverted index
  61. utilities described by Lesk.
  62. .[
  63. Lesk 1979
  64. .]
  65. The macros extend the set of ``%'' keys used by Lesk's suite of
  66. programs to provide for a bit more flexibility
  67. in defining and formatting various kinds of bibliographic citations.
  68. It is important to realize that extending the ``%'' key fields for each
  69. bibliographic entry is, in part, a response to the many bugs of the \*(rf
  70. software.
  71. The macros are written to be independent of any existing macro package
  72. (e.g., MS or ME), and can be used alone or together with other macro
  73. packages.
  74. .AE
  75. .SH
  76. Introduction
  77. .PP
  78. The UNIX suite of programs for maintaining and using bibliographic
  79. data is extremely useful,
  80. .[
  81. Lesk 1979
  82. .]
  83. but suffers from at least two difficulties:
  84. 1) the \*(rf program attempts to make inferences about what
  85. kind of bibliographic entry is being cited (e.g., book article,
  86. proceedings article, etc.) but its inferences are frequently wrong.
  87. Its inferences are communicated as integer arguments
  88. to the formatting macros and can thus be ignored.
  89. The macros described herein provide an alternative when 
  90. those inferences are ignored;
  91. 2) the \*(rf program fails to communicate more detailed bibliographic
  92. data to the standard formatting macros,
  93. e.g., multiple editors should be flagged as ``(eds.)'' not ``(ed.)''.
  94. The macros herein were designed to overcome several such difficulties.
  95. .PP
  96. Many of \*(rf's difficulties result from a lack of communication
  97. between the bibliographic data base entry and the formatting macros.
  98. Rather than rewrite \*(rf, the approach taken here is to provide
  99. extra information in each bibliographic entry by extra ``%'' key fields,
  100. and then have the macro definitions use those fields to produce a more
  101. ``accurate'' formatting of the citation.
  102. .SH
  103. Document formats
  104. .PP
  105. Instead of relying on \*(rf
  106. to make the correct inference about the kind of document cited, these macros
  107. .B require
  108. that a ``%l'' entry be associated with each bibliographic data base
  109. entry. The value of the ``%l'' field fixes the document type once and for all,
  110. and is used to determine the final format of any citation of that document.
  111. .PP
  112. Current document types supported are:
  113. .DS
  114. book
  115. journal-article
  116. proceedings-article
  117. book-article
  118. edited-book
  119. edited-proceedings
  120. technical-report
  121. manuscript
  122. dissertation
  123. edited-journal
  124. .DE
  125. .PP
  126. The formatting macros use the ``%l'' field to determine how 
  127. a reference is to be formatted.
  128. If the ``%l'' field is missing or is not one of the
  129. document types named above, the macros will use a default format.
  130. Consider the following example bibliographic entry:
  131. .DS
  132. %A F. Foo
  133. %A B. Bar
  134. %D 1982
  135. %e 2
  136. %J Artificial Insemination
  137. %T Special issue on bull-breeding
  138. %V 11
  139. %N 4
  140. %l edited-journal
  141. .DE
  142. The above document is formatted as follows:
  143. .LP
  144. .in +5
  145. .na
  146. .ds [F Foo82a
  147. .]-
  148. .ds [A Foo, F.
  149. .as [A " and Bar, B.
  150. .ds [D 1982
  151. .ds [e 2
  152. .ds [J Artificial Insemination
  153. .ds [T Special issue on bull-breeding
  154. .ds [V 11
  155. .ds [N 4
  156. .ds [l edited-journal
  157. .nr [T 0
  158. .nr [A 1
  159. .nr [O 0
  160. .][ 1
  161. .in -5
  162. .ad
  163. .LP
  164. If the ``%e'' field is included and is not null, then the formatting
  165. macros will produce ``F. Foo and B. Bar (1982, eds.)'' instead of
  166. ``F. Foo and B. Bar (1982, ed.)''
  167. As with all bibliographic entries, the order of fields is
  168. not important.
  169. .SH
  170. Document formatting details
  171. .PP
  172. The University of Chicago Manual of Style was used as a basic guideline
  173. for the preparation of these macros.
  174. .[
  175. Chicago 1969 A manual of style
  176. .]
  177. Among other things, this means that \*(rf's in-text citation style using
  178. footnotes is
  179. .B not
  180. used; as indicated by the Chicago Manual of Style, citations
  181. in the Natural Sciences normally use the (<author><year>) style of in-text
  182. citation.
  183. The footnote style can be provided by changing the string definitions
  184. for the in-text citation brackets (see below), but the reference listing
  185. will be produced in the same way.
  186. .PP
  187. The use of each field for each document type is given below. 
  188. An asterisk beside a field name indicates a required field.
  189. Note that very few fields are required; the macro for each
  190. format will do its best to provide reasonable output with the
  191. information provided.
  192. .LP
  193. .DS L
  194. .B book
  195. .sp
  196. %A <author(s)>*
  197. %D <year>*
  198. %T <title>*
  199. %V <volume> (appears as ``vol. <volume>'')
  200. %S <series> (include series number if it exists)
  201. %n <edition> (appears as ``edition <edition>'')
  202. %I <publisher>*
  203. %C <city of publication>
  204. %O <optional> (appears within square brackets ``[<optional>]'')
  205. %l book*
  206. .DE
  207. .LP
  208. .DS L
  209. .B journal-article
  210. .sp
  211. %A <author(s)>*
  212. %D <year>*
  213. %T <title>*
  214. %J <journal>*
  215. %V <volume>
  216. %N <number>
  217. %M <month>
  218. %I <publisher>
  219. %C <city of publication>
  220. %P <pages> (i.e., range, e.g., 23-35, or count, e.g., 45 pages)
  221. %O <optional> (appears within square brackets ``[<optional>]'')
  222. %l journal-article*
  223. .DE
  224. .LP
  225. .DS L
  226. .B proceedings-article
  227. .sp
  228. %A <author(s)>*
  229. %D <year>*
  230. %T <title>*
  231. %J <proceedings title>*
  232. %V <volume>
  233. %M <month>
  234. %I <institution> (e.g., name of university, corporation, etc.)
  235. %C <city of conference>
  236. %E <editor(s)> (multiple editors must be given in one field)
  237. %e <editor(s) flag> (non-null flag produces ``(eds.)'' otherwise ``(ed.)'')
  238. %O <optional> (appears within square brackets ``[<optional>]'')
  239. %l proceedings-article*
  240. .DE
  241. .LP
  242. .DS L
  243. .B book-article
  244. .sp
  245. %A <author(s)>*
  246. %D <year>*
  247. %T <title>*
  248. %B <book title>*
  249. %n <edition> (appears as ``edition <edition>'')
  250. %V <volume> (appears as ``vol. <volume>'')
  251. %S <series> (include series number if it exists)
  252. %E <editor(s)> (multiple editors must be given in one field)
  253. %e <editor(s) flag> (non-null flag produces ``(eds.)'' otherwise ``(ed.)'')
  254. %I <publisher>*
  255. %C <city of publication>
  256. %P <pages> (i.e., range, e.g., 23-35, or count, e.g., 45 pages)
  257. %O <optional> (appears within square brackets ``[<optional>]'')
  258. %l book-article*
  259. .DE
  260. .LP
  261. .DS L
  262. .B edited-book
  263. .sp
  264. %A <editor(s)>* (note that multiple entries can appear here)
  265. %e <editor(s) flag> (non-null flag produces ``(eds.)'' otherwise ``(ed.)'')
  266. %D <year>*
  267. %T <title>*
  268. %n <edition> (appears as ``edition <edition>'')
  269. %V <volume> (appears as ``vol. <volume>'')
  270. %S <series> (include series number if it exists)
  271. %I <publisher>*
  272. %C <city of publication>
  273. %O <optional> (appears enclosed within square brackets ``[<optional>]'')
  274. %l edited-book*
  275. .DE
  276. .LP
  277. .DS L
  278. .B edited-proceedings
  279. .sp
  280. %A <editor(s)>* (note that multiple entries can appear here)
  281. %e <editor(s) flag> (non-null flag produces ``(eds.)'' otherwise ``(ed.)'')
  282. %D <year>*
  283. %J <proceedings title>*
  284. %V <volume>
  285. %M <month>
  286. %I <institution> (e.g., name of university, corporation, etc.)
  287. %C <city of conference>
  288. %O <optional> (appears within square brackets ``[<optional>]'')
  289. %l edited-proceedings*
  290. .DE
  291. .LP
  292. .DS L
  293. .B technical-report
  294. .sp
  295. %A <author(s)>*
  296. %D <year>*
  297. %T <title>*
  298. %R <report number>
  299. %S <subdivision>  (e.g., Computer Science Department, Systems Lab, etc.)
  300. %I <institution> (e.g., name of university, corporation, etc.)
  301. %C <city>
  302. %M <month>
  303. %P <pages> (i.e., range, e.g., 23-35, or count, e.g., 45 pages)
  304. %O <optional> (appears enclosed within square brackets ``[<optional>]'')
  305. %l technical-report*
  306. .DE
  307. .LP
  308. .DS L
  309. .B manuscript
  310. .sp
  311. %A <author(s)>*
  312. %D <year>*
  313. %T <title>*
  314. %S <subdivision> (e.g., Computer Science Department, Systems Lab, etc.)
  315. %I <institution> (e.g., name of university, corporation, etc.)
  316. %C <city>
  317. %M <month>
  318. %P <pages> (i.e., range, e.g., 23-35, or count, e.g., 45 pages)
  319. %O <optional> (appears enclosed within square brackets ``[<optional>]'')
  320. %l manuscript*
  321. .DE
  322. .LP
  323. .DS L
  324. .B dissertation
  325. .sp
  326. %A <author>*
  327. %D <year>*
  328. %T <title>*
  329. %Q <level> (e.g., Ph.D., M.Math., D.Sc., etc.)
  330. %S <subdivision> (e.g., Computer Science Department, Systems Lab, etc.)
  331. %I <institution> (e.g., name of university, corporation, etc.)
  332. %C <city>
  333. %M <month>
  334. %P <pages> (i.e., range, e.g., 23-35, or count, e.g., 45 pages)
  335. %O <optional> (appears enclosed within square brackets ``[<optional>]'')
  336. %l dissertation*
  337. .DE
  338. .LP
  339. .DS L
  340. .B edited-journal
  341. .sp
  342. %A <editor(s)>* (note that multiple entries can appear here)
  343. %e <editor(s) flag> (non-null flag produces ``(eds.)'' otherwise ``(ed.)'')
  344. %D <year>*
  345. %T <title>* (e.g., special issue title)
  346. %J <journal>*
  347. %V <volume>
  348. %N <number>
  349. %M <month>
  350. %I <publisher>
  351. %C <city of publication>
  352. %O <optional> (appears enclosed within square brackets ``[<optional>]'')
  353. %l edited-journal*
  354. .DE
  355. .SH
  356. User options
  357. .PP
  358. As with the standard set of \*(rf macros, the user can redefine a few
  359. macros and strings to customize his in-text citation format and 
  360. reference listing.
  361. The following macro definition is used at the beginning of each reference
  362. in the reference list:
  363. .LP
  364. .DS
  365. \\.de rF 
  366. \\.ne 4
  367. \\.ti -5
  368. [\\\\\\\\*([F]
  369. \\.br
  370. \\..
  371. .DE
  372. .LP
  373. The ``rF'' macro works in conjunction with the following two macros, called
  374. at the beginning and end (respectively) of the collected list of references:
  375. .LP
  376. .DS
  377. \\.de ]<
  378. \\.ft R
  379. \\.ls 1
  380. \\.in 5
  381. \\.sp 2
  382. \\.na
  383. \\..
  384.  
  385. \\.de ]>
  386. \\.ft P
  387. \\.ad
  388. \\.in 0
  389. \\.sp 2
  390. \\..
  391. .DE
  392. .LP
  393. In the reference list, the indenting of each reference can be 
  394. changed by replacing the definitions of the above macros.
  395. .PP
  396. The \*(rf software constructs an \*(nt string ``[F'' to be used as
  397. the in-text citation for each document cited. 
  398. The contents of this string is controlled by \*(rf command line
  399. parameters,
  400. .[
  401. Lesk 1979
  402. .]
  403. and can be adjusted by the user.
  404. The in-text citation brackets are defined as
  405. .LP
  406. .DS
  407. \\.ds [. " [
  408. \\.ds .] ]
  409. .DE
  410. The first definition is expanded before the in-text citation is formatted,
  411. and the latter definition is expanded just after.
  412. Thus, the default in-text citation is a blank, a left square bracket,
  413. the string value of ``[F'' followed by a right square bracket.
  414. These bracketing strings can be redefined by the user,
  415. e.g., to produce in-text citations as footnotes.
  416. .PP
  417. The following string definitions control the positioning
  418. of punctuation:
  419. .LP
  420. .DS
  421. \\.ds >. .
  422. \\.ds <. \&
  423. \\.ds >, ,
  424. \\.ds <, \&
  425. \\.ds >; ;
  426. \\.ds <; \&
  427. \\.ds >: :
  428. \\.ds <: \&
  429. .DE
  430. The above definitions will position all punctuation after the in-text
  431. citation.
  432. .SH
  433. References
  434. .LP
  435. .[
  436. $LIST$
  437. .]
  438. _____________________
  439. .TH TMAC.REF 7 "Waterloo"
  440. .\"        Programmer's Manual entry for Refer macros (September 17, 1983)
  441. .\"        R. Goebel
  442. .\"        Department of Computer Science
  443. .\"        University of Waterloo
  444. .\"        Waterloo, Ontario
  445. .\"        Canada N2L 3G1   (519) 885-1211 x3512
  446. .\"        UUCP: watmath!rggoebel
  447. .\"        ------------------------------------------------
  448. .\"
  449. .\"        To produce hard copies (at UWaterloo):
  450. .\"
  451. .\"        versatec: vtroff -man /u/rggoebel/pub/doc/tmac.ref.7
  452. .\"        imagen:   ditroff -man /u/rggoebel/pub/doc/tmac.ref.7 | dcan
  453. .\"        printer:  nroff -man -Tlpr /u/rggoebel/pub/doc/tmac.ref.7
  454. .\"             ________________________________________________
  455. .\"
  456. .ds nt \fInroff\fR(1)/\fItroff\fR(1)
  457. .ds rf \fIrefer\fR(1)
  458. .SH NAME
  459. .B tmac.ref
  460. \- a family of macros for formatting \fIrefer\fR(1) output.
  461. .SH SYNOPSIS
  462. Include the \*(nt command
  463. .br
  464. .B "    .so /u/rggoebel/pub/src/tmac.ref\c"
  465. <style>
  466. .br
  467. in <sourcefile> and use the commands
  468. .br
  469. .B "    refer"
  470. [options]\ <sourcefile>
  471. .B "| nroff"
  472. [options]\ ...
  473. .br
  474. .B "    refer"
  475. [options]\ <sourcefile>
  476. .B "| troff"
  477. [options]\ ...
  478. .SH DESCRIPTION
  479. .PP
  480. This package of \*(nt macro definitions will format the reference
  481. citation strings produced by the \*(nt preprocessor \*(rf.
  482. The macros are compatible with the
  483. .IR ms (7)
  484. and
  485. .IR me (7)
  486. macro packages.
  487. The currently available options for <style> are:
  488. .TP
  489. DEF
  490. .B ".so /u/rggoebel/pub/src/tmac.refDEF"
  491. .br
  492. to format each reference in the default style.
  493. .TP
  494. CACM
  495. .B ".so /u/rggoebel/pub/src/tmac.refCACM"
  496. .br
  497. with the \*(rf command line options
  498. .B "-a -s"
  499. for ACM Communications format.
  500. .SH FILES
  501. /u/rggoebel/pub/src/tmac.refDEF
  502. .br
  503. /u/rggoebel/pub/src/tmac.refCACM
  504. .SH "SEE ALSO"
  505. .nf
  506. /u/rggoebel/pub/doc/refer.text    documentation for alternative macros
  507. /u/rggoebel/pub/doc/addbib.1.text    update bibliographic databases
  508. /u/rggoebel/pub/doc/indxbib.1.text    create inverted indices
  509. /u/rggoebel/pub/doc/sortbib.1.text    sort bibiographic databases
  510. /u/rggoebel/pub/doc/roffbib.1.text    print bibilographic databases
  511. .fi
  512. .SH DIAGNOSTICS
  513. Each <style> will remind the user of any required \*(rf command line
  514. options.
  515. .SH AUTHOR
  516. Randy Goebel, Department of Computer Science, University of Waterloo,
  517. Waterloo, Ontario, Canada, N2L 3G1, (519) 885-1211 (x3512),
  518. UUCP: watmath!rggoebel.
  519. ------------------
  520. Notice that the latter uses -man, and the former users -ms
  521.  
  522.  
  523. Randy
  524.  
  525. SHAR_EOF
  526. fi
  527. if test -f 'refer.text'
  528. then
  529.     echo shar: "will not over-write existing file 'refer.text'"
  530. else
  531. cat << \SHAR_EOF > 'refer.text'
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.                              Reference Formatting Macros
  542.  
  543.  
  544.                                     Randy Goebel
  545.  
  546.                              Computer Science Department
  547.                                University of Waterloo
  548.                                   Waterloo, Ontario
  549.                                    Canada N2L 3G1
  550.  
  551.  
  552.  
  553.                                       _A_B_S_T_R_A_C_T
  554.  
  555.                     This brief document describes the use of a set  of
  556.                _n_r_o_f_f(1)/_t_r_o_f_f(1)  macros  for formatting bibliographic
  557.                entries maintained with the  inverted  index  utilities
  558.                described by Lesk [Lesk79a].  The macros extend the set
  559.                of ``%'' keys used by Lesk's suite of programs to  pro-
  560.                vide for a bit more flexibility in defining and format-
  561.                ting various kinds of bibliographic citations.   It  is
  562.                important  to  realize  that  extending  the  ``%'' key
  563.                fields for each bibliographic  entry  is,  in  part,  a
  564.                response  to  the  many  bugs of the _r_e_f_e_r(1) software.
  565.                The macros are written to be independent of any  exist-
  566.                ing  macro  package  (e.g.,  MS or ME), and can be used
  567.                alone or together with other macro packages.
  568.  
  569.  
  570.  
  571.           September 20, 1983
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.                              Reference Formatting Macros
  608.  
  609.  
  610.                                     Randy Goebel
  611.  
  612.                              Computer Science Department
  613.                                University of Waterloo
  614.                                   Waterloo, Ontario
  615.                                    Canada N2L 3G1
  616.  
  617.  
  618.  
  619.           _I_n_t_r_o_d_u_c_t_i_o_n
  620.  
  621.                The UNIX suite of programs for maintaining and using biblio-
  622.           graphic  data  is extremely useful [Lesk79a], but suffers from at
  623.           least two difficulties: 1) the _r_e_f_e_r(1) program attempts to  make
  624.           inferences  about what kind of bibliographic entry is being cited
  625.           (e.g., book article, proceedings article, etc.)  but  its  infer-
  626.           ences  are  frequently wrong.  Its inferences are communicated as
  627.           integer arguments to  the  formatting  macros  and  can  thus  be
  628.           ignored.  The macros described herein provide an alternative when
  629.           those inferences are ignored; 2) the _r_e_f_e_r(1)  program  fails  to
  630.           communicate more detailed bibliographic data to the standard for-
  631.           matting macros, e.g.,  multiple  editors  should  be  flagged  as
  632.           ``(eds.)''  not  ``(ed.)''.   The  macros herein were designed to
  633.           overcome several such difficulties.
  634.  
  635.                Many of _r_e_f_e_r(1)'s difficulties result from a lack  of  com-
  636.           munication between the bibliographic data base entry and the for-
  637.           matting macros.  Rather than rewrite _r_e_f_e_r(1), the approach taken
  638.           here  is to provide extra information in each bibliographic entry
  639.           by extra ``%'' key fields, and then have  the  macro  definitions
  640.           use those fields to produce a more ``accurate'' formatting of the
  641.           citation.
  642.  
  643.           _D_o_c_u_m_e_n_t _f_o_r_m_a_t_s
  644.  
  645.                Instead of relying on _r_e_f_e_r(1) to make the correct inference
  646.           about  the  kind  of  document cited, these macros _r_e_q_u_i_r_e that a
  647.           ``%l'' entry be associated  with  each  bibliographic  data  base
  648.           entry. The value of the ``%l'' field fixes the document type once
  649.           and for all, and is used to determine the  final  format  of  any
  650.           citation of that document.
  651.  
  652.                Current document types supported are:
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.                                  September 20, 1983
  662.  
  663.  
  664.  
  665.  
  666.  
  667.                                         - 2 -
  668.  
  669.  
  670.                   book
  671.                   journal-article
  672.                   proceedings-article
  673.                   book-article
  674.                   edited-book
  675.                   edited-proceedings
  676.                   technical-report
  677.                   manuscript
  678.                   dissertation
  679.                   edited-journal
  680.  
  681.  
  682.                The formatting macros use the ``%l'' field to determine  how
  683.           a  reference  is to be formatted.  If the ``%l'' field is missing
  684.           or is not one of the document types named above, the macros  will
  685.           use  a  default  format.   Consider the following example biblio-
  686.           graphic entry:
  687.  
  688.                   %A F. Foo
  689.                   %A B. Bar
  690.                   %D 1982
  691.                   %e 2
  692.                   %J Artificial Insemination
  693.                   %T Special issue on bull-breeding
  694.                   %V 11
  695.                   %N 4
  696.                   %l edited-journal
  697.  
  698.           The above document is formatted as follows:
  699.  
  700.           [Foo82a]
  701.                Foo, F. and Bar, B. (1982, eds.), Special issue on bull-
  702.                breeding, _A_r_t_i_f_i_c_i_a_l _I_n_s_e_m_i_n_a_t_i_o_n 11(4).
  703.  
  704.           If the ``%e'' field is included and is not null, then the format-
  705.           ting  macros  will  produce  ``F.  Foo  and B. Bar (1982, eds.)''
  706.           instead of ``F. Foo and B. Bar (1982, ed.)'' As with all  biblio-
  707.           graphic entries, the order of fields is not important.
  708.  
  709.           _D_o_c_u_m_e_n_t _f_o_r_m_a_t_t_i_n_g _d_e_t_a_i_l_s
  710.  
  711.                The University of Chicago Manual of  Style  was  used  as  a
  712.           basic guideline for the preparation of these macros [Chicago69a].
  713.           Among other things, this means that _r_e_f_e_r(1)'s  in-text  citation
  714.           style  using  footnotes  is _n_o_t used; as indicated by the Chicago
  715.           Manual of Style, citations in the Natural Sciences  normally  use
  716.           the  (<author><year>)  style  of  in-text citation.  The footnote
  717.           style can be provided by changing the string definitions for  the
  718.           in-text  citation brackets (see below), but the reference listing
  719.           will be produced in the same way.
  720.  
  721.                The use of each field for each document type is given below.
  722.           An asterisk beside a field name indicates a required field.  Note
  723.           that very few fields are required; the macro for each format will
  724.  
  725.  
  726.  
  727.                                  September 20, 1983
  728.  
  729.  
  730.  
  731.  
  732.  
  733.                                         - 3 -
  734.  
  735.  
  736.           do  its  best  to  provide reasonable output with the information
  737.           provided.
  738.  
  739.  
  740.           _b_o_o_k
  741.  
  742.           %A <author(s)>*
  743.           %D <year>*
  744.           %T <title>*
  745.           %V <volume> (appears as ``vol. <volume>'')
  746.           %S <series> (include series number if it exists)
  747.           %n <edition> (appears as ``edition <edition>'')
  748.           %I <publisher>*
  749.           %C <city of publication>
  750.           %O <optional> (appears within square brackets ``[<optional>]'')
  751.           %l book*
  752.  
  753.  
  754.  
  755.           _j_o_u_r_n_a_l-_a_r_t_i_c_l_e
  756.  
  757.           %A <author(s)>*
  758.           %D <year>*
  759.           %T <title>*
  760.           %J <journal>*
  761.           %V <volume>
  762.           %N <number>
  763.           %M <month>
  764.           %I <publisher>
  765.           %C <city of publication>
  766.           %P <pages> (i.e., range, e.g., 23-35, or count, e.g., 45 pages)
  767.           %O <optional> (appears within square brackets ``[<optional>]'')
  768.           %l journal-article*
  769.  
  770.  
  771.  
  772.           _p_r_o_c_e_e_d_i_n_g_s-_a_r_t_i_c_l_e
  773.  
  774.           %A <author(s)>*
  775.           %D <year>*
  776.           %T <title>*
  777.           %J <proceedings title>*
  778.           %V <volume>
  779.           %M <month>
  780.           %I <institution> (e.g., name of university, corporation, etc.)
  781.           %C <city of conference>
  782.           %E <editor(s)> (multiple editors must be given in one field)
  783.           %e <editor(s) flag> (non-null flag produces ``(eds.)'' otherwise ``(ed.)'')
  784.           %O <optional> (appears within square brackets ``[<optional>]'')
  785.           %l proceedings-article*
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.                                  September 20, 1983
  794.  
  795.  
  796.  
  797.  
  798.  
  799.                                         - 4 -
  800.  
  801.  
  802.           _b_o_o_k-_a_r_t_i_c_l_e
  803.  
  804.           %A <author(s)>*
  805.           %D <year>*
  806.           %T <title>*
  807.           %B <book title>*
  808.           %n <edition> (appears as ``edition <edition>'')
  809.           %V <volume> (appears as ``vol. <volume>'')
  810.           %S <series> (include series number if it exists)
  811.           %E <editor(s)> (multiple editors must be given in one field)
  812.           %e <editor(s) flag> (non-null flag produces ``(eds.)'' otherwise ``(ed.)'')
  813.           %I <publisher>*
  814.           %C <city of publication>
  815.           %P <pages> (i.e., range, e.g., 23-35, or count, e.g., 45 pages)
  816.           %O <optional> (appears within square brackets ``[<optional>]'')
  817.           %l book-article*
  818.  
  819.  
  820.  
  821.           _e_d_i_t_e_d-_b_o_o_k
  822.  
  823.           %A <editor(s)>* (note that multiple entries can appear here)
  824.           %e <editor(s) flag> (non-null flag produces ``(eds.)'' otherwise ``(ed.)'')
  825.           %D <year>*
  826.           %T <title>*
  827.           %n <edition> (appears as ``edition <edition>'')
  828.           %V <volume> (appears as ``vol. <volume>'')
  829.           %S <series> (include series number if it exists)
  830.           %I <publisher>*
  831.           %C <city of publication>
  832.           %O <optional> (appears enclosed within square brackets ``[<optional>]'')
  833.           %l edited-book*
  834.  
  835.  
  836.  
  837.           _e_d_i_t_e_d-_p_r_o_c_e_e_d_i_n_g_s
  838.  
  839.           %A <editor(s)>* (note that multiple entries can appear here)
  840.           %e <editor(s) flag> (non-null flag produces ``(eds.)'' otherwise ``(ed.)'')
  841.           %D <year>*
  842.           %J <proceedings title>*
  843.           %V <volume>
  844.           %M <month>
  845.           %I <institution> (e.g., name of university, corporation, etc.)
  846.           %C <city of conference>
  847.           %O <optional> (appears within square brackets ``[<optional>]'')
  848.           %l edited-proceedings*
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.                                  September 20, 1983
  860.  
  861.  
  862.  
  863.  
  864.  
  865.                                         - 5 -
  866.  
  867.  
  868.           _t_e_c_h_n_i_c_a_l-_r_e_p_o_r_t
  869.  
  870.           %A <author(s)>*
  871.           %D <year>*
  872.           %T <title>*
  873.           %R <report number>
  874.           %S <subdivision>  (e.g., Computer Science Department, Systems Lab, etc.)
  875.           %I <institution> (e.g., name of university, corporation, etc.)
  876.           %C <city>
  877.           %M <month>
  878.           %P <pages> (i.e., range, e.g., 23-35, or count, e.g., 45 pages)
  879.           %O <optional> (appears enclosed within square brackets ``[<optional>]'')
  880.           %l technical-report*
  881.  
  882.  
  883.  
  884.           _m_a_n_u_s_c_r_i_p_t
  885.  
  886.           %A <author(s)>*
  887.           %D <year>*
  888.           %T <title>*
  889.           %S <subdivision> (e.g., Computer Science Department, Systems Lab, etc.)
  890.           %I <institution> (e.g., name of university, corporation, etc.)
  891.           %C <city>
  892.           %M <month>
  893.           %P <pages> (i.e., range, e.g., 23-35, or count, e.g., 45 pages)
  894.           %O <optional> (appears enclosed within square brackets ``[<optional>]'')
  895.           %l manuscript*
  896.  
  897.  
  898.  
  899.           _d_i_s_s_e_r_t_a_t_i_o_n
  900.  
  901.           %A <author>*
  902.           %D <year>*
  903.           %T <title>*
  904.           %Q <level> (e.g., Ph.D., M.Math., D.Sc., etc.)
  905.           %S <subdivision> (e.g., Computer Science Department, Systems Lab, etc.)
  906.           %I <institution> (e.g., name of university, corporation, etc.)
  907.           %C <city>
  908.           %M <month>
  909.           %P <pages> (i.e., range, e.g., 23-35, or count, e.g., 45 pages)
  910.           %O <optional> (appears enclosed within square brackets ``[<optional>]'')
  911.           %l dissertation*
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.                                  September 20, 1983
  926.  
  927.  
  928.  
  929.  
  930.  
  931.                                         - 6 -
  932.  
  933.  
  934.           _e_d_i_t_e_d-_j_o_u_r_n_a_l
  935.  
  936.           %A <editor(s)>* (note that multiple entries can appear here)
  937.           %e <editor(s) flag> (non-null flag produces ``(eds.)'' otherwise ``(ed.)'')
  938.           %D <year>*
  939.           %T <title>* (e.g., special issue title)
  940.           %J <journal>*
  941.           %V <volume>
  942.           %N <number>
  943.           %M <month>
  944.           %I <publisher>
  945.           %C <city of publication>
  946.           %O <optional> (appears enclosed within square brackets ``[<optional>]'')
  947.           %l edited-journal*
  948.  
  949.  
  950.           _U_s_e_r _o_p_t_i_o_n_s
  951.  
  952.                As with the standard set of _r_e_f_e_r(1) macros,  the  user  can
  953.           redefine  a few macros and strings to customize his in-text cita-
  954.           tion format and reference listing.  The following  macro  defini-
  955.           tion  is used at the beginning of each reference in the reference
  956.           list:
  957.  
  958.  
  959.                   .de rF
  960.                   .ne 4
  961.                   .ti -5
  962.                   [\\*([F]
  963.                   .br
  964.                   ..
  965.  
  966.  
  967.           The ``rF'' macro works in conjunction with the following two mac-
  968.           ros,  called  at the beginning and end (respectively) of the col-
  969.           lected list of references:
  970.  
  971.  
  972.                   .de ]<
  973.                   .ft R
  974.                   .ls 1
  975.                   .in 5
  976.                   .sp 2
  977.                   .na
  978.                   ..
  979.  
  980.                   .de ]>
  981.                   .ft P
  982.                   .ad
  983.                   .in 0
  984.                   .sp 2
  985.                   ..
  986.  
  987.  
  988.  
  989.  
  990.  
  991.                                  September 20, 1983
  992.  
  993.  
  994.  
  995.  
  996.  
  997.                                         - 7 -
  998.  
  999.  
  1000.           In the reference list, the indenting of  each  reference  can  be
  1001.           changed by replacing the definitions of the above macros.
  1002.  
  1003.                The _r_e_f_e_r(1) software constructs an _n_r_o_f_f(1)/_t_r_o_f_f(1) string
  1004.           ``[F''  to  be  used  as  the  in-text citation for each document
  1005.           cited. The contents of this string is controlled by _r_e_f_e_r(1) com-
  1006.           mand  line parameters [Lesk79a], and can be adjusted by the user.
  1007.           The in-text citation brackets are defined as
  1008.  
  1009.  
  1010.                   .ds [. " [
  1011.                   .ds .] ]
  1012.  
  1013.           The first definition is expanded before the in-text  citation  is
  1014.           formatted,  and  the  latter  definition  is expanded just after.
  1015.           Thus, the default in-text citation is  a  blank,  a  left  square
  1016.           bracket,  the  string  value of ``[F'' followed by a right square
  1017.           bracket.  These bracketing strings can be redefined by the  user,
  1018.           e.g., to produce in-text citations as footnotes.
  1019.  
  1020.                The following string definitions control the positioning  of
  1021.           punctuation:
  1022.  
  1023.  
  1024.                   .ds >. .
  1025.                   .ds <.
  1026.                   .ds >, ,
  1027.                   .ds <,
  1028.                   .ds >; ;
  1029.                   .ds <;
  1030.                   .ds >: :
  1031.                   .ds <:
  1032.  
  1033.           The above definitions will position  all  punctuation  after  the
  1034.           in-text citation.
  1035.  
  1036.           _R_e_f_e_r_e_n_c_e_s
  1037.  
  1038.  
  1039.  
  1040.           [Chicago69a]
  1041.                University of Chicago (1969), _A _M_a_n_u_a_l _o_f _S_t_y_l_e, edition 12,
  1042.                University of Chicago Press, Chicago, Illinois.
  1043.           [Lesk79a]
  1044.                M.E. Lesk (1979), Some applications of inverted indexes on
  1045.                the UNIX system, _U_N_I_X _P_r_o_g_r_a_m_m_e_r_s _M_a_n_u_a_l, edition 7,
  1046.                vol. 2A, .
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.                                  September 20, 1983
  1058.  
  1059.  
  1060. SHAR_EOF
  1061. chmod +x 'refer.text'
  1062. fi
  1063. if test -f 'tmac.ref.7.tex'
  1064. then
  1065.     echo shar: "will not over-write existing file 'tmac.ref.7.tex'"
  1066. else
  1067. cat << \SHAR_EOF > 'tmac.ref.7.tex'
  1068.  
  1069.  
  1070.  
  1071. TMAC.REF(7)         UNIX Programmer's Manual          TMAC.REF(7)
  1072.  
  1073.  
  1074.  
  1075. NAME
  1076.      tmac.ref - a family of macros for formatting _r_e_f_e_r(1) out-
  1077.      put.
  1078.  
  1079. SYNOPSIS
  1080.      Include the _n_r_o_f_f(1)/_t_r_o_f_f(1) command
  1081.           .so /u/rggoebel/pub/src/tmac.ref<style>
  1082.      in <sourcefile> and use the commands
  1083.           refer [options] <sourcefile> | nroff [options] ...
  1084.           refer [options] <sourcefile> | troff [options] ...
  1085.  
  1086. DESCRIPTION
  1087.      This package of _n_r_o_f_f(1)/_t_r_o_f_f(1) macro definitions will
  1088.      format the reference citation strings produced by the
  1089.      _n_r_o_f_f(1)/_t_r_o_f_f(1) preprocessor _r_e_f_e_r(1).  The macros are
  1090.      compatible with the _m_s(7) and _m_e(7) macro packages.  The
  1091.      currently available options for <style> are:
  1092.  
  1093.      DEF  .so /u/rggoebel/pub/src/tmac.refDEF
  1094.           to format each reference in the default style.
  1095.  
  1096.      CACM .so /u/rggoebel/pub/src/tmac.refCACM
  1097.           with the _r_e_f_e_r(1) command line options -a -s for ACM
  1098.           Communications format.
  1099.  
  1100. FILES
  1101.      /u/rggoebel/pub/src/tmac.refDEF
  1102.      /u/rggoebel/pub/src/tmac.refCACM
  1103.  
  1104. SEE ALSO
  1105.      /u/rggoebel/pub/doc/refer.text     documentation for alternative macros
  1106.      /u/rggoebel/pub/doc/addbib.1.text  update bibliographic databases
  1107.      /u/rggoebel/pub/doc/indxbib.1.text create inverted indices
  1108.      /u/rggoebel/pub/doc/sortbib.1.text sort bibiographic databases
  1109.      /u/rggoebel/pub/doc/roffbib.1.text print bibilographic databases
  1110.  
  1111. DIAGNOSTICS
  1112.      Each <style> will remind the user of any required _r_e_f_e_r(1)
  1113.      command line options.
  1114.  
  1115. AUTHOR
  1116.      Randy Goebel, Department of Computer Science, University of
  1117.      Waterloo, Waterloo, Ontario, Canada, N2L 3G1, (519) 885-1211
  1118.      (x3512), UUCP: watmath!rggoebel.
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130. Printed 9/18/83             Waterloo                            1
  1131.  
  1132.  
  1133.  
  1134. SHAR_EOF
  1135. chmod +x 'tmac.ref.7.tex'
  1136. fi
  1137. if test -f 'tmac.refCACM'
  1138. then
  1139.     echo shar: "will not over-write existing file 'tmac.refCACM'"
  1140. else
  1141. cat << \SHAR_EOF > 'tmac.refCACM'
  1142. .\"        Refer Macros, ACM Communications format
  1143. .\"        R. Goebel, September 20, 1983
  1144. .\"        Test version: report bugs to rggoebel
  1145. .\"        Documentation:    /u/rggoebel/pub/doc/refer.text
  1146. .\"                /u/rggoebel/pub/doc/tmac.ref.7.text
  1147. .\"             ________________________________________________
  1148. .\"
  1149. .\"        Inform user about required Refer options
  1150. .\"
  1151. .tm CACM format: requires Refer options "-a -s"
  1152. .\"
  1153. .\"        reference format selection macro
  1154. .\"        notice last entry is default format
  1155. .de ][
  1156. .ie \\*([lbook .[0
  1157. .el .ie \\*([ljournal-article .[1
  1158. .el .ie \\*([lproceedings-article .[2
  1159. .el .ie \\*([lbook-article .[3
  1160. .el .ie \\*([ledited-book .[4
  1161. .el .ie \\*([ledited-proceedings .[5
  1162. .el .ie \\*([ltechnical-report .[6
  1163. .el .ie \\*([lmanuscript .[7
  1164. .el .ie \\*([ldissertation .[8
  1165. .el .ie \\*([ledited-journal .[9
  1166. .el .[d
  1167. ..
  1168. .\"        placement of in text citation
  1169. .de rF
  1170. .ne 4
  1171. \f3\\*([F\f1.
  1172. .
  1173. .\"        punctuation definition
  1174. .ds >. .
  1175. .ds <. \&
  1176. .ds >, ,
  1177. .ds <, \&
  1178. .ds >; ;
  1179. .ds <; \&
  1180. .ds >: :
  1181. .ds <: \&
  1182. .\"        in-text citation brackets
  1183. .ds [.  [
  1184. .ds .] ]
  1185. .\"        reference list initialization macro
  1186. .de ]<
  1187. .ft R
  1188. .ls 1
  1189. .na
  1190. .sp
  1191. ..
  1192. .\"        reference list termination macro
  1193. .de ]>
  1194. .ft P
  1195. .ad
  1196. ..
  1197. .\"        string definition reset macro
  1198. .de ]-
  1199. .rm [V [P [A [T [N [C [B [O [R [I [E [D [L [J [S [M [l [e [n [c
  1200. ..
  1201. .de [0        \" book format
  1202. .rF
  1203. \\*([A\&
  1204. \\f2\\*([T\\f1\c
  1205. .if !\\*([n , \\f2edition \\*([n\\f1\c
  1206. .if !\\*([S , \\f2\\*([S\\f1\c
  1207. .if !\\*([V , \\f2vol.\ \\*([V\\f1\c
  1208. , \\*([I\c
  1209. .if !\\*([C , \\*([C\c
  1210. , \\*([D\c
  1211. .ie \\*([O \&.
  1212. .el \& [\\*([O].
  1213. ..
  1214. .de [1        \" journal-article format
  1215. .rF
  1216. \\*([A\&
  1217. \\*([T,
  1218. \\f2\\*([J\\f1
  1219. .if !\\*([V \\f2\\*([V\\f1\c
  1220. .if !\\*([N , \\*([N
  1221. .ie !\\*([M , (\\*([M \\*([D),
  1222. .el (\\*([D),
  1223. .if !\\*([P , \\*([P\c
  1224. .ie \\*([O \&.
  1225. .el \& [\\*([O].
  1226. ..
  1227. .de [2        \" proceedings-article format
  1228. .rF
  1229. \\*([A\&
  1230. \\*([T,
  1231. \\f2\\*([J\\f1\c
  1232. .if !\\*([V \& \\f2\\*([V\\f1\c
  1233. .if !\\*([M , \\*([M\c
  1234. , \\*([D\c
  1235. .if !\\*([I , \\*([I\c
  1236. .if !\\*([C , \\*([C\c
  1237. .if !\\*([E \{\
  1238. , \\*([E
  1239. .ie !\\*([e (eds.)\c
  1240. .el (ed.)\c
  1241. .\}
  1242. .if !\\*([P , \\*([P\c
  1243. .ie \\*([O \&.
  1244. .el \& [\\*([O].
  1245. ..
  1246. .de [3        \" book-article format
  1247. .rF
  1248. \\*([A\&
  1249. \\*([T,
  1250. \\f2\\*([B\\f1\c
  1251. .if !\\*([n , \\f2edition \\*([n\\f1\c
  1252. .if !\\*([S , \\f2\\*([S\\f1\c
  1253. .if !\\*([V , \\f2vol.\ \\*([V\\f1\c
  1254. .if !\\*([E \{\
  1255. , \\*([E
  1256. .ie !\\*([e (eds.)\c
  1257. .el (ed.)\c\}
  1258. , \\*([I\c
  1259. .if !\\*([C , \\*([C\c
  1260. , \\*([D
  1261. .if !\\*([P , \\*([P\c
  1262. .ie \\*([O \&.
  1263. .el \& [\\*([O].
  1264. ..
  1265. .de [4        \" edited-book format
  1266. .rF
  1267. \\*([A\&
  1268. .ie \\*([e (ed.).\&
  1269. .el (eds.).\&
  1270. \\f2\\*([T\\f1\c
  1271. .if !\\*([n , \\f2edition \\*([n\\f1\c
  1272. .if !\\*([S , \\f2\\*([S\\f1\c
  1273. .if !\\*([V , \\f2vol.\ \\*([V\\f1\c
  1274. , \\*([I\c
  1275. .if !\\*([C , \\*([C\c
  1276. , \\*([D\c
  1277. .ie \\*([O \&.
  1278. .el \& [\\*([O].
  1279. ..
  1280. .de [5        \" edited-proceedings format
  1281. .rF
  1282. \\*([A\&
  1283. .ie \\*([e (ed.).\&
  1284. .el (eds.).\&
  1285. \\f2\\*([J\\f1\c
  1286. .if !\\*([V \& \\f2\\*([V\\f1\c
  1287. .if !\\*([M , \\*([M\c
  1288. , \\*([D\c
  1289. .if !\\*([I , \\*([I\c
  1290. .if !\\*([C , \\*([C\c
  1291. .ie \\*([O \&.
  1292. .el \& [\\*([O].
  1293. ..
  1294. .de [6        \" technical-report format
  1295. .rF
  1296. \\*([A\&
  1297. \\*([T\c
  1298. .if !\\*([R , \\*([R\c
  1299. .if !\\*([S , \\*([S\c
  1300. .if !\\*([I , \\*([I\c
  1301. .if !\\*([C , \\*([C\c
  1302. .if !\\*([M , \\*([M\c
  1303. , \\*([D\c
  1304. .if !\\*([P , \\*([P\c
  1305. .ie \\*([O \&.
  1306. .el \& [\\*([O].
  1307. ..
  1308. .de [7        \" manuscript format
  1309. .rF
  1310. \\*([A\&
  1311. \\*([T\c
  1312. .if !\\*([S , \\*([S\c
  1313. .if !\\*([I , \\*([I\c
  1314. .if !\\*([C , \\*([C\c
  1315. .if !\\*([M , \\*([M\c
  1316. , \\*([D\c
  1317. .if !\\*([P , \\*([P\c
  1318. .ie \\*([O \&.
  1319. .el \& [\\*([O].
  1320. ..
  1321. .de [8        \" dissertation format
  1322. .rF
  1323. \\*([A\&
  1324. \\*([T\c
  1325. .if !\\*([Q , \\*([Q dissertation\c
  1326. .if !\\*([S , \\*([S\c
  1327. .if !\\*([I , \\*([I\c
  1328. .if !\\*([C , \\*([C\c
  1329. .if !\\*([M , \\*([M\c
  1330. , \\*([D\c
  1331. .if !\\*([P , \\*([P\c
  1332. .ie \\*([O \&.
  1333. .el \& [\\*([O].
  1334. ..
  1335. .de [9        \" edited-journal
  1336. .rF
  1337. \\*([A\&
  1338. .ie \\*([e (ed.).
  1339. .el (eds.).
  1340. \\*([T,
  1341. \\f2\\*([J\\f1
  1342. .if !\\*([V \\f2\\*([V\\f1\c
  1343. .if !\\*([N , \\*([N
  1344. .ie !\\*([M , (\\*([M \\*([D),
  1345. .el (\\*([D),
  1346. .if !\\*([P , \\*([P\c
  1347. .ie \\*([O \&.
  1348. .el \& [\\*([O].
  1349. ..
  1350. .de [d        \" default format
  1351. .rF
  1352. \\*([A\&
  1353. \\*([T\c
  1354. .if !\\*([E \{\
  1355. , \\*([E
  1356. .ie !\\*([e (eds.)\c
  1357. .el (ed.)\c\}
  1358. .if !\\*([B , \\f2\\*([B\\f1\c
  1359. .if !\\*([S , \\*([S\c
  1360. .if !\\*([I , \\*([I\c
  1361. .if !\\*([J , \\f2\\*([J\\f1
  1362. .if !\\*([V , vol.\ \\*([V\\f1\c
  1363. .if !\\*([N , no.\ \\*([N
  1364. .if !\\*([M , \\*([M\c
  1365. .if !\\*([D , \\*([D\c
  1366. .if !\\*([P , \\*([P\c
  1367. .ie \\*([O \&.
  1368. .el \& [\\*([O].
  1369. ..
  1370. SHAR_EOF
  1371. chmod +x 'tmac.refCACM'
  1372. fi
  1373. if test -f 'tmac.refDEF'
  1374. then
  1375.     echo shar: "will not over-write existing file 'tmac.refDEF'"
  1376. else
  1377. cat << \SHAR_EOF > 'tmac.refDEF'
  1378. .\"        Refer macros default format
  1379. .\"        R. Goebel, May 1, 1983
  1380. .\"        Documentation: /u/rggoebel/pub/doc/refer.text
  1381. .\"                   /u/rggoebel/pub/doc/tmac.ref.7.text
  1382. .\"             ________________________________________________
  1383. .\"
  1384. .\"        reference format selection macro
  1385. .\"        notice that last entry is default format
  1386. .de ][
  1387. .ie \\*([lbook .[0
  1388. .el .ie \\*([ljournal-article .[1
  1389. .el .ie \\*([lproceedings-article .[2
  1390. .el .ie \\*([lbook-article .[3
  1391. .el .ie \\*([ledited-book .[4
  1392. .el .ie \\*([ledited-proceedings .[5
  1393. .el .ie \\*([ltechnical-report .[6
  1394. .el .ie \\*([lmanuscript .[7
  1395. .el .ie \\*([ldissertation .[8
  1396. .el .ie \\*([ledited-journal .[9
  1397. .el .[d
  1398. ..
  1399. .\"        format in-text citation
  1400. .de rF
  1401. .ne 4
  1402. .ti -5
  1403. .if !\\*([F [\\*([F]
  1404. .br
  1405. ..
  1406. .\"        punctuation definition
  1407. .ds >. .
  1408. .ds <. \&
  1409. .ds >, ,
  1410. .ds <, \&
  1411. .ds >; ;
  1412. .ds <; \&
  1413. .ds >: :
  1414. .ds <: \&
  1415. .\"        in-text citation brackets
  1416. .ds [. " [
  1417. .ds .] ]
  1418. .\"        reference list initialization macro
  1419. .de ]<
  1420. .ft R
  1421. .ls 1
  1422. .in 5
  1423. .sp 2
  1424. .na
  1425. ..
  1426. .\"        reference list termination macro
  1427. .de ]>
  1428. .ft P
  1429. .ad
  1430. .in 0
  1431. .sp 2
  1432. ..
  1433. .\"        string definition reset macro
  1434. .de ]-
  1435. .rm [V [P [A [T [N [C [B [O [R [I [E [D [L [J [S [M [l [e [n [c
  1436. ..
  1437. .de [0        \" book format
  1438. .rF
  1439. \\*([A (\\*([D),
  1440. \\f2\\*([T\\f1\c
  1441. .if !\\*([n , edition \\*([n\c
  1442. .if !\\*([S , \\*([S\c
  1443. .if !\\*([V , vol.\ \\*([V\c
  1444. , \\*([I\c
  1445. .if !\\*([C , \\*([C\c
  1446. .ie \\*([O \&.
  1447. .el \& [\\*([O].
  1448. ..
  1449. .de [1        \" journal-article format
  1450. .rF
  1451. \\*([A (\\*([D),
  1452. \\*([T,
  1453. \\f2\\*([J\\f1\c
  1454. .if !\\*([V \& \\f3\\*([V\\f1\c
  1455. .if !\\*([N (\\*([N)\c
  1456. .if !\\*([M , \\*([M\c
  1457. .if !\\*([I , \\*([I\c
  1458. .if !\\*([C , \\*([C\c
  1459. .if !\\*([P , \\*([P\c
  1460. .ie \\*([O \&.
  1461. .el \& [\\*([O].
  1462. ..
  1463. .de [2        \" proceedings-article format
  1464. .rF
  1465. \\*([A (\\*([D),
  1466. \\*([T,
  1467. \\f2\\*([J\\f1\c
  1468. .if !\\*([V \& \\f3\\*([V\\f1\c
  1469. .if !\\*([M , \\*([M\c
  1470. .if !\\*([I , \\*([I\c
  1471. .if !\\*([C , \\*([C\c
  1472. .if !\\*([E \{\
  1473. , \\*([E
  1474. .ie !\\*([e (eds.)\c
  1475. .el (ed.)\c
  1476. .\}
  1477. .if !\\*([P , \\*([P\c
  1478. .ie \\*([O \&.
  1479. .el \& [\\*([O].
  1480. ..
  1481. .de [3        \" book-article format
  1482. .rF
  1483. \\*([A (\\*([D),
  1484. \\*([T,
  1485. \\f2\\*([B\\f1\c
  1486. .if !\\*([n , edition \\*([n\c
  1487. .if !\\*([S , \\*([S\c
  1488. .if !\\*([V , vol.\ \\*([V\c
  1489. .if !\\*([E \{\
  1490. , \\*([E
  1491. .ie !\\*([e (eds.)\c
  1492. .el (ed.)\c\}
  1493. , \\*([I\c
  1494. .if !\\*([C , \\*([C\c
  1495. .if !\\*([P , \\*([P\c
  1496. .ie \\*([O \&.
  1497. .el \& [\\*([O].
  1498. ..
  1499. .de [4        \" edited-book format
  1500. .rF
  1501. \\*([A (\\*([D,
  1502. .ie \\*([e ed.),
  1503. .el eds.),
  1504. \\f2\\*([T\\f1\c
  1505. .if !\\*([n , edition \\*([n\c
  1506. .if !\\*([S , \\*([S\c
  1507. .if !\\*([V , vol.\ \\*([V\c
  1508. , \\*([I\c
  1509. .if !\\*([C , \\*([C\c
  1510. .ie \\*([O \&.
  1511. .el \& [\\*([O].
  1512. ..
  1513. .de [5        \" edited-proceedings format
  1514. .rF
  1515. .ie \\*([e \\*([A (\\*([D, ed.),
  1516. .el \\*([A (\\*([D, eds.),
  1517. \\f2\\*([J\\f1\c
  1518. .if !\\*([V \& \\f3\\*([V\\f1\c
  1519. .if !\\*([M , \\*([M\c
  1520. .if !\\*([I , \\*([I\c
  1521. .if !\\*([C , \\*([C\c
  1522. .ie \\*([O \&.
  1523. .el \& [\\*([O].
  1524. ..
  1525. .de [6        \" technical-report format
  1526. .rF
  1527. \\*([A (\\*([D),
  1528. \\*([T\c
  1529. .if !\\*([R , \\*([R\c
  1530. .if !\\*([S , \\*([S\c
  1531. .if !\\*([I , \\*([I\c
  1532. .if !\\*([C , \\*([C\c
  1533. .if !\\*([M , \\*([M\c
  1534. .if !\\*([P , \\*([P\c
  1535. .ie \\*([O \&.
  1536. .el \& [\\*([O].
  1537. ..
  1538. .de [7        \" manuscript format
  1539. .rF
  1540. \\*([A (\\*([D),
  1541. \\*([T\c
  1542. .if !\\*([S , \\*([S\c
  1543. .if !\\*([I , \\*([I\c
  1544. .if !\\*([C , \\*([C\c
  1545. .if !\\*([M , \\*([M\c
  1546. .if !\\*([P , \\*([P\c
  1547. .ie \\*([O \&.
  1548. .el \& [\\*([O].
  1549. ..
  1550. .de [8        \" dissertation format
  1551. .rF
  1552. \\*([A (\\*([D),
  1553. \\*([T\c
  1554. .if !\\*([Q , \\*([Q dissertation\c
  1555. .if !\\*([S , \\*([S\c
  1556. .if !\\*([I , \\*([I\c
  1557. .if !\\*([C , \\*([C\c
  1558. .if !\\*([M , \\*([M\c
  1559. .if !\\*([P , \\*([P\c
  1560. .ie \\*([O \&.
  1561. .el \& [\\*([O].
  1562. ..
  1563. .de [9        \" edited-journal
  1564. .rF
  1565. \\*([A (\\*([D,
  1566. .ie \\*([e ed.),
  1567. .el eds.),
  1568. \\*([T,
  1569. \\f2\\*([J\\f1\c
  1570. .if !\\*([V \& \\f3\\*([V\\f1\c
  1571. .if !\\*([N (\\*([N)\c
  1572. .if !\\*([M , \\*([M\c
  1573. .if !\\*([I , \\*([I\c
  1574. .if !\\*([C , \\*([C\c
  1575. .ie \\*([O \&.
  1576. .el \& [\\*([O].
  1577. ..
  1578. .de [d        \" default format
  1579. .rF
  1580. \\*([A (\\*([D),
  1581. \\*([T\c
  1582. .if !\\*([J , \\f2\\*([J\\f1\c
  1583. .if !\\*([B , \\f2\\*([B\\f1\c
  1584. .if !\\*([S , \\*([S\c
  1585. .if !\\*([V , vol.\ \\*([V\c
  1586. .if !\\*([N , no.\ \\*([N\c
  1587. .if !\\*([E \{\
  1588. , \\*([E
  1589. .ie !\\*([e (eds.)\c
  1590. .el (ed.)\c\}
  1591. .if !\\*([I , \\*([I\c
  1592. .if !\\*([C , \\*([C\c
  1593. .if !\\*([M , \\*([M\c
  1594. .if !\\*([P , \\*([P\c
  1595. .ie \\*([O \&.
  1596. .el \& [\\*([O].
  1597. ..
  1598. SHAR_EOF
  1599. chmod +x 'tmac.refDEF'
  1600. fi
  1601. exit 0
  1602. #    End of shell archive
  1603. -- 
  1604. Patrick Powell, Dept. Computer Science, 136 Lind Hall, 207 Church St. SE,
  1605. University of Minnesota,  Minneapolis, MN 55455 (612)625-3543/625-4002
  1606.  
  1607.  
  1608.