diff options
Diffstat (limited to 'etc')
| -rw-r--r-- | etc/README.md | 25 |
1 files changed, 14 insertions, 11 deletions
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 ``<upper case group name>_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].<group name>.d/``, -named ``<package name>.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 "<package_name>" "${RTL_FILEOP_SOURCE_FNAME}"; +ex_pkg_register_group "<group name>" "${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].<group name>.d/``, +named ``<package name>.package`` containing the package's variables, with the following epilogue, +the parameters enclosed in square brackets being optional: ```shell - -ex_pkg_register "<package_name>" "${RTL_FILEOP_SOURCE_FNAME}" "<group name>"; +ex_pkg_register "<package_name>" "${RTL_FILEOP_SOURCE_FNAME}" ["<group name>"]; # 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 |