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 specify 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 Filliâtre and Claude Marché.  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.

                                                                                                      BIB2BIB(1)