[PATCH] gdb: gdb.1 - order options alphabetically in manual page

Jari Aalto
2009-09-09T18:20:22Z

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 <jari.aalto@cante.net>

* gdb.1: Order options alphabetically.

[PATCH]

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 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