Re: [PATCH] consistently capitalize section names

Bob Wilson
2007-03-26T21:20:52Z

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