| 1 |
# Model TeX format creation files |
| 2 |
|
| 3 |
This bundle provides a collection of model `.ini` files for |
| 4 |
creating TeX formats. These files are commonly used to introduced |
| 5 |
distribution-dependent variations in formats. They are also used |
| 6 |
to allow existing format source files to be used with newer |
| 7 |
engines, for example to adapt the plain e-TeX source file to |
| 8 |
work with XeTeX and LuaTeX. |
| 9 |
|
| 10 |
## Shared configuration |
| 11 |
|
| 12 |
The file `pdftexconfig.tex` contains common settings for pdfTeX |
| 13 |
and LuaTeX, most of which are concerned with direct PDF output. |
| 14 |
This file is designed to be loaded directly by pdfTeX and can |
| 15 |
be parsed by the `luatexconfig.tex` to allow the same settings |
| 16 |
to be used by LuaTeX directly. The format of the file |
| 17 |
`pdftexconfig.tex` is strictly |
| 18 |
|
| 19 |
<pdfTeX primitive> = <value> |
| 20 |
|
| 21 |
for all non-comment non-blank lines. |
| 22 |
|
| 23 |
The LuaTeX loader recognize the marker control sequence `\dvimode`. |
| 24 |
If this is defined, the loaders will set the format to produce |
| 25 |
DVI file, and otherwise will select direct PDF output. The loader |
| 26 |
will then undefine `\dvimode`. |
| 27 |
|
| 28 |
## History |
| 29 |
|
| 30 |
The use of `.ini` files for building formats has developed over |
| 31 |
some time. The initial versions of the files collected here were |
| 32 |
taken from TeX Live 2015, and thus carry forward long-standing |
| 33 |
behaviors from this system. Initial modifications were made |
| 34 |
to allow for significant changes in LuaTeX primitive support |
| 35 |
between TeX Live 2015 and TeX Live 2016. |
| 36 |
|
| 37 |
The files provided here are designed to work with other support |
| 38 |
files and engines available from late 2015 onward, in particular: |
| 39 |
|
| 40 |
- pdfTeX v1.40+ |
| 41 |
- LuaTeX v0.80+ |
| 42 |
- XeTeX v0.99992+ |
| 43 |
- LaTeX2e 2015-01-01 onward |
| 44 |
- unicode-data v1.0+ |
| 45 |
|
| 46 |
Major changes: |
| 47 |
|
| 48 |
- 2016-02-27 First version of bundle |
| 49 |
- 2016-04-14 Do not assume e-TeX availability in `pdftexconfig.tex` |
| 50 |
- 2016-04-15 New approach to loading shared pdfTeX/LuaTeX data |
| 51 |
- 2023-11-15 Align setting of interaction mode across LaTeX `.ini` files |
| 52 |
- 2023-11-17 Add `luatexiniconfig.tex` |
| 53 |
- 2025-02-09 Step PDF version to 1.7 |
| 54 |
- 2025-03-25 Correct an lccode leak in `xetex.ini` |
| 55 |
- 2026-03-23 Add wrapper for `callback.register` |
| 56 |
- 2026-03-25 Correct scope of `\everyjob` setting |
| 57 |
- 2026-03-27 Remove one stray line |
| 58 |
|
| 59 |
A full history of this bundle is available from |
| 60 |
https://github.com/latex3/tex-ini-files |
| 61 |
|
| 62 |
## Legal |
| 63 |
|
| 64 |
The files provided here were originally written by various |
| 65 |
authors and are all marked as public domain. |