[ http://issues.apache.org/jira/browse/MODPYTHON-28?page=comments#action_66505 ] Jim Gallacher commented on MODPYTHON-28: ----------------------------------------
You got the LaTex mostly right. There is one error (a stray backslash) which I've corrected in the attached patch. As for the testing documentation itself, in section 2.4 item 7 you mention the need to "use a higher level handler such as mod_python publisher (see 3.1), mpservlets or Vampire". It may not be obvious to the reader that mpservlets and Vampire are not included with mod_python. Maybe add somthing at the end of section 2.4 such: \begin{seealso} \seeurl{http://home.comcast.net/~d.popowich/mpservlets}{mpservlets} \seeurl{http://www.dscpl.com.au/projects/vampire}{Vampire} \end{seealso} > Add a standard test handler in the distribution > ----------------------------------------------- > > Key: MODPYTHON-28 > URL: http://issues.apache.org/jira/browse/MODPYTHON-28 > Project: mod_python > Type: Improvement > Versions: 3.1.4, 2.7.10 > Reporter: Nicolas Lehuen > Assignee: Nicolas Lehuen > Fix For: 3.2.0 > Attachments: modpython2.tex-jg20050528-1.diff > > Improving the testing phase of the installation is crucial as we get a steady > stream of question from new users who can't run the mptest or are confused > about its meaning (for example, the fact that any URL ending with .py runs > the mptest handler is misleading at first). > We should include a standard mptest handler in the distribution so that we > can better help beginners, without making them struggle with a new file > PYTHONPATH, syntax errors in the handler, etc. Ideally, the mptest handler > should display useful informations both in the Apache log and in the result > page ; this would help us check their environment and provide better help. > The information displayed could be (both in the log and the result page) : > - Apache version (+MPM type if this information can be queried at runtime) > - Python version > - mod_python version > - sys.path > - mod_python.publisher available yes/no > - mod_python.psp available yes/no > Of course, if anything goes wrong, it should be clearly stated in the Apache > log (no misleading 404 errors, please !). > The testing phase of the installation would then be : 1) set "SetHandler > mod_python.mptest" directive and 2) watch the results. This would be far less > messy as it is currently. -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa - For more information on JIRA, see: http://www.atlassian.com/software/jira