From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 25307 invoked by alias); 14 May 2009 22:07:28 -0000 Received: (qmail 25298 invoked by uid 22791); 14 May 2009 22:07:28 -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 22:07:23 +0000 Received: from totara (190.63.255.123.dynamic.snap.net.nz [123.255.63.190]) by viper.snap.net.nz (Postfix) with ESMTP id 7C97D3DA034; Fri, 15 May 2009 10:07:20 +1200 (NZST) Received: by totara (Postfix, from userid 1000) id 4824CC13E; Fri, 15 May 2009 10:07:19 +1200 (NZST) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <18956.38423.255406.48556@totara.tehura.co.nz> Date: Thu, 14 May 2009 22:07:00 -0000 To: Vladimir Prus Cc: gdb-patches@sources.redhat.com Subject: Re: [PATCH] GDB/MI documentation In-Reply-To: References: <18954.41627.111280.24736@totara.tehura.co.nz> <18955.48976.690330.445604@totara.tehura.co.nz> 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/msg00315.txt.bz2 Vladimir Prus writes: > Nick Roberts wrote: > > > - 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. > > Unfortunately, you have made a semantic change to the sentence. Original > sentence was definition what notification is. The changed sentence, instead, > say what notifications do, and is not a definition. You've defined them by what they do, so the definition here is implicit. If you want to emphasise the definition, you could use @dfn{}. In any case, in the patch I've committed, I've not changed this. After describing them in the node, GDB/MI General Design, the documentation uses older terminolgy and they are generally referred to as async records. -- Nick http://www.inet.net.nz/~nickrob