xref: /original-bsd/old/refer/OTHERS/roffbib.1 (revision 0eaa7944)
Copyright (c) 1983 Regents of the University of California.
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.

@(#)roffbib.1 6.1 (Berkeley) 04/29/85

ROFFBIB 1 ""
C 5
NAME
roffbib - run off bibliographic database
SYNOPSIS
roffbib [ -e ] [ -h ] [ -n ] [ -o ] [ -r ] [ -s ] [ -T term ] [ -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 -r N1 will number the references starting at one (1). The flag -r V2 will double space the biblio\%graphy, while -r V1 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 -r L6i argument, and the page offset can be set from the default of 0 to one inch by specifying -r O1i (capital O, not zero). Note: with the -V and -Q flags the default page offset is already one inch.

FILES
/usr/lib/tmac/tmac.bib file 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.