From owner-svn-doc-head@FreeBSD.ORG Mon Feb 9 09:23:02 2015 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 46E76A40; Mon, 9 Feb 2015 09:23:02 +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 32A222FA; Mon, 9 Feb 2015 09:23:02 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t199N2sR028344; Mon, 9 Feb 2015 09:23:02 GMT (envelope-from delphij@FreeBSD.org) Received: (from delphij@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t199N2GU028342; Mon, 9 Feb 2015 09:23:02 GMT (envelope-from delphij@FreeBSD.org) Message-Id: <201502090923.t199N2GU028342@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: delphij set sender to delphij@FreeBSD.org using -f From: Xin LI Date: Mon, 9 Feb 2015 09:23:02 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46262 - head/en_US.ISO8859-1/books/porters-handbook/versions X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 09 Feb 2015 09:23:02 -0000 Author: delphij Date: Mon Feb 9 09:23:01 2015 New Revision: 46262 URL: https://svnweb.freebsd.org/changeset/doc/46262 Log: Document __FreeBSD_version 1100058 and 1100059. Modified: head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml Fri Feb 6 22:07:58 2015 (r46261) +++ head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml Mon Feb 9 09:23:01 2015 (r46262) @@ -5694,6 +5694,23 @@ 11.0-CURRENT after removal of d_thread_t (277897). + + + 1100058 + February 5, 2015 + 11.0-CURRENT after addition of support for probing + the SCSI VPD Extended Inquiry page (0x86) + (278228). + + + + 1100059 + February 9, 201511.0-CURRENT after import of xz 5.2.0, + which added multi-threaded compression and lzma + gained libthr dependency. + (278433). + From owner-svn-doc-head@FreeBSD.ORG Mon Feb 9 09:37:50 2015 Return-Path: Delivered-To: svn-doc-head@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 60C24E17; Mon, 9 Feb 2015 09:37:50 +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 4C739638; Mon, 9 Feb 2015 09:37:50 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t199boRq033670; Mon, 9 Feb 2015 09:37:50 GMT (envelope-from gjb@FreeBSD.org) Received: (from gjb@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t199boV0033669; Mon, 9 Feb 2015 09:37:50 GMT (envelope-from gjb@FreeBSD.org) Message-Id: <201502090937.t199boV0033669@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: gjb set sender to gjb@FreeBSD.org using -f From: Glen Barber Date: Mon, 9 Feb 2015 09:37:50 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46263 - head/en_US.ISO8859-1/books/porters-handbook/versions X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 09 Feb 2015 09:37:50 -0000 Author: gjb Date: Mon Feb 9 09:37:49 2015 New Revision: 46263 URL: https://svnweb.freebsd.org/changeset/doc/46263 Log: Fix build. Sponsored by: The FreeBSD Foundation Modified: head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml Mon Feb 9 09:23:01 2015 (r46262) +++ head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml Mon Feb 9 09:37:49 2015 (r46263) @@ -5705,7 +5705,7 @@ 1100059 - February 9, 2015February 9, 2015 11.0-CURRENT after import of xz 5.2.0, which added multi-threaded compression and lzma gained libthr dependency. From owner-svn-doc-head@FreeBSD.ORG Tue Feb 10 14:59:27 2015 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id B52D29AA; Tue, 10 Feb 2015 14:59:27 +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 A0362950; Tue, 10 Feb 2015 14:59:27 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t1AExRRJ043554; Tue, 10 Feb 2015 14:59:27 GMT (envelope-from skreuzer@FreeBSD.org) Received: (from skreuzer@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t1AExRjv043553; Tue, 10 Feb 2015 14:59:27 GMT (envelope-from skreuzer@FreeBSD.org) Message-Id: <201502101459.t1AExRjv043553@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: skreuzer set sender to skreuzer@FreeBSD.org using -f From: Steven Kreuzer Date: Tue, 10 Feb 2015 14:59:27 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46264 - head/en_US.ISO8859-1/htdocs/donations X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 10 Feb 2015 14:59:27 -0000 Author: skreuzer Date: Tue Feb 10 14:59:26 2015 New Revision: 46264 URL: https://svnweb.freebsd.org/changeset/doc/46264 Log: Document the donation of a Macbook Pro from Xin Xu to jmg Approved by: hrs (mentor) Modified: head/en_US.ISO8859-1/htdocs/donations/donors.xml Modified: head/en_US.ISO8859-1/htdocs/donations/donors.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/donations/donors.xml Mon Feb 9 09:37:49 2015 (r46263) +++ head/en_US.ISO8859-1/htdocs/donations/donors.xml Tue Feb 10 14:59:26 2015 (r46264) @@ -2994,6 +2994,13 @@ marcel received + + + Xin Xu <railwaycat@gmail.com> + 15 inch MacBook Pro + jmg + received + From owner-svn-doc-head@FreeBSD.ORG Tue Feb 10 21:31:18 2015 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 35E17C53; Tue, 10 Feb 2015 21:31:18 +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 208EFB50; Tue, 10 Feb 2015 21:31:18 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t1ALVIXZ034802; Tue, 10 Feb 2015 21:31:18 GMT (envelope-from pawel@FreeBSD.org) Received: (from pawel@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t1ALVHR2034801; Tue, 10 Feb 2015 21:31:17 GMT (envelope-from pawel@FreeBSD.org) Message-Id: <201502102131.t1ALVHR2034801@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: pawel set sender to pawel@FreeBSD.org using -f From: Pawel Pekala Date: Tue, 10 Feb 2015 21:31:17 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46265 - head/en_US.ISO8859-1/articles/contributors X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 10 Feb 2015 21:31:18 -0000 Author: pawel (ports committer) Date: Tue Feb 10 21:31:17 2015 New Revision: 46265 URL: https://svnweb.freebsd.org/changeset/doc/46265 Log: For devel/rubygem-rodzilla PR: 196812 Modified: head/en_US.ISO8859-1/articles/contributors/contrib.additional.xml Modified: head/en_US.ISO8859-1/articles/contributors/contrib.additional.xml ============================================================================== --- head/en_US.ISO8859-1/articles/contributors/contrib.additional.xml Tue Feb 10 14:59:26 2015 (r46264) +++ head/en_US.ISO8859-1/articles/contributors/contrib.additional.xml Tue Feb 10 21:31:17 2015 (r46265) @@ -4745,6 +4745,11 @@ + Jin-Sih Lin + linpct@gmail.com + + + Jo Rhett jrhett@netconsonance.com From owner-svn-doc-head@FreeBSD.ORG Thu Feb 12 17:59:52 2015 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 614034B7; Thu, 12 Feb 2015 17:59:52 +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 4C13E3FC; Thu, 12 Feb 2015 17:59:52 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t1CHxqYq012041; Thu, 12 Feb 2015 17:59:52 GMT (envelope-from jgh@FreeBSD.org) Received: (from jgh@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t1CHxpGm012039; Thu, 12 Feb 2015 17:59:51 GMT (envelope-from jgh@FreeBSD.org) Message-Id: <201502121759.t1CHxpGm012039@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: jgh set sender to jgh@FreeBSD.org using -f From: Jason Helfman Date: Thu, 12 Feb 2015 17:59:51 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46266 - in head/en_US.ISO8859-1/books/fdp-primer: docbook-markup structure X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 12 Feb 2015 17:59:52 -0000 Author: jgh Date: Thu Feb 12 17:59:51 2015 New Revision: 46266 URL: https://svnweb.freebsd.org/changeset/doc/46266 Log: - remove class defining directory from ftp-primer and advise to use filename Differential Revision: https://reviews.freebsd.org/D1740 Approved by: bcr (mentor) Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml head/en_US.ISO8859-1/books/fdp-primer/structure/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Tue Feb 10 21:31:17 2015 (r46265) +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Thu Feb 12 17:59:51 2015 (r46266) @@ -1703,9 +1703,7 @@ This is the file called 'foo2' Files, Directories, Extensions, Device Names To refer to the name of a file, a directory, a file - extension, or a device name, use filename. For - directory names, set the class attribute to - directory. + extension, or a device name, use filename. <tag>filename</tag> @@ -1713,8 +1711,7 @@ This is the file called 'foo2' Usage: paraThe source for the Handbook in English is found in - filename - class="directory"/usr/doc/en_US.ISO8859-1/books/handbook/filename. + filename/usr/doc/en_US.ISO8859-1/books/handbook/filename. The main file is called filenamebook.xmlfilename. There is also a filenameMakefilefilename and a number of files with a filename.entfilename extension.para @@ -1726,8 +1723,7 @@ This is the file called 'foo2' Appearance: The source for the Handbook in English is found in - /usr/doc/en_US.ISO8859-1/books/handbook/. + /usr/doc/en_US.ISO8859-1/books/handbook/. The main file is called book.xml. There is also a Makefile and a number of files with a .ent extension. Modified: head/en_US.ISO8859-1/books/fdp-primer/structure/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/structure/chapter.xml Tue Feb 10 21:31:17 2015 (r46265) +++ head/en_US.ISO8859-1/books/fdp-primer/structure/chapter.xml Thu Feb 12 17:59:51 2015 (r46266) @@ -94,8 +94,8 @@ - lang.encoding + + lang.encoding One directory exists for each available translation and encoding of the documentation, for example From owner-svn-doc-head@FreeBSD.ORG Fri Feb 13 15:26:57 2015 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 7066EB73; Fri, 13 Feb 2015 15:26:57 +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 5B799DF6; Fri, 13 Feb 2015 15:26:57 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t1DFQv20029504; Fri, 13 Feb 2015 15:26:57 GMT (envelope-from brd@FreeBSD.org) Received: (from brd@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t1DFQvQF029503; Fri, 13 Feb 2015 15:26:57 GMT (envelope-from brd@FreeBSD.org) Message-Id: <201502131526.t1DFQvQF029503@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 15:26:57 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46267 - head/en_US.ISO8859-1/htdocs/releases/10.1R X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 13 Feb 2015 15:26:57 -0000 Author: brd Date: Fri Feb 13 15:26:56 2015 New Revision: 46267 URL: https://svnweb.freebsd.org/changeset/doc/46267 Log: Point to the 10.1 relnotes for upgrading. Submitted by: Barnerd / IonutVan (via #bsddocs) Modified: head/en_US.ISO8859-1/htdocs/releases/10.1R/installation.html Modified: head/en_US.ISO8859-1/htdocs/releases/10.1R/installation.html ============================================================================== --- head/en_US.ISO8859-1/htdocs/releases/10.1R/installation.html Thu Feb 12 17:59:51 2015 (r46266) +++ head/en_US.ISO8859-1/htdocs/releases/10.1R/installation.html Fri Feb 13 15:26:56 2015 (r46267) @@ -20,7 +20,7 @@ Handbook provides more in-depth information about the installation program itself, including a guided walk-through with screenshots.

2. Upgrading FreeBSD

If you are upgrading from a previous release of FreeBSD, please - read upgrading + read upgrading section in the Release Notes for notable incompatibilities carefully.

2.1. Upgrading from Source

The procedure for doing a source code based update is described in From owner-svn-doc-head@FreeBSD.ORG Fri Feb 13 15:43:43 2015 Return-Path: Delivered-To: svn-doc-head@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 1AB57430; Fri, 13 Feb 2015 15:43:43 +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 E0D83FB5; Fri, 13 Feb 2015 15:43:42 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t1DFhgu9038847; Fri, 13 Feb 2015 15:43:42 GMT (envelope-from brd@FreeBSD.org) Received: (from brd@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t1DFhgOl038846; Fri, 13 Feb 2015 15:43:42 GMT (envelope-from brd@FreeBSD.org) Message-Id: <201502131543.t1DFhgOl038846@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 15:43:42 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46268 - 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-head@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 13 Feb 2015 15:43:43 -0000 Author: brd Date: Fri Feb 13 15:43:42 2015 New Revision: 46268 URL: https://svnweb.freebsd.org/changeset/doc/46268 Log: Improve the wording around startup scripts to be clearer. 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 15:26:56 2015 (r46267) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Fri Feb 13 15:43:42 2015 (r46268) @@ -4367,15 +4367,18 @@ post-patch: article on practical aspects of rc.d scripting. - One or more rc.d scripts can be - installed: + With a mythical port called + doorman, which needs to start a + doormand daemon. Add the following + to the Makefile: USE_RC_SUBR= doormand - Scripts must be placed in the files + Multiple scripts may be listed and will be installed. + Scripts must be placed in the files subdirectory and a .in suffix must be added to their filename. Standard SUB_LIST - expansions will be used for this file. Use of the + expansions will be ran against this file. Use of the %%PREFIX%% and %%LOCALBASE%% expansions is strongly encouraged as well. More on SUB_LIST in @@ -4387,7 +4390,8 @@ post-patch: by ports) are included in the overall &man.rcorder.8; of the base system. - Example simple rc.d script: + An example simple rc.d script to start + the doormand daemon: #!/bin/sh From owner-svn-doc-head@FreeBSD.ORG Fri Feb 13 16:02:10 2015 Return-Path: Delivered-To: svn-doc-head@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 E55B3683; Fri, 13 Feb 2015 16:02:09 +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 D0B441E3; Fri, 13 Feb 2015 16:02:09 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t1DG29lt048312; Fri, 13 Feb 2015 16:02:09 GMT (envelope-from brd@FreeBSD.org) Received: (from brd@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t1DG29to048311; Fri, 13 Feb 2015 16:02:09 GMT (envelope-from brd@FreeBSD.org) Message-Id: <201502131602.t1DG29to048311@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:02:09 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46269 - 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-head@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 13 Feb 2015 16:02:10 -0000 Author: brd Date: Fri Feb 13 16:02:08 2015 New Revision: 46269 URL: https://svnweb.freebsd.org/changeset/doc/46269 Log: Sprinkle replaceable tags in the startup script section Reviewed by: brueffer bjk 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 15:43:42 2015 (r46268) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Fri Feb 13 16:02:08 2015 (r46269) @@ -4372,7 +4372,7 @@ post-patch: doormand daemon. Add the following to the Makefile: - USE_RC_SUBR= doormand + USE_RC_SUBR= doormand Multiple scripts may be listed and will be installed. Scripts must be placed in the files @@ -4397,37 +4397,37 @@ post-patch: # $FreeBSD$ # -# PROVIDE: doormand +# PROVIDE: doormand # REQUIRE: LOGIN # KEYWORD: shutdown # # Add these lines to /etc/rc.conf.local or /etc/rc.conf # to enable this service: # -# doormand_enable (bool): Set to NO by default. -# Set it to YES to enable doormand. -# doormand_config (path): Set to %%PREFIX%%/etc/doormand/doormand.cf +# doormand_enable (bool): Set to NO by default. +# Set it to YES to enable doormand. +# doormand_config (path): Set to %%PREFIX%%/etc/doormand/doormand.cf # by default. . /etc/rc.subr -name=doormand -rcvar=doormand_enable +name=doormand +rcvar=doormand_enable load_rc_config $name -: ${doormand_enable:="NO"} -: ${doormand_config="%%PREFIX%%/etc/doormand/doormand.cf"} +: ${doormand_enable:="NO"} +: ${doormand_config="%%PREFIX%%/etc/doormand/doormand.cf"} command=%%PREFIX%%/sbin/${name} pidfile=/var/run/${name}.pid -command_args="-p $pidfile -f $doormand_config" +command_args="-p $pidfile -f $doormand_config" run_rc_command "$1" Unless there is a good reason to start the service - earlier, all ports scripts should use + earlier, all ports scripts should use: REQUIRE: LOGIN @@ -4447,9 +4447,9 @@ run_rc_command "$1" ":=" style here, since the former sets a default value only if the variable is unset, and the latter sets one if the variable is unset or null. A user - might very well include something like + might very well include something like: - doormand_flags="" + doormand_flags="" in their rc.conf.local, and a variable substitution using ":=" would From owner-svn-doc-head@FreeBSD.ORG Fri Feb 13 16:28:32 2015 Return-Path: Delivered-To: svn-doc-head@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-head@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the doc tree for head 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