BSD 4_3_Reno release

[unix-history] / usr / src / contrib / bib / man / bib.1

diff --git a/usr/src/contrib/bib/man/bib.1 b/usr/src/contrib/bib/man/bib.1
index 3a7dd2e..2c10870 100644 (file)
--- a/usr/src/contrib/bib/man/bib.1
+++ b/usr/src/contrib/bib/man/bib.1
@@ -1,8 +1,8 @@
-.TH bib/listrefs 1 local
+.\"    "@(#)bib.1      4.6     5/25/86";
+.TH BIB 1 "May 25, 1986" "Univ of Arizona"
+.UC 4

 .SH NAME
 .SH NAME

-bib - bibliographic formatter
-.br
-listrefs - list bibliographic reference items
+bib, listrefs \- bibliographic formatter; list bibliographic reference items

 .SH SYNOPSIS
 \fBbib\fP [options] ...
 .br
 .SH SYNOPSIS
 \fBbib\fP [options] ...
 .br


@@ -15,69 +15,75 @@ pairs, which are assumed to be keywords for searching a bibliographic database.
 If a matching reference is found a citation is generated replacing the text.
 References are collected, optionally sorted, and written out at a location
 specified by the user.
 If a matching reference is found a citation is generated replacing the text.
 References are collected, optionally sorted, and written out at a location
 specified by the user.

-Citation and reference formats are controlled by the -t option.
+Citation and reference formats are controlled by the \-t option.

 .PP
 Reference databases are created using the \fIinvert\fP utility.
 .PP
 The following options are available.
 .PP
 Reference databases are created using the \fIinvert\fP utility.
 .PP
 The following options are available.

-Note that standard format styles (see the -t option) set options automatically.
-Thus if a standard format style is used, the user need not indicate any
+Note that standard format styles (see the \-t option) set options automatically.
+Thus if a standard format style is used the user need not indicate any

 further options for most documents.
 further options for most documents.

-.IP -aa 8m
+.IP \-aa 8m

 reduce author\*(CQs first names to abbreviations.
 reduce author\*(CQs first names to abbreviations.

-.IP -ar\fInum\fP
-reverse the first \fInum\fP author\*(CQs names
-.IP -ax
+.IP \-ar\fInum\fP
+reverse the first \fInum\fP author's names.
+If a number is not given all authors names are reversed.
+.IP \-ax

 print authors last names in Caps-Small Caps style.  For example Budd becomes
 B\s-2UDD\s+2.  This style is used by certain ACM publications.
 print authors last names in Caps-Small Caps style.  For example Budd becomes
 B\s-2UDD\s+2.  This style is used by certain ACM publications.

-.IP -ea 8m
-reduce editor\*(CQs first names to abbreviations.
-.IP -er\fInum\fP
-reverse the first \fInum\fP editor\*(CQs names
-.IP -ex
-print editors last names in Caps-Small Caps style.
-.IP -c\fIstr\fP
+.IP \-c\fIstr\fP

 build citations according to the template \fIstr\fP.  See the reference
 format designer\*(CQs guide for more information on templates.
 build citations according to the template \fIstr\fP.  See the reference
 format designer\*(CQs guide for more information on templates.

-.IP -f
+.IP \-ea
+reduce editors first names to abbreviations.
+.IP \-ex
+print editors last names in Caps-Small Caps style (see \-ax option).
+.IP \-er\fInum\fP
+reverse the first \fInum\fP editors names.  If a number is not given all
+editors names are reversed.
+.IP \-f

 instead of collecting references, dump each
 reference immediately following the line on which the citation is placed
 (used for footnoted references).
 instead of collecting references, dump each
 reference immediately following the line on which the citation is placed
 (used for footnoted references).

-.IP "-i \fIfile\fP"
+.IP "\-i \fIfile\fP"

 .ns
 .ns

-.IP  -i\fIfile\fP
+.IP  \-i\fIfile\fP

 process the indicated file, such as a file of definitions.
 (see technical report for a description of file format).
 process the indicated file, such as a file of definitions.
 (see technical report for a description of file format).

-.IP -h
+.IP \-h

 replace citations to three or more adjacent reference items with
 a hyphenated string (eg 2,3,4,5 becomes 2-5).
 replace citations to three or more adjacent reference items with
 a hyphenated string (eg 2,3,4,5 becomes 2-5).

-.IP -n\fIstr\fP
+This option implies the \-o option.
+.IP \-n\fIstr\fP

 turn off indicated options.  \fIstr\fP must be composed of the letters afhosx.
 turn off indicated options.  \fIstr\fP must be composed of the letters afhosx.

-.IP -o
+.IP \-o

 contiguous citations are ordered according the the reference list before
 being printed (default).
 contiguous citations are ordered according the the reference list before
 being printed (default).

-.IP "-p \fIfile\fP"
+.IP "\-p \fIfile\fP"

 .ns
 .ns

-.IP  -p\fIfile\fP
+.IP  \-p\fIfile\fP

 instead of searching the file INDEX,
 instead of searching the file INDEX,

-search the indicated reference file before searching the system file.
-.IP -s\fIstr\fP
+search the indicated reference files before searching the system file.
+\fIfiles\fP is a comma separated list of inverted indices, created using
+the \fIinvert\fP utility.
+.IP \-s\fIstr\fP

 sort references according to the template \fIstr\fP.
 sort references according to the template \fIstr\fP.

-.IP "-t \fItype\fP"
+.IP "\-t \fItype\fP"

 .ns
 .ns

-.IP -t\fItype\fP
+.IP \-t\fItype\fP

 use the standard macros and switch settings for the indicated style
 to generate citations and references.
 use the standard macros and switch settings for the indicated style
 to generate citations and references.

-There are a number of standard styles provided.  In addition the user
+There are a number of standard styles provided.  In addition users

 can generate their own style macros.  See the format designers guide for
 can generate their own style macros.  See the format designers guide for

-more details.
+details.

 .PP
 .PP

-\fIListrefs\fP formats an entire format file.  Options to \fIlistrefs\fP
-are the same as for \fIbib\fP.  Items in the format file are not sorted.
+\fIListrefs\fP formats an entire reference database file.
+Options to \fIlistrefs\fP
+are the same as for \fIbib\fP.

 .PP
 .PP

-\fIBib\fP was designed initially for use with the -ms macros, and
-uses a couple of the -ms macros (.ip and .lp) in its macro definitions.
-To use it with the -me macros, prefix the file being sent to nroff/troff
+\fIBib\fP was designed initially for use with the \-ms macros, and
+uses a couple of the \-ms macros (.ip and .lp) in its macro definitions.
+To use it with the \-me macros, prefix the file being sent to nroff/troff

 with the following macro definitions:
 .nf
 .in +1.0i
 with the following macro definitions:
 .nf
 .in +1.0i


@@ -91,14 +97,14 @@ with the following macro definitions:
 .in -1.0i
 .PP
 A file "bibmac.me" containing these macro
 .in -1.0i
 .PP
 A file "bibmac.me" containing these macro

-definitions may be found in /usr/lib/bmac.
+definitions may be found in /usr/new/lib/bmac.

 .SH FILES
 .ta 2i
 INDEX  inverted index for reference database
 .br
 /usr/dict/papers/INDEX default system index
 .br
 .SH FILES
 .ta 2i
 INDEX  inverted index for reference database
 .br
 /usr/dict/papers/INDEX default system index
 .br

-/usr/lib/bmac/bmac.*   formatting macro packages
+/usr/new/lib/bmac/bmac.*       formatting macro packages

 .br
 /usr/tmp/bibr* scratch file for collecting references
 .br
 .br
 /usr/tmp/bibr* scratch file for collecting references
 .br