summaryrefslogtreecommitdiff
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2010-11-15 08:27:07 -0800
committerSaul Wold <Saul.Wold@intel.com>2010-12-10 22:01:05 -0800
commit8feae1342393dcf1dad5d86df2ebe3727ea40d88 (patch)
tree8b8472a0f88db697cc995962e1bfa21363e13dad /documentation
parente7e12483e42a995f6611818cda9b556e995ec271 (diff)
downloadopenembedded-core-8feae1342393dcf1dad5d86df2ebe3727ea40d88.tar.gz
openembedded-core-8feae1342393dcf1dad5d86df2ebe3727ea40d88.tar.bz2
openembedded-core-8feae1342393dcf1dad5d86df2ebe3727ea40d88.tar.xz
openembedded-core-8feae1342393dcf1dad5d86df2ebe3727ea40d88.zip
Poky Reference Manual: Added INC_PR documentation.
Added an entry in the glossary for INC_PR. Also updated section "Package Revision Incrementing" to mention the use of INC_PR in conjuntion with the PR and PV variables. Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
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>