From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 16524 invoked by alias); 10 Jun 2014 07:00:37 -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 16504 invoked by uid 89); 10 Jun 2014 07:00:36 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.1 required=5.0 tests=AWL,BAYES_00,FREEMAIL_FROM,RCVD_IN_DNSWL_LOW,SPF_PASS autolearn=ham version=3.3.2 X-HELO: mail-ie0-f178.google.com Received: from mail-ie0-f178.google.com (HELO mail-ie0-f178.google.com) (209.85.223.178) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES128-SHA encrypted) ESMTPS; Tue, 10 Jun 2014 07:00:34 +0000 Received: by mail-ie0-f178.google.com with SMTP id rl12so6816639iec.37 for ; Tue, 10 Jun 2014 00:00:32 -0700 (PDT) X-Received: by 10.42.121.212 with SMTP id k20mr37010515icr.21.1402383632393; Tue, 10 Jun 2014 00:00:32 -0700 (PDT) MIME-Version: 1.0 Received: by 10.50.20.169 with HTTP; Tue, 10 Jun 2014 00:00:12 -0700 (PDT) In-Reply-To: <83ioo91nnk.fsf@gnu.org> References: <831tuy2kzi.fsf@gnu.org> <83ioo91nnk.fsf@gnu.org> From: Mingjie Xing Date: Tue, 10 Jun 2014 07:00:00 -0000 Message-ID: Subject: Re: [patch] Share options between info and man page To: Eli Zaretskii Cc: gdb-patches@sourceware.org Content-Type: text/plain; charset=UTF-8 X-IsSubscribed: yes X-SW-Source: 2014-06/txt/msg00412.txt.bz2 Hello, 2014-06-10 10:52 GMT+08:00 Eli Zaretskii : >> From: Mingjie Xing >> Date: Tue, 10 Jun 2014 08:46:10 +0800 >> Cc: gdb-patches@sourceware.org >> >> 2014-06-09 22:52 GMT+08:00 Eli Zaretskii : >> > The text of these two portions is different, so you are actually >> > changing the man page contents. Also, the @node and @section lines >> > are probably inappropriate for a man page. >> >> Yes, but you can see that the man page contents are almost same with >> those sections. > > Then please also suggest changes to make them exactly the same. I'm > OK with making the maintenance burden easier, but I don't want to lose > content. I made a compare and find that only one paragraph and one option are unique to man page: "All the options and command line arguments you give are processed in sequential order. The order makes a difference when the @option{-x} option is used." and "@item -help @itemx -h List all options, with brief explanations." I've preserved them and moved to 'File Options'. On the other hand, there are many options missing in man page which can be resolved by sharing. >> For an example, gcc's man page and info page use the >> same file 'invoke.texi' which includes @node and @section lines. > > I'm sorry, but GCC's example is unlikely to convince me, because I > consider the GCC documentation to be one of the worst examples in the > GNU project. I can never find useful up to date information there > when I'm looking for it. > > It should be easy to keep the @node and @chapter out of the man page. Done. 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 to here. Best regards, Mingjie