1REFER(1)                    General Commands Manual                   REFER(1)
2
3
4

NAME

6       refer, lookbib - find and insert literature references in documents
7

SYNOPSIS

9       refer [ option ] ...
10
11       lookbib [ file ] ...
12

DESCRIPTION

14       Lookbib accepts keywords from the standard input and searches a biblio‐
15       graphic data base for references that contain those  keywords  anywhere
16       in  title,  author, journal name, etc.  Matching references are printed
17       on the standard output.  Blank lines are taken  as  delimiters  between
18       queries.
19
20       Refer  is  a  preprocessor for nroff or troff(1) that finds and formats
21       references.  The input files (standard input default) are copied to the
22       standard  output,  except  for  lines between .[ and .]  command lines,
23       which are assumed to contain keywords as for lookbib, and are  replaced
24       by  information  from  the bibliographic data base.  The user may avoid
25       the search, override fields from it, or add new fields.  The  reference
26       data,  from  whatever  source,  are assigned to a set of troff strings.
27       Macro packages such as ms(7) print the  finished  reference  text  from
28       these strings.  A flag is placed in the text at the point of reference;
29       by default the references are indicated by numbers.
30
31       The following options are available:
32
33       -ar   Reverse the first r author names (Jones, J. A. instead of  J.  A.
34             Jones).  If r is omitted all author names are reversed.
35
36       -b    Bare  mode:  do  not  put  any flags in text (neither numbers nor
37             labels).
38
39       -cstring
40             Capitalize (with CAPS SMALL CAPS) the  fields  whose  key-letters
41             are in string.
42
43       -e    Instead  of  leaving the references where encountered, accumulate
44             them until a sequence of the form
45                       .[
46                       $LIST$
47                       .]
48             is encountered, and then write out all  references  collected  so
49             far.  Collapse references to the same source.
50
51       -kx   Instead  of  numbering  references,  use labels as specified in a
52             reference data line beginning %x; by default x is L.
53
54       -lm,n Instead of numbering references, use labels made from the  senior
55             author's last name and the year of publication.  Only the first m
56             letters of the last name and the last n digits of  the  date  are
57             used.   If  either  m  or  ,n  is omitted the entire name or date
58             respectively is used.
59
60       -p    Take the next argument as a file of references  to  be  searched.
61             The default file is searched last.
62
63       -n    Do not search the default file.
64
65       -skeys
66             Sort  references  by  fields  whose  key-letters  are in the keys
67             string; permute reference numbers in text  accordingly.   Implies
68             -e.  The key-letters in keys may be followed by a number to indi‐
69             cate how many such fields are used, with + taken as a very  large
70             number.   The  default is AD which sorts on the senior author and
71             then date; to sort, for example, on all authors  and  then  title
72             use -sA+T.
73
74       To  use  your  own  references,  put  them  in  the format described in
75       pubindex(1) They can be searched more rapidly by running pubindex(1) on
76       them before using refer; failure to index results in a linear search.
77
78       When  refer  is  used  with eqn, neqn or tbl, refer should be first, to
79       minimize the volume of data passed through pipes.
80

FILES

82       /usr/dict/papers directory of default publication lists and indexes
83       /usr/lib/refer directory of programs
84

SEE ALSO

86                                                                      REFER(1)
Impressum