diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in index c770318f2be76cca3ea23a25d819ace46d157b4c..4f4684be4bf7f95ff0263a01136f8ee5a30f1937 100644 --- a/documentation/poky.yaml.in +++ b/documentation/poky.yaml.in @@ -10,32 +10,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 - \n\ $ sudo locale-gen en_US.UTF-8" -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" diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst index 0fc92550a51ac62c39859acc63002ac065559e2a..0660d830ec2dc903fa4660a3ac62043661d955b1 100644 --- a/documentation/ref-manual/system-requirements.rst +++ b/documentation/ref-manual/system-requirements.rst @@ -148,9 +148,10 @@ Ubuntu and Debian ----------------- Here are the packages needed to build an image on a headless system -with a supported Ubuntu or Debian Linux distribution:: +with a supported Ubuntu or Debian Linux distribution: - $ sudo apt install &UBUNTU_HOST_PACKAGES_ESSENTIAL; + .. literalinclude:: ../tools/ubuntu_host_packages_essential.sh + :language: shell .. note:: @@ -162,45 +163,47 @@ with a supported Ubuntu or Debian Linux distribution:: $ sudo apt build-dep qemu $ sudo apt remove oss4-dev -Here are the packages needed to build Project documentation manuals:: +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 + .. literalinclude:: ../tools/ubuntu_host_packages_docs.sh + :language: shell Fedora Packages --------------- Here are the packages needed to build an image on a headless system -with a supported Fedora Linux distribution:: +with a supported Fedora Linux distribution: - $ sudo dnf install &FEDORA_HOST_PACKAGES_ESSENTIAL; + .. literalinclude:: ../tools/fedora_host_packages_essential.sh + :language: shell -Here are the packages needed to build Project documentation manuals:: +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; + .. literalinclude:: ../tools/fedora_host_packages_docs.sh + :language: shell openSUSE Packages ----------------- Here are the packages needed to build an image on a headless system -with a supported openSUSE distribution:: +with a supported openSUSE distribution: - $ sudo zypper install &OPENSUSE_HOST_PACKAGES_ESSENTIAL; + .. literalinclude:: ../tools/opensuse_host_packages_essential.sh + :language: shell -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; +Here are the packages needed to build Project documentation manuals: + .. literalinclude:: ../tools/opensuse_host_packages_docs.sh + :language: shell AlmaLinux Packages ------------------ Here are the packages needed to build an image on a headless system -with a supported AlmaLinux distribution:: +with a supported AlmaLinux distribution: - $ sudo dnf install &ALMALINUX_HOST_PACKAGES_ESSENTIAL; + .. literalinclude:: ../tools/almalinux_host_packages_essential.sh + :language: shell .. note:: @@ -215,10 +218,10 @@ with a supported AlmaLinux distribution:: - The ``makecache`` command consumes additional Metadata from ``epel-release``. -Here are the packages needed to build Project documentation manuals:: +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; + .. literalinclude:: ../tools/almalinux_host_packages_docs.sh + :language: shell .. _system-requirements-buildtools: diff --git a/documentation/tools/almalinux_host_packages_docs.sh b/documentation/tools/almalinux_host_packages_docs.sh new file mode 100644 index 0000000000000000000000000000000000000000..93ed34ce01d803e85c67e01f75dc82ed53d864f0 --- /dev/null +++ b/documentation/tools/almalinux_host_packages_docs.sh @@ -0,0 +1,2 @@ +sudo dnf install git make python3-pip which inkscape texlive-fncychap +sudo pip3 install sphinx sphinx_rtd_theme pyyaml diff --git a/documentation/tools/almalinux_host_packages_essential.sh b/documentation/tools/almalinux_host_packages_essential.sh new file mode 100644 index 0000000000000000000000000000000000000000..d2c5168e0bb53bfe14785b2f36220917ac55282e --- /dev/null +++ b/documentation/tools/almalinux_host_packages_essential.sh @@ -0,0 +1,5 @@ +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 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 diff --git a/documentation/tools/fedora_host_packages_docs.sh b/documentation/tools/fedora_host_packages_docs.sh new file mode 100644 index 0000000000000000000000000000000000000000..93ed34ce01d803e85c67e01f75dc82ed53d864f0 --- /dev/null +++ b/documentation/tools/fedora_host_packages_docs.sh @@ -0,0 +1,2 @@ +sudo dnf install git make python3-pip which inkscape texlive-fncychap +sudo pip3 install sphinx sphinx_rtd_theme pyyaml diff --git a/documentation/tools/fedora_host_packages_essential.sh b/documentation/tools/fedora_host_packages_essential.sh new file mode 100644 index 0000000000000000000000000000000000000000..448a6e5f1038838132603db0d993fb80eabf75ef --- /dev/null +++ b/documentation/tools/fedora_host_packages_essential.sh @@ -0,0 +1 @@ +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 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 diff --git a/documentation/tools/opensuse_host_packages_docs.sh b/documentation/tools/opensuse_host_packages_docs.sh new file mode 100644 index 0000000000000000000000000000000000000000..90f52d576451ee0a7c481b31b7605e4a870496cd --- /dev/null +++ b/documentation/tools/opensuse_host_packages_docs.sh @@ -0,0 +1,2 @@ +sudo zypper install git make python3-pip which inkscape texlive-fncychap +sudo pip3 install sphinx sphinx_rtd_theme pyyaml diff --git a/documentation/tools/opensuse_host_packages_essential.sh b/documentation/tools/opensuse_host_packages_essential.sh new file mode 100644 index 0000000000000000000000000000000000000000..ef24fcefd99c9ecc335c594965965bb36e43cd05 --- /dev/null +++ b/documentation/tools/opensuse_host_packages_essential.sh @@ -0,0 +1,2 @@ +sudo zypper install 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 +sudo pip3 install GitPython diff --git a/documentation/tools/ubuntu_host_packages_docs.sh b/documentation/tools/ubuntu_host_packages_docs.sh new file mode 100644 index 0000000000000000000000000000000000000000..1bfb256e34ba931784bcf97a60e211520c70a199 --- /dev/null +++ b/documentation/tools/ubuntu_host_packages_docs.sh @@ -0,0 +1,2 @@ +sudo apt install git make inkscape texlive-latex-extra +sudo apt install sphinx python3-saneyaml python3-sphinx-rtd-theme diff --git a/documentation/tools/ubuntu_host_packages_essential.sh b/documentation/tools/ubuntu_host_packages_essential.sh new file mode 100644 index 0000000000000000000000000000000000000000..5cab5b34068e3886fb2fb06ea66120a2ae12e3a3 --- /dev/null +++ b/documentation/tools/ubuntu_host_packages_essential.sh @@ -0,0 +1,2 @@ +sudo apt-get install 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 +sudo locale-gen en_US.UTF-8