R. David Murray added the comment:
No, the docs are correct as they stand. They say that without an argument it
acts like locals(), and there is even a special note saying you shouldn't
modify the returned dictionary because what happens when you do is undefined.
It just so happens that whe
New submission from Dan L :
Perhaps it's assumed that you should know about this by knowing about how the
vars dictionary is implemented, but to someone unfamiliar like me it seems like
the builtin functions documentation for vars() should mention that you can
create a variable name from a str