|
Size: 934
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 14: | Line 23: |
| SF:984952 PEP 307 not documented SF:993601 No optparse reference SF:970783 |
SF:970783 PyObject_GenericGetAttr is undocumented |
| Line 22: | Line 27: |
| SF:960340 new-style classes SF:944407 urllib2 exception classes SF:914375 modulefinder SF:882332 boolobject.h SF:873146 pickletools SF:866222 SimpleHTTPServer outdated SF:827209 list comprehension change |
|
| Line 37: | 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