From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 4224 invoked by alias); 14 May 2009 06:51:07 -0000 Received: (qmail 4214 invoked by uid 22791); 14 May 2009 06:51:06 -0000 X-SWARE-Spam-Status: No, hits=-2.5 required=5.0 tests=AWL,BAYES_00,SPF_PASS X-Spam-Check-By: sourceware.org Received: from mx.southnet.co.nz (HELO viper.snap.net.nz) (202.37.101.20) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Thu, 14 May 2009 06:51:00 +0000 Received: from totara (122.61.255.123.dynamic.snap.net.nz [123.255.61.122]) by viper.snap.net.nz (Postfix) with ESMTP id B33D93DA5CE; Thu, 14 May 2009 18:50:57 +1200 (NZST) Received: by totara (Postfix, from userid 1000) id B62CFC13E; Thu, 14 May 2009 18:50:56 +1200 (NZST) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <18955.48976.690330.445604@totara.tehura.co.nz> Date: Thu, 14 May 2009 06:51:00 -0000 To: Eli Zaretskii Cc: gdb-patches@sourceware.org Subject: Re: [PATCH] GDB/MI documentation In-Reply-To: <834ovoswt3.fsf@gnu.org> References: <18954.41627.111280.24736@totara.tehura.co.nz> <834ovoswt3.fsf@gnu.org> From: nickrob@snap.net.nz (Nick Roberts) X-IsSubscribed: yes 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: 2009-05/txt/msg00287.txt.bz2 > > Here are just a few basic changes that preserve the content. > > I'm okay with adding nodes, but the rest of the changes don't make the > text any clearer than it is already. I thought this change was so basic, obvious almost, that approval would be a formality. Let's just look at two changes: - Interaction of a @sc{GDB/MI} frontend with @value{GDBN} involves three - parts---commands sent to @value{GDBN}, responses to those commands - and notifications. + Interaction of a @sc{GDB/MI} frontend with @value{GDBN} involves three + parts: commands sent to @value{GDBN}; responses to those commands; + and notifications. A wide dash (Em dash?) is normally used parenthetically while a semi-colon is generally used for a list, often with a colon. The example at http://en.wikipedia.org/wiki/Semicolon: "She saw three men: Donald, who came from New Zealand; Jon, the milkman's son; and George, a gaunt kind of man." is almost identical to my change. - Notifications is the mechanism for reporting changes in the state of the - target, + Notifications are used for reporting changes in the state of the + target, It's generally considered bad English to use "is" after a plural word. If you think that correct punctuation and grammar don't make the text any clearer then I'm a bit at a loss at what to say. Perhaps speling doesn't matter either. > > I think it would be quite easy to read GDB/MI General Design and still not > > understand the overall purpose of GDB/MI. > > Feel free to suggest the text you think is missing. I'd welcome any > such patches. > > TIA Frankly, the overhead seems too high. I don't think it should be necessary for every little change to have so many iterations. One step backward for every four forward is better than taking no steps at all. -- Nick http://www.inet.net.nz/~nickrob