roffbib(1)              (BSD Compatibility Package)              roffbib(1)

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 data-
     base, 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 bibliogra-
     phy. Several %X fields may be given if several annotation paragraphs
     are desired.

     roffbib accepts all options understood by nroff(1M) except -i and -q,
     as well as those listed below.

OPTIONS
     -e   Produce equally-spaced words in adjusted lines using full termi-
          nal 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.







Page 1                       Reliant UNIX 5.44                Printed 11/98

roffbib(1)              (BSD Compatibility Package)              roffbib(1)

     -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(5). 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.

NOTE
     Users have to rewrite macros to create customized formats.

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

SEE ALSO
     addbib(1), indxbib(1), lookbib(1), refer(1), sortbib(1), nroff(1M),
     troff(1M).


























Page 2                       Reliant UNIX 5.44                Printed 11/98