<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
                   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % entities.ent SYSTEM "entities.ent">
%entities.ent;
]>

<refentry id="miktex-bibtex">

<?dbhh topicname="MIKTEXHELP_BIBTEX" topicid="0"?>

<refmeta>
<refentrytitle>miktex-bibtex</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="source">&PACKAGE_NAME;</refmiscinfo>
<refmiscinfo class="version">&miktexrev;</refmiscinfo>
<refmiscinfo class="manual">User Commands</refmiscinfo>
</refmeta>

<refnamediv>
<refname>miktex-bibtex</refname>
<refpurpose>make a bibliography for &LaTeX;</refpurpose>
</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>
<command>miktex-bibtex</command>
<arg choice="opt" rep="repeat"><replaceable>option</replaceable></arg>
<arg  choice="plain"><replaceable>auxfile</replaceable></arg>
</cmdsynopsis>

</refsynopsisdiv>

<refsect1>

<title>Description</title>

<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="_tlack.xml" />

<para>&BibTeX; reads the top-level auxiliary
(<filename>.aux</filename>) file that was output during the running of
<citerefentry><refentrytitle>miktex-latex</refentrytitle><manvolnum>1</manvolnum></citerefentry>
<citerefentry><refentrytitle>miktex-tex</refentrytitle><manvolnum>1</manvolnum></citerefentry>
and creates a bibliography (<filename>.bbl</filename>) file that will
be
<indexterm>
<primary>.bbl (bibliography file)</primary>
</indexterm>
incorporated into the document on subsequent runs of &LaTeX; or &TeX;.
<indexterm>
<primary>bibliography</primary>
<secondary>creation</secondary>
</indexterm>
</para>

<para>&BibTeX; looks up, in bibliographic database
<indexterm>
<primary>.bib (bibliographic database)</primary>
</indexterm>
(<filename>.bib</filename>) files specified by the <markup
role="tex">\bibliography</markup> command, the entries specified by
the <markup role="tex">\cite</markup> and <markup
role="tex">\nocite</markup> commands in the &LaTeX; or &TeX; source
file.  It formats the information from those entries according to
instructions in a bibliography style (<filename>.bst</filename>) file
<indexterm>
<primary>.bst (bibliography style file)</primary>
</indexterm>
(specified by the <markup role="tex">\bibliographystyle</markup>
command, and it outputs the results to the <filename>.bbl</filename>
<indexterm>
<primary>.bbl</primary>
</indexterm>
file.</para>

<para>The &LaTeX; reference manual explains what a &LaTeX; source file
must contain to work with &BibTeX;.  Appendix&nbsp;B of the manual
describes the format of the <filename>.bib</filename> files. The
<citetitle>&BibTeX;ing</citetitle> document describes extensions and
details of this format, and it gives other useful hints for using
&BibTeX;.</para>

</refsect1>

<refsect1>

<title>Options</title>

<variablelist>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/alias.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/disableinstaller.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/enableinstaller.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/help.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/hhelp.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/includedirectory.xml" />
<varlistentry>
<term><option>--min-crossrefs=<replaceable>n</replaceable></option></term>
<listitem>
<indexterm>
<primary>--min-crossrefs=n</primary>
</indexterm>
<para>Defines the minimum number of <command>crossref</command>s
required for automatic inclusion of the
<indexterm>
<primary>cross-references</primary>
<secondary>minimum number required</secondary>
</indexterm>
crossref'd entry on the citation list; the default is
two.</para></listitem>
</varlistentry>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/quiet.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/recordpackageusages.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/trace.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/version.xml" />
</variablelist>

</refsect1>

<refsect1>

<title>Environment</title>

<variablelist>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../EnvVars/BIBINPUTS.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../EnvVars/BSTINPUTS.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../EnvVars/MIKTEX_TRACE.xml" />
</variablelist>

</refsect1>

<refsect1>

<title>See Also</title>

<simplelist type="inline">
<member><citerefentry><refentrytitle>miktex-latex</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
<member><citerefentry><refentrytitle>miktex-tex</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
</simplelist>

<bibliolist>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../BibEntries/latex.xml" />
</bibliolist>

</refsect1>

</refentry>
