summaryrefslogtreecommitdiffstats
path: root/documentation/poky-ref-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/poky-ref-manual')
-rw-r--r--documentation/poky-ref-manual/extendpoky.xml17
-rw-r--r--documentation/poky-ref-manual/ref-variables.xml8
2 files changed, 17 insertions, 8 deletions
diff --git a/documentation/poky-ref-manual/extendpoky.xml b/documentation/poky-ref-manual/extendpoky.xml
index 92f51a56f9..4fd818e8b1 100644
--- a/documentation/poky-ref-manual/extendpoky.xml
+++ b/documentation/poky-ref-manual/extendpoky.xml
@@ -685,15 +685,20 @@ BBFILE_PRIORITY_emenlow = "6"
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 Failing to define 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 following the "r" in the PR variable.
689 </para> 689 </para>
690 <para> 690 <para>
691 You can also use the <glossterm><link linkend='var-INC_PR'>INC_PR</link></glossterm> variable 691 If you are sharing a common .inc file with multiple recipes, you can also use the
692 to keep up with package revisioning. 692 <glossterm><link linkend='var-INC_PR'>INC_PR</link></glossterm> variable to ensure that
693 </para> 693 the recipes sharing the .inc file are rebuilt when the .inc file itself is changed. The
694 .inc file must set INC_PR (initially to "r0"), and all recipes referring to it should set PR to
695 "$(INC_PR).0" initially, incrementing the last number when the recipe is changed. If the
696 .inc file is changed then its INC_PR should be incremented.
697 </literallayout>
694 <para> 698 <para>
695 When upgrading the version of a package the (<glossterm><link 699 When upgrading the version of a package, assuming the <glossterm><link
696 linkend='var-PV'>PV</link></glossterm>) and PR variables should be reset to "r0". 700 linkend='var-PV'>PV</link></glossterm> changes, the PR variable should be reset to "r0"
701 (or "$(INC_PR).0" if you are using INC_PR).
697 </para> 702 </para>
698 <para> 703 <para>
699 Usually, version increases occur only to packages. 704 Usually, version increases occur only to packages.
diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 98a501f399..da57e2c384 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -609,7 +609,7 @@ recipes-graphics/xorg-font/fiont-alias_1.0.2.bb:PR - "$(INC_PR).0"
609 609
610 <glossentry id='var-PR'><glossterm>PR</glossterm> 610 <glossentry id='var-PR'><glossterm>PR</glossterm>
611 <glossdef> 611 <glossdef>
612 <para>Revision of package. 612 <para>Revision of package. The default value is "r0".
613 </para> 613 </para>
614 </glossdef> 614 </glossdef>
615 </glossentry> 615 </glossentry>
@@ -617,7 +617,11 @@ recipes-graphics/xorg-font/fiont-alias_1.0.2.bb:PR - "$(INC_PR).0"
617 <glossentry id='var-PV'><glossterm>PV</glossterm> 617 <glossentry id='var-PV'><glossterm>PV</glossterm>
618 <glossdef> 618 <glossdef>
619 <para>Version of package. 619 <para>Version of package.
620 The default value is "1.0"</para> 620 This is normally extracted from the recipe name, e.g. if the recipe is named
621 "expat_2.0.1.bb" then PV will be "2.0.1". PV is generally not overridden within
622 a recipe unless it is building an unstable version from a source code repository
623 (git, svn, etc.).
624 </para>
621 </glossdef> 625 </glossdef>
622 </glossentry> 626 </glossentry>
623 627