This is the mail archive of the
gdb-patches@sourceware.cygnus.com
mailing list for the GDB project.
[RFA] doc/gdb.texinfo: mention `-x' in "Command Files" node
- To: gdb-patches at sourceware dot cygnus dot com
- Subject: [RFA] doc/gdb.texinfo: mention `-x' in "Command Files" node
- From: Nick Duffek <nsd at cygnus dot com>
- Date: Sat, 29 Apr 2000 16:16:35 -0400
The appended patch does the following:
1. Mentions the `-x' option in the "Command Files" info node so that
someone looking there for such an option will find it.
2. Describes the startup sequence using @enumerate, because the addition
of `-x' makes the single-sentence approach unwieldy.
Here's how the relevant section looks with the patch:
When you start GDB, it automatically executes commands from its
"init files". These are files named `.gdbinit' on Unix and `gdb.ini'
on DOS/Windows. During startup, GDB does the following:
1. Reads the init file (if any) in your home directory(1).
2. Processes command line options and operands.
3. Reads the init file (if any) in the current working directory.
4. Reads command files specified by the `-x' option.
The init file in your home directory can set options (such as `set
complaints') that affect subsequent processing of command line options
and operands. Init files are not executed if you use the `-nx' option
(*note Choosing modes: Mode Options.).
And here's how it looks without the patch:
When you start GDB, it automatically executes commands from its
"init files". These are files named `.gdbinit' on Unix, or `gdb.ini'
on DOS/Windows. GDB reads the init file (if any) in your home
directory(1), then processes command line options and operands, and then
reads the init file (if any) in the current working directory. This is
so the init file in your home directory can set options (such as `set
complaints') which affect the processing of the command line options
and operands. The init files are not executed if you use the `-nx'
option; *note Choosing modes: Mode Options..
Okay to apply?
Nick Duffek
nsd@cygnus.com
[patch follows]
Index: doc/gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.17
diff -u -r1.17 gdb.texinfo
--- gdb.texinfo 2000/04/23 08:15:48 1.17
+++ gdb.texinfo 2000/04/29 20:10:38
@@ -11901,16 +11901,30 @@
@cindex @file{.gdbinit}
@cindex @file{gdb.ini}
When you start @value{GDBN}, it automatically executes commands from its
-@dfn{init files}. These are files named @file{.gdbinit} on Unix, or
-@file{gdb.ini} on DOS/Windows. @value{GDBN} reads the init file (if
-any) in your home directory@footnote{On DOS/Windows systems, the home
-directory is the one pointed to by the @code{HOME} environment
-variable.}, then processes command line options and operands, and then
-reads the init file (if any) in the current working directory. This is
-so the init file in your home directory can set options (such as
-@code{set complaints}) which affect the processing of the command line
-options and operands. The init files are not executed if you use the
-@samp{-nx} option; @pxref{Mode Options, ,Choosing modes}.
+@dfn{init files}. These are files named @file{.gdbinit} on Unix and
+@file{gdb.ini} on DOS/Windows. During startup, @value{GDBN} does the
+following:
+
+@enumerate
+@item
+Reads the init file (if any) in your home directory@footnote{On
+DOS/Windows systems, the home directory is the one pointed to by the
+@code{HOME} environment variable.}.
+
+@item
+Processes command line options and operands.
+
+@item
+Reads the init file (if any) in the current working directory.
+
+@item
+Reads command files specified by the @samp{-x} option.
+@end enumerate
+
+The init file in your home directory can set options (such as @code{set
+complaints}) that affect subsequent processing of command line options
+and operands. Init files are not executed if you use the @samp{-nx}
+option (@pxref{Mode Options, ,Choosing modes}).
@cindex init file name
On some configurations of @value{GDBN}, the init file is known by a