summaryrefslogtreecommitdiffstats
path: root/gdb/doc
diff options
context:
space:
mode:
authorDoug Evans <dje@google.com>2010-12-15 17:28:00 +0000
committerDoug Evans <dje@google.com>2010-12-15 17:28:00 +0000
commita86caf66bb66054f86ef6bed3c5fa6d68444734b (patch)
treedacd30dd4676b811dab258da5a799f596b3ee7c2 /gdb/doc
parent2fbb4320cae80e68bd80064cac06588f33546e6f (diff)
downloadppe42-binutils-a86caf66bb66054f86ef6bed3c5fa6d68444734b.tar.gz
ppe42-binutils-a86caf66bb66054f86ef6bed3c5fa6d68444734b.zip
Rename "maint set python auto-load" to "set auto-load-scripts".
* NEWS: Mention it. * python/py-auto-load.c (auto_load_scripts): Renamed from gdbpy_auto_load. (load_auto_scripts_for_objfile): Update. (gdbpy_initialize_auto_load): Rename "maint set python auto-load" to "set auto-load-scripts". doc/ * gdb.texinfo (Startup): Document auto-loading of scripts during startup. (Auto-loading): Delete "maint set python auto-load on|off". Add "set auto-load-scripts on|off".
Diffstat (limited to 'gdb/doc')
-rw-r--r--gdb/doc/ChangeLog7
-rw-r--r--gdb/doc/gdb.texinfo31
2 files changed, 32 insertions, 6 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index c1d0e1cfdf..df46a17534 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,10 @@
+2010-12-15 Doug Evans <dje@google.com>
+
+ * gdb.texinfo (Startup): Document auto-loading of scripts during
+ startup.
+ (Auto-loading): Delete "maint set python auto-load on|off".
+ Add "set auto-load-scripts on|off".
+
2010-12-07 Doug Evans <dje@google.com>
* gdb.texinfo (Mode Options): Document -data-directory.
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index dc9630ac0c..0e1d553263 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -1263,6 +1263,25 @@ to the program you are debugging, in the directory where you invoke
@value{GDBN}.
@item
+If the command line specified a program to debug, or a process to
+attach to, or a core file, @value{GDBN} loads any auto-loaded
+scripts provided for the program or for its loaded shared libraries.
+@xref{Auto-loading}.
+
+If you wish to disable the auto-loading during startup,
+you must do something like the following:
+
+@smallexample
+$ gdb -ex "set auto-load-scripts off" -ex "file myprogram"
+@end smallexample
+
+The following does not work because the auto-loading is turned off too late:
+
+@smallexample
+$ gdb -ex "set auto-load-scripts off" myprogram
+@end smallexample
+
+@item
Reads command files specified by the @samp{-x} option. @xref{Command
Files}, for more details about @value{GDBN} command files.
@@ -23114,13 +23133,13 @@ debugging commands and scripts.
Auto-loading can be enabled or disabled.
@table @code
-@kindex maint set python auto-load
-@item maint set python auto-load [yes|no]
-Enable or disable the Python auto-loading feature.
+@kindex set auto-load-scripts
+@item set auto-load-scripts [yes|no]
+Enable or disable the auto-loading of Python scripts.
-@kindex maint show python auto-load
-@item maint show python auto-load
-Show whether Python auto-loading is enabled or disabled.
+@kindex show auto-load-scripts
+@item show auto-load-scripts
+Show whether auto-loading of Python scripts is enabled or disabled.
@end table
When reading an auto-loaded file, @value{GDBN} sets the
OpenPOWER on IntegriCloud