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

Comments

Antonin Godard Jan. 5, 2026, 1:52 p.m. UTC | #1
On Thu, 11 Dec 2025 10:06:13 +0100, Antonin Godard wrote:
> 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.
> 
> [...]

Applied, thanks!

[1/5] tools/build-docs-container: move container files in their own directory
      commit: 4ee207aa6678812e93a625be84dff87df56610b2
[2/5] Makefile: fix rsvg-convert --format capitalization
      commit: ec588f83a38439bf4af7d6019169ec4445a72b9a
[3/5] tools/build-docs-container: add CentOS Stream 9 support
      commit: 2989f2fcd9e81f9385fcd2431ec7f3d9e7e507ff
[4/5] ref-manual/system-requirements.rst: fix AlmaLinux PDF build
      commit: 6751174d760a10dfe65d10dd3cc1c57395a10b0a
[5/5] ref-manual/system-requirements.rst: add RockyLinux install instructions
      commit: 5919767adc4b2dbd97fd1506b5f7c7e13ad083dc

Best regards,
--