From mboxrd@z Thu Jan 1 00:00:00 1970 Delivery-date: Thu, 15 Dec 2022 08:35:52 +0100 Received: from metis.ext.pengutronix.de ([2001:67c:670:201:290:27ff:fe1d:cc33]) by lore.white.stw.pengutronix.de with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1p5imV-004SPY-I9 for lore@lore.pengutronix.de; Thu, 15 Dec 2022 08:35:52 +0100 Received: from localhost ([127.0.0.1] helo=metis.ext.pengutronix.de) by metis.ext.pengutronix.de with esmtp (Exim 4.92) (envelope-from ) id 1p5imV-0001y7-BO; Thu, 15 Dec 2022 08:35:51 +0100 Received: from drehscheibe.grey.stw.pengutronix.de ([2a0a:edc0:0:c01:1d::a2]) by metis.ext.pengutronix.de with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1p5ilh-0000PE-Q2; Thu, 15 Dec 2022 08:35:01 +0100 Received: from [2a0a:edc0:0:1101:1d::54] (helo=dude05.red.stw.pengutronix.de) by drehscheibe.grey.stw.pengutronix.de with esmtp (Exim 4.94.2) (envelope-from ) id 1p5ilg-004eX2-EB; Thu, 15 Dec 2022 08:35:01 +0100 Received: from mol by dude05.red.stw.pengutronix.de with local (Exim 4.94.2) (envelope-from ) id 1p5ilg-00AVi8-Au; Thu, 15 Dec 2022 08:35:00 +0100 From: Michael Olbrich To: ptxdist@pengutronix.de Date: Thu, 15 Dec 2022 08:35:00 +0100 Message-Id: <20221215073500.2505133-1-m.olbrich@pengutronix.de> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20221206111211.3961424-3-rhi@pengutronix.de> References: <20221206111211.3961424-3-rhi@pengutronix.de> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: Re: [ptxdist] [APPLIED] doc: ref: document config hash macros and variables X-BeenThere: ptxdist@pengutronix.de X-Mailman-Version: 2.1.29 Precedence: list List-Id: PTXdist Development Mailing List List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: ptxdist@pengutronix.de Cc: Roland Hieber Sender: "ptxdist" X-SA-Exim-Connect-IP: 127.0.0.1 X-SA-Exim-Mail-From: ptxdist-bounces@pengutronix.de X-SA-Exim-Scanned: No (on metis.ext.pengutronix.de); SAEximRunCond expanded to false Thanks, applied as 908c6ca41a28759e697be0d951a00a17306d0cab. Michael [sent from post-receive hook] On Thu, 15 Dec 2022 08:35:00 +0100, Roland Hieber wrote: > Signed-off-by: Roland Hieber > Message-Id: <20221206111211.3961424-3-rhi@pengutronix.de> > Signed-off-by: Michael Olbrich > > diff --git a/doc/ref_make_macros.rst b/doc/ref_make_macros.rst > index 4c1ca2f0375f..3ea331baee4b 100644 > --- a/doc/ref_make_macros.rst > +++ b/doc/ref_make_macros.rst > @@ -681,6 +681,24 @@ be installed with some other ``install_*`` command before > @$(call install_replace, timezone, /etc/timezone, @TIMEZONE@, \ > $(PTXCONF_TIMEZONE_LOCALTIME)) > > +.. _ptx/cfghash: > +.. _ptx/cfghash-file: > + > +ptx/cfghash, ptx/cfghash-file > +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > + > +Usage: > + > +.. code-block:: make > + > + $(call ptx/cfghash, , ) > + $(call ptx/cfghash-file, , ) > + > +Add an arbitrary **** or the content of **** to the config hash > +for ****. > +This has the effect that the package will be rebuilt when the string or the > +content of the file changes. > + > .. _param_macros: > .. _ptxEndis: > .. _ptxDisen: > diff --git a/doc/ref_make_variables.rst b/doc/ref_make_variables.rst > index beca984edccc..7ec09cbb3e91 100644 > --- a/doc/ref_make_variables.rst > +++ b/doc/ref_make_variables.rst > @@ -345,6 +345,15 @@ Build Environment for all Stages > Prepare Stage > ^^^^^^^^^^^^^ > > +``_CFGHASH`` > + This variable contains the config hash for the package. > + If it changes, PTXdist rebuilds the prepare stage of the package (and > + successively, all following stages). > + > + You should not need to touch this variable directly. > + To add content to the config hash, you can use the macros :ref:`ptx/cfghash > + and ptx/cfghash-file `. > + > ``_CONF_ENV`` > The environment for the prepare stage. If undefined, PTXdist will use > ``$(CROSS_ENV)`` for target packages, ``$(HOST_ENV)`` for host packages