documentation/poky-ref-manual: expand discussion of PR and INC_PR
Expands a little on PR and INC_PR. Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
This commit is contained in:
parent
321d70e186
commit
6d5adf1048
|
@ -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
|
This means that for new recipes you must be sure to add the PR variable and set its initial value
|
||||||
equal to "r0".
|
equal to "r0".
|
||||||
Failing to define 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.
|
Note that you can only use integer values following the "r" in the PR variable.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
You can also use the <glossterm><link linkend='var-INC_PR'>INC_PR</link></glossterm> variable
|
If you are sharing a common .inc file with multiple recipes, you can also use the
|
||||||
to keep up with package revisioning.
|
<glossterm><link linkend='var-INC_PR'>INC_PR</link></glossterm> variable to ensure that
|
||||||
</para>
|
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.
|
||||||
|
</literallayout>
|
||||||
<para>
|
<para>
|
||||||
When upgrading the version of a package the (<glossterm><link
|
When upgrading the version of a package, assuming the <glossterm><link
|
||||||
linkend='var-PV'>PV</link></glossterm>) and PR variables should be reset to "r0".
|
linkend='var-PV'>PV</link></glossterm> changes, the PR variable should be reset to "r0"
|
||||||
|
(or "$(INC_PR).0" if you are using INC_PR).
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
Usually, version increases occur only to packages.
|
Usually, version increases occur only to packages.
|
||||||
|
|
|
@ -609,7 +609,7 @@ recipes-graphics/xorg-font/fiont-alias_1.0.2.bb:PR - "$(INC_PR).0"
|
||||||
|
|
||||||
<glossentry id='var-PR'><glossterm>PR</glossterm>
|
<glossentry id='var-PR'><glossterm>PR</glossterm>
|
||||||
<glossdef>
|
<glossdef>
|
||||||
<para>Revision of package.
|
<para>Revision of package. The default value is "r0".
|
||||||
</para>
|
</para>
|
||||||
</glossdef>
|
</glossdef>
|
||||||
</glossentry>
|
</glossentry>
|
||||||
|
@ -617,7 +617,11 @@ recipes-graphics/xorg-font/fiont-alias_1.0.2.bb:PR - "$(INC_PR).0"
|
||||||
<glossentry id='var-PV'><glossterm>PV</glossterm>
|
<glossentry id='var-PV'><glossterm>PV</glossterm>
|
||||||
<glossdef>
|
<glossdef>
|
||||||
<para>Version of package.
|
<para>Version of package.
|
||||||
The default value is "1.0"</para>
|
This is normally extracted from the recipe name, e.g. if the recipe is named
|
||||||
|
"expat_2.0.1.bb" then PV will be "2.0.1". PV is generally not overridden within
|
||||||
|
a recipe unless it is building an unstable version from a source code repository
|
||||||
|
(git, svn, etc.).
|
||||||
|
</para>
|
||||||
</glossdef>
|
</glossdef>
|
||||||
</glossentry>
|
</glossentry>
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue