2004-10-23 Eli Zaretskii <eliz@gnu.org>

	* gdb.texinfo(Files): Add a tip for decreasing memory used for
	symtabs from shared libraries.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index b15da41da9966e5bb95302a651c39612645d5934..93061fca9dec49414e80805b5ca7ee27aec9a86d 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -3,6 +3,8 @@
        * gdb.texinfo (SVR4 Process Information): Document subcommands of
        "info proc" that are already implemented.  Add index entries.
        (Working Directory): Add a cross-reference to "info proc" command.
+       (Files): Add a tip for decreasing memory used for symtabs from
+       shared libraries.
 
 2004-10-12  Andrew Cagney  <cagney@gnu.org>
 

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index c5b0a664c8486d7c8661c1ba24539e26d0ae82fe..3c798be5f5622c9727bee9eefe977e5d7cd372bb 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -10453,6 +10453,16 @@ informs @value{GDBN} that a new library has been loaded.  If @var{mode}
 is @code{off}, symbols must be loaded manually, using the
 @code{sharedlibrary} command.  The default value is @code{on}.
 
+@cindex memory used for symbol tables
+If your program uses lots of shared libraries with debug info that
+takes large amounts of memory, you can decrease the @value{GDBN}
+memory footprint by preventing it from automatically loading the
+symbols from shared libraries.  To that end, type @kbd{set
+auto-solib-add off} before running the inferior, then load each
+library whose debug symbols you do need with @kbd{sharedlibrary
+@var{regexp}}, where @var{regexp} is a regular expresion that matches
+the libraries whose symbols you want to be loaded.
+
 @kindex show auto-solib-add
 @item show auto-solib-add
 Display the current autoloading mode.