From: "Paul E. McKenney" <paulmck@kernel.org>
To: Akira Yokosawa <akiyks@gmail.com>
Cc: perfbook@vger.kernel.org
Subject: Re: [PATCH v2 -perfbook] Advance TeX Live requirement to 2019/Debian
Date: Thu, 29 Jun 2023 07:25:13 -0700 [thread overview]
Message-ID: <503a9b9a-f781-4b45-b61a-a19eb0c89626@paulmck-laptop> (raw)
In-Reply-To: <0757aae5-c8d4-5feb-63a0-47e1b3971e24@gmail.com>
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 <akiyks@gmail.com>
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
>
>
prev parent reply other threads:[~2023-06-29 14:25 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-06-29 11:16 [PATCH -perfbook] Give up TeX Live 2017/Debian Akira Yokosawa
2023-06-29 12:26 ` Akira Yokosawa
2023-06-29 13:47 ` [PATCH v2 -perfbook] Advance TeX Live requirement to 2019/Debian Akira Yokosawa
2023-06-29 14:25 ` Paul E. McKenney [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=503a9b9a-f781-4b45-b61a-a19eb0c89626@paulmck-laptop \
--to=paulmck@kernel.org \
--cc=akiyks@gmail.com \
--cc=perfbook@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).