Date: Fri, 2 Nov 2012 10:10:29 +0100 From: Marc Fonvieille <blackend@FreeBSD.org> To: Warren Block <wblock@FreeBSD.org> Cc: svn-doc-head@FreeBSD.org, svn-doc-all@FreeBSD.org, doc-committers@FreeBSD.org Subject: Re: svn commit: r39872 - head/en_US.ISO8859-1/books/handbook/config Message-ID: <20121102091029.GA1463@emphyrio.blackend.org> In-Reply-To: <201210310241.q9V2f3rx030600@svn.freebsd.org> References: <201210310241.q9V2f3rx030600@svn.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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 > <filename>rc*</filename> files.</para> > > - <para>An administrator should make entries in the > - <filename>rc.conf</filename> file to override the default > + <para>An administrator should make entries in > + <filename>rc.conf</filename> to override the default > settings from <filename>/etc/defaults/rc.conf</filename>. The > defaults file should not be copied verbatim to > <filename class="directory">/etc</filename> - 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 > - <filename>/etc/rc.conf.local</filename> file. For > + system-specific configuration into > + <filename>/etc/rc.conf.local</filename>. For > example:</para> > > <itemizedlist> > @@ -292,14 +292,14 @@ ifconfig_fxp0="inet 10.1.1.1/8"</program > </listitem> > </itemizedlist> > > - <para>The <filename>rc.conf</filename> file can then be > + <para><filename>rc.conf</filename>can 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 <command>rsync</command> or a > - similar program, while the <filename>rc.conf.local</filename> > - file remains unique.</para> > + similar program, while <filename>rc.conf.local</filename> > + remains unique.</para> > > <para>Upgrading the system using &man.sysinstall.8; or > - <command>make world</command> will not overwrite the > - <filename>rc.conf</filename> file, so system configuration > + <command>make world</command> will not overwrite > + <filename>rc.conf</filename>, so system configuration > information will not be lost.</para> [...] These changes are necessary? Till now it's what we used to do and we never got any complaints. -- Marc
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20121102091029.GA1463>