32v 1m lookbib
From Computer History Wiki
REFER(1) UNIX Programmer's Manual REFER(1)
Contents
NAME
refer, lookbib - find and insert literature references in documents
SYNOPSIS
refer [ option ] ...
lookbib [ file ] ...
DESCRIPTION
_L_o_o_k_b_i_b 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.
_R_e_f_e_r is a preprocessor for _n_r_o_f_f or _t_r_o_f_f(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 _l_o_o_k_b_i_b, 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 _t_r_o_f_f strings. Macro packages such as _m_s(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:
-a_r 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 numbers nor labels).
-c_s_t_r_i_n_g Capitalize (with CAPS SMALL CAPS) the fields whose key-letters are in _s_t_r_i_n_g.
-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.
-k_x Instead of numbering references, use labels as specified in a reference data line beginning %_x; by default _x is L.
-l_m,_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.
-s_k_e_y_s Sort references by fields whose key-letters are in the _k_e_y_s string; permute reference numbers in text accord- ingly. Implies -e. The key-letters in _k_e_y_s 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 _p_u_b_i_n_d_e_x(1) They can be searched more rapidly by running _p_u_b_i_n_d_e_x(1) on them before using _r_e_f_e_r; failure to index results in a linear search.
When _r_e_f_e_r is used with _e_q_n, _n_e_q_n or _t_b_l, _r_e_f_e_r should be first, to minimize the volume of data passed through pipes.
FILES
/_u_s_r/_d_i_c_t/_p_a_p_e_r_s directory of default publication lists and indexes /_u_s_r/_l_i_b/_r_e_f_e_r directory of programs