Re: [PATCH 4/9] agent doc

[Eli Zaretskii <eliz at gnu dot org>]

> Date: Fri, 17 Feb 2012 21:12:49 +0800
> From: Yao Qi <yao@codesourcery.com>
> CC: <gdb-patches@sourceware.org>
> 
> On 02/17/2012 07:37 PM, Eli Zaretskii wrote:
> >> >                                                         Gradually,
> >> > +they are used more widely, such as in remote stub.
> > I don't understand what you wanted to say in this sentence.  Does it
> > really add anything important?
> > 
> 
> What I want to describe here is that "Agent Expression" is not only used
> in agent, but also used somewhere else, such as target-side breakpoint
> conditions in GDBserver.  Just want to avoid the confusion that Agent
> Expression is used in agent only.

Then I suggest the following modified wording of that paragraph:

  Although called @dfn{agent expression}, because they originally
  referred to the target-side debugging agent (@pxref{Agent}), these
  expressions can be used in conjunction with many unrelated
  @value{GDBN} features, such as expressions used in tracepoints for
  data collection, expressions used in breakpoint condition evaluation,
  etc.  Note that the expressions may also denote registers and objects
  in memory---structures or arrays, for example---whose values
  @value{GDBN} should record.