[Python-Dev] Libref sections to put new modules under?

[Phillip J. Eby]

At 01:33 PM 3/27/2006 -0800, Guido van Rossum wrote:
>Is the with statement documented yet?

Sort of.  I've added stuff to the language reference, but the "What's New" 
for it is blank right now.  There's nothing in the tutorial, either, and of 
course contextlib isn't in the libref yet (which is what triggered my 
question).

PEP 342 is also virtually undocumented outside of the "What's New".  So far 
all I've done is correct the part about yield not being allowed in 
try/finally; apart from that I'm a bit hung up on how to document the new 
hybrid nature of "yield" in the language reference.  It's like "New 
YIELD!  It's a statement!  It's an expression!  It's an 
operator!  It's...  well, we don't know what it is.  But it's great!"  :)

Suggestions on how to handle this appreciated.  :)