NAME
bibtex - make a bibliography for (La)TeX
SYNOPSIS
bibtex [ -min-crossrefs=number ] [ -terse ] [ auxname ]
DESCRIPTION
This manual page is not meant to be exhaustive. The complete
documentation for this version of TeX can be found in the info file or
manual Web2C: A TeX implementation.
BibTeX reads the top-level auxiliary (.aux) file that was output during
the running of latex(1) or tex(1) and creates a bibliography (.bbl)
file that will be incorporated into the document on subsequent runs of
LaTeX or TeX. The auxname on the command line must be given without
the .aux extension. If you don't give the auxname, the program prompts
you for it.
BibTeX looks up, in bibliographic database (.bib) files specified by
the \bibliography command, the entries specified by the \cite and
\nocite commands in the LaTeX or TeX source file. It formats the
information from those entries according to instructions in a
bibliography style (.bst) file (specified by the \bibliographystyle
command, and it outputs the results to the .bbl file.
The LaTeX manual explains what a LaTeX source file must contain to work
with BibTeX. Appendix B of the manual describes the format of the .bib
files. The `BibTeXing' document describes extensions and details of
this format, and it gives other useful hints for using BibTeX.
OPTIONS
The -min-crossrefs option defines the minimum number of crossref
required for automatic inclusion of the crossref'd entry on the
citation list; the default is two. With the -terse option, BibTeX
operates silently. Without it, a banner and progress reports are
printed on stdout.
ENVIRONMENT
BibTeX searches the directories in the path defined by the BSTINPUTS
environment variable for .bst files. If BSTINPUTS is not set, it uses
the system default. For .bib files, it uses the BIBINPUTS environment
variable if that is set, otherwise the default. See tex(1) for the
details of the searching.
If the environment variable TEXMFOUTPUT is set, BibTeX attempts to put
its output files in it, if they cannot be put in the current directory.
Again, see tex(1). No special searching is done for the .aux file.
FILES
*.bst Bibliography style files.
btxdoc.tex
``BibTeXing'' - LaTeXable documentation for general BibTeX users
btxhak.tex
``Designing BibTeX Styles'' - LaTeXable documentation for style
designers
btxdoc.bib
database file for those two documents
xampl.bib
database file giving examples of all standard entry types
btxbst.doc
template file and documentation for the standard styles
All those files should be available somewhere on your system.
The host math.utah.edu has a vast collection of .bib files available
for anonymous ftp, including references for all the standard TeX books
and a complete bibliography for TUGboat.
SEE ALSO
latex(1), tex(1).
Leslie Lamport, LaTeX - A Document Preparation System, Addison-Wesley,
1985, ISBN 0-201-15790-X.
AUTHOR
Oren Patashnik, Stanford University. This man page describes the web2c
version of BibTeX. Other ports of BibTeX, such as Donald Knuth's
version using the Sun Pascal compiler, do not have the same path
searching implementation, or the command-line options.