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