summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/texfot.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-07-01 21:12:46 +0000
committerKarl Berry <karl@freefriends.org>2019-07-01 21:12:46 +0000
commit42ef9956ca9666303f8266c1aafc1d055a217b57 (patch)
treeeec516a72431088a3aca110fcae29e862f2cd7f3 /Master/texmf-dist/doc/man/man1/texfot.1
parent2717d0fe451cea4e239315a39487ea999a06c507 (diff)
texfot (1jul19)
git-svn-id: svn://tug.org/texlive/trunk@51525 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/texfot.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/texfot.162
1 files changed, 34 insertions, 28 deletions
diff --git a/Master/texmf-dist/doc/man/man1/texfot.1 b/Master/texmf-dist/doc/man/man1/texfot.1
index 373152e74f7..3691e276fcc 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.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.
.if n .ad l
@@ -149,12 +153,12 @@ value is that of \fItexcmd\fR. Examples:
\& # 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 @@ followed by a line with specific detail about the error.
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 @@ is never entered. Giving \f(CW\*(C`\-\-interactive\*(C'\fR allows interaction t
.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 @@ Display this help and exit successfully.
.SH "RATIONALE"
.IX Header "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 @@ complicated). Hence I wrote this.
.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
-Windows, please make your own fork; I'm not interested in supporting
-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 @@ the present case\ :).
.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 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>.