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

dev-manual: Fixed typo for "${INC_PR}.0" 

The string appeared in the text as "$(INC_PR).0".  So, fixed
it to be proper with the curly braces.

(From yocto-docs rev: 0e4ca6cd3d0eae847243fc624c5f119d004cf40c)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2016-11-09 09:22:23 -08:00 committed by Richard Purdie
parent 2759976f48
commit a68b471de3
1 changed files with 22 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
documentation/dev-manual/dev-manual-common-tasks.xml
View File

@ -7499,26 +7499,29 @@
</para> </para>
<para> <para>
If a committed change results in changing the package output, If a committed change results in changing the package
then the value of the PR variable needs to be increased output, then the value of the PR variable needs to be
(or "bumped") as part of that commit. increased (or "bumped") as part of that commit.
For new recipes you should add the <filename>PR</filename> For new recipes you should add the <filename>PR</filename>
variable and set its initial value equal to "r0", which is the default. variable and set its initial value equal to "r0", which is
Even though the default value is "r0", the practice of adding it to a new recipe makes the default.
it harder to forget to bump the variable when you make changes Even though the default value is "r0", the practice of
to the recipe in future. adding it to a new recipe makes it harder to forget to bump
the variable when you make changes to the recipe in future.
</para> </para>
<para> <para>
If you are sharing a common <filename>.inc</filename> file with multiple recipes, If you are sharing a common <filename>.inc</filename> file
you can also use the with multiple recipes, you can also use the
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-INC_PR'>INC_PR</ulink></filename> <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-INC_PR'>INC_PR</ulink></filename>
variable to ensure that variable to ensure that the recipes sharing the
the recipes sharing the <filename>.inc</filename> file are rebuilt when the <filename>.inc</filename> file are rebuilt when the
<filename>.inc</filename> file itself is changed. <filename>.inc</filename> file itself is changed.
The <filename>.inc</filename> file must set <filename>INC_PR</filename> The <filename>.inc</filename> file must set
(initially to "r0"), and all recipes referring to it should set <filename>PR</filename> <filename>INC_PR</filename> (initially to "r0"), and all
to "$(INC_PR).0" initially, incrementing the last number when the recipe is changed. recipes referring to it should set <filename>PR</filename>
to "${INC_PR}.0" initially, incrementing the last number
when the recipe is changed.
If the <filename>.inc</filename> file is changed then its If the <filename>.inc</filename> file is changed then its
<filename>INC_PR</filename> should be incremented. <filename>INC_PR</filename> should be incremented.
</para> </para>
@ -7527,14 +7530,14 @@
When upgrading the version of a package, assuming the When upgrading the version of a package, assuming the
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PV'>PV</ulink></filename> <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PV'>PV</ulink></filename>
changes, the <filename>PR</filename> variable should be changes, the <filename>PR</filename> variable should be
reset to "r0" (or "$(INC_PR).0" if you are using reset to "r0" (or "${INC_PR}.0" if you are using
<filename>INC_PR</filename>). <filename>INC_PR</filename>).
</para> </para>
<para> <para>
Usually, version increases occur only to packages. Usually, version increases occur only to packages.
However, if for some reason <filename>PV</filename> changes but does not However, if for some reason <filename>PV</filename> changes
increase, you can increase the but does not increase, you can increase the
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PE'>PE</ulink></filename> <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PE'>PE</ulink></filename>
variable (Package Epoch). variable (Package Epoch).
The <filename>PE</filename> variable defaults to "0". The <filename>PE</filename> variable defaults to "0".
@ -7544,7 +7547,8 @@
Version numbering strives to follow the Version numbering strives to follow the
<ulink url='http://www.debian.org/doc/debian-policy/ch-controlfields.html'> <ulink url='http://www.debian.org/doc/debian-policy/ch-controlfields.html'>
Debian Version Field Policy Guidelines</ulink>. Debian Version Field Policy Guidelines</ulink>.
These guidelines define how versions are compared and what "increasing" a version means. These guidelines define how versions are compared and what
"increasing" a version means.
</para> </para>
</section> </section>
</section> </section>