svn commit: r39872 - head/en_US.ISO8859-1/books/handbook/config

[Marc Fonvieille]

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