Commit | Line | Data |
---|---|---|
95f51977 C |
1 | .\" "@(#)bib.1 4.6 5/25/86"; |
2 | .TH BIB 1 "May 25, 1986" "Univ of Arizona" | |
30a9a226 | 3 | .UC 4 |
d4285d8c | 4 | .SH NAME |
58ad5548 | 5 | bib, listrefs \- bibliographic formatter; list bibliographic reference items |
d4285d8c SL |
6 | .SH SYNOPSIS |
7 | \fBbib\fP [options] ... | |
8 | .br | |
9 | \fBlistrefs\fP [options] ... | |
10 | .SH DESCRIPTION | |
11 | \fIBib\fP is a preprocessor for \fInroff\fP or \fItroff\fP(1) that | |
12 | formats citations and bibliographies. The input files (standard input | |
13 | default) are copied to the standard output, except for text between [. and .] | |
14 | pairs, which are assumed to be keywords for searching a bibliographic database. | |
15 | If a matching reference is found a citation is generated replacing the text. | |
16 | References are collected, optionally sorted, and written out at a location | |
17 | specified by the user. | |
30a9a226 | 18 | Citation and reference formats are controlled by the \-t option. |
d4285d8c SL |
19 | .PP |
20 | Reference databases are created using the \fIinvert\fP utility. | |
21 | .PP | |
22 | The following options are available. | |
30a9a226 | 23 | Note that standard format styles (see the \-t option) set options automatically. |
d2ffc63c | 24 | Thus if a standard format style is used the user need not indicate any |
d4285d8c | 25 | further options for most documents. |
30a9a226 | 26 | .IP \-aa 8m |
d4285d8c | 27 | reduce author\*(CQs first names to abbreviations. |
30a9a226 | 28 | .IP \-ar\fInum\fP |
d2ffc63c GL |
29 | reverse the first \fInum\fP author's names. |
30 | If a number is not given all authors names are reversed. | |
30a9a226 | 31 | .IP \-ax |
d4285d8c SL |
32 | print authors last names in Caps-Small Caps style. For example Budd becomes |
33 | B\s-2UDD\s+2. This style is used by certain ACM publications. | |
30a9a226 | 34 | .IP \-c\fIstr\fP |
d4285d8c SL |
35 | build citations according to the template \fIstr\fP. See the reference |
36 | format designer\*(CQs guide for more information on templates. | |
d2ffc63c GL |
37 | .IP \-ea |
38 | reduce editors first names to abbreviations. | |
39 | .IP \-ex | |
40 | print editors last names in Caps-Small Caps style (see \-ax option). | |
41 | .IP \-er\fInum\fP | |
42 | reverse the first \fInum\fP editors names. If a number is not given all | |
43 | editors names are reversed. | |
30a9a226 | 44 | .IP \-f |
d4285d8c SL |
45 | instead of collecting references, dump each |
46 | reference immediately following the line on which the citation is placed | |
47 | (used for footnoted references). | |
30a9a226 | 48 | .IP "\-i \fIfile\fP" |
d4285d8c | 49 | .ns |
30a9a226 | 50 | .IP \-i\fIfile\fP |
d4285d8c SL |
51 | process the indicated file, such as a file of definitions. |
52 | (see technical report for a description of file format). | |
30a9a226 | 53 | .IP \-h |
d4285d8c SL |
54 | replace citations to three or more adjacent reference items with |
55 | a hyphenated string (eg 2,3,4,5 becomes 2-5). | |
d2ffc63c | 56 | This option implies the \-o option. |
30a9a226 | 57 | .IP \-n\fIstr\fP |
d4285d8c | 58 | turn off indicated options. \fIstr\fP must be composed of the letters afhosx. |
30a9a226 | 59 | .IP \-o |
d4285d8c SL |
60 | contiguous citations are ordered according the the reference list before |
61 | being printed (default). | |
30a9a226 | 62 | .IP "\-p \fIfile\fP" |
d4285d8c | 63 | .ns |
30a9a226 | 64 | .IP \-p\fIfile\fP |
d4285d8c | 65 | instead of searching the file INDEX, |
d2ffc63c GL |
66 | search the indicated reference files before searching the system file. |
67 | \fIfiles\fP is a comma separated list of inverted indices, created using | |
68 | the \fIinvert\fP utility. | |
30a9a226 | 69 | .IP \-s\fIstr\fP |
d4285d8c | 70 | sort references according to the template \fIstr\fP. |
30a9a226 | 71 | .IP "\-t \fItype\fP" |
d4285d8c | 72 | .ns |
30a9a226 | 73 | .IP \-t\fItype\fP |
d4285d8c SL |
74 | use the standard macros and switch settings for the indicated style |
75 | to generate citations and references. | |
d2ffc63c | 76 | There are a number of standard styles provided. In addition users |
d4285d8c | 77 | can generate their own style macros. See the format designers guide for |
d2ffc63c | 78 | details. |
d4285d8c | 79 | .PP |
d2ffc63c GL |
80 | \fIListrefs\fP formats an entire reference database file. |
81 | Options to \fIlistrefs\fP | |
82 | are the same as for \fIbib\fP. | |
d4285d8c | 83 | .PP |
30a9a226 PN |
84 | \fIBib\fP was designed initially for use with the \-ms macros, and |
85 | uses a couple of the \-ms macros (.ip and .lp) in its macro definitions. | |
86 | To use it with the \-me macros, prefix the file being sent to nroff/troff | |
d4285d8c SL |
87 | with the following macro definitions: |
88 | .nf | |
89 | .in +1.0i | |
90 | \&.de IP | |
91 | \&.ip \\$1 \\$2 | |
92 | \&.. | |
93 | \&.de LP | |
94 | \&.lp | |
95 | \&.. | |
96 | .fi | |
97 | .in -1.0i | |
98 | .PP | |
99 | A file "bibmac.me" containing these macro | |
98535d6d | 100 | definitions may be found in /usr/new/lib/bmac. |
d4285d8c SL |
101 | .SH FILES |
102 | .ta 2i | |
103 | INDEX inverted index for reference database | |
104 | .br | |
105 | /usr/dict/papers/INDEX default system index | |
106 | .br | |
98535d6d | 107 | /usr/new/lib/bmac/bmac.* formatting macro packages |
d4285d8c SL |
108 | .br |
109 | /usr/tmp/bibr* scratch file for collecting references | |
110 | .br | |
111 | /usr/tmp/bibp* output of pass one of bib | |
112 | .SH SEE ALSO | |
113 | \fIA UNIX Bibliographic Database Facility\fP, Timothy A. Budd and Gary M. Levin, | |
114 | University of Arizona Technical Report 82-1, 1982. | |
115 | (includes format designers guide). | |
116 | .br | |
117 | invert(1), troff(1) |