diff mbox series

[v2,2/2] ref-manual/system-requirements.rst: instruct to install a buildtools tarball

Message ID 20260420-python3-websockets-requirement-v2-2-a273a01a6f44@bootlin.com
State Superseded
Headers show
Series Updates to host requirements | expand

Commit Message

Antonin Godard April 20, 2026, 9:52 a.m. UTC
I noticed that openSUSE Leap 15.6 provide Python 3.6, which is not
supported by BitBake (which requires Python >3.9). Instruct to use a
buildtools tarball, which is how this is done on the Autobuilder.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/system-requirements.rst | 5 +++++
 1 file changed, 5 insertions(+)

Comments

Quentin Schulz April 20, 2026, 10:46 a.m. UTC | #1
Hi Antonin,

On 4/20/26 11:52 AM, Antonin Godard via lists.yoctoproject.org wrote:
> I noticed that openSUSE Leap 15.6 provide Python 3.6, which is not
> supported by BitBake (which requires Python >3.9). Instruct to use a
> buildtools tarball, which is how this is done on the Autobuilder.
> 
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
> ---
>   documentation/ref-manual/system-requirements.rst | 5 +++++
>   1 file changed, 5 insertions(+)
> 
> diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst
> index baa965573..85a26060c 100644
> --- a/documentation/ref-manual/system-requirements.rst
> +++ b/documentation/ref-manual/system-requirements.rst
> @@ -243,6 +243,11 @@ with a supported openSUSE Leap 15.6 distribution:
>   .. literalinclude:: ../tools/host_packages_scripts/opensuse_essential_15.6.sh
>      :language: shell
>   
> +Additionally, openSUSE Leap 15.6 requires a :term:`buildtools` tarball to be
> +installed and set up, as this distribution provides a version of Python that is
> +too old for :term:`BitBake`. Follow the :ref:`system-requirements-buildtools`
> +section below for more information.
> +

Shouldn't the buildtools cover all required packages to be present on 
the host? If so, do we actually need instructions without (e.g. the 
opensuse_essential_15.6.sh above)?

Cheers,
Quentin
Antonin Godard April 20, 2026, 10:54 a.m. UTC | #2
Hi,

On Mon Apr 20, 2026 at 12:46 PM CEST, Quentin Schulz wrote:
> Hi Antonin,
>
> On 4/20/26 11:52 AM, Antonin Godard via lists.yoctoproject.org wrote:
>> I noticed that openSUSE Leap 15.6 provide Python 3.6, which is not
>> supported by BitBake (which requires Python >3.9). Instruct to use a
>> buildtools tarball, which is how this is done on the Autobuilder.
>> 
>> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
>> ---
>>   documentation/ref-manual/system-requirements.rst | 5 +++++
>>   1 file changed, 5 insertions(+)
>> 
>> diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst
>> index baa965573..85a26060c 100644
>> --- a/documentation/ref-manual/system-requirements.rst
>> +++ b/documentation/ref-manual/system-requirements.rst
>> @@ -243,6 +243,11 @@ with a supported openSUSE Leap 15.6 distribution:
>>   .. literalinclude:: ../tools/host_packages_scripts/opensuse_essential_15.6.sh
>>      :language: shell
>>   
>> +Additionally, openSUSE Leap 15.6 requires a :term:`buildtools` tarball to be
>> +installed and set up, as this distribution provides a version of Python that is
>> +too old for :term:`BitBake`. Follow the :ref:`system-requirements-buildtools`
>> +section below for more information.
>> +
>
> Shouldn't the buildtools cover all required packages to be present on 
> the host? If so, do we actually need instructions without (e.g. the 
> opensuse_essential_15.6.sh above)?

Probably, but to be fair I'm trying to match what is installed on the
Autobuilder (and that is known to work), and I'd like to avoid dropping one
requirement by mistake. That's a bit inefficient, but a bit safer. I wish the
Autobuilder list of requirements was public and allow my to test things but I
don't have such an environment :/

Antonin
diff mbox series

Patch

diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst
index baa965573..85a26060c 100644
--- a/documentation/ref-manual/system-requirements.rst
+++ b/documentation/ref-manual/system-requirements.rst
@@ -243,6 +243,11 @@  with a supported openSUSE Leap 15.6 distribution:
 .. literalinclude:: ../tools/host_packages_scripts/opensuse_essential_15.6.sh
    :language: shell
 
+Additionally, openSUSE Leap 15.6 requires a :term:`buildtools` tarball to be
+installed and set up, as this distribution provides a version of Python that is
+too old for :term:`BitBake`. Follow the :ref:`system-requirements-buildtools`
+section below for more information.
+
 Here are the packages needed to build Project documentation manuals:
 
 .. literalinclude:: ../tools/host_packages_scripts/opensuse_docs.sh