From 539edd1a9af966d16f3391edece93702a86c7155 Mon Sep 17 00:00:00 2001
From: Jari Aalto <jari.aalto@cante.net>
Date: Sat, 8 Aug 2009 10:18:20 +0300
Subject: [PATCH] gdb.1: Order options alphabetically

Signed-off-by: Jari Aalto <jari.aalto@cante.net>
---
 gdb/gdb.1 |  148 +++++++++++++++++++++++++-------------------------------------
 1 file changed, 60 insertions(+), 88 deletions(-)

Index: gdb-7.0.1/gdb/gdb.1
===================================================================
--- gdb-7.0.1.orig/gdb/gdb.1	2010-01-30 16:24:38.000000000 -0500
+++ gdb-7.0.1/gdb/gdb.1	2010-01-30 16:24:40.000000000 -0500
@@ -220,90 +220,11 @@ in sequential order.  The order makes a 
 `\|\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
@@ -331,6 +252,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
@@ -339,9 +266,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
@@ -356,10 +295,34 @@ Emacs-to-GDB interface program uses the 
 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
@@ -379,6 +342,15 @@ Pass \c
 Run GDB using a text (console) user interface.
 .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