Re: [RFC - Python scripting] New methods Symtab.global_block and Symtab.static_block (docs included)

[Doug Evans <dje at google dot com>]

On Thu, Apr 26, 2012 at 4:56 AM, Siva Chandra <sivachandra@google.com> wrote:
> On Wed, Apr 25, 2012 at 12:06 PM, Tom Tromey <tromey@redhat.com> wrote:
>> I think the difficulty here is that saying nothing may also lull Python
>> users into a false sense of security that we will not change things in
>> this area.
>>
>> But, we'd still like the freedom to change things. ?For example, we've
>> talked off and on about implementing "hierarchical" symbol tables, where
>> the symbols in a namespace (e.g.) are kept in the namespace symbol, not
>> globally.
>>
>> If we made this sort of change, then iterating over the block would
>> return different results.
>>
>> Maybe there is some way to rewrite the original text to give us some
>> leeway.
>
> Does this note to user need to be a part of this patch?

fwiw, my opinion is "No.".
That would just be making you put too much effort into form over substance.
If you want to, go for it.  But it's not necessary (IMO).

We may want to hold off checking things in until the doc text is ready though.