From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 5538 invoked by alias); 21 Feb 2013 17:44:38 -0000 Received: (qmail 5530 invoked by uid 22791); 21 Feb 2013 17:44:37 -0000 X-SWARE-Spam-Status: No, hits=-4.5 required=5.0 tests=AWL,BAYES_00,KHOP_THREADED,RCVD_IN_DNSWL_NONE,RCVD_IN_HOSTKARMA_NO,RCVD_IN_HOSTKARMA_YE,SPF_SOFTFAIL X-Spam-Check-By: sourceware.org Received: from mtaout21.012.net.il (HELO mtaout21.012.net.il) (80.179.55.169) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Thu, 21 Feb 2013 17:44:31 +0000 Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0MIK00K00ZIZNX00@a-mtaout21.012.net.il> for gdb-patches@sourceware.org; Thu, 21 Feb 2013 19:43:37 +0200 (IST) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MIK00KVRZWOMF50@a-mtaout21.012.net.il>; Thu, 21 Feb 2013 19:43:37 +0200 (IST) Date: Thu, 21 Feb 2013 17:44:00 -0000 From: Eli Zaretskii Subject: Re: RFA: fix gdb.texinfo for Texinfo 5.0 In-reply-to: <877gm1d7nm.fsf@fleche.redhat.com> To: Tom Tromey Cc: gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <8338wpo946.fsf@gnu.org> References: <877gm1d7nm.fsf@fleche.redhat.com> X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2013-02/txt/msg00559.txt.bz2 > From: Tom Tromey > Date: Thu, 21 Feb 2013 08:10:53 -0700 > > I tried Texinfo 5.0 on gdb.texinfo today, and it gave a number of > warnings. > > These fell into two major categories: first, we were using @table > without any @items; and second, we were using @item without an argument. > > The fix for the first problem is to just remove the @table. > There's no need for it. It's possible that someone used this trick to get the text indented. All of those instances are around @defXXX directives, so perhaps someone didn't like how functions/methods/etc. look unless indented. But if you are satisfied by the results of removing @table in those cases, that's fine by me. > The fix for the second was to use @w{} as the argument to @item. Yes, Texinfo 5.0 replaced one ugly kludge with another, sigh. (We left the @item empty because we wanted `' in the manual, by virtue of "@table @samp".) > This patch fixes all the problems. Thanks! > Tested by rebuilding with makeinfo 5.0 and makeinfo 4.13. > > Ok? Yes, thanks. P.S. I recommend everybody not to use makeinfo 5 yet, since it's dog-slow. I renamed it to 'makeinfo5' and keep the old v4.13a executable around, because it is 30 times faster, and that really shows when processing such a large manual.