New submission from Stephen Lacy <sl...@slacy.com>:

There's reasonable documentation of the yield statement for most python 
versions under Section 6: Simple Statements, particularly 6.8 "The Yield 
Statement" 
(http://docs.python.org/release/2.7/reference/simple_stmts.html#the-yield-statement)

But, there's no mention of the return value of the yield statement, or that the 
send statement even exists.  It's mentioned in passing here under "PEP342 New 
Generator Features" 
(http://docs.python.org/whatsnew/2.5.html#pep-342-new-generator-features) but 
should be given fuller explanation and cross-linking from the yield statement 
documentation. 

It's also mentioned a bit here: 
http://docs.python.org/howto/functional.html#passing-values-into-a-generator 
but again, not under the language documentation itself.

----------
assignee: docs@python
components: Documentation
messages: 161320
nosy: Stephen.Lacy, docs@python
priority: normal
severity: normal
status: open
title: send statement from PEP342 is poorly documented.
versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4

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

Reply via email to