This is the mail archive of the gdb-patches@sourceware.org mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [PATCH] consistently capitalize section names


> Date: Mon, 26 Mar 2007 11:25:26 -0700
> From: Bob Wilson <bwilson@tensilica.com>
> 
> With the exception of some of the more recently written parts of the GDB doc, 
> there appears to be a strong convention of capitalizing only the first word of 
> section titles.  (All the major words in chapter and appendix titles are 
> capitalized.)  Some of the section titles do not follow this convention.  This 
> is most visible when you read the table of contents in the TeX-generated output. 
>   This patch makes all the section titles consistently capitalized.

Thanks for doing this, but unfortunately the capitalization style
you've chosen is wrong.  The Texinfo manual says:

   * By convention, node names are capitalized just as they would be for
     section or chapter titles--initial and significant words are
     capitalized; others are not.

IOW, the correct capitalization style is, e.g., "Commands to Set
Tracepoints", not "Commands to set tracepoints".  If you can afford
that, please redo the capitalization to use this style.

Thanks again for working on this.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]