Skip to contentSkip to conversation

Work around backward incompatible changes in LaTeX2e 2024-06-01

PATCH Applied Akira Yokosawa 2 participants 10 messages Jun 11, 2024 – Jun 14, 2024

lore
Share & tools
lore
#0 lore raw

v2 cover Work around backward incompatible changes in LaTeX2e 2024-06-01

Hi Paul,

As I mentioned earlier [1], recent updates in core LaTeX and accompanying changes in the array package broke build of perfbook.

There are two modes of incompatibilities.

1. arydshln assumes array's internal implementation of a past version of array, which is no longer true with array >=v2.6.

2. A "LaTeX Warning:" message in loading parnotes.sty.

Neither arydshln nor parnotes is actively maintained, so here are workarounds made in perfbook-lt.tex.

Patch 1/3 adds a rollback option to array and sticks with array v2.5 or earlier.

Patch 2/3 enables a silence filter for the particular warning.

Patch 3/3 is a follow up change to use date as rollback options of glossaries related packages. By saying [=2022-10-01] rather than [=v2.07], [=v4.49], etc., it becomes obvious when those packages worked well with our custom code for glossaries & indexing.

[1]: https://lore.kernel.org/r/[email protected]/

Akira Yokosawa (3):
Work around conflict between arydshln and array v2.6 Silence warning msg from LaTeX while loading parnotes package Use date as rollback options for glossaries related packages

 perfbook-lt.tex | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

base-commit: ef80c4a3ecb96f115b27f1d60bcf7448074ea2e7

Signature · 1 line
2.34.1
#1 lore raw

PATCH v2 1/3 Work around conflict between arydshln and array v2.6

Version 2.6 of array.sty released along with LaTeX2e <2024-06-01> is not compatible with arydshln's assumption of internal behavior of array.

Stick to a compatible version of array by adding \RequirePackage{array} with a rollback option.

Use of date as in [=2024-05-01] makes the LaTeX code compatible with earlier installation of TeX Live, where the latex engine can pick a suitable version available.

---
I have tried to contact arydshln package maintainer, but failed to get any response so far.

---
 perfbook-lt.tex | 3 +++
 1 file changed, 3 insertions(+)
perfbook-lt.tex +3 -0
index fd598a56..ad4463be 100644
@@ -9,6 +9,9 @@
 % within a page. See: https://tex.stackexchange.com/questions/183149/
 \ifdefined\pdfsuppresswarningpagegroup \pdfsuppresswarningpagegroup=1 \fi
 
+% Work around conflict between arydshln and array since array v2.6c
+\RequirePackage{array}[=2024-05-01] % One month before the release date of v2.6c
+
 % standard packages
 
 % A more pleasant font
Signature · 1 line
2.34.1
#2 lore raw

PATCH v2 2/3 Silence warning msg from LaTeX while loading parnotes package

In reply to Akira Yokosawa

LaTeX2e <2024-06-01> emits warning on loading parnotes.sty saying:

LaTeX Warning: Command `\theparnotemark' already defined -- not changed on input line 54.

This looks like a harmless warning.
As perfbook's build scripts treat "LaTeX Warning" as build error, silence it by enabling a filter for this particular message.

---
Unfortunately, parnotes doesn't have any maintainer assigned and it is not clear if the issue can be taken care of soon.

---
 perfbook-lt.tex | 3 +++
 1 file changed, 3 insertions(+)
perfbook-lt.tex +3 -0
index ad4463be..3c6fb9f3 100644
@@ -79,6 +79,9 @@
 \usepackage[split,makeindex]{splitidx}
 \usepackage[nottoc]{tocbibind}
 \usepackage[columns=3,totoc,indentunit=12pt,justific=raggedright,font=small,columnsep=.15in]{idxlayout}
+\RequirePackage[save]{silence}
+\WarningFilter[parnotes]{latex}{Command `\theparnotemark' already defined}
+\ActivateWarningFilters[parnotes]
 \usepackage{parnotes} % for footnotes in tabularx
 \usepackage[bookmarks=true,bookmarksnumbered=true,pdfborder={0 0 0},linktoc=all,pdfusetitle]{hyperref}
 \usepackage{footnotebackref} % to enable cross-ref of footnote
Signature · 1 line
2.34.1
#3 lore raw

PATCH v2 3/3 Use date as rollback options for glossaries related packages

In reply to Akira Yokosawa

While discussing about rollback of the array package, array's maintainer recommended using date as rollback options.

Apply the same approach for rollback of glossaries related packages. This way, it would be obvious that those packages as of early October 2022 worked fine.

---
 perfbook-lt.tex | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)
perfbook-lt.tex +5 -6
index 3c6fb9f3..20394851 100644
@@ -86,12 +86,11 @@
 \usepackage[bookmarks=true,bookmarksnumbered=true,pdfborder={0 0 0},linktoc=all,pdfusetitle]{hyperref}
 \usepackage{footnotebackref} % to enable cross-ref of footnote
 \usepackage[all]{hypcap} % for going to the top of figure and table
-\usepackage{mfirstuc}[=v2.07] % v2.08 or later is not compatible with our
-                              % indexing macros
-% rollback glossaries related packages as well
-\usepackage[toc,nopostdot,acronym]{glossaries}[=v4.49]
-\usepackage{glossaries-extra}[=v1.48]
-\usepackage[longragged]{glossaries-extra-stylemods}[=v1.48]
+% rollback glossaries related packages to versions as of 2022-10-01 or earlier.
+\usepackage{mfirstuc}[=2022-10-01]
+\usepackage[toc,nopostdot,acronym]{glossaries}[=2022-10-01]
+\usepackage{glossaries-extra}[=2022-10-01]
+\usepackage[longragged]{glossaries-extra-stylemods}[=2022-10-01]
 
 \usepackage{epigraph}[2020/01/02] % latest version prevents orphaned epigraph
 \setlength{\epigraphwidth}{2.6in}
Signature · 1 line
2.34.1
#4 lore raw
In reply to Akira Yokosawa
Quoted 18 lines · Akira Yokosawa

Hi Paul,

As I mentioned earlier [1], recent updates in core LaTeX and accompanying changes in the array package broke build of perfbook.

There are two modes of incompatibilities.

1. arydshln assumes array's internal implementation of a past version of array, which is no longer true with array >=v2.6.

2. A "LaTeX Warning:" message in loading parnotes.sty.

Neither arydshln nor parnotes is actively maintained, so here are workarounds made in perfbook-lt.tex.

Patch 1/3 adds a rollback option to array and sticks with array v2.5 or earlier.

Quoted 8 lines

Patch 2/3 enables a silence filter for the particular warning.

Patch 3/3 is a follow up change to use date as rollback options of glossaries related packages. By saying [=2022-10-01] rather than [=v2.07], [=v4.49], etc., it becomes obvious when those packages worked well with our custom code for glossaries & indexing.

[1]: https://lore.kernel.org/r/[email protected]/

Queued, thank you!

I have to ask... Longer term, are we going to need to be thinking in terms of avoiding use of these two packages? (I have no idea whether that even makes any sense, but again, I have to ask.)

Thanx, Paul

Quoted 13 lines

Akira Yokosawa (3):
Work around conflict between arydshln and array v2.6 Silence warning msg from LaTeX while loading parnotes package Use date as rollback options for glossaries related packages

 perfbook-lt.tex | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

base-commit: ef80c4a3ecb96f115b27f1d60bcf7448074ea2e7

Signature · 1 line
2.34.1
#5 lore raw
Quoted 26 lines · Paul E. McKenney
Quoted 25 lines · Akira Yokosawa

Hi Paul,

As I mentioned earlier [1], recent updates in core LaTeX and accompanying changes in the array package broke build of perfbook.

There are two modes of incompatibilities.

1. arydshln assumes array's internal implementation of a past version of array, which is no longer true with array >=v2.6.

2. A "LaTeX Warning:" message in loading parnotes.sty.

Neither arydshln nor parnotes is actively maintained, so here are workarounds made in perfbook-lt.tex.

Patch 1/3 adds a rollback option to array and sticks with array v2.5 or earlier.

Patch 2/3 enables a silence filter for the particular warning.

Patch 3/3 is a follow up change to use date as rollback options of glossaries related packages. By saying [=2022-10-01] rather than [=v2.07], [=v4.49], etc., it becomes obvious when those packages worked well with our custom code for glossaries & indexing.

Quoted 7 lines
Quoted 1 line

[1]: https://lore.kernel.org/r/[email protected]/

Queued, thank you!

I have to ask... Longer term, are we going to need to be thinking in terms of avoiding use of these two packages? (I have no idea whether that even makes any sense, but again, I have to ask.)

Well, I have faint hope that Frank Mittelbach, the author of TLC3 (The LaTeX Companion, 3rd edition) and the maintainer of array (among others), might want to update those packages, as the book uses arydshln and parnotes in a couple of examples.

Just hoping. ;-)

Thanks, Akira

Quoted 2 lines

Thanx, Paul

#6 lore raw
Quoted 35 lines · Akira Yokosawa
Quoted 26 lines · Paul E. McKenney
Quoted 25 lines · Akira Yokosawa

Hi Paul,

As I mentioned earlier [1], recent updates in core LaTeX and accompanying changes in the array package broke build of perfbook.

There are two modes of incompatibilities.

1. arydshln assumes array's internal implementation of a past version of array, which is no longer true with array >=v2.6.

2. A "LaTeX Warning:" message in loading parnotes.sty.

Neither arydshln nor parnotes is actively maintained, so here are workarounds made in perfbook-lt.tex.

Patch 1/3 adds a rollback option to array and sticks with array v2.5 or earlier.

Patch 2/3 enables a silence filter for the particular warning.

Patch 3/3 is a follow up change to use date as rollback options of glossaries related packages. By saying [=2022-10-01] rather than [=v2.07], [=v4.49], etc., it becomes obvious when those packages worked well with our custom code for glossaries & indexing.

Quoted 7 lines
Quoted 1 line

[1]: https://lore.kernel.org/r/[email protected]/

Queued, thank you!

I have to ask... Longer term, are we going to need to be thinking in terms of avoiding use of these two packages? (I have no idea whether that even makes any sense, but again, I have to ask.)

Quoted 6 lines

Well, I have faint hope that Frank Mittelbach, the author of TLC3 (The LaTeX Companion, 3rd edition) and the maintainer of array (among others), might want to update those packages, as the book uses arydshln and parnotes in a couple of examples.

Just hoping. ;-)

Me too! ;-)

Thanx, Paul

#7 lore raw
Quoted 36 lines · Paul E. McKenney
Quoted 35 lines · Akira Yokosawa
Quoted 33 lines · Paul E. McKenney
Quoted 18 lines · Akira Yokosawa

Hi Paul,

As I mentioned earlier [1], recent updates in core LaTeX and accompanying changes in the array package broke build of perfbook.

There are two modes of incompatibilities.

1. arydshln assumes array's internal implementation of a past version of array, which is no longer true with array >=v2.6.

2. A "LaTeX Warning:" message in loading parnotes.sty.

Neither arydshln nor parnotes is actively maintained, so here are workarounds made in perfbook-lt.tex.

Patch 1/3 adds a rollback option to array and sticks with array v2.5 or earlier.

Quoted 8 lines

Patch 2/3 enables a silence filter for the particular warning.

Patch 3/3 is a follow up change to use date as rollback options of glossaries related packages. By saying [=2022-10-01] rather than [=v2.07], [=v4.49], etc., it becomes obvious when those packages worked well with our custom code for glossaries & indexing.

[1]: https://lore.kernel.org/r/[email protected]/

Queued, thank you!

I have to ask... Longer term, are we going to need to be thinking in terms of avoiding use of these two packages? (I have no idea whether that even makes any sense, but again, I have to ask.)

Quoted 8 lines
Quoted 6 lines

Well, I have faint hope that Frank Mittelbach, the author of TLC3 (The LaTeX Companion, 3rd edition) and the maintainer of array (among others), might want to update those packages, as the book uses arydshln and parnotes in a couple of examples.

Just hoping. ;-)

Me too! ;-)

Good news.

I've got parnotes v3c in today's update of vanilla TeX Live 2024. It fixes that "harmless" warning. Frank is kind enough and takes care of parnotes as a temporary caretaker [1].

Can you please drop 2/3 unless it is too late?

[1]: https://mirrors.ctan.org/macros/latex/contrib/parnotes/README.md

Thanks, Akira

Quoted 2 lines

Thanx, Paul

#8 lore raw
Quoted 44 lines · Akira Yokosawa
Quoted 43 lines · Paul E. McKenney
Quoted 41 lines · Akira Yokosawa
Quoted 26 lines · Paul E. McKenney
Quoted 25 lines · Akira Yokosawa

Hi Paul,

As I mentioned earlier [1], recent updates in core LaTeX and accompanying changes in the array package broke build of perfbook.

There are two modes of incompatibilities.

1. arydshln assumes array's internal implementation of a past version of array, which is no longer true with array >=v2.6.

2. A "LaTeX Warning:" message in loading parnotes.sty.

Neither arydshln nor parnotes is actively maintained, so here are workarounds made in perfbook-lt.tex.

Patch 1/3 adds a rollback option to array and sticks with array v2.5 or earlier.

Patch 2/3 enables a silence filter for the particular warning.

Patch 3/3 is a follow up change to use date as rollback options of glossaries related packages. By saying [=2022-10-01] rather than [=v2.07], [=v4.49], etc., it becomes obvious when those packages worked well with our custom code for glossaries & indexing.

Quoted 7 lines
Quoted 1 line

[1]: https://lore.kernel.org/r/[email protected]/

Queued, thank you!

I have to ask... Longer term, are we going to need to be thinking in terms of avoiding use of these two packages? (I have no idea whether that even makes any sense, but again, I have to ask.)

Well, I have faint hope that Frank Mittelbach, the author of TLC3 (The LaTeX Companion, 3rd edition) and the maintainer of array (among others), might want to update those packages, as the book uses arydshln and parnotes in a couple of examples.

Just hoping. ;-)

Quoted 7 lines
Quoted 1 line

Me too! ;-)

Good news.

I've got parnotes v3c in today's update of vanilla TeX Live 2024. It fixes that "harmless" warning. Frank is kind enough and takes care of parnotes as a temporary caretaker [1].

Very good, thank you!

Quoted 3 lines

Can you please drop 2/3 unless it is too late?

[1]: https://mirrors.ctan.org/macros/latex/contrib/parnotes/README.md

Given that I forgot to push your series out, no problem at all!

Please let me know if what is pushed now is what you expected.

Thanx, Paul

#9 lore raw
Quoted 1 line · Paul E. McKenney

On Fri, Jun 14, 2024 at 11:12:27AM +0900, Akira Yokosawa wrote:

[...]

Quoted 9 lines
Quoted 6 lines

Good news.

I've got parnotes v3c in today's update of vanilla TeX Live 2024. It fixes that "harmless" warning. Frank is kind enough and takes care of parnotes as a temporary caretaker [1].

Very good, thank you!

Quoted 7 lines
Quoted 3 lines

Can you please drop 2/3 unless it is too late?

[1]: https://mirrors.ctan.org/macros/latex/contrib/parnotes/README.md

Given that I forgot to push your series out, no problem at all!

Please let me know if what is pushed now is what you expected.

LGTM!

Thanks, Akira

Quoted 2 lines

Thanx, Paul