2012-05-02 Siva Chandra Reddy <sivachandra@google.com>

	* doc/gdb.texinfo (Blocks In Python): Add a note saying that
	future improvements to GDB and its infrastructure can move
	symbols across blocks within a symbol table.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 87230cc0b858e9be8d6e26fb83b98bc51340d18b..385e919d80bb8d112c77c8993c779a8ce0ab23f8 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,9 @@
+2012-05-02  Siva Chandra Reddy  <sivachandra@google.com>
+
+       * gdb.texinfo (Blocks In Python): Add a note saying that future
+       improvements to GDB and its infrastructure can move symbols
+       across blocks within a symbol table.
+
 2012-04-29  Yao Qi  <yao@codesourcery.com>
 
        * gdb.texinfo (Architectures): Remove menu entry `A29K'.

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index c72f6a7e0eaae5a2ceb20a7c860f4652bf70450c..e0b852939f7489ba6cfcee67e43eff9e96dd2157 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -24644,7 +24644,11 @@ detailed technical information on @value{GDBN}'s book-keeping of the
 stack.
 
 A @code{gdb.Block} is iterable.  The iterator returns the symbols
-(@pxref{Symbols In Python}) local to the block.
+(@pxref{Symbols In Python}) local to the block.  Python programs
+should not assume that a specific block object will always contain a
+given symbol, since changes in @value{GDBN} features and
+infrastructure may cause symbols move across blocks in a symbol
+table.
 
 The following block-related functions are available in the @code{gdb}
 module: