mbox series

[v2,0/5] Add missing CentOS Stream / RockyLinux distros to the system-requirements.rst doc

Message ID 20251211-build-docs-container-tlmgr-v2-0-58719c103a50@bootlin.com
Headers show
Series Add missing CentOS Stream / RockyLinux distros to the system-requirements.rst doc | expand

Message

Antonin Godard Dec. 11, 2025, 9:06 a.m. UTC 
These two distros were missing so add a section for them along with
their list of requirements, which all and all are very similar to
AlmaLinux and Fedora.

For these distros and AlmaLinux, we now provide a way to build the
documentation PDF using a local installation of TeX Live packages (using
the TeX Live package manager, tlmgr). This is not as nice as the other
distributions where we have a working list of packages for that, but
it's still better than the current nothing, and finding all the required
TeX packages proves to be quite hard. Using tlmgr is also what is
currently done for all the distros on the Autobuilder.

This series also reorganizes the container files to put them in their
own directory, along with the new entrypoint which is needed to setup
the PATH.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
Changes in v2:
- Apply suggestions from Quentin, thanks!
  - Switch to environment variables directly set in the Containerfile,
    instead of an entrypoint.
  - Simplify tar extraction command.
- Link to v1: https://patch.msgid.link/20251205-build-docs-container-tlmgr-v1-0-de30623e664d@bootlin.com

---
Antonin Godard (5):
      tools/build-docs-container: move container files in their own directory
      Makefile: fix rsvg-convert --format capitalization
      tools/build-docs-container: add CentOS Stream 9 support
      ref-manual/system-requirements.rst: fix AlmaLinux PDF build
      ref-manual/system-requirements.rst: add RockyLinux install instructions

 documentation/Makefile                             |   4 +-
 documentation/ref-manual/system-requirements.rst   | 102 +++++++++++++++++++--
 documentation/tools/build-docs-container           |  55 +++++++----
 .../tools/containerfiles/Containerfile.almalinux   |   1 +
 .../tools/{ => containerfiles}/Containerfile.apt   |   0
 .../{ => containerfiles}/Containerfile.debian      |   0
 .../tools/{ => containerfiles}/Containerfile.dnf   |   3 +
 .../{ => containerfiles}/Containerfile.fedora      |   0
 .../tools/containerfiles/Containerfile.rocky       |   1 +
 .../Containerfile.stream}                          |   0
 .../{ => containerfiles}/Containerfile.ubuntu      |   0
 .../{ => containerfiles}/Containerfile.zypper      |   0
 .../tools/host_packages_scripts/almalinux_docs.sh  |   2 +-
 .../host_packages_scripts/almalinux_docs_pdf.sh    |   1 -
 .../host_packages_scripts/almalinux_essential.sh   |   6 +-
 .../host_packages_scripts/centosstream_docs.sh     |   1 +
 .../centosstream_essential.sh                      |   5 +
 .../tools/host_packages_scripts/rockylinux_docs.sh |   1 +
 .../host_packages_scripts/rockylinux_essential.sh  |   5 +
 .../tools/host_packages_scripts/tlmgr_docs_pdf.sh  |   7 ++
 20 files changed, 164 insertions(+), 30 deletions(-)
---
base-commit: efa93ba6a9340cf3b3c52525de83aa74ca09c5c9
change-id: 20251205-build-docs-container-tlmgr-0bb2d0c4cce4