[PATCH v2] [doc] Update obsolete text about sub-blocks

[PATCH v2] [doc] Update obsolete text about sub-blocks

[Tom Tromey]

The manual claims that there is no way to iterate over the sub-blocks
of a gdb.Block, but this hasn't been true since commit 5166ed9c
("gdb/python: add subblocks property to gdb.Block").

v2: This patch removes the entire paragraph.  After some discussion we
agreed it was confusing to talk about what gdb can't do.
---
 gdb/doc/python.texi | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi
index 1a38360ca1a..d86d679c35d 100644
--- a/gdb/doc/python.texi
+++ b/gdb/doc/python.texi
@@ -6273,11 +6273,6 @@ The block nested just inside the global block is the @dfn{static
 block}.  The static block typically holds file-scoped variables and
 functions.
 
-@value{GDBN} provides a method to get a block's superblock, but there
-is currently no way to examine the sub-blocks of a block, or to
-iterate over all the blocks in a symbol table (@pxref{Symbol Tables In
-Python}).
-
 Here is a short example that should help explain blocks:
 
 @smallexample

base-commit: 21e7edb10530341334a02c873aa9f7f5aeb0138a
-- 
2.55.0

Re: [PATCH v2] [doc] Update obsolete text about sub-blocks

[Eli Zaretskii]

> From: Tom Tromey <tromey@adacore.com>
> Cc: Tom Tromey <tromey@adacore.com>
> Date: Thu,  3 Sep 2026 10:47:49 -0600
> 
> The manual claims that there is no way to iterate over the sub-blocks
> of a gdb.Block, but this hasn't been true since commit 5166ed9c
> ("gdb/python: add subblocks property to gdb.Block").
> 
> v2: This patch removes the entire paragraph.  After some discussion we
> agreed it was confusing to talk about what gdb can't do.
> ---
>  gdb/doc/python.texi | 5 -----
>  1 file changed, 5 deletions(-)

This is okay, thanks.

Approved-By: Eli Zaretskii <eliz@gnu.org>