Return to bib.1 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / bib / man

Annotation of 43BSD/contrib/bib/man/bib.1, revision 1.1

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.