From: Bob Wilson <bwilson@tensilica.com>
To: Eli Zaretskii <eliz@gnu.org>
Cc: gdb-patches@sources.redhat.com
Subject: Re: [PATCH] consistently capitalize section names
Date: Mon, 26 Mar 2007 21:20:00 -0000 [thread overview]
Message-ID: <4608392C.3070109@tensilica.com> (raw)
In-Reply-To: <ufy7rafw8.fsf@gnu.org>
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
next prev parent reply other threads:[~2007-03-26 21:20 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2007-03-26 18:25 Bob Wilson
2007-03-26 20:50 ` Eli Zaretskii
2007-03-26 21:20 ` Bob Wilson [this message]
2007-03-27 4:06 ` Eli Zaretskii
2007-03-27 19:35 ` Bob Wilson
2007-03-31 11:48 ` Eli Zaretskii
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=4608392C.3070109@tensilica.com \
--to=bwilson@tensilica.com \
--cc=eliz@gnu.org \
--cc=gdb-patches@sources.redhat.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox