[services-openrc] Adjust documentation and follow renaming

src/modules/openrccfg/openrccfg.conf

@@ -1,39 +0,0 @@
-# operccfg
-# openrc services module to set service runlevels via rc-update in the chroot
-#
-# format of the conf
-###
-# services:
-#     add:
-#         - name: foo1
-#           runlevel: default
-#         - name: foo2
-#           runlevel: nonetwork
-#     del:
-#         - name: foo3
-#           runlevel: default
-#
-# initdDir: /etc/init.d
-#
-# runlevelsDir: /etc/runlevels
-####
-# add: list of services and their runlevels to add
-# del: list of services and their runlevels to delete
-# name: the service name
-# runlevel: can hold any runlevel present on the target system
-# initdDir: holds the openrc service directory location
-# runlevelsDir: holds the runlevels directory location
-#
-# handle del with care and only use it if absolutely necessary
-# if a service is listed in the conf but is not present/detected on the target system,
-# or a runlevel does not exist, it will be ignored and skipped
-#
----
-services:
-    add:
-        - name: "NetworkManager"
-          runlevel: "default"
-
-initdDir: /etc/init.d
-
-runlevelsDir: /etc/runlevels

src/modules/services-openrc/module.desc

@@ -1,5 +1,5 @@
 ---
 type:       "job"
-name:       "openrccfg"
+name:       "services-openrc"
 interface:  "python"
 script:     "main.py"

src/modules/services-openrc/services-openrc.conf

@@ -0,0 +1,34 @@
+# openrc services module to modify service runlevels via rc-update in the chroot
+#
+# Services can be added (to any runlevel, or multiple runlevels) or deleted.
+# Handle del with care and only use it if absolutely necessary.
+#
+# if a service is listed in the conf but is not present/detected on the target system,
+# or a runlevel does not exist, it will be ignored and skipped; a warning is logged.
+#
+---
+# initdDir: holds the openrc service directory location
+initdDir: /etc/init.d
+
+# runlevelsDir: holds the runlevels directory location
+runlevelsDir: /etc/runlevels
+
+# services: each subkey of *services* is an action to take;
+# supported actions are "add" and "del". The each subkey
+# has a list of entries as value, and each entry has two
+# fields:
+#   - name: the service name
+#   - runlevel: can hold any runlevel present on the target system
+#
+# # Example services:
+# services:
+#     add:
+#         - name: foo1
+#           runlevel: default
+#         - name: foo2
+#           runlevel: nonetwork
+#     del:
+#         - name: foo3
+#           runlevel: default
+services: []
+