| 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 | |
| Fred Drake | e39dab6 | 2000-07-31 18:18:27 +0000 | [diff] [blame] | 4 | General |
| 5 | ------- |
| 6 | |
| 7 | * Figure out HTMLHelp generation for the Windows world. |
| 8 | |
| Fred Drake | e39dab6 | 2000-07-31 18:18:27 +0000 | [diff] [blame] | 9 | |
| 10 | Python/C API |
| 11 | ------------ |
| Fred Drake | 81f4b66 | 1998-02-17 19:01:02 +0000 | [diff] [blame] | 12 | |
| Fred Drake | 5a8aaa7 | 1999-07-02 14:31:41 +0000 | [diff] [blame] | 13 | * The "Very High Level Interface" in the API document has been |
| 14 | requested; I guess it wouldn't hurt to fill in a bit there. Request |
| 15 | by Albert Hofkamp <a.hofkamp@wtb.tue.nl>. (Partly done.) |
| 16 | |
| Fred Drake | 8ece804 | 1999-02-22 14:37:18 +0000 | [diff] [blame] | 17 | * Describe implementing types in C, including use of the 'self' |
| 18 | parameter to the method implementation function. (Missing material |
| 19 | mentioned in the Extending & Embedding manual, section 1.1; problem |
| Fred Drake | e39dab6 | 2000-07-31 18:18:27 +0000 | [diff] [blame] | 20 | reported by Clay Spence <cspence@sarnoff.com>.) Heavily impacts one |
| 21 | chapter of the Python/C API manual. |
| Fred Drake | 8ece804 | 1999-02-22 14:37:18 +0000 | [diff] [blame] | 22 | |
| Fred Drake | e39dab6 | 2000-07-31 18:18:27 +0000 | [diff] [blame] | 23 | * Missing PyArg_ParseTuple(), PyArg_ParseTupleAndKeywords(), |
| 24 | Py_BuildValue(). Information requested by Greg Kochanski |
| 25 | <gpk@bell-labs.com>. PyEval_EvalCode() has also been requested. |
| Fred Drake | 10682c2 | 1999-04-23 15:15:58 +0000 | [diff] [blame] | 26 | |
| Fred Drake | e39dab6 | 2000-07-31 18:18:27 +0000 | [diff] [blame] | 27 | Extending & Embedding |
| 28 | --------------------- |
| 29 | |
| 30 | * More information is needed about building dynamically linked |
| 31 | extensions in C++. Specifically, the extensions must be linked |
| 32 | against the C++ libraries (and possibly runtime). Also noted by |
| 33 | Albert Hofkamp <a.hofkamp@wtb.tue.nl>. |
| 34 | |
| 35 | Reference Manual |
| 36 | ---------------- |
| 37 | |
| 38 | * Document the Extended Call Syntax in the language reference. |
| 39 | [Jeremy Hylton] |
| 40 | |
| 41 | * Document new comparison support for recursive objects (lang. ref.? |
| 42 | library ref.? (cmp() function). [Jeremy Hylton] |
| 43 | |
| 44 | Library Reference |
| 45 | ----------------- |
| 46 | |
| Fred Drake | 8d43a29 | 1999-01-12 21:31:16 +0000 | [diff] [blame] | 47 | * Update the pickle documentation to describe all of the current |
| Fred Drake | 6a90b5e | 1999-12-21 23:02:38 +0000 | [diff] [blame] | 48 | behavior; only a subset is described. __reduce__, etc. Partial |
| 49 | update submitted by Jim Kerr <jbkerr@sr.hp.com>. |
| Fred Drake | 81f4b66 | 1998-02-17 19:01:02 +0000 | [diff] [blame] | 50 | |
| Fred Drake | 0f353ed | 2000-06-29 03:33:28 +0000 | [diff] [blame] | 51 | * Update the httplib documentation to match Greg Stein's HTTP/1.1 |
| 52 | support and new classes. (Greg, this is yours!) |
| 53 | |
| Fred Drake | e39dab6 | 2000-07-31 18:18:27 +0000 | [diff] [blame] | 54 | Tutorial |
| 55 | -------- |
| 56 | |
| 57 | * Update tutorial to use string methods and talk about backward |
| 58 | compatibility of same. |
| 59 | |
| Fred Drake | 6a90b5e | 1999-12-21 23:02:38 +0000 | [diff] [blame] | 60 | |
| 61 | NOT WORTH THE TROUBLE |
| 62 | --------------------- |
| 63 | |
| Fred Drake | 8d43a29 | 1999-01-12 21:31:16 +0000 | [diff] [blame] | 64 | * In the indexes, some subitem entries are separated from the item |
| 65 | entries by column- or page-breaks. Reported by Lorenzo M. Catucci |
| Fred Drake | 9ef8635 | 1999-04-29 04:23:37 +0000 | [diff] [blame] | 66 | <lorenzo@argon.roma2.infn.it>. This one will be hard; probably not |
| Fred Drake | 5a8aaa7 | 1999-07-02 14:31:41 +0000 | [diff] [blame] | 67 | really worth the pain. (Only an issue at all when a header-letter |
| 68 | and the first index entry get separated -- can change as soon as we |
| Fred Drake | e39dab6 | 2000-07-31 18:18:27 +0000 | [diff] [blame] | 69 | change the index entries in the text.) Also only a problem in the |
| 70 | print version. |
| Fred Drake | 13529c4 | 1998-07-24 13:02:17 +0000 | [diff] [blame] | 71 | |
| 72 | * Fix problem with howto documents getting the last module synopsis |
| 73 | twice (in \localmoduletable) so we can get rid of the ugly 'uniq' |
| Fred Drake | 6a90b5e | 1999-12-21 23:02:38 +0000 | [diff] [blame] | 74 | hack in tools/mkhowto. (Probably not worth the trouble of fixing.) |