Differences between revisions 10 and 11
Revision 10 as of 2005-12-04 17:10:32
Size: 1110
Editor: 82-44-72-146
Comment: 944407 is closed already
Revision 11 as of 2006-03-31 14:48:02
Size: 1220
Editor: BSN-77-113-216
Comment:
Deletions are marked like this. Additions are marked like this.
Line 29: Line 29:
SF:960340 new-style classes SF:960340 new-style classes (some documentation was already added to [http://docs.python.org/dev/ref/node33.html Python Reference Manual)

This page lists various things that aren't documented in the main Python docs, but should be. We should try to fix these before 2.5final.

Features

The reference manual doesn't mention new-style classes at all. (I can't see that it really specifies the semantics of old-style classes, either.) I'm not sure the information is even collected anywhere. A start is now at NewClassVsClassicClass

Iterator protocol not described on its own (mentioned in passing in ref's discussion of generators)

Are nested scopes explained in the ref?

PEPS that aren't covered: new-style classes.

Other tasks

Also see ModulesThatNeedDocs.

Add example code to various modules.

Relevant SF bugs

984952 PEP 307 not documented (mostly done -- needs a pickle expert to decide if anything else in PEP 307 is worth including).

970783 PyObject_GenericGetAttr is undocumented

966625 descriptors not documented

960340 new-style classes (some documentation was already added to [http://docs.python.org/dev/ref/node33.html Python Reference Manual)

914375 modulefinder

813198 Migrate PEP material to docs

779976 trace undocumented

515751 imputil undocumented

MissingFromDocumentation (last edited 2010-11-16 21:35:39 by RDavidMurray)

Unable to edit the page? See the FrontPage for instructions.