mirror of
https://git.yoctoproject.org/poky
synced 2026-05-09 17:39:31 +00:00
dev-manual: Review edits to manual upgrades for recipes.
(From yocto-docs rev: 05307788395cb16af95e89592bda070be6c1a397) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
committed by
Richard Purdie
parent
cfe25e8410
commit
4ae67cc01a
@@ -4541,17 +4541,18 @@
|
||||
To manually upgrade recipe versions, follow these general steps:
|
||||
<orderedlist>
|
||||
<listitem><para>
|
||||
<emphasis>Change the Recipe Name:</emphasis>
|
||||
Adjust the version (i.e.
|
||||
<ulink url='&YOCTO_DOCS_REF_URL;#var-PV'><filename>PV</filename></ulink>)
|
||||
part of the recipe name such that it uses the
|
||||
new version number.
|
||||
<emphasis>Change the Version:</emphasis>
|
||||
Rename the recipe such that the version (i.e. the
|
||||
<ulink url='&YOCTO_DOCS_REF_URL;#var-PV'><filename>PV</filename></ulink>
|
||||
part of the recipe name) changes appropriately.
|
||||
If the version is not part of the recipe name, change
|
||||
the value as it is set for <filename>PV</filename>
|
||||
within the recipe itself.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis>Update <filename>SRCREV</filename> if Needed:</emphasis>
|
||||
If the source code your recipe builds is fetched from
|
||||
Git or some other Version Control System (VCS),
|
||||
update
|
||||
Git or some other version control system, update
|
||||
<ulink url='&YOCTO_DOCS_REF_URL;#var-SRCREV'><filename>SRCREV</filename></ulink>
|
||||
to point to the commit hash that matches the new
|
||||
version.
|
||||
@@ -4562,13 +4563,19 @@
|
||||
Typical build failures include the following:
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
License terms were updated for the new version.
|
||||
For this case, you need to review the new
|
||||
terms of the license and update the values of
|
||||
License statements were updated for the new
|
||||
version.
|
||||
For this case, you need to review any changes
|
||||
to the license and update the values of
|
||||
<ulink url='&YOCTO_DOCS_REF_URL;#var-LICENSE'><filename>LICENSE</filename></ulink>
|
||||
and
|
||||
<ulink url='&YOCTO_DOCS_REF_URL;#var-LIC_FILES_CHKSUM'><filename>LIC_FILES_CHKSUM</filename></ulink>
|
||||
as needed.
|
||||
<note>
|
||||
License changes are often inconsequential.
|
||||
For example, the license text's copyright
|
||||
year might have changed.
|
||||
</note>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
Custom patches carried by the older version of
|
||||
@@ -4592,7 +4599,7 @@
|
||||
<ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink>
|
||||
variable and rebuilding the software.
|
||||
This optional step is especially important if the
|
||||
recipe is public.
|
||||
recipe is to be released publicly.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis>Check the Upstream Change Log or Release Notes:</emphasis>
|
||||
|
||||
Reference in New Issue
Block a user