From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 2809 invoked by alias); 8 Jul 2014 14:59:06 -0000 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 Received: (qmail 2797 invoked by uid 89); 8 Jul 2014 14:59:05 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.2 required=5.0 tests=AWL,BAYES_00,SPF_SOFTFAIL,TBC autolearn=no version=3.3.2 X-HELO: mtaout26.012.net.il Received: from mtaout26.012.net.il (HELO mtaout26.012.net.il) (80.179.55.182) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 08 Jul 2014 14:59:03 +0000 Received: from conversion-daemon.mtaout26.012.net.il by mtaout26.012.net.il (HyperSendmail v2007.08) id <0N8E00G00EO7N400@mtaout26.012.net.il> for gdb-patches@sourceware.org; Tue, 08 Jul 2014 17:54:47 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout26.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N8E00EGHERAKR20@mtaout26.012.net.il>; Tue, 08 Jul 2014 17:54:47 +0300 (IDT) Date: Tue, 08 Jul 2014 14:59:00 -0000 From: Eli Zaretskii Subject: Re: [patch] Share options between info and man page In-reply-to: <53BBBE39.6040904@redhat.com> To: Pedro Alves Cc: brobecker@adacore.com, mingjie.xing@gmail.com, gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83k37ndhhq.fsf@gnu.org> References: <8338fc1wed.fsf@gnu.org> <53983FFA.6020909@redhat.com> <53A82F8B.7080507@redhat.com> <83wqc6qp2r.fsf@gnu.org> <20140707141843.GA6038@adacore.com> <83y4w5chra.fsf@gnu.org> <53BBBE39.6040904@redhat.com> X-IsSubscribed: yes X-SW-Source: 2014-07/txt/msg00148.txt.bz2 > Date: Tue, 08 Jul 2014 10:47:37 +0100 > From: Pedro Alves > CC: mingjie.xing@gmail.com, gdb-patches@sourceware.org > > > On top of that, this > > whole "produce man pages from Texinfo" business was sold to us on the > > assumption that "it makes maintenance simpler" (see > > https://sourceware.org/ml/gdb-patches/2013-02/msg00290.html and the > > discussions around it). To me this means that we put a bunch of > > telltale markers into the Texinfo files, add a few Makefile rules, and > > promptly forget everything we knew about that. > > > > But now it sounds like this arrangement is not simple at all, that we > > need non-trivial changes to follow (which will probably stump someone > > at some point, and perhaps even be changed and break the man-page > > generation), we need to maintain texi2pod.pl, and whatnot else. > > I found some documention on texi2pod.pl here: > > https://gcc.gnu.org/onlinedocs/gccint/Man-Page-Generation.html > > Sounds like we actually want '@table @gcctabopt'. > > > So I'm beginning to doubt that this is for the better. > > I think the benefits once this is in place outweigh the hurdle we're > going through. I'd rather have a synced man page with the occasional > odd formatting (that gets fixed eventually) than having to keep > the two texts in sync manually. In that case, if everyone else is happy with the patch, please approve it, and let's see what happens next.