Debian Codegraph @

texmf-dist/doc/generic/tex-ini-files/README.md

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