some doc cleanup.

1 files changed, 61 insertions, 46 deletions

diff --git a/doc/index.html b/doc/index.html
index 76136c4..f3d7521 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -43,14 +43,15 @@ replacement for
 <a href="ftp://ftp.cistron.nl/pub/people/miquels/sysvinit/">sysvinit</a>
 and other init schemes. <i>runit</i> runs on <b>GNU/Linux</b>,
 <b>OpenBSD</b>, <b>FreeBSD</b>, <b>MacOSX</b>, <b>Solaris</b>, and can
-easily be adapted to other unix operating systems.
-If <i>runit</i> runs for you on any other operating system, please let me
-know.
+easily be adapted to other Unix operating systems.
+If <i>runit</i> runs for you on any other operating system, please
+<a href="mailto:supervision@list.skarnet.org">let me know</a>.
 <p>
 <b>Warning:</b> Replacing <i>sysvinit</i> or <i>init</i> can cause the
-system's boot to fail. Make sure you are able to recover and repair your
-system, for example if you run a boot loader, it should be able to pass
-<tt>init=/bin/sh</tt> to the kernel.
+system's boot to fail.
+Make sure you are able to recover and repair your system, for example if you
+run a boot loader, it should be able to pass <tt>init=/bin/sh</tt> to the
+kernel.
 <hr>
 <i>runit</i> is discussed on the
 <a href="http://skarnet.org/lists/#supervision">
@@ -58,8 +59,13 @@ system, for example if you run a boot loader, it should be able to pass
 mailing list. To subscribe send an empty email to
 <a href="mailto:supervision-subscribe@list.skarnet.org">
 &lt;supervision-subscribe@list.skarnet.org&gt;</a>.
+<p>
+Mailing list archives are available at
+<a href="http://skarnet.org/lists/archive.cgi?2">skarnet.org</a>, and
+<a href="http://news.gmane.org/gmane.comp.sysutils.supervision.general">
+gmane.org</a>.
 <hr>
-The command <a href="runit.8.html">runit</a> is intended to run as Unix
+The program <a href="runit.8.html">runit</a> is intended to run as Unix
 process no 1, it is automatically started by the
 <a href="runit-init.8.html">runit-init</a> <tt>/sbin/init</tt>-replacement
 if this is started by the kernel.
@@ -69,46 +75,49 @@ if this is started by the kernel.
 <ul>
   <li><b>Stage 1:</b><br>
   <i>runit</i> starts <tt>/etc/runit/1</tt> and waits for it to
-  terminate. The system's one time initialization tasks are done here.
-  <tt>/etc/runit/1</tt> has full control of <tt>/dev/console</tt> to be
+  terminate.
+  The system's one time initialization tasks are done here.
+  <tt>/etc/runit/1</tt> has full control over <tt>/dev/console</tt> to be
   able to start an emergency shell if the one time initialization tasks
   fail.
   <li><b>Stage 2:</b><br>
   <i>runit</i> starts <tt>/etc/runit/2</tt> which should not return
-  until the system is going to halt or reboot, if it crashes, it will be
-  restarted. Normally, <tt>/etc/runit/2</tt> runs
+  until the system is going to halt or reboot; if it crashes, it will be
+  restarted.
+  Normally, <tt>/etc/runit/2</tt> runs
   <a href="runsvdir.8.html">runsvdir</a>.
-  In Stage 2 <i>runit</i> optionally handles an INT signal
-  (ctrl-alt-del keyboard request on Linux/i386).
+  In Stage 2 <i>runit</i> optionally handles an INT signal (ctrl-alt-del
+  keyboard request on Linux/i386).
   <li><b>Stage 3:</b><br>
   If <i>runit</i> is told to halt or reboot the system, or the Stage 2
   returns without errors, it terminates Stage 2 if it is running and runs
-  <tt>/etc/runit/3</tt>. The systems tasks to shutdown and halt or
-  reboot are done here.
+  <tt>/etc/runit/3</tt>.
+  The systems tasks to shutdown and halt or reboot are done here.
 </ul>
 These are working examples for Debian woody:
 <a href="debian/1">/etc/runit/1</a>,
 <a href="debian/2">/etc/runit/2</a>,
 <a href="debian/3">/etc/runit/3</a>.
 <p>
-The command <a href="runit-init.8.html">runit-init</a> is intended to
-replace <tt>/sbin/init</tt>. sysvinit's command <tt>shutdown</tt> will
-keep working. On *BSD systems use <b><tt>init 0</tt></b> for system halt
-and <b><tt>init 6</tt></b> for reboot.
+The program <a href="runit-init.8.html">runit-init</a> is intended to
+replace <tt>/sbin/init</tt>.
+sysvinit's command <tt>shutdown</tt> will keep working.
+On *BSD systems use <b><tt>init 0</tt></b> for system halt and
+<b><tt>init 6</tt></b> for reboot.
 <a href="runlevels.html">Runlevels</a> are handled through the
 <a href="runsvdir.8.html">runsvdir</a> and
 <a href="runsvchdir.8.html">runsvchdir</a> programs.
 Service <a href="dependencies.html">dependencies</a> are resolved
 automatically.
 <p>
-<i>runit</i> is optimized for reliability and small size. The amount of
-code in process no 1 should be minimal.
+<i>runit</i> is optimized for reliability and small size.
+The amount of code in process no 1 should be minimal.
 <hr>
-<b><i>runit</i> in use</b>: I replaced <i>sysvinit</i> with <i>runit</i>
-on several server systems and a laptop running Debian/GNU Linux sarge, woody
-and potato, and did not encounter any problems. Of course also the
-<tt>smarden.org</tt> content server is running with <i>runit</i> as process
-no 1, here is an example:
+<b><i>runit</i> in use</b>:
+I replaced <i>sysvinit</i> successfully with <i>runit</i> on several server
+systems and a laptop running Debian/GNU Linux sarge, woody, and potato.
+Of course also the <tt>smarden.org</tt> content server is running with
+<i>runit</i> as process no 1, here is an example:
 <pre>
  # strings /proc/1/exe |grep Id
  &#36;Id: runit.c,v 1.7 2002/02/13 09:59:52 pape Exp &#36;
@@ -174,13 +183,13 @@ no 1, here is an example:
 </pre>
 <hr>
 See <a href="install.html">How to install runit</a> for installing
-<i>runit</i> and <a href="replaceinit.html">How to replace init</a> for
-smoothly escaping from <i>sysvinit</i>.
+<i>runit</i>, and <a href="replaceinit.html">How to replace init</a> for
+configuring <i>runit</i> to run as process no 1.
 <hr>
-If <i>runit</i> on linux is compiled and linked with
-<a href="http://www.fefe.de/dietlibc/">dietlibc</a> it yields in a statically
-linked <tt>runit</tt> binary of 8.5k size and this <tt>ps axuw</tt> output
-on my system:
+If <i>runit</i> on Linux is compiled and linked with the
+<a href="http://www.fefe.de/dietlibc/">dietlibc</a>, it yields in a
+statically linked <tt>runit</tt> binary of 8.5k size and this
+<tt>ps axuw</tt> output on my system:
 <pre>
   USER       PID %CPU %MEM   VSZ  RSS TTY      STAT START   TIME COMMAND
   root         1  0.0  0.0    20   16 ?        S     2002   0:02 runit
@@ -193,20 +202,26 @@ for recent informations.
 <hr>
 Related links:
 <ul>
-  <li><a href="http://packages.debian.org/runit">
-  runit Debian package</a>
-  <li><a href="http://www.fefe.de/minit/">
-  minit</a>
-  <li><a href="http://multivac.cwru.edu/svscan-1/">
-  svscan as process 1</a>
-  <li><a href="ftp://ftp.cistron.nl/pub/people/miquels/sysvinit/">
-  sysvinit</a>
-  <li><a href="http://www.openbsd.org/cgi-bin/cvsweb/src/sbin/init/">
-  OpenBSD's init</a>
-  <li><a href="http://www.freebsd.org/cgi/cvsweb.cgi/src/sbin/init/">
-  FreeBSD's init</a>
-  <li><a href="http://www.atnf.csiro.au/~rgooch/linux/boot-scripts/">
-  Richard Gooch's Linux Boot Scripts</a>
+<li><a href="http://packages.debian.org/runit">
+runit Debian package</a>
+<li><a href="http://packages.debian.org/runit-run">
+runit-run Debian package</a>
+<li><a href="http://www.freshports.org/sysutils/runit/">
+runit FreeBSD port</a>
+<li><a href="http://rpmfind.net/linux/rpm2html/search.php?query=runit">
+runit RPMs</a>
+<li><a href="http://www.fefe.de/minit/">
+minit</a> - a small yet feature-complete init
+<li><a href="http://multivac.cwru.edu/svscan-1/">
+svscan as process 1</a> - by Paul Jarc
+<li><a href="ftp://ftp.cistron.nl/pub/people/miquels/sysvinit/">
+sysvinit</a> - source code
+<li><a href="http://www.openbsd.org/cgi-bin/cvsweb/src/sbin/init/">
+OpenBSD's init</a> - CVS repository
+<li><a href="http://www.freebsd.org/cgi/cvsweb.cgi/src/sbin/init/">
+FreeBSD's init</a> - CVS repository
+<li><a href="http://www.atnf.csiro.au/~rgooch/linux/boot-scripts/">
+Linux Boot Scripts</a> - from Richard Gooch
 </ul>
 <hr>
 <address><a href="mailto:pape@smarden.org">