blob: 30052804f03edbd9ab66cf9b6a3012bea256216d [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 Drake8d43a291999-01-12 21:31:16 +000019* Update the pickle documentation to describe all of the current
Fred Drake6a90b5e1999-12-21 23:02:38 +000020 behavior; only a subset is described. __reduce__, etc. Partial
21 update submitted by Jim Kerr <jbkerr@sr.hp.com>.
Fred Drake81f4b661998-02-17 19:01:02 +000022
Fred Drake5a8aaa71999-07-02 14:31:41 +000023* Update the code/codeop module documentation.
Fred Drakee0208cc1999-04-22 13:05:52 +000024
Fred Drake6a90b5e1999-12-21 23:02:38 +000025* Figure out HTMLHelp generation for the Windows world.
26
27* Straighten out random/whrandom.
28
29
30NOT WORTH THE TROUBLE
31---------------------
32
Fred Drake8d43a291999-01-12 21:31:16 +000033* In the indexes, some subitem entries are separated from the item
34 entries by column- or page-breaks. Reported by Lorenzo M. Catucci
Fred Drake9ef86351999-04-29 04:23:37 +000035 <lorenzo@argon.roma2.infn.it>. This one will be hard; probably not
Fred Drake5a8aaa71999-07-02 14:31:41 +000036 really worth the pain. (Only an issue at all when a header-letter
37 and the first index entry get separated -- can change as soon as we
38 change the index entries in the text.)
Fred Drake13529c41998-07-24 13:02:17 +000039
40* Fix problem with howto documents getting the last module synopsis
41 twice (in \localmoduletable) so we can get rid of the ugly 'uniq'
Fred Drake6a90b5e1999-12-21 23:02:38 +000042 hack in tools/mkhowto. (Probably not worth the trouble of fixing.)