diff options
Diffstat (limited to 'poky/documentation/ref-manual/classes.rst')
-rw-r--r-- | poky/documentation/ref-manual/classes.rst | 69 |
1 files changed, 17 insertions, 52 deletions
diff --git a/poky/documentation/ref-manual/classes.rst b/poky/documentation/ref-manual/classes.rst index be112e0fa..52a50faf6 100644 --- a/poky/documentation/ref-manual/classes.rst +++ b/poky/documentation/ref-manual/classes.rst @@ -501,29 +501,6 @@ Support for other version control systems such as Subversion is limited due to BitBake's automatic fetch dependencies (e.g. ``subversion-native``). -.. _ref-classes-distutils: - -``distutils*.bbclass`` -====================== - -The ``distutils*`` classes support recipes for Python version 2.x -extensions, which are simple. These recipes usually only need to point -to the source's archive and then inherit the proper class. Building is -split into two methods depending on which method the module authors -used. - -- Extensions that use an Autotools-based build system require Autotools - and the classes based on ``distutils`` in their recipes. - -- Extensions that use build systems based on ``distutils`` require the - ``distutils`` class in their recipes. - -- Extensions that use build systems based on ``setuptools`` require the - :ref:`setuptools <ref-classes-setuptools>` class in their recipes. - -The ``distutils-common-base`` class is required by some of the -``distutils*`` classes to provide common Python2 support. - .. _ref-classes-distutils3: ``distutils3*.bbclass`` @@ -542,15 +519,9 @@ used. ``distutils`` class in their recipes. - Extensions that use build systems based on ``setuptools3`` require - the :ref:`setuptools3 <ref-classes-setuptools>` class in their + the :ref:`setuptools3 <ref-classes-setuptools3>` class in their recipes. -The ``distutils3*`` classes either inherit their corresponding -``distutils*`` class or replicate them using a Python3 version instead -(e.g. ``distutils3-base`` inherits ``distutils-common-base``, which is -the same as ``distutils-base`` but inherits ``python3native`` instead of -``pythonnative``). - .. _ref-classes-externalsrc: ``externalsrc.bbclass`` @@ -1426,7 +1397,7 @@ Only a single U-boot boot script can be added to the FIT image created by The boot script is specified in the ITS file as a text file containing U-boot commands. When using a boot script the user should configure the U-boot ``do_install`` task to copy the script to sysroot. -So the script can be included in the the FIT image by the ``kernel-fitimage`` +So the script can be included in the FIT image by the ``kernel-fitimage`` class. At run-time, U-boot CONFIG_BOOTCOMMAND define can be configured to load the boot script from the FIT image and executes it. @@ -2138,13 +2109,13 @@ For information on setting up and running ptests, see the ":ref:`dev-manual/common-tasks:testing packages with ptest`" section in the Yocto Project Development Tasks Manual. -.. _ref-classes-python-dir: +.. _ref-classes-python3-dir: -``python-dir.bbclass`` -====================== +``python3-dir.bbclass`` +======================= -The ``python-dir`` class provides the base version, location, and site -package location for Python. +The ``python3-dir`` class provides the base version, location, and site +package location for Python 3. .. _ref-classes-python3native: @@ -2155,14 +2126,17 @@ The ``python3native`` class supports using the native version of Python 3 built by the build system rather than support of the version provided by the build host. -.. _ref-classes-pythonnative: +.. _ref-classes-python3targetconfig: -``pythonnative.bbclass`` -======================== +``python3targetconfig.bbclass`` +=============================== -When inherited by a recipe, the ``pythonnative`` class supports using -the native version of Python built by the build system rather than using -the version provided by the build host. +The ``python3targetconfig`` class supports using the native version of Python +3 built by the build system rather than support of the version provided +by the build host, except that the configuration for the target machine +is accessible (such as correct installation directories). This also adds a +dependency on target ``python3``, so should only be used where appropriate +in order to avoid unnecessarily lengthening builds. .. _ref-classes-qemu: @@ -2323,22 +2297,13 @@ additional configuration options you want to pass SCons command line. The ``sdl`` class supports recipes that need to build software that uses the Simple DirectMedia Layer (SDL) library. -.. _ref-classes-setuptools: - -``setuptools.bbclass`` -====================== - -The ``setuptools`` class supports Python version 2.x extensions that use -build systems based on ``setuptools``. If your recipe uses these build -systems, the recipe needs to inherit the ``setuptools`` class. - .. _ref-classes-setuptools3: ``setuptools3.bbclass`` ======================= The ``setuptools3`` class supports Python version 3.x extensions that -use build systems based on ``setuptools3``. If your recipe uses these +use build systems based on ``setuptools``. If your recipe uses these build systems, the recipe needs to inherit the ``setuptools3`` class. .. _ref-classes-sign_rpm: |