summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/texlogsieve.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/texlogsieve.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/texlogsieve.129
1 files changed, 20 insertions, 9 deletions
diff --git a/Master/texmf-dist/doc/man/man1/texlogsieve.1 b/Master/texmf-dist/doc/man/man1/texlogsieve.1
index a6656bcc0db..bd5d7b38fc5 100644
--- a/Master/texmf-dist/doc/man/man1/texlogsieve.1
+++ b/Master/texmf-dist/doc/man/man1/texlogsieve.1
@@ -1,4 +1,4 @@
-.TH TEXLOGSIEVE "1" "February 2022" "texlogsieve 1.0.0-beta-3" "User Commands"
+.TH TEXLOGSIEVE "1" "February 2022" "texlogsieve 1.0.0" "User Commands"
.SH NAME
@@ -66,6 +66,11 @@ Enable/disable reporting shipouts (default disabled with page-delay,
enabled with no-page-delay).
.TP
+\fB\-\-file\-banner\fR, \fB\-\-no\-file\-banner\fR
+Show/don't show the \[lq]From file...\[rq] banner messages (default
+enabled, except with level DEBUG as that would be redundant and confusing).
+
+.TP
\fB\-\-repetitions\fR, \fB\-\-no\-repetitions\fR
Allow/prevent repeated messages (default disabled, i.e., repeated messages
are supressed).
@@ -104,6 +109,11 @@ Toggle \-\-box\-detail, \-\-ref\-detail, and \-\-cite\-detail at once.
Enable/disable progress gauge in page-delay mode (default enabled).
.TP
+\fB\-\-color\fR, \fB\-\-no\-color\fR
+Enable/disable colored output. On Windows, this will only work with
+an up-to-date Windows 10 or later (default disabled).
+
+.TP
\fB\-l\fR \fI\,LEVEL\/\fR, \fB\-\-minlevel\fR=\fI\,LEVEL\/\fR
Filter out messages with severity level lower than LEVEL. Valid levels
are DEBUG (no filtering), INFO, WARNING, CRITICAL, and UNKNOWN (default
@@ -115,13 +125,13 @@ Do not filter messages and do not output the summary, only unwrap long,
wrapped lines. The output should be very similar (but not equal) to the
input file, but with wrapped lines reconstructed. This activates \-l debug,
\-\-no\-summary, \-\-no\-page\-delay, \-\-repetitions, \-\-be\-redundant,
-and \-\-shipouts, and also supresses the verbose \[lq]open/close file\[rq]
-and \[lq]shipout\[rq] messages, simulating instead the TeX format, with parens
-and square brackets. This is useful if you prefer the reports generated
-by some other tool but want to benefit from texlogsieve's line unwrapping
-algorithm; the output generated by this option should be parseable by other
-tools (but you probably need to coerce the other tool not to try to unwrap
-lines).
+\-\-shipouts, and \-\-no\-file\-banner, and also supresses the verbose
+\[lq]open/close file\[rq] and \[lq]shipout\[rq] messages, simulating
+instead the TeX format, with parens and square brackets. This is useful if
+you prefer the reports generated by some other tool but want to benefit
+from texlogsieve's line unwrapping algorithm; the output generated by this
+option should be parseable by other tools (but you probably need to coerce
+the other tool not to try to unwrap lines).
.TP
\fB\-\-silence\-package\fR=\fI\,PKGNAME\/\fR
@@ -260,7 +270,8 @@ TeX. Still, adding support to them should not be too difficult.
.SH SEE ALSO
-The pdf documentation (in TeXLive, try \fI\,texdoc texlogsieve\/\fR).
+The pdf documentation (in TeXLive, try \fI\,texdoc texlogsieve\/\fR)
+includes a \fBTIPS\fR section you may find useful.
If you want to know more about the TeX log file and the workings of the
program, check the initial comments in the code.