From owner-svn-doc-all@FreeBSD.ORG Fri Nov 2 09:10:49 2012 Return-Path: Delivered-To: svn-doc-all@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id EB17EB8F; Fri, 2 Nov 2012 09:10:48 +0000 (UTC) (envelope-from marc@blackend.org) Received: from smtp6-g21.free.fr (smtp6-g21.free.fr [IPv6:2a01:e0c:1:1599::15]) by mx1.freebsd.org (Postfix) with ESMTP id 28C378FC15; Fri, 2 Nov 2012 09:10:38 +0000 (UTC) Received: from emphyrio.blackend.org (unknown [88.179.1.53]) by smtp6-g21.free.fr (Postfix) with ESMTP id 1A0BD822B8; Fri, 2 Nov 2012 10:10:30 +0100 (CET) Received: from emphyrio.blackend.org (localhost [127.0.0.1]) by emphyrio.blackend.org (8.14.5/8.14.4) with ESMTP id qA29ATuN001744; Fri, 2 Nov 2012 10:10:29 +0100 (CET) (envelope-from marc@emphyrio.blackend.org) Received: (from marc@localhost) by emphyrio.blackend.org (8.14.5/8.14.4/Submit) id qA29AT3h001743; Fri, 2 Nov 2012 10:10:29 +0100 (CET) (envelope-from marc) Date: Fri, 2 Nov 2012 10:10:29 +0100 From: Marc Fonvieille To: Warren Block Subject: Re: svn commit: r39872 - head/en_US.ISO8859-1/books/handbook/config Message-ID: <20121102091029.GA1463@emphyrio.blackend.org> References: <201210310241.q9V2f3rx030600@svn.freebsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <201210310241.q9V2f3rx030600@svn.freebsd.org> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 8.3-STABLE User-Agent: Mutt/1.5.21 (2010-09-15) Cc: svn-doc-head@FreeBSD.org, svn-doc-all@FreeBSD.org, doc-committers@FreeBSD.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 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, 02 Nov 2012 09:10:49 -0000 On Wed, Oct 31, 2012 at 02:41:03AM +0000, Warren Block wrote: > Author: wblock > Date: Wed Oct 31 02:41:03 2012 > New Revision: 39872 > URL: http://svn.freebsd.org/changeset/doc/39872 > > Log: > Remove redundant words, fix title capitalization. > > Modified: > head/en_US.ISO8859-1/books/handbook/config/chapter.xml > > Modified: head/en_US.ISO8859-1/books/handbook/config/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/handbook/config/chapter.xml Wed Oct 31 02:19:12 2012 (r39871) > +++ head/en_US.ISO8859-1/books/handbook/config/chapter.xml Wed Oct 31 02:41:03 2012 (r39872) > @@ -256,8 +256,8 @@ > implies this; it is configuration information for the > rc* files. > > - An administrator should make entries in the > - rc.conf file to override the default > + An administrator should make entries in > + rc.conf to override the default > settings from /etc/defaults/rc.conf. The > defaults file should not be copied verbatim to > /etc - it contains > @@ -269,8 +269,8 @@ > applications to separate site-wide configuration from > system-specific configuration in order to keep administration > overhead down. The recommended approach is to place > - system-specific configuration into the > - /etc/rc.conf.local file. For > + system-specific configuration into > + /etc/rc.conf.local. For > example: > > > @@ -292,14 +292,14 @@ ifconfig_fxp0="inet 10.1.1.1/8" > > > - The rc.conf file can then be > + rc.confcan then be (a whitespace is missing before the "can") Regarding this change, you are just reverting what was decided years ago to avoid having a sentence beginning without a capital letter. The same applies to the manual pages with "The .Nm utility/whatever..." thing. Respecting this principle has been a huge work... > distributed to every system using rsync or a > - similar program, while the rc.conf.local > - file remains unique. > + similar program, while rc.conf.local > + remains unique. > > Upgrading the system using &man.sysinstall.8; or > - make world will not overwrite the > - rc.conf file, so system configuration > + make world will not overwrite > + rc.conf, so system configuration > information will not be lost. [...] These changes are necessary? Till now it's what we used to do and we never got any complaints. -- Marc