From owner-svn-doc-all@FreeBSD.ORG Fri Feb 13 16:28:32 2015 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 2216255B; Fri, 13 Feb 2015 16:28:32 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id DFDC46A0; Fri, 13 Feb 2015 16:28:31 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t1DGSVLe058786; Fri, 13 Feb 2015 16:28:31 GMT (envelope-from brd@FreeBSD.org) Received: (from brd@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t1DGSVGV058785; Fri, 13 Feb 2015 16:28:31 GMT (envelope-from brd@FreeBSD.org) Message-Id: <201502131628.t1DGSVGV058785@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: brd set sender to brd@FreeBSD.org using -f From: Brad Davis Date: Fri, 13 Feb 2015 16:28:31 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 13 Feb 2015 16:28:32 -0000 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="-p $pidfile - run_rc_command "$1" - Unless there is a good reason to start the service - earlier, all ports scripts should use: + 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: REQUIRE: LOGIN - If the service runs as a particular user (other than root) - this is mandatory. + If the startup script launches a daemon that must be + shutdown, the following will trigger a stop of the service on + system shutdown: KEYWORD: shutdown - 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. + If the script is not starting a persistent service this is + not necessary. For optional configuration elements the "=" style of default variable assignment is preferable to the