summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-02-17 21:48:01 +0000
committerKarl Berry <karl@freefriends.org>2022-02-17 21:48:01 +0000
commit1d673b607ed5fe711a3e4b67eefedbc5b1fdaa6b (patch)
tree5c99b7f1c18617638f960c7784bf2630400e3baf /Master/texmf-dist/doc/man
parentad59fa4275f36a12c72af4b1f5bd6aa06b522101 (diff)
texfot (17feb22)
git-svn-id: svn://tug.org/texlive/trunk@62062 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man')
-rw-r--r--Master/texmf-dist/doc/man/man1/texfot.130
-rw-r--r--Master/texmf-dist/doc/man/man1/texfot.man1.pdfbin31312 -> 32546 bytes
2 files changed, 19 insertions, 11 deletions
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
(<https://tug.org/TUGboat>, 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 <https://ctan.org/search>.
.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
<https://ctan.org/pkg/texfot>.
+.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
--- a/Master/texmf-dist/doc/man/man1/texfot.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/texfot.man1.pdf
Binary files differ