roffbib(1)         UNIX System V(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.

     -raN   Set register a (one-character) to N.  The command-line argument
             -rN1 will number the references starting at 1.





10/89                                                                    Page 1

roffbib(1)         UNIX System V(BSD Compatibility Package)          roffbib(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                                                                    10/89