-.TH REFER 1 "18 July 1983"
-.AT 3
-.SH NAME
-refer \- find and insert literature references in documents
-.SH SYNOPSIS
-.B refer
-[
-.B \-a
-] [
-.B \-b
-] [
-.B \-c
-] [
-.B \-e
-] [
-.BI \-f n
-] [
-.BI \-k x
-] [
-.BI \-l m,n
-] [
-.B \-n
-] [
-.B \-p
-bib
-] [
-.BI \-s keys
-] [
-.BI \-B l.m
-] [
-.B \-P
-] [
-.B \-S
-] [ file ... ]
-.SH DESCRIPTION
-.I Refer
+.\" This module is believed to contain source code proprietary to AT&T.
+.\" Use and redistribution is subject to the Berkeley Software License
+.\" Agreement and your Software Agreement with AT&T (Western Electric).
+.\"
+.\" @(#)refer.1 6.7 (Berkeley) 8/8/91
+.\"
+.Dd August 8, 1991
+.Dt REFER 1
+.Os ATT 7th
+.Sh NAME
+.Nm refer
+.Nd find and insert literature references in documents
+.Sh SYNOPSIS
+.Nm refer
+.Op Fl a
+.Op Fl b
+.Op Fl c
+.Op Fl e
+.Op Fl f Ns Ar n
+.Op Fl k Ns Ar x
+.Op Fl l Ns Ar m,n
+.Op Fl n
+.Op Fl p Ar bib
+.Op Fl s Ns Ar keys
+.Op Fl B Ns Ar l.m
+.Op Fl P
+.Op Fl S
+.Op Ar
+.Sh DESCRIPTION
+.Nm Refer
that finds and formats references for footnotes or endnotes.
It is also the base for a series of programs designed to
index, search, sort, and print stand-alone bibliographies,
or other data entered in the appropriate form.
that finds and formats references for footnotes or endnotes.
It is also the base for a series of programs designed to
index, search, sort, and print stand-alone bibliographies,
or other data entered in the appropriate form.
will search a bibliographic database for references
containing these keywords anywhere in the title, author, journal, etc.
The input file (or standard input)
is copied to standard output,
will search a bibliographic database for references
containing these keywords anywhere in the title, author, journal, etc.
The input file (or standard input)
is copied to standard output,
which are assumed to contain keywords,
and are replaced by information from the bibliographic database.
The user may also search different databases,
override particular fields, or add new fields.
The reference data, from whatever source, are assigned to a set of
which are assumed to contain keywords,
and are replaced by information from the bibliographic database.
The user may also search different databases,
override particular fields, or add new fields.
The reference data, from whatever source, are assigned to a set of
print the finished reference text from these strings.
By default references are flagged by footnote numbers.
print the finished reference text from these strings.
By default references are flagged by footnote numbers.
Instead of leaving the references where encountered,
accumulate them until a sequence of the form
Instead of leaving the references where encountered,
accumulate them until a sequence of the form
is encountered, and then write out all references collected so far.
Collapse references to same source.
is encountered, and then write out all references collected so far.
Collapse references to same source.
instead of the default of 1 (one).
With labels rather than numbers,
this flag is a no-op.
instead of the default of 1 (one).
With labels rather than numbers,
this flag is a no-op.
Instead of numbering references, use labels as specified in a
reference data line beginning
Instead of numbering references, use labels as specified in a
reference data line beginning
Instead of numbering references, use labels made from
the senior author's last name and the year of publication.
Only the first
Instead of numbering references, use labels made from
the senior author's last name and the year of publication.
Only the first
To use your own references,
put them in the format described below.
They can be searched more rapidly by running
To use your own references,
put them in the format described below.
They can be searched more rapidly by running
should be first, to minimize the volume
of data passed through pipes.
should be first, to minimize the volume
of data passed through pipes.
preprocessor and associated programs
expect input from a file of references
composed of records separated by blank lines.
A record is a set of lines (fields),
each containing one kind of information.
preprocessor and associated programs
expect input from a file of references
composed of records separated by blank lines.
A record is a set of lines (fields),
each containing one kind of information.
followed by a key-letter, then a blank,
and finally the contents of the field,
followed by a key-letter, then a blank,
and finally the contents of the field,
(for stand-alone bibliographies).
For a list of the most common key-letters
and their corresponding fields, see
(for stand-alone bibliographies).
For a list of the most common key-letters
and their corresponding fields, see
-.fi
-.SH FILES
-.ta \w'/usr/dict/papers\0\0'u
-/usr/dict/papers directory of default publication lists
-.br
-/usr/lib/refer directory of companion programs
-.SH SEE ALSO
-addbib(1), sortbib(1), roffbib(1), indxbib(1), lookbib(1)
-.SH AUTHOR
-Mike Lesk
-.SH BUGS
+.Ed
+.Sh FILES
+.Bl -tag -width /usr/share/dict/papers -compact
+.It Pa /usr/share/dict/papers
+Directory of default publication lists.
+.It Pa /var/db/Ind
+Default search file (for
+.Em hunt
+phase).
+.It Pa /usr/share/dict/eign
+Contains common words.
+.It Pa /usr/libexec
+Directory where companion programs reside.
+.El
+.Sh SEE ALSO
+.Xr addbib 1 ,
+.Xr sortbib 1 ,
+.Xr roffbib 1 ,
+.Xr indxbib 1 ,
+.Xr lookbib 1
+.Sh HISTORY
+The
+.Nm Refer
+command appeared in
+.At v7 .
+.Sh AUTHOR
+.An Mike Lesk
+.Sh BUGS
Blank spaces at the end of lines in bibliography fields
will cause the records to sort and reverse incorrectly.
Sorting large numbers of references causes a core dump.
Blank spaces at the end of lines in bibliography fields
will cause the records to sort and reverse incorrectly.
Sorting large numbers of references causes a core dump.