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>

diff --git a/documentation/poky-ref-manual/extendpoky.xml b/documentation/poky-ref-manual/extendpoky.xml
index 03546e6d3fed8f141ab7038ed88c950433cd3f25..92f51a56f947149edf56f801b6910c4c14bdd086 100644 (file)
--- 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 fc2cbbeea3961d701c2b3b8a705602f7a1949816..e4c60d195f557aadc72f91d76ef438a63a4297d5 100644 (file)
--- 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>