roffbib(1BSD)        (BSD System Compatibility)        roffbib(1BSD)


       NAME
             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


                           Copyright 1994 Novell, Inc.               Page 1

      roffbib(1BSD)        (BSD System Compatibility)        roffbib(1BSD)


                   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.
















                          Copyright 1994 Novell, Inc.               Page 2