NAME

roffbib − format and print a bibliographic database

SYNOPSIS

/usr/ucb/roffbib [ −e ] [ −h ] [ −Q ] [ −x ] [ −m filename ] [ −np ] [ −olist ]
                  [ −raN ] [ −sN ] [ −Tterm ] [ filename ] . . . 

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(1):

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 all options understood by nroff(1) except −i and −q, as well as those listed 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 filename
Prepend the macro file /usr/ucblib/doctools/tmac/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/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(7).  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/tmac.bib
file of macros used by nroff/troff

SEE ALSO

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

NOTES

Users have to rewrite macros to create customized formats. 

  —  BSD Compatibility Package