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

Guido van Rossum guido at python.org
Mon Mar 27 23:33:16 CEST 2006

On 3/27/06, Phillip J. Eby <pje at telecommunity.com> wrote:
> Any thoughts on where documentation for the new "contextlib" module should
> go in the library reference?
> Some candidates:
> * Program Frameworks (???)
> * Development Tools (??)
> * Python Runtime Services (?)
> * Python Language Services (??)
> * Miscellaneous Services (??)

Runtime Services is by far the best candidate. The Language services
are more for code that reads/writes Python source code or bytecode.
The others are even less likely matches. (What's development tools?)

> A similar issue exists for "ctypes" module, although I imagine an argument
> could easily be made for putting it with "Optional Operating System Services".


> wsgiref can probably go in "Internet Protocols and Support", while
> ElementTree obviously goes under "Structured Markup Processing Tools".


> What other new modules do we have going in 2.5 that haven't found a home in
> the documentation yet?  I seem to recall some discussion about a decorator
> library or functools or something of that sort.

Is the with statement documented yet?

--Guido van Rossum (home page: http://www.python.org/~guido/)

More information about the Python-Dev mailing list