From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 15326 invoked by alias); 7 Jul 2014 15:26:29 -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 15310 invoked by uid 89); 7 Jul 2014 15:26:28 -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; Mon, 07 Jul 2014 15:26:26 +0000 Received: from conversion-daemon.mtaout26.012.net.il by mtaout26.012.net.il (HyperSendmail v2007.08) id <0N8C00700L6HKY00@mtaout26.012.net.il> for gdb-patches@sourceware.org; Mon, 07 Jul 2014 18:22:11 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout26.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N8C001RWLCYUR60@mtaout26.012.net.il>; Mon, 07 Jul 2014 18:22:11 +0300 (IDT) Date: Mon, 07 Jul 2014 15:26:00 -0000 From: Eli Zaretskii Subject: Re: [patch] Share options between info and man page In-reply-to: <20140707141843.GA6038@adacore.com> To: Joel Brobecker Cc: mingjie.xing@gmail.com, palves@redhat.com, gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83y4w5chra.fsf@gnu.org> References: <8338fc1wed.fsf@gnu.org> <53983FFA.6020909@redhat.com> <53A82F8B.7080507@redhat.com> <83wqc6qp2r.fsf@gnu.org> <20140707141843.GA6038@adacore.com> X-IsSubscribed: yes X-SW-Source: 2014-07/txt/msg00120.txt.bz2 > Date: Mon, 7 Jul 2014 07:18:43 -0700 > From: Joel Brobecker > Cc: Eli Zaretskii , Pedro Alves , > gdb-patches@sourceware.org > > > Ping. > > > > 2014-06-26 17:34 GMT+08:00 Mingjie Xing : > > > I'd like to put an updated patch for both gdb.texinfo and texi2pod.pl, > > > plus the new comparing result. > > > > > > etc/ChangeLog: > > > > > > * texi2pod.pl (postprocess): Move command process for '@sc' to the > > > front of '@dfn'. Add a new command process for '@t{...}', just print > > > the content. > > > > > > gdb/doc/ChangeLog: > > > > > > * gdb.texinfo (Man Pages): Remove the content of man OPTIONS > > > gdb, add > > > a cross reference to 'Invoking GDB'. > > > (Invoking GDB): Share the option sub-sections with man OPTIONS > > > gdb, > > > move the uniqe part of man here. To display correrctly in man > > > page, > > > change '@xref' after a comma to 'see @ref', and change '@table > > > @code' > > > to '@table @env'. > > This is a documentation patch, so best to attract the documentation > maintainer's attention by adding something like "DOCO" in the email > subject. Frankly, I just don't know what to do with this patch. I don't know enough Perl to judge the texi2pod.pl patch, and don't intend to learn Perl just for that purpose. 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. And I'm the person who needs to be responsible for it. So I'm beginning to doubt that this is for the better. Thoughts?