summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man5/fmtutil.cnf.5
blob: 858d3fa2b95f88152b4a082880c445b43f29e952 (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
.TH "fmtutil\&.cnf" "5" "27 April 2015" "TeX Live" 
.SH "NAME" 
fmtutil\&.cnf \- configuration file for fmtutil

.SH "DESCRIPTION" 
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\'\', ``luatex\'\'), the name of the engine that
is used by that format (e\&.g\&., ``tex\'\', ``pdftex\'\',
``luatex\'\'), the pattern file (e\&.g\&., \fIlanguage\&.dat\fP,
\fIlanguage\&.dat\&.lua\fP), and any arguments (e\&.g\&.,
\fItex\&.ini\fP).
.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 on the options
\fI--showhyphen\fP and \fI--byhyphen\fP\&.
If the format has no way to
customize hyphenation, ``-\'\' should be used to indicate this\&.
.PP
Running "fmtutil --help" will output the main documentation for using
\fIfmtutil\&.cnf\fP.

.SH "NOTES" 
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)\&.

.SH "FILES" 
.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

.SH "SEE ALSO" 
\fBamstex\fP(1), \fBetex\fP(1), \fBfmtutil\fP(8),
\fBtex\fP(1), \fBtexconfig\fP(8), \fBtexlinks\fP(8)\&.

.SH "AUTHOR" 
\fIfmtutil\&.cnf\fP was originally written by Thomas Esser and released
as public domain.  It is maintained as part of TeX Live:
<http://tug\&.org/texlive/>.
.PP 
This manual page was originally written by C\&.M\&. Connelly for the
Debian GNU/Linux system\&.  It may be used by other distributions
without contacting the author\&.