![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to bib.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / new / bib / man|
Return to bib.1 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / new / bib / man |
1.1 root 1: .\" "@(#)bib.1 4.6 5/25/86";
2: .TH BIB 1 "May 25, 1986" "Univ of Arizona"
3: .UC 4
4: .SH NAME
5: bib, listrefs \- bibliographic formatter; list bibliographic reference items
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.
18: Citation and reference formats are controlled by the \-t option.
19: .PP
20: Reference databases are created using the \fIinvert\fP utility.
21: .PP
22: The following options are available.
23: Note that standard format styles (see the \-t option) set options automatically.
24: Thus if a standard format style is used the user need not indicate any
25: further options for most documents.
26: .IP \-aa 8m
27: reduce author\*(CQs first names to abbreviations.
28: .IP \-ar\fInum\fP
29: reverse the first \fInum\fP author's names.
30: If a number is not given all authors names are reversed.
31: .IP \-ax
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.
34: .IP \-c\fIstr\fP
35: build citations according to the template \fIstr\fP. See the reference
36: format designer\*(CQs guide for more information on templates.
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.
44: .IP \-f
45: instead of collecting references, dump each
46: reference immediately following the line on which the citation is placed
47: (used for footnoted references).
48: .IP "\-i \fIfile\fP"
49: .ns
50: .IP \-i\fIfile\fP
51: process the indicated file, such as a file of definitions.
52: (see technical report for a description of file format).
53: .IP \-h
54: replace citations to three or more adjacent reference items with
55: a hyphenated string (eg 2,3,4,5 becomes 2-5).
56: This option implies the \-o option.
57: .IP \-n\fIstr\fP
58: turn off indicated options. \fIstr\fP must be composed of the letters afhosx.
59: .IP \-o
60: contiguous citations are ordered according the the reference list before
61: being printed (default).
62: .IP "\-p \fIfile\fP"
63: .ns
64: .IP \-p\fIfile\fP
65: instead of searching the file INDEX,
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.
69: .IP \-s\fIstr\fP
70: sort references according to the template \fIstr\fP.
71: .IP "\-t \fItype\fP"
72: .ns
73: .IP \-t\fItype\fP
74: use the standard macros and switch settings for the indicated style
75: to generate citations and references.
76: There are a number of standard styles provided. In addition users
77: can generate their own style macros. See the format designers guide for
78: details.
79: .PP
80: \fIListrefs\fP formats an entire reference database file.
81: Options to \fIlistrefs\fP
82: are the same as for \fIbib\fP.
83: .PP
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
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
100: definitions may be found in /usr/new/lib/bmac.
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
107: /usr/new/lib/bmac/bmac.* formatting macro packages
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)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.