[yocto-docs PATCH v2 0/6] Update the dependencies in poky.yaml.in

[yocto-docs PATCH v2 0/6] Update the dependencies in poky.yaml.in

[Antonin Godard]

This patch series aims at gathering the dependencies required to build
(both the image and the documentation) in poky.yaml.in, and updating
them with regards to recent changes (PDF, Epub addition / switch to
rsvg-convert).

Having all the dependencies listed in poky.yaml.in makes it easier to
track and compare them across the different distros. Also, these can be
reused by scripts (note: I am working on a patch that uses these
variables to build a container image ready for building the doc).

Also, add the dependencies required to build PDFs/Epub files. These were
initially listed for an Ubuntu 22.04 docker image I was working with,
and "translated" for other distros using https://pkgs.org.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
Changes in v2:
- Fix sorting of the yaml lists.
- Split commit for Fedora 39 addition, to backport on scarthgap.
- Use texlive-collection-lang* to match all language texlive packages in
  fedora and opensuse.
- Link to v1: https://lore.kernel.org/r/20241120-update-doc-deps-v1-0-50e267ae4123@bootlin.com

---
Antonin Godard (6):
      Gather dependencies in poky.yaml.in
      poky.yaml.in: replace inkscape dependency by librsvg2-bin
      system-requirements: add fedora 39 to supported distros
      system-requirements: update list of supported distros
      system-requirements.rst: add dependencies for pdf builds
      poky.yaml.in: add missing locales dependency

 documentation/brief-yoctoprojectqs/index.rst     |   2 +-
 documentation/poky.yaml.in                       | 266 ++++++++++++++++++++---
 documentation/ref-manual/system-requirements.rst |  59 ++++-
 3 files changed, 292 insertions(+), 35 deletions(-)
---
base-commit: 30002019198a168e48537407bb928facb26af82a
change-id: 20241120-update-doc-deps-1d59abdb2119

Best regards,
-- 
Antonin Godard <antonin.godard@bootlin.com>

[yocto-docs PATCH v2 1/6] Gather dependencies in poky.yaml.in

[Antonin Godard]

We used to have packages here and there in system-requirements.rst for
each distro. Instead, gather all the dependencies in poky.yaml.in so we
have an overview of what we provide for each distro.

Use yaml ">" to list the dependencies in alphabetical order, one entry
per line, which makes them easier to read and compare among distros.

Rename UBUNTU_… variables to UBUNTU_DEBIAN_…, since these are used for
both distros.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/brief-yoctoprojectqs/index.rst     |   2 +-
 documentation/poky.yaml.in                       | 218 ++++++++++++++++++++---
 documentation/ref-manual/system-requirements.rst |  22 ++-
 3 files changed, 207 insertions(+), 35 deletions(-)

diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst
index c5400e4ac8dafb9e3d1e4c14a065d02ac3e2f7a7..3d249eefaae35239b92c8a2f8dedf27ec2dbdca0 100644
--- a/documentation/brief-yoctoprojectqs/index.rst
+++ b/documentation/brief-yoctoprojectqs/index.rst
@@ -78,7 +78,7 @@ You must install essential host packages on your build host. The
 following command installs the host packages based on an Ubuntu
 distribution::
 
-   $ sudo apt install &UBUNTU_HOST_PACKAGES_ESSENTIAL;
+   $ sudo apt install &UBUNTU_DEBIAN_HOST_PACKAGES_ESSENTIAL;
 
 .. note::
 
diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
index 66f758fe85fcd10291f00902639b43a1da639b0f..d03809f557960d10a6b9a2753a65c80937c62e13 100644
--- a/documentation/poky.yaml.in
+++ b/documentation/poky.yaml.in
@@ -1,3 +1,7 @@
+#
+# Macros used in the documentation
+#
+
 DISTRO : "5.1"
 DISTRO_NAME_NO_CAP : "styhead"
 DISTRO_NAME : "Styhead"
@@ -10,31 +14,6 @@ BITBAKE_SERIES : ""
 YOCTO_DL_URL : "https://downloads.yoctoproject.org"
 YOCTO_AB_URL : "https://autobuilder.yoctoproject.org"
 YOCTO_RELEASE_DL_URL : "&YOCTO_DL_URL;/releases/yocto/yocto-&DISTRO;"
-UBUNTU_HOST_PACKAGES_ESSENTIAL : "gawk wget git diffstat unzip texinfo gcc \
-     build-essential chrpath socat cpio python3 python3-pip python3-pexpect \
-     xz-utils debianutils iputils-ping python3-git python3-jinja2 \
-     python3-subunit zstd liblz4-tool file locales libacl1"
-FEDORA_HOST_PACKAGES_ESSENTIAL : "gawk make wget tar bzip2 gzip python3 unzip perl patch \
-     diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath \
-     ccache perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue perl-bignum socat \
-     python3-pexpect findutils which file cpio python python3-pip xz python3-GitPython \
-     python3-jinja2 rpcgen perl-FindBin perl-File-Compare \
-     perl-File-Copy perl-locale zstd lz4 hostname glibc-langpack-en libacl"
-OPENSUSE_HOST_PACKAGES_ESSENTIAL : "python gcc gcc-c++ git chrpath make wget python-xml \
-     diffstat makeinfo python-curses patch socat python3 python3-curses tar python3-pip \
-     python3-pexpect xz which python3-Jinja2 rpcgen \
-     zstd lz4 bzip2 gzip hostname libacl1
-     \n\   $ sudo pip3 install GitPython"
-ALMALINUX_HOST_PACKAGES_ESSENTIAL : "-y epel-release
-     \n\   $ sudo yum install dnf-plugins-core
-     \n\   $ sudo dnf config-manager --set-enabled crb
-     \n\   $ sudo dnf makecache
-     \n\   $ sudo dnf install gawk make wget tar bzip2 gzip python3 unzip perl patch \
-     diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath ccache \
-     socat perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue python3-pip \
-     python3-GitPython python3-jinja2 python3-pexpect xz which \
-     rpcgen zstd lz4 cpio glibc-langpack-en libacl"
-PIP3_HOST_PACKAGES_DOC : "$ sudo pip3 install sphinx sphinx_rtd_theme pyyaml"
 MIN_PYTHON_VERSION : "3.8.0"
 MIN_TAR_VERSION : "1.28"
 MIN_GIT_VERSION : "1.8.3.1"
@@ -46,3 +25,192 @@ MIN_DISK_SPACE : "90"
 MIN_DISK_SPACE_RM_WORK : "40"
 # RAM (Gbytes) needed to generate qemux86-64 core-image-sato on Ubuntu 22.04 (x86-64) on a 4 core system
 MIN_RAM : "8"
+
+#
+# Dependencies
+#
+
+# Shared between distros
+PIP3_HOST_PACKAGES_DOC: sphinx sphinx_rtd_theme pyyaml
+
+UBUNTU_DEBIAN_HOST_PACKAGES_ESSENTIAL: >-
+  build-essential
+  chrpath
+  cpio
+  debianutils
+  diffstat
+  file
+  gawk
+  gcc
+  git
+  iputils-ping
+  libacl1
+  liblz4-tool
+  locales
+  python3
+  python3-git
+  python3-jinja2
+  python3-pexpect
+  python3-pip
+  python3-subunit
+  socat
+  texinfo
+  unzip
+  wget
+  xz-utils
+  zstd
+
+UBUNTU_DEBIAN_HOST_PACKAGES_DOC: >-
+  git
+  inkscape
+  make
+  python3-saneyaml
+  python3-sphinx-rtd-theme
+  sphinx
+  texlive-latex-extra
+
+
+FEDORA_HOST_PACKAGES_ESSENTIAL: >-
+  bzip2
+  ccache
+  chrpath
+  cpio
+  cpp
+  diffstat
+  diffutils
+  file
+  findutils
+  gawk
+  gcc
+  gcc-c++
+  git
+  glibc-devel
+  glibc-langpack-en
+  gzip
+  hostname
+  libacl
+  lz4
+  make
+  patch
+  perl
+  perl-Data-Dumper
+  perl-File-Compare
+  perl-File-Copy
+  perl-FindBin
+  perl-Text-ParseWords
+  perl-Thread-Queue
+  perl-bignum
+  perl-locale
+  python
+  python3
+  python3-GitPython
+  python3-jinja2
+  python3-pexpect
+  python3-pip
+  rpcgen
+  socat
+  tar
+  texinfo
+  unzip
+  wget
+  which
+  xz
+  zstd
+
+FEDORA_HOST_PACKAGES_DOC: >-
+  git
+  inkscape
+  make
+  python3-pip
+  python3-saneyaml
+  python3-sphinx-rtd-theme
+  sphinx
+  texlive-fncychap
+  texlive-latex-extra
+  which
+
+OPENSUSE_HOST_PACKAGES_ESSENTIAL: >-
+  bzip2
+  chrpath
+  diffstat
+  gcc
+  gcc-c++
+  git
+  gzip
+  hostname
+  libacl1
+  lz4
+  make
+  makeinfo
+  patch
+  python
+  python-curses
+  python-xml
+  python3
+  python3-Jinja2
+  python3-curses
+  python3-pexpect
+  python3-pip
+  rpcgen
+  socat
+  tar
+  wget
+  which
+  xz
+  zstd
+
+OPENSUSE_PIP3_HOST_PACKAGES_ESSENTIAL: GitPython
+
+OPENSUSE_HOST_PACKAGES_DOC: >-
+  git
+  inkscape
+  make
+  python3-pip
+  texlive-fncychap
+  which
+
+ALMALINUX_HOST_PACKAGES_ESSENTIAL: >-
+  bzip2
+  ccache
+  chrpath
+  cpio
+  cpp
+  diffstat
+  diffutils
+  gawk
+  gcc
+  gcc-c++
+  git
+  glibc-devel
+  glibc-langpack-en
+  gzip
+  libacl
+  lz4
+  make
+  patch
+  perl
+  perl-Data-Dumper
+  perl-Text-ParseWords
+  perl-Thread-Queue
+  python3
+  python3-GitPython
+  python3-jinja2
+  python3-pexpect
+  python3-pip
+  rpcgen
+  socat
+  tar
+  texinfo
+  unzip
+  wget
+  which
+  xz
+  zstd
+
+ALMALINUX_HOST_PACKAGES_DOC: >-
+  git
+  inkscape
+  make
+  python3-pip
+  texlive-fncychap
+  which
diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst
index 43c3c5834b1a3c7d164512a9b42b68e06eacaafa..0b40c3f5e5ae87d703d9a2d338de084ca9f93b2b 100644
--- a/documentation/ref-manual/system-requirements.rst
+++ b/documentation/ref-manual/system-requirements.rst
@@ -150,7 +150,7 @@ Ubuntu and Debian
 Here are the packages needed to build an image on a headless system
 with a supported Ubuntu or Debian Linux distribution::
 
-   $ sudo apt install &UBUNTU_HOST_PACKAGES_ESSENTIAL;
+   $ sudo apt install &UBUNTU_DEBIAN_HOST_PACKAGES_ESSENTIAL;
 
 You also need to ensure you have the ``en_US.UTF-8`` locale enabled::
 
@@ -181,8 +181,7 @@ If this is not the case, you can reconfigure the ``locales`` package to add it
 
 Here are the packages needed to build Project documentation manuals::
 
-   $ sudo apt install git make inkscape texlive-latex-extra
-   $ sudo apt install sphinx python3-saneyaml python3-sphinx-rtd-theme
+   $ sudo apt install &UBUNTU_DEBIAN_HOST_PACKAGES_DOC;
 
 Fedora Packages
 ---------------
@@ -194,8 +193,8 @@ with a supported Fedora Linux distribution::
 
 Here are the packages needed to build Project documentation manuals::
 
-   $ sudo dnf install git make python3-pip which inkscape texlive-fncychap
-   &PIP3_HOST_PACKAGES_DOC;
+   $ sudo dnf install &FEDORA_HOST_PACKAGES_DOC;
+   $ sudo pip3 install &PIP3_HOST_PACKAGES_DOC;
 
 openSUSE Packages
 -----------------
@@ -204,11 +203,12 @@ Here are the packages needed to build an image on a headless system
 with a supported openSUSE distribution::
 
    $ sudo zypper install &OPENSUSE_HOST_PACKAGES_ESSENTIAL;
+   $ sudo pip3 install &OPENSUSE_PIP3_HOST_PACKAGES_ESSENTIAL;
 
 Here are the packages needed to build Project documentation manuals::
 
-   $ sudo zypper install git make python3-pip which inkscape texlive-fncychap
-   &PIP3_HOST_PACKAGES_DOC;
+   $ sudo zypper install &OPENSUSE_HOST_PACKAGES_DOC;
+   $ sudo pip3 install &PIP3_HOST_PACKAGES_DOC;
 
 
 AlmaLinux Packages
@@ -217,6 +217,10 @@ AlmaLinux Packages
 Here are the packages needed to build an image on a headless system
 with a supported AlmaLinux distribution::
 
+   $ sudo dnf install -y epel-release
+   $ sudo yum install dnf-plugins-core
+   $ sudo dnf config-manager --set-enabled crb
+   $ sudo dnf makecache
    $ sudo dnf install &ALMALINUX_HOST_PACKAGES_ESSENTIAL;
 
 .. note::
@@ -234,8 +238,8 @@ with a supported AlmaLinux distribution::
 
 Here are the packages needed to build Project documentation manuals::
 
-   $ sudo dnf install git make python3-pip which inkscape texlive-fncychap
-   &PIP3_HOST_PACKAGES_DOC;
+   $ sudo dnf install &ALMALINUX_HOST_PACKAGES_DOC;
+   $ sudo pip3 install &PIP3_HOST_PACKAGES_DOC;
 
 .. _system-requirements-buildtools:
 

-- 
2.46.1

[yocto-docs PATCH v2 2/6] poky.yaml.in: replace inkscape dependency by librsvg2-bin

[Antonin Godard]

inkscape used to be a requirement to convert SVG images to PNGs/PDFs,
but we replaced it recently by rsvg-convert.

Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/poky.yaml.in | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
index d03809f557960d10a6b9a2753a65c80937c62e13..94849acf9942c7ebddb2ac7f8aaf5eb9d87e0c5b 100644
--- a/documentation/poky.yaml.in
+++ b/documentation/poky.yaml.in
@@ -62,7 +62,7 @@ UBUNTU_DEBIAN_HOST_PACKAGES_ESSENTIAL: >-
 
 UBUNTU_DEBIAN_HOST_PACKAGES_DOC: >-
   git
-  inkscape
+  librsvg2-bin
   make
   python3-saneyaml
   python3-sphinx-rtd-theme
@@ -119,7 +119,7 @@ FEDORA_HOST_PACKAGES_ESSENTIAL: >-
 
 FEDORA_HOST_PACKAGES_DOC: >-
   git
-  inkscape
+  librsvg2-tools
   make
   python3-pip
   python3-saneyaml
@@ -163,9 +163,9 @@ OPENSUSE_PIP3_HOST_PACKAGES_ESSENTIAL: GitPython
 
 OPENSUSE_HOST_PACKAGES_DOC: >-
   git
-  inkscape
   make
   python3-pip
+  rsvg-convert
   texlive-fncychap
   which
 
@@ -209,7 +209,7 @@ ALMALINUX_HOST_PACKAGES_ESSENTIAL: >-
 
 ALMALINUX_HOST_PACKAGES_DOC: >-
   git
-  inkscape
+  librsvg2-tools
   make
   python3-pip
   texlive-fncychap

-- 
2.46.1

[yocto-docs PATCH v2 3/6] system-requirements: add fedora 39 to supported distros

[Antonin Godard]

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/system-requirements.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst
index 0b40c3f5e5ae87d703d9a2d338de084ca9f93b2b..17ad1b741a0b92f218860d22bbc4b0927b73b865 100644
--- a/documentation/ref-manual/system-requirements.rst
+++ b/documentation/ref-manual/system-requirements.rst
@@ -64,6 +64,8 @@ supported on the following distributions:
 
 -  Fedora 38
 
+-  Fedora 39
+
 -  CentOS Stream 8
 
 -  Debian GNU/Linux 11 (Bullseye)

-- 
2.46.1

[yocto-docs PATCH v2 4/6] system-requirements: update list of supported distros

[Antonin Godard]

To match the list in meta-poky/conf/distro/poky.conf.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/system-requirements.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst
index 17ad1b741a0b92f218860d22bbc4b0927b73b865..7c7f518d9fe1f68e5b014cf31e59dc9bbe322e4c 100644
--- a/documentation/ref-manual/system-requirements.rst
+++ b/documentation/ref-manual/system-requirements.rst
@@ -62,10 +62,14 @@ supported on the following distributions:
 
 -  Ubuntu 22.04 (LTS)
 
+-  Ubuntu 24.04 (LTS)
+
 -  Fedora 38
 
 -  Fedora 39
 
+-  Fedora 40
+
 -  CentOS Stream 8
 
 -  Debian GNU/Linux 11 (Bullseye)
@@ -74,6 +78,10 @@ supported on the following distributions:
 
 -  OpenSUSE Leap 15.4
 
+-  OpenSUSE Leap 15.5
+
+-  OpenSUSE Leap 15.6
+
 -  AlmaLinux 8
 
 -  AlmaLinux 9

-- 
2.46.1

[yocto-docs PATCH v2 5/6] system-requirements.rst: add dependencies for pdf builds

[Antonin Godard]

With the recent changes from commit
bd6265ca323fac547a197bb516dc4a9ef3897508 ("doc: Makefile: add support
for xelatex"), the list of dependencies needs to be updated.

The initial list of dependencies was made for Ubuntu/Debian, and the
packages were translated for the other distros using pkgs.org.

Add them separately from the rest of the dependencies as they pull a
_lot_ of additional dependencies (for LaTeX).

Notes:
- Fedora/OpenSUSE do not have the "lang-all" texlive collection, so
  install all available languages.
- AlmaLinux does not seem to provide texlive-collection-fontsextra,
  texlive-collection-lang*, and texlive-collection-latexextra, so add a
  warning about that.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/poky.yaml.in                       | 47 +++++++++++++++++++++++-
 documentation/ref-manual/system-requirements.rst | 27 ++++++++++++++
 2 files changed, 73 insertions(+), 1 deletion(-)

diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
index 94849acf9942c7ebddb2ac7f8aaf5eb9d87e0c5b..25385068679a51e0f2e9e516b02b62e19e126291 100644
--- a/documentation/poky.yaml.in
+++ b/documentation/poky.yaml.in
@@ -67,8 +67,17 @@ UBUNTU_DEBIAN_HOST_PACKAGES_DOC: >-
   python3-saneyaml
   python3-sphinx-rtd-theme
   sphinx
-  texlive-latex-extra
 
+UBUNTU_DEBIAN_HOST_PACKAGES_DOC_PDF: >-
+  fonts-freefont-otf
+  latexmk
+  tex-gyre
+  texlive-fonts-extra
+  texlive-fonts-recommended
+  texlive-lang-all
+  texlive-latex-extra
+  texlive-latex-recommended
+  texlive-xetex
 
 FEDORA_HOST_PACKAGES_ESSENTIAL: >-
   bzip2
@@ -129,6 +138,19 @@ FEDORA_HOST_PACKAGES_DOC: >-
   texlive-latex-extra
   which
 
+FEDORA_HOST_PACKAGES_DOC_PDF: >-
+  latexmk
+  texlive-collection-fontsextra
+  texlive-collection-fontsrecommended
+  texlive-collection-lang*
+  texlive-collection-latex
+  texlive-collection-latexextra
+  texlive-collection-latexrecommended
+  texlive-collection-xetex
+  texlive-gnu-freefont
+  texlive-tex-gyre
+  texlive-xetex
+
 OPENSUSE_HOST_PACKAGES_ESSENTIAL: >-
   bzip2
   chrpath
@@ -169,6 +191,19 @@ OPENSUSE_HOST_PACKAGES_DOC: >-
   texlive-fncychap
   which
 
+OPENSUSE_HOST_PACKAGES_DOC_PDF: >-
+  texlive-collection-fontsextra
+  texlive-collection-fontsrecommended
+  texlive-collection-lang*
+  texlive-collection-latex
+  texlive-collection-latexextra
+  texlive-collection-latexrecommended
+  texlive-collection-xetex
+  texlive-gnu-freefont
+  texlive-latexmk
+  texlive-tex-gyre
+  texlive-xetex
+
 ALMALINUX_HOST_PACKAGES_ESSENTIAL: >-
   bzip2
   ccache
@@ -214,3 +249,13 @@ ALMALINUX_HOST_PACKAGES_DOC: >-
   python3-pip
   texlive-fncychap
   which
+
+ALMALINUX_HOST_PACKAGES_DOC_PDF: >-
+  latexmk
+  texlive-collection-fontsrecommended
+  texlive-collection-latex
+  texlive-collection-latexrecommended
+  texlive-collection-xetex
+  texlive-gnu-freefont
+  texlive-tex-gyre
+  texlive-xetex
diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst
index 7c7f518d9fe1f68e5b014cf31e59dc9bbe322e4c..b087d374d23a71104dc9c050e96e4a2c20f5abb0 100644
--- a/documentation/ref-manual/system-requirements.rst
+++ b/documentation/ref-manual/system-requirements.rst
@@ -193,6 +193,11 @@ Here are the packages needed to build Project documentation manuals::
 
    $ sudo apt install &UBUNTU_DEBIAN_HOST_PACKAGES_DOC;
 
+In addition to the previous packages, here are the packages needed to build the
+documentation in PDF format::
+
+   $ sudo apt install &UBUNTU_DEBIAN_HOST_PACKAGES_DOC_PDF;
+
 Fedora Packages
 ---------------
 
@@ -206,6 +211,11 @@ Here are the packages needed to build Project documentation manuals::
    $ sudo dnf install &FEDORA_HOST_PACKAGES_DOC;
    $ sudo pip3 install &PIP3_HOST_PACKAGES_DOC;
 
+In addition to the previous packages, here are the packages needed to build the
+documentation in PDF format::
+
+   $ sudo dnf install &FEDORA_HOST_PACKAGES_DOC_PDF;
+
 openSUSE Packages
 -----------------
 
@@ -220,6 +230,11 @@ Here are the packages needed to build Project documentation manuals::
    $ sudo zypper install &OPENSUSE_HOST_PACKAGES_DOC;
    $ sudo pip3 install &PIP3_HOST_PACKAGES_DOC;
 
+In addition to the previous packages, here are the packages needed to build the
+documentation in PDF format::
+
+   $ sudo zypper install &OPENSUSE_HOST_PACKAGES_DOC_PDF;
+
 
 AlmaLinux Packages
 ------------------
@@ -251,6 +266,18 @@ Here are the packages needed to build Project documentation manuals::
    $ sudo dnf install &ALMALINUX_HOST_PACKAGES_DOC;
    $ sudo pip3 install &PIP3_HOST_PACKAGES_DOC;
 
+In addition to the previous packages, here are the packages needed to build the
+documentation in PDF format::
+
+   $ sudo dnf install &ALMALINUX_HOST_PACKAGES_DOC_PDF;
+
+.. warning::
+
+   Unlike Fedora or OpenSUSE, AlmaLinux does not provide the packages
+   ``texlive-collection-fontsextra``, ``texlive-collection-lang*`` and
+   ``texlive-collection-latexextra``, so you may run into issues. These may be
+   installed using `tlmgr <https://tug.org/texlive/tlmgr.html>`_.
+
 .. _system-requirements-buildtools:
 
 Required Git, tar, Python, make and gcc Versions

-- 
2.46.1

[yocto-docs PATCH v2 6/6] poky.yaml.in: add missing locales dependency

[Antonin Godard]

This is a requirement for building the documentation, otherwise we get
(on Ubuntu 24.04):

     File "/usr/lib/python3.12/locale.py", line 615, in setlocale
       return _setlocale(category, locale)
              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
   locale.Error: unsupported locale setting

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/poky.yaml.in | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
index 25385068679a51e0f2e9e516b02b62e19e126291..340c6e891615d4b552a879062ac9e367888905da 100644
--- a/documentation/poky.yaml.in
+++ b/documentation/poky.yaml.in
@@ -63,6 +63,7 @@ UBUNTU_DEBIAN_HOST_PACKAGES_ESSENTIAL: >-
 UBUNTU_DEBIAN_HOST_PACKAGES_DOC: >-
   git
   librsvg2-bin
+  locales
   make
   python3-saneyaml
   python3-sphinx-rtd-theme
@@ -128,12 +129,12 @@ FEDORA_HOST_PACKAGES_ESSENTIAL: >-
 
 FEDORA_HOST_PACKAGES_DOC: >-
   git
+  glibc-locale-source
   librsvg2-tools
   make
   python3-pip
   python3-saneyaml
   python3-sphinx-rtd-theme
-  sphinx
   texlive-fncychap
   texlive-latex-extra
   which
@@ -185,6 +186,7 @@ OPENSUSE_PIP3_HOST_PACKAGES_ESSENTIAL: GitPython
 
 OPENSUSE_HOST_PACKAGES_DOC: >-
   git
+  glibc-i18ndata
   make
   python3-pip
   rsvg-convert
@@ -244,6 +246,7 @@ ALMALINUX_HOST_PACKAGES_ESSENTIAL: >-
 
 ALMALINUX_HOST_PACKAGES_DOC: >-
   git
+  glibc-locale-source
   librsvg2-tools
   make
   python3-pip

-- 
2.46.1

Re: [yocto-docs PATCH v2 1/6] Gather dependencies in poky.yaml.in

[Quentin Schulz]

Hi Antonin,

On 12/4/24 1:23 PM, Antonin Godard wrote:
> We used to have packages here and there in system-requirements.rst for
> each distro. Instead, gather all the dependencies in poky.yaml.in so we
> have an overview of what we provide for each distro.
> 
> Use yaml ">" to list the dependencies in alphabetical order, one entry

Yet >- is used :)

> per line, which makes them easier to read and compare among distros.
> 
> Rename UBUNTU_… variables to UBUNTU_DEBIAN_…, since these are used for
> both distros.
> 
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
> ---
>   documentation/brief-yoctoprojectqs/index.rst     |   2 +-
>   documentation/poky.yaml.in                       | 218 ++++++++++++++++++++---
>   documentation/ref-manual/system-requirements.rst |  22 ++-
>   3 files changed, 207 insertions(+), 35 deletions(-)
> 
> diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst
> index c5400e4ac8dafb9e3d1e4c14a065d02ac3e2f7a7..3d249eefaae35239b92c8a2f8dedf27ec2dbdca0 100644
> --- a/documentation/brief-yoctoprojectqs/index.rst
> +++ b/documentation/brief-yoctoprojectqs/index.rst
> @@ -78,7 +78,7 @@ You must install essential host packages on your build host. The
>   following command installs the host packages based on an Ubuntu
>   distribution::
>   
> -   $ sudo apt install &UBUNTU_HOST_PACKAGES_ESSENTIAL;
> +   $ sudo apt install &UBUNTU_DEBIAN_HOST_PACKAGES_ESSENTIAL;
>   
>   .. note::
>   
> diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
> index 66f758fe85fcd10291f00902639b43a1da639b0f..d03809f557960d10a6b9a2753a65c80937c62e13 100644
> --- a/documentation/poky.yaml.in
> +++ b/documentation/poky.yaml.in
> @@ -1,3 +1,7 @@
> +#
> +# Macros used in the documentation
> +#
> +
>   DISTRO : "5.1"
>   DISTRO_NAME_NO_CAP : "styhead"
>   DISTRO_NAME : "Styhead"
> @@ -10,31 +14,6 @@ BITBAKE_SERIES : ""
>   YOCTO_DL_URL : "https://downloads.yoctoproject.org/"
>   YOCTO_AB_URL : "https://autobuilder.yoctoproject.org/"
>   YOCTO_RELEASE_DL_URL : "&YOCTO_DL_URL;/releases/yocto/yocto-&DISTRO;"
> -UBUNTU_HOST_PACKAGES_ESSENTIAL : "gawk wget git diffstat unzip texinfo gcc \
> -     build-essential chrpath socat cpio python3 python3-pip python3-pexpect \
> -     xz-utils debianutils iputils-ping python3-git python3-jinja2 \
> -     python3-subunit zstd liblz4-tool file locales libacl1"
> -FEDORA_HOST_PACKAGES_ESSENTIAL : "gawk make wget tar bzip2 gzip python3 unzip perl patch \
> -     diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath \
> -     ccache perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue perl-bignum socat \
> -     python3-pexpect findutils which file cpio python python3-pip xz python3-GitPython \
> -     python3-jinja2 rpcgen perl-FindBin perl-File-Compare \
> -     perl-File-Copy perl-locale zstd lz4 hostname glibc-langpack-en libacl"
> -OPENSUSE_HOST_PACKAGES_ESSENTIAL : "python gcc gcc-c++ git chrpath make wget python-xml \
> -     diffstat makeinfo python-curses patch socat python3 python3-curses tar python3-pip \
> -     python3-pexpect xz which python3-Jinja2 rpcgen \
> -     zstd lz4 bzip2 gzip hostname libacl1
> -     \n\   $ sudo pip3 install GitPython"
> -ALMALINUX_HOST_PACKAGES_ESSENTIAL : "-y epel-release
> -     \n\   $ sudo yum install dnf-plugins-core
> -     \n\   $ sudo dnf config-manager --set-enabled crb
> -     \n\   $ sudo dnf makecache
> -     \n\   $ sudo dnf install gawk make wget tar bzip2 gzip python3 unzip perl patch \
> -     diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath ccache \
> -     socat perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue python3-pip \
> -     python3-GitPython python3-jinja2 python3-pexpect xz which \
> -     rpcgen zstd lz4 cpio glibc-langpack-en libacl"
> -PIP3_HOST_PACKAGES_DOC : "$ sudo pip3 install sphinx sphinx_rtd_theme pyyaml"
>   MIN_PYTHON_VERSION : "3.8.0"
>   MIN_TAR_VERSION : "1.28"
>   MIN_GIT_VERSION : "1.8.3.1"
> @@ -46,3 +25,192 @@ MIN_DISK_SPACE : "90"
>   MIN_DISK_SPACE_RM_WORK : "40"
>   # RAM (Gbytes) needed to generate qemux86-64 core-image-sato on Ubuntu 22.04 (x86-64) on a 4 core system
>   MIN_RAM : "8"
> +
> +#
> +# Dependencies
> +#
> +
> +# Shared between distros
> +PIP3_HOST_PACKAGES_DOC: sphinx sphinx_rtd_theme pyyaml
> +
> +UBUNTU_DEBIAN_HOST_PACKAGES_ESSENTIAL: >-
> +  build-essential
> +  chrpath
> +  cpio
> +  debianutils
> +  diffstat
> +  file
> +  gawk
> +  gcc
> +  git
> +  iputils-ping
> +  libacl1
> +  liblz4-tool
> +  locales
> +  python3
> +  python3-git
> +  python3-jinja2
> +  python3-pexpect
> +  python3-pip
> +  python3-subunit
> +  socat
> +  texinfo
> +  unzip
> +  wget
> +  xz-utils
> +  zstd
> +
> +UBUNTU_DEBIAN_HOST_PACKAGES_DOC: >-
> +  git
> +  inkscape
> +  make
> +  python3-saneyaml
> +  python3-sphinx-rtd-theme
> +  sphinx
> +  texlive-latex-extra
> +
> +
> +FEDORA_HOST_PACKAGES_ESSENTIAL: >-
> +  bzip2
> +  ccache

I'm wondering if this is really required?

> +  chrpath
> +  cpio
> +  cpp
> +  diffstat
> +  diffutils
> +  file
> +  findutils
> +  gawk
> +  gcc
> +  gcc-c++
> +  git
> +  glibc-devel
> +  glibc-langpack-en
> +  gzip
> +  hostname
> +  libacl
> +  lz4
> +  make
> +  patch
> +  perl
> +  perl-Data-Dumper
> +  perl-File-Compare
> +  perl-File-Copy
> +  perl-FindBin
> +  perl-Text-ParseWords
> +  perl-Thread-Queue
> +  perl-bignum
> +  perl-locale
> +  python

I'm wondering if this is required? I guess the times we could have 
python3 and python2 code mixed is over?

> +  python3
> +  python3-GitPython
> +  python3-jinja2
> +  python3-pexpect
> +  python3-pip
> +  rpcgen
> +  socat
> +  tar
> +  texinfo
> +  unzip
> +  wget
> +  which
> +  xz
> +  zstd
> +
> +FEDORA_HOST_PACKAGES_DOC: >-
> +  git
> +  inkscape
> +  make
> +  python3-pip
> +  python3-saneyaml
> +  python3-sphinx-rtd-theme
> +  sphinx

The three packages above are supposed to be coming from pip according to 
the current version of the instructions.

> +  texlive-fncychap
> +  texlive-latex-extra

This isn't currently part of the instructions.

> +  which
> +
> +OPENSUSE_HOST_PACKAGES_ESSENTIAL: >-
> +  bzip2
> +  chrpath
> +  diffstat
> +  gcc
> +  gcc-c++
> +  git
> +  gzip
> +  hostname
> +  libacl1
> +  lz4
> +  make
> +  makeinfo
> +  patch
> +  python
> +  python-curses

Ditto for python and python-curses, especialy since we have 
python3-curses below.

> +  python-xml
> +  python3
> +  python3-Jinja2
> +  python3-curses
> +  python3-pexpect
> +  python3-pip
> +  rpcgen
> +  socat
> +  tar
> +  wget
> +  which
> +  xz
> +  zstd
> +
> +OPENSUSE_PIP3_HOST_PACKAGES_ESSENTIAL: GitPython
> +
> +OPENSUSE_HOST_PACKAGES_DOC: >-
> +  git
> +  inkscape
> +  make
> +  python3-pip
> +  texlive-fncychap
> +  which
> +
> +ALMALINUX_HOST_PACKAGES_ESSENTIAL: >-
> +  bzip2
> +  ccache

This is aligned with Fedora but I'm still wondering if it actually is a 
requirement (well, if you INHERIT ccache, yes).

> +  chrpath
> +  cpio
> +  cpp
> +  diffstat
> +  diffutils
> +  gawk
> +  gcc
> +  gcc-c++
> +  git
> +  glibc-devel
> +  glibc-langpack-en
> +  gzip

The original list had "install" but it's gone here, on purpose?

Cheers,
Quentin

Re: [yocto-docs PATCH v2 2/6] poky.yaml.in: replace inkscape dependency by librsvg2-bin

[Quentin Schulz]

Hi Antonin,

On 12/4/24 1:23 PM, Antonin Godard wrote:
> inkscape used to be a requirement to convert SVG images to PNGs/PDFs,
> but we replaced it recently by rsvg-convert.
> 
> Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>

I would recommend to order the commits differently.

I believe patch 1/6 and 6/6 can be backported to earlier releases. But 
by having 2/6 modify the same part of the code, it is possible that 6/6 
won't cleanly apply when backporting. If we were to reorder the patches 
and have 6/6 before 2/6, this should not happen.

It's anyway you that would experience the pain of backporting and 
resolving conflicts, if there's any, so up to you :)

Cheers,
Quentin

Re: [yocto-docs PATCH v2 5/6] system-requirements.rst: add dependencies for pdf builds

[Quentin Schulz]

Hi Antonin,

On 12/4/24 1:23 PM, Antonin Godard wrote:
> With the recent changes from commit
> bd6265ca323fac547a197bb516dc4a9ef3897508 ("doc: Makefile: add support
> for xelatex"), the list of dependencies needs to be updated.
> 
> The initial list of dependencies was made for Ubuntu/Debian, and the
> packages were translated for the other distros using pkgs.org.
> 
> Add them separately from the rest of the dependencies as they pull a
> _lot_ of additional dependencies (for LaTeX).
> 
> Notes:
> - Fedora/OpenSUSE do not have the "lang-all" texlive collection, so
>    install all available languages.
> - AlmaLinux does not seem to provide texlive-collection-fontsextra,
>    texlive-collection-lang*, and texlive-collection-latexextra, so add a
>    warning about that.
> 
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
> ---
>   documentation/poky.yaml.in                       | 47 +++++++++++++++++++++++-
>   documentation/ref-manual/system-requirements.rst | 27 ++++++++++++++
>   2 files changed, 73 insertions(+), 1 deletion(-)
> 
> diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
> index 94849acf9942c7ebddb2ac7f8aaf5eb9d87e0c5b..25385068679a51e0f2e9e516b02b62e19e126291 100644
> --- a/documentation/poky.yaml.in
> +++ b/documentation/poky.yaml.in
> @@ -67,8 +67,17 @@ UBUNTU_DEBIAN_HOST_PACKAGES_DOC: >-
>     python3-saneyaml
>     python3-sphinx-rtd-theme
>     sphinx
> -  texlive-latex-extra
>   
> +UBUNTU_DEBIAN_HOST_PACKAGES_DOC_PDF: >-
> +  fonts-freefont-otf
> +  latexmk
> +  tex-gyre
> +  texlive-fonts-extra
> +  texlive-fonts-recommended
> +  texlive-lang-all
> +  texlive-latex-extra
> +  texlive-latex-recommended
> +  texlive-xetex
>   
>   FEDORA_HOST_PACKAGES_ESSENTIAL: >-
>     bzip2
> @@ -129,6 +138,19 @@ FEDORA_HOST_PACKAGES_DOC: >-
>     texlive-latex-extra
>     which
>   
> +FEDORA_HOST_PACKAGES_DOC_PDF: >-
> +  latexmk
> +  texlive-collection-fontsextra
> +  texlive-collection-fontsrecommended
> +  texlive-collection-lang*

Please use single quotes to surround texlive-collection-lang* otherwise 
it may be interpreted by the shell, c.f. for me:

```sh
$ sudo dnf install texlive-collection-lang*
zsh: no matches found: libgpiod*
```

while `sudo dnf install 'texlive-collection-lang*'` works just fine.

Ditto for the other occurrences later in this diff.

Cheers,
Quentin

Re: [yocto-docs PATCH v2 1/6] Gather dependencies in poky.yaml.in

[Antonin Godard]

Hi Quentin,

On Fri Dec 6, 2024 at 2:51 PM CET, Quentin Schulz wrote:
[...]
>> +FEDORA_HOST_PACKAGES_ESSENTIAL: >-
>> +  bzip2
>> +  ccache
>
> I'm wondering if this is really required?

I'm not sure either. For now, this series focuses on updating the dependencies
for the recent PDF additions. Optimizing this list will require more work, and
is related to an open bug on bugzilla
(https://bugzilla.yoctoproject.org/show_bug.cgi?id=14873).

I'm trying to get a clean base and a helper container script in to make this
easier for me and others to do this (adding/removing things from the list).

But I will definitely go back to your comments as you are indeed pointing out
things that might be unneeded now, indeed.

>> +  chrpath
>> +  cpio
>> +  cpp
>> +  diffstat
>> +  diffutils
>> +  file
>> +  findutils
>> +  gawk
>> +  gcc
>> +  gcc-c++
>> +  git
>> +  glibc-devel
>> +  glibc-langpack-en
>> +  gzip
>> +  hostname
>> +  libacl
>> +  lz4
>> +  make
>> +  patch
>> +  perl
>> +  perl-Data-Dumper
>> +  perl-File-Compare
>> +  perl-File-Copy
>> +  perl-FindBin
>> +  perl-Text-ParseWords
>> +  perl-Thread-Queue
>> +  perl-bignum
>> +  perl-locale
>> +  python
>
> I'm wondering if this is required? I guess the times we could have 
> python3 and python2 code mixed is over?
>
>> +  python3
>> +  python3-GitPython
>> +  python3-jinja2
>> +  python3-pexpect
>> +  python3-pip
>> +  rpcgen
>> +  socat
>> +  tar
>> +  texinfo
>> +  unzip
>> +  wget
>> +  which
>> +  xz
>> +  zstd
>> +
>> +FEDORA_HOST_PACKAGES_DOC: >-
>> +  git
>> +  inkscape
>> +  make
>> +  python3-pip
>> +  python3-saneyaml
>> +  python3-sphinx-rtd-theme
>> +  sphinx
>
> The three packages above are supposed to be coming from pip according to 
> the current version of the instructions.

You're right, I guess I mixed things up with the Ubuntu instructions. I think
initially I wanted to provide a common base for all distros but it's not a good
idea. I'll revert this and keep the same content as in the previous instructions.

>> +  texlive-fncychap
>> +  texlive-latex-extra
>
> This isn't currently part of the instructions.
>
>> +  which
>> +
>> +OPENSUSE_HOST_PACKAGES_ESSENTIAL: >-
>> +  bzip2
>> +  chrpath
>> +  diffstat
>> +  gcc
>> +  gcc-c++
>> +  git
>> +  gzip
>> +  hostname
>> +  libacl1
>> +  lz4
>> +  make
>> +  makeinfo
>> +  patch
>> +  python
>> +  python-curses
>
> Ditto for python and python-curses, especialy since we have 
> python3-curses below.
>
>> +  python-xml
>> +  python3
>> +  python3-Jinja2
>> +  python3-curses
>> +  python3-pexpect
>> +  python3-pip
>> +  rpcgen
>> +  socat
>> +  tar
>> +  wget
>> +  which
>> +  xz
>> +  zstd
>> +
>> +OPENSUSE_PIP3_HOST_PACKAGES_ESSENTIAL: GitPython
>> +
>> +OPENSUSE_HOST_PACKAGES_DOC: >-
>> +  git
>> +  inkscape
>> +  make
>> +  python3-pip
>> +  texlive-fncychap
>> +  which
>> +
>> +ALMALINUX_HOST_PACKAGES_ESSENTIAL: >-
>> +  bzip2
>> +  ccache
>
> This is aligned with Fedora but I'm still wondering if it actually is a 
> requirement (well, if you INHERIT ccache, yes).
>
>> +  chrpath
>> +  cpio
>> +  cpp
>> +  diffstat
>> +  diffutils
>> +  gawk
>> +  gcc
>> +  gcc-c++
>> +  git
>> +  glibc-devel
>> +  glibc-langpack-en
>> +  gzip
>
> The original list had "install" but it's gone here, on purpose?

No, must be a mistake from me.


Thanks!
Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [yocto-docs PATCH v2 5/6] system-requirements.rst: add dependencies for pdf builds

[Antonin Godard]

Hi Quentin,

On Fri Dec 6, 2024 at 3:00 PM CET, Quentin Schulz wrote:
> Hi Antonin,
>
> On 12/4/24 1:23 PM, Antonin Godard wrote:
>> With the recent changes from commit
>> bd6265ca323fac547a197bb516dc4a9ef3897508 ("doc: Makefile: add support
>> for xelatex"), the list of dependencies needs to be updated.
>> 
>> The initial list of dependencies was made for Ubuntu/Debian, and the
>> packages were translated for the other distros using pkgs.org.
>> 
>> Add them separately from the rest of the dependencies as they pull a
>> _lot_ of additional dependencies (for LaTeX).
>> 
>> Notes:
>> - Fedora/OpenSUSE do not have the "lang-all" texlive collection, so
>>    install all available languages.
>> - AlmaLinux does not seem to provide texlive-collection-fontsextra,
>>    texlive-collection-lang*, and texlive-collection-latexextra, so add a
>>    warning about that.
>> 
>> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
>> ---
>>   documentation/poky.yaml.in                       | 47 +++++++++++++++++++++++-
>>   documentation/ref-manual/system-requirements.rst | 27 ++++++++++++++
>>   2 files changed, 73 insertions(+), 1 deletion(-)
>> 
>> diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
>> index 94849acf9942c7ebddb2ac7f8aaf5eb9d87e0c5b..25385068679a51e0f2e9e516b02b62e19e126291 100644
>> --- a/documentation/poky.yaml.in
>> +++ b/documentation/poky.yaml.in
>> @@ -67,8 +67,17 @@ UBUNTU_DEBIAN_HOST_PACKAGES_DOC: >-
>>     python3-saneyaml
>>     python3-sphinx-rtd-theme
>>     sphinx
>> -  texlive-latex-extra
>>   
>> +UBUNTU_DEBIAN_HOST_PACKAGES_DOC_PDF: >-
>> +  fonts-freefont-otf
>> +  latexmk
>> +  tex-gyre
>> +  texlive-fonts-extra
>> +  texlive-fonts-recommended
>> +  texlive-lang-all
>> +  texlive-latex-extra
>> +  texlive-latex-recommended
>> +  texlive-xetex
>>   
>>   FEDORA_HOST_PACKAGES_ESSENTIAL: >-
>>     bzip2
>> @@ -129,6 +138,19 @@ FEDORA_HOST_PACKAGES_DOC: >-
>>     texlive-latex-extra
>>     which
>>   
>> +FEDORA_HOST_PACKAGES_DOC_PDF: >-
>> +  latexmk
>> +  texlive-collection-fontsextra
>> +  texlive-collection-fontsrecommended
>> +  texlive-collection-lang*
>
> Please use single quotes to surround texlive-collection-lang* otherwise 
> it may be interpreted by the shell, c.f. for me:
>
> ```sh
> $ sudo dnf install texlive-collection-lang*
> zsh: no matches found: libgpiod*
> ```
>
> while `sudo dnf install 'texlive-collection-lang*'` works just fine.
>
> Ditto for the other occurrences later in this diff.

So I had issues with this in the container scripts, which is why I left it at
that. I initially single quoted this but it didn't work. Are you sure you can
mix non-quotes and quoted strings here? I'll give a try, might be specific to
the dockerfile.

Thanks,
Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [docs] [yocto-docs PATCH v2 2/6] poky.yaml.in: replace inkscape dependency by librsvg2-bin

[Antonin Godard]

Hi Quentin,

On Fri Dec 6, 2024 at 2:56 PM CET, Quentin Schulz via lists.yoctoproject.org wrote:
> Hi Antonin,
>
> On 12/4/24 1:23 PM, Antonin Godard wrote:
>> inkscape used to be a requirement to convert SVG images to PNGs/PDFs,
>> but we replaced it recently by rsvg-convert.
>> 
>> Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>
>> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
>
> I would recommend to order the commits differently.
>
> I believe patch 1/6 and 6/6 can be backported to earlier releases. But 
> by having 2/6 modify the same part of the code, it is possible that 6/6 
> won't cleanly apply when backporting. If we were to reorder the patches 
> and have 6/6 before 2/6, this should not happen.
>
> It's anyway you that would experience the pain of backporting and 
> resolving conflicts, if there's any, so up to you :)

True, true! Thanks for thinking about this, I'll re-order. :)


Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [docs] [yocto-docs PATCH v2 5/6] system-requirements.rst: add dependencies for pdf builds

[Quentin Schulz]

Hi Antonin,

On 12/9/24 6:02 PM, Antonin Godard via lists.yoctoproject.org wrote:
> Hi Quentin,
> 
> On Fri Dec 6, 2024 at 3:00 PM CET, Quentin Schulz wrote:
>> Hi Antonin,
>>
>> On 12/4/24 1:23 PM, Antonin Godard wrote:
>>> With the recent changes from commit
>>> bd6265ca323fac547a197bb516dc4a9ef3897508 ("doc: Makefile: add support
>>> for xelatex"), the list of dependencies needs to be updated.
>>>
>>> The initial list of dependencies was made for Ubuntu/Debian, and the
>>> packages were translated for the other distros using pkgs.org.
>>>
>>> Add them separately from the rest of the dependencies as they pull a
>>> _lot_ of additional dependencies (for LaTeX).
>>>
>>> Notes:
>>> - Fedora/OpenSUSE do not have the "lang-all" texlive collection, so
>>>     install all available languages.
>>> - AlmaLinux does not seem to provide texlive-collection-fontsextra,
>>>     texlive-collection-lang*, and texlive-collection-latexextra, so add a
>>>     warning about that.
>>>
>>> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
>>> ---
>>>    documentation/poky.yaml.in                       | 47 +++++++++++++++++++++++-
>>>    documentation/ref-manual/system-requirements.rst | 27 ++++++++++++++
>>>    2 files changed, 73 insertions(+), 1 deletion(-)
>>>
>>> diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
>>> index 94849acf9942c7ebddb2ac7f8aaf5eb9d87e0c5b..25385068679a51e0f2e9e516b02b62e19e126291 100644
>>> --- a/documentation/poky.yaml.in
>>> +++ b/documentation/poky.yaml.in
>>> @@ -67,8 +67,17 @@ UBUNTU_DEBIAN_HOST_PACKAGES_DOC: >-
>>>      python3-saneyaml
>>>      python3-sphinx-rtd-theme
>>>      sphinx
>>> -  texlive-latex-extra
>>>    
>>> +UBUNTU_DEBIAN_HOST_PACKAGES_DOC_PDF: >-
>>> +  fonts-freefont-otf
>>> +  latexmk
>>> +  tex-gyre
>>> +  texlive-fonts-extra
>>> +  texlive-fonts-recommended
>>> +  texlive-lang-all
>>> +  texlive-latex-extra
>>> +  texlive-latex-recommended
>>> +  texlive-xetex
>>>    
>>>    FEDORA_HOST_PACKAGES_ESSENTIAL: >-
>>>      bzip2
>>> @@ -129,6 +138,19 @@ FEDORA_HOST_PACKAGES_DOC: >-
>>>      texlive-latex-extra
>>>      which
>>>    
>>> +FEDORA_HOST_PACKAGES_DOC_PDF: >-
>>> +  latexmk
>>> +  texlive-collection-fontsextra
>>> +  texlive-collection-fontsrecommended
>>> +  texlive-collection-lang*
>>
>> Please use single quotes to surround texlive-collection-lang* otherwise
>> it may be interpreted by the shell, c.f. for me:
>>
>> ```sh
>> $ sudo dnf install texlive-collection-lang*
>> zsh: no matches found: libgpiod*
>> ```
>>
>> while `sudo dnf install 'texlive-collection-lang*'` works just fine.
>>
>> Ditto for the other occurrences later in this diff.
> 
> So I had issues with this in the container scripts, which is why I left it at
> that. I initially single quoted this but it didn't work. Are you sure you can

Can you tell us more about those issues with some error value/messages 
or something?

> mix non-quotes and quoted strings here? I'll give a try, might be specific to
> the dockerfile.
> 

"""
$ sudo dnf install 'texlive-collection-lang*' latexmk
Updating and loading repositories:
Repositories loaded.
Package "texlive-collection-langarabic-11:svn59594-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langchinese-11:svn63995-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langcjk-11:svn65824-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langcyrillic-11:svn54074-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langczechslovak-11:svn54074-73.fc41.noarch" 
is already installed.
Package "texlive-collection-langenglish-11:svn65496-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langeuropean-11:svn66432-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langfrench-11:svn63147-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langgerman-11:svn55706-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langgreek-11:svn65038-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langitalian-11:svn55129-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langjapanese-11:svn64603-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langkorean-11:svn54074-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langother-11:svn59564-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langpolish-11:svn54074-73.fc41.noarch" is 
already installed.
Package "texlive-collection-langportuguese-11:svn54074-73.fc41.noarch" 
is already installed.
Package "texlive-collection-langspanish-11:svn54141-73.fc41.noarch" is 
already installed.
Package "latexmk-4.85-2.fc41.noarch" is already installed.

Nothing to do.
"""

Same for latexmk first in the list.

That's for DNF5 (fedora 41 and later).

DNF4 seems to be happy in a fedora 40 container as well:

"""
[root@6f0bdf8b38f2 /]# dnf install latexmk 'texlive-collection-lang*'
Last metadata expiration check: 0:00:54 ago on Mon Dec  9 17:13:01 2024.
Dependencies resolved.
==============================================================================================
  Package                                 Arch   Version 
         Repo     Size
==============================================================================================
Installing:
  latexmk                                 noarch 4.85-1.fc40 
         updates 454 k
  texlive-collection-langarabic           noarch 11:svn59594-71.fc40 
         fedora  9.7 k
  texlive-collection-langchinese          noarch 11:svn63995-71.fc40 
         fedora   10 k
  texlive-collection-langcjk              noarch 11:svn65824-71.fc40 
         fedora  9.8 k
  texlive-collection-langcyrillic         noarch 11:svn54074-71.fc40 
         fedora   10 k
  texlive-collection-langczechslovak      noarch 11:svn54074-71.fc40 
         fedora  9.4 k
  texlive-collection-langenglish          noarch 11:svn65496-71.fc40 
         fedora   11 k
  texlive-collection-langeuropean         noarch 11:svn66432-71.fc40 
         fedora   11 k
  texlive-collection-langfrench           noarch 11:svn63147-71.fc40 
         fedora   10 k
  texlive-collection-langgerman           noarch 11:svn55706-71.fc40 
         fedora   10 k
  texlive-collection-langgreek            noarch 11:svn65038-71.fc40 
         fedora  9.6 k
  texlive-collection-langitalian          noarch 11:svn55129-71.fc40 
         fedora  9.6 k
  texlive-collection-langjapanese         noarch 11:svn64603-71.fc40 
         fedora   11 k
  texlive-collection-langkorean           noarch 11:svn54074-71.fc40 
         fedora  9.4 k
  texlive-collection-langother            noarch 11:svn59564-71.fc40 
         fedora   11 k
  texlive-collection-langpolish           noarch 11:svn54074-71.fc40 
         fedora  9.5 k
  texlive-collection-langportuguese       noarch 11:svn54074-71.fc40 
         fedora  9.4 k
  texlive-collection-langspanish          noarch 11:svn54141-71.fc40 
         fedora  9.4 k
[...]
"""

and the other way around:

"""
[root@6f0bdf8b38f2 /]# dnf install 'texlive-collection-lang*' latexmk
Last metadata expiration check: 0:00:09 ago on Mon Dec  9 17:13:01 2024.
Dependencies resolved.
==============================================================================================
  Package                                 Arch   Version 
         Repo     Size
==============================================================================================
Installing:
  latexmk                                 noarch 4.85-1.fc40 
         updates 454 k
  texlive-collection-langarabic           noarch 11:svn59594-71.fc40 
         fedora  9.7 k
  texlive-collection-langchinese          noarch 11:svn63995-71.fc40 
         fedora   10 k
  texlive-collection-langcjk              noarch 11:svn65824-71.fc40 
         fedora  9.8 k
  texlive-collection-langcyrillic         noarch 11:svn54074-71.fc40 
         fedora   10 k
  texlive-collection-langczechslovak      noarch 11:svn54074-71.fc40 
         fedora  9.4 k
  texlive-collection-langenglish          noarch 11:svn65496-71.fc40 
         fedora   11 k
  texlive-collection-langeuropean         noarch 11:svn66432-71.fc40 
         fedora   11 k
  texlive-collection-langfrench           noarch 11:svn63147-71.fc40 
         fedora   10 k
  texlive-collection-langgerman           noarch 11:svn55706-71.fc40 
         fedora   10 k
  texlive-collection-langgreek            noarch 11:svn65038-71.fc40 
         fedora  9.6 k
  texlive-collection-langitalian          noarch 11:svn55129-71.fc40 
         fedora  9.6 k
  texlive-collection-langjapanese         noarch 11:svn64603-71.fc40 
         fedora   11 k
  texlive-collection-langkorean           noarch 11:svn54074-71.fc40 
         fedora  9.4 k
  texlive-collection-langother            noarch 11:svn59564-71.fc40 
         fedora   11 k
  texlive-collection-langpolish           noarch 11:svn54074-71.fc40 
         fedora  9.5 k
  texlive-collection-langportuguese       noarch 11:svn54074-71.fc40 
         fedora  9.4 k
  texlive-collection-langspanish          noarch 11:svn54141-71.fc40 
         fedora  9.4 k
[...]
"""

Cheers,
Quentin

Re: [yocto-docs PATCH v2 1/6] Gather dependencies in poky.yaml.in

[Quentin Schulz]

Hi Antonin,

On 12/9/24 6:02 PM, Antonin Godard wrote:
> Hi Quentin,
> 
> On Fri Dec 6, 2024 at 2:51 PM CET, Quentin Schulz wrote:
> [...]
>>> +FEDORA_HOST_PACKAGES_ESSENTIAL: >-
>>> +  bzip2
>>> +  ccache
>>
>> I'm wondering if this is really required?
> 
> I'm not sure either. For now, this series focuses on updating the dependencies
> for the recent PDF additions. Optimizing this list will require more work, and
> is related to an open bug on bugzilla
> (https://bugzilla.yoctoproject.org/show_bug.cgi?id=14873).
> 
> I'm trying to get a clean base and a helper container script in to make this
> easier for me and others to do this (adding/removing things from the list).
> 
> But I will definitely go back to your comments as you are indeed pointing out
> things that might be unneeded now, indeed.
> 

Not a blocker for this patch (or series), one thing at a time :) Just 
wanted to raise this as I went through the list and it seemed odd to me.

Cheers,
Quentin

Re: [docs] [yocto-docs PATCH v2 5/6] system-requirements.rst: add dependencies for pdf builds

[Antonin Godard]

Hi Quentin,

On Mon Dec 9, 2024 at 6:28 PM CET, Quentin Schulz wrote:
[...]
>>>> +FEDORA_HOST_PACKAGES_DOC_PDF: >-
>>>> +  latexmk
>>>> +  texlive-collection-fontsextra
>>>> +  texlive-collection-fontsrecommended
>>>> +  texlive-collection-lang*
>>>
>>> Please use single quotes to surround texlive-collection-lang* otherwise
>>> it may be interpreted by the shell, c.f. for me:
>>>
>>> ```sh
>>> $ sudo dnf install texlive-collection-lang*
>>> zsh: no matches found: libgpiod*
>>> ```
>>>
>>> while `sudo dnf install 'texlive-collection-lang*'` works just fine.
>>>
>>> Ditto for the other occurrences later in this diff.
>> 
>> So I had issues with this in the container scripts, which is why I left it at
>> that. I initially single quoted this but it didn't work. Are you sure you can
>
> Can you tell us more about those issues with some error value/messages 
> or something?
>
>> mix non-quotes and quoted strings here? I'll give a try, might be specific to
>> the dockerfile.
>> 
>
> """
> $ sudo dnf install 'texlive-collection-lang*' latexmk
> Updating and loading repositories:
> Repositories loaded.
> Package "texlive-collection-langarabic-11:svn59594-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langchinese-11:svn63995-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langcjk-11:svn65824-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langcyrillic-11:svn54074-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langczechslovak-11:svn54074-73.fc41.noarch" 
> is already installed.
> Package "texlive-collection-langenglish-11:svn65496-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langeuropean-11:svn66432-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langfrench-11:svn63147-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langgerman-11:svn55706-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langgreek-11:svn65038-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langitalian-11:svn55129-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langjapanese-11:svn64603-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langkorean-11:svn54074-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langother-11:svn59564-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langpolish-11:svn54074-73.fc41.noarch" is 
> already installed.
> Package "texlive-collection-langportuguese-11:svn54074-73.fc41.noarch" 
> is already installed.
> Package "texlive-collection-langspanish-11:svn54141-73.fc41.noarch" is 
> already installed.
> Package "latexmk-4.85-2.fc41.noarch" is already installed.
>
> Nothing to do.
> """
>
> Same for latexmk first in the list.
>
> That's for DNF5 (fedora 41 and later).
>
> DNF4 seems to be happy in a fedora 40 container as well:
>
> """
> [root@6f0bdf8b38f2 /]# dnf install latexmk 'texlive-collection-lang*'
> Last metadata expiration check: 0:00:54 ago on Mon Dec  9 17:13:01 2024.
> Dependencies resolved.
> ==============================================================================================
>   Package                                 Arch   Version 
>          Repo     Size
> ==============================================================================================
> Installing:
>   latexmk                                 noarch 4.85-1.fc40 
>          updates 454 k
>   texlive-collection-langarabic           noarch 11:svn59594-71.fc40 
>          fedora  9.7 k
>   texlive-collection-langchinese          noarch 11:svn63995-71.fc40 
>          fedora   10 k
>   texlive-collection-langcjk              noarch 11:svn65824-71.fc40 
>          fedora  9.8 k
>   texlive-collection-langcyrillic         noarch 11:svn54074-71.fc40 
>          fedora   10 k
>   texlive-collection-langczechslovak      noarch 11:svn54074-71.fc40 
>          fedora  9.4 k
>   texlive-collection-langenglish          noarch 11:svn65496-71.fc40 
>          fedora   11 k
>   texlive-collection-langeuropean         noarch 11:svn66432-71.fc40 
>          fedora   11 k
>   texlive-collection-langfrench           noarch 11:svn63147-71.fc40 
>          fedora   10 k
>   texlive-collection-langgerman           noarch 11:svn55706-71.fc40 
>          fedora   10 k
>   texlive-collection-langgreek            noarch 11:svn65038-71.fc40 
>          fedora  9.6 k
>   texlive-collection-langitalian          noarch 11:svn55129-71.fc40 
>          fedora  9.6 k
>   texlive-collection-langjapanese         noarch 11:svn64603-71.fc40 
>          fedora   11 k
>   texlive-collection-langkorean           noarch 11:svn54074-71.fc40 
>          fedora  9.4 k
>   texlive-collection-langother            noarch 11:svn59564-71.fc40 
>          fedora   11 k
>   texlive-collection-langpolish           noarch 11:svn54074-71.fc40 
>          fedora  9.5 k
>   texlive-collection-langportuguese       noarch 11:svn54074-71.fc40 
>          fedora  9.4 k
>   texlive-collection-langspanish          noarch 11:svn54141-71.fc40 
>          fedora  9.4 k
> [...]
> """
>
> and the other way around:
>
> """
> [root@6f0bdf8b38f2 /]# dnf install 'texlive-collection-lang*' latexmk
> Last metadata expiration check: 0:00:09 ago on Mon Dec  9 17:13:01 2024.
> Dependencies resolved.
> ==============================================================================================
>   Package                                 Arch   Version 
>          Repo     Size
> ==============================================================================================
> Installing:
>   latexmk                                 noarch 4.85-1.fc40 
>          updates 454 k
>   texlive-collection-langarabic           noarch 11:svn59594-71.fc40 
>          fedora  9.7 k
>   texlive-collection-langchinese          noarch 11:svn63995-71.fc40 
>          fedora   10 k
>   texlive-collection-langcjk              noarch 11:svn65824-71.fc40 
>          fedora  9.8 k
>   texlive-collection-langcyrillic         noarch 11:svn54074-71.fc40 
>          fedora   10 k
>   texlive-collection-langczechslovak      noarch 11:svn54074-71.fc40 
>          fedora  9.4 k
>   texlive-collection-langenglish          noarch 11:svn65496-71.fc40 
>          fedora   11 k
>   texlive-collection-langeuropean         noarch 11:svn66432-71.fc40 
>          fedora   11 k
>   texlive-collection-langfrench           noarch 11:svn63147-71.fc40 
>          fedora   10 k
>   texlive-collection-langgerman           noarch 11:svn55706-71.fc40 
>          fedora   10 k
>   texlive-collection-langgreek            noarch 11:svn65038-71.fc40 
>          fedora  9.6 k
>   texlive-collection-langitalian          noarch 11:svn55129-71.fc40 
>          fedora  9.6 k
>   texlive-collection-langjapanese         noarch 11:svn64603-71.fc40 
>          fedora   11 k
>   texlive-collection-langkorean           noarch 11:svn54074-71.fc40 
>          fedora  9.4 k
>   texlive-collection-langother            noarch 11:svn59564-71.fc40 
>          fedora   11 k
>   texlive-collection-langpolish           noarch 11:svn54074-71.fc40 
>          fedora  9.5 k
>   texlive-collection-langportuguese       noarch 11:svn54074-71.fc40 
>          fedora  9.4 k
>   texlive-collection-langspanish          noarch 11:svn54141-71.fc40 
>          fedora  9.4 k
> [...]
> """
>
> Cheers,
> Quentin

Thanks for taking the time to test this. I guess this works for most shells, but
in the context of a Dockerfile I hit this error:

  10.39 No match for argument: 'texlive-collection-lang*'
  10.45 Error: Unable to find a match: 'texlive-collection-lang*'

You can reproduce this by running:

  $ echo "'texlive-collection-lang*'" > /tmp/deps
  $ sudo dnf install $(cat /tmp/deps)

I was able use this instead:

  xargs -a /tmp/deps sudo dnf install

I'll use this instead in Fedora and others. xargs is installed by default in
base Ubuntu/Debian/Fedora containers.


Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [yocto-docs PATCH v2 1/6] Gather dependencies in poky.yaml.in

[Antonin Godard]

Hi Quentin,

On Fri Dec 6, 2024 at 2:51 PM CET, Quentin Schulz wrote:
[...]
>> +ALMALINUX_HOST_PACKAGES_ESSENTIAL: >-
>> +  bzip2
>> +  ccache
>
> This is aligned with Fedora but I'm still wondering if it actually is a 
> requirement (well, if you INHERIT ccache, yes).
>
>> +  chrpath
>> +  cpio
>> +  cpp
>> +  diffstat
>> +  diffutils
>> +  gawk
>> +  gcc
>> +  gcc-c++
>> +  git
>> +  glibc-devel
>> +  glibc-langpack-en
>> +  gzip
>
> The original list had "install" but it's gone here, on purpose?

I don't think it did actually. I see the "yum install" and "dnf install"
commands but not the "install" package.


Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [yocto-docs PATCH v2 1/6] Gather dependencies in poky.yaml.in

[Quentin Schulz]

Hi Antonin,

On 12/10/24 10:58 AM, Antonin Godard wrote:
> Hi Quentin,
> 
> On Fri Dec 6, 2024 at 2:51 PM CET, Quentin Schulz wrote:
> [...]
>>> +ALMALINUX_HOST_PACKAGES_ESSENTIAL: >-
>>> +  bzip2
>>> +  ccache
>>
>> This is aligned with Fedora but I'm still wondering if it actually is a
>> requirement (well, if you INHERIT ccache, yes).
>>
>>> +  chrpath
>>> +  cpio
>>> +  cpp
>>> +  diffstat
>>> +  diffutils
>>> +  gawk
>>> +  gcc
>>> +  gcc-c++
>>> +  git
>>> +  glibc-devel
>>> +  glibc-langpack-en
>>> +  gzip
>>
>> The original list had "install" but it's gone here, on purpose?
> 
> I don't think it did actually. I see the "yum install" and "dnf install"
> commands but not the "install" package.
> 

Overeager mouse selection I did to extract the package names from the 
list and sort them I guess :)

Yes, doesn't seem to appear in the list today either. Sorry for the noise.

Cheers,
Quentin

Re: [docs] [yocto-docs PATCH v2 5/6] system-requirements.rst: add dependencies for pdf builds

[Quentin Schulz]

Hi Antonin,

On 12/10/24 10:33 AM, Antonin Godard wrote:
> Hi Quentin,
> 
> On Mon Dec 9, 2024 at 6:28 PM CET, Quentin Schulz wrote:
> [...]
>>>>> +FEDORA_HOST_PACKAGES_DOC_PDF: >-
>>>>> +  latexmk
>>>>> +  texlive-collection-fontsextra
>>>>> +  texlive-collection-fontsrecommended
>>>>> +  texlive-collection-lang*
>>>>
>>>> Please use single quotes to surround texlive-collection-lang* otherwise
>>>> it may be interpreted by the shell, c.f. for me:
>>>>
>>>> ```sh
>>>> $ sudo dnf install texlive-collection-lang*
>>>> zsh: no matches found: libgpiod*
>>>> ```
>>>>
>>>> while `sudo dnf install 'texlive-collection-lang*'` works just fine.
>>>>
>>>> Ditto for the other occurrences later in this diff.
>>>
>>> So I had issues with this in the container scripts, which is why I left it at
>>> that. I initially single quoted this but it didn't work. Are you sure you can
>>
>> Can you tell us more about those issues with some error value/messages
>> or something?
>>
>>> mix non-quotes and quoted strings here? I'll give a try, might be specific to
>>> the dockerfile.
>>>
>>
>> """
>> $ sudo dnf install 'texlive-collection-lang*' latexmk
>> Updating and loading repositories:
>> Repositories loaded.
>> Package "texlive-collection-langarabic-11:svn59594-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langchinese-11:svn63995-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langcjk-11:svn65824-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langcyrillic-11:svn54074-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langczechslovak-11:svn54074-73.fc41.noarch"
>> is already installed.
>> Package "texlive-collection-langenglish-11:svn65496-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langeuropean-11:svn66432-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langfrench-11:svn63147-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langgerman-11:svn55706-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langgreek-11:svn65038-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langitalian-11:svn55129-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langjapanese-11:svn64603-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langkorean-11:svn54074-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langother-11:svn59564-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langpolish-11:svn54074-73.fc41.noarch" is
>> already installed.
>> Package "texlive-collection-langportuguese-11:svn54074-73.fc41.noarch"
>> is already installed.
>> Package "texlive-collection-langspanish-11:svn54141-73.fc41.noarch" is
>> already installed.
>> Package "latexmk-4.85-2.fc41.noarch" is already installed.
>>
>> Nothing to do.
>> """
>>
>> Same for latexmk first in the list.
>>
>> That's for DNF5 (fedora 41 and later).
>>
>> DNF4 seems to be happy in a fedora 40 container as well:
>>
>> """
>> [root@6f0bdf8b38f2 /]# dnf install latexmk 'texlive-collection-lang*'
>> Last metadata expiration check: 0:00:54 ago on Mon Dec  9 17:13:01 2024.
>> Dependencies resolved.
>> ==============================================================================================
>>    Package                                 Arch   Version
>>           Repo     Size
>> ==============================================================================================
>> Installing:
>>    latexmk                                 noarch 4.85-1.fc40
>>           updates 454 k
>>    texlive-collection-langarabic           noarch 11:svn59594-71.fc40
>>           fedora  9.7 k
>>    texlive-collection-langchinese          noarch 11:svn63995-71.fc40
>>           fedora   10 k
>>    texlive-collection-langcjk              noarch 11:svn65824-71.fc40
>>           fedora  9.8 k
>>    texlive-collection-langcyrillic         noarch 11:svn54074-71.fc40
>>           fedora   10 k
>>    texlive-collection-langczechslovak      noarch 11:svn54074-71.fc40
>>           fedora  9.4 k
>>    texlive-collection-langenglish          noarch 11:svn65496-71.fc40
>>           fedora   11 k
>>    texlive-collection-langeuropean         noarch 11:svn66432-71.fc40
>>           fedora   11 k
>>    texlive-collection-langfrench           noarch 11:svn63147-71.fc40
>>           fedora   10 k
>>    texlive-collection-langgerman           noarch 11:svn55706-71.fc40
>>           fedora   10 k
>>    texlive-collection-langgreek            noarch 11:svn65038-71.fc40
>>           fedora  9.6 k
>>    texlive-collection-langitalian          noarch 11:svn55129-71.fc40
>>           fedora  9.6 k
>>    texlive-collection-langjapanese         noarch 11:svn64603-71.fc40
>>           fedora   11 k
>>    texlive-collection-langkorean           noarch 11:svn54074-71.fc40
>>           fedora  9.4 k
>>    texlive-collection-langother            noarch 11:svn59564-71.fc40
>>           fedora   11 k
>>    texlive-collection-langpolish           noarch 11:svn54074-71.fc40
>>           fedora  9.5 k
>>    texlive-collection-langportuguese       noarch 11:svn54074-71.fc40
>>           fedora  9.4 k
>>    texlive-collection-langspanish          noarch 11:svn54141-71.fc40
>>           fedora  9.4 k
>> [...]
>> """
>>
>> and the other way around:
>>
>> """
>> [root@6f0bdf8b38f2 /]# dnf install 'texlive-collection-lang*' latexmk
>> Last metadata expiration check: 0:00:09 ago on Mon Dec  9 17:13:01 2024.
>> Dependencies resolved.
>> ==============================================================================================
>>    Package                                 Arch   Version
>>           Repo     Size
>> ==============================================================================================
>> Installing:
>>    latexmk                                 noarch 4.85-1.fc40
>>           updates 454 k
>>    texlive-collection-langarabic           noarch 11:svn59594-71.fc40
>>           fedora  9.7 k
>>    texlive-collection-langchinese          noarch 11:svn63995-71.fc40
>>           fedora   10 k
>>    texlive-collection-langcjk              noarch 11:svn65824-71.fc40
>>           fedora  9.8 k
>>    texlive-collection-langcyrillic         noarch 11:svn54074-71.fc40
>>           fedora   10 k
>>    texlive-collection-langczechslovak      noarch 11:svn54074-71.fc40
>>           fedora  9.4 k
>>    texlive-collection-langenglish          noarch 11:svn65496-71.fc40
>>           fedora   11 k
>>    texlive-collection-langeuropean         noarch 11:svn66432-71.fc40
>>           fedora   11 k
>>    texlive-collection-langfrench           noarch 11:svn63147-71.fc40
>>           fedora   10 k
>>    texlive-collection-langgerman           noarch 11:svn55706-71.fc40
>>           fedora   10 k
>>    texlive-collection-langgreek            noarch 11:svn65038-71.fc40
>>           fedora  9.6 k
>>    texlive-collection-langitalian          noarch 11:svn55129-71.fc40
>>           fedora  9.6 k
>>    texlive-collection-langjapanese         noarch 11:svn64603-71.fc40
>>           fedora   11 k
>>    texlive-collection-langkorean           noarch 11:svn54074-71.fc40
>>           fedora  9.4 k
>>    texlive-collection-langother            noarch 11:svn59564-71.fc40
>>           fedora   11 k
>>    texlive-collection-langpolish           noarch 11:svn54074-71.fc40
>>           fedora  9.5 k
>>    texlive-collection-langportuguese       noarch 11:svn54074-71.fc40
>>           fedora  9.4 k
>>    texlive-collection-langspanish          noarch 11:svn54141-71.fc40
>>           fedora  9.4 k
>> [...]
>> """
>>
>> Cheers,
>> Quentin
> 
> Thanks for taking the time to test this. I guess this works for most shells, but
> in the context of a Dockerfile I hit this error:
> 
>    10.39 No match for argument: 'texlive-collection-lang*'
>    10.45 Error: Unable to find a match: 'texlive-collection-lang*'
> 
> You can reproduce this by running:
> 
>    $ echo "'texlive-collection-lang*'" > /tmp/deps
>    $ sudo dnf install $(cat /tmp/deps)
> 

OK. I guess this is because shell isn't parsing the line and just 
interpreting it directly, so it's passing 'texlive-collection-lang*' to 
dnf, whereas before it would pass texlive-collection-lang* because shell 
would parse and unquote the argument?

> I was able use this instead:
> 
>    xargs -a /tmp/deps sudo dnf install
> 
> I'll use this instead in Fedora and others. xargs is installed by default in
> base Ubuntu/Debian/Fedora containers.
> 

I still think storing the full instructions in separate scripts is a 
more maintainable and future-proof solution than this.

Cheers,
Quentin