From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 7779 invoked by alias); 12 Apr 2013 14:39:23 -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 7770 invoked by uid 89); 12 Apr 2013 14:39:23 -0000 X-Spam-SWARE-Status: No, score=-8.9 required=5.0 tests=AWL,BAYES_00,KHOP_RCVD_UNTRUST,KHOP_THREADED,RCVD_IN_DNSWL_HI,RCVD_IN_HOSTKARMA_W,RP_MATCHES_RCVD,SPF_HELO_PASS,TW_DB,TW_XD autolearn=ham version=3.3.1 Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.84/v0.84-167-ge50287c) with ESMTP; Fri, 12 Apr 2013 14:39:22 +0000 Received: from int-mx11.intmail.prod.int.phx2.redhat.com (int-mx11.intmail.prod.int.phx2.redhat.com [10.5.11.24]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id r3CEdHeg027900 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 12 Apr 2013 10:39:17 -0400 Received: from [127.0.0.1] (ovpn01.gateway.prod.ext.ams2.redhat.com [10.39.146.11]) by int-mx11.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id r3CEdEJS024872; Fri, 12 Apr 2013 10:39:14 -0400 Message-ID: <51681C92.4000502@redhat.com> Date: Fri, 12 Apr 2013 16:39:00 -0000 From: Pedro Alves User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130311 Thunderbird/17.0.4 MIME-Version: 1.0 To: Eli Zaretskii CC: tromey@redhat.com, dje@google.com, brobecker@adacore.com, gdb-patches@sourceware.org Subject: regroup --help text (was: Re: [PATCH] Display configuration details in --help) References: <83r4jaynqq.fsf@gnu.org> <514B4AC3.1090103@redhat.com> <83zjxwy4ux.fsf@gnu.org> <20130321191051.GF5447@adacore.com> <83r4j8y1kh.fsf@gnu.org> <20130321203919.GG5447@adacore.com> <87r4j8zd0k.fsf@fleche.redhat.com> <83ehf85u7x.fsf@gnu.org> <83wqsbadfe.fsf@gnu.org> <20836.17485.525118.795474@ruffy2.mtv.corp.google.com> <83txnfa9m7.fsf@gnu.org> <51645982.8050904@redhat.com> <87k3oamlqy.fsf@fleche.redhat.com> <51658BC9.6080001@redhat.com> <878v4qmc14.fsf@fleche.redhat.com> <83eheg9lbr.fsf@gnu.org> <83bo9k9ifl.fsf@gnu.org> In-Reply-To: <83bo9k9ifl.fsf@gnu.org> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-SW-Source: 2013-04/txt/msg00386.txt.bz2 On 04/12/2013 11:01 AM, Eli Zaretskii wrote: >> Date: Fri, 12 Apr 2013 11:58:48 +0300 >> From: Eli Zaretskii >> Cc: palves@redhat.com, dje@google.com, brobecker@adacore.com, gdb-patches@sourceware.org >> >> I will take a shot on regrouping the --help text later. > > Howe about the following (if accepted, I will write a patch to > implement this): This is great. Many thanks. > > This is the GNU debugger. Usage: > > gdb [options] [executable-file [core-file or process-id]] > gdb [options] --args executable-file [inferior-arguments ...] > > Selection of debuggee and its files: > > --args Arguments after executable-file are passed to inferior. > --core=COREFILE Analyze the core dump COREFILE. > --exec=EXECFILE Use EXECFILE as the executable. > --pid=PID Attach to running process PID. > --directory=DIR Search for source files in DIR. > --se=FILE Use FILE as symbol file and executable file. > --symbols=SYMFILE Read symbols from SYMFILE. > --readnow Fully read symbol files on first access. > --write Set writing into executable and core files. > > Initial commands and command files: > > --command=FILE, -x Execute GDB commands from FILE. > --init-command=FILE, -ix > Like -x but execute commands before loading inferior. > --eval-command=COMMAND, -ex > Execute a single GDB command. > May be used multiple times and in conjunction > with --command. > --init-eval-command=COMMAND, -iex > Like -ex but before loading inferior. > --nh Do not read ~/.gdbinit. > --nx Do not read any .gdbinit files in any directory. > > Output and user interface control: > > --epoch Output information used by epoch emacs-GDB interface. > --fullname Output information used by emacs-GDB interface. > --interpreter=INTERP > Select a specific interpreter / user interface > --tty=TTY Use TTY for input/output by the program being debugged. > -w Use the GUI interface. > --nw Do not use the GUI interface. > --tui Use the text-mode user interface > --dbx DBX compatibility mode. > --xdb XDB compatibility mode. > --quiet Do not print version number on startup. > > Miscellaneous options: > > -b BAUDRATE Set serial port baud rate used for remote debugging. > --batch Exit after processing options. > --batch-silent Like --batch, but suppress all gdb stdout output. > --return-child-result > GDB exit code will be the child's exit code. > --cd=DIR Change current directory to DIR. > -l TIMEOUT Set timeout in seconds for remote debugging. > > --configuration Print details about GDB configuration and then exit. > --help Print this message and then exit. > --version Print version information and then exit. > I'd suggest splitting the miscellaneous section as: Operating modes: --batch Exit after processing options. --batch-silent Like --batch, but suppress all gdb stdout output. --return-child-result GDB exit code will be the child's exit code. --configuration Print details about GDB configuration and then exit. --help Print this message and then exit. --version Print version information and then exit. Remote debugging options: -b BAUDRATE Set serial port baud rate used for remote debugging. -l TIMEOUT Set timeout in seconds for remote debugging. Other options: --cd=DIR Change current directory to DIR. -- Pedro Alves