Re: [patch 5/5] Document

[Yao Qi <yao@codesourcery.com>]

[-- Attachment #1: Type: text/plain, Size: 763 bytes --]

On 11/16/2011 01:03 AM, Eli Zaretskii wrote:
>> > +                                                              Similar
>> > +to breakpoint, @dfn{pending tracepoint}---tracepoint whose address is
>> > +not yet resolved, is supported as well.
> Putting verbs at the end of the sentence produces awkward and hard to
> understand sentences (unless you talk in German or Japanese ;-).

This applies to Chinese as well :)

> Using passive tense makes it even more so.  I would reword like this:
> 
>   In addition, @value{GDBN} supports @dfn{pending tracepoints}---
>   tracepoints whose address is not yet resolved.  (This is similar to
>   pending breakpoints.)

That looks good.

Eli, Luis,
Thanks for your suggestions.  Here is a new one.

-- 
Yao (齐尧)

[-- Attachment #2: 0005-doc-pending-tracepoint.patch --]
[-- Type: text/x-patch, Size: 1236 bytes --]


	* 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..6882b78 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 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 remote stub, pending tracepoints still exists but can
+not be resolved while @value{GDBN} is disconnected.
 
 Here are some examples of using the @code{trace} command:
 
-- 
1.7.0.4