Admin: ch07: finish /etc/conf.d clade

1 files changed, 12 insertions, 70 deletions

diff --git a/src/admin/7_config.xml b/src/admin/7_config.xml
index 82c1548..5e58987 100644
--- a/src/admin/7_config.xml
+++ b/src/admin/7_config.xml
@@ -100,7 +100,7 @@
         </section>
         <section role="NotInToc">
             <title>Detailed Information</title>
-            <para>The following variables are configurable in the <filename>/etc/conf.d/bootmisc</filename> file:</para>
+            <para>The <filename>/etc/conf.d/bootmisc</filename> file defines the following configuration variables:</para>
             <table frame="none">
                 <title>Configurable variables in <filename>/etc/conf.d/bootmisc</filename></title>
                 <tgroup cols="3" align="left" colsep="1" rowsep="1">
@@ -179,7 +179,7 @@
         </section>
         <section role="NotInToc">
             <title>Detailed Information</title>
-            <para>The following variables are configurable in the <filename>/etc/conf.d/fsck</filename> file:</para>
+            <para>The <filename>/etc/conf.d/fsck</filename> file defines the following configuration variables:</para>
             <table frame="none">
                 <title>Configurable variables in <filename>/etc/conf.d/fsck</filename></title>
                 <tgroup cols="3" align="left" colsep="1" rowsep="1">
@@ -249,7 +249,7 @@
             <important><title>Important</title><para>Changes to this file will not take effect until the system is restarted.</para></important>
         </section>
     </section>
-    <section>
+    <!-- <section>
         <title><filename>/etc/conf.d/hwclock</filename>: System time configuration</title>
         <section role="NotInToc">
             <title>Purpose</title>
@@ -263,35 +263,22 @@
             <title>Detailed Information</title>
             <para></para>
         </section>
-    </section>
-    <section>
-        <title><filename>/etc/conf.d/keymaps</filename>: Keyboard layout configuration</title>
-        <section role="NotInToc">
-            <title>Purpose</title>
-            <para>The <filename>/etc/conf.d/keymaps</filename> file determines certain behaviours of the keyboard connected to the system console.</para>
-        </section>
-        <section role="NotInToc">
-            <title>Syntax</title>
-            <para>Shell script.  Variables are in lowercase.  Booleans may be set as <literal>YES</literal> or <literal>NO</literal>.</para>
-        </section>
-        <section role="NotInToc">
-            <title>Detailed Information</title>
-            <para>The <filename>/etc/conf.d/keymaps</filename> file </para>
-        </section>
-    </section>
+    </section> -->
     <section>
         <title><filename>/etc/conf.d/modules</filename>: Kernel module configuration</title>
         <section role="NotInToc">
             <title>Purpose</title>
-            <para>The <filename>/etc/conf.d/</filename> file </para>
+            <para>The <filename>/etc/conf.d/modules</filename> file specifies additional kernel modules to load during system initialisation.</para>
         </section>
         <section role="NotInToc">
             <title>Syntax</title>
-            <para>Shell script.  Variables are in </para>
+            <para>Shell script.  Variables are in lowercase.</para>
         </section>
         <section role="NotInToc">
             <title>Detailed Information</title>
-            <para></para>
+            <para>The <filename>/etc/conf.d/modules</filename> file allows you to specify additional kernel modules for the system to load during initialisation.  This is typically unnecessary as the <package>eudev</pacakge> system will automatically load any modules required for the correct functioning of your hardware.  However, some advanced use cases may require the loading of additional kernel modules.</para>
+            <para>The <filename>/etc/conf.d/modules</filename> file defines the <varname>modules</varname> configuration variables.  This is a space-delimited list of modules to load.</para>
+            <para>For each module specified, an additional variable, <varname>module_<replaceable>MODNAME</replaceable>_args</varname>, is defined, where <replaceable>MODNAME</replaceable> is the name of the module.  The <varname>module_<replaceable>MODNAME</replaceable>_args</varname> variable controls the arguments passed to the module.  Refer to the documentation for each module for a list of arguments it supports.</para>
         </section>
     </section>
     <section>
@@ -310,63 +297,18 @@
         </section>
     </section>
     <section>
-        <title><filename>/etc/conf.d/netmount</filename>: Network file system configuration</title>
-        <section role="NotInToc">
-            <title>Purpose</title>
-            <para>The <filename>/etc/conf.d/</filename> file </para>
-        </section>
-        <section role="NotInToc">
-            <title>Syntax</title>
-            <para>Shell script.  Variables are in </para>
-        </section>
-        <section role="NotInToc">
-            <title>Detailed Information</title>
-            <para></para>
-        </section>
-    </section>
-    <section>
-        <title><filename>/etc/conf.d/swap</filename>: Network swap file configuration</title>
-        <section role="NotInToc">
-            <title>Purpose</title>
-            <para>The <filename>/etc/conf.d/</filename> file </para>
-        </section>
-        <section role="NotInToc">
-            <title>Syntax</title>
-            <para>Shell script.  Variables are in </para>
-        </section>
-        <section role="NotInToc">
-            <title>Detailed Information</title>
-            <para></para>
-        </section>
-    </section>
-    <section>
-        <title><filename>/etc/conf.d/udev-trigger</filename>: Hardware hot-plug configuration</title>
-        <section role="NotInToc">
-            <title>Purpose</title>
-            <para>The <filename>/etc/conf.d/</filename> file </para>
-        </section>
-        <section role="NotInToc">
-            <title>Syntax</title>
-            <para>Shell script.  Variables are in </para>
-        </section>
-        <section role="NotInToc">
-            <title>Detailed Information</title>
-            <para></para>
-        </section>
-    </section>
-    <section>
         <title><filename>/etc/conf.d/urandom</filename>: Random number configuration</title>
         <section role="NotInToc">
             <title>Purpose</title>
-            <para>The <filename>/etc/conf.d/</filename> file </para>
+            <para>The <filename>/etc/conf.d/urandom</filename> file specifies the path where the random number seed is stored when the system is shut down.</para>
         </section>
         <section role="NotInToc">
             <title>Syntax</title>
-            <para>Shell script.  Variables are in </para>
+            <para>Shell script.  Variables are in lowercase.</para>
         </section>
         <section role="NotInToc">
             <title>Detailed Information</title>
-            <para></para>
+            <para>The <filename>/etc/conf.d/urandom</filename> file defines a single configuration variable, <varname>urandom_seed</varname>, which specifies the path in which to save the random number seed when the system is shut down.  The default is <filename>/var/lib/misc/random-seed</filename>.  This variable must point to a path that is on the root filesystem; if <filename class="directory">/var</filename> is a separate filesystem, you must configure this variable to use a different path.</para>
         </section>
     </section>
 </chapter>