summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/fmtutil.1
diff options
context:
space:
mode:
authorNorbert Preining <preining@logic.at>2015-04-20 22:56:07 +0000
committerNorbert Preining <preining@logic.at>2015-04-20 22:56:07 +0000
commit47cba4f9121720e97b3066e5e32fb870c0cf9f2e (patch)
treeb02b32798ed9a8bf2b316453f94e7f236f4bf331 /Master/texmf-dist/doc/man/man1/fmtutil.1
parent1306b56b4fa31cf7b3b11d1f01774ef24f0f1bc6 (diff)
update fmtutil.1 from source
git-svn-id: svn://tug.org/texlive/trunk@36974 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/fmtutil.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/fmtutil.1255
1 files changed, 169 insertions, 86 deletions
diff --git a/Master/texmf-dist/doc/man/man1/fmtutil.1 b/Master/texmf-dist/doc/man/man1/fmtutil.1
index 39ed57bf8b5..1b4357cdfa9 100644
--- a/Master/texmf-dist/doc/man/man1/fmtutil.1
+++ b/Master/texmf-dist/doc/man/man1/fmtutil.1
@@ -1,113 +1,196 @@
-.TH FMTUTIL 1 "June 2011" "TeX Live" "TeX Live"
-.SH "NAME"
-fmtutil \- utility for maintaining TeX format files
-.PP
-fmtutil-sys \- utility for maintaining TeX format files system\-wide
-.SH "SYNOPSIS"
-.B fmtutil\fP
-.RI [ OPTION .\|.\|.]
-.I COMMAND
-.PP
+.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.5.
+.TH FMTUTIL "1" "April 2015" "TeX Live" "User Commands"
+.SH NAME
+fmtutil \- manage TeX formats, Metafont bases and Metapost mems, per-user
+.br
+fmtutil-sys \- manage TeX formats, Metafont bases and Metapost mems, system-wide
+.br
+mktexfmt \- create a TeX format, Metafont base, or Metapost mem
+.SH SYNOPSIS
+.B fmtutil
+[\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR]
+.br
.B fmtutil-sys
-.RI [ OPTION .\|.\|.]
-.I COMMAND
-.SH "DESCRIPTION"
-\fBfmtutil\fP is used to create or recreate format and hyphenation
-files or show information about format files\&.
+[\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR]
+.br
+.B mktexfmt
+\fI\,FORMAT.fmt|BASE.base|MEM.mem|FMTNAME.EXT\/\fR
+.SH DESCRIPTION
+fmtutil version svn36788 (2015\-04\-13 00:53:26 +0900)
+.PP
+Rebuild and manage TeX formats, Metafont bases and MetaPost mems.
.PP
-\fICOMMAND\fP is one of:
+If the command name ends in mktexfmt, only one format can be created.
+The only options supported are \fB\-\-help\fR and \fB\-\-version\fR, and the command
+line must consist of either a format name, with its extension, or a
+plain name that is passed as the argument to \fB\-\-byfmt\fR (see below). The
+full name of the generated file (if any) is written to stdout, and
+nothing else.
.PP
+If not operating in mktexfmt mode, the command line can be more general,
+and multiple formats can be generated, as follows.
+.SH OPTIONS
.TP
-.B --all
-recreate all format files
+\fB\-\-cnffile\fR FILE
+read FILE instead of fmtutil.cnf
+(can be given multiple times, in which case
+all the files are used)
+.HP
+\fB\-\-fmtdir\fR DIRECTORY
.TP
-.BI --byengine \ enginename
-(re)create formats that depend on the
-engine \fIenginename\fP
+\fB\-\-no\-engine\-subdir\fR
+don't use engine\-specific subdir of the fmtdir
.TP
-.BI --byfmt \ formatname
-(re)create the format for
-format \fIformatname\fP
+\fB\-\-no\-error\-if\-no\-format\fR
+exit successfully if no format is selected
.TP
-.BI --byhyphen \ hyphenfile
-(re)create formats that depend on the
-hyphenation file \fIhyphenfile\fP
+\fB\-\-no\-error\-if\-no\-engine\fR=\fI\,ENGINE1\/\fR,ENGINE2,...
+exit successfully even if the required engine
+.IP
+is missing, if it is included in the list.
.TP
-.B --catcfg
-output the content of the config file
-.TP
-.BI --disablefmt \ formatname
-disable
-.I formatname
-in config file
+\fB\-\-quiet\fR
+be silent
.TP
-.B --edit
-no-op in TeX Live
+\fB\-\-test\fR
+(not implemented, just for compatibility)
.TP
-.BI --enablefmt \ formatname
-ensable
-.I formatname
-in config file
+\fB\-\-dolinks\fR
+(not implemented, just for compatibility)
.TP
-.B --help
-print a summary of commands and options
+\fB\-\-force\fR
+(not implemented, just for compatibility)
+.SS "Commands:"
.TP
-.B --listcfg
-list (enabled and disabled) configurations, filtered to available formats
+\fB\-\-all\fR
+recreate all format files
.TP
-.B --missing
+\fB\-\-missing\fR
create all missing format files
.TP
-.B --refresh
+\fB\-\-refresh\fR
recreate only existing format files
.TP
-.BI --showhyphen \ formatname
-print the name of the
-hyphenation file for the format
-\fIformatname\fP
+\fB\-\-byengine\fR ENGINENAME
+(re)create formats using ENGINENAME
.TP
-.B --version
-show version info
-.SH "OPTIONS"
+\fB\-\-byfmt\fR FORMATNAME
+(re)create format for FORMATNAME
.TP
-.BI --cnffile \ file
-specify the configuration
-\fIfile\fP \fBfmtutil\fP should use
+\fB\-\-byhyphen\fR HYPHENFILE
+(re)create formats that depend on HYPHENFILE
.TP
-.B --dolinks
-(not implemented, just for compatibility)
+\fB\-\-enablefmt\fR FORMATNAME
+enable formatname in config file
.TP
-.BI --fmtdir \ directory
-set the destination
-directory for format files generated by
-\fBfmtutil\fP to \fIdirectory\fP
+\fB\-\-disablefmt\fR FORMATNAME
+disable formatname in config file
.TP
-.B --force
-(not implemented, just for compatibility)
+\fB\-\-listcfg\fR
+list (enabled and disabled) configurations,
+filtered to available formats
.TP
-.B --no-engine-subdir
-don't use engine-specific subdir of the fmtdir
+\fB\-\-catcfg\fR
+output the content of the config file
.TP
-.B --no-error-if-no-format
-exit successfully if no format is selected
+\fB\-\-showhyphen\fR FORMATNAME
+print name of hyphenfile for format FORMATNAME
.TP
-.B --quiet
-be silent
+\fB\-\-version\fR
+show version information and exit
.TP
-.B --test
-(not implemented, just for compatibility)
-.SH "FILES"
-.TP
-.I fmtutil\&.cnf
-default configuration file
-.SH "SEE ALSO"
-.BR kpsewhich (1)
-.SH "BUGS"
-None known, but report any bugs found to <tex-k@tug.org> (mailing list).
-.SH "AUTHOR"
-\fBfmtutil\fP was written by Thomas Esser
-<te@dbs\&.uni-hannover\&.de> and is in the public domain.
+\fB\-\-help\fR
+show this message and exit
+.SH ENVIRONMENT
+.PP
+Explanation of trees and files normally used:
+.IP
+If \fB\-\-cnffile\fR is specified on the command line (possibly multiple
+times), its value(s) are used. Otherwise, fmtutil reads all the
+fmtutil.cnf files found by running `kpsewhich \fB\-all\fR fmtutil.cnf', in the
+order returned by kpsewhich.
+.IP
+In any case, if multiple fmtutil.cnf files are found, all the format
+definitions found in all the fmtutil.cnf files are merged.
+.IP
+Thus, if fmtutil.cnf files are present in all trees, and the default
+layout is used as shipped with TeX Live, the following files are
+read, in the given order.
+.nf
+.IP
+For fmtutil\-sys:
+TEXMFSYSCONFIG \fI\,$TEXLIVE/YYYY/texmf\-config/web2c/fmtutil.cnf\/\fP
+TEXMFSYSVAR \fI\,$TEXLIVE/YYYY/texmf\-var/web2c/fmtutil.cnf\/\fP
+TEXMFLOCAL \fI\,$TEXLIVE/texmf\-local/web2c/fmtutil.cnf\/\fP
+TEXMFDIST \fI\,$TEXLIVE/YYYY/texmf\-dist/web2c/fmtutil.cnf\/\fP
+.IP
+For fmtutil:
+TEXMFCONFIG $HOME/.texliveYYYY/texmf\-config/web2c/fmtutil.cnf
+TEXMFVAR $HOME/.texliveYYYY/texmf\-var/web2c/fmtutil.cnf
+TEXMFHOME \fI\,$HOME/texmf/web2c/fmtutil.cnf\/\fP
+TEXMFSYSCONFIG \fI\,$TEXLIVE/YYYY/texmf\-config/web2c/fmtutil.cnf\/\fP
+TEXMFSYSVAR \fI\,$TEXLIVE/YYYY/texmf\-var/web2c/fmtutil.cnf\/\fP
+TEXMFLOCAL \fI\,$TEXLIVE/texmf\-local/web2c/fmtutil.cnf\/\fP
+TEXMFDIST \fI\,$TEXLIVE/YYYY/texmf\-dist/web2c/fmtutil.cnf\/\fP
+.IP
+(where YYYY is the TeX Live release version).
+.fi
+.IP
+According to the actions, fmtutil might write to one of the given files
+or create a new fmtutil.cnf, described further below.
+.PP
+Where changes are saved:
+.IP
+If config files are given on the command line, then the first one
+given will be used to save any changes from \fB\-\-enable\fR or \fB\-\-disable\fR.
+If the config files are taken from kpsewhich output, then the
+algorithm is more complex:
+.IP
+1) If \fI\,$TEXMFCONFIG/web2c/fmtutil.cnf\/\fP or \fI\,$TEXMFHOME/web2c/fmtutil.cnf\/\fP
+appears in the list of used files, then the one listed first by
+kpsewhich \fB\-\-all\fR (equivalently, the one returned by kpsewhich
+fmtutil.cnf), is used.
+.IP
+2) If neither of the above two are present and changes are made, a
+new config file is created in \fI\,$TEXMFCONFIG/web2c/fmtutil.cnf\/\fP.
+.IP
+In general, the idea is that if a given config file is not writable, a
+higher\-level one can be used. That way, the distribution's settings
+can be overridden for system\-wide using TEXMFLOCAL, and then system
+settings can be overridden again for a particular using using TEXMFHOME.
+.PP
+Resolving multiple definitions of a format:
+.IP
+If a format is defined in more than one config file, then the definition
+coming from the first\-listed fmtutil.cnf is used.
+.PP
+Disabling formats:
+.IP
+fmtutil.cnf files with higher priority (listed earlier) can disable
+formats mentioned in lower priority (listed later) fmtutil.cnf files by
+writing, e.g.,
+.IP
+#! <fmtname> <enginename> <hyphen> <args>
+.IP
+in the higher\-priority fmtutil.cnf file.
+.IP
+As an example, suppose you have want to disable the luajitlatex format.
+You can create the file \fI\,$TEXMFCONFIG/web2c/fmtutil.cnf\/\fP with the content
+.IP
+#! luajitlatex luajittex language.dat,language.dat.lua lualatex.ini
+.IP
+and call fmtutil.
.PP
-This manual page was written by C\&.M\&. Connelly
-<c@eskimo\&.com>, for
-the Debian GNU/Linux system and later slightly adapted for the teTeX 3 release\&.
+fmtutil vs. fmtutil\-sys (fmtutil \fB\-\-sys\fR):
+.IP
+When fmtutil\-sys is run or the command line option \fB\-\-sys\fR is used,
+TEXMFSYSCONFIG and TEXMFSYSVAR are used instead of TEXMFCONFIG and
+TEXMFVAR, respectively. This is the primary difference between
+fmtutil\-sys and fmtutil.
+.IP
+Other locations may be used if you give them on the command line, or
+these trees don't exist, or you are not using the original TeX Live.
+.SH "REPORTING BUGS"
+Report bugs to: tex\-k@tug.org
+.br
+TeX Live home page: <http://tug.org/texlive/>