Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 15 Feb 2012 21:23:42 -0500
From:      Glen Barber <gjb@FreeBSD.org>
To:        Chad Perrin <perrin@apotheon.com>
Cc:        freebsd-doc@freebsd.org
Subject:   Re: CfR: config chapter changes
Message-ID:  <20120216022342.GC1837@glenbarber.us>
In-Reply-To: <20120216020228.GA1094@hemlock.hydra>
References:  <CAF6rxgnvyoibFt7ijm6GpWoeF-eAOLu3SgvhEGCBDUAV4grybw@mail.gmail.com> <alpine.GSO.1.10.1202120028440.882@multics.mit.edu> <CAF6rxgmPyVXSFRJiOZZaJQFObhCsZMHS5_5UneVrb3t=wznMhA@mail.gmail.com> <20120215040311.GB1862@glenbarber.us> <20120215213448.GA29817@hemlock.hydra> <20120215221813.GB5203@glenbarber.us> <CAF6rxgkY21MMfUWRMRnvWsTGC_2QspnfWqCKrFc_QDedTQMOoQ@mail.gmail.com> <20120216015300.GA1837@glenbarber.us> <20120216020228.GA1094@hemlock.hydra>

next in thread | previous in thread | raw e-mail | index | archive | help
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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20120216022342.GC1837>