Re: gdb manual woes

[Patrice Dumas]

On Thu, May 31, 2012 at 09:35:13PM +0000, Karl Berry wrote:
> Hi Patrice,
> 
> FYI, the GDB manual fails with Perl makeinfo.  I expect it is using
> "wrong" constructs, but didn't look into it.  Can you do that, and
> send a report/patch to the gdb maintainers?  (Sorry if I already asked
> you to do this, it just came up again since I installed 7.4.1.)

I fixed some issues, but there still remains some, like full tables
without @item, and I am not sure that this is not what the writer
wanted, and also some empty @item which also looks like they are wanted.

Ans also there are still

./gdb.texinfo:190: warning: @contents should only appear at beginning or
end of document
./stabs.texinfo:81: warning: @contents should only appear at beginning
or end of document

But it is not clear that it is wrong, as the code is like

 @titlepage
 @title The ``stabs'' debug format
 ....

 @end titlepage
 
 @ifnottex
 @node Top
 @top The "stabs" representation of debugging information
 
 This document describes the stabs debugging format.

 @menu
 * .....
 @end menu
 @end ifnottex

 @contents

 @node Overview
 @chapter Overview of Stabs

So in TeX the @contents is at the beginning, and one may imagine that
the @contents after the master menu location is on purpose.

This makes me think that maybe this warning message should only appear
when doing error messages for TeX.


Here are the warning messages I talk about above:

./gdb.texinfo:22939: warning: @table has text but no @item
./gdb.texinfo:22991: warning: @table has text but no @item
./gdb.texinfo:23247: warning: @table has text but no @item
./gdb.texinfo:23269: warning: @table has text but no @item
./gdb.texinfo:23860: warning: @table has text but no @item
./gdb.texinfo:23878: warning: @table has text but no @item
./gdb.texinfo:23939: warning: @table has text but no @item
./gdb.texinfo:23983: warning: @table has text but no @item
./gdb.texinfo:23998: warning: @table has text but no @item
./gdb.texinfo:24023: warning: @table has text but no @item
./gdb.texinfo:24036: warning: @table has text but no @item
./gdb.texinfo:24053: warning: @table has text but no @item
./gdb.texinfo:24081: warning: @table has text but no @item
./gdb.texinfo:24108: warning: @table has text but no @item
./gdb.texinfo:24768: warning: @table has text but no @item
./gdb.texinfo:24937: warning: @table has text but no @item
./gdb.texinfo:24950: warning: @table has text but no @item
./gdb.texinfo:25046: warning: @table has text but no @item
./gdb.texinfo:25110: warning: @table has text but no @item
./gdb.texinfo:25256: warning: @table has text but no @item
./gdb.texinfo:25275: warning: @table has text but no @item
./gdb.texinfo:25288: warning: @table has text but no @item
./gdb.texinfo:25301: warning: @table has text but no @item
./gdb.texinfo:35330: warning: @item missing argument
./gdb.texinfo:35500: warning: @item missing argument
./gdb.texinfo:35684: warning: @item missing argument
./gdb.texinfo:35708: warning: @item missing argument
./gdb.texinfo:35725: warning: @item missing argument
./gdb.texinfo:35742: warning: @item missing argument
./gdb.texinfo:35759: warning: @item missing argument
./gdb.texinfo:36021: warning: @item missing argument
./gdb.texinfo:36092: warning: @item missing argument
./gdb.texinfo:36113: warning: @item missing argument
./gdb.texinfo:36196: warning: @item missing argument
./gdb.texinfo:36228: warning: @item missing argument
./gdb.texinfo:36270: warning: @item missing argument
./gdb.texinfo:36298: warning: @item missing argument
./gdb.texinfo:36323: warning: @item missing argument
./gdb.texinfo:36340: warning: @item missing argument
./gdb.texinfo:36370: warning: @item missing argument
./gdb.texinfo:37019: warning: @item missing argument
./gdb.texinfo:37074: warning: @item missing argument
./gdb.texinfo:37234: warning: @item missing argument
./gdb.texinfo:37300: warning: @item missing argument
./gdb.texinfo:37410: warning: @item missing argument
./gdb.texinfo:37608: warning: @item missing argument
./gdb.texinfo:37741: warning: @item missing argument


-- 
Pat