(BSD System Compatibility)

roffbib(1bsd)

roffbib -- (BSD) format and print a bibliographic database

Synopsis

   
   /usr/ucb/roffbib [-e] [-h] [-Q] [-x] [-m name] [-np] [-olist]
   	[-raN] [-sN] [-Tterm] [file] . . .

Description

The roffbib command prints out all records in a bibliographic database, in bibliography format rather than as footnotes or endnotes. Generally it is used in conjunction with sortbib(1bsd):

   example% sortbib  database | roffbib

If abstracts or comments are entered following the %X field key, roffbib will format them into paragraphs for an annotated bibliography. Several %X fields may be given if several annotation paragraphs are desired.

roffbib accepts most options understood by nroff(1bsd), as well as others defined below:

-e: Produce equally-spaced words in adjusted lines using full terminal resolution.
-h: Use output tabs during horizontal spacing to speed output and reduce output character count. TAB settings are assumed to be every 8 nominal character widths.
-Q: Queue output for the phototypesetter. Page offset is set to 1 inch.
-x: Suppress printing of abstracts.
-m name: Prepend the macro file /usr/ucblib/doctools/tmac/name to the input files. There should be a space between the -m and the macro filename. This set of macros will replace the ones defined in /usr/ucblib/doctools/tmac/bib.
-np: Number first generated page p.
-olist: Print only page numbers that appear in the comma-separated list of numbers and ranges. A range N-M means pages N through M; an initial -N means from the beginning to page N; a final N- means from page N to end.
-raN: Set register a (one-character) to N. The command-line argument -rN1 will number the references starting at 1.
Four command-line registers control formatting style of the bibliography, much like the number registers of ms(5bsd). The flag -rV2 will double space the bibliography, while -rV1 will double space references but single space annotation paragraphs. The line length can be changed from the default 6.5 inches to 6 inches with the -rL6i argument, and the page offset can be set from the default of 0 to one inch by specifying -rO1i (capital O, not zero).
-sN: Halt prior to every N pages for paper loading or changing (default N=1). To resume, enter NEWLINE or RETURN.
-Tterm: Specify term as the terminal type.

Files

/usr/ucblib/doctools/tmac/bib: file of macros used by nroff/troff

References

addbib(1bsd), indxbib(1bsd), lookbib(1bsd), nroff(1bsd), refer(1bsd), sortbib(1bsd), troff(1bsd)

Notices

Users have to rewrite macros to create customized formats.