BibTool Manual Reference Manual Selecting Items Extracting by aux Files

Extracting by aux Files

BibTool includes a module to extract BibTeX entries required for a document. This is accomplished by analyzing the aux file of the document. The aux file is usually produced by LaTeX. It contains the information which BibTeX files and which references are used in the document. Only those entries mentioned in the aux file are selected for printing. Since the BibTeX files are already named in the aux file it is not necessary to specify an input file.

To use an aux file the command line option -x can be given. This option is followed by the name of the aux file.

bibtool -x file.aux

Multiple files can be given this way. As always the same functionality can be requested with a resource. The resource extract.file can be used for this purpose.

extract.file = {file.aux}

A small difference exists between the two variants. the command line option automatically sets the resource print.all.strings to off. This has to be done in the resource file manually.

One special feature of BibTeX is supported. If the command \nocite{*} is given in the LaTeX file then all entries of the bibliography files are included in the bibliography. The same behavior is imitated by the extracting mechanism of BibTool.

An example of extracting can be seen in section Extracting Entries for a Document on page Extracting Entries for a Document.

BibTool Manual Reference Manual Selecting Items Extracting by aux Files