Debian Codegraph @

texmf-dist/doc/man/man5/fmtutil.cnf.5

raw
1 .TH "fmtutil.cnf" "5" "10 February 2025" "TeX Live"
2 .PP
3 .SH "NAME"
4 fmtutil.cnf \- configuration file for fmtutil
5 .PP
6 .SH "DESCRIPTION"
7 .PP
8 The \fIfmtutil.cnf\fP file contains the configuration information
9 for \fBfmtutil\fP(8). Each line contains the name of the format
10 (e.g., ``tex\'\', ``latex\'\', ``omega\'\'), the name of the engine that
11 is used by that format (e.g., ``tex\'\', ``etex\'\', ``omega\'\'),
12 the pattern file (e.g., \fIlanguage.dat\fP, \fIlanguage.def\fP),
13 and any arguments (name of an \fI.ini\fP file).
14 .PP
15 Fields are separated by whitespace and complete lines can be commented
16 out with ``#\'\'. The ``pattern file\'\' field cannot be used to
17 define a file that is used while building the format.
18 It tells \fBfmtutil\fP which files (separated by commas) the
19 format creation procedure reads and it has an effect to the options
20 \fI--showhyphen\fP and \fI--byhyphen\fP.
21 If the format has no way to
22 customize hyphenation, a ``-\'\' can be used to indicate this.
23 .PP
24 .SH "NOTES"
25 .PP
26 The \fBtex\fP(1) and \fBamstex\fP(1) formats always load
27 \fIhyphen.tex\fP. No customization by a pattern file is available
28 for these formats. Therefore, the pattern-file field for the
29 \fBtex\fP and \fBamstex\fP is usually indicated to be empty (``-\'\').
30 .PP
31 You can, however, build customized formats on top of plain
32 \fBtex\fP(1) or \fBamstex\fP(1) by using \fIbplain.tex\fP instead of
33 \fIplain.tex\fP (b for the \fIBabel\fP system). See, for example,
34 the \fIbplain.ini\fP file for the bplain format).
35 .PP
36 \fBetex\fP(1) loads \fIlanguage.def\fP, not
37 \fIlanguage.dat\fP.
38 .PP
39 Symbolic links to the correct engines (e.g., bplain -> tex)
40 are generated by the \fBtexlinks\fP(8) script. Remember to run
41 \fBtexlinks\fP(8) if you run \fBfmtutil\fP(8) yourself, rather
42 than using the FORMATS option in \fBtexconfig\fP(8).
43 .PP
44 .SH "FILES"
45 .PP
46 .IP "\fIfmtutil.cnf\fP"
47 default configuration file
48 .IP "\fIlanguage.dat\fP"
49 hyphenation pattern file
50 .IP "\fIlanguage.def\fP"
51 hyphenation pattern file
52 .IP "\fIlanguage.dat.lua\fP"
53 hyphenation pattern file
54 .PP
55 .SH "SEE ALSO"
56 .PP
57 \fBamstex\fP(1), \fBetex\fP(1), \fBfmtutil\fP(8),
58 \fBtex\fP(1), \fBtexconfig\fP(8), \fBtexlinks\fP(8).
59 .PP
60 <https://tug.org/texlive/scripts-sys-user.html>
61 .PP
62 .SH "BUGS"
63 .PP
64 Email bug reports to <https://lists.tug.org/tex-k> (public mailing list).
65 .SH "AUTHOR"
66 .PP
67 \fBfmtutil\fP and \fIfmtutil.cnf\fP was originally written by Thomas Esser.
68 .PP
69 This manual page was written by C.M\&. Connelly for the Debian
70 GNU/Linux system. It is now maintained as part of TeX Live.