diff mbox series

ref-manual/system-requirements: add buildtools note for Alma/CentOS/Rocky 9

Message ID 20260402-alma-centos-rocky-builtools-v1-1-447c92372100@bootlin.com
State New
Headers show
Series ref-manual/system-requirements: add buildtools note for Alma/CentOS/Rocky 9 | expand

Commit Message

Antonin Godard April 2, 2026, 8:21 a.m. UTC 
These distributions are affected by a bug with tar described in [1]. Add
a note for installing buildtools for these distros as described in the
bug comments.

[1]: https://bugzilla.yoctoproject.org/show_bug.cgi?id=16143

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/buildtools-alma-centos-rocky-9.rst | 11 +++++++++++
 documentation/ref-manual/system-requirements.rst            |  6 ++++++
 2 files changed, 17 insertions(+)


---
base-commit: c1c6eee66915b225a2efd5433fa1a9cf964f5abe
change-id: 20260402-alma-centos-rocky-builtools-325c1ec91a2c
diff mbox series

Patch

diff --git a/documentation/ref-manual/buildtools-alma-centos-rocky-9.rst b/documentation/ref-manual/buildtools-alma-centos-rocky-9.rst
new file mode 100644
index 000000000..713b729a0
--- /dev/null
+++ b/documentation/ref-manual/buildtools-alma-centos-rocky-9.rst
@@ -0,0 +1,11 @@ 
+.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
+
+You will also need to use a :term:`buildtools` tarball which provides a set of
+basic host tools with fixed versions. Follow the :ref:`system-requirements-buildtools`
+section below to learn how to download and install this tarball.
+
+.. note::
+
+   The AlmaLinux 9, CentOS 9 and RockyLinux 9 distributions are affected by a
+   bug described in :yocto_bugs:`/show_bug.cgi?id=16143`, which is the reason why a
+   :term:`buildtools` tarball is required.
diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst
index b427e2c64..c4d8cb5e0 100644
--- a/documentation/ref-manual/system-requirements.rst
+++ b/documentation/ref-manual/system-requirements.rst
@@ -236,6 +236,8 @@  with a supported AlmaLinux distribution:
 .. literalinclude:: ../tools/host_packages_scripts/almalinux_essential.sh
    :language: shell
 
+.. include:: buildtools-alma-centos-rocky-9.rst
+
 .. note::
 
    -  Extra Packages for Enterprise Linux (i.e. ``epel-release``) is
@@ -285,6 +287,8 @@  with a supported CentOS Stream distribution:
 .. literalinclude:: ../tools/host_packages_scripts/centosstream_essential.sh
    :language: shell
 
+.. include:: buildtools-alma-centos-rocky-9.rst
+
 Here are the packages needed to build Project documentation manuals:
 
 .. literalinclude:: ../tools/host_packages_scripts/centosstream_docs.sh
@@ -321,6 +325,8 @@  with a supported RockyLinux distribution:
 .. literalinclude:: ../tools/host_packages_scripts/rockylinux_essential.sh
    :language: shell
 
+.. include:: buildtools-alma-centos-rocky-9.rst
+
 .. note::
 
    -  Extra Packages for Enterprise Linux (i.e. ``epel-release``) is