From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-return-23162-listarch-gdb=sources.redhat.com@sourceware.org>
Received: (qmail 19662 invoked by alias); 12 Nov 2005 00:25:01 -0000
Mailing-List: contact gdb-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Subscribe: <mailto:gdb-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb/>
List-Post: <mailto:gdb@sourceware.org>
List-Help: <mailto:gdb-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-owner@sourceware.org
Received: (qmail 19598 invoked by uid 22791); 12 Nov 2005 00:24:59 -0000
Received: from zproxy.gmail.com (HELO zproxy.gmail.com) (64.233.162.195)
    by sourceware.org (qpsmtpd/0.30-dev) with ESMTP; Sat, 12 Nov 2005 00:24:59 +0000
Received: by zproxy.gmail.com with SMTP id l1so822582nzf
        for <gdb@sources.redhat.com>; Fri, 11 Nov 2005 16:24:57 -0800 (PST)
Received: by 10.36.177.11 with SMTP id z11mr1817901nze;
        Fri, 11 Nov 2005 16:24:57 -0800 (PST)
Received: by 10.37.2.35 with HTTP; Fri, 11 Nov 2005 16:24:57 -0800 (PST)
Message-ID: <8f2776cb0511111624h4d646cd9i1f86824c5edc613f@mail.gmail.com>
Date: Sat, 12 Nov 2005 00:25:00 -0000
From: Jim Blandy <jimb@red-bean.com>
To: gdb@sources.redhat.com
Subject: Formatting of packet descriptions in GDB manual
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline
X-SW-Source: 2005-11/txt/msg00232.txt.bz2

The way gdb.texinfo describes packet formats is pretty wierd.  The
.texinfo says stuff like:

    @table @r
...
    @item @code{q}@code{ThreadExtraInfo}@code{,}@var{id} --- extra thread i=
nfo

which is rendered in .info files as:

    `q'`ThreadExtraInfo'`,'ID -- extra thread info

Those quotes aren't helping anything at all.  The rendering in .pdf
files is fine.

I'd much rather see:

    @table @r
...
    @item @code{qThreadExtraInfo,@var{id}} --- extra thread info

which renders in .info as:

    `qThreadExtraInfo,ID' -- extra thread info

and renders the same in .pdf.

What do folks think?