REFER(1) (alice) REFER(1)
NAME
refer, lookbib, pubindex - maintain and use bibliographic
references
SYNOPSIS
refer [ option ... ] [ file ... ]
lookbib [ file ... ]
pubindex file ...
DESCRIPTION
Refer is a preprocessor for nroff or troff(1) that finds and
formats references. The input files (standard input
default) are copied to the standard output, except for lines
between `.[' and `.]' which are assumed to contain keywords
and are replaced by information from the bibliographic data
base. The user may avoid the search, override fields from
it, or add new fields. The reference data, from whatever
source, are assigned to a set of troff strings. Macro pack-
ages such as ms(6) print the finished reference text from
these strings. A flag is placed in the text at the point of
reference; by default the references are indicated by num-
bers.
The following options are available:
-ar Reverse the first r author names (Jones, J. A. instead
of J. A. Jones). If r is omitted all author names are
reversed.
-b Bare mode: do not put any flags in text (neither num-
bers nor labels).
-cstring
Capitalize (with CAPS SMALL CAPS) the fields whose
key-letters are in string.
-e Instead of leaving the references where encountered,
accumulate them until a sequence of the form
.[
$LIST$
.]
is encountered, and then write out all references col-
lected so far. Collapse references to the same source.
-kx Instead of numbering references, use labels as speci-
fied in a reference data line beginning %x; by default
REFER(1) (alice) REFER(1)
x is L.
-lm,n
Instead of numbering references, use labels made from
the senior author's last name and the year of publica-
tion. Only the first m letters of the last name and
the last n digits of the date are used. If either m or
n is omitted the entire name or date respectively is
used.
-p Take the next argument as a file of references to be
searched. The default file is searched last.
-n Do not search the default file.
-skeys
Sort references by fields whose key-letters are in the
keys string; permute reference numbers in text accord-
ingly. Implies -e. The key-letters in keys may be
followed by a number to indicate how many such fields
are used, with + taken as a very large number. The
default is AD which sorts on the senior author and then
date; to sort, for example, on all authors and then
title use -sA+T.
A bibliographic reference in a -p file is a set of lines
that contain bibliographic information fields. Empty lines
separate references. Each field starts on a line beginning
with `%', followed by a key-letter, followed by a blank, and
followed by the contents of the field, which continues until
the next line starting with `%'. The most common key-
letters and the corresponding fields are:
`A' Author name
`B' Title of book containing article referenced
`C' City
`D' Date
`d' Alternate date
`E' Editor of book containing article referenced
`G' Government (CFSTI) order number
`I' Issuer (publisher)
`J' Journal
`K' Other keywords to use in locating reference
`M' Technical memorandum number
`N' Issue number within volume
`O' Other commentary to be printed at end of reference
`P' Page numbers
`R' Report number
`r' Alternate report number
`T' Title of article, book, etc.
`V' Volume number
`X' Commentary unused by pubindex
REFER(1) (alice) REFER(1)
Except for `A', each field should only be given once. Only
relevant fields should be supplied. When refer is used with
eqn, neqn or tbl(1), refer should be first, to minimize the
volume of data passed through pipes.
Lookbib accepts keywords from the standard input and
searches a bibliographic data base for references that con-
tain those keywords anywhere in the title, author, journal
name, etc. Matching references are printed on the standard
output. Blank lines are taken as delimiters between
queries.
Pubindex makes a hashed inverted index to the named biblio-
graphic files for use by refer.
EXAMPLES
%T 5-by-5 Palindromic Word Squares
%A M. D. McIlroy
%J Word Ways
%V 9
%P 199-202
%D 1976
FILES
directory of default publication lists and indexes
directory of programs
x.ia, x.ib, x.ic where x is the first argument to pubindex
SEE ALSO
M. E. Lesk, `Some Applications of Inverted Indexes on UNIX'
in AT&T Bell Laboratories, UNIX Programmer's Manual, Volume
2, Holt-Rinehart (1984)
troff(1), doctype(1), prefer(1)
BUGS
Refer is unmaintained; better use prefer(1).