- documentation updates and a test polish

CHANGES.rst

@@ -54,7 +54,9 @@ Features
 Other changes
 +++++++++++++
 
-- Exceptions during publishing are now re-raised in a new exceptions debug mode
+- Exceptions during publishing are now re-raised in a new exceptions debug
+  mode to allow WSGI middleware to handle/debug it. See the `documentation
+  <https://zope.readthedocs.io/en/latest/wsgi.html#werkzeug>`_ for examples.
   (`#562 <https://github.com/zopefoundation/Zope/issues/562>`_)
 
 - Remove hardcoded list of factories that don't want an add dialog

docs/wsgi.rst

@@ -251,7 +251,7 @@ This is how you run Zope in exceptions debug mode using the built-in
 
 .. code-block:: console
 
-   $ bin/runwsgi -ev etc/zope.ini
+   $ bin/runwsgi -e etc/zope.ini
 
 If you built your environment using ``plone.recipe.zope2instance`` you will
 need to do a manual change to your Zope configuration file. Enable exceptions

src/ZPublisher/tests/test_WSGIPublisher.py

@@ -652,13 +652,14 @@ def response_factory(stdout, stderr):
             response.debug_exceptions = True
             return response
 
-        # With debug_exceptions, the exception view is not called.
-        with self.assertRaises(BadRequest):
-            self._callFUT(environ, start_response, _publish,
-                          _response_factory=response_factory)
-
-        # Clean up view registration
-        unregisterExceptionView(IException)
+        try:
+            # With debug_exceptions, the exception view is not called.
+            with self.assertRaises(BadRequest):
+                self._callFUT(environ, start_response, _publish,
+                              _response_factory=response_factory)
+        finally:
+            # Clean up view registration
+            unregisterExceptionView(IException)
 
 
 class ExcViewCreatedTests(ZopeTestCase):