summaryrefslogtreecommitdiff
path: root/biblio/bibtex/utils/bibindex/biblook.man
blob: d39c874791f4166c1fa65d342f2857b164fc58bd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
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]========================