summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-02-02 21:41:21 +0000
committerKarl Berry <karl@freefriends.org>2022-02-02 21:41:21 +0000
commitd4cbd833ea2b1e5f6b7dd39c10a9eed4c57b9df2 (patch)
tree95483158e1c8e6bc214ea7ca229b839499104aed /Master/texmf-dist/doc
parent56116169670197f29747c0aac833ec9a95192895 (diff)
texlogsieve (2feb22)
git-svn-id: svn://tug.org/texlive/trunk@61859 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/man/man1/texlogsieve.124
-rw-r--r--Master/texmf-dist/doc/man/man1/texlogsieve.man1.pdfbin40761 -> 40946 bytes
-rw-r--r--Master/texmf-dist/doc/support/texlogsieve/texlogsieve.pdfbin51179 -> 52118 bytes
-rw-r--r--Master/texmf-dist/doc/support/texlogsieve/texlogsieve.tex40
4 files changed, 57 insertions, 7 deletions
diff --git a/Master/texmf-dist/doc/man/man1/texlogsieve.1 b/Master/texmf-dist/doc/man/man1/texlogsieve.1
index 41095e2374e..a6656bcc0db 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" "January 2022" "texlogsieve 1.0.0-beta-2" "User Commands"
+.TH TEXLOGSIEVE "1" "February 2022" "texlogsieve 1.0.0-beta-3" "User Commands"
.SH NAME
@@ -84,6 +84,22 @@ summary. With \-\-no\-box\-detail, the summary presents only a list of
pages and files that had under/overfull boxes (default enabled).
.TP
+\fB\-\-ref\-detail\fR, \fB\-\-no\-ref\-detail\fR
+Include/exclude detailed information on undefined references in the final
+summary. With \-\-no\-ref\-detail, the summary presents only a list of
+undefined references, without page numbers and filenames (default enabled).
+
+.TP
+\fB\-\-cite\-detail\fR, \fB\-\-no\-cite\-detail\fR
+Include/exclude detailed information on undefined citations in the final
+summary. With \-\-no\-cite\-detail, the summary presents only a list of
+undefined citations, without page numbers and filenames (default enabled).
+
+.TP
+\fB\-\-summary\-detail\fR, \fB\-\-no\-summary\-detail\fR
+Toggle \-\-box\-detail, \-\-ref\-detail, and \-\-cite\-detail at once.
+
+.TP
\fB\-\-heartbeat\fR, \fB\-\-no\-heartbeat\fR
Enable/disable progress gauge in page-delay mode (default enabled).
@@ -124,8 +140,10 @@ characters in the message, including newlines. If needed, you may precede the
string with \[lq]////\[rq], in which case you can use lua-style pattern matching
(\c
.UR https://www.lua.org/pil/20.2.html
-.UE ). Note that the string is used verbatim: you need not (and should not)
-enclose it in quotes nor escape special characters such as \[lq]\e\[rq].
+.UE ). Note that the string is used verbatim: you may need to enclose it in
+quotes or escape special characters such as \[lq]\e\[rq] for the benefit of
+the shell, but such quoting and escaping is unnecessary (and harmful) in the
+configuration file.
.TP
\fB\-\-silence\-file\fR=\fI\,FILENAME OR FILE GLOB\/\fR
diff --git a/Master/texmf-dist/doc/man/man1/texlogsieve.man1.pdf b/Master/texmf-dist/doc/man/man1/texlogsieve.man1.pdf
index 12059aaf046..0f7b7e77472 100644
--- a/Master/texmf-dist/doc/man/man1/texlogsieve.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/texlogsieve.man1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.pdf b/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.pdf
index 35a729df5de..bf2f2df5f9f 100644
--- a/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.pdf
+++ b/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.tex b/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.tex
index 3608343743f..eb1ad528700 100644
--- a/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.tex
+++ b/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.tex
@@ -34,6 +34,8 @@
\usepackage{libertinus}
\usepackage[scale=.85]{sourcecodepro}
+\usepackage{microtype}
+\usepackage{metalogo}
\RecordChanges
@@ -51,12 +53,20 @@
\texttt{-\/-add-[info\textbar
warning]-message} from working}
\changes{v1.0.0-beta-2}{2022/01/04}{Misc small bugfixes}
+\changes{v1.0.0-beta-3}{2022/02/02}{Add options
+ \texttt{-\/-summary-detail},
+ \texttt{-\/-ref-detail},
+ \texttt{-\/-cite-detail}}
+\changes{v1.0.0-beta-3}{2022/02/02}{Abort on invalid command-line options}
+\changes{v1.0.0-beta-3}{2022/02/02}{Detect ``please rerun`` messages and
+ add them to the summary}
+\changes{v1.0.0-beta-3}{2022/02/02}{Fix line unwrapping with \XeTeX}
\begin{document}
\title{\textsf{texlogsieve}:\thanks{This document
-corresponds to \textsf{texlogsieve}~1.0.0-beta-2,
-dated~2022-01-04.}\\[.3\baselineskip]
+corresponds to \textsf{texlogsieve}~1.0.0-beta-3,
+dated~2022-02-02.}\\[.3\baselineskip]
{\normalsize(yet another program to)\\[-.6\baselineskip]}
{\large filter and summarize \LaTeX\ log files}
}
@@ -253,6 +263,26 @@ of pages and files that had under/overfull boxes (default enabled).
\end{description}
\begin{description}
+\item[\texttt{-\/-ref-detail}, \texttt{-\/-no-ref-detail}]~\\
+Include/exclude detailed information on undefined references in the final
+summary. With \texttt{-\/-no-ref-detail}, the summary presents only a list of
+undefined references, without page numbers and filenames (default enabled).
+\end{description}
+
+\begin{description}
+\item[\texttt{-\/-cite-detail}, \texttt{-\/-no-cite-detail}]~\\
+Include/exclude detailed information on undefined citations in the final
+summary. With \texttt{-\/-no-cite-detail}, the summary presents only a list
+of undefined citations, without page numbers and filenames (default enabled).
+\end{description}
+
+\begin{description}
+\item[\texttt{-\/-summary-detail}, \texttt{-\/-no-summary-detail}]~\\
+Toggle \texttt{-\/-box-detail}, \texttt{-\/-ref-detail}, and
+\texttt{-\/-cite-detail} at once.
+\end{description}
+
+\begin{description}
\item[\texttt{-\/-heartbeat}, \texttt{-\/-no-heartbeat}]~\\
Enable/disable progress gauge in page-delay mode (default enabled).
\end{description}
@@ -297,8 +327,10 @@ messages: space characters in the provided string match any sequence of
whitespace characters in the message, including newlines. If needed, you
may precede the string with ``////'', in which case you can use lua-style
pattern matching (\url{https://www.lua.org/pil/20.2.html}). Note that the
-string is used verbatim: you need not (and should not) enclose it in quotes
-nor escape special characters such as ``\textbackslash''.
+string is used verbatim: you may need to enclose it in quotes or escape
+special characters such as ``\textbackslash'' for the benefit of the
+shell, but such quoting and escaping is unnecessary (and harmful) in
+the configuration file.
\end{description}
\begin{description}