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.

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