mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-05-09 17:39:31 +00:00
Code Issues Projects Releases Wiki Activity

ref-manual: improve "devtool check-upgrade-status" explanations

Browse Source 
- Fix broken link to a .bb file
- Clarify the explanations

(From yocto-docs rev: 937ef39cb4d04da388b1945d741820089daa2780)

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Michael Opdenacker
2023-02-08 18:18:43 +01:00
committed by Richard Purdie
parent 1ea54b0db3
commit 4681a9e6ce
1 changed files with 11 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/ref-manual/devtool-reference.rst
+11 -8
View File
@@ -378,14 +378,7 @@ command::
Unless you provide a specific recipe name on the command line, the Unless you provide a specific recipe name on the command line, the
command checks all recipes in all configured layers. command checks all recipes in all configured layers.
Following is a partial example table that reports on all the recipes. Following is a partial example table that reports on all the recipes::
Notice the reported reason for not upgrading the ``base-passwd`` recipe.
In this example, while a new version is available upstream, you do not
want to use it because the dependency on ``cdebconf`` is not easily
satisfied. Maintainers can explicit the reason that is shown by adding
the :term:`RECIPE_NO_UPDATE_REASON` variable to the corresponding recipe.
See :yocto_git:`base-passwd.bb </poky/tree/meta/recipes-core/base-passwd/base-passwd_3.5.29.bb>`
for an example::
$ devtool check-upgrade-status $ devtool check-upgrade-status
... ...
@@ -396,6 +389,16 @@ for an example::
INFO: base-passwd 3.5.29 3.5.51 Anuj Mittal <anuj.mittal@intel.com> cannot be updated due to: Version 3.5.38 requires cdebconf for update-passwd utility INFO: base-passwd 3.5.29 3.5.51 Anuj Mittal <anuj.mittal@intel.com> cannot be updated due to: Version 3.5.38 requires cdebconf for update-passwd utility
... ...
Notice the reported reason for not upgrading the ``base-passwd`` recipe.
In this example, while a new version is available upstream, you do not
want to use it because the dependency on ``cdebconf`` is not easily
satisfied. Maintainers can explicit the reason that is shown by adding
the :term:`RECIPE_NO_UPDATE_REASON` variable to the corresponding recipe.
See :yocto_git:`base-passwd.bb </poky/tree/meta/recipes-core/base-passwd/base-passwd_3.5.29.bb?h=kirkstone>`
for an example::
RECIPE_NO_UPDATE_REASON = "Version 3.5.38 requires cdebconf for update-passwd utility"
Last but not least, you may set :term:`UPSTREAM_VERSION_UNKNOWN` to ``1`` Last but not least, you may set :term:`UPSTREAM_VERSION_UNKNOWN` to ``1``
in a recipe when there's currently no way to determine its latest upstream in a recipe when there's currently no way to determine its latest upstream
version. version.