<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<refentry id="pi-bibtex">
  <refmeta>
    <refentrytitle>bibtex</refentrytitle>
  </refmeta>
  <refnamediv>
    <refname><sgmltag class="xmlpi">bibtex</sgmltag></refname>
    <refpurpose>Specify how to fill a Bibliography with BibTeX</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <programlisting><![CDATA[<?bibtex bibfiles="bib/database1,bib/database2"
                          bibstyle="plain"
                          mode="cited"?>]]></programlisting>
  </refsynopsisdiv>
  <refsection>
    <title>Description</title>
    <para>This Programming Instruction is usefull to include a bibliography
    coming from an external bibliography database written in the well known
    BibTeX format. <command>Dblatex</command> will call
    <command>bibtex</command> to process the database.</para>

    <para>The attributes supported by the PI are:</para>

    <xi:include href="../biblio.xml"
                xpointer="xpointer(id('bibtex-attributes'))"
                xmlns:xi="http://www.w3.org/2001/XInclude" />

  </refsection>

  <refsection>
    <title>Context</title>
    <para>Recognized in the <sgmltag>bibliomixed</sgmltag> element.</para>
  </refsection>

  <refsection>
    <title>See Also</title>
    <itemizedlist>
      <listitem><xref linkend="sec-bibtex" /></listitem>
      <listitem><xref linkend="latex.biblio.style" /></listitem>
      <listitem><xref linkend="latex.biblio.output" /></listitem>
    </itemizedlist>
  </refsection>
</refentry>
