From 6d0dd8a6353503bf75e8e49be4dca5e457da3b47 Mon Sep 17 00:00:00 2001 From: Tim Orling Date: Thu, 13 Jan 2022 07:38:43 -0800 Subject: ref-manual/classes.rst: add setuptools3-base Add setuptools3-base class Deprecate distutils3* classes. [YOCTO #14610] (From yocto-docs rev: 0e9838e5a2096932d081a9a05a25c4fa0d6dc714) Signed-off-by: Tim Orling Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie --- documentation/ref-manual/classes.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) (limited to 'documentation/ref-manual') diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index 99d9a7a3e7..d9065b3619 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -515,6 +515,14 @@ used. - Extensions that use ``distutils``-based build systems require the ``distutils`` class in their recipes. + .. note:: + + ``distutils`` has been deprecated in Python 3.10 and will be removed + in Python 3.12. For this reason the ``distutils3*`` classes are now + deprecated and will be removed from core in the near future. Instead, + use the ``setuptools3*`` classes. + + - Extensions that use build systems based on ``setuptools3`` require the :ref:`setuptools3 ` class in their recipes. @@ -2376,6 +2384,17 @@ The ``setuptools3`` class supports Python version 3.x extensions that use build systems based on ``setuptools``. If your recipe uses these build systems, the recipe needs to inherit the ``setuptools3`` class. +.. _ref-classes-setuptools3-base: + +``setuptools3-base.bbclass`` +============================ + +The ``setuptools3-base`` class provides a reusable base for other classes +that support building Python version 3.x extensions. If you need +functionality that is not provided by the :ref:`setuptools3 ` class, you may +want to ``inherit setuptools3-base``. Some recipes do not need the tasks +in the :ref:`setuptools3 ` class and inherit this class instead. + .. _ref-classes-sign_rpm: ``sign_rpm.bbclass`` -- cgit v1.2.3-54-g00ecf