W. Trevor King 2277901a72 Deprecate the --debug setting
"Limits the number of worker processes to 1" hasn't been true since
06a4dc6 (fix one error in gunicorn_paster, global conf was ignored,
2010-06-22), although it was true when the line was added in 3c7d532
(Large refactor of the documentation and website, 2010-05-22).

"changes some error handling that's sent to clients" hasn't been true
since feb86d3 (don't display the traceback in the HTTP response,
2013-09-27).

The only remaining actions that --debug had were disabling --preload
and hiding debug-level config logging.  The former seems useless (just
disable --preload directly) and the latter at doesn't seem useful
enough for a new setting (just turn down --log-level).  With this
commit, --preload always works and you always get debug-level config
logging.

I left a stub Debug entry in gunicorn.config, which we can leave in
place while folks convert any gunicorn scripts and configurations to
drop --debug.  When the time comes, we can just remove that entry.  I
also the boolean-config tests to use --preload, since that will still
be around after we remove the dummy Debug entry.

Fixes #700.
2014-02-13 12:40:41 -08:00
..
2012-10-21 08:14:27 +03:00
2013-12-12 15:00:45 -08:00
2014-02-13 12:40:41 -08:00
2013-12-26 13:42:17 +01:00
2012-10-03 05:04:07 +05:45
2013-06-29 06:09:52 +02:00
2012-10-03 04:29:35 +05:45
2012-10-03 04:29:35 +05:45

Generate Documentation
======================

Requirements
------------

To generate documentation you need to install:

 - Python >= 2.5
 - Sphinx (http://sphinx.pocoo.org/)


Generate html
-------------
::

    $ make html

The command generates html document inside ``build/html`` dir.