Re: warnings with cvs texinfo version

[Patrice Dumas]

On Thu, Jun 21, 2012 at 05:52:55AM +0300, Eli Zaretskii wrote:
> 
> > ./gdb.texinfo:22939: warning: @table has text but no @item
> 
> Why is this warning needed?

This one is clear to me.  A @table without @item does not make sense.  A
@table specifies a series of headings and associated texts, so a @table 
without @item has no reason to be.  I don't think this warning should be
ignored.  Maybe use @group?  Or @quotation?  What are you searching for
with those empty tables?

> > ./gdb.texinfo:35330: warning: @item missing argument
> 
> And this one?

@table is for a succession of headings and text.  An empty item means
no heading and thus is not suitable.  I agree that it may make sense as
a separator, to control the presentation, but the general idea is that
Texinfo should not be used as a presentational markup, but instead as 
a descriptive markup, hence this warning.

You can always ignore that warning, though.
 
> > ./gdb.texinfo:190: warning: @contents should only appear at beginning or 
> > end of document
> 
> That @contents _is_ at the beginning.  What's the issue here?

It is not at the very beginning, instead, it appears at the end of the 
top node and element.  At the beginning would mean before 
@node Top

You can ignore this warning, though.

-- 
Pat