[docs] [issue17546] Document the circumstances where the locals() dict get updated

[Martin Panter]

Martin Panter added the comment:

Here is another attempt with different words:

'''
.. note::
   The dictionary returned by :func:`locals` is an accurate snapshot of the local namespace at the time it is called.  If the namespace changes after the call, the dictionary may become out of date, but it may also automatically update at any time.  The contents of the dictionary should not be modified by the user; it is undefined whether such changes affect the namespace or not.
'''

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue17546>
_______________________________________