4.3BSD-Reno/share/man/cat1/lookbib.0

LOOKBIB(1)		    UNIX Reference Manual		    LOOKBIB(1)

NNAAMMEE
     iinnddxxbbiibb, llooookkbbiibb - build inverted index for a bibliography, find refer-
     ences in a bibliography

SSYYNNOOPPSSIISS
     iinnddxxbbiibb _d_a_t_a_b_a_s_e ...
     llooookkbbiibb [--nn] _d_a_t_a_b_a_s_e

DDEESSCCRRIIPPTTIIOONN
     IInnddxxbbiibb builds an inverted index to the named _d_a_t_a_b_a_s_e_s (or files), which
     can then be used by llooookkbbiibb and refer(1).	The files are assumed to be
     refer style bibliographic databases (see addbib(1)).

     IInnddxxbbiibb is a shell script which calls mmkkeeyy and iinnvv.  The first program,
     mmkkeeyy, truncates words to 6 characters, and maps upper case to lower case.
     It also discards words shorter than 3 characters, words among the 100
     most common English words, and numbers (dates) < 1900 or > 2000.  These
     parameters can be changed; see page 4 of a _R_e_f_e_r document by Mike Lesk
     (See the SEE ALSO section below).	The second program, iinnvv, creates an
     entry file (_f_i_l_e.ia), a posting file (_f_i_l_e.ib), and a tag file (_f_i_l_e.ic),
     all in the working directory.

     LLooookkbbiibb uses an inverted index made by iinnddxxbbiibb to find sets of biblio-
     graphic references.  It reads keywords typed after the ``>'' prompt on
     the terminal, and retrieves records containing all these keywords.  If
     nothing matches, nothing is returned except another ``>'' prompt.

     LLooookkbbiibb will ask if you need instructions, and will print some brief in-
     formation if you reply ``y''.  The --nn flag turns off the prompt for in-
     structions.

     It is possible to search multiple databases, as long as they have a com-
     mon index made by iinnddxxbbiibb.  In that case, only the first argument given
     to iinnddxxbbiibb is specified to llooookkbbiibb.

     If llooookkbbiibb does not find the index files (the (_f_i_l_e.i[abc] files), it
     looks for a reference file with the same name as the argument, without
     the suffixes.  It creates a file with a `.ig' suffix, suitable for use
     with fgrep(1).  It then uses this fgrep file to find references.  This
     method is simpler to use, but the _f_i_l_e.ig is slower to use than the
     _f_i_l_e.i[abc] files, and does not allow the use of multiple reference
     files.

FFIILLEESS
     *._i_a		 entry file
     *._i_b		 posting file
     *._i_c		 tag file
     *._i_g		 ascii file created if index files not found.
     /_u_s_r/_l_i_b_e_x_e_c/_m_k_e_y	 make keys program
     /_u_s_r/_l_i_b_e_x_e_c/_i_n_v	 hash and invert program


SSEEEE AALLSSOO
     refer(1), addbib(1), sortbib(1), roffbib(1), lookbib(1)

BBUUGGSS
     More than one blank line in between citations can wreak havoc.

     Probably all dates should be indexed, since many disciplines refer to
     literature written in the 1800s or earlier.

HHIISSTTOORRYY
     A llooookkbbiibb appeared in Version 32 AT&T Unix.