NAME

roffbib − run off bibliographic database

SYNOPSIS

roffbib [ options ] [ files ]

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, as in the following example:
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. 

OPTIONS

−e Equally spaces words in justified lines. 

−h Speeds output with tabs (set every 8 spaces). 

−m macro Specifies user-defined set of macros.  (There should be a space between the −m and the macro filename.)  Otherwise, /usr/lib/tmac/tmac.bib is used. 

−nn Numbers first page n. 

−olist Prints only listed page numbers;  n − m indicates a range. 

−Q Sends output to phototypesetter spooler. 

−roption 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 1.  The flag −rV2 will doublespace the bibliography, while −rV1 will doublespace references but singlespace 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. 

Nn Reference numbering begins at n. 
Vn Sets vertical spacing to n lines. 
Lns Changes line length to n units in scale s (6.5i default). 
Ons Changes page offset to n units in scale s (0 default). 
s Scale: i for inches, c for centimeters. 

−sn Stops every n pages (1 default). 

−Tterm Same as in nroff;  specifies terminal type. 

−V Prints output on Versatec. 

−x Suppresses printing of abstracts. 

FILES

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

SEE ALSO

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

BUGS

Users must rewrite macros to create customized formats. 

4th Berkeley Distribution  —  1 August 1985