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

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.