From e1184971b59aaf98f2ad758b564adb2c86797bb7 Mon Sep 17 00:00:00 2001
From: Yaroslav Tykhiy <ytykhiy@gmail.com>
Date: Thu, 16 Aug 2007 13:08:42 +0000
Subject: [PATCH] Polish the part on "shutdown" to make it even more precise
 and understandable.

---
 .../articles/rc-scripting/article.sgml        | 26 +++++++++++++------
 1 file changed, 18 insertions(+), 8 deletions(-)

diff --git a/en_US.ISO8859-1/articles/rc-scripting/article.sgml b/en_US.ISO8859-1/articles/rc-scripting/article.sgml
index 0225680357..58c014c9b6 100644
--- a/en_US.ISO8859-1/articles/rc-scripting/article.sgml
+++ b/en_US.ISO8859-1/articles/rc-scripting/article.sgml
@@ -1140,19 +1140,29 @@ run_rc_command "$1"</programlisting>
 	    <term><literal>shutdown</literal></term>
 
 	    <listitem>
-	      <para>The script wants to run during system shutdown.
+	      <para>This keyword is to be listed
+		<emphasis>explicitly</emphasis> if the service needs
+		to be stopped before system shutdown.</para>
 
 	      <note>
-		<para>When the system is shut down,
+		<para>When the system is going to shut down,
 		  <filename>/etc/rc.shutdown</filename> runs.  It
 		  assumes that most <filename>rc.d</filename> scripts
-		  have nothing to do at system shutdown time.  For
-		  faster shutdown, <filename>/etc/rc.shutdown</filename>
-		  selectively invokes scripts with the
-		  <literal>shutdown</literal> keyword and passes
-		  the <option>faststop</option> command to them.</para>
+		  have nothing to do at that time.  Therefore
+		  <filename>/etc/rc.shutdown</filename>
+		  selectively invokes <filename>rc.d</filename>
+		  scripts with the <literal>shutdown</literal>
+		  keyword, effectively ignoring the
+		  rest of the scripts.  For even faster shutdown,
+		  <filename>/etc/rc.shutdown</filename> passes
+		  the <option>faststop</option> command to the scripts
+		  it runs so that they skip preliminary checks, e.g.,
+		  the pidfile check.  As dependent services should be
+		  stopped before their prerequisites,
+		  <filename>/etc/rc.shutdown</filename> runs the scripts
+		  in reverse dependency order.</para>
 
-		<para>Threrefore, when writing a real
+		<para>If writing a real
 		  <filename>rc.d</filename> script, you should
 		  consider whether it is relevant at system shutdown
 		  time.  E.g., if your script does its work in