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

[Doug Evans]

On Thu, Apr 19, 2012 at 10:29 AM, Siva Chandra <sivachandra@google.com> wrote:
> Phil> FWIW, I would still like to see a clarification of the static/global
> Phil> documentation regarding the "this might change" comment.  Sorry to be
> Phil> a stickler on this, but I think it is important we don't start hinting
> Phil> at API breakages without an adequate explanation as to what may
> Phil> change, and why.  (Given that there is a need to put that disclaimer
> Phil> in there in the first place).
>
> Tom> I agree this text is a bit on the terse side.
> Tom>
> Tom> An issue I see with it is that, as a Python developer, you can't take
> Tom> any action to insulate yourself.  Perhaps being more specific about what
> Tom> "identical" means would be useful.
>
> OK. I will wait for Doug to clarify on this.
>
> /Siva Chandra

It would not be unexpected to me if a symbol disappeared from either
list, moved from one list to another, or a new symbol appeared.

[I also think exposing "global" vs "static" is an implementation
detail, and thus shouldn't be part of the API, akin to exposing symbol
table file names - symbols can have file names (like they have line
numbers), but symbol tables I'm less comfortable with.  Both of those
ships have already sailed, I know.]