[RFC - doc] Add note about the possibility of symbols getting moved across blocks

Siva Chandra
2012-04-25T08:06:38Z

[-- Attachment #1: Type: text/plain, Size: 396 bytes --]

Hello,

This patch is in response to the discussion here:
http://sourceware.org/ml/gdb-patches/2012-04/msg00845.html

2012-04-25 Siva Chandra Reddy <sivachandra@google.com>

* gdb.texinfo (Blocks In Python): Add a note saying that future
improvements to symbol and symbol table representations can move
symbols across blocks within a symbol table.

Thanks,
Siva Chandra

[-- Attachment #2: blocks_doc_patch_v1.txt --]
[-- Type: text/plain, Size: 794 bytes --]

Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.948
diff -u -p -r1.948 gdb.texinfo
--- gdb.texinfo 23 Apr 2012 17:26:01 -0000 1.948
+++ gdb.texinfo 25 Apr 2012 07:53:58 -0000
@@ -24530,7 +24530,10 @@ detailed technical information on @value
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. Users using this
+feature should keep in mind that future improvements to the internal
+representation, of symbols and symbol tables, can move symbols across
+blocks within a symbol table.

The following block-related functions are available in the @code{gdb}