roffbib(1)							   User Commands							roffbib(1)

NAME

       roffbib - format and print a bibliographic database

SYNOPSIS

       roffbib [-e] [-h] [-m filename] [-np] [-olist] [-Q] [-raN] [-sN] [-Tterm] [-V] [-x] [filename] ...

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(1):

	      example% sortbib database | roffbib

OPTIONS

       roffbib accepts all options understood by nroff(1) except -i and -q.

       -e	       Produce equally-spaced words in adjusted lines using full terminal resolution.

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

       -m filename     Prepend	the  macro  file  /usr/share/lib/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/share/lib/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.

       -Q	       Queue output for the phototypesetter.  Page offset is set to 1 inch.

       -raN	       Set register a (one-character) to N. The command-line argument -rN1 will number the references starting at 1.

		       Four command-line registers control formatting style of the bibliography, much like the number registers of ms(5). 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).

       -sN	       Halt prior to every N pages for paper loading or changing (default N=1).  To resume, enter NEWLINE or RETURN.

       -Tterm	       Specify term as the terminal type.

       -V	       Send output to the Versatec.  Page offset is set to 1 inch.

       -x	       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.

FILES

       /usr/share/lib/tmac/tmac.bib    file of macros used by nroff/troff

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWdoc			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       addbib(1), indxbib(1), lookbib(1), nroff(1) refer(1), sortbib(1),  troff(1), attributes(5)

BUGS

       Users have to rewrite macros to create customized formats.

SunOS 5.10							    14 Sep 1992 							roffbib(1)