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
         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.





   7/91                                                                 Page 1

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

























   Page 2                                                                 7/91