PYTHON DOCUMENTATION TO-DO LIST -*- indented-text -*-

===============================

* 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

by Albert Hofkamp <[email protected]>. (Partly done.)

* 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 <[email protected]>.)

* 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 <[email protected]>.

* Python/C API reference missing PyArg_ParseTuple(),

PyArg_ParseTupleAndKeywords(), Py_BuildValue(). Information

requested by Greg Kochanski <[email protected]>. PyEval_EvalCode()

has also been requested.

* Update the pickle documentation to describe all of the current

behavior; only a subset is described. __reduce__, etc. Partial

update submitted by Jim Kerr <[email protected]>.

* Update the code/codeop module documentation.

* Figure out HTMLHelp generation for the Windows world.

* Straighten out random/whrandom.

NOT WORTH THE TROUBLE

---------------------

* In the indexes, some subitem entries are separated from the item

entries by column- or page-breaks. Reported by Lorenzo M. Catucci

<[email protected]>. 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.)

* Fix problem with howto documents getting the last module synopsis

twice (in \localmoduletable) so we can get rid of the ugly 'uniq'

hack in tools/mkhowto. (Probably not worth the trouble of fixing.)