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 _______________________________________________ bug-gdb mailing list [email protected] https://lists.gnu.org/mailman/listinfo/bug-gdb
