Name

pdftex — DVI/PDF output from TeX

Synopsis

pdftex [option...] [[file] | [\command...]]

Description

Run the pdfTeX typesetter on file, usually creating file.pdf. If the file argument has no extension, .tex 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.

pdfTeX is a version of TeX that can create PDF files as well as DVI files.

In PDF mode, pdfTeX can natively handle the PDF, JPG, and PNG graphics formats.

Options

--alias=app

Pretend to be app, i.e., set program (and memory dump) name to app. This may affect the search paths and other values used. Using this option is equivalent to copying the executable file to app.exe and invoking app.exe.

--aux-directory=dir

Set the directory dir to which auxiliary files are written. Also look for input files in dir first, before along the normal search path.

--buf-size=n

Set the the maximum number of characters simultaneously present in current lines of open files and in control sequences between \csname and \endcsname.

--c-style-errors

Change the way, error messages are printed. The alternate style looks like error messages from many compilers and is easier to parse for some editors. This option implies \scrollmode.

--disable-installer

Disable automatic installation of missing packages. Specifying this option overwrites the global configuration setting in MiKTeX Options (see the section called “Automatic Package Installation”).

--disable-pipes

Disable input (output) from (to) child processes.

--disable-write18

Disable the \write18{command} construct.

--dont-parse-first-line

Disable checking whether the first line of the main input file starts with %&.

--draftmode

Switch on draft mode (generates no output).

--enable-installer

Enable automatic installation of missing packages. Specifying this option overwrites the global configuration setting in MiKTeX Options (see the section called “Automatic Package Installation”).

--enable-pipes

Enable input (output) from (to) child processes.

--enable-write18

Enable the \write18{command} construct. It is disabled by default to avoid security problems. When enabled, the command (which undergoes the usual TeX expansions) is passed to the command interpreter. The output of the command is not diverted anywhere, so it will not appear in the log file. The command execution either happens at \output time or right away, according to the absence or presence of the \immediate prefix.

--error-line=n

Set the width of context lines on terminal error messages.

--font-max=n

Set the maximum internal font number; must not exceed 5000.

--font-mem-size=n

Set the size, in TeX memory words, of the font memory.

--half-error-line=n

Set the width of first lines of contexts in terminal error messages.

--halt-on-error

Quit after the first error.

--help

Give help and exit.

--include-directory=dir

Prefix dir to the search path.

--initialize

Become the INI variant of the compiler.

--interaction=mode

Set the interaction mode. Must be one of batchmode, nonstopmode, scrollmode and errorstopmode. The meaning of these modes is the same as the corresponding commands.

--job-name=name

Set the name of the job (\jobname. This has an affect on the output file names.

--job-time=file

Set the time-stamp of all output files equal to file's time-stamp.

--max-in-open=n

Set the maximum number of input files and error insertions that can be going on simultaneously.

--max-print-line=n

Set the width of longest text lines output; should be at least 60.

--max-strings=n

Set the maximum number of strings.

--mem-bot=n

Set the the smallest index in the internal memory array dumped by the INI variant of the compiler; must not be less than mem_min.

--mem-max=n

Set the the greatest index in the internal memory array.

--mem-min=n

Set the the smallest index in the internal memory array; must be 0 or more; must be equal to mem_bot in the INI variant of the compiler, otherwise less than or equal to mem_bot}.

--mem-top=n

Set the largest index in the internal memory array dumped by the INI variant of the compiler; must be substantially larger than 0 and not greater than mem_max.

--mltex

Enable MLTeX extensions such as \charsubdef.

--nest-size=n

Set the maximum number of semantic levels simultaneously active.

--no-c-style-errors

Don't change the way, error messages are printed.

--output-directory=dir

Create output files in dir. This implies --include-directory=dir.

--output-format=format

Set the output format.

--param-size=n

Set the the maximum number of simultaneous macro parameters.

--parse-first-line

Check whether the first line of the main input file starts with %&, and parse if it does. This can be used to specify extra command-line options.

--pool-size=n

Set the maximum number of characters in strings, including all error messages and help texts, and the names of all fonts and control sequences; must exceed string_vacancies by the total length of the program's own strings, which is currently about 30000.

--quiet

Suppress all output, except errors.

--record-package-usages=file

Record all package usages and write them into file.

--recorder

Enable the file name recorder. This leaves a trace of the files opened for input and output in a file with the extension .fls.

--save-size=n

Set the the amount of space for saving values outside of current group.

--src-specials

Embed source file information (source specials) in the DVI file.

--stack-size=n

Set the maximum number of simultaneous input sources.

--string-vacancies=n

Set the minimum number of characters that should be available for the user's control sequences and font names, after the compiler's own error messages are stored.

--tcx=name

Process the TCX table name.

--terminal=oem

Use the active code page (e.g., 437 ) for console output.

--time-statistics

Show processing time statistics.

--trace[=tracestreams]

Enable trace messages. The tracestreams argument, if speciefied, is a comma-separated list of trace stream names (Chapter 9, Trace Streams).

--trie-op-size=n

Set the amount of space for “opcodes” in the hyphenation patterns.

--trie-size=n

Set the amount of space for hyphenation patterns; should be larger for the INI variant of the compiler.

--undump=name

Use name as the name of the format to be used, instead of the name by which the program was called or a

%&

line.

--version

Show version information and exit.

Files

pdftex.cfg

The pdfTeX configuration file.

Environment

TEXINPUTS

Extra paths to locate TeX \input and \openin files.

TFMFONTS

Extra paths to locate TeX font metric files

See also

The pdfTeX user manual (A4 version)

Run mthelp pdftex-a