From 1d673b607ed5fe711a3e4b67eefedbc5b1fdaa6b Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 17 Feb 2022 21:48:01 +0000 Subject: texfot (17feb22) git-svn-id: svn://tug.org/texlive/trunk@62062 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/texfot.1 | 30 ++++++++++++++++--------- Master/texmf-dist/doc/man/man1/texfot.man1.pdf | Bin 31312 -> 32546 bytes 2 files changed, 19 insertions(+), 11 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 491001177e8..85ba26172b4 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.14 (Pod::Simple 3.40) +.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42) .\" .\" Standard preamble: .\" ======================================================================== @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "TEXFOT 1" -.TH TEXFOT 1 "2021-05-01" "texfot" "Karl Berry" +.TH TEXFOT 1 "2022-02-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 @@ -153,8 +153,8 @@ value is that of \fItexcmd\fR. Examples: \& # Sample basic invocation: \& texfot pdflatex file.tex \& -\& # Ordinarily all output is copied to /tmp/fot before filtering, -\& # but that can be omitted: +\& # Ordinarily the full output is copied to /tmp/fot.$UID before +\& # filtering, but that can be omitted, or the filename changed: \& texfot \-\-tee=/dev/null lualatex file.tex \& \& # Example of more complex engine invocation: @@ -285,11 +285,15 @@ the TeX command (on stdout). \f(CW\*(C`\-\-no\-stderr\*(C'\fR omits that report .el .IP "\f(CW\-\-tee\fR \fIfile\fR" 4 .IX Item "--tee file" By default, the output being filtered is \f(CW\*(C`tee\*(C'\fR\-ed, before filtering, to -\&\f(CW\*(C`$TMPDIR/fot\*(C'\fR (or \f(CW\*(C`$TMP/fot\*(C'\fR if \f(CW\*(C`TMP\*(C'\fR is set, or \f(CW\*(C`/tmp/fot\*(C'\fR if -neither environment variable is set), to make it easy to check the full -output when the filtering seems suspect. This option allows specifying a -different file. Use \f(CW\*(C`\-\-tee\ /dev/null\*(C'\fR if you don't want the original -output at all. +make it easy to check the full output in case of problems. +.Sp +The default \fIfile\fR is \f(CW\*(C`$TMPDIR/fot.\*(C'\fR\fIuid\fR; if \f(CW\*(C`TMPDIR\*(C'\fR is not set, +\&\f(CW\*(C`TMP\*(C'\fR is used if set; if neither is set, the default directory is +\&\f(CW\*(C`/tmp\*(C'\fR. For example: \f(CW\*(C`/tmp/fot.1001\*(C'\fR. The \fIuid\fR suffix is the +effective userid of the process, appended for basic avoidance of +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 .IX Item "--version" @@ -302,7 +306,7 @@ Display this help and exit successfully. .IX Header "RATIONALE" I wrote this because, in my work as a TUGboat editor (, journal submissions always welcome!), I run -and rerun many documents, many times each. It was too easy to lose +and rerun many documents, many times each. It was 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 @@ -322,7 +326,7 @@ searching for \f(CW\*(C`log\*(C'\fR at . .PP \&\f(CW\*(C`texfot\*(C'\fR is written in Perl, and runs on Unix. It may work on Windows if Perl and other software is installed, but I don't use Windows and -don't support C,texfot> there. +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 @@ -335,3 +339,7 @@ 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 . +.PP +.Vb 1 +\& $Id: texfot,v 1.45 2022/02/17 18:42:02 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 53e89ac2637..07a865f745e 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