summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-02-17 21:48:01 +0000
committerKarl Berry <karl@freefriends.org>2022-02-17 21:48:01 +0000
commit1d673b607ed5fe711a3e4b67eefedbc5b1fdaa6b (patch)
tree5c99b7f1c18617638f960c7784bf2630400e3baf
parentad59fa4275f36a12c72af4b1f5bd6aa06b522101 (diff)
texfot (17feb22)
git-svn-id: svn://tug.org/texlive/trunk@62062 c570f23f-e606-0410-a88d-b1316a301751
-rwxr-xr-xBuild/source/texk/texlive/linked_scripts/texfot/texfot.pl34
-rw-r--r--Master/texmf-dist/doc/man/man1/texfot.130
-rw-r--r--Master/texmf-dist/doc/man/man1/texfot.man1.pdfbin31312 -> 32546 bytes
-rwxr-xr-xMaster/texmf-dist/scripts/texfot/texfot.pl34
4 files changed, 61 insertions, 37 deletions
diff --git a/Build/source/texk/texlive/linked_scripts/texfot/texfot.pl b/Build/source/texk/texlive/linked_scripts/texfot/texfot.pl
index d0e9ad68047..d7b9d85ce7c 100755
--- a/Build/source/texk/texlive/linked_scripts/texfot/texfot.pl
+++ b/Build/source/texk/texlive/linked_scripts/texfot/texfot.pl
@@ -1,14 +1,14 @@
#!/usr/bin/env perl
-# $Id: texfot,v 1.43 2021/05/01 15:49:53 karl Exp $
+# $Id: texfot,v 1.45 2022/02/17 18:42:02 karl Exp $
# Invoke a TeX command, filtering all but interesting terminal output;
# do not look at the log or check any output files.
# Exit status is that of the subprogram.
# Tee the complete (unfiltered) standard output and standard error to
-# (by default) /tmp/fot.
+# (by default) /tmp/fot.$UID.
#
# Public domain. Originally written 2014 by Karl Berry.
-my $ident = '$Id: texfot,v 1.43 2021/05/01 15:49:53 karl Exp $';
+my $ident = '$Id: texfot,v 1.45 2022/02/17 18:42:02 karl Exp $';
(my $prg = $0) =~ s,^.*/,,;
select STDERR; $| = 1; # no buffering
select STDOUT; $| = 1;
@@ -26,7 +26,7 @@ my @opt_ignore = ();
my $opt_interactive = 0;
my $opt_quiet = 0;
my $opt_stderr = 1;
-my $opt_tee = ($ENV{"TMPDIR"} || $ENV{"TMP"} || "/tmp") . "/fot";
+my $opt_tee = ($ENV{"TMPDIR"} || $ENV{"TMP"} || "/tmp") . "/fot.$>";
my $opt_version = 0;
my $opt_help = 0;
@@ -135,6 +135,7 @@ sub process_output {
|LaTeX\ Font\ Warning:\ Some\ font\ shapes
|LaTeX\ Font\ Warning:\ Size\ substitutions
|Package\ auxhook\ Warning:\ Cannot\ patch
+ |Package\ biditools\ Warning:\ Patching
|Package\ caption\ Warning:\ Un(supported|known)\ document\ class
|Package\ fixltx2e\ Warning:\ fixltx2e\ is\ not\ required
|Package\ frenchb?\.ldf\ Warning:\ (Figures|The\ definition)
@@ -230,8 +231,8 @@ value is that of I<texcmd>. Examples:
# Sample basic invocation:
texfot pdflatex file.tex
- # Ordinarily all output is copied to /tmp/fot before filtering,
- # but that can be omitted:
+ # Ordinarily the full output is copied to /tmp/fot.$UID before
+ # filtering, but that can be omitted, or the filename changed:
texfot --tee=/dev/null lualatex file.tex
# Example of more complex engine invocation:
@@ -367,11 +368,16 @@ the TeX command (on stdout). C<--no-stderr> omits that reporting.
=item C<--tee> I<file>
By default, the output being filtered is C<tee>-ed, before filtering, to
-C<$TMPDIR/fot> (or C<$TMP/fot> if C<TMP> is set, or C</tmp/fot> if
-neither environment variable is set), to make it easy to check the full
-output when the filtering seems suspect. This option allows specifying a
-different file. Use S<C<--tee /dev/null>> if you don't want the original
-output at all.
+make it easy to check the full output in case of problems.
+
+The default I<file> is C<$TMPDIR/fot.>I<uid>; if C<TMPDIR> is not set,
+C<TMP> is used if set; if neither is set, the default directory is
+C</tmp>. For example: C</tmp/fot.1001>. The I<uid> suffix is the
+effective userid of the process, appended for basic avoidance of
+collisions between different users on the same system.
+
+This option allows specifying a different file. Use S<C<--tee
+/dev/null>> to discard the original output.
=item C<--version>
@@ -387,7 +393,7 @@ Display this help and exit successfully.
I wrote this because, in my work as a TUGboat editor
(L<https://tug.org/TUGboat>, journal submissions always welcome!), I run
-and rerun many documents, many times each. It was too easy to lose
+and rerun many documents, many times each. It was easy to lose
warnings I needed to see in the mass of unvarying and uninteresting
output from TeX, such as style files being read and fonts being used. I
wanted to see all and only those messages which needed some action by
@@ -407,7 +413,7 @@ searching for C<log> at L<https://ctan.org/search>.
C<texfot> is written in Perl, and runs on Unix. It may work on Windows
if Perl and other software is installed, but I don't use Windows and
-don't support C,texfot> there.
+don't support C<texfot> there.
The name comes from the C<trip.fot> and C<trap.fot> files that are part
of Knuth's trip and trap torture tests, which record the online output
@@ -422,4 +428,6 @@ are released to the public domain. Email C<karl@freefriends.org> with
bug reports. It has no home page beyond the package on CTAN:
L<https://ctan.org/pkg/texfot>.
+ $Id: texfot,v 1.45 2022/02/17 18:42:02 karl Exp $
+
=cut
diff --git a/Master/texmf-dist/doc/man/man1/texfot.1 b/Master/texmf-dist/doc/man/man1/texfot.1
index 491001177e8..85ba26172b4 100644
--- a/Master/texmf-dist/doc/man/man1/texfot.1
+++ b/Master/texmf-dist/doc/man/man1/texfot.1
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
+.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "TEXFOT 1"
-.TH TEXFOT 1 "2021-05-01" "texfot" "Karl Berry"
+.TH TEXFOT 1 "2022-02-17" "texfot" "Karl Berry"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -153,8 +153,8 @@ value is that of \fItexcmd\fR. Examples:
\& # Sample basic invocation:
\& texfot pdflatex file.tex
\&
-\& # Ordinarily all output is copied to /tmp/fot before filtering,
-\& # but that can be omitted:
+\& # Ordinarily the full output is copied to /tmp/fot.$UID before
+\& # filtering, but that can be omitted, or the filename changed:
\& texfot \-\-tee=/dev/null lualatex file.tex
\&
\& # Example of more complex engine invocation:
@@ -285,11 +285,15 @@ the TeX command (on stdout). \f(CW\*(C`\-\-no\-stderr\*(C'\fR omits that report
.el .IP "\f(CW\-\-tee\fR \fIfile\fR" 4
.IX Item "--tee file"
By default, the output being filtered is \f(CW\*(C`tee\*(C'\fR\-ed, before filtering, to
-\&\f(CW\*(C`$TMPDIR/fot\*(C'\fR (or \f(CW\*(C`$TMP/fot\*(C'\fR if \f(CW\*(C`TMP\*(C'\fR is set, or \f(CW\*(C`/tmp/fot\*(C'\fR if
-neither environment variable is set), to make it easy to check the full
-output when the filtering seems suspect. This option allows specifying a
-different file. Use \f(CW\*(C`\-\-tee\ /dev/null\*(C'\fR if you don't want the original
-output at all.
+make it easy to check the full output in case of problems.
+.Sp
+The default \fIfile\fR is \f(CW\*(C`$TMPDIR/fot.\*(C'\fR\fIuid\fR; if \f(CW\*(C`TMPDIR\*(C'\fR is not set,
+\&\f(CW\*(C`TMP\*(C'\fR is used if set; if neither is set, the default directory is
+\&\f(CW\*(C`/tmp\*(C'\fR. For example: \f(CW\*(C`/tmp/fot.1001\*(C'\fR. The \fIuid\fR suffix is the
+effective userid of the process, appended for basic avoidance of
+collisions between different users on the same system.
+.Sp
+This option allows specifying a different file. Use \f(CW\*(C`\-\-tee\ /dev/null\*(C'\fR to discard the original output.
.ie n .IP """\-\-version""" 4
.el .IP "\f(CW\-\-version\fR" 4
.IX Item "--version"
@@ -302,7 +306,7 @@ Display this help and exit successfully.
.IX Header "RATIONALE"
I wrote this because, in my work as a TUGboat editor
(<https://tug.org/TUGboat>, journal submissions always welcome!), I run
-and rerun many documents, many times each. It was too easy to lose
+and rerun many documents, many times each. It was easy to lose
warnings I needed to see in the mass of unvarying and uninteresting
output from TeX, such as style files being read and fonts being used. I
wanted to see all and only those messages which needed some action by
@@ -322,7 +326,7 @@ searching for \f(CW\*(C`log\*(C'\fR at <https://ctan.org/search>.
.PP
\&\f(CW\*(C`texfot\*(C'\fR is written in Perl, and runs on Unix. It may work on Windows
if Perl and other software is installed, but I don't use Windows and
-don't support C,texfot> there.
+don't support \f(CW\*(C`texfot\*(C'\fR there.
.PP
The name comes from the \f(CW\*(C`trip.fot\*(C'\fR and \f(CW\*(C`trap.fot\*(C'\fR files that are part
of Knuth's trip and trap torture tests, which record the online output
@@ -335,3 +339,7 @@ This script and its documentation were written by Karl Berry and both
are released to the public domain. Email \f(CW\*(C`karl@freefriends.org\*(C'\fR with
bug reports. It has no home page beyond the package on \s-1CTAN:\s0
<https://ctan.org/pkg/texfot>.
+.PP
+.Vb 1
+\& $Id: texfot,v 1.45 2022/02/17 18:42:02 karl Exp $
+.Ve
diff --git a/Master/texmf-dist/doc/man/man1/texfot.man1.pdf b/Master/texmf-dist/doc/man/man1/texfot.man1.pdf
index 53e89ac2637..07a865f745e 100644
--- a/Master/texmf-dist/doc/man/man1/texfot.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/texfot.man1.pdf
Binary files differ
diff --git a/Master/texmf-dist/scripts/texfot/texfot.pl b/Master/texmf-dist/scripts/texfot/texfot.pl
index d0e9ad68047..d7b9d85ce7c 100755
--- a/Master/texmf-dist/scripts/texfot/texfot.pl
+++ b/Master/texmf-dist/scripts/texfot/texfot.pl
@@ -1,14 +1,14 @@
#!/usr/bin/env perl
-# $Id: texfot,v 1.43 2021/05/01 15:49:53 karl Exp $
+# $Id: texfot,v 1.45 2022/02/17 18:42:02 karl Exp $
# Invoke a TeX command, filtering all but interesting terminal output;
# do not look at the log or check any output files.
# Exit status is that of the subprogram.
# Tee the complete (unfiltered) standard output and standard error to
-# (by default) /tmp/fot.
+# (by default) /tmp/fot.$UID.
#
# Public domain. Originally written 2014 by Karl Berry.
-my $ident = '$Id: texfot,v 1.43 2021/05/01 15:49:53 karl Exp $';
+my $ident = '$Id: texfot,v 1.45 2022/02/17 18:42:02 karl Exp $';
(my $prg = $0) =~ s,^.*/,,;
select STDERR; $| = 1; # no buffering
select STDOUT; $| = 1;
@@ -26,7 +26,7 @@ my @opt_ignore = ();
my $opt_interactive = 0;
my $opt_quiet = 0;
my $opt_stderr = 1;
-my $opt_tee = ($ENV{"TMPDIR"} || $ENV{"TMP"} || "/tmp") . "/fot";
+my $opt_tee = ($ENV{"TMPDIR"} || $ENV{"TMP"} || "/tmp") . "/fot.$>";
my $opt_version = 0;
my $opt_help = 0;
@@ -135,6 +135,7 @@ sub process_output {
|LaTeX\ Font\ Warning:\ Some\ font\ shapes
|LaTeX\ Font\ Warning:\ Size\ substitutions
|Package\ auxhook\ Warning:\ Cannot\ patch
+ |Package\ biditools\ Warning:\ Patching
|Package\ caption\ Warning:\ Un(supported|known)\ document\ class
|Package\ fixltx2e\ Warning:\ fixltx2e\ is\ not\ required
|Package\ frenchb?\.ldf\ Warning:\ (Figures|The\ definition)
@@ -230,8 +231,8 @@ value is that of I<texcmd>. Examples:
# Sample basic invocation:
texfot pdflatex file.tex
- # Ordinarily all output is copied to /tmp/fot before filtering,
- # but that can be omitted:
+ # Ordinarily the full output is copied to /tmp/fot.$UID before
+ # filtering, but that can be omitted, or the filename changed:
texfot --tee=/dev/null lualatex file.tex
# Example of more complex engine invocation:
@@ -367,11 +368,16 @@ the TeX command (on stdout). C<--no-stderr> omits that reporting.
=item C<--tee> I<file>
By default, the output being filtered is C<tee>-ed, before filtering, to
-C<$TMPDIR/fot> (or C<$TMP/fot> if C<TMP> is set, or C</tmp/fot> if
-neither environment variable is set), to make it easy to check the full
-output when the filtering seems suspect. This option allows specifying a
-different file. Use S<C<--tee /dev/null>> if you don't want the original
-output at all.
+make it easy to check the full output in case of problems.
+
+The default I<file> is C<$TMPDIR/fot.>I<uid>; if C<TMPDIR> is not set,
+C<TMP> is used if set; if neither is set, the default directory is
+C</tmp>. For example: C</tmp/fot.1001>. The I<uid> suffix is the
+effective userid of the process, appended for basic avoidance of
+collisions between different users on the same system.
+
+This option allows specifying a different file. Use S<C<--tee
+/dev/null>> to discard the original output.
=item C<--version>
@@ -387,7 +393,7 @@ Display this help and exit successfully.
I wrote this because, in my work as a TUGboat editor
(L<https://tug.org/TUGboat>, journal submissions always welcome!), I run
-and rerun many documents, many times each. It was too easy to lose
+and rerun many documents, many times each. It was easy to lose
warnings I needed to see in the mass of unvarying and uninteresting
output from TeX, such as style files being read and fonts being used. I
wanted to see all and only those messages which needed some action by
@@ -407,7 +413,7 @@ searching for C<log> at L<https://ctan.org/search>.
C<texfot> is written in Perl, and runs on Unix. It may work on Windows
if Perl and other software is installed, but I don't use Windows and
-don't support C,texfot> there.
+don't support C<texfot> there.
The name comes from the C<trip.fot> and C<trap.fot> files that are part
of Knuth's trip and trap torture tests, which record the online output
@@ -422,4 +428,6 @@ are released to the public domain. Email C<karl@freefriends.org> with
bug reports. It has no home page beyond the package on CTAN:
L<https://ctan.org/pkg/texfot>.
+ $Id: texfot,v 1.45 2022/02/17 18:42:02 karl Exp $
+
=cut