[unix-history] / usr / man / man1 / roffbib.1

.TH ROFFBIB 1 "18 July 1983"
.UC 4
.SH NAME
roffbib \- run off bibliographic database
.SH SYNOPSIS
.B roffbib
[
.B \-e
] [
.B \-h
] [
.B \-n
] [
.B \-o
] [
.B \-r
] [
.B \-s
] [
.BI \-T term
] [
.B \-x
] [
.B \-m
.I mac
] [
.B \-V
] [
.B \-Q
] [ file ... ]
.SH DESCRIPTION
.I 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
.IR sortbib :
.LP
.RS
sortbib  database | roffbib
.RE
.LP
.I Roffbib
accepts most of the options understood by
.IR nroff (1),
most importantly the
.B \-T
flag to specify terminal type.
.PP
If abstracts or comments are entered following the %X field key,
.I roffbib
will format them into paragraphs for an annotated bibliography.
Several %X fields may be given if several
annotation paragraphs are desired.
The
.B \-x
flag will suppress the printing of these abstracts.
.PP
A user-defined set of macros
may be specified after the
.B \-m
option.
There should be a space between the
.B \-m
and the macro filename.
This set of macros will replace the ones
defined in /usr/lib/tmac/tmac.bib.
The
.B \-V
flag will send output to the Versatec; the
.B \-Q
flag will queue output for the phototypesetter.
.PP
Four command-line registers control formatting style
of the bibliography, much like the number registers of
.IR ms (7).
The command-line argument
.BR \-r N1
will number
the references starting at one (1).
The flag
.BR \-r V2
will double space the biblio\%graphy,
while
.BR \-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
.BR \-r L6i
argument,
and the page offset can be set from the default of 0
to one inch by specifying
.BR \-r O1i
(capital O, not zero).
Note: with the
.B \-V
and
.B \-Q
flags
the default page offset is already one inch.
.SH FILES
.ta \w'/usr/lib/tmac/tmac.bib\0\0'u
.nf
/usr/lib/tmac/tmac.bib	file of macros used by \fInroff/troff\fP
.fi
.SH SEE ALSO
refer(1), addbib(1), sortbib(1), indxbib(1), lookbib(1)
.SH AUTHORS
Greg Shenaut, Bill Tuthill
.SH BUGS
Users have to rewrite macros
to create customized formats.
Commit	Line	Data
6d4c8433 C	1	.TH ROFFBIB 1 "18 July 1983"
	2	.UC 4
	3	.SH NAME
	4	roffbib \- run off bibliographic database
	5	.SH SYNOPSIS
	6	.B roffbib
	7	[
	8	.B \-e
	9	] [
	10	.B \-h
	11	] [
	12	.B \-n
	13	] [
	14	.B \-o
	15	] [
	16	.B \-r
	17	] [
	18	.B \-s
	19	] [
	20	.BI \-T term
	21	] [
	22	.B \-x
	23	] [
	24	.B \-m
	25	.I mac
	26	] [
	27	.B \-V
	28	] [
	29	.B \-Q
	30	] [ file ... ]
	31	.SH DESCRIPTION
	32	.I Roffbib
	33	prints out all records in a bibliographic database,
	34	in bibliography format rather than as footnotes or endnotes.
	35	Generally it is used in conjunction with
	36	.IR sortbib :
	37	.LP
	38	.RS
	39	sortbib database \| roffbib
	40	.RE
	41	.LP
	42	.I Roffbib
	43	accepts most of the options understood by
	44	.IR nroff (1),
	45	most importantly the
	46	.B \-T
	47	flag to specify terminal type.
	48	.PP
	49	If abstracts or comments are entered following the %X field key,
	50	.I roffbib
	51	will format them into paragraphs for an annotated bibliography.
	52	Several %X fields may be given if several
	53	annotation paragraphs are desired.
	54	The
	55	.B \-x
	56	flag will suppress the printing of these abstracts.
	57	.PP
	58	A user-defined set of macros
	59	may be specified after the
	60	.B \-m
	61	option.
	62	There should be a space between the
	63	.B \-m
	64	and the macro filename.
65	This set of macros will replace the ones
66	defined in /usr/lib/tmac/tmac.bib.
67	The
68	.B \-V
69	flag will send output to the Versatec; the
70	.B \-Q
71	flag will queue output for the phototypesetter.
72	.PP
73	Four command-line registers control formatting style
74	of the bibliography, much like the number registers of
75	.IR ms (7).
76	The command-line argument
77	.BR \-r N1
78	will number
79	the references starting at one (1).
80	The flag
81	.BR \-r V2
82	will double space the biblio\%graphy,
83	while
84	.BR \-r V1
85	will double space references
86	but single space annotation paragraphs.
87	The line length can be changed from the default 6.5 inches
88	to 6 inches with the
89	.BR \-r L6i
90	argument,
91	and the page offset can be set from the default of 0
92	to one inch by specifying
93	.BR \-r O1i
94	(capital O, not zero).
95	Note: with the
96	.B \-V
97	and
98	.B \-Q
99	flags
100	the default page offset is already one inch.
101	.SH FILES
102	.ta \w'/usr/lib/tmac/tmac.bib\0\0'u
103	.nf
104	/usr/lib/tmac/tmac.bib file of macros used by \fInroff/troff\fP
105	.fi
106	.SH SEE ALSO
107	refer(1), addbib(1), sortbib(1), indxbib(1), lookbib(1)
108	.SH AUTHORS
109	Greg Shenaut, Bill Tuthill
110	.SH BUGS
111	Users have to rewrite macros
112	to create customized formats.