*** UNIX MANUAL PAGE BROWSER ***

REFER(1) General Commands Manual 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 con- tain 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 packages such as ms(6) print the fin- ished 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 numbers nor la- bels). -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 collected so far. Collapse references to the same source. -kx Instead of numbering references, use labels as specified 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 publication. 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 re- spectively 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 accordingly. Implies -e. The key-letters in keys may be followed by a number to in- dicate how many such fields are used, with + taken as a very large number. The default is AD which sorts on the senior au- thor 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: Author name Title of book containing article referenced City Date Alternate date Editor of book containing article referenced Government (CFSTI) order number Issuer (publisher) Journal Other keywords to use in locating reference Technical memorandum number Issue number within volume Other commentary to be printed at end of reference Page numbers Report number Alternate report number Title of article, book, etc. Volume number Commentary unused by pubindex Except for 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 biblio- graphic data base for references that contain 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 bibliographic 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). alice REFER(1)