Changeset 1929

Timestamp:

Dec 28, 2008, 2:56:22 AM (15 years ago)

Author:

price

Message:

document config-init.sh better

Location:

trunk/packages/invirt-base

Files:

• debian/changelog (modified) (1 diff)
• files/lib/init/config-init.sh (modified) (1 diff)

trunk/packages/invirt-base/debian/changelog

@@ -2 +2 @@
 
   * run_parts_list: fix unclear docstring
-  * config-init.sh: degrade to non-bash gracefully
-
- -- Greg Price <price@mit.edu>  Sun, 28 Dec 2008 01:00:07 -0500
+  * config-init.sh: degrade to non-bash gracefully, document better
+
+ -- Greg Price <price@mit.edu>  Sun, 28 Dec 2008 02:46:33 -0500
 
 invirt-base (0.0.17) unstable; urgency=low

trunk/packages/invirt-base/files/lib/init/config-init.sh

@@ -1 +1 @@
 # For a package which only configures another, "parent" package.
 #
-# Global variable PARENTPACKAGE names parent; unset for no parent,
-# array for (zero or one or) many parents.
+# Usage:
+#   PACKAGE=short-name
+#   GEN_FILES=(files to generate)
+#   PARENTPACKAGE=(parent-package another-parent-package)
+#   . /lib/init/config-init.sh
+#   config_init "$1"
 #
-# Global variable PACKAGE names this package, for log message.
+# PACKAGE       - name to appear in log message
+# GEN_FILES     - files to be generated with gen-files.sh
+# PARENTPACKAGE - packages to receive start, etc, commands passed through
 #
-# If BASH_VERSION is null or unset, accepts only one parent in
-# PARENTPACKAGE, or empty for zero.
+# Global variables GEN_FILES, PARENTPACKAGE may be unset for zero
+# values, or scalars for one.  If run under sh, they cannot be arrays.
 
 . /lib/init/vars.sh