Re: [PATCH] Display configuration details in --help

Doug Evans
2013-04-15T18:12:48Z

On Fri, Apr 12, 2013 at 3:01 AM, Eli Zaretskii <eliz@gnu.org> wrote:
>> Date: Fri, 12 Apr 2013 11:58:48 +0300
>> From: Eli Zaretskii <eliz@gnu.org>
>> 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 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.

Works for me, modulo do we care about alpha-sorting within each section?
[If not, please add a comment saying that the lists are intentionally
sorted (if at all) via means other than alphabetical.]

Thanks!