PUBINDEX(1)         UNIX Programmer's Manual          PUBINDEX(1)

NAME
     pubindex - make inverted bibliographic index

SYNTAX
     pubindex [ file ] ...

DESCRIPTION
     _p_u_b_i_n_d_e_x makes a hashed inverted index to the named _f_i_l_e_s
     for use by _r_e_f_e_r(1).  The _f_i_l_e_s contain bibliographic refer-
     ences separated by blank lines.  A bibliographic reference
     is a set of lines that contain bibliographic information
     fields.  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
          R    Report number
          r    Alternate report number
          T    Title of article, book, etc.
          V    Volume number
          X    Commentary unused by _p_u_b_i_n_d_e_x

     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

BUGS
     The lines separating references must be completely empty; if
     there is a blank on the line, two references will be

Printed 5/16/83                                                 1

PUBINDEX(1)         UNIX Programmer's Manual          PUBINDEX(1)

     collapsed into one.
     Pubindex is a csh script; to use it with /bin/sh, try "csh
     /usr/bin/pubindex".

FILES
     _x._i_a, _x._i_b, _x._i_c where _x is the first argument.

SEE ALSO
     refer(1)
     M. E. Lesk, _S_o_m_e _A_p_p_l_i_c_a_t_i_o_n_s _o_f _I_n_v_e_r_t_e_d _I_n_d_e_x_e_s _o_n _t_h_e
     _U_N_I_X _S_y_s_t_e_m

Printed 5/16/83                                                 2