diff --git a/Doc/TODO b/Doc/TODO index 5893378450f..b7ee309761f 100644 --- a/Doc/TODO +++ b/Doc/TODO @@ -1,6 +1,18 @@ PYTHON DOCUMENTATION TO-DO LIST -*- indented-text -*- =============================== +General +------- + +* Figure out HTMLHelp generation for the Windows world. + +* Straighten out random/whrandom. Things are generally in the right + place, but need to respond to comments in email from Jan Kim + . + + +Python/C API +------------ * The "Very High Level Interface" in the API document has been requested; I guess it wouldn't hurt to fill in a bit there. Request @@ -9,17 +21,34 @@ PYTHON DOCUMENTATION TO-DO LIST -*- indented-text -*- * Describe implementing types in C, including use of the 'self' parameter to the method implementation function. (Missing material mentioned in the Extending & Embedding manual, section 1.1; problem - reported by Clay Spence .) + reported by Clay Spence .) Heavily impacts one + chapter of the Python/C API manual. -* In the extensions manual, more information is needed about building - dynamically linked extensions in C++. Specifically, the extensions - must be linked against the C++ libraries (and possibly runtime). - Also noted by Albert Hofkamp . +* Missing PyArg_ParseTuple(), PyArg_ParseTupleAndKeywords(), + Py_BuildValue(). Information requested by Greg Kochanski + . PyEval_EvalCode() has also been requested. -* Python/C API reference missing PyArg_ParseTuple(), - PyArg_ParseTupleAndKeywords(), Py_BuildValue(). Information - requested by Greg Kochanski . PyEval_EvalCode() - has also been requested. +Extending & Embedding +--------------------- + +* More information is needed about building dynamically linked + extensions in C++. Specifically, the extensions must be linked + against the C++ libraries (and possibly runtime). Also noted by + Albert Hofkamp . + +Reference Manual +---------------- + +* Document the Extended Call Syntax in the language reference. + [Jeremy Hylton] + +* Document new comparison support for recursive objects (lang. ref.? + library ref.? (cmp() function). [Jeremy Hylton] + +Library Reference +----------------- + +* urllib2 module reference. [Jeremy Hylton] * Update the pickle documentation to describe all of the current behavior; only a subset is described. __reduce__, etc. Partial @@ -27,15 +56,15 @@ PYTHON DOCUMENTATION TO-DO LIST -*- indented-text -*- * Update the code/codeop module documentation. -* Figure out HTMLHelp generation for the Windows world. - -* Straighten out random/whrandom. - -* Update the filecmp documentation (Moshe?). - * Update the httplib documentation to match Greg Stein's HTTP/1.1 support and new classes. (Greg, this is yours!) +Tutorial +-------- + +* Update tutorial to use string methods and talk about backward + compatibility of same. + NOT WORTH THE TROUBLE --------------------- @@ -45,7 +74,8 @@ NOT WORTH THE TROUBLE . This one will be hard; probably not really worth the pain. (Only an issue at all when a header-letter and the first index entry get separated -- can change as soon as we - change the index entries in the text.) + change the index entries in the text.) Also only a problem in the + print version. * Fix problem with howto documents getting the last module synopsis twice (in \localmoduletable) so we can get rid of the ugly 'uniq'