dracut, dracut.8.xml: added more documentation about "[LIST]"

added examples on how to use [LIST] on the shell command line.

https://bugzilla.redhat.com/show_bug.cgi?id=767736

diff --git a/dracut b/dracut
index 9c833a8c7d4834c62d4027ee0938d7faaec5387d..f2e5febbcc9d483f1761dc377ca67dfa6bc9947d 100755 (executable)
--- a/dracut
+++ b/dracut
@@ -120,6 +120,10 @@ Creates initial ramdisk images for preloading modules
   --keep                Keep the temporary initramfs for debugging purposes
   --sshkey [SSHKEY]     Add ssh key to initramfs (use with ssh-client module)
   --ctty                Add control tty for emergency shells
+
+If [LIST] has multiple arguments, then you have to put these in quotes.
+For example:
+# dracut --add-drivers "module1 module2"  ...
 EOF
 }
 

diff --git a/dracut.8.xml b/dracut.8.xml
index 5a5df54cc99605d7660ee403994aef15cd5e4dbe..88c97c3a19c32110f3a104c4c6c503ebcf30f525 100644 (file)
--- a/dracut.8.xml
+++ b/dracut.8.xml
@@ -18,23 +18,27 @@
         <surname>Lowther</surname>
         <email>victor.lowther@gmail.com</email>
       </author>
+      <author>
+        <contrib>Developer</contrib>
+        <firstname>Philippe</firstname>
+        <surname>Seewer</surname>
+        <email>philippe.seewer@bfh.ch</email>
+      </author>
       <author>
         <contrib>Developer</contrib>
         <firstname>Warren</firstname>
         <surname>Togami</surname>
-        <email>wtogami@redhat.com</email>
       </author>
       <author>
         <contrib>Developer</contrib>
-        <firstname>Jeremy</firstname>
-        <surname>Katz</surname>
-        <email>katzj@redhat.com</email>
+        <firstname>Amadeusz</firstname>
+        <surname>Żołnowski</surname>
+        <email>aidecoe@aidecoe.name</email>
       </author>
       <author>
         <contrib>Developer</contrib>
-        <firstname>Philippe</firstname>
-        <surname>Seewer</surname>
-        <email>philippe.seewer@bfh.ch</email>
+        <firstname>Jeremy</firstname>
+        <surname>Katz</surname>
       </author>
       <author>
         <contrib>Developer</contrib>
@@ -42,12 +46,6 @@
         <surname>Dillow</surname>
         <email>dave@thedillows.org</email>
       </author>
-      <author>
-        <contrib>Developer</contrib>
-        <firstname>Amadeusz</firstname>
-        <surname>Żołnowski</surname>
-        <email>aidecoe@aidecoe.name</email>
-      </author>
     </authorgroup>
   </refentryinfo>
   <refmeta>
@@ -113,6 +111,11 @@ For a complete list of kernel command line options see
 when building the initramfs.
 Modules are located in
 <filename>/usr/lib/dracut/modules.d</filename>. This parameter can be specified multiple times.</para>
+           <para>
+             If [LIST] has multiple arguments, then you have to put these in quotes.
+             For example:
+             <screen># dracut --modules "module1 module2"  ...</screen>
+           </para>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -124,6 +127,11 @@ Modules are located in
           </term>
           <listitem>
             <para>omit a space-separated list of dracut modules. This parameter can be specified multiple times.</para>
+           <para>
+             If [LIST] has multiple arguments, then you have to put these in quotes.
+             For example:
+             <screen># dracut --omit "module1 module2"  ...</screen>
+           </para>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -135,6 +143,11 @@ Modules are located in
           </term>
           <listitem>
             <para>add a space-separated list of dracut modules to the default set of modules. This parameter can be specified multiple times.</para>
+           <para>
+             If [LIST] has multiple arguments, then you have to put these in quotes.
+             For example:
+             <screen># dracut --add "module1 module2"  ...</screen>
+           </para>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -143,6 +156,11 @@ Modules are located in
           </term>
           <listitem>
             <para>force to add a space-separated list of dracut modules to the default set of modules, when -H is specified. This parameter can be specified multiple times.</para>
+           <para>
+             If [LIST] has multiple arguments, then you have to put these in quotes.
+             For example:
+             <screen># dracut --force-add "module1 module2"  ...</screen>
+           </para>
           </listitem>
         </varlistentry>
 
@@ -157,6 +175,11 @@ Modules are located in
             <para>specify a space-separated list of kernel modules to exclusively include
 in the initramfs.
 The kernel modules have to be specified without the &quot;.ko&quot; suffix. This parameter can be specified multiple times.</para>
+           <para>
+             If [LIST] has multiple arguments, then you have to put these in quotes.
+             For example:
+             <screen># dracut --drivers "kmodule1 kmodule2"  ...</screen>
+           </para>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -166,6 +189,11 @@ The kernel modules have to be specified without the &quot;.ko&quot; suffix. This
           <listitem>
             <para>specify a space-separated list of kernel modules to add to the initramfs.
 The kernel modules have to be specified without the &quot;.ko&quot; suffix. This parameter can be specified multiple times.</para>
+           <para>
+             If [LIST] has multiple arguments, then you have to put these in quotes.
+             For example:
+             <screen># dracut --add-drivers "kmodule1 kmodule2"  ...</screen>
+           </para>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -175,6 +203,11 @@ The kernel modules have to be specified without the &quot;.ko&quot; suffix. This
           <listitem>
             <para>specify a space-separated list of kernel filesystem modules to exclusively
 include in the generic initramfs. This parameter can be specified multiple times.</para>
+           <para>
+             If [LIST] has multiple arguments, then you have to put these in quotes.
+             For example:
+             <screen># dracut --filesystems "filesystem1 filesystem2"  ...</screen>
+           </para>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -253,6 +286,11 @@ include in the generic initramfs. This parameter can be specified multiple times
               <filename>dracut.conf</filename>'s specification; the
               installation is opportunistic (non-existing tools are ignored)
             </para>
+           <para>
+             If [LIST] has multiple arguments, then you have to put these in quotes.
+             For example:
+             <screen># dracut --fscks "fsck.foo barfsck"  ...</screen>
+           </para>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -450,6 +488,11 @@ TARGET directory in the final initramfs. If SOURCE is a file, it will be install
           </term>
           <listitem>
             <para>install the space separated list of files into the initramfs.</para>
+           <para>
+             If [LIST] has multiple arguments, then you have to put these in quotes.
+             For example:
+             <screen># dracut --install "/bin/foo /sbin/bar"  ...</screen>
+           </para>
           </listitem>
         </varlistentry>
         <varlistentry>