blob: 267fc653bd3043c92a7203c31ce4765d3d6ad96b [file] [log] [blame]
Fred Drakeb8660201998-02-18 16:03:43 +00001PYTHON DOCUMENTATION TO-DO LIST -*- indented-text -*-
Fred Drake81f4b661998-02-17 19:01:02 +00002===============================
3
4
Fred Drake5a8aaa71999-07-02 14:31:41 +00005* The "Very High Level Interface" in the API document has been
6 requested; I guess it wouldn't hurt to fill in a bit there. Request
7 by Albert Hofkamp <a.hofkamp@wtb.tue.nl>. (Partly done.)
8
Fred Drake8ece8041999-02-22 14:37:18 +00009* Describe implementing types in C, including use of the 'self'
10 parameter to the method implementation function. (Missing material
11 mentioned in the Extending & Embedding manual, section 1.1; problem
12 reported by Clay Spence <cspence@sarnoff.com>.)
13
Fred Drake10682c21999-04-23 15:15:58 +000014* In the extensions manual, more information is needed about building
15 dynamically linked extensions in C++. Specifically, the extensions
16 must be linked against the C++ libraries (and possibly runtime).
17 Also noted by Albert Hofkamp <a.hofkamp@wtb.tue.nl>.
18
Fred Drake90938341999-12-23 17:22:13 +000019* Python/C API reference missing PyArg_ParseTuple(),
20 PyArg_ParseTupleAndKeywords(), Py_BuildValue(). Information
21 requested by Greg Kochanski <gpk@bell-labs.com>. PyEval_EvalCode()
22 has also been requested.
23
Fred Drake8d43a291999-01-12 21:31:16 +000024* Update the pickle documentation to describe all of the current
Fred Drake6a90b5e1999-12-21 23:02:38 +000025 behavior; only a subset is described. __reduce__, etc. Partial
26 update submitted by Jim Kerr <jbkerr@sr.hp.com>.
Fred Drake81f4b661998-02-17 19:01:02 +000027
Fred Drake5a8aaa71999-07-02 14:31:41 +000028* Update the code/codeop module documentation.
Fred Drakee0208cc1999-04-22 13:05:52 +000029
Fred Drake6a90b5e1999-12-21 23:02:38 +000030* Figure out HTMLHelp generation for the Windows world.
31
32* Straighten out random/whrandom.
33
34
35NOT WORTH THE TROUBLE
36---------------------
37
Fred Drake8d43a291999-01-12 21:31:16 +000038* In the indexes, some subitem entries are separated from the item
39 entries by column- or page-breaks. Reported by Lorenzo M. Catucci
Fred Drake9ef86351999-04-29 04:23:37 +000040 <lorenzo@argon.roma2.infn.it>. This one will be hard; probably not
Fred Drake5a8aaa71999-07-02 14:31:41 +000041 really worth the pain. (Only an issue at all when a header-letter
42 and the first index entry get separated -- can change as soon as we
43 change the index entries in the text.)
Fred Drake13529c41998-07-24 13:02:17 +000044
45* Fix problem with howto documents getting the last module synopsis
46 twice (in \localmoduletable) so we can get rid of the ugly 'uniq'
Fred Drake6a90b5e1999-12-21 23:02:38 +000047 hack in tools/mkhowto. (Probably not worth the trouble of fixing.)