Re: warnings with cvs texinfo version

Article View: gnu.gdb.bug

Article #1096

#1096

From: Patrice Dumas
Date: Thu, 21 Jun 2012 13:50

36 lines
3405 bytes

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

Technical Details

Message-ID: <mailman.3176.1340286664.855.bug-gdb@gnu.org>

Path: arc1-ca.pugleaf.net!l9ni3381pbj.0!nntp.google.com!news2.google.com!news.glorb.com!usenet.stanford.edu!not-for-mail

References: <20120620203753.GA4470@free.fr> <83obodcr5k.fsf@gnu.org>

Show Full Headers

Complete Article Headers

X-Google-Thread: f5053,1e059240fd602bbf
X-Google-NewGroupId: yes
X-Google-Attributes: gidf0ead4270c,domainid0,public,usenet
X-Google-Language: ENGLISH,ASCII-7-bit
Received: by 10.68.193.129 with SMTP id ho1mr26424067pbc.8.1340286665000;
        Thu, 21 Jun 2012 06:51:05 -0700 (PDT)
Path: arc1-ca.pugleaf.net!l9ni3381pbj.0!nntp.google.com!news2.google.com!news.glorb.com!usenet.stanford.edu!not-for-mail
From: Patrice Dumas <pertusus@free.fr>
Newsgroups: gnu.gdb.bug
Subject: Re: warnings with cvs texinfo version
Date: Thu, 21 Jun 2012 15:50:29 +0200
Lines: 37
Approved: bug-gdb@gnu.org
Message-ID: <mailman.3176.1340286664.855.bug-gdb@gnu.org>
References: <20120620203753.GA4470@free.fr>
 <83obodcr5k.fsf@gnu.org>
NNTP-Posting-Host: lists.gnu.org
Mime-Version: 1.0
X-Trace: usenet.stanford.edu 1340286664 14676 208.118.235.17 (21 Jun 2012 13:51:04 GMT)
X-Complaints-To: action@cs.stanford.edu
Cc: karl@freefriends.org, bug-gdb@gnu.org
To: Eli Zaretskii <eliz@gnu.org>
Envelope-to: bug-gdb@gnu.org
In-Reply-To: <83obodcr5k.fsf@gnu.org>
User-Agent: Mutt/1.5.20 (2009-12-10)
X-Miltered: at saturne.centre-cired.fr with ID 4FE326B5.001 by Joe's j-chkmail
 (http://j-chkmail.ensmp.fr)!
X-Greylist: Sender succeeded SMTP AUTH authentication, not delayed by
 milter-greylist-2.0.2 (saturne.centre-cired.fr
 [193.51.120.234]); Thu, 21 Jun 2012 15:50:50 +0200 (CEST)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 193.51.120.234
X-BeenThere: bug-gdb@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: "Bug reports for GDB, the GNU debugger" <bug-gdb.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-gdb>,
 <mailto:bug-gdb-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-gdb>
List-Post: <mailto:bug-gdb@gnu.org>
List-Help: <mailto:bug-gdb-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-gdb>,
 <mailto:bug-gdb-request@gnu.org?subject=subscribe>
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

Reply to Parent Message