Debian Codegraph @

upstream/debian-unstable/man1/lookbib.1

raw
1 .TH \%lookbib 1 "2026-04-22" "groff 1.24.1"
2 .SH Name
3 \%lookbib \- search bibliographic databases interactively
4 .
5 .
6 .\" ====================================================================
7 .\" Legal Terms
8 .\" ====================================================================
9 .\"
10 .\" Copyright (C) 1989-2024 Free Software Foundation, Inc.
11 .\"
12 .\" Permission is granted to make and distribute verbatim copies of this
13 .\" manual provided the copyright notice and this permission notice are
14 .\" preserved on all copies.
15 .\"
16 .\" Permission is granted to copy and distribute modified versions of
17 .\" this manual under the conditions for verbatim copying, provided that
18 .\" the entire resulting derived work is distributed under the terms of
19 .\" a permission notice identical to this one.
20 .\"
21 .\" Permission is granted to copy and distribute translations of this
22 .\" manual into another language, under the above conditions for
23 .\" modified versions, except that this permission notice may be
24 .\" included in translations approved by the Free Software Foundation
25 .\" instead of in the original English.
26 .
27 .
28 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
29 .do nr *groff_lookbib_1_man_C \n[.cp]
30 .cp 0
31 .
32 .\" Define fallback for groff 1.23's MR macro if the system lacks it.
33 .nr do-fallback 0
34 .if !\n(.f .nr do-fallback 1 \" mandoc
35 .if \n(.g .if !d MR .nr do-fallback 1 \" older groff
36 .if !\n(.g .nr do-fallback 1 \" non-groff *roff
37 .if \n[do-fallback] \{\
38 . de MR
39 . ie \\n(.$=1 \
40 . I \%\\$1
41 . el \
42 . IR \%\\$1 (\\$2)\\$3
43 . .
44 .\}
45 .rr do-fallback
46 .
47 .
48 .\" ====================================================================
49 .SH Synopsis
50 .\" ====================================================================
51 .
52 .SY \%lookbib
53 .RB [ \-i\~\c
54 .IR string ]
55 .RB [ \-t\~\c
56 .IR n ]
57 .I file
58 \&.\|.\|.\&
59 .YS
60 .
61 .
62 .P
63 .SY \%lookbib
64 .B \-\-help
65 .YS
66 .
67 .
68 .P
69 .SY \%lookbib
70 .B \-v
71 .YS
72 .
73 .SY \%lookbib
74 .B \%\-\-version
75 .YS
76 .
77 .
78 .\" ====================================================================
79 .SH Description
80 .\" ====================================================================
81 .
82 .I \%lookbib
83 writes a prompt to the standard error stream
84 (unless the standard input stream is not
85 a terminal),
86 reads from the standard input a line containing a set of keywords,
87 searches each bibliographic database
88 .I file
89 for references containing those keywords,
90 writes any references found to the standard output stream,
91 and repeats this process until the end of input.
92 .
93 For each database
94 .I file
95 to be searched,
96 if an index
97 .RI file \%.i
98 created by
99 .MR \%indxbib 1
100 exists,
101 then it will be searched instead;
102 each index can cover multiple databases.
103 .
104 .
105 .\" ====================================================================
106 .SH Options
107 .\" ====================================================================
108 .
109 .B \-\-help
110 displays a usage message,
111 while
112 .B \-v
113 and
114 .B \%\-\-version
115 show version information;
116 all exit afterward.
117 .
118 .
119 .TP
120 .BI \-i\~ string
121 When searching files for which no index exists,
122 ignore the contents of fields whose names are in
123 .IR string .
124 .
125 .
126 .TP
127 .BI \-t\~ n
128 Require only the first
129 .I n
130 characters of keys to be given.
131 .
132 The default
133 is\~6.
134 .
135 .
136 .\" ====================================================================
137 .SH "Exit status"
138 .\" ====================================================================
139 .
140 .I \%lookbib
141 exits with
142 .RB status\~ 0
143 on successful operation,
144 .RB status\~ 2
145 if the program cannot interpret its command-line arguments,
146 and
147 .RB status\~ 1
148 if it encounters an error during operation.
149 .
150 .
151 .\" ====================================================================
152 .SH Files
153 .\" ====================================================================
154 .
155 .TP
156 .RI file \%.i
157 Index files.
158 .
159 .
160 .\" ====================================================================
161 .SH "See also"
162 .\" ====================================================================
163 .
164 \[lq]Some Applications of Inverted Indexes on the Unix System\[rq],
165 by M.\& E.\& Lesk,
166 1978,
167 AT&T Bell Laboratories Computing Science Technical Report No.\& 69.
168 .
169 .
170 .LP
171 .MR \%refer 1 ,
172 .MR lkbib 1 ,
173 .MR \%indxbib 1
174 .
175 .
176 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
177 .cp \n[*groff_lookbib_1_man_C]
178 .do rr *groff_lookbib_1_man_C
179 .
180 .\" Local Variables:
181 .\" fill-column: 72
182 .\" mode: nroff
183 .\" End:
184 .\" vim: set filetype=groff textwidth=72: