This is the mail archive of the gdb-patches@sourceware.cygnus.com mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

[RFA] doc/gdb.texinfo: mention `-x' in "Command Files" node


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

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]