|
Size: 934
Comment:
|
Size: 1220
Comment:
|
| 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:984952 PEP 307 not documented (mostly done -- needs a pickle expert to decide if anything else in PEP 307 is worth including). |
| Line 16: | Line 25: |
| SF:993601 No optparse reference SF:970783 |
SF:970783 PyObject_GenericGetAttr is undocumented |
| Line 22: | Line 29: |
| SF:960340 new-style classes SF:944407 urllib2 exception classes |
SF:960340 new-style classes (some documentation was already added to [http://docs.python.org/dev/ref/node33.html Python Reference Manual) |
| Line 27: | Line 32: |
SF:882332 boolobject.h SF:873146 pickletools SF:866222 SimpleHTTPServer outdated SF:827209 list comprehension change |
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