roffbib(1)                                             roffbib(1)



NAME
     roffbib - prints out all records in a bibliographic database

SYNOPSIS
     roffbib [-e] [-h] [-m name] [-nstart-no] [-opage-range]
     -rletter[integer] [-sN] [-Ttty-type] [-x] [file]...

ARGUMENTS
     -e   Produces equally spaced words in adjusted lines, using
          the full resolution of the particular terminal.

     file Specifies the file into which the output from the
          roffbib command is placed.

     -h   Uses output tabs during horizontal spacing to speed
          output and reduce output character count.  Tab settings
          are assumed to be every 8 nominal character widths.

     -mname
          Prepends to the input files to the
          /usr/lib/tmac/tmac.name macro file.

     -nstart-no
          Numbers the first generated page at start-no.

     -opage-range
          Prints only pages whose page numbers appear in the
          page-range of numbers and ranges, separated by commas.
          A range x-y means pages x through y; a range given by
          -y means from the beginning to page y; a range given by
          x- means from page x to the end.

     -rletter[integer]
          Set the number register referenced by letter to
          integer.

     -s[pages-per-pause]
          Specifies the number of pages to print between pauses,
          causing nroff to halt to allow paper receipt of a
          linefeed or newline (newlines do not work in pipelines,
          e.g., with mm).  The default is 1.  This option does
          not work if the output of nroff is piped through col.
          When nroff (otroff) halts between pages, an ASCII BEL
          is sent to the terminal.

     -Ttty-type
          Prepare output for specified terminal.  Known tty-types
          are

          2631        Hewlett-Packard 2631 printer in regular
                      mode




January 1992                                                    1

roffbib(1)                                             roffbib(1)



          2631-c      Hewlett-Packard 2631 printer in compressed
                      mode

          2631-e      Hewlett-Packard 2631 printer in expanded
                      mode

          300         DASI-300 printer

          300-12      DASI-300 terminal set to 12-pitch (12
                      characters per inch)

          300s        DASI-300s printer (300s is a synonym)

          300s-12     DASI-300s terminal set to 12-pitch (12
                      characters per inch) (300s-12 is a synonym)

          37          TELETYPE Model 37 terminal (default)

     -x   Suppresses the printing of these abstracts.

DESCRIPTION
     roffbib 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:

        sortbib database | roffbib

     The roffbib program accepts most of the options understood
     by nroff; most importantly, -T which specifies terminal
     type.

     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.

     Four command-line registers control formatting style of the
     bibliography, much like the number registers of ms.  The
     command-line argument -rN1 will number the references
     starting at one (1).  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).

LIMITATIONS
     Users have to rewrite macros to create customized formats.






2                                                    January 1992

roffbib(1)                                             roffbib(1)



FILES
     /usr/ucb/roffbib
          Executable file
     /usr/lib/tmac/tmac.bib
          Macro file

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














































January 1992                                                    3