<?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="latex.engine.options">
<refmeta>
<refentrytitle>latex.engine.options</refentrytitle>
</refmeta>
<refnamediv>
<refname><parameter>latex.engine.options</parameter></refname>
<refpurpose>Extra arguments to pass to the TeX engine</refpurpose>
</refnamediv>
<refsynopsisdiv>
<programlisting>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="syn/latex.engine.options.xml"/></programlisting>
</refsynopsisdiv>
<refsection>
<title>Description</title>
<para>This parameter enables to pass some options or extra arguments to the
TeX engine used to compile the latex file built by
<command>dblatex</command>.</para>
<para>This can be usefull to tweak the PDF generation to meet some specific
needs that cannot be set through latex commands. The following example asks
to <command>xelatex</command> to produce PDF version 1.3 and to embed all
the fonts in the PDF file:</para>
<screen>
$ <userinput>dblatex -b xetex -V -P latex.engine.options="-output-driver='xdvipdfmx -V3 -E'" file.xml</userinput>
[...]
xelatex -output-driver=xdvipdfmx -V3 -E -interaction=batchmode file.tex
[...]
xelatex -output-driver=xdvipdfmx -V3 -E -interaction=batchmode file.tex
[...]
</screen>
</refsection>
</refentry>