Skip to contentSkip to conversation

ref-manual/system-requirements.rst: recommend buildtools for not supported distros

PATCH Superseded [email protected] 2 participants 3 messages Jan 5, 2023

v1 of 2 Superseded Latest is v2 →

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 ref-manual/system-requirements.rst: recommend buildtools for not supported distros

From: Michael Opdenacker <[email protected]>

Also minor correction to supported distribution notes

---
 documentation/ref-manual/system-requirements.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)
documentation/ref-manual/system-requirements.rst +6 -3
index 1f9b3b1b58..2bb813b385 100644
@@ -34,8 +34,7 @@ and conceptual information in the :doc:`/overview-manual/index`.
 Supported Linux Distributions
 =============================
 
-Currently, the Yocto Project is supported on the following
-distributions:
+Currently, the Yocto Project is supported on the following distributions:
 
 -  Ubuntu 18.04 (LTS)
 
@@ -71,7 +70,11 @@ distributions:
       has no plans to support rolling-releases or development
       distributions due to their constantly changing nature. We welcome
       patches and bug reports, but keep in mind that our priority is on
-      the supported platforms listed below.
+      the supported platforms listed above.
+
+   -  If your Linux distribution is not in the above list, we recommend to
+      get the :term:`buildtools` or :term:`buildtools-extended` tarballs
+      containing the host tools required by your Yocto Project release.
 
    -  You may use Windows Subsystem For Linux v2 to set up a build host
       using Windows 10 or later, or Windows Server 2019 or later, but validation
Signature · 1 line
2.37.2
#1 lore raw

Which is done by running scripts/install-buildtools and doing that has its own section in the same system-requirements.rst
:-) A simple reference to it should be enough.

Alex

Quoted 41 lines · On Thu, 5 Jan 2023 at 16:20, <[email protected]> wrote:

From: Michael Opdenacker <[email protected]>

Also minor correction to supported distribution notes

---
 documentation/ref-manual/system-requirements.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)
documentation/ref-manual/system-requirements.rst +6 -4
index 1f9b3b1b58..2bb813b385 100644
@@ -34,8 +34,7 @@ and conceptual information in the :doc:`/overview-manual/index`.
 Supported Linux Distributions
 =============================
 
-Currently, the Yocto Project is supported on the following
-distributions:
+Currently, the Yocto Project is supported on the following distributions:
 
 -  Ubuntu 18.04 (LTS)
 
@@ -71,7 +70,11 @@ distributions:
       has no plans to support rolling-releases or development
       distributions due to their constantly changing nature. We welcome
       patches and bug reports, but keep in mind that our priority is on
-      the supported platforms listed below.
+      the supported platforms listed above.
+
+   -  If your Linux distribution is not in the above list, we recommend to
+      get the :term:`buildtools` or :term:`buildtools-extended` tarballs
+      containing the host tools required by your Yocto Project release.
 
    -  You may use Windows Subsystem For Linux v2 to set up a build host
       using Windows 10 or later, or Windows Server 2019 or later, but validation
--

2.37.2

#2 lore raw
Quoted 5 lines · Alexander Kanavin

Which is done by running scripts/install-buildtools and doing that has its own section in the same system-requirements.rst
:-) A simple reference to it should be enough.

Alex

Right, I wanted to minimize the text (as the section is referred to in the description of "builttools"), but it's true a direct reference will help.

Thanks
Michael.

Signature · 3 lines
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com