texlogsieve (2feb22)

git-svn-id: svn://tug.org/texlive/trunk@61859 c570f23f-e606-0410-a88d-b1316a301751

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
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
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}