Re: [patch 5/5] Document

[Yao Qi <yao at codesourcery dot com>]

On 11/17/2011 03:03 AM, Pedro Alves wrote:
> On Wednesday 16 November 2011 03:13:06, Yao Qi wrote:
>> +Pending tracepoints are not downloaded to target and not installed until
> 
> to the target
> 
>> +they are resolved.  The resolution of pending tracepoints requires
>> +@value{GDBN} support.  
> 
> This sentence confused me a little.   Everything in GDB requires GDB
> support.  :-)  I suggest joining it with the following sentence, like
> say:
> 
>  The resolution of pending tracepoints requires
>  @value{GDBN} support---in the remote target, when @value{GDBN}
>  disconnects from the remote stub, pending tracepoints still exist
>  but can not be resolved while @value{GDBN} is disconnected.
> 
>> +disconnects from remote stub, pending tracepoints still exists but can
>                from the remote stub                  still exist
> 

These definite article are needed.  Here is a new one.

-- 
Yao (éå)

	* gdb.texinfo (Create and Delete Tracepoints): Mention pending
	tracepoint.
---
 gdb/doc/gdb.texinfo |    9 ++++++++-
 1 files changed, 8 insertions(+), 1 deletions(-)

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 0cadc96..7cbf037 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -10337,7 +10337,14 @@ in tracing}).
 If remote stub doesn't support the @samp{InstallInTrace} feature, all
 these changes don't take effect until the next @code{tstart}
 command, and once a trace experiment is running, further changes will
-not have any effect until the next trace experiment starts.
+not have any effect until the next trace experiment starts.  In addition,
+@value{GDBN} supports @dfn{pending tracepoints}---tracepoints whose
+address is not yet resolved.  (This is similar to pending breakpoints.)
+Pending tracepoints are not downloaded to the target and not installed
+until they are resolved.  The resolution of pending tracepoints requires
+@value{GDBN} support--in the remote target, when @value{GDBN}
+disconnects from the remote stub, pending tracepoints still exist but
+can not be resolved while @value{GDBN} is disconnected.
 
 Here are some examples of using the @code{trace} command:
 
-- 
1.7.0.4