Doc/TODO

   1 PYTHON DOCUMENTATION TO-DO LIST                 -*- indented-text -*-
   2 ===============================
   3
   4
   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
   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
  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
  19 * 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
  24 * Update the pickle documentation to describe all of the current
  25   behavior; only a subset is described.  __reduce__, etc.  Partial
  26   update submitted by Jim Kerr <jbkerr@sr.hp.com>.
  27
  28 * Update the code/codeop module documentation.
  29
  30 * Figure out HTMLHelp generation for the Windows world.
  31
  32 * Straighten out random/whrandom.
  33
  34
  35 NOT WORTH THE TROUBLE
  36 ---------------------
  37
  38 * In the indexes, some subitem entries are separated from the item
  39   entries by column- or page-breaks.  Reported by Lorenzo M. Catucci
  40   <lorenzo@argon.roma2.infn.it>.  This one will be hard; probably not
  41   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.)
  44
  45 * Fix problem with howto documents getting the last module synopsis
  46   twice (in \localmoduletable) so we can get rid of the ugly 'uniq'
  47   hack in tools/mkhowto.  (Probably not worth the trouble of fixing.)