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> -- http://mail.python.org/mailman/listinfo/python-list