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