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

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]>
---
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