mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-05-05 20:27:58 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: ref-manual: ref-system-requirements: update requirements to build Sphinx docs

Browse Source 
Tested with containers on all supported distributions.

Debian 8 (Jessie) still has Python3.4 and an old pip3, which makes it
impossible to build typing module which is a requirement of "new" Sphinx
python module.

One cannot update to latest pip3 from within pip in Jessie's version.
One cannot get a newer pip from upstream because newer pip don't support
Python3.4 anymore.
One cannot build with python3-sphinx package from Jessie because the
package is too old (1.2.3) and does not have sphinx.ext.autosectionlabel
module which appeared in 1.4 version.

(From yocto-docs rev: db2e97515636674a0b04d2fe3f35b433b49b6c0f)

Signed-off-by: Quentin Schulz <foss@0leil.net>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
(cherry picked from commit 14da565986a573ac7e0b5c5943e55b7b74f99dd5)
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Quentin Schulz
2020-10-04 15:12:40 +02:00
committed by Richard Purdie
parent ccb3a1db76
commit 4030fd0f3c
2 changed files with 17 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
documentation/poky.yaml
View File

@@ -86,3 +86,4 @@ 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 xterm \
rpcgen mesa-libGL-devel"
PIP3_HOST_PACKAGES_DOC : "$ sudo pip3 install sphinx sphinx_rtd_theme pyyaml"

24
documentation/ref-manual/ref-system-requirements.rst
View File

@@ -145,7 +145,14 @@ supported Ubuntu or Debian Linux distribution:
Yocto Project documentation manuals:
::
$ sudo apt-get install make xsltproc docbook-utils fop dblatex xmlto
$ sudo apt-get install make python3-pip
&PIP3_HOST_PACKAGES_DOC;
.. note::
It is currently not possible to build out documentation from Debian 8
(Jessie) because of outdated ``pip3`` and ``python3``. ``python3-sphinx``
is too outdated.
Fedora Packages
---------------
@@ -163,8 +170,8 @@ supported Fedora Linux distribution:
Yocto Project documentation manuals:
::
$ sudo dnf install docbook-style-dsssl docbook-style-xsl \
docbook-dtds docbook-utils fop libxslt dblatex xmlto
$ sudo dnf install make python3-pip which
&PIP3_HOST_PACKAGES_DOC;
openSUSE Packages
-----------------
@@ -182,7 +189,8 @@ supported openSUSE Linux distribution:
Yocto Project documentation manuals:
::
$ sudo zypper install dblatex xmlto
$ sudo zypper install make python3-pip which
&PIP3_HOST_PACKAGES_DOC;
CentOS-7 Packages
@@ -211,8 +219,8 @@ supported CentOS-7 Linux distribution:
Yocto Project documentation manuals:
::
$ sudo yum install docbook-style-dsssl docbook-style-xsl \
docbook-dtds docbook-utils fop libxslt dblatex xmlto
$ sudo yum install make python3-pip which
&PIP3_HOST_PACKAGES_DOC;
CentOS-8 Packages
-----------------
@@ -243,8 +251,8 @@ supported CentOS-8 Linux distribution:
Yocto Project documentation manuals:
::
$ sudo dnf install docbook-style-dsssl docbook-style-xsl \
docbook-dtds docbook-utils fop libxslt dblatex xmlto
$ sudo dnf install make python3-pip which
&PIP3_HOST_PACKAGES_DOC;
Required Git, tar, Python and gcc Versions
==========================================