diff options
Diffstat (limited to 'Build/source/texk/texlive/tl_support/fmtutil.1')
-rw-r--r-- | Build/source/texk/texlive/tl_support/fmtutil.1 | 196 |
1 files changed, 0 insertions, 196 deletions
diff --git a/Build/source/texk/texlive/tl_support/fmtutil.1 b/Build/source/texk/texlive/tl_support/fmtutil.1 deleted file mode 100644 index 1b4357cdfa9..00000000000 --- a/Build/source/texk/texlive/tl_support/fmtutil.1 +++ /dev/null @@ -1,196 +0,0 @@ -.\" 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 -[\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 -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 -\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 -\fB\-\-no\-engine\-subdir\fR -don't use engine\-specific subdir of the fmtdir -.TP -\fB\-\-no\-error\-if\-no\-format\fR -exit successfully if no format is selected -.TP -\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 -\fB\-\-quiet\fR -be silent -.TP -\fB\-\-test\fR -(not implemented, just for compatibility) -.TP -\fB\-\-dolinks\fR -(not implemented, just for compatibility) -.TP -\fB\-\-force\fR -(not implemented, just for compatibility) -.SS "Commands:" -.TP -\fB\-\-all\fR -recreate all format files -.TP -\fB\-\-missing\fR -create all missing format files -.TP -\fB\-\-refresh\fR -recreate only existing format files -.TP -\fB\-\-byengine\fR ENGINENAME -(re)create formats using ENGINENAME -.TP -\fB\-\-byfmt\fR FORMATNAME -(re)create format for FORMATNAME -.TP -\fB\-\-byhyphen\fR HYPHENFILE -(re)create formats that depend on HYPHENFILE -.TP -\fB\-\-enablefmt\fR FORMATNAME -enable formatname in config file -.TP -\fB\-\-disablefmt\fR FORMATNAME -disable formatname in config file -.TP -\fB\-\-listcfg\fR -list (enabled and disabled) configurations, -filtered to available formats -.TP -\fB\-\-catcfg\fR -output the content of the config file -.TP -\fB\-\-showhyphen\fR FORMATNAME -print name of hyphenfile for format FORMATNAME -.TP -\fB\-\-version\fR -show version information and exit -.TP -\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 -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/> |