* gdb.texinfo (Blocks In Python): Clarify block iteration.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 1bdc3805196bb24f6c9496f1a1fa8d4a95214d04..2c16fef8c30920030326dec1cd19a400e7ed0335 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,7 @@
+2012-02-22  Tom Tromey  <tromey@redhat.com>
+
+       * gdb.texinfo (Blocks In Python): Clarify block iteration.
+
 2012-02-17  Tom Tromey  <tromey@redhat.com>
 
        PR python/10753:

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 73779a758d3aa57205f8480923454affa462020a..fe98db0d859e131325b428db7eedd63772d59b3c 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -23848,6 +23848,9 @@ frames.  Furthermore, see @ref{Stack, ,Examining the Stack}, for more
 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.
+
 The following block-related functions are available in the @code{gdb}
 module:
 
@@ -23866,9 +23869,8 @@ Returns @code{True} if the @code{gdb.Block} object is valid,
 @code{False} if not.  A block object can become invalid if the block it
 refers to doesn't exist anymore in the inferior.  All other
 @code{gdb.Block} methods will throw an exception if it is invalid at
-the time the method is called.  This method is also made available to
-the Python iterator object that @code{gdb.Block} provides in an iteration
-context and via the Python @code{iter} built-in function.
+the time the method is called.  The block's validity is also checked
+during iteration over symbols of the block.
 @end defun
 @end table