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

[R. David Murray]

R. David Murray added the comment:

Hmm.  Perhaps the last sentence could be "... because changes to the local dict propagating to the local namespace cannot be relied upon to either happen or not happen".  That would make it less redundant, since it would essentially be referencing the previous statement in the specific case of the consequences of modification.

The original included the caution against modifying it, and I think it is valid because of the inconsistent behavior.  Perhaps it could be weakened to "it is not a good idea to modify"?

----------
title: Document the circumstances where the locals() dict gets	updated -> Document the circumstances where the locals() dict get updated

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