## Name

xetex — Unicode-based TeX engine

## Synopsis

`xetex` [`option`...] [[`file`] | [\`command`...]]

## Description

Run the XeTeX 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 XeTeX commands can be given, the first of which must start with a backslash.

XeTeX has simple font installation; it can use any installed fonts in the operating system without configuring TeX font metric. As a result, XeTeX can access font features such as special ligatures and variable font weights.

## 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. TeX uses the buffer to contain input lines, but macro expansion works by writing material into the buffer and reparsing the line. As a consequence, certain constructs require the buffer to be very large, even though most documents can be handled with a small value.

`--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 %&.

`--enable-etex`

Enable eTeX extensions.

`--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-mltex`

Enable MLTeX extensions such as \charsubdef.

`--enable-pipes`

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

`--enable-write18`

Fully enable the \write18{`command`} construct. It is only partially enabled by default to avoid security problems. When fully 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.

`--extra-mem-bot=n`

Set the extra size (in memory words) for large data structures like boxes, glue, breakpoints, et al. Relevant only after the memory dump file has been read.

`--extra-mem-top=n`

Set the extra size (in memory words) for chars, tokens, et al. Relevant only after the memory dump file has been read.

`--font-max=n`

Set the maximum internal font number.

`--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.

`--hash-extra=n`

Set the extra space for the hash table of control sequences (which allows 10K names as distributed).

`--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.

`--main-memory=n`

Change the total size (in memory words) of the main memory array. Relevant only while creating memory dump files.

`--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.

`--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.

`--no-pdf`

Generate XDV (extended DVI) output rather than PDF

`--output-directory=dir`

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

`--output-driver=cmd`

Use `cmd` as the XDV-to-PDF driver instead of xdvipdfmx.

`--papersize=string`

Set PDF media size to `string`.

`--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.

`--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`.

`--restrict-write18`

Partially enable the \write18{`command`} construct.

`--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. Must be at least 25000 less than `pool_size`, but doesn't need to be nearly that large.

`--synctex=n`

Generate SyncTeX data for previewers if nonzero.

`--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-size=n`

Set the amount of space for hyphenation patterns.

`--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.

## Environment

`TEXINPUTS`

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

`TFMFONTS`

Extra paths to locate TeX font metric files

Run `mthelp xetexref`