svn commit: r468290 - /httpd/mod_python/trunk/Doc/modpython3.tex

[gr...@apache.org]

Author: grahamd
Date: Thu Oct 26 23:14:48 2006
New Revision: 468290

URL: http://svn.apache.org/viewvc?view=rev&rev=468290
Log:
Add note about using apache.DONE in non response phase handlers when wishing
to send a complete response and terminate processing.


Modified:
    httpd/mod_python/trunk/Doc/modpython3.tex

Modified: httpd/mod_python/trunk/Doc/modpython3.tex
URL: http://svn.apache.org/viewvc/httpd/mod_python/trunk/Doc/modpython3.tex?view=diff&rev=468290&r1=468289&r2=468290
==============================================================================
--- httpd/mod_python/trunk/Doc/modpython3.tex (original)
+++ httpd/mod_python/trunk/Doc/modpython3.tex Thu Oct 26 23:14:48 2006
@@ -473,3 +473,12 @@
       req.write(pagebuffer)
       return(apache.OK)
 \end{verbatim}
+
+Note that if wishing to returning an error page from a handler phase other
+than the response handler, the value \code{apache.DONE} must be returned
+instead of \code{apache.OK}. If this is not done, subsequent handler phases
+will still be run. The value of \code{apache.DONE} indicates that processing
+of the request should be stopped immediately. If using stacked response
+handlers, then \code{apache.DONE} should also be returned in that situation
+to prevent subsequent handlers registered for that phase being run if
+appropriate.