NAME

roffbib − run off bibliographic database

SYNOPSIS

roffbib [ −e ] [ −h ] [ −n ] [ −o ] [ −r ] [ −s ] [ −Tterm ] [ −x ] [ −m mac ] [ −V ] [ −Q ] [ file ... ]

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

Roffbib accepts most of the options understood by nroff(1), most importantly the −T flag to specify 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.  The −x flag will suppress the printing of these abstracts. 

A user-defined set of macros may be specified after the −m option.  There should be a space between the −m and the macro filename.  This set of macros will replace the ones defined in /usr/lib/tmac/tmac.bib.  The −V flag will send output to the Versatec; the −Q flag will queue output for the phototypesetter. 

Four command-line registers control formatting style of the bibliography, much like the number registers of ms(7). The command-line argument −rN1 will number the references starting at one (1).  The flag −rV2 will double space the biblio­graphy, 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).  Note: with the −V and −Q flags the default page offset is already one inch. 

FILES

/usr/lib/tmac/tmac.bibfile of macros used by nroff/troff

SEE ALSO

refer(1), addbib(1), sortbib(1), indxbib(1), lookbib(1)

AUTHORS

Greg Shenaut, Bill Tuthill

BUGS

Users have to rewrite macros to create customized formats. 

4BSD