aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/ref-manual/classes.rst19
1 files changed, 19 insertions, 0 deletions
diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index 99d9a7a3e7c..41360c96584 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 <ref-classes-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 Python3 version 3.x extensions. If you need
+functionality that is not provided by the ``setuptools3`` class, you may
+want to ``inherit setuptools3-base``. Some recipes do not need the tasks
+in the ``setuptools3`` class and inherit this class instead.
+
.. _ref-classes-sign_rpm:
``sign_rpm.bbclass``