<?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-pdftex">

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

<refmeta>
<refentrytitle>miktex-pdftex</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-pdftex</refname>
<refpurpose>&DVI;/&PDF; output from &TeX;</refpurpose>
</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>
&miktexpdftex;
<arg choice="opt" rep="repeat"><replaceable>option</replaceable></arg>
<group>
<arg choice="opt"><replaceable>file</replaceable></arg>
<arg choice="opt" rep="repeat">\<replaceable>command</replaceable></arg>
</group></cmdsynopsis>

</refsynopsisdiv>

<refsect1>

<title>Description</title>

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

<para>Run the &pdfTeX; typesetter on <replaceable>file</replaceable>,
usually creating <filename>file.pdf</filename>.  If the file argument
has no extension, <filename>.tex</filename> will be appended to it.
Instead of a file name, a set of &pdfTeX; commands can be given, the
first of which must start with a backslash.  With a
<option>&amp;<replaceable>format</replaceable></option> argument
&pdfTeX; uses a different set of precompiled commands, contained in
<filename><replaceable>format.fmt</replaceable></filename>; it is
usually better to use the
<option>--undump=<replaceable>format</replaceable></option> option
instead.</para>

<para>&pdfTeX; is a version of &TeX;, with the &eTeX; extensions, that
can create &PDF; files as well as &DVI; files.</para>

<para>In &DVI; mode, &pdfTeX; can be used as a complete replacement
for the &TeX; engine.</para>

<para>The typical use of &pdfTeX; is with a pregenerated formats for
which &PDF; output has been enabled.  The &miktexpdftex; command uses
the equivalent of the plain &TeX; format, and the &miktexpdflatex;
command uses the equivalent of the &LaTeX; format.  To generate
formats, use the <option>--initialize</option> switch.</para>

<para>In &PDF; mode, &pdfTeX; can natively handle the &PDF;, &JPG;,
<acronym>JBIG2</acronym> and &PNG; graphics formats.  &pdfTeX; cannot
include &PostScript; or Encapsulated &PostScript; (&EPS;) graphics
files; first convert them to &PDF; using
<citerefentry><refentrytitle>miktex-epstopdf</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
&pdfTeX;’s handling of its command-line arguments is similar to that
of of the other &TeX; programs in the &MiKTeX; implementation.</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/auxdirectory.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/bufsize.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/cstyleerrors.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/disable8bitchars.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/disablewriteeighteen.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/dontparsefirstline.xml" />
<varlistentry>
<term><option>--draftmode</option></term>
<listitem><para>Sets <markup role="tex">\pdfdraftmode</markup> so
<indexterm>
<primary>--draftmode</primary> </indexterm> &pdfTeX; doesn't write a
&PDF; and doesn't read any included images, thus speeding up
execution.</para></listitem>
</varlistentry>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/enable8bitchars.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/enableenctex.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/enableetex.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/enablemltex.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/enablewriteeighteen.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/errorline.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/extramembot.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/extramemtop.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/fontmax.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/fontmemsize.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/halferrorline.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/haltonerror.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/hashextra.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" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/initialize.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/interaction.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/jobname.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/jobtime.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/mainmemory.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/maxinopen.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/maxprintline.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/maxstrings.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/nestsize.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/nocstyleerrors.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/outputdirectory.xml" />
<varlistentry>
<indexterm>
<primary>--output-format=<replaceable>format</replaceable></primary>
</indexterm>
<term><option>--output-format=format</option></term>
<listitem><para>Set the output format mode, where
<replaceable>format</replaceable> must be either <option>dvi</option>
or <option>pdf</option>.  This also influences the set of graphics
formats understood by &pdfTeX;.</para></listitem>
</varlistentry>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/paramsize.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/parsefirstline.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/poolfree.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/poolsize.xml" />
<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/recorder.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/restrictwriteeighteen.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/savesize.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/srcspecials.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/stacksize.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/stringvacancies.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/synctex.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/tcx.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/timestatistics.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/triesize.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/undump.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/version.xml" />
</variablelist>

</refsect1>

<refsect1>

<title>Files</title>

<simplelist type="inline">
<member><citerefentry><refentrytitle>pdftex.cfg</refentrytitle><manvolnum>5</manvolnum></citerefentry></member>
</simplelist>

</refsect1>

<refsect1>

<title>Environment</title>

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

</refsect1>

<refsect1>

<title>See also</title>

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

<para>The full &pdfTeX; manual can be accessed from the home page or &CTAN; page.</para>

</refsect1>

</refentry>
