Improve docs of qfThreadInfo packet.

gdb/doc/gdb.texinfo (General Query Packets): Add a note about thread IDs
mentioned in the qfThreadInfo reply.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index f3ccebac36149279cf7fc0271c34d0cc8fe077d7..5adb06f77445d512edfa8e6989022c25b57be41a 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2014-05-17  David Taylor <dtaylor@emc.com>
+
+       * gdb.texinfo (General Query Packets): Add a note about thread IDs
+       mentioned in the qfThreadInfo reply.
+
 2014-05-16  Doug Evans  <dje@google.com>
 
        * gdb.texinfo (Mode Options): Add -D.

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 49a060261f040b55797833384c70f770137cb82b..a6bde127cc34cf321ad81aa8bf6c3cc919f48a6a 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -34806,6 +34806,12 @@ with @samp{l} (lower-case ell, for @dfn{last}).
 Refer to @ref{thread-id syntax}, for the format of the @var{thread-id}
 fields.
 
+@emph{Note: @value{GDBN} will send the @code{qfThreadInfo} query during the
+initial connection with the remote target, and the very first thread ID
+mentioned in the reply will be stopped by @value{GDBN} in a subsequent
+message.  Therefore, the stub should ensure that the first thread ID in
+the @code{qfThreadInfo} reply is suitable for being stopped by @value{GDBN}.}
+
 @item qGetTLSAddr:@var{thread-id},@var{offset},@var{lm}
 @cindex get thread-local storage address, remote request
 @cindex @samp{qGetTLSAddr} packet