diff options
author | Quentin Schulz <foss@0leil.net> | 2021-06-01 21:22:06 +0200 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2021-06-06 23:18:26 +0100 |
commit | 2c37ab65e535d0cbf450b54df8c21043ca9b33f3 (patch) | |
tree | 4e5aad6c72cddc537e0bfc6c3a1a3bdc766d46f0 | |
parent | 287ee2514571f2c78e67364c65851ec60bc59c51 (diff) | |
download | poky-2c37ab65e535d0cbf450b54df8c21043ca9b33f3.tar.gz |
bitbake: doc: user-manual: remove mentions to BBVERSIONS
BBVERSIONS support was dropped in November 2016 in commit
0bb188f01e39 "ast: remove BBVERSIONS support".
Let's update the documentation to reflect this.
This was found by running:
git grep -hoP '^ :term:`\K\w+(?=`)' doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst | \
xargs -I{} sh -c \
"grep -Rq --include='*.py' --include='*.conf' --include='*.bbclass' --include='*.bb' --include='*.bbappend' --include='*.inc' \
-w -E {}'_*(_[a-z]+[0-9a-z]*[a-z]+)*' || \
echo {}"
(Bitbake rev: 376e20c1aaff197020cdb68d309b3b22f19dafe8)
Signed-off-by: Quentin Schulz <foss@0leil.net>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst | 41 | ||||
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst | 10 |
2 files changed, 9 insertions, 42 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst index 615c9f9ce1..77c107aff6 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst | |||
@@ -1650,10 +1650,15 @@ user interfaces: | |||
1650 | Variants - Class Extension Mechanism | 1650 | Variants - Class Extension Mechanism |
1651 | ==================================== | 1651 | ==================================== |
1652 | 1652 | ||
1653 | BitBake supports two features that facilitate creating from a single | 1653 | BitBake supports multiple incarnations of a recipe file via the |
1654 | recipe file multiple incarnations of that recipe file where all | 1654 | :term:`BBCLASSEXTEND` variable. |
1655 | incarnations are buildable. These features are enabled through the | 1655 | |
1656 | :term:`BBCLASSEXTEND` and :term:`BBVERSIONS` variables. | 1656 | The :term:`BBCLASSEXTEND` variable is a space separated list of classes used |
1657 | to "extend" the recipe for each variant. Here is an example that results in a | ||
1658 | second incarnation of the current recipe being available. This second | ||
1659 | incarnation will have the "native" class inherited. :: | ||
1660 | |||
1661 | BBCLASSEXTEND = "native" | ||
1657 | 1662 | ||
1658 | .. note:: | 1663 | .. note:: |
1659 | 1664 | ||
@@ -1663,34 +1668,6 @@ incarnations are buildable. These features are enabled through the | |||
1663 | class. For specific examples, see the OE-Core native , nativesdk , and | 1668 | class. For specific examples, see the OE-Core native , nativesdk , and |
1664 | multilib classes. | 1669 | multilib classes. |
1665 | 1670 | ||
1666 | - ``BBCLASSEXTEND``: This variable is a space separated list of | ||
1667 | classes used to "extend" the recipe for each variant. Here is an | ||
1668 | example that results in a second incarnation of the current recipe | ||
1669 | being available. This second incarnation will have the "native" class | ||
1670 | inherited. :: | ||
1671 | |||
1672 | BBCLASSEXTEND = "native" | ||
1673 | |||
1674 | - ``BBVERSIONS``: This variable allows a single recipe to build | ||
1675 | multiple versions of a project from a single recipe file. You can | ||
1676 | also specify conditional metadata (using the | ||
1677 | :term:`OVERRIDES` mechanism) for a single | ||
1678 | version, or an optionally named range of versions. Here is an | ||
1679 | example:: | ||
1680 | |||
1681 | BBVERSIONS = "1.0 2.0 git" | ||
1682 | SRC_URI_git = "git://someurl/somepath.git" | ||
1683 | |||
1684 | BBVERSIONS = "1.0.[0-6]:1.0.0+ 1.0.[7-9]:1.0.7+" | ||
1685 | SRC_URI_append_1.0.7+ = "file://some_patch_which_the_new_versions_need.patch;patch=1" | ||
1686 | |||
1687 | The name of the range defaults to the original version of the recipe. For | ||
1688 | example, in OpenEmbedded, the recipe file ``foo_1.0.0+.bb`` creates a default | ||
1689 | name range of ``1.0.0+``. This is useful because the range name is not only | ||
1690 | placed into overrides, but it is also made available for the metadata to use | ||
1691 | in the variable that defines the base recipe versions for use in ``file://`` | ||
1692 | search paths (:term:`FILESPATH`). | ||
1693 | |||
1694 | Dependencies | 1671 | Dependencies |
1695 | ============ | 1672 | ============ |
1696 | 1673 | ||
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst index e1b640e2fd..adb311ab10 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst | |||
@@ -797,16 +797,6 @@ overview of their function and contents. | |||
797 | Allows you to use a configuration file to add to the list of | 797 | Allows you to use a configuration file to add to the list of |
798 | command-line target recipes you want to build. | 798 | command-line target recipes you want to build. |
799 | 799 | ||
800 | :term:`BBVERSIONS` | ||
801 | Allows a single recipe to build multiple versions of a project from a | ||
802 | single recipe file. You also able to specify conditional metadata | ||
803 | using the :term:`OVERRIDES` mechanism for a | ||
804 | single version or for an optionally named range of versions. | ||
805 | |||
806 | For more information on ``BBVERSIONS``, see the | ||
807 | ":ref:`bitbake-user-manual/bitbake-user-manual-metadata:variants - class extension mechanism`" | ||
808 | section. | ||
809 | |||
810 | :term:`BITBAKE_UI` | 800 | :term:`BITBAKE_UI` |
811 | Used to specify the UI module to use when running BitBake. Using this | 801 | Used to specify the UI module to use when running BitBake. Using this |
812 | variable is equivalent to using the ``-u`` command-line option. | 802 | variable is equivalent to using the ``-u`` command-line option. |