diff options
author | Daniel Jacobowitz <drow@false.org> | 2006-05-14 15:09:51 +0000 |
---|---|---|
committer | Daniel Jacobowitz <drow@false.org> | 2006-05-14 15:09:51 +0000 |
commit | 369af7bd63d5dbadaabf44c1f595c6c31c244d2a (patch) | |
tree | 9e510d6ce08f81efa0a497dd84332183db718d25 | |
parent | ea3d1626fe6c7a92e5f1a0ad6ae1ab0c5f0d5764 (diff) | |
download | gdb-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/ChangeLog | 5 | ||||
-rw-r--r-- | gdb/doc/gdb.texinfo | 13 |
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 |