svn commit: r46270 - head/en_US.ISO8859-1/books/porters-handbook/special

Author: brd
Date: Fri Feb 13 16:28:31 2015
New Revision: 46270
URL: https://svnweb.freebsd.org/changeset/doc/46270

Log:
  Clean up ordering and wording of the paragraphs to make it easier to tell what is being talked about in the startup script section.

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Fri Feb 13 16:02:08 2015	(r46269)
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Fri Feb 13 16:28:31 2015	(r46270)
@@ -4426,21 +4426,20 @@ command_args="<replaceable>-p $pidfile -
 
 run_rc_command "$1"</programlisting>
 
-    <para>Unless there is a good reason to start the service
-      earlier, all ports scripts should use:</para>
+    <para>Unless there is a very good reason to start the service
+      earlier, or it runs as a particular user (other than root), all
+      ports scripts must use:</para>
 
     <programlisting>REQUIRE: LOGIN</programlisting>
 
-    <para>If the service runs as a particular user (other than root)
-      this is mandatory.</para>
+    <para>If the startup script launches a daemon that must be
+      shutdown, the following will trigger a stop of the service on
+      system shutdown:</para>
 
     <programlisting>KEYWORD: shutdown</programlisting>
 
-    <para>is included in the script above because the mythical port
-      we are using as an example starts a service, and it must be
-      shut down cleanly when the system shuts down.  If the script
-      is not starting a persistent service this is not
-      necessary.</para>
+    <para>If the script is not starting a persistent service this is
+      not necessary.</para>
 
     <para>For optional configuration elements the &quot;=&quot;
       style of default variable assignment is preferable to the
_______________________________________________
[email protected] mailing list
http://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "[email protected]"