[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: warnings with cvs texinfo version
From: |
Patrice Dumas |
Subject: |
Re: warnings with cvs texinfo version |
Date: |
Thu, 21 Jun 2012 15:50:29 +0200 |
User-agent: |
Mutt/1.5.20 (2009-12-10) |
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
- warnings with cvs texinfo version, Patrice Dumas, 2012/06/20
- Re: warnings with cvs texinfo version, Eli Zaretskii, 2012/06/20
- Re: warnings with cvs texinfo version,
Patrice Dumas <=
- Re: warnings with cvs texinfo version, Eli Zaretskii, 2012/06/21
- Re: warnings with cvs texinfo version, Patrice Dumas, 2012/06/21
- Re: warnings with cvs texinfo version, Eli Zaretskii, 2012/06/21
- Re: warnings with cvs texinfo version, Patrice Dumas, 2012/06/23
- Re: warnings with cvs texinfo version, Eli Zaretskii, 2012/06/23
Re: warnings with cvs texinfo version, Eli Zaretskii, 2012/06/20