texlive[60609] Master/texmf-dist: latexbug (25sep21)
commits+karl at tug.org
commits+karl at tug.org
Sat Sep 25 23:25:48 CEST 2021
Revision: 60609
http://tug.org/svn/texlive?view=revision&revision=60609
Author: karl
Date: 2021-09-25 23:25:48 +0200 (Sat, 25 Sep 2021)
Log Message:
-----------
latexbug (25sep21)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/latexbug/changes.txt
trunk/Master/texmf-dist/doc/latex/latexbug/latexbug.pdf
trunk/Master/texmf-dist/source/latex/latexbug/latexbug.dtx
trunk/Master/texmf-dist/tex/latex/latexbug/latexbug.sty
Modified: trunk/Master/texmf-dist/doc/latex/latexbug/changes.txt
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latexbug/changes.txt 2021-09-25 21:25:23 UTC (rev 60608)
+++ trunk/Master/texmf-dist/doc/latex/latexbug/changes.txt 2021-09-25 21:25:48 UTC (rev 60609)
@@ -1,3 +1,13 @@
+2021-09-25 Frank Mittelbach <Frank.Mittelbach at latex-project.org>
+
+ * latexbug.dtx: don't warn for expl3.ltx (part of rollback)
+
+2021-08-26 Frank Mittelbach <Frank.Mittelbach at latex-project.org>
+
+ * latexbug.dtx:
+ Do not classify packages maintained by us (but in different
+ repositories) as third-party files.
+
2021-06-27 Frank Mittelbach <Frank.Mittelbach at latex-project.org>
* latexbug.dtx:
Modified: trunk/Master/texmf-dist/doc/latex/latexbug/latexbug.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/source/latex/latexbug/latexbug.dtx
===================================================================
--- trunk/Master/texmf-dist/source/latex/latexbug/latexbug.dtx 2021-09-25 21:25:23 UTC (rev 60608)
+++ trunk/Master/texmf-dist/source/latex/latexbug/latexbug.dtx 2021-09-25 21:25:48 UTC (rev 60609)
@@ -105,8 +105,7 @@
%
% An error is generated if the test file makes use of third-party code
% that is not maintained by the \LaTeX{} Project Team. For example, if
-% the file would load \texttt{geometry}, \texttt{footmisc} and
-% \texttt{hyperref} you
+% the file would load \texttt{geometry} and \texttt{footmisc} you
% would see the following:
% \begin{verbatim}
% Package latexbug Error: Third-party file(s)
@@ -117,8 +116,6 @@
% (latexbug) geometry.sty -> Hideo Umeki
% (latexbug) <latexgeometry [at] gmail [dot] com>
% (latexbug) footmisc.sty
-% (latexbug) hyperref.sty -> LaTeX Team
-% (latexbug) https://github.com/latex3/hyperref/issues
% (latexbug) ==============
% (latexbug)
% \end{verbatim}
@@ -137,7 +134,7 @@
% To make life somewhat easier \texttt{latexbug} will tell you the
% name of the maintainer (if we know it and have added it in) and if
% possible also the canonical bug address for the package (like in the
-% case of \texttt{geometry} and \texttt{hyperref}).
+% case of \texttt{geometry}).
% If we don't have that information, you
% need to find it out for yourself by looking at the package
% documentation.
@@ -158,6 +155,43 @@
%
% \vspace*{1ex}
%
+% It is also possible that \texttt{latexbug} doesn't generate an
+% error, but issues a warning, that it has detected one or more
+% packages, that have their own bug tracker. In that case the report
+% should be made in the bug tracker of that package and not in the
+% \LaTeXe{}, even if it is a package that is mainted by us!
+%
+% Other people look these bug tracker to search for known problems and
+% thus it is best if yours is recorded in the right place. Such a
+% warning will look like this (we use \texttt{hyperref} as an
+% example):
+% \begin{verbatim}
+% Package latexbug Warning: Special bug tracker!
+% (latexbug)
+% (latexbug) This test file uses the following file(s)
+% (latexbug)
+% (latexbug) ==============
+% (latexbug) hyperref.sty -> Report at:
+% (latexbug) https://github.com/latex3/hyperref/issues
+% (latexbug) ==============
+% (latexbug)
+% (latexbug) Please note that these files have their own
+% (latexbug) bug tracker and your issue should therefore
+% (latexbug) be reported in the indicated repository.
+% (latexbug)
+% (latexbug) If they are not necessary to exhibit the problem,
+% (latexbug) remove them from your example and rerun it,
+% (latexbug) otherwise report the issue in the listed repository.
+% (latexbug)
+% (latexbug) If different repositories are listed, try to
+% (latexbug) select the most appropriate one (but don't worry
+% (latexbug) too much, if the choice is not clear to you).
+% \end{verbatim}
+%
+%
+%
+% \vspace*{1ex}
+%
% \begin{center}
% \fbox{\fbox{\parbox{.6\textwidth}{\itshape Thank you for taking
% the time to report a bug and prepare a test
@@ -231,7 +265,7 @@
% \begin{macrocode}
%<*package>
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{latexbug}[2021/06/28 v1.0k Bug-classification]
+\ProvidesPackage{latexbug}[2021/09/25 v1.0l Bug-classification]
% \end{macrocode}
%
% \begin{macro}{\latexbug at empty}
@@ -268,17 +302,26 @@
% mapping. The trailing space is important (stripping it is not really worth
% it for this very limited use case).
% \begin{macrocode}
-\long\def\latexbug at loop #1 = #2 , {% spaces matter
- \global\@namedef{latexbug@@#1}{#2}%
+\long\def\latexbug at loop #1 = #2 #3, {% spaces matter
+ \global\@namedef{latexbug@@#1}{{#2}{#3}}%
\ifx\latexbug at empty#1\else\expandafter\latexbug at loop\fi}
% \end{macrocode}
% \end{macro}
%
% A simple database of files. The value \texttt{us} means we accept
-% bugs for it. We also take bug reports for \texttt{us*} (expl3) entries, but
+% bugs for it. We also take bug reports for \texttt{us*}
+% (expl3 or other repositories we suport) entries, but
% they need to go to a different GitHub repository, so are handled separately
% (and only show up
-% if there doesn't seem to be anything else to pick up). A value of
+% if there are no third-party packages).
+% For the \texttt{latex3/latex3} repository just write \texttt{us*}, for others
+% one need to specify the full details, e.g.,
+%\begin{verbatim}
+% hyperref.sty = us*
+% \Contact https://github.com/latex3/hyperref/issues ,
+%\end{verbatim}
+%
+% A value of
% \texttt{ignore} means that its not our code, but we understand that it may
% show up in legitimate test files and should therefore not trigger an error.
%
@@ -290,7 +333,8 @@
%
% \begin{quote} \itshape
% The database format is somewhat fragile: one needs to have a space on both sides
-% of the equal sign (or one gets a nasty low-level error) and names can't have
+% of the equal sign and before the comma (or one gets a nasty low-level error),
+% and names can't have
% no-ascii characters in them, so they end up crippled (sorry for that).
% \end{quote}
%
@@ -764,8 +808,7 @@
xfp.sty = us* ,
%--------------------------------- l3kernel / expl3
expl3-code.tex = ignore ,
-expl3.ltx = us* ,
-expl3.ltx = us* ,
+expl3.ltx = ignore ,
expl3.lua = us* ,
expl3.sty = us* ,
l3backend-dvipdfmx.def = ignore ,
@@ -801,16 +844,39 @@
xgalley.sty = us* ,
xparse.sty = us* ,
xtemplate.sty = us* ,
-%--------------------------------- HYPERREF
+%--------------------------------- TAGGING PROJECT
+pdfmanagement-testphase.sty = us*
+ \Contact https://github.com/latex3/pdfresources/issues
+pdfmanagement-testphase.ltx = ignore ,
+%--------------------------------- EXTERNAL PACKAGES SUPPORTED BY THE LaTeX Team
hluatex.def = ignore ,
hpdftex.def = ignore ,
hxetex.def = ignore ,
hyperref.cfg = ignore ,
-hyperref.sty = LaTeX Team
+hyperref.sty = us*
\Contact https://github.com/latex3/hyperref/issues ,
hyperref-langpatches.def = ignore ,
pd1enc.def = ignore ,
puenc.def = ignore ,
+xcolor.sty = us*
+ \Contact https://github.com/latex3/xcolor/issues ,
+%--------------------------------- PACKAGES BY MEMBERS OF THE LaTeX Team
+beamer.cls = Joseph Wright
+ \Contact https://github.com/josephwright/beamer/issues ,
+dashundergaps.sty = Frank Mittelbach
+ \Contact https://github.com/FrankMittelbach/fmitex-dashundergaps/issues ,
+fewerfloatpages.sty = Frank Mittelbach
+ \Contact https://github.com/FrankMittelbach/fmitex-fewerfloatpages ,
+fontspec.sty = Will Robertson
+ \Contact https://github.com/wspr/fontspec/issues ,
+luatex85.sty = Joseph Wright
+ \Contact https://github.com/josephwright/luatex85/issues ,
+parskip.sty = Frank Mittelbach
+ \Contact https://github.com/FrankMittelbach/fmitex-parskip/issues ,
+siunitx.sty = Joseph Wright
+ \Contact https://github.com/josephwright/siunitx/issues ,
+widows-and-orphans.sty = Frank Mittelbach
+ \Contact https://github.com/FrankMittelbach/fmitex-widows-and-orphans/issues ,
%--------------------------------- USEFUL FOR BUG REPORTS
blindtext.sty = ignore ,
etoolbox.sty = ignore ,
@@ -819,20 +885,12 @@
lipsum.sty = ignore ,
%--------------------------------- EXTERNALLY SUPPORTED
%
-beamer.cls = Joseph Wright
- \Contact https://github.com/josephwright/beamer/issues ,
-fontspec.sty = Will Robertson
- \Contact https://github.com/wspr/fontspec/issues ,
geometry.sty = Hideo Umeki
\Contact <latexgeometry [at] gmail [dot] com> ,
-luatex85.sty = Joseph Wright
- \Contact https://github.com/josephwright/luatex85/issues ,
-siunitx.sty = Joseph Wright
- \Contact https://github.com/josephwright/siunitx/issues ,
%--------------------------------- babel external
basque.ldf = Juan M. Aguirregabiria
\Contact <http://tp.lc.ehu.es/jma.html> ,
-belarusian.ldf = Aleksey Novodvorsky, Andrew Shadura
+belarusian.ldf = Aleksey Novodvorsky and Andrew Shadura
\Contact <andrew [at] shadura [dot] me> ,
bosnian.ldf = Samir Halilcevic %% Halilčević
\Contact <samir [dot] halilcevic [at] fet [dot] ba> ,
@@ -915,11 +973,11 @@
% \end{macro}
%
% \begin{macro}{\latexbug at zzzz}
-% \begin{macro}{\latexbug at expl}
+% \begin{macro}{\latexbug at own}
% Storage for third-party files and those from the \LaTeX3 set on GitHub.
% \begin{macrocode}
\def\latexbug at zzzz{}
-\def\latexbug at expl{}
+\def\latexbug at own{}
% \end{macrocode}
% \end{macro}
% \end{macro}
@@ -928,7 +986,7 @@
% \begin{macro}{\process at table}
% A hook into a convenient place in the document set up: the
% initialization of NFSS during the \cs{document} macro. If either
-% \cs{latexbug at zzzz} or \cs{latexbug at expl} have any content then there is
+% \cs{latexbug at zzzz} or \cs{latexbug at own} have any content then there is
% a message to issue, it's just a question of deciding which one.
% \begin{macrocode}
\let\latexbug at process@table\process at table
@@ -935,26 +993,30 @@
\def\process at table{\global\let\@addtofilelist\latexbug at addtofilelist
\latexbug at process@table
\ifx\latexbug at zzzz\latexbug at empty
- \ifx\latexbug at expl\latexbug at empty
+ \ifx\latexbug at own\latexbug at empty
\else
- \PackageError{latexbug}%
- {LaTeX3 file(s)\MessageBreak
+ \typeout{}%
+ \PackageWarningNoLine{latexbug}%
+ {Special bug tracker!\MessageBreak
\MessageBreak
-This test files uses the LaTeX3 file(s)\MessageBreak
+This test file uses the following file(s)\MessageBreak
\MessageBreak
==============\MessageBreak
- \latexbug at expl
+ \latexbug at own
==============\MessageBreak
\MessageBreak
-You should report bugs in these packages\MessageBreak
-at the LaTeX3 GitHub site,\MessageBreak
-https://github.com/latex3/latex3/issues\MessageBreak
-(Or remove them from your example,\MessageBreak
-if they are not necessary to\MessageBreak
-exhibit the problem).\MessageBreak
-}{Please correct your test file prior
- to submitting the bug report.\MessageBreak
- Otherwise it is likely to be rejected!}%
+Please note that these files have their own\MessageBreak
+bug tracker and your issue should therefore\MessageBreak
+be reported in the indicated repository.\MessageBreak
+ \MessageBreak
+If they are not necessary to exhibit the problem,\MessageBreak
+remove them from your example and rerun it,\MessageBreak
+otherwise report the issue in the listed repository.\MessageBreak
+ \MessageBreak
+If different repositories are listed, try to\MessageBreak
+select the most appropriate one (but don't worry\MessageBreak
+too much, if the choice is not clear to you)}%
+ \typeout{}%
\fi
\else
\PackageError{latexbug}%
@@ -998,7 +1060,6 @@
% later.
% \begin{macrocode}
\def\@addtofilelist#1{%
-% \show\@currnamestack
\expandafter\latexbug at iftoplevel\@currnamestack {}\@nil
\begingroup
\xdef\latexbug at x{#1}% TODO: one-level sanitize
@@ -1006,14 +1067,30 @@
\ifx\csname latexbug@@\latexbug at x\endcsname\relax
\def\latexbug at y{}%
\else
- \xdef\latexbug at y{\csname latexbug@@\latexbug at x\endcsname}%
+% \end{macrocode}
+% \cs{latexbug at y} will contain either on of the keywords
+% \texttt{us} or \texttt{us*} or \texttt{ignore} or it will contain
+% the start part of the third-party information, \cs{latexbug at z}
+% contains the rest (if anything), the space between the two is
+% lost and needs to be reinserted.
+% \begin{macrocode}
+ \xdef\latexbug at y{\expandafter\expandafter\expandafter
+ \@firstoftwo\csname latexbug@@\latexbug at x\endcsname}%
+ \xdef\latexbug at z{\expandafter\expandafter\expandafter
+ \@secondoftwo\csname latexbug@@\latexbug at x\endcsname}%
\fi
\ifx\latexbug at y\latexbug at us\else
\ifx\latexbug at y\latexbug at usstar
\begingroup
\let\MessageBreak\relax
- \xdef\latexbug at expl{%
- \latexbug at expl\latexbug at x
+ \xdef\latexbug at own{%
+ \latexbug at own\latexbug at x
+ \space\space -> \space Report at:
+ \ifx\latexbug at z\@empty
+ \Contact https://github.com/latex3/latex3/issues
+ \else
+ \latexbug at z
+ \fi
\MessageBreak
}%
\endgroup
@@ -1022,7 +1099,9 @@
{\let\MessageBreak\relax
\xdef\latexbug at zzzz{\latexbug at zzzz\latexbug at x
\ifx\latexbug at y\latexbug at empty\else
- \space\space -> \space \latexbug at y\fi
+ \space\space -> \space \latexbug at y
+ \space \latexbug at z
+ \fi
\MessageBreak}}%
\fi
\fi
Modified: trunk/Master/texmf-dist/tex/latex/latexbug/latexbug.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/latexbug/latexbug.sty 2021-09-25 21:25:23 UTC (rev 60608)
+++ trunk/Master/texmf-dist/tex/latex/latexbug/latexbug.sty 2021-09-25 21:25:48 UTC (rev 60609)
@@ -30,7 +30,7 @@
%% version 2005/12/01 or later.
%%
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{latexbug}[2021/06/28 v1.0k Bug-classification]
+\ProvidesPackage{latexbug}[2021/09/25 v1.0l Bug-classification]
\def\latexbug at empty{}
\def\latexbug at us{us}
\def\latexbug at usstar{us*}
@@ -37,8 +37,8 @@
\def\latexbug at ignore{ignore}
\def\Contact{\MessageBreak \@spaces}
\begingroup
-\long\def\latexbug at loop #1 = #2 , {% spaces matter
- \global\@namedef{latexbug@@#1}{#2}%
+\long\def\latexbug at loop #1 = #2 #3, {% spaces matter
+ \global\@namedef{latexbug@@#1}{{#2}{#3}}%
\ifx\latexbug at empty#1\else\expandafter\latexbug at loop\fi}
\latexbug at loop
latexbug.sty = us ,
@@ -495,8 +495,7 @@
xparse.ltx = us* ,
xfp.sty = us* ,
expl3-code.tex = ignore ,
-expl3.ltx = us* ,
-expl3.ltx = us* ,
+expl3.ltx = ignore ,
expl3.lua = us* ,
expl3.sty = us* ,
l3backend-dvipdfmx.def = ignore ,
@@ -532,33 +531,46 @@
xgalley.sty = us* ,
xparse.sty = us* ,
xtemplate.sty = us* ,
+pdfmanagement-testphase.sty = us*
+ \Contact https://github.com/latex3/pdfresources/issues
+pdfmanagement-testphase.ltx = ignore ,
hluatex.def = ignore ,
hpdftex.def = ignore ,
hxetex.def = ignore ,
hyperref.cfg = ignore ,
-hyperref.sty = LaTeX Team
+hyperref.sty = us*
\Contact https://github.com/latex3/hyperref/issues ,
hyperref-langpatches.def = ignore ,
pd1enc.def = ignore ,
puenc.def = ignore ,
-blindtext.sty = ignore ,
-etoolbox.sty = ignore ,
-kantlipsum.sty = ignore ,
-lipsum.ltd = ignore ,
-lipsum.sty = ignore ,
+xcolor.sty = us*
+ \Contact https://github.com/latex3/xcolor/issues ,
beamer.cls = Joseph Wright
\Contact https://github.com/josephwright/beamer/issues ,
+dashundergaps.sty = Frank Mittelbach
+ \Contact https://github.com/FrankMittelbach/fmitex-dashundergaps/issues ,
+fewerfloatpages.sty = Frank Mittelbach
+ \Contact https://github.com/FrankMittelbach/fmitex-fewerfloatpages ,
fontspec.sty = Will Robertson
\Contact https://github.com/wspr/fontspec/issues ,
-geometry.sty = Hideo Umeki
- \Contact <latexgeometry [at] gmail [dot] com> ,
luatex85.sty = Joseph Wright
\Contact https://github.com/josephwright/luatex85/issues ,
+parskip.sty = Frank Mittelbach
+ \Contact https://github.com/FrankMittelbach/fmitex-parskip/issues ,
siunitx.sty = Joseph Wright
\Contact https://github.com/josephwright/siunitx/issues ,
+widows-and-orphans.sty = Frank Mittelbach
+ \Contact https://github.com/FrankMittelbach/fmitex-widows-and-orphans/issues ,
+blindtext.sty = ignore ,
+etoolbox.sty = ignore ,
+kantlipsum.sty = ignore ,
+lipsum.ltd = ignore ,
+lipsum.sty = ignore ,
+geometry.sty = Hideo Umeki
+ \Contact <latexgeometry [at] gmail [dot] com> ,
basque.ldf = Juan M. Aguirregabiria
\Contact <http://tp.lc.ehu.es/jma.html> ,
-belarusian.ldf = Aleksey Novodvorsky, Andrew Shadura
+belarusian.ldf = Aleksey Novodvorsky and Andrew Shadura
\Contact <andrew [at] shadura [dot] me> ,
bosnian.ldf = Samir Halilcevic %% Halilčević
\Contact <samir [dot] halilcevic [at] fet [dot] ba> ,
@@ -628,31 +640,35 @@
\endgroup
\let\latexbug at addtofilelist\@addtofilelist
\def\latexbug at zzzz{}
-\def\latexbug at expl{}
+\def\latexbug at own{}
\let\latexbug at process@table\process at table
\def\process at table{\global\let\@addtofilelist\latexbug at addtofilelist
\latexbug at process@table
\ifx\latexbug at zzzz\latexbug at empty
- \ifx\latexbug at expl\latexbug at empty
+ \ifx\latexbug at own\latexbug at empty
\else
- \PackageError{latexbug}%
- {LaTeX3 file(s)\MessageBreak
+ \typeout{}%
+ \PackageWarningNoLine{latexbug}%
+ {Special bug tracker!\MessageBreak
\MessageBreak
-This test files uses the LaTeX3 file(s)\MessageBreak
+This test file uses the following file(s)\MessageBreak
\MessageBreak
==============\MessageBreak
- \latexbug at expl
+ \latexbug at own
==============\MessageBreak
\MessageBreak
-You should report bugs in these packages\MessageBreak
-at the LaTeX3 GitHub site,\MessageBreak
-https://github.com/latex3/latex3/issues\MessageBreak
-(Or remove them from your example,\MessageBreak
-if they are not necessary to\MessageBreak
-exhibit the problem).\MessageBreak
-}{Please correct your test file prior
- to submitting the bug report.\MessageBreak
- Otherwise it is likely to be rejected!}%
+Please note that these files have their own\MessageBreak
+bug tracker and your issue should therefore\MessageBreak
+be reported in the indicated repository.\MessageBreak
+ \MessageBreak
+If they are not necessary to exhibit the problem,\MessageBreak
+remove them from your example and rerun it,\MessageBreak
+otherwise report the issue in the listed repository.\MessageBreak
+ \MessageBreak
+If different repositories are listed, try to\MessageBreak
+select the most appropriate one (but don't worry\MessageBreak
+too much, if the choice is not clear to you)}%
+ \typeout{}%
\fi
\else
\PackageError{latexbug}%
@@ -689,14 +705,23 @@
\ifx\csname latexbug@@\latexbug at x\endcsname\relax
\def\latexbug at y{}%
\else
- \xdef\latexbug at y{\csname latexbug@@\latexbug at x\endcsname}%
+ \xdef\latexbug at y{\expandafter\expandafter\expandafter
+ \@firstoftwo\csname latexbug@@\latexbug at x\endcsname}%
+ \xdef\latexbug at z{\expandafter\expandafter\expandafter
+ \@secondoftwo\csname latexbug@@\latexbug at x\endcsname}%
\fi
\ifx\latexbug at y\latexbug at us\else
\ifx\latexbug at y\latexbug at usstar
\begingroup
\let\MessageBreak\relax
- \xdef\latexbug at expl{%
- \latexbug at expl\latexbug at x
+ \xdef\latexbug at own{%
+ \latexbug at own\latexbug at x
+ \space\space -> \space Report at:
+ \ifx\latexbug at z\@empty
+ \Contact https://github.com/latex3/latex3/issues
+ \else
+ \latexbug at z
+ \fi
\MessageBreak
}%
\endgroup
@@ -705,7 +730,9 @@
{\let\MessageBreak\relax
\xdef\latexbug at zzzz{\latexbug at zzzz\latexbug at x
\ifx\latexbug at y\latexbug at empty\else
- \space\space -> \space \latexbug at y\fi
+ \space\space -> \space \latexbug at y
+ \space \latexbug at z
+ \fi
\MessageBreak}}%
\fi
\fi
More information about the tex-live-commits
mailing list.