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>
This commit is contained in:
parent
e7e12483e4
commit
8feae13423
|
@ -684,9 +684,13 @@ BBFILE_PRIORITY_emenlow = "6"
|
||||||
</glossterm> variable needs to be increased (or 'bumped') as part of that commit.
|
</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
|
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".
|
||||||
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.
|
Note that you can only use integer values for the PR variable.
|
||||||
</para>
|
</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>
|
<para>
|
||||||
When upgrading the version of a package the (<glossterm><link
|
When upgrading the version of a package the (<glossterm><link
|
||||||
linkend='var-PV'>PV</link></glossterm>) and PR variables should be reset to "r0".
|
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
|
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.
|
the repository and don't have to remember to rebuild any sections.
|
||||||
Second, to ensure that target users are able to upgrade their
|
Second, to ensure that target users are able to upgrade their
|
||||||
devices using package manager commands such as <filename>
|
devices using package manager commands such as <filename>opkg upgrade</filename>
|
||||||
opkg upgrade</filename> (or similar commands for dpkg/apt or rpm-based systems).
|
(or similar commands for dpkg/apt or rpm-based systems).
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
The goal is to ensure Poky has upgradeable packages in all cases.
|
The goal is to ensure Poky has upgradeable packages in all cases.
|
||||||
|
|
|
@ -360,6 +360,26 @@
|
||||||
</glossdef>
|
</glossdef>
|
||||||
</glossentry>
|
</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>
|
<glossentry id='var-INHIBIT_PACKAGE_STRIP'><glossterm>INHIBIT_PACKAGE_STRIP</glossterm>
|
||||||
<glossdef>
|
<glossdef>
|
||||||
<para>
|
<para>
|
||||||
|
|
Loading…
Reference in New Issue