From mboxrd@z Thu Jan 1 00:00:00 1970 Delivery-date: Thu, 08 Aug 2024 14:58:33 +0200 Received: from metis.whiteo.stw.pengutronix.de ([2a0a:edc0:2:b01:1d::104]) by lore.white.stw.pengutronix.de with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1sc2iv-007Uwp-0G for lore@lore.pengutronix.de; Thu, 08 Aug 2024 14:58:33 +0200 Received: from localhost ([127.0.0.1] helo=metis.whiteo.stw.pengutronix.de) by metis.whiteo.stw.pengutronix.de with esmtp (Exim 4.92) (envelope-from ) id 1sc2it-0008M4-Uq; Thu, 08 Aug 2024 14:58:31 +0200 Received: from drehscheibe.grey.stw.pengutronix.de ([2a0a:edc0:0:c01:1d::a2]) by metis.whiteo.stw.pengutronix.de with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1sc2io-0008Ld-EP; Thu, 08 Aug 2024 14:58:26 +0200 Received: from [2a0a:edc0:0:1101:1d::ac] (helo=dude04.red.stw.pengutronix.de) by drehscheibe.grey.stw.pengutronix.de with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1sc2io-005Qk3-16; Thu, 08 Aug 2024 14:58:26 +0200 Received: from rhi by dude04.red.stw.pengutronix.de with local (Exim 4.96) (envelope-from ) id 1sc2in-008j6d-3A; Thu, 08 Aug 2024 14:58:25 +0200 From: Roland Hieber To: distrokit@pengutronix.de Date: Thu, 8 Aug 2024 14:58:24 +0200 Message-Id: <20240808125824.2079957-2-rhi@pengutronix.de> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240808125824.2079957-1-rhi@pengutronix.de> References: <20240808125824.2079957-1-rhi@pengutronix.de> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [DistroKit] [PATCH 2/2] doc: intro: update updating instructions X-BeenThere: distrokit@pengutronix.de X-Mailman-Version: 2.1.29 Precedence: list List-Id: DistroKit Mailinglist List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Roland Hieber Sender: "DistroKit" X-SA-Exim-Connect-IP: 127.0.0.1 X-SA-Exim-Mail-From: distrokit-bounces@pengutronix.de X-SA-Exim-Scanned: No (on metis.whiteo.stw.pengutronix.de); SAEximRunCond expanded to false For a version update, the versioned PTXdist binary needs to be called explicitly, otherwise just calling 'ptxdist' will use the PTXdist version from the current ptxconfig, which will be a no-op. Explain the purpose of scripts/p-all independently of updating. Signed-off-by: Roland Hieber --- doc/intro.rst | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/doc/intro.rst b/doc/intro.rst index d91cc20508c3..498d7160444c 100644 --- a/doc/intro.rst +++ b/doc/intro.rst @@ -122,10 +122,15 @@ Maintenance scripts Before sending your patch, you should run ``ptxdist lint`` and check its output. Your patch should not add any new lint errors. -For migrating PTXdist to a new version, there is the wrapper script -``scripts/p-all`` that runs PTXdist with the supplied arguments on all existing -platforms in DistroKit, for example:: +The wrapper script ``scripts/p-all`` runs PTXdist with the supplied arguments on +all existing platforms in DistroKit. +To migrate DistroKit to a new PTXdist version, first update the *ptxconfig* by +calling the new PTXdist version explicitely, then use ``scripts/p-all`` (which +will use the PTXdist version from the updated ptxconfig) to update all +*platformconfigs:*: + + $ ptxdist-2024.08.0 migrate $ ./scripts/p-all migrate Some platforms use config diffs for kernel and/or barebox packages. -- 2.39.2