summaryrefslogtreecommitdiff
path: root/support/texlogsieve/texlogsieve.tex
diff options
context:
space:
mode:
Diffstat (limited to 'support/texlogsieve/texlogsieve.tex')
-rw-r--r--support/texlogsieve/texlogsieve.tex40
1 files changed, 36 insertions, 4 deletions
diff --git a/support/texlogsieve/texlogsieve.tex b/support/texlogsieve/texlogsieve.tex
index 3608343743..eb1ad52870 100644
--- a/support/texlogsieve/texlogsieve.tex
+++ b/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}