summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/variables.rst
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual/variables.rst')
-rw-r--r--documentation/ref-manual/variables.rst37
1 files changed, 0 insertions, 37 deletions
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 15f33dcf9f..2658fad61b 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -3859,43 +3859,6 @@ system and gives an overview of their function and contents.
3859 files to be deployed into :term:`IMGDEPLOYDIR`, and the class will take 3859 files to be deployed into :term:`IMGDEPLOYDIR`, and the class will take
3860 care of copying them into :term:`DEPLOY_DIR_IMAGE` afterwards. 3860 care of copying them into :term:`DEPLOY_DIR_IMAGE` afterwards.
3861 3861
3862 :term:`INC_PR`
3863 Helps define the recipe revision for recipes that share a common
3864 ``include`` file. You can think of this variable as part of the
3865 recipe revision as set from within an include file.
3866
3867 Suppose, for example, you have a set of recipes that are used across
3868 several projects. And, within each of those recipes the revision (its
3869 :term:`PR` value) is set accordingly. In this case, when
3870 the revision of those recipes changes, the burden is on you to find
3871 all those recipes and be sure that they get changed to reflect the
3872 updated version of the recipe. In this scenario, it can get
3873 complicated when recipes that are used in many places and provide
3874 common functionality are upgraded to a new revision.
3875
3876 A more efficient way of dealing with this situation is to set the
3877 :term:`INC_PR` variable inside the ``include`` files that the recipes
3878 share and then expand the :term:`INC_PR` variable within the recipes to
3879 help define the recipe revision.
3880
3881 The following provides an example that shows how to use the
3882 :term:`INC_PR` variable given a common ``include`` file that defines the
3883 variable. Once the variable is defined in the ``include`` file, you
3884 can use the variable to set the :term:`PR` values in each recipe. You
3885 will notice that when you set a recipe's :term:`PR` you can provide more
3886 granular revisioning by appending values to the :term:`INC_PR` variable::
3887
3888 recipes-graphics/xorg-font/xorg-font-common.inc:INC_PR = "r2"
3889 recipes-graphics/xorg-font/encodings_1.0.4.bb:PR = "${INC_PR}.1"
3890 recipes-graphics/xorg-font/font-util_1.3.0.bb:PR = "${INC_PR}.0"
3891 recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3892
3893 The
3894 first line of the example establishes the baseline revision to be
3895 used for all recipes that use the ``include`` file. The remaining
3896 lines in the example are from individual recipes and show how the
3897 :term:`PR` value is set.
3898
3899 :term:`INCOMPATIBLE_LICENSE` 3862 :term:`INCOMPATIBLE_LICENSE`
3900 Specifies a space-separated list of license names (as they would 3863 Specifies a space-separated list of license names (as they would
3901 appear in :term:`LICENSE`) that should be excluded 3864 appear in :term:`LICENSE`) that should be excluded