BIB(1)BIB(1)NAME
bib, listrefs, bibinc, bib2tib - bibliographic formatter
SYNOPSISbib [options] ...
listrefs [options] ...
bibinc [options] ...
DESCRIPTION
Bib is a preprocessor for nroff or troff(1) that formats citations and
bibliographies. The input files (standard input default) are copied to
the standard output, except for text between [. and .] 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. Citation and reference formats are
controlled by the -t option.
Reference databases are created using the invert utility.
The following options are available. Note that standard format styles
(see the -t option) set options automatically. Thus if a standard for‐
mat style is used the user need not indicate any further options for
most documents.
-aa reduce authors first names to abbreviations.
-arnum reverse the first num author's names. If a number is not given
all authors names are reversed.
-ax print authors last names in Caps-Small Caps style. For example
Budd becomes BUDD. This style is used by certain ACM publica‐
tions.
-cstr build citations according to the template str. See the refer‐
ence format designers guide for more information on templates.
-d changes the default search directory for style files, include
files, etc. and changes the value of the macro BMACLIB for
bib, and of the macro l] used to find the troff macro defini‐
tion file bmac.std. Defaults to /usr/new/lib/bmac. If you
have your own private copies of all the necessary files, using
this option is the easiest way to specify them.
-ea reduce editors' first names to abbreviations.
-ex print editors' last names in Caps-Small Caps style (see -ax
option).
-ernum reverse the first num editors' names. If a number is not given
all editors' names are reversed.
-f instead of collecting references, dump each reference immedi‐
ately following the line on which the citation is placed (used
for footnoted references).
-i file
-ifile process the indicated file, such as a file of definitions.
(see technical report for a description of file format).
-h replace citations to three or more adjacent reference items
with a hyphenated string (eg 2,3,4,5 becomes 2-5). This option
implies the -o option.
-nstr turn off indicated options. str must be composed of the let‐
ters afhosx.
-o contiguous citations are ordered according the the reference
list before being printed (default).
-p file
-pfile instead of searching the file INDEX, search the indicated ref‐
erence files before searching the system file. files is a
comma separated list of inverted indices, created using the
invert utility.
-sstr sort references according to the template str.
-t type
-ttype 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 users can generate
their own style macros. See the format designers guide for
details.
-Tib the abbreviations and macros used all use the TiB style of
macro call in which the name is enclosed in vertical |bars|.
-Tibx instead of processing the input files, write the file bib.m4.in
containing m4(I) macro definitions that make converting from
bib style to Tib style macros a little easier. Note that m4
does not allow ampersands in macro names: this file and all of
the files to be converted will have to be changed by hand. The
m4 macros will only identify words that bib would normally
expand: they do no other conversions. After creating
.bib.m4.in, run the scriptfile bib2tib passing it the names of
the files you wish converted.
Listrefs formats an entire reference database file. Options to
listrefs are the same as for bib.
Bibinc is an old hack tool for solving the problem of multiple define
files for multiple styles. Some journal styles require that journal
names be spelled out completely, while others allow abbreviated names.
Two macro definition files are available that allow this multiplicity
of style: bibinc.fullnames and bibinc.shortnames. A frequent source of
error is updating one of these files, and forgetting to update the
other. Bibinc allows a single file, say bibinc.names, to define both
the long and the short versions of names, and from which the files bib‐
inc.fullnames and bibinc.shortnames can easily be created. Bibinc can
also be used to define macro files for the TiB bibliographic preproces‐
sor.
Bib2tib will use the bib.m4.in file created with the -Tibx option to
convert any files you specify into one using the TiB-style macro con‐
ventions. It is a simple script that does about 95% of the necessary
grunge work to make this conversion, but be aware that the user will
still need to eyeball the converted files for correctness. To make use
of the facility, run a bib job with the -Tibx option: bib will not
process the input files, but will create bib.m4.in instead, after gath‐
ering together all the definitions it can find. Then for each of your
bibliographic database files, run bibinc.
Bib was designed initially for use with the -ms macros, and uses a cou‐
ple 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:
.de IP
.ip \$1 \$2
..
.de LP
.lp
..
A file "bibmac.me" containing these macro definitions may be found in
/usr/new/lib/bmac.
FILES
INDEX inverted index for reference database
/usr/dict/papers/INDEXdefault system index
/usr/new/lib/bmac/bmac.*formatting macro packages
/usr/new/lib/bmac/bibinc.namesinput to bibinc
/usr/new/lib/bmac/tibmacs/*for use with TiB-style |macros|
/usr/new/lib/bmac/bibmacs/*for use with old bib-style macros
/usr/tmp/bibr* scratch file for collecting references
/usr/tmp/bibp* output of pass one of bib
bib.m4.in macros for converting to TiB (see -Tibx above)
SEE ALSO
A UNIX Bibliographic Database Facility, Timothy A. Budd and Gary M.
Levin, University of Arizona Technical Report 82-1, 1982. (includes
format designers guide).
BIB - A Program for Formatting Bibliographies, Timothy A. Budd, a BSD
UNIX document found in /usr/doc/usd/31.bib.
invert(1), troff(1)4th Berkeley Distribution 2 September 1988BIB(1)