aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Jacobowitz <drow@false.org>2006-05-14 15:09:51 +0000
committerDaniel Jacobowitz <drow@false.org>2006-05-14 15:09:51 +0000
commit369af7bd63d5dbadaabf44c1f595c6c31c244d2a (patch)
tree9e510d6ce08f81efa0a497dd84332183db718d25
parentea3d1626fe6c7a92e5f1a0ad6ae1ab0c5f0d5764 (diff)
downloadgdb-369af7bd63d5dbadaabf44c1f595c6c31c244d2a.zip
gdb-369af7bd63d5dbadaabf44c1f595c6c31c244d2a.tar.gz
gdb-369af7bd63d5dbadaabf44c1f595c6c31c244d2a.tar.bz2
* gdb.texinfo (General Query Packets): Recommend not starting
new packets with qC and clarify.
-rw-r--r--gdb/doc/ChangeLog5
-rw-r--r--gdb/doc/gdb.texinfo13
2 files changed, 13 insertions, 5 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 9d4ceb5..cdf4622 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2006-05-14 Daniel Jacobowitz <dan@codesourcery.com>
+
+ * gdb.texinfo (General Query Packets): Recommend not starting
+ new packets with qC and clarify.
+
2006-05-13 Gaius Mulley <gaius@glam.ac.uk>
* gdb.texinfo (M2 Types): New section.
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 74617c7..422d63e 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -23266,11 +23266,14 @@ foos) or @samp{Qacme.bar} (for setting bars).
The name of a query or set packet should be separated from any
parameters by a @samp{:}; the parameters themselves should be
separated by @samp{,} or @samp{;}. Stubs must be careful to match the
-full packet name, in case packet names have common prefixes. New
-packets should not begin with @samp{qP} or @samp{qL}@footnote{The
-@samp{qP} and @samp{qL} packets predate these conventions, and don't
-have any terminator for the packet name; we suspect they are in
-widespread use in places that are difficult to upgrade.}.
+full packet name, and check for a separator or the end of the packet,
+in case two packet names share a common prefix. New packets should not begin
+with @samp{qC}, @samp{qP}, or @samp{qL}@footnote{The @samp{qP} and @samp{qL}
+packets predate these conventions, and have arguments without any terminator
+for the packet name; we suspect they are in widespread use in places that
+are difficult to upgrade. The @samp{qC} packet has no arguments, but some
+existing stubs (e.g.@: RedBoot) are known to not check for the end of the
+packet.}.
Like the descriptions of the other packets, each description here
has a template showing the packet's overall syntax, followed by an