NAME
BibX2bib - Filter BibTeX data bases
SYNOPSIS
bib2bib [options] <filename> ...
DESCRIPTION
bib2bib is a filter tool that reads one or several bibliography files,
filters the entries with respect to a given criterion, and outputs the
list of selected keys together with a new bibliography file containing
only the selected entries. If no input file is given then input is
taken from the standard input.
Additionally, bib2bib may output a file containing all the keys of
entries that satisfy the condition. This second file is suitable for
input as option -citefile to bibtex2html
OPTIONS
-ob filename
specify the filename where the selected entries are output. If
not given, it defaults to standard output.
-oc filename
specify the filename where the list of selected keys is output.
If not given, this file is not created.
-c condition
specify a condition for selecting the entries. The output will
retain only the entries that satisfy this condition. If several
such condition are given, then only the entries that satisfy all
the conditions are selected. The syntax of conditions is
described in the complete documentation, notice that it is
better to escape shell expansions in that conditions, in other
words, you should write conditions between quotes.
-expand
expand all abbreviations in the output file. Notice that there
is no way to ask for expansion of cross-references, since the
meaning of such an expansion is unclear: it’s better to let
bibtex (via bibtex2html) handle the cross-references himself,
depending on the style considered.
-s field
sorts the entries of the bibliography with respect to the given
field, which may be $key or $type to refer to the key or to the
entry type, as for filter conditions. This options may be used
several times to specifiy a lexicographic order, such as by
year, then by keys. When the field is $date then entries are
sorted chronologically.
When sorting, the resulting bibliography will always contain the
comments first, then the preambles, then the abbreviations, and
finally the regular entries. Be warned that such a sort may put
cross-references before entries that refer to them, so be
cautious.
-r reverses the sort
-q , --quiet
be quiet.
-w , --warn-error
stop at the first warning.
USAGE WITH BIBTEX2HTML
Notice that the two output files are suitable for use with bibtex2html.
A typical use would be
bib2bib -oc citefile -ob bibfile.bib -c condition file1.bib
file2.bib ...
bibtex2html -citefile citefile bibfile.bib
which will produce exactly the HTML file for the selected references.
Notice finally that bibtex2html will expand the strings (by default,
unless you specify the -noexpand option) but not the cross-references.
AUTHOR
Bib2bib has been written by Jean-Christophe Filliatre and Claude
Marche. This manpage has been compiled by Ralf Treinen from the
original bib2bib documentation.
SEE ALSO
bibtex2html(1),bibtex(1),hevea(1)
http://www.lri.fr/~filliatr/bibtex2html/
For complete documentation, please check the bibtex2html manual. On a
Debian system the manual can be found at /usr/share/doc/bibtex2html
both in the formats postscript and HTML, or via the Debian help system.