make_app() now uses the debugger param in DebugMiddleware()

Setting app.debugger in setup.py now takes proper effect.
A warning is issued if the entry point is not callable.

Change-Id: I58a860b8ef0e1cb956b4554071275c024a1949d2
Closes-Bug: #1449573

1 files changed, 14 insertions, 1 deletions

diff --git a/docs/source/development.rst b/docs/source/development.rst
index f4e3217..db9bd84 100644
--- a/docs/source/development.rst
+++ b/docs/source/development.rst
@@ -29,11 +29,24 @@ browser for easy debugging:
 
 To further aid in debugging, the middleware includes the ability to repeat the
 offending request, automatically inserting a breakpoint, and dropping your
-console into the Python debugger, ``pdb``:
+console into the Python debugger, ``pdb.post_mortem``:
 
 .. figure:: debug-middleware-2.png
    :alt: Pecan debug middleware request debugger. 
 
+You can also use any debugger with a suitable ``post_mortem`` entry point.
+For example, to use the `PuDB Debugger <http://pypi.python.org/pypi/pudb>`_,
+set ``debugger`` like so::
+
+    import pudb
+
+    app = {
+        ...
+        'debug': True,
+        'debugger': pudb.post_mortem,
+        ...
+    }
+
 .. seealso::
 
   Refer to the `pdb documentation