|
Size: 1045
Comment:
|
Size: 854
Comment: converted to 1.6 markup
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 2: | Line 2: |
| but should be. We should try to fix these before 2.4final. | but should be. We should try to fix these before 2.5final. |
| Line 6: | Line 6: |
| 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.) | 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 |
| Line 12: | Line 12: |
| PEPS that aren't covered: new-style classes. = Other tasks = Also see ModulesThatNeedDocs. Add example code to various modules. |
|
| Line 13: | Line 22: |
SF:984952 PEP 307 not documented (mostly done -- needs a pickle export to decide if anything else in PEP 307 is worth including) SF:993601 No optparse reference |
|
| Line 22: | Line 27: |
| SF:960340 new-style classes SF:944407 urllib2 exception classes SF:914375 modulefinder SF:882332 boolobject.h SF:866222 SimpleHTTPServer outdated SF:827209 list comprehension change |
|
| Line 35: | Line 28: |
SF:779976 trace undocumented SF:515751 imputil undocumented |
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
970783 PyObject_GenericGetAttr is undocumented
966625 descriptors not documented
813198 Migrate PEP material to docs