Store exceptions raised by ``abort`` in the WSGI environ.

This makes it easier to access the original exception later in the request cycle (e.g., other middleware or in custom error handlers).

1 files changed, 7 insertions, 0 deletions

diff --git a/docs/source/routing.rst b/docs/source/routing.rst
index e27baf6..6ed3524 100644
--- a/docs/source/routing.rst
+++ b/docs/source/routing.rst
@@ -163,6 +163,13 @@ Pecan also comes with ``abort``, a utility function for raising HTTP errors:
             abort(404)
 
 
+Under the hood, ``abort`` raises an instance of
+``webob.exc.WSGIHTTPException`` which is used by pecan to render default
+response bodies for HTTP errors.  This exception is stored in the WSGI request
+environ at ``pecan.original_exception``, where it can be accessed later in the
+request cycle (by, for example, other middleware or :ref:`errors`).
+
+
 Routing to Subcontrollers with ``_lookup``
 ------------------------------------------