summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/scripts
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2021-05-09 11:08:22 +0900
committerNorbert Preining <norbert@preining.info>2021-05-09 11:08:29 +0900
commit18158646eec9d48af8b1f9217a931e6e2be513a7 (patch)
tree43c532258b957b4428591fc42174725cc4e384b8 /Master/texmf-dist/scripts
parent2b4be1f23b20f9deb5c681e6fa65ad4fe9d782dc (diff)
fmtutil/tlutils: fixes from Karl: wording/doc, better dry-runmerged/fmtutil-improvements
Diffstat (limited to 'Master/texmf-dist/scripts')
-rwxr-xr-xMaster/texmf-dist/scripts/texlive/fmtutil.pl116
1 files changed, 64 insertions, 52 deletions
diff --git a/Master/texmf-dist/scripts/texlive/fmtutil.pl b/Master/texmf-dist/scripts/texlive/fmtutil.pl
index 03785755c3a..2248c2040a4 100755
--- a/Master/texmf-dist/scripts/texlive/fmtutil.pl
+++ b/Master/texmf-dist/scripts/texlive/fmtutil.pl
@@ -59,6 +59,7 @@ my $sep = (win32() ? ';' : ':');
my @deferred_stderr;
my @deferred_stdout;
+# $::opt_verbosity = 3; # manually enable debugging
my $first_time_creation_in_usermode = 0;
@@ -122,7 +123,7 @@ our @cmdline_options = ( # in same order as help message
"sys",
"user",
"cnffile=s@",
- "dry-run=n",
+ "dry-run|n",
"fmtdir=s",
"no-engine-subdir",
"no-error-if-no-engine=s",
@@ -171,8 +172,11 @@ sub main {
$opts{'user'} = 1;
my @save_argv = @ARGV;
- GetOptions ( "help" => \$opts{'help'}, "version" => \$opts{'version'} )
- || die "$prg: Unknown option in mktexfmt command line: @save_argv\n";
+ GetOptions (
+ "dry-run|n", \$opts{'dry-run'},
+ "help" => \$opts{'help'},
+ "version" => \$opts{'version'}
+ ) || die "$prg: Unknown option in mktexfmt command line: @save_argv\n";
help() if $opts{'help'};
if ($opts{'version'}) {
@@ -374,39 +378,43 @@ sub callback_build_formats {
# On W32 it seems that File::Temp creates restrictive permissions (ok)
# that are copied over with the files created inside it (not ok).
# So make our own temp dir.
- my $tmpdir;
- if (win32()) {
- my $foo;
- my $tmp_deflt = File::Spec->tmpdir;
- for my $i (1..5) {
- # $foo = "$texmfvar/temp.$$." . int(rand(1000000));
- $foo = (($texmfvar =~ m!^//!) ? $tmp_deflt : $texmfvar)
- . "/temp.$$." . int(rand(1000000));
- if (! -d $foo) {
- TeXLive::TLUtils::mkdirhier($foo);
- sleep 1;
- if (-d $foo) {
- $tmpdir = $foo;
- last;
+ my $tmpdir = "";
+ if (! $opts{"dry-run"}) {
+ if (win32()) {
+ my $foo;
+ my $tmp_deflt = File::Spec->tmpdir;
+ for my $i (1..5) {
+ # $foo = "$texmfvar/temp.$$." . int(rand(1000000));
+ $foo = (($texmfvar =~ m!^//!) ? $tmp_deflt : $texmfvar)
+ . "/temp.$$." . int(rand(1000000));
+ if (! -d $foo) {
+ TeXLive::TLUtils::mkdirhier($foo);
+ sleep 1;
+ if (-d $foo) {
+ $tmpdir = $foo;
+ last;
+ }
}
}
+ if (! $tmpdir) {
+ die "Cannot get a temporary directory after five iterations, sorry!";
+ }
+ if ($texmfvar =~ m!^//!) {
+ # used File::Spec->tmpdir; fix permissions
+ TeXLive::TLWinGoo::maybe_make_ro ($tmpdir);
+ }
+ } else {
+ $tmpdir = File::Temp::tempdir(CLEANUP => 1);
}
- if (! $tmpdir) {
- die "Cannot get a temporary directory after five iterations ... sorry!";
- }
- if ($texmfvar =~ m!^//!) {
- # used File::Spec->tmpdir; fix permissions
- TeXLive::TLWinGoo::maybe_make_ro ($tmpdir);
- }
- } else {
- $tmpdir = File::Temp::tempdir(CLEANUP => 1);
}
# set up destination directory
$opts{'fmtdir'} ||= "$texmfvar/web2c";
- TeXLive::TLUtils::mkdirhier($opts{'fmtdir'}) if (! -d $opts{'fmtdir'});
- if (! -w $opts{'fmtdir'}) {
- print_error("format directory not writable: $opts{fmtdir}\n");
- exit 1;
+ if (! $opts{"dry-run"}) {
+ TeXLive::TLUtils::mkdirhier($opts{'fmtdir'}) if (! -d $opts{'fmtdir'});
+ if (! -w $opts{'fmtdir'}) {
+ print_error("format directory not writable: $opts{fmtdir}\n");
+ exit 1;
+ }
}
# since the directory does not exist, we can make it absolute with abs_path
# without any trickery around non-existing dirs
@@ -430,7 +438,8 @@ sub callback_build_formats {
$ENV{'TEXFORMATS'} = "$tmpdir$sep$ENV{TEXFORMATS}";
# switch to temporary directory for format generation
- chdir($tmpdir) || die "Cannot change to directory $tmpdir: $!";
+ $opts{"dry-run"} || chdir($tmpdir)
+ || die "Cannot change to directory $tmpdir: $!";
# we rebuild formats in two rounds:
# round 1: only formats with the same name as engine (pdftex/pdftex)
@@ -783,7 +792,7 @@ sub rebuild_one_format {
# Copy the log file after the program is run, so that the log file
# is available to inspect even on failure. So we need the dest dir tree.
- TeXLive::TLUtils::mkdirhier($destdir);
+ TeXLive::TLUtils::mkdirhier($destdir) if ! $opts{"dry-run"};
#
# Here and in the following we use copy instead of move
# to make sure that in SElinux enabled cases the rules of
@@ -792,7 +801,8 @@ sub rebuild_one_format {
if (File::Copy::copy($logfile, "$destdir/$logfile")) {
print_info("log file copied to: $destdir/$logfile\n");
} else {
- print_deferred_error("cannot copy log $logfile to: $destdir\n");
+ print_deferred_error("cannot copy log $logfile to: $destdir\n")
+ unless $opts{"dry-run"};
}
# original shell script did *not* check the return value
@@ -1399,7 +1409,7 @@ sub help {
Usage: $prg [-user|-sys] [OPTION] ... [COMMAND]
or: $prg-sys [OPTION] ... [COMMAND]
or: $prg-user [OPTION] ... [COMMAND]
- or: mktexfmt FORMAT.fmt|BASE.base|FMTNAME.EXT
+ or: mktexfmt FORMAT.fmt|BASE.base|FMTNAME
Rebuild and manage TeX fmts and Metafont bases, collectively called
"formats" here. (MetaPost no longer uses the past-equivalent "mems".)
@@ -1412,7 +1422,8 @@ 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.
+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.
@@ -1461,7 +1472,7 @@ Explanation of trees and files normally used:
If --cnffile 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 -all fmtutil.cnf', in the
+ fmtutil.cnf files found by running "kpsewhich -all fmtutil.cnf", in the
order returned by kpsewhich. Files specified via --cnffile are
first tried to be loaded directly, and if not found and the file names
don't contain directory parts, are searched via kpsewhich.
@@ -1490,21 +1501,22 @@ Explanation of trees and files normally used:
(where YYYY is the TeX Live release version).
- According to the actions, fmtutil might write to one of the given files
- or create a new fmtutil.cnf, described further below.
+ According to the actions, fmtutil might update one of the existing cnf
+ files or create a new fmtutil.cnf, as described below.
-Where formats are written:
-
- By default, format files are (re)written in TEXMFSYSVAR/ENGINE by
- fmtutil-sys, and TEXMFVAR/ENGINE by fmtutil-user, where /ENGINE is a
- subdirectory named for the engine used, such as "pdftex". For
- mktexfmt, TEXMFSYSVAR is used if it is writable, else TEXMFVAR.
+Where format files are written:
+
+ By default, format files are (re)written in \$TEXMFSYSVAR/ENGINE by
+ fmtutil-sys, and \$TEXMFVAR/ENGINE by fmtutil-user, where /ENGINE is
+ a subdirectory named for the engine used, such as "pdftex".
+
+ For mktexfmt, TEXMFSYSVAR is used if it is writable, else TEXMFVAR.
If the --fmtdir=DIR option is specified, DIR is used instead of
TEXMF[SYS]VAR, but the /ENGINE subdir is still used by default.
- If the --no-engine-subdir option is specified, the /ENGINE subdir is
- omitted in all cases.
+ In all cases, if the --no-engine-subdir option is specified, the
+ /ENGINE subdir is omitted.
Where configuration changes are saved:
@@ -1525,7 +1537,7 @@ Where configuration changes are saved:
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 system-wide using TEXMFLOCAL, and system settings
- can be overridden again in a particular user's TEXMFHOME.
+ can be overridden again in a particular user's TEXMFHOME or TEXMFCONF.
Resolving multiple definitions of a format:
@@ -1536,11 +1548,11 @@ Disabling formats:
fmtutil.cnf files with higher priority (listed earlier) can disable
formats in lower priority (listed later) fmtutil.cnf files by
- writing a line like
+ writing a line like this in the higher-priority fmtutil.cnf file:
\#! <fmtname> <enginename> <hyphen> <args>
- in the higher-priority fmtutil.cnf file. The \#! must be at the
- beginning of the line, with at least one space or tab afterward, and
- there must be whitespace between each word on the list.
+ The \#! must be at the beginning of the line, with at least one space
+ or tab afterward, and there must be whitespace between each word on
+ the list.
For example, you can disable the luajitlatex format by creating
the file \$TEXMFCONFIG/web2c/fmtutil.cnf with the line
@@ -1561,7 +1573,7 @@ fmtutil-user (fmtutil -user) vs. fmtutil-sys (fmtutil -sys):
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.
-Supporting development binaries
+Supporting development binaries:
If an engine name ends with "-dev", formats are created in
the respective directory with the -dev stripped. This allows for