BUGS
====

   * Autoconfiguration relies on the existence of "grep", "cut" and
     "tr".
   
   * When handling a parsed HTML, the directive `<!--#exec cgi="file.py"-->'
     is performed as a normal CGI, not through this module. This is caused
     by the way Apache treats that directive. The easier workaround is to use
     `<!--#include virtual="file.py"-->', that is similar to the former but
     does not have this limitation.

   * Since the Apache Server executes itself under user `nobody', it is able
     to create the compiled version of the scripts it executes only when the
     directory containing them is writable by everybody, which may be an
     insane choice in some circumstances. The workaround is to create/update
     the compiled scripts whenever you install their sources (see the
     `compileall.py' library module in the Python Distribution).

   * This module requires Python 1.5[.1] and Apache 1.3.1, and will
     require some work to adapt it to higher releases.
     If you are still using Apache 1.2, then you need release 2.43
     of this module.

   * Suspicious code is marked with a 'XXX' sign: feel free to email me
     your mumblings on it.

   * Solved in 4.6: multipart handling wasn't working right.

   * Maybe not a bug, but: in 4.14, the Location header gets honored if it
     is a local URL (begins with '/'), otherwise you need to explicitly say
     "Status: 302". mod_cgi.c, in this situation, says <<Note that if a
     script wants to produce its own Redirect body, it now has to
     explicitly *say* "Status: 302">>, and returns a REDIRECT code, which is
     difficult in current PyApache.
     I do not understand very well the situation, so my doubts...

     