Re: [PATCH v2 -perfbook] Advance TeX Live requirement to 2019/Debian

On Thu, Jun 29, 2023 at 10:47:34PM +0900, Akira Yokosawa wrote:
> As is mentioned in FAQ-BUILD.txt, TeX Live 2017/Debian under
> Ubuntu bionic needs manual upgrades of cleveref, epigraph, and
> glossaries-extra.
> Furthermore, glossaries-extra needs manual rollback to v1.48.
> 
> LaTeX packages at CTAN tend to provide good backward compatibility
> with older TeX Live releases, but that is not a given.
> 
> Furthermore, the manual rollback of glossaries-extra done in
> Dockerfile.bionic might fail once a future release changes its
> internal structure.
> 
> As Ubuntu bionic went into its expanded security maintenance phase,
> let's advance the minimal requirement of TeX Live to 2019/Debian
> (Ubuntu focal).
> 
> Remove Dockerfile.bionic and related notes in FAQ-BUILD.txt.
> 
> Signed-off-by: Akira Yokosawa <[email protected]>

Makes sense to me, especially given that people can now get up-to-date
PDFs from Leonardo's CI.  Queued and pushed, thank you!

							Thanx, Paul

> ---
> v2: Amend summary and changelog.
> --
>  FAQ-BUILD.txt            | 43 +++++++-----------------------
>  docker/Dockerfile.bionic | 57 ----------------------------------------
>  2 files changed, 9 insertions(+), 91 deletions(-)
>  delete mode 100644 docker/Dockerfile.bionic
> 
> diff --git a/FAQ-BUILD.txt b/FAQ-BUILD.txt
> index 5867acd9d4d3..e9719a606786 100644
> --- a/FAQ-BUILD.txt
> +++ b/FAQ-BUILD.txt
> @@ -40,20 +40,12 @@
>  		Alternatively, you can use the container image described
>  		in #13 below.  Otherwise, instructions follow.
>  
> -		On Ubuntu Bionic and later, the following list should cover
> +		On Ubuntu Focal and later, the following list should cover
>  		necessary packages (except for -doc packages):
>  			texlive-publishers texlive-pstricks
>  			texlive-science texlive-fonts-extra
>  			xfig inkscape graphviz
>  
> -		Ubuntu Bionic has a buggy/incompatible version of LaTeX
> -		packages "cleveref" and "glossaries-extra".
> -		See #10 below to install the latest one.
> -
> -		On Ubuntu Bionic, you also need to fetch a version of
> -		a2ping which is compatible with updated Ghostscript.
> -		See #7 below.
> -
>  		On Fedora, installing the following set of packages
>  		suffices:
>  			texlive-collection-plaingeneric
> @@ -122,16 +114,12 @@
>  	"nimbus15", "newtxtt", etc.; or an old version of font package
>  	"newtx".  How can I install or update them?
>  
> -	A-1.	First of all, building perfbook requires TeX Live 2017/Debian
> -		(Ubuntu Bionic) or later. If you are told you don't have
> -		"glossaries-extra" package, you need to upgrade your TeX
> -		installation.
> -		For other optional font packages, upgrading TeX Live
> -		to 2017/Debian (Ubuntu Bionic) or later should suffice.
> +	A-1.	First of all, building perfbook requires TeX Live 2019/Debian
> +		(Ubuntu Focal) or later.
>  
> -		Upgrading your Linux distribution (e.g. to Ubuntu Focal)
> -		is one way to upgrade TeX Live (to 2019/Debian on Focal),
> -		and might have many other benefits as well.
> +		Upgrading your Linux distribution (e.g. to Ubuntu Jammy)
> +		is one way to upgrade TeX Live and might have many other
> +		benefits as well.
>  
>  		However, on modern TeX Live, installing -fonts-extra consumes
>  		more than 1GB of your disk space. If you prefer to manually
> @@ -209,32 +197,19 @@
>  		  - dejavu-fonts-all
>  		  - liberation-fonts
>  
> -10.	Building perfbook fails with a warning of buggy cleveref or
> -	version mismatch of epigraph.
> +10.	Building perfbook fails with a warning of version mismatch of epigraph.
>  	What can I do?
>  
> -	A.	They are known issues on Ubuntu Bionic (cleveref,
> -		glossaries-extra), and TeX Live releases prior to 2020
> -		(epigraph).
> +	A.	It is a known issue of TeX Live releases prior to 2020.
>  		This answer assumes Ubuntu, but it should work on other
>  		distros.
>  
> -	    1.	Download whichever package from CTAN mirror:
> -		http://mirrors.ctan.org/macros/latex/contrib/cleveref.zip
> +	    1.	Download package archive from CTAN mirror:
>  		http://mirrors.ctan.org/macros/latex/contrib/epigraph.zip
> -		http://mirrors.ctan.org/macros/latex/contrib/glossaries-extra.zip
>  
>  	    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
> deleted file mode 100644
> index e1c4c3a9696b..000000000000
> --- a/docker/Dockerfile.bionic
> +++ /dev/null
> @@ -1,57 +0,0 @@
> -FROM ubuntu:bionic
> -
> -RUN apt-get update && apt-get install -y locales && \
> -    localedef -i en_US -c -f UTF-8 -A /usr/share/locale/locale.alias en_US.UTF-8 && \
> -    rm -rf /var/lib/apt/lists/*
> -ENV LANG en_US.utf8
> -RUN apt-get update && DEBIAN_FRONTEND=noninteractive TZ=UTC apt-get install -y tzdata && \
> -    rm -rf /var/lib/apt/lists/*
> -RUN apt-get update && apt-get install -y fig2ps inkscape xfig graphviz psutils \
> -    texlive-publishers texlive-pstricks texlive-science texlive-fonts-extra \
> -    make nano vim git curl gnuplot-nox time && \
> -    rm -rf /var/lib/apt/lists/*
> -COPY steel-city-comic.regular.ttf /usr/local/share/fonts/
> -RUN fc-cache /usr/local/share/fonts/
> -WORKDIR /opt
> -RUN curl https://mirrors.ctan.org/macros/latex/contrib/cleveref.zip -L -O && unzip cleveref.zip && \
> -    curl https://mirrors.ctan.org/macros/latex/contrib/epigraph.zip -L -O && unzip epigraph.zip && \
> -    curl https://mirrors.ctan.org/macros/latex/contrib/glossaries-extra.zip -L -O && unzip glossaries-extra.zip && \
> -    cd cleveref; latex cleveref.ins; cd .. && \
> -    mkdir -p /usr/local/share/texmf/tex/latex/cleveref && \
> -    cp cleveref/cleveref.sty /usr/local/share/texmf/tex/latex/cleveref && \
> -    cd epigraph; latex epigraph.ins; cd .. && \
> -    mkdir -p /usr/local/share/texmf/tex/latex/epigraph && \
> -    cp epigraph/epigraph.sty /usr/local/share/texmf/tex/latex/epigraph && \
> -    cd glossaries-extra; latex glossaries-extra.ins; cd .. && \
> -    mkdir -p /usr/local/share/texmf/tex/latex/glossaries-extra && \
> -    cp glossaries-extra/*.sty /usr/local/share/texmf/tex/latex/glossaries-extra && \
> -    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
> -ARG group=perfbook
> -RUN if [ $uid -ne 0 ] ; then \
> -    groupadd -g $gid $group ; \
> -    useradd -u $uid -g $gid -m $user ; \
> -    fi
> -VOLUME /work
> -USER $uid:$gid
> -WORKDIR /work
> -CMD /bin/bash
> 
> base-commit: 3dace505d308aad265ee0a0c3daa850dbf890966
> -- 
> 2.25.1
> 
>