sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

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:
Scott Rifenbark 2010-11-15 08:27:07 -08:00 committed by Saul Wold
parent e7e12483e4
commit 8feae13423
2 changed files with 27 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
documentation/poky-ref-manual/extendpoky.xml
View File

@ -684,9 +684,13 @@ BBFILE_PRIORITY_emenlow = "6"
</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
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.
</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>
When upgrading the version of a package the (<glossterm><link
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
the repository and don't have to remember to rebuild any sections.
Second, to ensure that target users are able to upgrade their
devices using package manager commands such as <filename>
opkg upgrade</filename> (or similar commands for dpkg/apt or rpm-based systems).
devices using package manager commands such as <filename>opkg upgrade</filename>
(or similar commands for dpkg/apt or rpm-based systems).
</para>
<para>
The goal is to ensure Poky has upgradeable packages in all cases.

20
documentation/poky-ref-manual/ref-variables.xml
View File

@ -360,6 +360,26 @@
</glossdef>
</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>
<glossdef>
<para>