From 809a2782f6a6514f7689c13bdc1875a4fd388e5a Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 7 Aug 2015 21:45:17 +0000 Subject: texfot (7aug15) git-svn-id: svn://tug.org/texlive/trunk@38071 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/texfot.1 | 35 ++++++++++++++++--------- Master/texmf-dist/doc/man/man1/texfot.man1.pdf | Bin 12095 -> 12309 bytes 2 files changed, 23 insertions(+), 12 deletions(-) (limited to 'Master/texmf-dist/doc/man/man1') 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 -(, 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. +(, 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 . \&\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 Binary files a/Master/texmf-dist/doc/man/man1/texfot.man1.pdf and b/Master/texmf-dist/doc/man/man1/texfot.man1.pdf differ -- cgit v1.2.3