From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 29896 invoked by alias); 5 Apr 2013 15:37:57 -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 25920 invoked by uid 89); 5 Apr 2013 15:23:43 -0000 X-Spam-SWARE-Status: No, score=-4.2 required=5.0 tests=AWL,BAYES_00,KHOP_THREADED,RCVD_IN_DNSWL_NONE,RCVD_IN_HOSTKARMA_NO,RCVD_IN_HOSTKARMA_YE,RCVD_IN_NIX_SPAM,SPF_SOFTFAIL autolearn=no version=3.3.1 Received: from mtaout20.012.net.il (HELO mtaout20.012.net.il) (80.179.55.166) by sourceware.org (qpsmtpd/0.84/v0.84-167-ge50287c) with ESMTP; Fri, 05 Apr 2013 15:23:39 +0000 Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0MKS00300FZTQO00@a-mtaout20.012.net.il> for gdb-patches@sourceware.org; Fri, 05 Apr 2013 18:23:08 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MKS002OLG2HHOL0@a-mtaout20.012.net.il>; Fri, 05 Apr 2013 18:23:05 +0300 (IDT) Date: Fri, 05 Apr 2013 18:29:00 -0000 From: Eli Zaretskii Subject: Re: [patchv2+doc] New gdbinit.5 man page + converted gdb.1+gdbserver.1 In-reply-to: <20130405150101.GA15883@host2.jankratochvil.net> To: Jan Kratochvil Cc: tromey@redhat.com, gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83wqshdmsk.fsf@gnu.org> References: <87pq05mdqc.fsf@fleche.redhat.com> <83lias3ybi.fsf@gnu.org> <20130219162741.GA4493@host2.jankratochvil.net> <838v6kp4gu.fsf@gnu.org> <20130220084353.GA801@host2.jankratochvil.net> <83fw0qokfw.fsf@gnu.org> <20130404160915.GA11966@host2.jankratochvil.net> <83sj36fcxb.fsf@gnu.org> <20130404171439.GA20464@host2.jankratochvil.net> <83obduf9ny.fsf@gnu.org> <20130405150101.GA15883@host2.jankratochvil.net> X-SW-Source: 2013-04/txt/msg00130.txt.bz2 > Date: Fri, 5 Apr 2013 17:01:01 +0200 > From: Jan Kratochvil > Cc: tromey@redhat.com, gdb-patches@sourceware.org > > On Thu, 04 Apr 2013 20:11:29 +0200, Eli Zaretskii wrote: > > > +@c man begin SYNOPSIS gdb > > > +gdb [@option{-help}] [@option{-nh}] [@option{-nx}] [@option{-q}] > > > +[@option{-batch}] [@option{-cd=}@var{dir}] [@option{-f}] > > > +[@option{-b}@w{ }@var{bps}] > > > + [@option{-tty=}@var{dev}] [@option{-s} @var{symfile}] > > > +[@option{-e}@w{ }@var{prog}] [@option{-se}@w{ }@var{prog}] > > > +[@option{-c}@w{ }@var{core}] [@option{-x}@w{ }@var{cmds}] > > > + [@option{-d}@w{ }@var{dir}] [@var{prog}|@var{core}|@var{procID}] > > > +@c man end > > > > Why are the options formatted in such a strange way -- some lines > > indented, others not? The original man page has them all aligned > > nicely after formatting: > > > > SYNOPSIS > > gdb [-help] [-nx] [-q] [-batch] [-cd=dir] [-f] [-b bps] [-tty=dev] > > [-s symfile] [-e prog] [-se prog] [-c core] [-x file] [-ex cmd] > > [-d dir] [prog[core|procID]] > > cd gdb/doc;make gdb.1;nroff -man gdb.1|less -r > SYNOPSIS > gdb [-help] [-nh] [-nx] [-q] [-batch] [-cd=dir] [-f] [-b bps] > [-tty=dev] [-s symfile] [-e prog] [-se prog] [-c core] [-x cmds] > [-d dir] [prog|core|procID] > > The formatting is kept for the man page but it looks weird in the .texinfo > source. It is because I tried to keep the .texinfo source <= 80 columns, > I believe you do not prefer an equivalent .texinfo form (174 columns): No, of course not. But if you use @verbatim..@end verbatim around this block, you can simply format the text exactly as you want it in the produced formats, and makeinfo will not fill or reindent that text. > Sending FYI, I will check it in without further comments. Please go ahead after using @verbatim as suggested above, this is fine otherwise. Thanks.