From bdb1994d75ea8298de0af65b299e37ab7abaf18b Mon Sep 17 00:00:00 2001 From: Tom Tromey Date: Wed, 22 Feb 2012 18:39:28 +0000 Subject: [PATCH] * gdb.texinfo (Blocks In Python): Clarify block iteration. --- gdb/doc/ChangeLog | 4 ++++ gdb/doc/gdb.texinfo | 8 +++++--- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 1bdc380519..2c16fef8c3 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,7 @@ +2012-02-22 Tom Tromey + + * gdb.texinfo (Blocks In Python): Clarify block iteration. + 2012-02-17 Tom Tromey PR python/10753: diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 73779a758d..fe98db0d85 100644 --- 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 -- 2.34.1