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>