From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 25706 invoked by alias); 9 Sep 2009 18:20:22 -0000 Received: (qmail 25589 invoked by uid 22791); 9 Sep 2009 18:20:17 -0000 X-SWARE-Spam-Status: No, hits=-2.7 required=5.0 tests=AWL,BAYES_00,SPF_HELO_PASS,SPF_PASS X-Spam-Check-By: sourceware.org Received: from lo.gmane.org (HELO lo.gmane.org) (80.91.229.12) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Wed, 09 Sep 2009 18:20:11 +0000 Received: from list by lo.gmane.org with local (Exim 4.50) id 1MlRlz-000139-2Q for gdb-patches@sources.redhat.com; Wed, 09 Sep 2009 20:20:03 +0200 Received: from a91-155-187-216.elisa-laajakaista.fi ([91.155.187.216]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 09 Sep 2009 20:20:03 +0200 Received: from jari.aalto by a91-155-187-216.elisa-laajakaista.fi with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 09 Sep 2009 20:20:03 +0200 To: gdb-patches@sources.redhat.com From: Jari Aalto Subject: [PATCH] gdb: gdb.1 - order options alphabetically in manual page Date: Wed, 09 Sep 2009 18:20:00 -0000 Message-ID: <87hbvct24x.fsf@jondo.cante.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: jari.aalto@cante.net User-Agent: Gnus/5.110011 (No Gnus v0.11) Emacs/23.1 (gnu/linux) X-IsSubscribed: yes 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 X-SW-Source: 2009-09/txt/msg00255.txt.bz2 Motivation: Order of the options would follow the convention used in other GNU programs lik Cf. cp(1), mv(1), etc. Forwarded from: http://sourceware.org/bugzilla/show_bug.cgi?id=10505 I have assigned papers to FSF (Emacs). Please let me know if more is needed. Jari [ChangeLog] 2009-09-09 Jari Aalto * gdb.1: Order options alphabetically. [PATCH] >From 539edd1a9af966d16f3391edece93702a86c7155 Mon Sep 17 00:00:00 2001 From: Jari Aalto Date: Sat, 8 Aug 2009 10:18:20 +0300 Subject: [PATCH] gdb.1: Order options alphabetically Signed-off-by: Jari Aalto --- gdb/gdb.1 | 148 +++++++++++++++++++++++++------------------------------------ 1 files changed, 60 insertions(+), 88 deletions(-) diff --git a/gdb/gdb.1 b/gdb/gdb.1 index 809578f..18550b4 100644 --- a/gdb/gdb.1 +++ b/gdb/gdb.1 @@ -205,90 +205,11 @@ in sequential order. The order makes a difference when the `\|\c .B \-x\c \&\|' option is used. - -.TP -.B \-help -.TP -.B \-h -List all options, with brief explanations. - -.TP -.BI "\-symbols=" "file"\c -.TP -.BI "\-s " "file"\c -\& -Read symbol table from file \c -.I file\c -\&. - -.TP -.B \-write -Enable writing into executable and core files. - -.TP -.BI "\-exec=" "file"\c -.TP -.BI "\-e " "file"\c -\& -Use file \c -.I file\c -\& as the executable file to execute when -appropriate, and for examining pure data in conjunction with a core -dump. - -.TP -.BI "\-se=" "file"\c -\& -Read symbol table from file \c -.I file\c -\& and use it as the executable -file. - -.TP -.BI "\-core=" "file"\c -.TP -.BI "\-c " "file"\c -\& -Use file \c -.I file\c -\& as a core dump to examine. - -.TP -.BI "\-command=" "file"\c -.TP -.BI "\-x " "file"\c -\& -Execute GDB commands from file \c -.I file\c -\&. - -.TP -.BI "\-directory=" "directory"\c .TP -.BI "\-d " "directory"\c +.BI "\-b " "bps"\c \& -Add \c -.I directory\c -\& to the path to search for source files. -.PP - -.TP -.B \-nx -.TP -.B \-n -Do not execute commands from any `\|\c -.B .gdbinit\c -\&\|' initialization files. -Normally, the commands in these files are executed after all the -command options and arguments have been processed. - - -.TP -.B \-quiet -.TP -.B \-q -``Quiet''. Do not print the introductory and copyright messages. These -messages are also suppressed in batch mode. +Set the line speed (baud rate or bits per second) of any serial +interface used by GDB for remote debugging. .TP .B \-batch @@ -316,6 +237,12 @@ Program\ exited\ normally. terminates) is not issued when running in batch mode. .TP +.B \-c FILE, \-core=FILE +Use file \c +.I file\c +\& as a core dump to examine. + +.TP .BI "\-cd=" "directory"\c \& Run GDB using \c @@ -324,9 +251,21 @@ Run GDB using \c instead of the current directory. .TP -.B \-fullname +.B \-d DIRECTORY, \-directory=DIRECTORY +Add \c +.I directory\c +\& to the path to search for source files. + +.TP +.B \-e FILE, -exec=FILE +Use file \c +.I file\c +\& as the executable file to execute when +appropriate, and for examining pure data in conjunction with a core +dump. + .TP -.B \-f +.B \-f, \-fullname Emacs sets this option when it runs GDB as a subprocess. It tells GDB to output the full file name and line number in a standard, recognizable fashion each time a stack frame is displayed (which @@ -341,10 +280,34 @@ Emacs-to-GDB interface program uses the two `\|\c a signal to display the source code for the frame. .TP -.BI "\-b " "bps"\c -\& -Set the line speed (baud rate or bits per second) of any serial -interface used by GDB for remote debugging. +.B \-h, \-help +List all options, with brief explanations. + +.TP +.B \-n, \-nx +Do not execute commands from any `\|\c +.B .gdbinit\c +\&\|' initialization files. +Normally, the commands in these files are executed after all the +command options and arguments have been processed. + +.TP +.B -s FILE, \-symbols=FILE +Read symbol table from file \c +.I file\c +\&. + +.TP +.BI "\-se=" "file"\c +Read symbol table from file \c +.I file\c +\& and use it as the executable +file. + +.TP +.B \q, \-quiet +``Quiet''. Do not print the introductory and copyright messages. These +messages are also suppressed in batch mode. .TP .BI "\-tty=" "device"\c @@ -354,6 +317,15 @@ Run using \c \& for your program's standard input and output. .PP +.TP +.B \-write +Enable writing into executable and core files. + +.TP +.B \-x FILE, \-command=FILE +Execute GDB commands from file \c +.I file\c +\&. .SH "SEE ALSO" .RB "`\|" gdb "\|'" entry in -- 1.6.3.3