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