From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 30419 invoked by alias); 26 Mar 2007 21:20:52 -0000 Received: (qmail 30404 invoked by uid 22791); 26 Mar 2007 21:20:51 -0000 X-Spam-Check-By: sourceware.org Received: from hq.tensilica.com (HELO mailapp.tensilica.com) (65.205.227.29) by sourceware.org (qpsmtpd/0.31) with ESMTP; Mon, 26 Mar 2007 22:20:49 +0100 Received: from localhost ([127.0.0.1]) by mailapp.tensilica.com with esmtp (Exim 4.34) id 1HVwcP-0000AC-LA; Mon, 26 Mar 2007 13:20:45 -0800 Received: from mailapp.tensilica.com ([127.0.0.1]) by localhost (mailapp [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 32479-08; Mon, 26 Mar 2007 13:20:45 -0800 (PST) Received: from heron.hq.tensilica.com ([192.168.11.123]) by mailapp.tensilica.com with esmtp (Exim 4.34) id 1HVwcP-0000A6-93; Mon, 26 Mar 2007 13:20:45 -0800 Received: from [192.168.11.123] (heron.hq.tensilica.com [192.168.11.123]) by heron.hq.tensilica.com (Postfix) with ESMTP id 22209AC66C; Mon, 26 Mar 2007 14:20:45 -0700 (PDT) Message-ID: <4608392C.3070109@tensilica.com> Date: Mon, 26 Mar 2007 21:20:00 -0000 From: Bob Wilson User-Agent: Thunderbird 1.5.0.10 (X11/20070306) MIME-Version: 1.0 To: Eli Zaretskii CC: gdb-patches@sources.redhat.com Subject: Re: [PATCH] consistently capitalize section names References: <46081016.3030204@tensilica.com> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2007-03/txt/msg00241.txt.bz2 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