Re: [PATCH] GDB/MI documentation

[nickrob at snap dot net dot nz (Nick Roberts)]

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