New submission from Terry J. Reedy <tjre...@udel.edu>:

This doc improvement suggestion is inspired by #991196 (and subsequent 
duplicates) and the current discussion on py-dev in the thread
  'variable name resolution in exec is incorrect'
(which is not a correct claim). I believe there is consensus that the doc for 
exec needs improving.

My suggestion (which others may amend) is that the following paragraph (from 
the 3.x builtin functions exec entry)

"In all cases, if the optional parts are omitted, the code is executed in the 
current scope. If only globals is provided, it must be a dictionary, which will 
be used for both the global and the local variables. If globals  and locals are 
given, they are used for the global and local variables, respectively. If 
provided, locals can be any mapping object."

have these two sentences added:

"If only globals is provided or if onedict is provided as both globals and 
locals, the code is executed in a new top-level scope. If different objects are 
given as globals and locals, the code is executed as if it were in a class 
statement in a new top-level scope."

----------
assignee: d...@python
components: Documentation
messages: 106552
nosy: d...@python, tjreedy
priority: normal
severity: normal
status: open
title: Improve documentation of exec
versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue8824>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to