summaryrefslogtreecommitdiff
path: root/documentation
diff options
context:
space:
mode:
Diffstat (limited to 'documentation')
-rw-r--r--documentation/poky-ref-manual/extendpoky.xml10
-rw-r--r--documentation/poky-ref-manual/ref-variables.xml20
2 files changed, 27 insertions, 3 deletions
diff --git a/documentation/poky-ref-manual/extendpoky.xml b/documentation/poky-ref-manual/extendpoky.xml
index 03546e6d3..92f51a56f 100644
--- a/documentation/poky-ref-manual/extendpoky.xml
+++ b/documentation/poky-ref-manual/extendpoky.xml
@@ -684,9 +684,13 @@ BBFILE_PRIORITY_emenlow = "6"
</glossterm> variable needs to be increased (or 'bumped') as part of that commit.
This means that for new recipes you must be sure to add the PR variable and set its initial value
equal to "r0".
- Not initially defining PR makes it easy to miss when you bump a package.
+ Failing to define PR makes it easy to miss when you bump a package.
Note that you can only use integer values for the PR variable.
</para>
+ <para>
+ You can also use the <glossterm><link linkend='var-INC_PR'>INC_PR</link></glossterm> variable
+ to keep up with package revisioning.
+ </para>
<para>
When upgrading the version of a package the (<glossterm><link
linkend='var-PV'>PV</link></glossterm>) and PR variables should be reset to "r0".
@@ -708,8 +712,8 @@ BBFILE_PRIORITY_emenlow = "6"
First, to ensure that when a developer updates and rebuilds, they get all the changes to
the repository and don't have to remember to rebuild any sections.
Second, to ensure that target users are able to upgrade their
- devices using package manager commands such as <filename>
- opkg upgrade</filename> (or similar commands for dpkg/apt or rpm-based systems).
+ devices using package manager commands such as <filename>opkg upgrade</filename>
+ (or similar commands for dpkg/apt or rpm-based systems).
</para>
<para>
The goal is to ensure Poky has upgradeable packages in all cases.
diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index fc2cbbeea..e4c60d195 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -360,6 +360,26 @@
</glossdef>
</glossentry>
+ <glossentry id='var-INC_PR'><glossterm>INC_PR</glossterm>
+ <glossdef>
+ <para>Defines the Package revision.
+ You manually combine values for INC_PR into the PR field of the parent recipe.
+ When you change INC_PR you change the PR value for every person that includes the file.
+ </para>
+ <para>
+ The following example shows how to use INC_PR given a common <filename>.inc</filename>
+ that defines the variable.
+ Once defined, the variable can be used to set the PR value:
+ </para>
+ <programlisting>
+recipes-graphics/xorg-font/font-util_1.1.1.bb:PR - "$(INC_PR).1"
+recipes-graphics/xorg-font/xorg-font-common.inc:INC_PR - "r1"
+recipes-graphics/xorg-font/encondings_1.0.3.bb:PR - "$(INC_PR).1"
+recipes-graphics/xorg-font/fiont-alias_1.0.2.bb:PR - "$(INC_PR).0"
+ </programlisting>
+ </glossdef>
+ </glossentry>
+
<glossentry id='var-INHIBIT_PACKAGE_STRIP'><glossterm>INHIBIT_PACKAGE_STRIP</glossterm>
<glossdef>
<para>