MirOS Manual: indxbib(1), lookbib(1)

LOOKBIB(1)                   BSD Reference Manual                   LOOKBIB(1)

NAME

     indxbib, lookbib - build inverted index for a bibliography, find refer-
     ences in a bibliography

SYNOPSIS

     indxbib database ...
     lookbib [-n] database

DESCRIPTION

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

     Indxbib is a shell script which calls mkey and inv. The first program,
     mkey, 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 Refer document by Mike Lesk
     (See the SEE ALSO section below). The second program, inv, creates an en-
     try file (file.ia), a posting file (file.ib), and a tag file (file.ic),
     all in the working directory.

     Lookbib uses an inverted index made by indxbib 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.

     Lookbib will ask if you need instructions, and will print some brief in-
     formation if you reply "y". The -n flag turns off the prompt for instruc-
     tions.

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

     If lookbib does not find the index files (the file.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 fileig is slower to use than the
     file.i[abc] files, and does not allow the use of multiple reference
     files.

FILES

     *.ia           Entry file.
     *.ib           Posting file.
     *.ic           Tag file.
     *.ig           Ascii file created if index files not found.
     /usr/bin/mkey  Make keys program.
     /usr/bin/inv   Hash and invert program.

SEE ALSO

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

BUGS

     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.

HISTORY

     A lookbib command appeared in Version 32V AT&T UNIX.

4.2 Berkeley Distribution     November 22, 2009                              1

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.