From 369af7bd63d5dbadaabf44c1f595c6c31c244d2a Mon Sep 17 00:00:00 2001 From: Daniel Jacobowitz Date: Sun, 14 May 2006 15:09:51 +0000 Subject: [PATCH] * gdb.texinfo (General Query Packets): Recommend not starting new packets with qC and clarify. --- gdb/doc/ChangeLog | 5 +++++ gdb/doc/gdb.texinfo | 13 ++++++++----- 2 files changed, 13 insertions(+), 5 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 9d4ceb522f..cdf4622c3e 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2006-05-14 Daniel Jacobowitz + + * gdb.texinfo (General Query Packets): Recommend not starting + new packets with qC and clarify. + 2006-05-13 Gaius Mulley * gdb.texinfo (M2 Types): New section. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 74617c73c4..422d63e879 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