REFER(1) REFER(1) NAME refer, lookbib - find and insert literature references in documents SYNOPSIS refer [ option ] ... lookbib [ file ] ... DESCRIPTION Lookbib accepts keywords from the standard input and searches a bibliographic data base for references that con- tain those keywords anywhere in title, author, journal name, etc. Matching references are printed on the standard out- put. Blank lines are taken as delimiters between queries. 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 .] command lines, which are assumed to con- tain keywords as for lookbib, and are replaced by informa- tion 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 packages such as ms(7) 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 numbers. 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. REFER(1) REFER(1) -kx Instead of numbering references, use labels as speci- fied in a reference data line beginning %x; by default 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. To use your own references, put them in the format described in pubindex(1) They can be searched more rapidly by running pubindex(1) on them before using refer; failure to index results in a linear search. When refer is used with eqn, neqn or tbl, refer should be first, to minimize the volume of data passed through pipes. FILES /usr/dict/papers directory of default publication lists and indexes /usr/lib/refer directory of programs SEE ALSO