diff options
author | Karl Berry <karl@freefriends.org> | 2022-03-05 21:09:36 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-03-05 21:09:36 +0000 |
commit | 78e8e11677f05c6d8c95666100af8481943d9d8a (patch) | |
tree | b2f1720b71bf38cbebfe7cbc98d2a36b8c8c5d11 /Master/texmf-dist/doc | |
parent | 9825faffa8b69c03762ebbc1810aa7a93809bece (diff) |
texlogsieve (5mar22) (branch)
git-svn-id: svn://tug.org/texlive/branches/branch2021.final@62454 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/texlogsieve.1 | 15 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/texlogsieve.man1.pdf | bin | 41446 -> 41517 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/texlogsieve/texlogsieve.pdf | bin | 56978 -> 58436 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/texlogsieve/texlogsieve.tex | 25 |
4 files changed, 26 insertions, 14 deletions
diff --git a/Master/texmf-dist/doc/man/man1/texlogsieve.1 b/Master/texmf-dist/doc/man/man1/texlogsieve.1 index bd5d7b38fc5..d386ebd7ff8 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" "February 2022" "texlogsieve 1.0.0" "User Commands" +.TH TEXLOGSIEVE "1" "March 2022" "texlogsieve 1.1.1" "User Commands" .SH NAME @@ -258,11 +258,11 @@ silence\-files = *.sty .SH LIMITATIONS -texlogsieve 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 \fBreally\fR run LaTeX in \fI\,nonstopmode\/\fR when texlogsieve -is reading from a pipe. +texlogsieve does not try to do anything smart about error messages (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 \fBreally\fR +run LaTeX in \fI\,nonstopmode\/\fR when texlogsieve is reading from a pipe. Since it needs to know what messages to expect, texlogsieve is currently geared towards LaTeX; I have no idea how it would work with ConTeXt or plain @@ -271,7 +271,8 @@ TeX. Still, adding support to them should not be too difficult. .SH SEE ALSO The pdf documentation (in TeXLive, try \fI\,texdoc texlogsieve\/\fR) -includes a \fBTIPS\fR section you may find useful. +is a little more verbose than this manpage and includes a \fBTIPS\fR +section you may find useful. If you want to know more about the TeX log file and the workings of the program, check the initial comments in the code. diff --git a/Master/texmf-dist/doc/man/man1/texlogsieve.man1.pdf b/Master/texmf-dist/doc/man/man1/texlogsieve.man1.pdf Binary files differindex 5a30d5da6f2..57506cbc4bf 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 Binary files differindex 1301f70b662..1e56d8a04e3 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 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 |