From 6d5adf104895db47a0d426f68cb81454bd855790 Mon Sep 17 00:00:00 2001 From: Paul Eggleton Date: Thu, 23 Dec 2010 13:44:05 +0000 Subject: documentation/poky-ref-manual: expand discussion of PR and INC_PR Expands a little on PR and INC_PR. Signed-off-by: Paul Eggleton --- documentation/poky-ref-manual/extendpoky.xml | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) (limited to 'documentation/poky-ref-manual/extendpoky.xml') diff --git a/documentation/poky-ref-manual/extendpoky.xml b/documentation/poky-ref-manual/extendpoky.xml index 92f51a5..4fd818e 100644 --- a/documentation/poky-ref-manual/extendpoky.xml +++ b/documentation/poky-ref-manual/extendpoky.xml @@ -685,15 +685,20 @@ BBFILE_PRIORITY_emenlow = "6" This means that for new recipes you must be sure to add the PR variable and set its initial value equal to "r0". 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. + Note that you can only use integer values following the "r" in the PR variable. - You can also use the INC_PR variable - to keep up with package revisioning. - + If you are sharing a common .inc file with multiple recipes, you can also use the + INC_PR variable to ensure that + the recipes sharing the .inc file are rebuilt when the .inc file itself is changed. The + .inc file must set INC_PR (initially to "r0"), and all recipes referring to it should set PR to + "$(INC_PR).0" initially, incrementing the last number when the recipe is changed. If the + .inc file is changed then its INC_PR should be incremented. + - When upgrading the version of a package the (PV) and PR variables should be reset to "r0". + When upgrading the version of a package, assuming the PV changes, the PR variable should be reset to "r0" + (or "$(INC_PR).0" if you are using INC_PR). Usually, version increases occur only to packages. -- cgit v1.1