Initial commit

1 files changed, 122 insertions, 0 deletions

diff --git a/biblio/bibtex/utils/bibindex/biblook.man b/biblio/bibtex/utils/bibindex/biblook.man
new file mode 100644
index 0000000000..d39c874791
--- /dev/null
+++ b/biblio/bibtex/utils/bibindex/biblook.man
@@ -0,0 +1,122 @@
+.\" ====================================================================
+.\"  @Troff-man-file{
+.\"     author          = "Nelson H. F. Beebe",
+.\"     version         = "1.00",
+.\"     date            = "30 September 1992",
+.\"     time            = "16:48:22 MDT",
+.\"     filename        = "biblook.man",
+.\"     address         = "Center for Scientific Computing
+.\"                        Department of Mathematics
+.\"                        University of Utah
+.\"                        Salt Lake City, UT 84112
+.\"                        USA
+.\"                        Tel: +1 801 581 5254
+.\"                        FAX: +1 801 581 4148",
+.\"     checksum        = "20001 122 646 4560",
+.\"     email           = "beebe@math.utah.edu (Internet)",
+.\"     codetable       = "ISO/ASCII",
+.\"     keywords        = "bibliography, BibTeX",
+.\"     supported       = "yes",
+.\"     docstring       = "This file is the UNIX nroff/troff manual page
+.\"                        documentation for biblook, a BibTeX bibliography
+.\"                        lookup program.
+.\"
+.\"                        The checksum field above contains a CRC-16
+.\"                        checksum as the first value, followed by the
+.\"                        equivalent of the standard UNIX wc (word
+.\"                        count) utility output of lines, words, and
+.\"                        characters.  This is produced by Robert
+.\"                        Solovay's checksum utility.",
+.\"  }
+.\" ====================================================================
+.if t .ds Bi B\s-2IB\s+2T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X
+.if n .ds Bi BibTeX
+.if t .ds Te T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X
+.if n .ds Te TeX
+.TH BIBLOOK 1 "30 September 1992" "Version 2.2"
+.SH NAME
+biblook \- lookup entries in a bibliography file
+.SH SYNOPSIS
+.B "biblook \fIbasename\fP [\fIsavefile\fP]
+.SH DESCRIPTION
+.I biblook
+permits rapid lookup in a \*(Bi\& bibliography data base, using a
+compact binary index file prepared by \fIbibindex\fP(1).
+.PP
+At the prompt, the user can enter any of the following commands:
+.PP
+.TP
+.B ? or h[elp]
+Display a help message.
+.TP
+.B "f[ind] [not] <field> <words>"
+Find the entries containing the given words in any field
+with a prefix matching the <field> argument.  For example,
+`a' matches both `author' and `address', and `au' matches
+`author' only.  If the <field> argument is `-' (or any
+string with no letters or numbers), match any field.
+.IP
+If `not' appears before the <field>, the sense of the search
+is reversed.  The symbols `~' and `!' can be used in place
+of `not'.
+.IP
+Each word is a contiguous sequence of letters and digits.
+Case is ignored; accents should be omitted; apostrophes are
+not required.  Single characters and a few common words are
+also ignored.  Any word ending with an asterisk is treated
+as a prefix.  Thus, `point*' matches `point', `points',
+`pointer', etc.
+.PP
+.TP
+.BR "and [not] <field> <words>"
+.TP
+.BR "or [not] <field> <words>"
+Intersect (resp. union) the results of the given search
+with the previous search.  Several of these commands may be
+combined on a single line.  Commands are handled in the order
+in which they appear; there is no precedence.  Unlike other
+commands, and like `not', these must be spelled out
+completely.  `&' can be used in place of `and', and `|' can
+be used in place of `or'.
+.PP
+.TP
+.B "d[isplay]"
+Display the results of the previous search.
+.PP
+.TP
+.B "s[ave] [<filename>]"
+Save the results of the previous results into the specified
+file.  If <filename> is omitted, the previous save file is
+used.  If no save file has ever been specified, results are
+saved in the file specified on the command line.  If no such
+file is specified, `save.bib' is used.  If the save file
+exists, results are appended to it.
+.PP
+.TP
+.B "q[uit]/EOF"
+Quit.
+.PP
+Several commands can be combined on a single line by separating
+them with semicolons.  For example, the following command displays
+all STOC papers cowritten by Erdo"s without `Voronoi diagrams' in
+the title:
+.PP
+.nf
+f b stoc* | b symp* theory comp* & au erdos & ~t voronoi diagrams ; d
+.fi
+.PP
+.SH "SEE ALSO"
+bibclean(1), bibindex(1), bibtex(1), latex(1), tex(1)
+.SH AUTHOR
+.nf
+Jeff Erickson
+Computer Science Division
+University of California
+Berkeley, CA 94720
+USA
+Email: <jeff@cs.berkeley.edu>, <jeffe@melody.berkeley.edu>
+.fi
+.PP
+This program is in the public domain.  You may use it or modify it to
+your heart's content, at your own risk.
+.\" ========================[End of biblook.man]========================