ref-manual: document UPSTREAM_CHECK_COMMITS and UPSTREAM_VERSION_UNKNOWN

(From yocto-docs rev: 99b5fee6295a5c424fdb2cc0b34a4a486d7bf721)

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
2021-09-15 19:11:57 +02:00
committed by Richard Purdie
parent 95866fd533
commit d6966a39f2

View File

@@ -8483,6 +8483,18 @@ system and gives an overview of their function and contents.
install initscripts package them in the main package for the recipe,
you rarely need to set this variable in individual recipes.
:term:`UPSTREAM_CHECK_COMMITS`
You can perform a per-recipe check for what the latest upstream
source code version is by calling ``devtool latest-version recipe``. If
the recipe source code is provided from Git repositories, but
releases are not identified by Git tags, set :term:`UPSTREAM_CHECK_COMMITS`
to ``1`` in the recipe, and the OpenEmbedded build system
will compare the latest commit with the one currently specified
by the recipe (:term:`SRCREV`).
::
UPSTREAM_CHECK_COMMITS = "1"
:term:`UPSTREAM_CHECK_GITTAGREGEX`
You can perform a per-recipe check for what the latest upstream
source code version is by calling ``bitbake -c checkpkg`` recipe. If
@@ -8518,6 +8530,18 @@ system and gives an overview of their function and contents.
UPSTREAM_CHECK_URI = "recipe_url"
:term:`UPSTREAM_VERSION_UNKNOWN`
You can perform a per-recipe check for what the latest upstream
source code version is by calling ``devtool latest-version recipe``.
If no combination of the :term:`UPSTREAM_CHECK_URI`, :term:`UPSTREAM_CHECK_REGEX`,
:term:`UPSTREAM_CHECK_GITTAGREGEX` and :term:`UPSTREAM_CHECK_COMMITS` variables in
the recipe allows to determine what the latest upstream version is,
you can set :term:`UPSTREAM_VERSION_UNKNOWN` to ``1`` in the recipe
to acknowledge that the check cannot be performed.
::
UPSTREAM_VERSION_UNKNOWN = "1"
:term:`USE_DEVFS`
Determines if ``devtmpfs`` is used for ``/dev`` population. The
default value used for :term:`USE_DEVFS` is "1" when no value is