# texlive[51525] trunk: texfot (1jul19)

commits+karl at tug.org commits+karl at tug.org
Mon Jul 1 23:12:46 CEST 2019

```Revision: 51525
http://tug.org/svn/texlive?view=revision&revision=51525
Author:   karl
Date:     2019-07-01 23:12:46 +0200 (Mon, 01 Jul 2019)
Log Message:
-----------
texfot (1jul19)

Modified Paths:
--------------
trunk/Master/texmf-dist/doc/man/man1/texfot.1
trunk/Master/texmf-dist/doc/man/man1/texfot.man1.pdf
trunk/Master/texmf-dist/scripts/texfot/texfot.pl

===================================================================
--- trunk/Build/source/texk/texlive/linked_scripts/texfot/texfot.pl	2019-07-01 21:12:25 UTC (rev 51524)
+++ trunk/Build/source/texk/texlive/linked_scripts/texfot/texfot.pl	2019-07-01 21:12:46 UTC (rev 51525)
@@ -1,5 +1,5 @@
#!/usr/bin/env perl
-# \$Id: texfot,v 1.37 2017/07/25 15:06:53 karl Exp \$
+# \$Id: texfot,v 1.38 2019/06/30 22:59:39 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.
@@ -8,7 +8,7 @@
#
# Public domain.  Originally written 2014 by Karl Berry.

-my \$ident = '\$Id: texfot,v 1.37 2017/07/25 15:06:53 karl Exp \$';
+my \$ident = '\$Id: texfot,v 1.38 2019/06/30 22:59:39 karl Exp \$';
(my \$prg = \$0) =~ s,^.*/,,;
select STDERR; \$| = 1;  # no buffering
select STDOUT; \$| = 1;
@@ -226,12 +226,12 @@
# Sample basic invocation:
texfot pdflatex file.tex

-  # Ordinarily all output is copied to /tmp/fot before filtering;
-  # that can be omitted:
-  texfot pdflatex --tee=/dev/null file.tex
+  # Ordinarily all output is copied to /tmp/fot before filtering,
+  # but that can be omitted:
+  texfot --tee=/dev/null lualatex file.tex

# Example of more complex engine invocation:
-  texfot lualatex --recorder '\nonstopmode\input file'
+  texfot xelatex --recorder '\nonstopmode\input file'

Aside from its own options, described below, C<texfot> just runs the
given command with the given arguments (same approach to command line
@@ -279,9 +279,9 @@
=item 5.

Otherwise, the default: if the line came from stdout, ignore it; if the
-line came from stderr, print it (to stdout).  (This distinction is made
+line came from stderr, print it (to stdout).  This distinction is made
because TeX engines write relatively few messages to stderr, and it's
-not unlikely that any such should be considered.
+likely that any such should be considered.

It would be easy to add more options to allow for user additions to the
various regex lists, if that ever seems useful.  Or email me (see end).
@@ -346,7 +346,11 @@
=item C<--no-quiet>

By default, the TeX command being invoked is reported on standard output.
-C<--quiet> omits that reporting.
+C<--quiet> omits that reporting. To get a completely silent run,
+redirect standard output: S<C<texfot ... E<gt>/dev/null>>. (The only
+messages to standard error should be errors from C<texfot> itself, so it
+shouldn't be necessary to redirect that, but of course that can be done
+as well.)

=item C<--stderr>

@@ -377,12 +381,12 @@

I wrote this because, in my work as a TUGboat editor
-(L<http://tug.org/TUGboat>, journal submissions always welcome!), I end
-up running and rerunning many papers, many times each.  It was too 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 me.
+(L<http://tug.org/TUGboat>, journal submissions always welcome!), I run
+and rerun many documents, many times each. It was too 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
+me.

I found some other programs of a similar nature, the LaTeX package
C<silence>, and plenty of other (La)TeX wrappers, but it seemed none of
@@ -394,12 +398,10 @@

Here are some keywords if you want to explore other options:
texloganalyser, pydflatex, logfilter, latexmk, rubber, arara, and
-searching for C<log> at L<http://ctan.org/search>.
+searching for C<log> at L<https://ctan.org/search>.

C<texfot> is written in Perl, and runs on Unix, and does not work on
-Windows.  (If by some chance anyone wants to use this program on
-that os.)
+Windows.

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
@@ -412,6 +414,6 @@
This script and its documentation were written by Karl Berry and both
are released to the public domain.  Email C<karl at freefriends.org> with
bug reports.  It has no home page beyond the package on CTAN:
-L<http://www.ctan.org/pkg/texfot>.
+L<https://ctan.org/pkg/texfot>.

=cut

Modified: trunk/Master/texmf-dist/doc/man/man1/texfot.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/texfot.1	2019-07-01 21:12:25 UTC (rev 51524)
+++ trunk/Master/texmf-dist/doc/man/man1/texfot.1	2019-07-01 21:12:46 UTC (rev 51525)
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
+.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -54,16 +54,20 @@
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
-.if !\nF .nr F 0
-.if \nF>0 \{\
-.    de IX
-.    tm Index:\\\$1\t\\n%\t"\\\$2"
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{\
+.    if \nF \{\
+.        de IX
+.        tm Index:\\\$1\t\\n%\t"\\\$2"
..
-.    if !\nF==2 \{\
-.        nr % 0
-.        nr F 2
+.        if !\nF==2 \{\
+.            nr % 0
+.            nr F 2
+.        \}
.    \}
.\}
+.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
@@ -129,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "TEXFOT 1"
-.TH TEXFOT 1 "2017-07-25" "texfot" "Karl Berry"
+.TH TEXFOT 1 "2019-06-30" "texfot" "Karl Berry"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
@@ -149,12 +153,12 @@
\&  # Sample basic invocation:
\&  texfot pdflatex file.tex
\&
-\&  # Ordinarily all output is copied to /tmp/fot before filtering;
-\&  # that can be omitted:
-\&  texfot pdflatex \-\-tee=/dev/null file.tex
+\&  # Ordinarily all output is copied to /tmp/fot before filtering,
+\&  # but that can be omitted:
+\&  texfot \-\-tee=/dev/null lualatex file.tex
\&
\&  # Example of more complex engine invocation:
-\&  texfot lualatex \-\-recorder \*(Aq\enonstopmode\einput file\*(Aq
+\&  texfot xelatex \-\-recorder \*(Aq\enonstopmode\einput file\*(Aq
.Ve
.PP
Aside from its own options, described below, \f(CW\*(C`texfot\*(C'\fR just runs the
@@ -190,9 +194,9 @@
Otherwise, if the line matches the list of regexps to show, show it.
.IP "5." 4
Otherwise, the default: if the line came from stdout, ignore it; if the
-line came from stderr, print it (to stdout).  (This distinction is made
+line came from stderr, print it (to stdout).  This distinction is made
because TeX engines write relatively few messages to stderr, and it's
-not unlikely that any such should be considered.
+likely that any such should be considered.
.Sp
It would be easy to add more options to allow for user additions to the
various regex lists, if that ever seems useful.  Or email me (see end).
@@ -261,7 +265,11 @@
.IX Item "--no-quiet"
.PD
By default, the TeX command being invoked is reported on standard output.
-\&\f(CW\*(C`\-\-quiet\*(C'\fR omits that reporting.
+\&\f(CW\*(C`\-\-quiet\*(C'\fR omits that reporting. To get a completely silent run,
+redirect standard output: \f(CW\*(C`texfot\ ...\ >/dev/null\*(C'\fR. (The only
+messages to standard error should be errors from \f(CW\*(C`texfot\*(C'\fR itself, so it
+shouldn't be necessary to redirect that, but of course that can be done
+as well.)
.ie n .IP """\-\-stderr""" 4
.el .IP "\f(CW\-\-stderr\fR" 4
.IX Item "--stderr"
@@ -292,12 +300,12 @@
.SH "RATIONALE"
I wrote this because, in my work as a TUGboat editor
-(<http://tug.org/TUGboat>, journal submissions always welcome!), I end
-up running and rerunning many papers, many times each.  It was too 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 me.
+(<http://tug.org/TUGboat>, journal submissions always welcome!), I run
+and rerun many documents, many times each. It was too 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
+me.
.PP
I found some other programs of a similar nature, the LaTeX package
\&\f(CW\*(C`silence\*(C'\fR, and plenty of other (La)TeX wrappers, but it seemed none of
@@ -309,12 +317,10 @@
.PP
Here are some keywords if you want to explore other options:
texloganalyser, pydflatex, logfilter, latexmk, rubber, arara, and
-searching for \f(CW\*(C`log\*(C'\fR at <http://ctan.org/search>.
+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, and does not work on
-Windows.  (If by some chance anyone wants to use this program on
-that os.)
+Windows.
.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
@@ -325,5 +331,5 @@
This script and its documentation were written by Karl Berry and both
are released to the public domain.  Email \f(CW\*(C`karl at freefriends.org\*(C'\fR with
-bug reports.  It has no home page beyond the package on \s-1CTAN:
-\&\s0<http://www.ctan.org/pkg/texfot>.
+bug reports.  It has no home page beyond the package on \s-1CTAN:\s0
+<https://ctan.org/pkg/texfot>.

Modified: trunk/Master/texmf-dist/doc/man/man1/texfot.man1.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/scripts/texfot/texfot.pl
===================================================================
--- trunk/Master/texmf-dist/scripts/texfot/texfot.pl	2019-07-01 21:12:25 UTC (rev 51524)
+++ trunk/Master/texmf-dist/scripts/texfot/texfot.pl	2019-07-01 21:12:46 UTC (rev 51525)
@@ -1,5 +1,5 @@
#!/usr/bin/env perl
-# \$Id: texfot,v 1.37 2017/07/25 15:06:53 karl Exp \$
+# \$Id: texfot,v 1.38 2019/06/30 22:59:39 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.
@@ -8,7 +8,7 @@
#
# Public domain.  Originally written 2014 by Karl Berry.

-my \$ident = '\$Id: texfot,v 1.37 2017/07/25 15:06:53 karl Exp \$';
+my \$ident = '\$Id: texfot,v 1.38 2019/06/30 22:59:39 karl Exp \$';
(my \$prg = \$0) =~ s,^.*/,,;
select STDERR; \$| = 1;  # no buffering
select STDOUT; \$| = 1;
@@ -226,12 +226,12 @@
# Sample basic invocation:
texfot pdflatex file.tex

-  # Ordinarily all output is copied to /tmp/fot before filtering;
-  # that can be omitted:
-  texfot pdflatex --tee=/dev/null file.tex
+  # Ordinarily all output is copied to /tmp/fot before filtering,
+  # but that can be omitted:
+  texfot --tee=/dev/null lualatex file.tex

# Example of more complex engine invocation:
-  texfot lualatex --recorder '\nonstopmode\input file'
+  texfot xelatex --recorder '\nonstopmode\input file'

Aside from its own options, described below, C<texfot> just runs the
given command with the given arguments (same approach to command line
@@ -279,9 +279,9 @@
=item 5.

Otherwise, the default: if the line came from stdout, ignore it; if the
-line came from stderr, print it (to stdout).  (This distinction is made
+line came from stderr, print it (to stdout).  This distinction is made
because TeX engines write relatively few messages to stderr, and it's
-not unlikely that any such should be considered.
+likely that any such should be considered.

It would be easy to add more options to allow for user additions to the
various regex lists, if that ever seems useful.  Or email me (see end).
@@ -346,7 +346,11 @@
=item C<--no-quiet>

By default, the TeX command being invoked is reported on standard output.
-C<--quiet> omits that reporting.
+C<--quiet> omits that reporting. To get a completely silent run,
+redirect standard output: S<C<texfot ... E<gt>/dev/null>>. (The only
+messages to standard error should be errors from C<texfot> itself, so it
+shouldn't be necessary to redirect that, but of course that can be done
+as well.)

=item C<--stderr>

@@ -377,12 +381,12 @@

I wrote this because, in my work as a TUGboat editor
-(L<http://tug.org/TUGboat>, journal submissions always welcome!), I end
-up running and rerunning many papers, many times each.  It was too 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 me.
+(L<http://tug.org/TUGboat>, journal submissions always welcome!), I run
+and rerun many documents, many times each. It was too 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
+me.

I found some other programs of a similar nature, the LaTeX package
C<silence>, and plenty of other (La)TeX wrappers, but it seemed none of
@@ -394,12 +398,10 @@

Here are some keywords if you want to explore other options:
texloganalyser, pydflatex, logfilter, latexmk, rubber, arara, and
-searching for C<log> at L<http://ctan.org/search>.
+searching for C<log> at L<https://ctan.org/search>.

C<texfot> is written in Perl, and runs on Unix, and does not work on
-Windows.  (If by some chance anyone wants to use this program on
-that os.)
+Windows.

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
@@ -412,6 +414,6 @@
This script and its documentation were written by Karl Berry and both
are released to the public domain.  Email C<karl at freefriends.org> with
bug reports.  It has no home page beyond the package on CTAN:
-L<http://www.ctan.org/pkg/texfot>.
+L<https://ctan.org/pkg/texfot>.

=cut

```