[PATCH -perfbook] docker: bionic: Rollback glossaries-extra manually

[PATCH -perfbook] docker: bionic: Rollback glossaries-extra manually

[Akira Yokosawa]

Since October 2022, glossaries-extra uses a modern LaTeX feature
for backward compatibility, which was added in TeX Live 2018.
Unfortunately, TeX Live of Bionic is based on TeX Live 2017, hence
the glossaries-extra package at CTAN does not work out of the box.

Add commands for manual rollback in Dockerfile.bionic.

Update FAQ-BUILD.txt as well.

Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
---
Hi,

I think it is quite unlikely a new reader/contributor of
perfbook uses Ubuntu Bionic, but anyway.
When Bionic is EOL'ed next spring, we can forget about it. ;-)

        Thanks, Akira
--
 FAQ-BUILD.txt            |  8 ++++++++
 docker/Dockerfile.bionic | 15 +++++++++++++++
 2 files changed, 23 insertions(+)

diff --git a/FAQ-BUILD.txt b/FAQ-BUILD.txt
index eea4fa37737b..107707533398 100644
--- a/FAQ-BUILD.txt
+++ b/FAQ-BUILD.txt
@@ -196,6 +196,14 @@
 	    2.	Install it by following instructions at:
 		https://help.ubuntu.com/community/LaTeX#Installing_packages_manually
 
+	    3.  Since October 2022, glossaries-extra uses a modern LaTeX
+		feature for backward compatibility, which was added in
+		TeX Live 2018. Unfortunately, TeX Live of Bionic is based
+		on TeX Live 2017, hence the glossaries-extra package at
+		CTAN does not work out of the box.
+		Still, you can manually rollback it to an older version.
+		See docker/Dockerfile.bionic for how to do it.
+
 	B.	Instead of above manual steps, you could install the package
 		using a script in this repository,
 		'./utilities/install_latex_package.sh'.  For example:
diff --git a/docker/Dockerfile.bionic b/docker/Dockerfile.bionic
index 207feca7d768..e1c4c3a9696b 100644
--- a/docker/Dockerfile.bionic
+++ b/docker/Dockerfile.bionic
@@ -28,6 +28,21 @@ RUN curl https://mirrors.ctan.org/macros/latex/contrib/cleveref.zip -L -O && unz
     texhash /usr/local/share/texmf && \
     curl https://mirrors.ctan.org/graphics/a2ping.zip -L -O && unzip a2ping.zip && \
     cp a2ping/a2ping.pl /usr/local/bin/a2ping
+# Rollback glossaries-extra for pre-2018 TeX Live
+RUN cd /usr/local/share/texmf/tex/latex/glossaries-extra/ \
+ && mv glossaries-extra.sty glossaries-extra-latest.sty \
+ && mv glossaries-extra-bib2gls.sty glossaries-extra-bib2gls-latest.sty \
+ && mv glossaries-extra-stylemods.sty glossaries-extra-stylemods-latest.sty \
+ && mv glossary-bookindex.sty glossary-bookindex-latest.sty \
+ && mv glossary-longextra.sty glossary-longextra-latest.sty \
+ && mv glossary-topic.sty glossary-topic-latest.sty \
+ && ln -s glossaries-extra-2021-11-22.sty glossaries-extra.sty \
+ && ln -s glossaries-extra-bib2gls-2021-11-22.sty glossaries-extra-bib2gls.sty \
+ && ln -s glossaries-extra-stylemods-2021-11-22.sty glossaries-extra-stylemods.sty \
+ && ln -s glossary-bookindex-2021-11-22.sty glossary-bookindex.sty \
+ && ln -s glossary-longextra-2021-11-22.sty glossary-longextra.sty \
+ && ln -s glossary-topic-2021-11-22.sty glossary-topic.sty \
+ && texhash /usr/local/share/texmf
 ARG uid=1000
 ARG gid=1000
 ARG user=perfbook

base-commit: d5e69a022d636fb3e204c1ef90a3c668cbf0e8bc
-- 
2.25.1

Re: [PATCH -perfbook] docker: bionic: Rollback glossaries-extra manually

[Paul E. McKenney]

On Sun, Dec 25, 2022 at 09:46:39AM +0900, Akira Yokosawa wrote:
> Since October 2022, glossaries-extra uses a modern LaTeX feature
> for backward compatibility, which was added in TeX Live 2018.
> Unfortunately, TeX Live of Bionic is based on TeX Live 2017, hence
> the glossaries-extra package at CTAN does not work out of the box.
> 
> Add commands for manual rollback in Dockerfile.bionic.
> 
> Update FAQ-BUILD.txt as well.
> 
> Signed-off-by: Akira Yokosawa <akiyks@gmail.com>

Queued and pushed, thank you!

							Thanx, Paul

> ---
> Hi,
> 
> I think it is quite unlikely a new reader/contributor of
> perfbook uses Ubuntu Bionic, but anyway.
> When Bionic is EOL'ed next spring, we can forget about it. ;-)
> 
>         Thanks, Akira
> --
>  FAQ-BUILD.txt            |  8 ++++++++
>  docker/Dockerfile.bionic | 15 +++++++++++++++
>  2 files changed, 23 insertions(+)
> 
> diff --git a/FAQ-BUILD.txt b/FAQ-BUILD.txt
> index eea4fa37737b..107707533398 100644
> --- a/FAQ-BUILD.txt
> +++ b/FAQ-BUILD.txt
> @@ -196,6 +196,14 @@
>  	    2.	Install it by following instructions at:
>  		https://help.ubuntu.com/community/LaTeX#Installing_packages_manually
>  
> +	    3.  Since October 2022, glossaries-extra uses a modern LaTeX
> +		feature for backward compatibility, which was added in
> +		TeX Live 2018. Unfortunately, TeX Live of Bionic is based
> +		on TeX Live 2017, hence the glossaries-extra package at
> +		CTAN does not work out of the box.
> +		Still, you can manually rollback it to an older version.
> +		See docker/Dockerfile.bionic for how to do it.
> +
>  	B.	Instead of above manual steps, you could install the package
>  		using a script in this repository,
>  		'./utilities/install_latex_package.sh'.  For example:
> diff --git a/docker/Dockerfile.bionic b/docker/Dockerfile.bionic
> index 207feca7d768..e1c4c3a9696b 100644
> --- a/docker/Dockerfile.bionic
> +++ b/docker/Dockerfile.bionic
> @@ -28,6 +28,21 @@ RUN curl https://mirrors.ctan.org/macros/latex/contrib/cleveref.zip -L -O && unz
>      texhash /usr/local/share/texmf && \
>      curl https://mirrors.ctan.org/graphics/a2ping.zip -L -O && unzip a2ping.zip && \
>      cp a2ping/a2ping.pl /usr/local/bin/a2ping
> +# Rollback glossaries-extra for pre-2018 TeX Live
> +RUN cd /usr/local/share/texmf/tex/latex/glossaries-extra/ \
> + && mv glossaries-extra.sty glossaries-extra-latest.sty \
> + && mv glossaries-extra-bib2gls.sty glossaries-extra-bib2gls-latest.sty \
> + && mv glossaries-extra-stylemods.sty glossaries-extra-stylemods-latest.sty \
> + && mv glossary-bookindex.sty glossary-bookindex-latest.sty \
> + && mv glossary-longextra.sty glossary-longextra-latest.sty \
> + && mv glossary-topic.sty glossary-topic-latest.sty \
> + && ln -s glossaries-extra-2021-11-22.sty glossaries-extra.sty \
> + && ln -s glossaries-extra-bib2gls-2021-11-22.sty glossaries-extra-bib2gls.sty \
> + && ln -s glossaries-extra-stylemods-2021-11-22.sty glossaries-extra-stylemods.sty \
> + && ln -s glossary-bookindex-2021-11-22.sty glossary-bookindex.sty \
> + && ln -s glossary-longextra-2021-11-22.sty glossary-longextra.sty \
> + && ln -s glossary-topic-2021-11-22.sty glossary-topic.sty \
> + && texhash /usr/local/share/texmf
>  ARG uid=1000
>  ARG gid=1000
>  ARG user=perfbook
> 
> base-commit: d5e69a022d636fb3e204c1ef90a3c668cbf0e8bc
> -- 
> 2.25.1
>