summaryrefslogtreecommitdiff
path: root/biblio/bibtex/utils/bibindex/biblook.man
diff options
context:
space:
mode:
Diffstat (limited to 'biblio/bibtex/utils/bibindex/biblook.man')
-rw-r--r--biblio/bibtex/utils/bibindex/biblook.man122
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]========================