roffbib(1)               USER COMMANDS                 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  biblio-
     graphic  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  anno-
          tated  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 out-
          put  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.



             Last change: BSD Compatibility Package             1

roffbib(1)               USER COMMANDS                 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  bibliogra-
          phy, 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 (capi-
          tal O, not zero).

     -sN  Halt prior to every N pages for paper loading or chang-
          ing (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),  sort-
     bib(1), troff(1).

NOTES
     Users have to rewrite macros to create customized formats.





























             Last change: BSD Compatibility Package             2