Fixed #5677 -- update modpython stdout documentation. Thanks to Manfred Wassmann for the report, nickefford for the initial patch and Graham Dumpleton for the expert advice.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@14059 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Simon Meers 2010-10-09 05:08:42 +00:00
parent b7a73cf929
commit c93f5e5d0e
1 changed files with 18 additions and 6 deletions

View File

@ -158,6 +158,8 @@ the full URL.
When deploying Django sites on mod_python, you'll need to restart Apache each
time you make changes to your Python code.
.. _mod_python documentation: http://modpython.org/live/current/doc-html/directives.html
Multiple Django installations on the same Apache
================================================
@ -211,15 +213,25 @@ everything for each request. But don't do that on a production server, or we'll
revoke your Django privileges.
If you're the type of programmer who debugs using scattered ``print``
statements, note that ``print`` statements have no effect in mod_python; they
don't appear in the Apache log, as one might expect. If you have the need to
print debugging information in a mod_python setup, either do this::
statements, note that output to ``stdout`` will not appear in the Apache
log and can even `cause response errors`_.
assert False, the_value_i_want_to_see
.. _cause response errors: http://blog.dscpl.com.au/2009/04/wsgi-and-printing-to-standard-output.html
Or add the debugging information to the template of your page.
If you have the need to print debugging information in a mod_python setup, you
have a few options. You can print to ``stderr`` explicitly, like so::
print >> sys.stderr, 'debug text'
sys.stderr.flush()
(note that ``stderr`` is buffered, so calling ``flush`` is necessary if you wish
debugging information to be displayed promptly.)
A more compact approach is to use an assertion::
.. _mod_python documentation: http://modpython.org/live/current/doc-html/directives.html
assert False, 'debug text'
Another alternative is to add debugging information to the template of your page.
Serving media files
===================