REFER(1)                     (alice)                     REFER(1)

     NAME
          refer, lookbib, pubindex - find and insert literature
          references in documents

     SYNOPSIS
          refer [ option ] ...

          lookbib [ file ] ...

          pubindex 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 .]  which are assumed to contain 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 pack-
          ages 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 num-
          bers.

          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

     REFER(1)                     (alice)                     REFER(1)

               collected so far.  Collapse references to the same
               source.

          -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.

          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 a `%', 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:

               A    Author name
               B    Title of book containing article referenced
               C    City
               D    Date
               d    Alternate date
               E    Editor of book containing article referenced
               G    Government (CFSTI) order number
               I    Issuer (publisher)
               J    Journal
               K    Other keywords to use in locating reference
               M    Technical memorandum number
               N    Issue number within volume
               O    Other commentary to be printed at end of reference
               P    Page numbers

     REFER(1)                     (alice)                     REFER(1)

               R    Report number
               r    Alternate report number
               T    Title of article, book, etc.
               V    Volume number
               X    Commentary unused by pubindex

          Except for `A', each field should only be given once.  Only
          relevant fields should be supplied.  An example is:

               %T 5-by-5 Palindromic Word Squares
               %A M. D. McIlroy
               %J Word Ways
               %V 9
               %P 199-202
               %D 1976

          When refer is used with eqn, neqn or tbl, refer should be
          first, to minimize the volume of data passed through pipes.

          Pubindex makes a hashed inverted index to the named files
          for use by refer. The files contain bibliographic refer-
          ences.

     FILES
          /usr/dict/papers  directory of default publication lists and
          indexes
          /usr/lib/refer    directory of programs
          xFR.ia, xFR.ib, xFR.icwhere x is the first argument to
          pubindex

     SEE ALSO
          troff(1), doctype(1)