From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id CYJJMdGkmWqK3SUAWB0awg (envelope-from ) for ; Thu, 03 Sep 2026 12:48:17 -0400 Authentication-Results: simark.ca; dkim=pass (2048-bit key; secure) header.d=adacore.com header.i=@adacore.com header.a=rsa-sha256 header.s=google header.b=cTnHCHIY; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id C2AD51E166; Thu, 03 Sep 2026 12:48:17 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-2.4 required=5.0 tests=ARC_SIGNED,ARC_VALID,BAYES_00, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED,RCVD_IN_VALIDITY_CERTIFIED_BLOCKED, RCVD_IN_VALIDITY_RPBL_BLOCKED,RCVD_IN_VALIDITY_SAFE_BLOCKED autolearn=ham autolearn_force=no version=4.0.1 Received: from vm01.sourceware.org (vm01.sourceware.org [38.145.34.32]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange x25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id 342311E033 for ; Thu, 03 Sep 2026 12:48:17 -0400 (EDT) Received: from vm01.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id BC5824BB1C19 for ; Thu, 3 Sep 2026 16:48:16 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org BC5824BB1C19 Authentication-Results: sourceware.org; dkim=pass (2048-bit key, secure) header.d=adacore.com header.i=@adacore.com header.a=rsa-sha256 header.s=google header.b=cTnHCHIY Received: from mail-oo1-xc2d.google.com (mail-oo1-xc2d.google.com [IPv6:2607:f8b0:4864:20::c2d]) by sourceware.org (Postfix) with ESMTPS id 963F54B99F6A for ; Thu, 3 Sep 2026 16:47:53 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 963F54B99F6A Authentication-Results: sourceware.org; dmarc=pass (p=quarantine dis=none) header.from=adacore.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=adacore.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 963F54B99F6A Authentication-Results: sourceware.org; arc=none smtp.remote-ip=2607:f8b0:4864:20::c2d ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1788454073; cv=none; b=PdrHIKquaOXEWE/CqYUkSxwJ2Neqxh/3evoFF2Ud9blTGk4oprQFka4YTmgIXmsaSYb8ak5kPLMyKAGQ7HOixbk0ImIEkL/j7P49w50kGA1BQogVCy1tkJg9rsW5Pj0olt5smbhwEhglgirn5+i42XwzmPKNDDptZi3+bqzDwuY= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1788454073; c=relaxed/simple; bh=N+hwy0v7lSbIXmalhQ7se/TJrHJ50TXQlAmDCsw3iBY=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=omcssRzPc5bJLYPxFaSxlgaN/7mwS2KMdOh0fLwPzNpr5tNhrQ6Mhs8q6JY6vRS5Ant3s6V3m4uWyQYUny0qzm/gafKyjOcxHJLrwTFgC732arUhcKfUHLz4KtS46+EEnRckZOKY7w2Hjm/EirE55c654LCB/vmdOIJ+VFDE9XE= ARC-Authentication-Results: i=1; sourceware.org; dkim=pass (2048-bit key, secure) header.d=adacore.com header.i=@adacore.com header.a=rsa-sha256 header.s=google header.b=cTnHCHIY DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 963F54B99F6A Received: by mail-oo1-xc2d.google.com with SMTP id 006d021491bc7-6b12942ed04so19594eaf.1 for ; Thu, 03 Sep 2026 09:47:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=adacore.com; s=google; t=1788454073; x=1789058873; darn=sourceware.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to:content-type; bh=H8+bqe8Dsp0eMT+U+hj0waSMPKHCxjKVlA+UDSXRRo8=; b=cTnHCHIYLeCZgb69YqQXJyz/Bp881ZTt54O+NkBIyn7AcYW74HqItbP4+ijqncwrON 8Sah0XDybW/jTCze6v1Z1B5bH+m6ng9eqhPjAHV8wMiC2kGAgMCFTYlpnu1J2xBF/ZuG b7ycFEBE3vMqF4OUK62au8FkurvAU9i3HRsWhwKwWlOYf9mUk5KC+V6h+ojp27E1S6A9 JnaebaDmwvnxeIDcL3Z73g6K63hVY8O9N8OP955A7Nd8dZ/2qamJnbugEOWgMUS1x6KQ 7fwmKayS5k6O7NyFJBaMYpmpOOEkx7lrTadyU+D7OhfIC0ZgCO2OB/qKZnFZT+7B8WD+ HU1Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1788454073; x=1789058873; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=H8+bqe8Dsp0eMT+U+hj0waSMPKHCxjKVlA+UDSXRRo8=; b=FAHzJBmDB93a7O/NSnTTjmpFcv1+6UN/Q7PlIoScecfAS6J/eG9PrqLnDy5D9htK5g dGG/buVSGMHPDb4m3QJZlBr13b0TVV7KaxdwK12xsmyZRYuAO5yzAYtk+IFxbyYWf9N/ v1H82GjjKFwRJRD8j97N/b7zGDZYvNX7I9qgbFqSkUneAPbEgaYFtNuD1fqud3t6K2+n UmZRNuOeOMKblFqCsqg4mjeleqy/BGVDONwmuyQ3BK3omEd93zvb5jgl7/zFxeJDh8Sb cPlHzhuZbsIx9krbc6DevOW/+SeG0JdLXB+AB3tfXpPJiR8DU0B2hsuYQjK1Hwmroc9K PIDg== X-Gm-Message-State: AFuF++n4pFNZ1dM2LNlg2bXZyKEuUP/5KOK825iDN8nk3wNFmOsDcupp us11TX3j9GimyD/q1irKlt8I14af3lbmzz9JzmIxOgSNWiy4Z7017YeK9wWDYXvpgW8oueeoIWB s5/Fwww== X-Gm-Gg: AYBFou3kw57mtEnieasXj08JLV++pX1koA3DDO5JV67AkWN7iogUCmqz+0MZWPHuyqT 7S1V6GZRHaxsdqbrrfmcUsTw5Ky2nkJGqOs7LaxiM/KSM+a23Zh/JUeNXEt0SZfZ0iE3CI8KL0Z j7WbEanqEtwmLt7J6+3Kml0xorH3uyDawqQfEuTKMZISQ4uOVKuwxf0+6Pgo7f41zZ5bzTbVZaz Hjz/uIhZ1971w/A2MyQh2piMQI7jByBgyPQ4NUf7+Y6U8aJ8grqJBAzvJtmyBdJRW9I3MFbkD+y Ctj2iKhMYzhESdivH8Hzml12mvbt2P5unArU4iUc+OJT3Gz71FYE98xQ0Q3D0Z5xwL/+7nc0CYw Tu4GgGsW0TQKdoLfqLGQHigt1rET2zVwE/lgCX2G2eHuZsfbFc6uB/1QKszzW/guCLvgSOwGHv6 /dpIPhLSAml75l83y5w+szYHA/GsjF+77+5KfB7xYC07UtfX6ycYkDfRHlMrLgptsA9NYqznXIB UCZ X-Received: by 2002:a05:6820:80c4:b0:6b6:b5c8:7432 with SMTP id 006d021491bc7-6b6df1e238dmr490173eaf.33.1788454072816; Thu, 03 Sep 2026 09:47:52 -0700 (PDT) Received: from bapiya (97-122-117-2.hlrn.qwest.net. [97.122.117.2]) by smtp.gmail.com with ESMTPSA id 46e09a7af769-7f9f72d3c8asm430226a34.21.2026.09.03.09.47.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 03 Sep 2026 09:47:52 -0700 (PDT) From: Tom Tromey To: gdb-patches@sourceware.org Cc: Tom Tromey Subject: [PATCH v2] [doc] Update obsolete text about sub-blocks Date: Thu, 3 Sep 2026 10:47:49 -0600 Message-ID: <20260903164749.3872468-1-tromey@adacore.com> X-Mailer: git-send-email 2.55.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gdb-patches-bounces~public-inbox=simark.ca@sourceware.org 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