nbibfind(1) find bibliography entries for BibTeX or NbibTeX

SYNOPSIS

nbibfind [-terse|-full|-bib] query [bibname...]

DESCRIPTION

nbibfind searches for BibTeX entries using the same query algorithm as NbibTeX. If the optional list of bibnames is given, it searches only those bibliographies; otherwise, it searches all bibliographies on the user's BIBINPUTS (or on the standard system path). The language of query is that of nbibtex(1).

OPTIONS

-terse
Print a one-line summary of each matched entry (the default).
-full
Print a longer summary of each matched entry, including full authors, year, and title, possibly spread over multiple lines.
-bib
Print each entry in a form suitable for including in a .bib file.

EXAMPLES

nbibfind author=knuth:series=art-programming:volume=2
nbibfind knuth:seminumerical personal.bib
nbibfind harper-moggi:phase
nbibfind :essence-algol
nbibfind :essence-functional

QUERY LANGUAGE

The query language is that of nbibtex(1).

A query consists of a sequence of one or more constraints separated by colons. A constraint may be empty.

A nonempty constraint is of the form key=words, where key is the name of a field in the NbibTeX entry and words is a sequence of one or more words separated by dashes. The contraint is satisfied if every word in words is found in the field named by key. (The key may also be [type], which matches agains the type of the entry, or *, which looks for words in any field.)

As a convenience, keys may be defaulted in up to three constraints. In the first constraint, the default key is author. In the second constraint, the default key is year if words is all digits, and is title otherwise. In the third constraint, the default key is year if words is all digits, and is [type] otherwise.

To match a word in words, nbibfind uses the Boyer-Moore string-matching algorithm, so longer words are usually faster.

ENVIRONMENT

For .bib files, nbibfind uses the BIBINPUTS environment variable if that is set, otherwise the default. For details of the searching, see tex(1) and kpsewhich(1).

AUTHOR

Norman Ramsey, Harvard University.