svn commit: r46270 - head/en_US.ISO8859-1/books/porters-handbook/special
Brad Davis
brd at FreeBSD.org
Fri Feb 13 16:28:32 UTC 2015
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 "="
style of default variable assignment is preferable to the
More information about the svn-doc-all
mailing list