From mboxrd@z Thu Jan  1 00:00:00 1970
Delivery-date: Mon, 27 Jan 2025 09:35:35 +0100
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 <ptxdist-bounces+lore=lore.pengutronix.de@pengutronix.de>)
	id 1tcKak-0052DD-3D
	for lore@lore.pengutronix.de;
	Mon, 27 Jan 2025 09:35:35 +0100
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 <ptxdist-bounces@pengutronix.de>)
	id 1tcKal-00067k-1a; Mon, 27 Jan 2025 09:35:35 +0100
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 <mol@pengutronix.de>)
 id 1tcKaM-0005fj-1m; Mon, 27 Jan 2025 09:35:10 +0100
Received: from dude05.red.stw.pengutronix.de ([2a0a:edc0:0:1101:1d::54])
 by drehscheibe.grey.stw.pengutronix.de with esmtps (TLS1.3) tls
 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96)
 (envelope-from <mol@pengutronix.de>) id 1tcKaL-0025uD-2n;
 Mon, 27 Jan 2025 09:35:09 +0100
Received: from mol by dude05.red.stw.pengutronix.de with local (Exim 4.96)
 (envelope-from <mol@pengutronix.de>) id 1tcKaL-001WOw-2e;
 Mon, 27 Jan 2025 09:35:09 +0100
From: Michael Olbrich <m.olbrich@pengutronix.de>
To: ptxdist@pengutronix.de
Date: Mon, 27 Jan 2025 09:35:09 +0100
Message-Id: <20250127083509.362871-1-m.olbrich@pengutronix.de>
X-Mailer: git-send-email 2.39.5
In-Reply-To: <20250122172807.3576211-1-rhi@pengutronix.de>
References: <20250122172807.3576211-1-rhi@pengutronix.de>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Subject: Re: [ptxdist] [APPLIED] doc/ref_make_variables: document <PKG>_PARTS
X-BeenThere: ptxdist@pengutronix.de
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: PTXdist Development Mailing List <ptxdist.pengutronix.de>
List-Unsubscribe: <https://metis.pengutronix.de/mailman/options/ptxdist>,
 <mailto:ptxdist-request@pengutronix.de?subject=unsubscribe>
List-Archive: <https://metis.pengutronix.de/mailman/private/ptxdist/>
List-Post: <mailto:ptxdist@pengutronix.de>
List-Help: <mailto:ptxdist-request@pengutronix.de?subject=help>
List-Subscribe: <https://metis.pengutronix.de/mailman/listinfo/ptxdist>,
 <mailto:ptxdist-request@pengutronix.de?subject=subscribe>
Reply-To: ptxdist@pengutronix.de
Cc: Roland Hieber <rhi@pengutronix.de>
Sender: "ptxdist" <ptxdist-bounces@pengutronix.de>
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.whiteo.stw.pengutronix.de); SAEximRunCond expanded to false

Thanks, applied as 870378a22bb3ed1bbfaf99cba7c1330abc1784fa.

Michael

[sent from post-receive hook]

On Mon, 27 Jan 2025 09:35:09 +0100, Roland Hieber <rhi@pengutronix.de> wrote:
> Signed-off-by: Roland Hieber <rhi@pengutronix.de>
> Message-Id: <20250122172807.3576211-1-rhi@pengutronix.de>
> Signed-off-by: Michael Olbrich <m.olbrich@pengutronix.de>
> 
> diff --git a/doc/ref_make_variables.rst b/doc/ref_make_variables.rst
> index 20c98995f6e5..358701aab9e2 100644
> --- a/doc/ref_make_variables.rst
> +++ b/doc/ref_make_variables.rst
> @@ -283,6 +283,44 @@ of the corresponding target package if it exists.
>    In theory ``<PKG>_STRIP_LEVEL`` could be set to 2 or more to remove more
>    than one directory level.
>  
> +``<PKG>_PARTS``
> +  Sometimes more than one source archive needs to be downloaded to build a
> +  single package, e.g. when the project's main source archive comes from a Git
> +  repository export, which doesn't include Git submodules. In this case,
> +  ``<PKG>_PARTS`` can be set to refer to multiple prefixes of
> +  variable names, usually of the form ``<PKG>_<SUBPART>``, which PTXdist's
> +  default *get* and *extract* stages will use to resolve additional
> +  ``*_VERSION``, ``*_URL``, ``*_MD5`` variables etc. to download and extract
> +  multiple source archives.
> +
> +  For example:
> +
> +  .. code:: make
> +
> +      FOO_VERSION		:= 1.0
> +      FOO_MD5			:= a38714a1713bfd436564d643e169879e
> +      FOO			:= foo-$(FOO_VERSION)
> +      FOO_URL			:= https://some-server/path/to/$(FOO).tar.gz
> +      FOO_SOURCE		:= $(SRCDIR)/$(FOO).$(FOO_SUFFIX)
> +      FOO_DIR			:= $(BUILDDIR)/$(FOO)
> +
> +      FOO_SUBPART_MD5		:= a38714a1713bfd436564d643e169879e
> +      FOO_SUBPART               := subpart-0.9.1
> +      FOO_SUBPART_URL		:= https://some-server/path/to/$(FOO_SUBPART).tar.gz
> +      FOO_SUBPART_SOURCE	:= $(SRCDIR)/$(FOO_SUBPART).tar.gz
> +      FOO_SUBPART_DIR		:= $(BUILDDIR)/$(FOO)/subpart
> +
> +      FOO_PARTS                 := FOO FOO_SUBPART
> +
> +  In this example, the *foo.get* stage will download *foo-1.0.tar.gz* and
> +  *subpart-0.9.1.tar.gz*.
> +  The *foo.extract* stage will first extract *foo-1.0.tar.gz* into its build
> +  dir at ``$(BUILDDIR)/$(FOO)`` as usual, and then extract
> +  *subpart-0.9.1.tar.gz* into the subfolder ``$(BUILDDIR)/$(FOO)/subpart``.
> +
> +  ``<PKG>_<SUBPART>_STRIP_LEVEL``, ``<PKG>_<SUBPART>_LICENSE`` and
> +  ``<PKG>_<SUBPART>_LICENSE_FILES`` can be used adequately.
> +
>  ``<PKG>_BUILD_OOT``
>    If this is set to ``YES`` then PTXdist will build the package out of
>    tree. This is only supported for autoconf, qmake and cmake packages. The