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


Eli Zaretskii wrote:
Thanks for doing this, but unfortunately the capitalization style
you've chosen is wrong.

I think consistency is the important thing here, and I was trying to match the existing convention. If you exclude recent additions to the manual, almost all of the headings at the section level and lower have only the first word capitalized.


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.

I'm not opposed to changing the capitalization style, but I don't think that quote requires it. Before the part you quoted, it says "Here are three suggestions". Besides, this is addressing the question of node names and only indirectly mentions the capitalization of section titles, assuming they will be handled the same as chapter titles.


Like I said, I'm not opposed to your suggestion. This seems to me a matter of choosing between two equally correct styles. Someone in the past must have made a conscious choice to capitalize section titles differently than chapter titles.

Anyway, it sounds like you want to change that convention, which is fine with me.


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.

Hmm. Yes, well, I really ought to be working on other things, but I might manage to squeeze it in sometime.


--Bob


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