From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from relay9-d.mail.gandi.net (relay9-d.mail.gandi.net [217.70.183.199]) by mx.groups.io with SMTP id smtpd.web09.5490.1631700756315952936 for ; Wed, 15 Sep 2021 03:12:36 -0700 Authentication-Results: mx.groups.io; dkim=missing; spf=pass (domain: bootlin.com, ip: 217.70.183.199, mailfrom: michael.opdenacker@bootlin.com) Received: (Authenticated sender: michael.opdenacker@bootlin.com) by relay9-d.mail.gandi.net (Postfix) with ESMTPSA id BCD4EFF810; Wed, 15 Sep 2021 10:12:33 +0000 (UTC) From: "Michael Opdenacker" To: docs@lists.yoctoproject.org Cc: Michael Opdenacker Subject: [PATCH 2/4] ref-manual: improve "devtool check-upgrade-status" details Date: Wed, 15 Sep 2021 12:12:17 +0200 Message-Id: <20210915101219.2198566-2-michael.opdenacker@bootlin.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210915101219.2198566-1-michael.opdenacker@bootlin.com> References: <20210915101219.2198566-1-michael.opdenacker@bootlin.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit - Mention "devtool latest-version recipe" to process a single version - Explain that the mechanism is controlled by the UPSTREAM_CHECK* variables, which are not referred to anywhere else in the manuals, except in the variable index. Signed-off-by: Michael Opdenacker --- documentation/ref-manual/devtool-reference.rst | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/documentation/ref-manual/devtool-reference.rst b/documentation/ref-manual/devtool-reference.rst index 5fd51569a3..5a0d6c25ae 100644 --- a/documentation/ref-manual/devtool-reference.rst +++ b/documentation/ref-manual/devtool-reference.rst @@ -328,12 +328,18 @@ Checking on the Upgrade Status of a Recipe Upstream recipes change over time. Consequently, you might find that you need to determine if you can upgrade a recipe to a newer version. -To check on the upgrade status of a recipe, use the -``devtool check-upgrade-status`` command. The command displays a table -of your current recipe versions, the latest upstream versions, the email -address of the recipe's maintainer, and any additional information such -as commit hash strings and reasons you might not be able to upgrade a -particular recipe. +To check on the upgrade status of a recipe, you can use the +``devtool latest-version recipe`` command, which quickly shows the current +version and the latest version available upstream. To get such information +for all available recipes, use the ``devtool check-upgrade-status`` command. +The command displays a table of your current recipe versions, the latest +upstream versions, the email address of the recipe's maintainer, and any +additional information such as commit hash strings and reasons you might +not be able to upgrade a particular recipe. + +This upgrade checking mechanism relies on the :term:`UPSTREAM_CHECK_URI`, +:term:`UPSTREAM_CHECK_REGEX` and :term:`UPSTREAM_CHECK_GITTAGREGEX` variables +which can be defined in each recipe. .. note:: -- 2.25.1