diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml index 6959b94d73..cbedfd010b 100644 --- a/documentation/poky-ref-manual/ref-variables.xml +++ b/documentation/poky-ref-manual/ref-variables.xml @@ -1587,6 +1587,25 @@ recipes-graphics/xorg-font/xorg-font-common.inc:INC_PR = "r2" + PRINC + + Causes the PR variable to dynamically increment. + This incrementation increases the value of a recipe's revision + (PR) while minimizing the impact of layer ordering. + In order to ensure multiple .bbappend files can co-exist, + PRINC should be self referencing. + The variable defaults to 0. + Following is an example that increments PR by two: + + PRINC := "${@int(PRINC) + 2}" + + It is adviseable not to use strings such as ".= '.1'" with the variable because + this usage is very sensitive to layer ordering. + Explicit assignments should be avoided as they cannot adequately represent multiple + .bbappend files. + + + PV The version of the recipe.