Return to lookbib.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/lookbib.1, revision 1.1

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