summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
authorTim Orling <ticotimo@gmail.com>2022-01-13 07:38:43 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2022-01-17 11:59:50 +0000
commit6d0dd8a6353503bf75e8e49be4dca5e457da3b47 (patch)
tree1c57dd66fbb664b28d45e85c52400ebedaeef704 /documentation/ref-manual
parent9d9a50aa14030c26a58e57e6ddab0f80a40a976c (diff)
downloadpoky-6d0dd8a6353503bf75e8e49be4dca5e457da3b47.tar.gz
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 <tim.orling@konsulko.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
-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 99d9a7a3e7..d9065b3619 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -515,6 +515,14 @@ used.
515- Extensions that use ``distutils``-based build systems require the 515- Extensions that use ``distutils``-based build systems require the
516 ``distutils`` class in their recipes. 516 ``distutils`` class in their recipes.
517 517
518 .. note::
519
520 ``distutils`` has been deprecated in Python 3.10 and will be removed
521 in Python 3.12. For this reason the ``distutils3*`` classes are now
522 deprecated and will be removed from core in the near future. Instead,
523 use the ``setuptools3*`` classes.
524
525
518- Extensions that use build systems based on ``setuptools3`` require 526- Extensions that use build systems based on ``setuptools3`` require
519 the :ref:`setuptools3 <ref-classes-setuptools3>` class in their 527 the :ref:`setuptools3 <ref-classes-setuptools3>` class in their
520 recipes. 528 recipes.
@@ -2376,6 +2384,17 @@ The ``setuptools3`` class supports Python version 3.x extensions that
2376use build systems based on ``setuptools``. If your recipe uses these 2384use build systems based on ``setuptools``. If your recipe uses these
2377build systems, the recipe needs to inherit the ``setuptools3`` class. 2385build systems, the recipe needs to inherit the ``setuptools3`` class.
2378 2386
2387.. _ref-classes-setuptools3-base:
2388
2389``setuptools3-base.bbclass``
2390============================
2391
2392The ``setuptools3-base`` class provides a reusable base for other classes
2393that support building Python version 3.x extensions. If you need
2394functionality that is not provided by the :ref:`setuptools3 <ref-classes-setuptools3>` class, you may
2395want to ``inherit setuptools3-base``. Some recipes do not need the tasks
2396in the :ref:`setuptools3 <ref-classes-setuptools3>` class and inherit this class instead.
2397
2379.. _ref-classes-sign_rpm: 2398.. _ref-classes-sign_rpm:
2380 2399
2381``sign_rpm.bbclass`` 2400``sign_rpm.bbclass``