BIB, LISTREFS(1,C) AIX Commands Reference BIB, LISTREFS(1,C)
-------------------------------------------------------------------------------
bib, listrefs
PURPOSE
Lists bibliographic reference items.
SYNTAX
+-------------------+ +----------+
bib, lisrefs ---| +---------------+ |---| |---|
+-| -aa -h |-+ +- -ttype -+
^| -arnum -nstr ||
|| -ax -o ||
|| -cstr -pfile ||
|| -ea -sstr ||
|| -ex ||
|| -ernum ||
|| -f ||
|| -ifile ||
|+---------------+|
+-----------------+
Note: This command does not have MBCS support.
DESCRIPTION
The bib command is a preprocessor for nroff or troff 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.
FLAGS
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 further options for most documents.
-aa Reduce authors' first names to abbreviations.
-arnum Reverse the first num of the authors' names. If a number is not given,
all authors' names are reversed.
Processed November 8, 1990 BIB, LISTREFS(1,C) 1
BIB, LISTREFS(1,C) AIX Commands Reference BIB, LISTREFS(1,C)
-ax Print authors' last names in Caps-Small Caps style. This style is used
by certain Association for Computing Machinery (ACM) publications.
-cstr Build citations according to the template str.
-ea Reduce editors' first names to abbreviations.
-ex Print editor' 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 immediately
following the line on which the citation is placed (used for footnoted
references).
-ifile Process the indicated file, such as a file of definitions.
-h Replace citations to three or more adjacent reference items with a
hyphenated string. That is, 2, 3, 4, 5 becomes 2-5. This option
implies the -o option.
-nstr Turn off indicated options. str must be composed of the following
letters: a f h o s x.
-o Order contiguous citations according to the reference list before being
printed (default).
-pfile Instead of searching the file INDEX, search the indicated reference
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.
-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.
The listrefs command formats an entire reference database file. Options to
listrefs are the same as for bib.
The bib command was designed initially for use with -ms macros and uses two -ms
macros (.ip and .lp) in its macro definitions. To use it with -me macros,
prefix the file being sent to nroff/troff with the following macro definitions:
.de IP
.ip $1 $2
..
.de LP
.lp
..
Processed November 8, 1990 BIB, LISTREFS(1,C) 2
BIB, LISTREFS(1,C) AIX Commands Reference BIB, LISTREFS(1,C)
A file named bibmac.me containing these macro definitions is in /usr/lib/bmac.
FILES
INDEX Inverted index for reference database
/usr/dict/papers/INDEX Default system index
/usr/lib/bmac/bmac* Formatting macro packages
/usr/tmp/bibr* Scratch file for collecting references
/usr/tmp/bibp* Output of pass one of bib
RELATED INFORMATION
See the "invert," "lookup," and "nroff" commands in the AIX Commands Reference.
Processed November 8, 1990 BIB, LISTREFS(1,C) 3