From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-43955-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 18547 invoked by alias); 5 May 2006 19:18:32 -0000
Received: (qmail 18535 invoked by uid 22791); 5 May 2006 19:18:31 -0000
X-Spam-Check-By: sourceware.org
Received: from intranet.codesourcery.com (HELO mail.codesourcery.com) (65.74.133.6)     by sourceware.org (qpsmtpd/0.31) with ESMTP; Fri, 05 May 2006 19:18:25 +0000
Received: (qmail 10472 invoked from network); 5 May 2006 19:18:24 -0000
Received: from unknown (HELO localhost) (jimb@127.0.0.2)   by mail.codesourcery.com with ESMTPA; 5 May 2006 19:18:24 -0000
To: Eli Zaretskii <eliz@gnu.org>
Cc: gdb-patches@sourceware.org
Subject: Re: RFA: Document conventions for terminating query/set packet names
References: <vt21wvavqe4.fsf@theseus.home.> 	<20060503195650.GA13156@nevyn.them.org> 	<vt2y7xira7a.fsf@theseus.home.> 	<20060504015712.GA19810@nevyn.them.org> 	<8f2776cb0605032313s69362babjcda4e60fe33f9d6e@mail.gmail.com> 	<20060504123755.GA29302@nevyn.them.org> 	<8f2776cb0605041024u7c420707ie2fbff8a32ce32f0@mail.gmail.com> 	<ufyjodbuq.fsf@gnu.org>
From: Jim Blandy <jimb@codesourcery.com>
Date: Fri, 05 May 2006 19:18:00 -0000
In-Reply-To: <ufyjodbuq.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 05 May 2006 13:06:53 +0300")
Message-ID: <vt2ejz8p9fk.fsf@theseus.home.>
User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-IsSubscribed: yes
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
X-SW-Source: 2006-05/txt/msg00084.txt.bz2


Eli Zaretskii <eliz@gnu.org> writes:
>> Date: Thu, 4 May 2006 10:24:22 -0700
>> From: "Jim Blandy" <jimb@red-bean.com>
>> 
>> Here's a revised patch:
>> 
>> 2006-05-04  Jim Blandy  <jimb@codesourcery.com>
>> 
>> 	* gdb.texinfo (General Query Packets): Document conventions for
>> 	terminating packet names, and their violations.
>
> Fine with me, but...
>
>> ! 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.  The
>> ! @code{qP} and @code{qL} packets predate these conventions; since we
>> ! suspect they are in widespread use in places that are difficult to
>> ! upgrade, new packets should not begin with @code{qP} or @code{qL}.
>
> ...perhaps the last sentence will be better placed in a footnote.
> WDYT?

(Argh.  In Emacs, the command to insert '@code{}' in a texinfo-mode
buffer is C-c C-c c.  But in a mail-mode buffer, C-c C-c is 'send
message'...)

We could replace that last sentence with:

  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.}

if you prefer.