Yield

[Fredrik Lundh]

olive wrote:

>> http://docs.python.org/ref/yield.html
> 
> This is a perfect example that demonstrate how the actual python is bad
> and most of the time useless (at least for me).

there's a place for (relatively) formal reference documentation, but 
it's hardly ever the right place to learn why things are there, or how 
they are supposed to be used.

> We really need mor example !
> 
> I would like to thanks Fredrik for his contribution to improve that.

thanks!

(for the curious, my current plan is to use

     http://effbot.org/zone/idea-seealso.htm

files to link from the official documentation to tutorials, example 
collections, and blog articles.  I encourage content producers to start 
looking into generating such files for their document collections.)

</F>