1refer(1)                         User Commands                        refer(1)
2
3
4

NAME

6       refer - expand and insert references from a bibliographic database
7

SYNOPSIS

9       refer [-ben] [-ar] [-cstring] [-kx] [-lm,n] [-p filename]
10            [-skeys] filename...
11
12

DESCRIPTION

14       refer  is a preprocessor for nroff(1), or troff(1), that finds and for‐
15       mats references. The input files (standard input by default) are copied
16       to  the standard output, except for lines between `.[' and `.]' command
17       lines, Such lines are assumed to contain keywords  as  for  lookbib(1),
18       and  are  replaced  by information from a bibliographic data base.  The
19       user can avoid the search, override fields from it, or add new  fields.
20       The reference data, from whatever source, is assigned to a set of troff
21       strings.  Macro packages such as ms(5)  print  the  finished  reference
22       text  from these strings.  A flag is placed in the text at the point of
23       reference. By default, the references are indicated by numbers.
24
25
26       When refer is used with eqn(1), neqn, or tbl(1), refer should  be  used
27       first  in  the  sequence, to minimize the volume of data passed through
28       pipes.
29

OPTIONS

31       -b             Bare mode — do not put any flags in text  (neither  num‐
32                      bers or labels).
33
34
35       -e             Accumulate  references instead of leaving the references
36                      where encountered, until a sequence of the form:
37
38                        .[
39                        $LIST$
40                        .]
41
42
43                      is encountered, and then write out all  references  col‐
44                      lected so far. Collapse references to the same source.
45
46
47       -n             Do not search the default file.
48
49
50       -ar            Reverse  the  first r author names (Jones, J. A. instead
51                      of J. A. Jones).  If r is omitted, all author names  are
52                      reversed.
53
54
55       -cstring       Capitalize  (with  SMALL CAPS) the fields whose key-let‐
56                      ters are in string.
57
58
59       -kx            Instead of numbering references, use labels as specified
60                      in  a  reference data line beginning with the characters
61                      %x; By default, x is L.
62
63
64       -lm,n          Instead of numbering references,  use  labels  from  the
65                      senior  author's  last name and the year of publication.
66                      Only the first m letters of the last name and the last n
67                      digits  of  the  date  are used.  If either of m or n is
68                      omitted, the entire name or date, respectively, is used.
69
70
71       -p filename    Take the next argument as a file  of  references  to  be
72                      searched.  The default file is searched last.
73
74
75       -skeys         Sort  references  by fields whose key-letters are in the
76                      keys string, and permute reference numbers in  the  text
77                      accordingly.  Using  this  option implies the -e option.
78                      The key-letters in keys may  be  followed  by  a  number
79                      indicating  how many such fields are used, with a + sign
80                      taken as a very large number.  The default is AD,  which
81                      sorts  on  the  senior  author  and date. To sort on all
82                      authors and then the date, for instance, use the options
83                      `-sA+T'.
84
85

FILES

87       /usr/lib/refer           directory of programs
88
89
90       /usr/lib/refer/papers    directory  of  default  publication  lists and
91                                indexes
92
93

ATTRIBUTES

95       See attributes(5) for descriptions of the following attributes:
96
97
98
99
100       ┌─────────────────────────────┬─────────────────────────────┐
101       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
102       ├─────────────────────────────┼─────────────────────────────┤
103       │Availability                 │SUNWdoc                      │
104       └─────────────────────────────┴─────────────────────────────┘
105

SEE ALSO

107       addbib(1), eqn(1), indxbib(1), lookbib(1), nroff(1), roffbib(1),  sort‐
108       bib(1), tbl(1), troff(1), attributes(5)
109
110
111
112SunOS 5.11                        14 Sep 1992                         refer(1)