CfR: config chapter changes

[Glen Barber]

On Wed, Feb 15, 2012 at 07:02:28PM -0700, Chad Perrin wrote:
> On Wed, Feb 15, 2012 at 08:53:00PM -0500, Glen Barber wrote:
> > On Wed, Feb 15, 2012 at 08:31:33PM -0500, Eitan Adler wrote:
> > >
> > >      <indexterm><primary>sysctl</primary></indexterm>
> > >      <indexterm>
> > > @@ -1944,7 +1942,7 @@
> > >  	out of space and the update to fail.</para>
> > > 
> > >        <sect3>
> > > -	<title>More Details about Soft Updates</title>
> > > +	<title>More Details About Soft Updates</title>
> > 
> > I'm not sure this "about" should be capitalized.  I may be wrong, but I
> > do not believe prepositions should be capitalized in titles like this
> > unless they are the first word of the title.
> 
> Different capitalization standards for titles apply in different
> contexts.  Some prefer "Only the first letter capitalized" while other
> prefer "Every Single Word Is Capitalized" and still others prefer
> variations between the two.  There are even cases where sentence
> punctuation is the "standard".  I don't know what's most appropriate in
> this case.
> 

The FDP Primer suggests there should be full capitalization within
<title> tags:

http://www.freebsd.org/doc/en/books/fdp-primer/examples.html#AEN3621

However the example does not contain words such as "a", "an", "the",
"about", etc.

As the FreeBSD Handbook is occasionally printed for hard-copy
distribution, I am inclined to think the paradigm should accordingly,
for example, after an admittedly short search, the "Title Case",
mentioned here:

http://grammar.about.com/od/grammarfaq/f/capitalstitle.htm

Glen