Update inittab docs

1 files changed, 42 insertions, 10 deletions

diff --git a/docs/busybox.sgml b/docs/busybox.sgml
index 1542337dd..184814125 100644
--- a/docs/busybox.sgml
+++ b/docs/busybox.sgml
@@ -1538,24 +1538,56 @@
                 <sect2>
                     <title>action</title>
 
+
+                        <para>
+                        Valid actions include: sysinit, respawn, askfirst, wait, 
+                        once, and ctrlaltdel.
+                        </para>
+
+
+                        <para>
+                        The available actions can be classified into two groups: actions
+                        that are run only once, and actions that are re-run when the specified
+                        process exits.
+                        </para>
+
                         <para>
-                        Valid actions include: sysinit, respawn,
-                        askfirst, wait, once, and ctrlaltdel.
+                        Run only-once actions:
                         </para>
 
                         <para>
-                        askfirst acts just like respawn, but before
-                        running the specified process it displays the
-                        line "Please press Enter to activate this
-                        console." and then waits for the user to press
-                        enter before starting the specified process.
+                        'sysinit' is the first item run on boot.  init waits until all
+                        sysinit actions are completed before continuing.  Following the
+                        completion of all sysinit actions, all 'wait' actions are run.
+                        'wait' actions, like  'sysinit' actions, cause init to wait until
+                        the specified task completes.  'once' actions are asyncronous,
+                        therefore, init does not wait for them to complete.  'ctrlaltdel'
+                        actions are run immediately before init causes the system to reboot
+                        (unmounting filesystems with a 'ctrlaltdel' action is a very good
+                         idea).
                         </para>
 
                         <para>
-                        Unrecognized actions (like initdefault) will
-                        cause init to emit an error message, and then go
-                        along with its business.
+                        Run repeatedly actions:
                         </para>
+
+                        <para>
+                        'respawn' actions are run after the 'once' actions.  When a process
+                        started with a 'respawn' action exits, init automatically restarts
+                        it.  Unlike sysvinit, BusyBox init does not stop processes from
+                        respawning out of control.  The 'askfirst' actions acts just like
+                        respawn, except that before running the specified process it
+                        displays the line "Please press Enter to activate this console."
+                        and then waits for the user to press enter before starting the
+                        specified process.  
+                        </para>
+
+                        <para>
+                        Unrecognized actions (like initdefault) will cause init to emit an
+                        error message, and then go along with its business.  All actions are
+                        run in the reverse order from how they appear in /etc/inittab.
+                        </para>
+
                 </sect2>
 
                 <sect2>