Date: Fri, 13 Feb 2015 16:28:31 +0000 (UTC) From: Brad Davis <brd@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46270 - head/en_US.ISO8859-1/books/porters-handbook/special Message-ID: <201502131628.t1DGSVGV058785@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201502131628.t1DGSVGV058785>