New submission from Chris Jerdonek <chris.jerdo...@gmail.com>:

I think the generator.__next__() documentation should say that it raises an 
exception if the generator is already executing:

http://docs.python.org/dev/reference/expressions.html#generator.__next__

I don't think this is currently mentioned anywhere in the section on yield 
expressions.

I think this is worth mentioning because this is different from the general 
situation for iterators, for example.  One consequence of this is that, unlike 
for iterators, using a bare generator in a multithreaded situation will always 
result in a critical section (since an iterator can be made to take care of its 
own locking, etc).

----------
assignee: docs@python
components: Documentation
keywords: easy
messages: 165476
nosy: cjerdonek, docs@python
priority: normal
severity: normal
status: open
title: generator.__next__() docs should mention exception if already executing
versions: Python 3.3

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

Reply via email to