fmtutil - manage TeX formats and Metafont bases, per-user
Contents
Description
fmtutil version r68962 (2023-11-25 00:01:43 +0100)
Rebuild and manage TeX fmts and Metafont bases, collectively called "formats" here. (MetaPost no longer
uses the past-equivalent "mems".)
If not operating in mktexfmt mode, exactly one command must be given, filename suffixes should generally
not be specified, no non-option arguments are allowed, and multiple formats can be generated.
If the command name ends in mktexfmt, only one format can be created. The only options supported are
--help and --version, and the command line must be either a format name, with extension, or a plain name
that is passed as the argument to --byfmt (see below). The full name of the generated file (if any) is
written to stdout, and nothing else. The system directories are used if they are writable, else the user
directories.
By default, the return status is zero if all formats requested are successfully built, else nonzero.
Environment
This script runs TeX and Metafont to generate the fmt/base file, and thus all normal environment
variables and search path rules for TeX/MF apply.
Name
fmtutil - manage TeX formats and Metafont bases, per-user
fmtutil-sys - manage TeX formats and Metafont bases, system-wide
mktexfmt - create a TeX format or Metafont base
Options
--sys use TEXMFSYS{VAR,CONFIG}
--user use TEXMF{VAR,CONFIG}
--cnffile FILE
read FILE instead of fmtutil.cnf (can be given multiple times, in which case all the files are
used)
--dry-run, -n
don't actually build formts
--fmtdir DIR
write formats under DIR instead of TEXMF[SYS]VAR
--no-engine-subdir
don't use engine-specific subdir of the fmtdir
--no-error-if-no-format
exit successfully if no format is selected
--no-error-if-no-engine=ENGINE1,ENGINE2,...
exit successfully even if a required ENGINE
is missing, if it is included in the list.
--no-strict
exit successfully even if a format fails to build
--nohash
don't update ls-R files
--recorder
pass the -recorder option and save .fls files
--refresh
recreate only existing format files
--status-file FILE
append status information about built formats to FILE
--quiet
be silent
--catcfg
(does nothing, exists for compatibility)
--dolinks
(does nothing, exists for compatibility)
--force
(does nothing, exists for compatibility)
--test (does nothing, exists for compatibility)
Commands(exactlyonemustbespecified):--all recreate all format files
--missing
create all missing format files
--byengine ENGINE
(re)create formats built with ENGINE
--byfmt FORMAT
(re)create format FORMAT
--byhyphen HYPHENFILE
(re)create formats that depend on HYPHENFILE
--enablefmt
FORMAT[/ENGINE] enable FORMAT, as built with ENGINE
--disablefmt FORMAT[/ENGINE]
disable FORMAT, as built with ENGINE If multiple formats have the same name and
different engines, /ENGINE specifier is required.
--listcfg
list (enabled and disabled) configurations, filtered to available formats
--showhyphen FORMAT
print name of hyphen file for FORMAT
--version
show version information and exit
--help show this message and exit
Reporting Bugs
Report bugs to: tex-live@tug.org
TeX Live home page: <https://tug.org/texlive/>
TeX Live February 2024 FMTUTIL(1)
Synopsis
fmtutil [-user|-sys] [OPTION] ... [COMMAND]
fmtutil-sys [OPTION] ... [COMMAND]
fmtutil-user [OPTION] ... [COMMAND]
mktexfmtFORMAT.fmt|BASE.base|FMTNAME