From 37f77685a693b9cad0901d2d5b918805c57580b2 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 23 Apr 2022 21:11:56 +0000 Subject: texlogsieve (23apr22) git-svn-id: svn://tug.org/texlive/trunk@63115 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/support/texlogsieve/README.md | 16 ++++++++++------ .../doc/support/texlogsieve/texlogsieve.pdf | Bin 58593 -> 59004 bytes .../doc/support/texlogsieve/texlogsieve.tex | 19 ++++++++++++------- 3 files changed, 22 insertions(+), 13 deletions(-) (limited to 'Master/texmf-dist/doc/support') diff --git a/Master/texmf-dist/doc/support/texlogsieve/README.md b/Master/texmf-dist/doc/support/texlogsieve/README.md index e7e92339978..fd13e3de2bb 100644 --- a/Master/texmf-dist/doc/support/texlogsieve/README.md +++ b/Master/texmf-dist/doc/support/texlogsieve/README.md @@ -3,8 +3,13 @@ `texlogsieve` reads a LaTeX log file (or the standard input if no file is specified), filters out less relevant messages, and displays a summary report. It is a `texlua` script, similar in spirit to tools such as -`texfot`, `texloganalyser`, `rubber-info`, `textlog_extract`, -`texlogparser`, and others. Highlights: +[`texfot`](https://ctan.org/pkg/texfot), +[`texloganalyser`](https://ctan.org/pkg/texloganalyser), +[`rubber-info`](https://gitlab.com/latex-rubber/rubber), +[`textlog_extract`](https://ctan.org/pkg/texlog-extract), +[`texlogparser`](https://github.com/reitzig/texlogparser), +[`texlogfilter`](https://gricad-gitlab.univ-grenoble-alpes.fr/labbeju/latex-packages), +and others. Highlights: * Two reports: the most important messages from the log file followed by a summary of repeated messages, undefined references etc.; @@ -16,9 +21,7 @@ report. It is a `texlua` script, similar in spirit to tools such as * Several options to control which messages should be filtered out; -* No messages are accidentally removed; - -* The summary report is currently simple, but useful. +* No messages are accidentally removed. `texlogsieve` **must** be run from the same directory as `[pdf|lua|xe]latex`, because it searches for the files used during compilation (packages loaded @@ -38,7 +41,8 @@ or texlogsieve myfile.log ``` -and be satisfied with the result. +and be satisfied with the result (still, you should check the "Tips" +section of the documentation). Since it needs to know what messages to expect, `texlogsieve` is currently geared towards LaTeX; I have no idea how it would work with diff --git a/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.pdf b/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.pdf index b8fcee8d52f..4bac5034a6a 100644 Binary files a/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.pdf and b/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.pdf differ diff --git a/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.tex b/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.tex index 38e179285d1..9d7d2d751bc 100644 --- a/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.tex +++ b/Master/texmf-dist/doc/support/texlogsieve/texlogsieve.tex @@ -75,12 +75,14 @@ \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 variable scope} \changes{1.1.2}{2022/03/14}{Fix bug unwrapping lines starting with ``]''} +\changes{1.1.3}{2022/04/22}{Be more careful with continuation lines in error + msgs} \begin{document} \title{\textsf{texlogsieve}:\thanks{This document -corresponds to \textsf{texlogsieve}~1.1.2, -dated~2022-03-14.}\\[.3\baselineskip] +corresponds to \textsf{texlogsieve}~1.1.3, +dated~2022-04-22.}\\[.3\baselineskip] {\normalsize(yet another program to)\\[-.6\baselineskip]} {\large filter and summarize \LaTeX\ log files} } @@ -108,8 +110,7 @@ a summary report. Highlights: wrapping and does a much better job at that than existing tools; \item Multiline messages are treated as a single entity; \item Several options to control which messages should be filtered out; - \item No messages are accidentally removed; - \item The summary report is currently simple, but useful. + \item No messages are accidentally removed. \end{itemize} \end{abstract} @@ -122,9 +123,13 @@ character'', ``undefined reference'', and others become buried among lots of less relevant messages. This program filters out such less relevant messages and outputs the rest, together with a final summary for the specially important ones. It is a \texttt{texlua} script, similar in -spirit to tools such as \texttt{texfot}, \texttt{texloganalyser}, -\texttt{rubber-info}, \texttt{textlog\_extract}, \texttt{texlogparser}, -and others. +spirit to tools such as \href{https://ctan.org/pkg/texfot}{\texttt{texfot}}, +\href{https://ctan.org/pkg/texloganalyser}{\texttt{texloganalyser}}, +\href{https://gitlab.com/latex-rubber/rubber}{\texttt{rubber-info}}, +\href{https://ctan.org/pkg/texlog-extract}{\texttt{textlog\_extract}}, +\href{https://github.com/reitzig/texlogparser}{\texttt{texlogparser}}, +\href{https://gricad-gitlab.univ-grenoble-alpes.fr/labbeju/latex-packages} +{\texttt{texlogfilter}}, and others. Note that it does not try to do anything smart about error messages (but it shows a warning in the summary if one is detected); if there -- cgit v1.2.3