- Added API docs for ``pyramid.httpexceptions.abort`` and

  ``pyramid.httpexceptions.redirect``.

- Added "HTTP Exceptions" section to Views narrative chapter including a
  description of ``pyramid.httpexceptions.abort``; adjusted redirect section
  to note ``pyramid.httpexceptions.redirect``.

- A default exception view for the context ``webob.exc.HTTPException`` (aka
  ``pyramid.httpexceptions.HTTPException``) is now registered by default.
  This means that an instance of any exception class imported from
  ``pyramid.httpexceptions`` (such as ``HTTPFound``) can now be raised from
  within view code; when raised, this exception view will render the
  exception to a response.

- New functions named ``pyramid.httpexceptions.abort`` and
  ``pyramid.httpexceptions.redirect`` perform the equivalent of their Pylons
  brethren when an HTTP exception handler is registered.  These functions
  take advantage of the newly registered exception view for
  ``webob.exc.HTTPException``.

- The Configurator now accepts an additional keyword argument named
  ``httpexception_view``.  By default, this argument is populated with a
  default exception view function that will be used when an HTTP exception is
  raised.  When ``None`` is passed for this value, an exception view for HTTP
  exceptions will not be registered.  Passing ``None`` returns the behavior
  of raising an HTTP exception to that of Pyramid 1.0 (the exception will
  propagate to middleware and to the WSGI server).

1 files changed, 6 insertions, 0 deletions

diff --git a/docs/glossary.rst b/docs/glossary.rst
index e1e9e76a9..797343e5e 100644
--- a/docs/glossary.rst
+++ b/docs/glossary.rst
@@ -618,6 +618,12 @@ Glossary
       request processing.  See :ref:`exception_views` for more
       information.
 
+   HTTP Exception
+      The set of exception classes defined in :mod:`pyramid.httpexceptions`.
+      These can be used to generate responses with various status codes when
+      raised or returned from a :term:`view callable`.  See also
+      :ref:`http_exceptions`.
+
    thread local
       A thread-local variable is one which is essentially a global variable
       in terms of how it is accessed and treated, however, each `thread