On 02/23/2012 04:25 AM, Pedro Alves wrote:
>> > I am inclined to leave this explanation there, as it is still useful to
>> > generic term "agent".
> Hmm, it still seems incorrect in the exact same way.
> 
>> > -When GDB is debugging a remote target, the GDB @dfn{agent} code running
>> > +Although called @dfn{agent expression}, because they originally
>> > +referred to the in-process agent (@pxref{In-Process Agent}), these
> Still false.  Looks unchanged compared to the previous version?
> 
>> > +When @value{GDBN} is debugging, the @value{GDBN} agent code running
>> >  on the target computes the values of the expressions itself.  To avoid
>> > -having a full symbolic expression evaluator on the agent, GDB translates
>> > -expressions in the source language into a simpler bytecode language, and
>> > -then sends the bytecode to the agent; the agent then executes the
>> > -bytecode, and records the values for GDB to retrieve later.
>> > +having a full symbolic expression evaluator on the agent or remote stub,
> This is still confused on agent vs in-process agent.  The remote stub is
> an agent as well; it does things for gdb (e.g., GDBserver supports tracepoints).
> Note the several references to "agent" on this whole paragraph.  I suggest
> really just leave this paragraph as it was.
> 
>> > +@value{GDBN} translates expressions in the source language into a simpler
>> > +bytecode language, and then sends the bytecode to the agent; the agent
>> > +then executes the bytecode, and records the values for @value{GDBN} to
>> > +retrieve later.
> We lost the intro about tracepoints, so this mention of recording values
> for gdb to retrieve later is now awkward.

Pedro,
It gets my hand dirty to try to distinguish "agent" vs. "in-process
agent" in appendix "Agent Expression", so I removed all the changes in
doc/agentexpr.texi, to leave it as it was.

Same as previous version, a node "In-Process Agent" is added, to
describe what is it, and how to control it.  Mention that "in-process
agent can interpret and execute Agent Expressions" only to avoid the
confusion on "agent" vs. "in-process agent", hopefully.

If this version is still not what you want, or confusing to you, please
give me an outline of this part, I've ran out of my brainpower. :)

-- 
Yao (齐尧)