summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2024-04-17 19:39:10 +0000
committerKarl Berry <karl@freefriends.org>2024-04-17 19:39:10 +0000
commit1185eb4874bd1aa65d062dcde3248ed1302435f8 (patch)
treedcf13a79948ac1cde35895ce637cda5cd0541afb /Master
parent616593868207a1d80dfacaee26644da0a27af535 (diff)
texfot (17apr24)
git-svn-id: svn://tug.org/texlive/trunk@70969 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf-dist/doc/man/man1/texfot.1136
-rw-r--r--Master/texmf-dist/doc/man/man1/texfot.man1.pdfbin33948 -> 33743 bytes
-rwxr-xr-xMaster/texmf-dist/scripts/texfot/texfot.pl7
3 files changed, 33 insertions, 110 deletions
diff --git a/Master/texmf-dist/doc/man/man1/texfot.1 b/Master/texmf-dist/doc/man/man1/texfot.1
index e49f576fd9b..22828805b87 100644
--- a/Master/texmf-dist/doc/man/man1/texfot.1
+++ b/Master/texmf-dist/doc/man/man1/texfot.1
@@ -1,4 +1,5 @@
-.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -15,29 +16,12 @@
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
@@ -68,82 +52,20 @@
. \}
.\}
.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.
-. \" fudge factors for nroff and troff
-.if n \{\
-. ds #H 0
-. ds #V .8m
-. ds #F .3m
-. ds #[ \f1
-. ds #] \fP
-.\}
-.if t \{\
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-. ds #V .6m
-. ds #F 0
-. ds #[ \&
-. ds #] \&
-.\}
-. \" simple accents for nroff and troff
-.if n \{\
-. ds ' \&
-. ds ` \&
-. ds ^ \&
-. ds , \&
-. ds ~ ~
-. ds /
-.\}
-.if t \{\
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-. \" troff and (daisy-wheel) nroff accents
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-. \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-. \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-. ds : e
-. ds 8 ss
-. ds o a
-. ds d- d\h'-1'\(ga
-. ds D- D\h'-1'\(hy
-. ds th \o'bp'
-. ds Th \o'LP'
-. ds ae ae
-. ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "TEXFOT 1"
-.TH TEXFOT 1 "2023-08-29" "texfot" "Karl Berry"
+.TH TEXFOT 1 2024-04-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
.nh
-.SH "NAME"
+.SH NAME
texfot \- run TeX, filtering online transcript for interesting messages
-.SH "SYNOPSIS"
+.SH SYNOPSIS
.IX Header "SYNOPSIS"
texfot [\fIoption\fR]... \fItexcmd\fR [\fItexarg\fR...]
-.SH "DESCRIPTION"
+.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\f(CW\*(C`texfot\*(C'\fR invokes \fItexcmd\fR with the given \fItexarg\fR arguments,
filtering the online output for ``interesting'' messages. Its exit
@@ -186,24 +108,24 @@ citations, missing characters from fonts, etc.
.SH "FLOW OF OPERATION"
.IX Header "FLOW OF OPERATION"
Here is the order in which lines of output are checked:
-.IP "1." 4
+.IP 1. 4
If the ``next line'' needs to be printed (see below), print it.
-.IP "2." 4
+.IP 2. 4
Otherwise, if the line matches any user-supplied list of regexps to
accept (given with \f(CW\*(C`\-\-accept\*(C'\fR, see below), in that order, print it.
-.IP "3." 4
+.IP 3. 4
Otherwise, if the line matches the built-in list of regexps to ignore,
or any user-supplied list of regexps to ignore (given with \f(CW\*(C`\-\-ignore\*(C'\fR,
see below), in that order, ignore it.
-.IP "4." 4
+.IP 4. 4
Otherwise, if the line matches the list of regexps for which the next
line (two lines in all) should be shown, show this line and set the
``next line'' flag for the next time around the loop. Examples are the
common \f(CW\*(C`!\*(C'\fR and \f(CW\*(C`filename:lineno:\*(C'\fR error messages, which are generally
followed by a line with specific detail about the error.
-.IP "5." 4
+.IP 5. 4
Otherwise, if the line matches the list of regexps to show, show it.
-.IP "6." 4
+.IP 6. 4
Otherwise, the default: if the line came from stdout, ignore it; if the
line came from stderr, print it (to stdout), with the prefix
\&\f(CW\*(C`[stderr]\ \*(C'\fR. This distinction is made because TeX engines write
@@ -238,7 +160,7 @@ TeX engines, all the regular expressions included in the program are
specific to TeX. So in practice the program isn't useful except with TeX
engines, although it would be easy enough to adapt it (if there was
anything else as verbose as TeX to make that useful).
-.SH "OPTIONS"
+.SH OPTIONS
.IX Header "OPTIONS"
The following are the options to \f(CW\*(C`texfot\*(C'\fR itself (not the TeX engine
being invoked; consult the engine documentation or \f(CW\*(C`\-\-help\*(C'\fR output for
@@ -262,11 +184,11 @@ repeated. This list is checked first, so any and all matches will be
shown, regardless of other options. These regexps are not automatically
anchored (or otherwise altered), simply used as-is.
.ie n .IP """\-\-debug""" 4
-.el .IP "\f(CW\-\-debug\fR" 4
+.el .IP \f(CW\-\-debug\fR 4
.IX Item "--debug"
.PD 0
.ie n .IP """\-\-no\-debug""" 4
-.el .IP "\f(CW\-\-no\-debug\fR" 4
+.el .IP \f(CW\-\-no\-debug\fR 4
.IX Item "--no-debug"
.PD
Output (or not) what the program is doing to standard error; off by default.
@@ -278,22 +200,22 @@ repeated. Adds to the default set of ignore regexps rather than
replacing. Like the acceptance regexps, these are not automatically
anchored (or otherwise altered).
.ie n .IP """\-\-interactive""" 4
-.el .IP "\f(CW\-\-interactive\fR" 4
+.el .IP \f(CW\-\-interactive\fR 4
.IX Item "--interactive"
.PD 0
.ie n .IP """\-\-no\-interactive""" 4
-.el .IP "\f(CW\-\-no\-interactive\fR" 4
+.el .IP \f(CW\-\-no\-interactive\fR 4
.IX Item "--no-interactive"
.PD
By default, standard input to the TeX process is closed so that TeX's
interactive mode (waiting for input upon error, the \f(CW\*(C`*\*(C'\fR prompt, etc.)
is never entered. Giving \f(CW\*(C`\-\-interactive\*(C'\fR allows interaction to happen.
.ie n .IP """\-\-quiet""" 4
-.el .IP "\f(CW\-\-quiet\fR" 4
+.el .IP \f(CW\-\-quiet\fR 4
.IX Item "--quiet"
.PD 0
.ie n .IP """\-\-no\-quiet""" 4
-.el .IP "\f(CW\-\-no\-quiet\fR" 4
+.el .IP \f(CW\-\-no\-quiet\fR 4
.IX Item "--no-quiet"
.PD
By default, the TeX command being invoked is reported on standard
@@ -303,11 +225,11 @@ messages to standard error should be errors from \f(CW\*(C`texfot\*(C'\fR itself
shouldn't be necessary to redirect that, but of course that could be
done as well.)
.ie n .IP """\-\-stderr""" 4
-.el .IP "\f(CW\-\-stderr\fR" 4
+.el .IP \f(CW\-\-stderr\fR 4
.IX Item "--stderr"
.PD 0
.ie n .IP """\-\-no\-stderr""" 4
-.el .IP "\f(CW\-\-no\-stderr\fR" 4
+.el .IP \f(CW\-\-no\-stderr\fR 4
.IX Item "--no-stderr"
.PD
The default is for \f(CW\*(C`texfot\*(C'\fR to report everything written to stderr by
@@ -327,14 +249,14 @@ 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
+.el .IP \f(CW\-\-version\fR 4
.IX Item "--version"
Output version information and exit successfully.
.ie n .IP """\-\-help""" 4
-.el .IP "\f(CW\-\-help\fR" 4
+.el .IP \f(CW\-\-help\fR 4
.IX Item "--help"
Display this help and exit successfully.
-.SH "RATIONALE"
+.SH RATIONALE
.IX Header "RATIONALE"
I wrote this because, in my work as a TUGboat editor
(<https://tug.org/TUGboat>, article submissions always welcome!), I run
@@ -361,16 +283,16 @@ 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
-from the programs. I am not sure what \*(L"fot\*(R" stands for in trip and trap,
-but I can pretend that it stands for \*(L"filter online transcript\*(R" in the
+from the programs. I am not sure what "fot" stands for in trip and trap,
+but I can pretend that it stands for "filter online transcript" in the
present case\ :).
.SH "AUTHORS AND COPYRIGHT"
.IX Header "AUTHORS AND COPYRIGHT"
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 page on \s-1CTAN:\s0
+bug reports. It has no home page beyond the package page on CTAN:
<https://ctan.org/pkg/texfot>.
.PP
.Vb 1
-\& $Id: texfot,v 1.50 2023/08/29 15:20:57 karl Exp $
+\& $Id: texfot,v 1.53 2024/04/17 16:52:12 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 a9005c79b9a..847fcca27f3 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 6ab601f08c6..9e59dcf3d2f 100755
--- a/Master/texmf-dist/scripts/texfot/texfot.pl
+++ b/Master/texmf-dist/scripts/texfot/texfot.pl
@@ -1,5 +1,5 @@
#!/usr/bin/env perl
-# $Id: texfot,v 1.50 2023/08/29 15:20:57 karl Exp $
+# $Id: texfot,v 1.53 2024/04/17 16:52:12 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.50 2023/08/29 15:20:57 karl Exp $';
+my $ident = '$Id: texfot,v 1.53 2024/04/17 16:52:12 karl Exp $';
(my $prg = $0) =~ s,^.*/,,;
select STDERR; $| = 1; # no buffering
select STDOUT; $| = 1;
@@ -147,6 +147,7 @@ sub process_output {
LaTeX\ Warning:\ You\ have\ requested\ package
|LaTeX\ Font\ Warning:\ Some\ font\ shapes
|LaTeX\ Font\ Warning:\ Size\ substitutions
+ |Module\ luamplib\ Warning:\ This\ is\ MetaPost
|Package\ auxhook\ Warning:\ Cannot\ patch
|Package\ biditools\ Warning:\ Patching
|Package\ caption\ Warning:\ Un(supported|known)\ document\ class
@@ -471,6 +472,6 @@ are released to the public domain. Email C<karl@freefriends.org> with
bug reports. It has no home page beyond the package page on CTAN:
L<https://ctan.org/pkg/texfot>.
- $Id: texfot,v 1.50 2023/08/29 15:20:57 karl Exp $
+ $Id: texfot,v 1.53 2024/04/17 16:52:12 karl Exp $
=cut