r7223 - in trunk/BOOK: introduction/welcome server/major

Bruce Dubbs bruce.dubbs at gmail.com
Mon Mar 10 10:35:17 MDT 2008


Randy McMurchy wrote:
> dj at linuxfromscratch.org wrote these words on 03/09/08 11:10 CST:
>> Author: dj
>> Date: 2008-03-09 10:10:02 -0600 (Sun, 09 Mar 2008)
>> New Revision: 7223
>> -    <bridgehead renderas="sect4">Optional (to Run the Test Suite)</bridgehead>
>> -    <para role="optional"><xref linkend="net-tools"/> (for <command>ifconfig</command>)
>> -    and <xref linkend="perl-net-dns"/></para>
>> +    <bridgehead renderas="sect4">Optional (to run the test suite)</bridgehead>
>> +    <para role="optional"><xref linkend="perl-net-dns"/></para>
>>  
>> -    <bridgehead renderas="sect4">Optional to [Re]Build Documentation</bridgehead>
>> +    <bridgehead renderas="sect4">Optional (to rebuild documentation)</bridgehead>
> 
> Actually, the Upper case is technically correct because these are
> header (Title) lines and so should use Title Case. However, I do
> like the look of lowercase. However, it probably should follow
> proper writing style.
> 
> Bruce, do you remember how Title Case works for parenthetical
> information in a Title?

It depends on the emphasis you want to give it.  In this case, I think
"Optional (to rebuild documentation)" is fine.  If it were a top level
title, it may be different.

I took a look at the MLA Handbook, but it really doesn't address the
issue.

  -- Bruce




More information about the blfs-book mailing list