diff options
| author | Michael Opdenacker <michael.opdenacker@bootlin.com> | 2022-06-14 20:18:12 +0200 |
|---|---|---|
| committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2022-06-21 20:57:17 +0100 |
| commit | f7f4444e36c34d495d86d819916c044bde07f0f9 (patch) | |
| tree | 149c2dc06f0c8e40df031c4869da77b3defbcfc1 /documentation | |
| parent | 50acfba977ea69e6e5f315d905bf584820d3bca1 (diff) | |
| download | poky-f7f4444e36c34d495d86d819916c044bde07f0f9.tar.gz | |
manuals: update host tool requirements
As enforced by meta/classes/sanity.bbclass:
- at least GNU make 4.0
- at least GNU tar 7.5 (instead of 5.0)
(From yocto-docs rev: 6480aa0f8338ef192c666b9445bc0baff47d9248)
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
| -rw-r--r-- | documentation/brief-yoctoprojectqs/index.rst | 3 | ||||
| -rw-r--r-- | documentation/dev-manual/start.rst | 6 | ||||
| -rw-r--r-- | documentation/migration-guides/migration-1.5.rst | 2 | ||||
| -rw-r--r-- | documentation/migration-guides/migration-1.7.rst | 2 | ||||
| -rw-r--r-- | documentation/migration-guides/migration-2.1.rst | 2 | ||||
| -rw-r--r-- | documentation/migration-guides/migration-3.3.rst | 2 | ||||
| -rw-r--r-- | documentation/poky.yaml.in | 3 | ||||
| -rw-r--r-- | documentation/ref-manual/faq.rst | 2 | ||||
| -rw-r--r-- | documentation/ref-manual/system-requirements.rst | 6 |
9 files changed, 17 insertions, 11 deletions
diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst index 7179f25022..4d5ac85e61 100644 --- a/documentation/brief-yoctoprojectqs/index.rst +++ b/documentation/brief-yoctoprojectqs/index.rst | |||
| @@ -64,11 +64,12 @@ following requirements: | |||
| 64 | - tar &MIN_TAR_VERSION; or greater | 64 | - tar &MIN_TAR_VERSION; or greater |
| 65 | - Python &MIN_PYTHON_VERSION; or greater. | 65 | - Python &MIN_PYTHON_VERSION; or greater. |
| 66 | - gcc &MIN_GCC_VERSION; or greater. | 66 | - gcc &MIN_GCC_VERSION; or greater. |
| 67 | - GNU make &MIN_MAKE_VERSION; or greater | ||
| 67 | 68 | ||
| 68 | If your build host does not meet any of these three listed version | 69 | If your build host does not meet any of these three listed version |
| 69 | requirements, you can take steps to prepare the system so that you | 70 | requirements, you can take steps to prepare the system so that you |
| 70 | can still use the Yocto Project. See the | 71 | can still use the Yocto Project. See the |
| 71 | :ref:`ref-manual/system-requirements:required git, tar, python and gcc versions` | 72 | :ref:`ref-manual/system-requirements:required git, tar, python, make and gcc versions` |
| 72 | section in the Yocto Project Reference Manual for information. | 73 | section in the Yocto Project Reference Manual for information. |
| 73 | 74 | ||
| 74 | Build Host Packages | 75 | Build Host Packages |
diff --git a/documentation/dev-manual/start.rst b/documentation/dev-manual/start.rst index 8cf3ebe316..499c3f8394 100644 --- a/documentation/dev-manual/start.rst +++ b/documentation/dev-manual/start.rst | |||
| @@ -311,7 +311,7 @@ Project Build Host: | |||
| 311 | 311 | ||
| 312 | 3. *Meet Minimal Version Requirements:* The OpenEmbedded build system | 312 | 3. *Meet Minimal Version Requirements:* The OpenEmbedded build system |
| 313 | should be able to run on any modern distribution that has the | 313 | should be able to run on any modern distribution that has the |
| 314 | following versions for Git, tar, Python and gcc. | 314 | following versions for Git, tar, Python, gcc and make. |
| 315 | 315 | ||
| 316 | - Git &MIN_GIT_VERSION; or greater | 316 | - Git &MIN_GIT_VERSION; or greater |
| 317 | 317 | ||
| @@ -321,10 +321,12 @@ Project Build Host: | |||
| 321 | 321 | ||
| 322 | - gcc &MIN_GCC_VERSION; or greater. | 322 | - gcc &MIN_GCC_VERSION; or greater. |
| 323 | 323 | ||
| 324 | - GNU make &MIN_MAKE_VERSION; or greater | ||
| 325 | |||
| 324 | If your build host does not meet any of these listed version | 326 | If your build host does not meet any of these listed version |
| 325 | requirements, you can take steps to prepare the system so that you | 327 | requirements, you can take steps to prepare the system so that you |
| 326 | can still use the Yocto Project. See the | 328 | can still use the Yocto Project. See the |
| 327 | ":ref:`ref-manual/system-requirements:required git, tar, python and gcc versions`" | 329 | ":ref:`ref-manual/system-requirements:required git, tar, python, make and gcc versions`" |
| 328 | section in the Yocto Project Reference Manual for information. | 330 | section in the Yocto Project Reference Manual for information. |
| 329 | 331 | ||
| 330 | 4. *Install Development Host Packages:* Required development host | 332 | 4. *Install Development Host Packages:* Required development host |
diff --git a/documentation/migration-guides/migration-1.5.rst b/documentation/migration-guides/migration-1.5.rst index 93db14c3ba..366fb006e8 100644 --- a/documentation/migration-guides/migration-1.5.rst +++ b/documentation/migration-guides/migration-1.5.rst | |||
| @@ -26,7 +26,7 @@ provide packages for these, you can install and use the Buildtools | |||
| 26 | tarball, which provides an SDK-like environment containing them. | 26 | tarball, which provides an SDK-like environment containing them. |
| 27 | 27 | ||
| 28 | For more information on this requirement, see the | 28 | For more information on this requirement, see the |
| 29 | ":ref:`ref-manual/system-requirements:required git, tar, python and gcc versions`" | 29 | ":ref:`ref-manual/system-requirements:required git, tar, python, make and gcc versions`" |
| 30 | section. | 30 | section. |
| 31 | 31 | ||
| 32 | .. _migration-1.5-atom-pc-bsp: | 32 | .. _migration-1.5-atom-pc-bsp: |
diff --git a/documentation/migration-guides/migration-1.7.rst b/documentation/migration-guides/migration-1.7.rst index 88a6855d50..8213ab58d9 100644 --- a/documentation/migration-guides/migration-1.7.rst +++ b/documentation/migration-guides/migration-1.7.rst | |||
| @@ -31,7 +31,7 @@ build host is now 1.7.8 because the ``--list`` option is now required by | |||
| 31 | BitBake's Git fetcher. As always, if your host distribution does not | 31 | BitBake's Git fetcher. As always, if your host distribution does not |
| 32 | provide a version of Git that meets this requirement, you can use the | 32 | provide a version of Git that meets this requirement, you can use the |
| 33 | ``buildtools-tarball`` that does. See the | 33 | ``buildtools-tarball`` that does. See the |
| 34 | ":ref:`ref-manual/system-requirements:required git, tar, python and gcc versions`" | 34 | ":ref:`ref-manual/system-requirements:required git, tar, python, make and gcc versions`" |
| 35 | section for more information. | 35 | section for more information. |
| 36 | 36 | ||
| 37 | .. _migration-1.7-autotools-class-changes: | 37 | .. _migration-1.7-autotools-class-changes: |
diff --git a/documentation/migration-guides/migration-2.1.rst b/documentation/migration-guides/migration-2.1.rst index ae6268d509..b2d8a0b678 100644 --- a/documentation/migration-guides/migration-2.1.rst +++ b/documentation/migration-guides/migration-2.1.rst | |||
| @@ -357,7 +357,7 @@ These additional changes exist: | |||
| 357 | - The minimum Git version has been increased to 1.8.3.1. If your host | 357 | - The minimum Git version has been increased to 1.8.3.1. If your host |
| 358 | distribution does not provide a sufficiently recent version, you can | 358 | distribution does not provide a sufficiently recent version, you can |
| 359 | install the buildtools, which will provide it. See the | 359 | install the buildtools, which will provide it. See the |
| 360 | :ref:`ref-manual/system-requirements:required git, tar, python and gcc versions` | 360 | :ref:`ref-manual/system-requirements:required git, tar, python, make and gcc versions` |
| 361 | section for more information on the buildtools tarball. | 361 | section for more information on the buildtools tarball. |
| 362 | 362 | ||
| 363 | - The buggy and incomplete support for the RPM version 4 package | 363 | - The buggy and incomplete support for the RPM version 4 package |
diff --git a/documentation/migration-guides/migration-3.3.rst b/documentation/migration-guides/migration-3.3.rst index 22562dacd4..d65f1c7b1f 100644 --- a/documentation/migration-guides/migration-3.3.rst +++ b/documentation/migration-guides/migration-3.3.rst | |||
| @@ -14,7 +14,7 @@ You will now need at least Python 3.6 installed on your build host. Most recent | |||
| 14 | distributions provide this, but should you be building on a distribution that | 14 | distributions provide this, but should you be building on a distribution that |
| 15 | does not have it, you can use the ``buildtools-tarball`` (easily installable | 15 | does not have it, you can use the ``buildtools-tarball`` (easily installable |
| 16 | using ``scripts/install-buildtools``) - see | 16 | using ``scripts/install-buildtools``) - see |
| 17 | :ref:`ref-manual/system-requirements:required git, tar, python and gcc versions` | 17 | :ref:`ref-manual/system-requirements:required git, tar, python, make and gcc versions` |
| 18 | for details. | 18 | for details. |
| 19 | 19 | ||
| 20 | 20 | ||
diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in index 1e1d6c83ed..6b942f0959 100644 --- a/documentation/poky.yaml.in +++ b/documentation/poky.yaml.in | |||
| @@ -44,4 +44,5 @@ PIP3_HOST_PACKAGES_DOC : "$ sudo pip3 install sphinx sphinx_rtd_theme pyyaml" | |||
| 44 | MIN_PYTHON_VERSION : "3.6.0" | 44 | MIN_PYTHON_VERSION : "3.6.0" |
| 45 | MIN_TAR_VERSION : "1.28" | 45 | MIN_TAR_VERSION : "1.28" |
| 46 | MIN_GIT_VERSION : "1.8.3.1" | 46 | MIN_GIT_VERSION : "1.8.3.1" |
| 47 | MIN_GCC_VERSION : "5.0" | 47 | MIN_GCC_VERSION : "7.5" |
| 48 | MIN_MAKE_VERSION : "4.0" | ||
diff --git a/documentation/ref-manual/faq.rst b/documentation/ref-manual/faq.rst index e06b5e6caa..3eee9e1be5 100644 --- a/documentation/ref-manual/faq.rst +++ b/documentation/ref-manual/faq.rst | |||
| @@ -22,7 +22,7 @@ Can I still use the Yocto Project? | |||
| 22 | **A:** You can get the required tools on your host development system a | 22 | **A:** You can get the required tools on your host development system a |
| 23 | couple different ways (i.e. building a tarball or downloading a | 23 | couple different ways (i.e. building a tarball or downloading a |
| 24 | tarball). See the | 24 | tarball). See the |
| 25 | ":ref:`ref-manual/system-requirements:required git, tar, python and gcc versions`" | 25 | ":ref:`ref-manual/system-requirements:required git, tar, python, make and gcc versions`" |
| 26 | section for steps on how to update your build tools. | 26 | section for steps on how to update your build tools. |
| 27 | 27 | ||
| 28 | **Q:** How can you claim Poky / OpenEmbedded-Core is stable? | 28 | **Q:** How can you claim Poky / OpenEmbedded-Core is stable? |
diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst index 04f9efaa23..6cf88f2a98 100644 --- a/documentation/ref-manual/system-requirements.rst +++ b/documentation/ref-manual/system-requirements.rst | |||
| @@ -234,8 +234,8 @@ supported CentOS-8 Linux distribution: | |||
| 234 | $ sudo dnf install make python3-pip which | 234 | $ sudo dnf install make python3-pip which |
| 235 | &PIP3_HOST_PACKAGES_DOC; | 235 | &PIP3_HOST_PACKAGES_DOC; |
| 236 | 236 | ||
| 237 | Required Git, tar, Python and gcc Versions | 237 | Required Git, tar, Python, make and gcc Versions |
| 238 | ========================================== | 238 | ================================================ |
| 239 | 239 | ||
| 240 | In order to use the build system, your host development system must meet | 240 | In order to use the build system, your host development system must meet |
| 241 | the following version requirements for Git, tar, and Python: | 241 | the following version requirements for Git, tar, and Python: |
| @@ -246,6 +246,8 @@ the following version requirements for Git, tar, and Python: | |||
| 246 | 246 | ||
| 247 | - Python &MIN_PYTHON_VERSION; or greater | 247 | - Python &MIN_PYTHON_VERSION; or greater |
| 248 | 248 | ||
| 249 | - GNU make &MIN_MAKE_VERSION; or greater | ||
| 250 | |||
| 249 | If your host development system does not meet all these requirements, | 251 | If your host development system does not meet all these requirements, |
| 250 | you can resolve this by installing a ``buildtools`` tarball that | 252 | you can resolve this by installing a ``buildtools`` tarball that |
| 251 | contains these tools. You can get the tarball one of two ways: download | 253 | contains these tools. You can get the tarball one of two ways: download |
