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 87230cc..385e919 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 c72f6a7..e0b8529 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: