Formatting of packet descriptions in GDB manual

Jim Blandy jimb@red-bean.com
Sat Nov 12 00:25:00 GMT 2005


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 info

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?



More information about the Gdb mailing list