Fred Drake | b866020 | 1998-02-18 16:03:43 +0000 | [diff] [blame] | 1 | PYTHON DOCUMENTATION TO-DO LIST -*- indented-text -*- |
Fred Drake | 81f4b66 | 1998-02-17 19:01:02 +0000 | [diff] [blame] | 2 | =============================== |
| 3 | |
| 4 | |
Fred Drake | 5a8aaa7 | 1999-07-02 14:31:41 +0000 | [diff] [blame] | 5 | * 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 Drake | 8ece804 | 1999-02-22 14:37:18 +0000 | [diff] [blame] | 9 | * 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 Drake | 10682c2 | 1999-04-23 15:15:58 +0000 | [diff] [blame] | 14 | * 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 Drake | 8d43a29 | 1999-01-12 21:31:16 +0000 | [diff] [blame] | 19 | * Update the pickle documentation to describe all of the current |
| 20 | behavior; only a subset is described. __reduce__, etc. |
Fred Drake | 81f4b66 | 1998-02-17 19:01:02 +0000 | [diff] [blame] | 21 | |
Fred Drake | 5a8aaa7 | 1999-07-02 14:31:41 +0000 | [diff] [blame] | 22 | * Update the code/codeop module documentation. |
Fred Drake | e0208cc | 1999-04-22 13:05:52 +0000 | [diff] [blame] | 23 | |
Fred Drake | 8d43a29 | 1999-01-12 21:31:16 +0000 | [diff] [blame] | 24 | * In the indexes, some subitem entries are separated from the item |
| 25 | entries by column- or page-breaks. Reported by Lorenzo M. Catucci |
Fred Drake | 9ef8635 | 1999-04-29 04:23:37 +0000 | [diff] [blame] | 26 | <lorenzo@argon.roma2.infn.it>. This one will be hard; probably not |
Fred Drake | 5a8aaa7 | 1999-07-02 14:31:41 +0000 | [diff] [blame] | 27 | really worth the pain. (Only an issue at all when a header-letter |
| 28 | and the first index entry get separated -- can change as soon as we |
| 29 | change the index entries in the text.) |
Fred Drake | 13529c4 | 1998-07-24 13:02:17 +0000 | [diff] [blame] | 30 | |
| 31 | * Fix problem with howto documents getting the last module synopsis |
| 32 | twice (in \localmoduletable) so we can get rid of the ugly 'uniq' |
Fred Drake | 9ef8635 | 1999-04-29 04:23:37 +0000 | [diff] [blame] | 33 | hack in tools/mkhowto.sh. (Probably not worth the trouble of |
| 34 | fixing.) |
Fred Drake | 8d43a29 | 1999-01-12 21:31:16 +0000 | [diff] [blame] | 35 | |
Fred Drake | 8d43a29 | 1999-01-12 21:31:16 +0000 | [diff] [blame] | 36 | * Figure out HTMLHelp generation for the Windows world. |
Fred Drake | 873f029 | 1999-06-17 15:20:44 +0000 | [diff] [blame] | 37 | |
Fred Drake | 9ed56de | 1999-08-19 15:37:35 +0000 | [diff] [blame] | 38 | * Straighten out random/whrandom. |
| 39 | |
Fred Drake | 9b59a30 | 1999-06-29 18:54:03 +0000 | [diff] [blame] | 40 | |
| 41 | BEFORE NEXT PYTHON RELEASE, BUT NOT UNTIL THEN: |
| 42 | |
| 43 | * Document that the mode parameter to wave.open() may be omitted, and |
| 44 | how it is determined if omitted. (Same of aifc, sunau open() |
| 45 | functions.) |
| 46 | |
| 47 | * Document that fpformat.NotANumber is a subclass of ValueError, has |
| 48 | the string that failed as the "exception value". |