summaryrefslogtreecommitdiffstats
path: root/documentation/poky-ref-manual
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/poky-ref-manual
parente7e12483e42a995f6611818cda9b556e995ec271 (diff)
downloadpoky-8feae1342393dcf1dad5d86df2ebe3727ea40d88.tar.gz
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/poky-ref-manual')
-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 03546e6d3f..92f51a56f9 100644
--- a/documentation/poky-ref-manual/extendpoky.xml
+++ b/documentation/poky-ref-manual/extendpoky.xml
@@ -684,9 +684,13 @@ BBFILE_PRIORITY_emenlow = "6"
684 </glossterm> variable needs to be increased (or 'bumped') as part of that commit. 684 </glossterm> variable needs to be increased (or 'bumped') as part of that commit.
685 This means that for new recipes you must be sure to add the PR variable and set its initial value 685 This means that for new recipes you must be sure to add the PR variable and set its initial value
686 equal to "r0". 686 equal to "r0".
687 Not initially defining PR makes it easy to miss when you bump a package. 687 Failing to define PR makes it easy to miss when you bump a package.
688 Note that you can only use integer values for the PR variable. 688 Note that you can only use integer values for the PR variable.
689 </para> 689 </para>
690 <para>
691 You can also use the <glossterm><link linkend='var-INC_PR'>INC_PR</link></glossterm> variable
692 to keep up with package revisioning.
693 </para>
690 <para> 694 <para>
691 When upgrading the version of a package the (<glossterm><link 695 When upgrading the version of a package the (<glossterm><link
692 linkend='var-PV'>PV</link></glossterm>) and PR variables should be reset to "r0". 696 linkend='var-PV'>PV</link></glossterm>) and PR variables should be reset to "r0".
@@ -708,8 +712,8 @@ BBFILE_PRIORITY_emenlow = "6"
708 First, to ensure that when a developer updates and rebuilds, they get all the changes to 712 First, to ensure that when a developer updates and rebuilds, they get all the changes to
709 the repository and don't have to remember to rebuild any sections. 713 the repository and don't have to remember to rebuild any sections.
710 Second, to ensure that target users are able to upgrade their 714 Second, to ensure that target users are able to upgrade their
711 devices using package manager commands such as <filename> 715 devices using package manager commands such as <filename>opkg upgrade</filename>
712 opkg upgrade</filename> (or similar commands for dpkg/apt or rpm-based systems). 716 (or similar commands for dpkg/apt or rpm-based systems).
713 </para> 717 </para>
714 <para> 718 <para>
715 The goal is to ensure Poky has upgradeable packages in all cases. 719 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 fc2cbbeea3..e4c60d195f 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -360,6 +360,26 @@
360 </glossdef> 360 </glossdef>
361 </glossentry> 361 </glossentry>
362 362
363 <glossentry id='var-INC_PR'><glossterm>INC_PR</glossterm>
364 <glossdef>
365 <para>Defines the Package revision.
366 You manually combine values for INC_PR into the PR field of the parent recipe.
367 When you change INC_PR you change the PR value for every person that includes the file.
368 </para>
369 <para>
370 The following example shows how to use INC_PR given a common <filename>.inc</filename>
371 that defines the variable.
372 Once defined, the variable can be used to set the PR value:
373 </para>
374 <programlisting>
375recipes-graphics/xorg-font/font-util_1.1.1.bb:PR - "$(INC_PR).1"
376recipes-graphics/xorg-font/xorg-font-common.inc:INC_PR - "r1"
377recipes-graphics/xorg-font/encondings_1.0.3.bb:PR - "$(INC_PR).1"
378recipes-graphics/xorg-font/fiont-alias_1.0.2.bb:PR - "$(INC_PR).0"
379 </programlisting>
380 </glossdef>
381 </glossentry>
382
363 <glossentry id='var-INHIBIT_PACKAGE_STRIP'><glossterm>INHIBIT_PACKAGE_STRIP</glossterm> 383 <glossentry id='var-INHIBIT_PACKAGE_STRIP'><glossterm>INHIBIT_PACKAGE_STRIP</glossterm>
364 <glossdef> 384 <glossdef>
365 <para> 385 <para>