Return to lookbib.1 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man1

Annotation of cci/usr/src/man/man1/lookbib.1, revision 1.1.1.1

1.1       root        1: .TH LOOKBIB 1 "18 July 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: indxbib, lookbib \- build inverted index for a bibliography, find references in a bibliography
                      5: .SH SYNOPSIS
                      6: .B indxbib
                      7: database  ...
                      8: .br
                      9: .B lookbib
                     10: database
                     11: .SH DESCRIPTION
                     12: .I Indxbib
                     13: makes an inverted index to the named
                     14: .I databases
                     15: (or files) for use by
                     16: .IR lookbib (1)
                     17: and
                     18: .IR refer (1).
                     19: These files contain bibliographic references
                     20: (or other kinds of information) separated by blank lines.
                     21: .PP
                     22: A bibliographic reference is a set of lines,
                     23: constituting fields of bibliographic information.
                     24: Each field starts on a line beginning with a ``%'',
                     25: followed by a key-letter, then a blank,
                     26: and finally the contents of the field,
                     27: which may continue until the next line starting with ``%''.
                     28: .PP
                     29: .I Indxbib 
                     30: is a shell script that calls
                     31: /usr/lib/refer/mkey and /usr/lib/refer/inv.
                     32: The first program,
                     33: .I mkey,
                     34: truncates words to 6 characters,
                     35: and maps upper case to lower case.
                     36: It also discards words shorter than 3 characters,
                     37: words among the 100 most common English words,
                     38: and numbers (dates) < 1900 or > 2000.
                     39: These parameters can be changed; see page 4 of the
                     40: .I Refer
                     41: document by Mike Lesk.
                     42: The second program,
                     43: .I inv,
                     44: creates an entry file (.ia),
                     45: a posting file (.ib), and a tag file (.ic),
                     46: all in the working directory.
                     47: .PP
                     48: .I Lookbib
                     49: uses an inverted index made by
                     50: .I indxbib
                     51: to find sets of bibliographic references.
                     52: It reads keywords typed after the ``>'' prompt on the terminal,
                     53: and retrieves records containing all these keywords.
                     54: If nothing matches, nothing is returned except another ``>'' prompt.
                     55: .PP
                     56: It is possible to search multiple databases,
                     57: as long as they have a common index made by
                     58: .I indxbib.
                     59: In that case, only the first argument given to
                     60: .I indxbib
                     61: is specified to
                     62: .I lookbib.
                     63: .PP
                     64: If
                     65: .I lookbib
                     66: does not find the index files (the .i[abc] files),
                     67: it looks for a reference file with the same name as the argument,
                     68: without the suffixes.
                     69: It creates a file with a '.ig' suffix, suitable for use with
                     70: .I fgrep.
                     71: It then uses this fgrep file to find references.
                     72: This method is simpler to use, but the .ig file is slower to use
                     73: than the .i[abc] files, and does not allow the use of multiple reference files.
                     74: .SH FILES
                     75: .IR x .ia,
                     76: .IR x .ib,
                     77: .IR x .ic,
                     78: where 
                     79: .I x
                     80: is the first argument, or if these are not present, then
                     81: .IR x .ig,
                     82: .IR x
                     83: .SH SEE ALSO
                     84: refer(1), addbib(1), sortbib(1), roffbib(1), lookbib(1)
                     85: .SH BUGS
                     86: Probably all dates should be indexed,
                     87: since many disciplines refer to literature
                     88: written in the 1800s or earlier.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.