From 36f9fd56a3e6263b726a4b4d013aadfbb6a66400 Mon Sep 17 00:00:00 2001
From: Adriaan de Groot <groot@kde.org>
Date: Tue, 3 Nov 2020 12:54:19 +0100
Subject: [PATCH] [users] Expand the example config with new possibilities

---
 src/modules/users/users.conf | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/src/modules/users/users.conf b/src/modules/users/users.conf
index 8606fd224..2e09ae123 100644
--- a/src/modules/users/users.conf
+++ b/src/modules/users/users.conf
@@ -16,13 +16,29 @@
 ---
 # Used as default groups for the created user.
 # Adjust to your Distribution defaults.
+#
+# Each entry in the *defaultGroups* list is either:
+#   - a string, naming a group; this is a **non**-system group
+#     which does not need to exist in the target system; if it
+#     does not exist, it will be created.
+#   - an entry with subkeys *name*, *must_exist* and *system*;
+#     if the group *must_exist* and does not, an error is thrown
+#     and the installation fails.
+#
+#     The group is created if it does not exist, and it is
+#     created as a system group (GID < 1000) or user group
+#     (GID >= 1000) depending on the value of *system*.
 defaultGroups:
-    - users
+    - name: users
+      must_exist: true
+      system: true
     - lp
     - video
     - network
     - storage
-    - wheel
+    - name: wheel
+      must_exist: false
+      system: true
     - audio
 
 # Some Distributions require a 'autologin' group for the user.