summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-03-05 21:09:21 +0000
committerKarl Berry <karl@freefriends.org>2022-03-05 21:09:21 +0000
commit67da68b691ab4ae95dad681fe32ced47f19f8626 (patch)
treeaa14634e909ac2e628639960f6cb056376737fff /Master/texmf-dist/doc/support
parente6cd03a2f53e43077a415cf7197f92883f8d359e (diff)
texlogsieve (5mar22)
git-svn-id: svn://tug.org/texlive/trunk@62453 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support')
-rw-r--r--Master/texmf-dist/doc/support/texlogsieve/texlogsieve.pdfbin56978 -> 58436 bytes
-rw-r--r--Master/texmf-dist/doc/support/texlogsieve/texlogsieve.tex25
2 files changed, 18 insertions, 7 deletions
diff --git a/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.pdf b/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.pdf
index 1301f70b662..1e56d8a04e3 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 17d1919575e..b0530874089 100644
--- a/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.tex
+++ b/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.tex
@@ -67,12 +67,19 @@
\changes{1.0.0-final={1.0.0}}{2022/02/09}{Add options \texttt{-\/-file-banner}
and \texttt{-\/-color}}
\changes{1.0.0-final={1.0.0}}{2022/02/09}{Changed the effect of filters on the summary}
+\changes{1.1.0}{2022/03/04}{Print ``No important messages to show'' when
+ nothing is printed}
+\changes{1.1.0}{2022/03/04}{Fix bug with filename and URL on the same line}
+\changes{1.1.0}{2022/03/04}{Print warning in the summary when there are
+ error messages}
+\changes{1.1.0}{2022/03/04}{Do not lose messages if the file is truncated}
+\changes{1.1.1}{2022/03/05}{Fix error in scope variable}
\begin{document}
\title{\textsf{texlogsieve}:\thanks{This document
-corresponds to \textsf{texlogsieve}~1.0.0,
-dated~2022-02-09.}\\[.3\baselineskip]
+corresponds to \textsf{texlogsieve}~1.1.1,
+dated~2022-03-05.}\\[.3\baselineskip]
{\normalsize(yet another program to)\\[-.6\baselineskip]}
{\large filter and summarize \LaTeX\ log files}
}
@@ -119,10 +126,11 @@ spirit to tools such as \texttt{texfot}, \texttt{texloganalyser},
and others.
Note that it does not try to do anything smart about error messages
-(at least for now); if there is an error, you probably want to take a
-look directly at the log file anyway. It also cannot detect if \LaTeX{}
-stops for user input, so you should \textbf{really} run \LaTeX\ in
-\texttt{nonstopmode} when \texttt{texlogsieve} is reading from a pipe.
+(but it shows a warning in the summary if one is detected); if there
+is an error, you probably want to take a look directly at the log file
+anyway. It also cannot detect if \LaTeX{} stops for user input, so
+you should \textbf{really} run \LaTeX\ in \texttt{nonstopmode} when
+\texttt{texlogsieve} is reading from a pipe.
\texttt{texlogsieve} \textbf{must} be run from the same directory as
\verb/[pdf|lua|xe]latex/, because it searches for the files used during
@@ -159,7 +167,10 @@ in quite a few cases (check the comments in the \texttt{texlogsieve} code
for a discussion on that). So, if at all possible, it is a very good idea
to set \texttt{max\_print\_line} to a really large value (such as 100,000),
effectively disabling line wrapping. It was useful in the 1980s, but not
-anymore (your terminal or editor wraps automatically).
+anymore (your terminal or editor wraps automatically)\footnote{Likewise,
+\texttt{error\_line} and \texttt{half\_error\_line} should be, respectively,
+254 and 238 (more about these values here:
+\url{https://tex.stackexchange.com/a/525972}).}.
Still, \texttt{texlogsieve} goes to great lengths to correctly handle
\TeX{} line wrapping and does a pretty good job at that. It understands