From cf854359717dc6b1e90b1b559901f158e39eaf7a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Luc=C3=ADa=20Andrea=20Illanes=20Albornoz?= Date: Wed, 24 Apr 2024 20:07:09 +0200 Subject: subr.ex/ex_pkg.subr:ex_pkg_register_group(): separate {owner,copy} from {auto,noauto} groups. groups.d/dev_packages.group: updated. etc/README.md: updated. --- etc/README.md | 25 ++++++++++++++----------- 1 file changed, 14 insertions(+), 11 deletions(-) (limited to 'etc') diff --git a/etc/README.md b/etc/README.md index 001a583e..98f1d35b 100644 --- a/etc/README.md +++ b/etc/README.md @@ -328,28 +328,31 @@ contain package variable defaults, optionally the alphabetically sorted list of packages, if any, in ``_PACKAGES``, and their package variables sorted alphabetically with the exception of ``${PKG_DEPENDS}`` (if present,) ``${PKG_SHA256SUM}``, ``${PKG_URL}``, and ``${PKG_VERSION}``, and/or ``${PKG_URLS_GIT}``, -which are specified in this order. - -Additionally, single package files may be added beneath ``groups.d/[0-9][0-9][0-9]..d/``, -named ``.package`` containing the package's variables, with one of the two following -epilogues: +which are specified in this order. Build group files require the following epilogue, the +parameters enclosed in square brackets being optional: ```shell - -ex_pkg_register "" "${RTL_FILEOP_SOURCE_FNAME}"; +ex_pkg_register_group "" "${RTL_FILEOP_SOURCE_FNAME}" [["owner|copy"] ["auto|noauto"]]; # vim:filetype=sh textwidth=0 ``` -or, if the group name should not be inferred automatically and explicitly set: +If ``copy`` is specified, the build group will copy all of its packages from their respective +build groups without taking ownership thereof, if ``owner`` is specified, the default, the build +group owns all of its packages. If ``noauto`` is specified, the build group will not be added to +the list of build groups to build by default, if ``auto`` is specified, the build group will be +added to the list of build groups to build by default. + +Additionally, single package files may be added beneath ``groups.d/[0-9][0-9][0-9]..d/``, +named ``.package`` containing the package's variables, with the following epilogue, +the parameters enclosed in square brackets being optional: ```shell - -ex_pkg_register "" "${RTL_FILEOP_SOURCE_FNAME}" ""; +ex_pkg_register "" "${RTL_FILEOP_SOURCE_FNAME}" [""]; # vim:filetype=sh textwidth=0 ``` - + 1. Pick a build group according to the criteria mentioned and specifiy the set of package variables required (see above and section [4.4](#44-package-variables)) in either the corresponding group file or a single package file; in the former case, do also add the -- cgit v1.2.3