diff options
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/texfot.1 | 35 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/texfot.man1.pdf | bin | 12095 -> 12309 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/texfot/README | 6 |
3 files changed, 26 insertions, 15 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 Binary files differindex c2693030de4..f6dfb36ce48 100644 --- a/Master/texmf-dist/doc/man/man1/texfot.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/texfot.man1.pdf diff --git a/Master/texmf-dist/doc/support/texfot/README b/Master/texmf-dist/doc/support/texfot/README index 15481ab2542..81b84dc9283 100644 --- a/Master/texmf-dist/doc/support/texfot/README +++ b/Master/texmf-dist/doc/support/texfot/README @@ -1,6 +1,6 @@ texfot is a Perl script to filter the online output from a TeX run, -attempting to show only those messages which probably deserve some -change in the source. The TeX invocation itself need not change. +attempting to show only those messages which (probably) deserve some +attention in the source. The TeX invocation itself need not change. The PDF file is made from the POD documentation in the Perl source: pod2man texfot.pl | groff -man -t -rS11 | ps2pdf - texfot.pdf @@ -13,4 +13,4 @@ Supposedly it is possible to add options to either groff or ps2pdf Originally written in 2014. Released to the public domain. Author: Karl Berry <karl@freefriends.org> -Home page: http://www.ctan.org/pkg/texfot +Home page: http://ctan.org/pkg/texfot |