[PATCH v2] Documentation: add pygments package for generating docs

[PATCH v2] Documentation: add pygments package for generating docs

[michael.opdenacker]

From: Michael Opdenacker <michael.opdenacker@bootlin.com>

To the packages required to build docs

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>

- Changes in V2:
  - Had "pygments" to PIP3_HOST_PACKAGES_DOC in documentation/poky.yaml.in too
---
 documentation/README       | 4 ++--
 documentation/poky.yaml.in | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/documentation/README b/documentation/README
index e8aed86eb4..117f4be409 100644
--- a/documentation/README
+++ b/documentation/README
@@ -118,12 +118,12 @@ and of its required dependencies is to use the Python Package Index (pip).
 
 To install all required packages run:
 
- $ pip3 install sphinx sphinx_rtd_theme pyyaml
+ $ pip3 install sphinx sphinx_rtd_theme pyyaml pygments
 
 To make sure you always have the latest versions of such packages, you
 should regularly run the same command with an added "--upgrade" option:
 
- $ pip3 install --upgrade sphinx sphinx_rtd_theme pyyaml
+ $ pip3 install --upgrade sphinx sphinx_rtd_theme pyyaml pygments
 
 Also install the "inkscape" package from your distribution.
 Inkscape is need to convert SVG graphics to PNG (for EPUB
diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
index cdccf6f3ca..0f8b5c0139 100644
--- a/documentation/poky.yaml.in
+++ b/documentation/poky.yaml.in
@@ -40,7 +40,7 @@ CENTOS8_HOST_PACKAGES_ESSENTIAL : "-y epel-release
      socat perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue python3-pip \
      python3-GitPython python3-jinja2 python3-pexpect xz which SDL-devel \
      rpcgen mesa-libGL-devel zstd lz4"
-PIP3_HOST_PACKAGES_DOC : "$ sudo pip3 install sphinx sphinx_rtd_theme pyyaml"
+PIP3_HOST_PACKAGES_DOC : "$ sudo pip3 install sphinx sphinx_rtd_theme pyyaml pygments"
 MIN_PYTHON_VERSION : "3.8.0"
 MIN_TAR_VERSION : "1.28"
 MIN_GIT_VERSION : "1.8.3.1"
-- 
2.34.1

Re: [docs] [PATCH v2] Documentation: add pygments package for generating docs

[Michael Opdenacker]

On 14.03.23 at 10:54, Michael Opdenacker via lists.yoctoproject.org wrote:
> From: Michael Opdenacker <michael.opdenacker@bootlin.com>
>
> To the packages required to build docs
>
> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
>
> - Changes in V2:
>    - Had "pygments" to PIP3_HOST_PACKAGES_DOC in documentation/poky.yaml.in too


Forget about this change. Checking the package requirements again on a 
fresh Ubuntu 22.04 container, I found that this time "pygments"  didn't 
need installing. Indeed, " pip3 show sphinx" shows that it's a 
dependency of "sphinx".

I wonder why I had to add this yesterday.

Apologies for the noise.
Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com