summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-08-07 21:45:17 +0000
committerKarl Berry <karl@freefriends.org>2015-08-07 21:45:17 +0000
commit809a2782f6a6514f7689c13bdc1875a4fd388e5a (patch)
treeed66a0d3c924a55ee2a90f19d1e0e8c038ac69b2 /Master/texmf-dist/doc/man/man1
parent652fddcc2fe810532f6c88b47758fc2ab8eae299 (diff)
texfot (7aug15)
git-svn-id: svn://tug.org/texlive/trunk@38071 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1')
-rw-r--r--Master/texmf-dist/doc/man/man1/texfot.135
-rw-r--r--Master/texmf-dist/doc/man/man1/texfot.man1.pdfbin12095 -> 12309 bytes
2 files changed, 23 insertions, 12 deletions
diff --git a/Master/texmf-dist/doc/man/man1/texfot.1 b/Master/texmf-dist/doc/man/man1/texfot.1
index 70795a88e24..05697bde084 100644
--- a/Master/texmf-dist/doc/man/man1/texfot.1
+++ b/Master/texmf-dist/doc/man/man1/texfot.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "TEXFOT 1"
-.TH TEXFOT 1 "2014-10-10" "texfot" "Karl Berry"
+.TH TEXFOT 1 "2015-08-06" "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
@@ -186,9 +186,9 @@ or any user-supplied list of regexps to ignore (given with \f(CW\*(C`\-\-ignore\
see below), in that order, ignore it.
.IP "3." 4
Otherwise, if the line matches the list of regexps for which the next
-line (two lines in all) should be shown, set the ``next line'' flag for
-the next time around the loop and show this line. Examples are the
-usual \f(CW\*(C`!\*(C'\fR and \f(CW\*(C`filename:lineno:\*(C'\fR error messages, which are generally
+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 "4." 4
Otherwise, if the line matches the list of regexps to show, show it.
@@ -252,7 +252,7 @@ altered), simply used as-is.
.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.)
-never happens. Giving \f(CW\*(C`\-\-interactive\*(C'\fR allows interaction to happen.
+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
.IX Item "--quiet"
@@ -263,6 +263,17 @@ never happens. Giving \f(CW\*(C`\-\-interactive\*(C'\fR allows interaction to h
.PD
By default, the TeX command being invoked is reported on standard output.
\&\f(CW\*(C`\-\-quiet\*(C'\fR omits that reporting.
+.ie n .IP """\-\-stderr""" 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
+.IX Item "--no-stderr"
+.PD
+The default is for \f(CW\*(C`texfot\*(C'\fR to report everything written to stderr by
+the TeX command (on stdout). \f(CW\*(C`\-\-no\-stderr\*(C'\fR omits that reporting.
+(Some programs, \f(CW\*(C`dvisvgm\*(C'\fR is one, can be rather verbose on stderr.)
.ie n .IP """\-\-tee"" \fIfile\fR" 4
.el .IP "\f(CW\-\-tee\fR \fIfile\fR" 4
.IX Item "--tee file"
@@ -282,12 +293,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>, submissions welcome, by the way), 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 all the style files being read and all the
-fonts being used. I wanted to see all and only those messages which
-actually needed some action by me.
+(<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 all the style files being read
+and all the 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 \f(CW\*(C`silence\*(C'\fR LaTeX
package, and plenty of other (La)TeX wrappers, but it seemed none of
@@ -304,7 +315,7 @@ searching for \f(CW\*(C`log\*(C'\fR at <http://ctan.org/search>.
\&\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
-it.)
+that os.)
.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
diff --git a/Master/texmf-dist/doc/man/man1/texfot.man1.pdf b/Master/texmf-dist/doc/man/man1/texfot.man1.pdf
index c2693030de4..f6dfb36ce48 100644
--- a/Master/texmf-dist/doc/man/man1/texfot.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/texfot.man1.pdf
Binary files differ