[Checkins] SVN: grok/trunk/doc/upgrade.txt add a note about the debug.ini profile and the fact that IUnauthorized exceptions are always handled by zope.publisher regardless of the handleErrors=False argument.

[Jan-Wijbrand Kolman]

Log message for revision 104579:
  add a note about the debug.ini profile and the fact that IUnauthorized exceptions are always handled by zope.publisher regardless of the handleErrors=False argument.

Changed:
  U   grok/trunk/doc/upgrade.txt

-=-
Modified: grok/trunk/doc/upgrade.txt
===================================================================
--- grok/trunk/doc/upgrade.txt	2009-09-27 12:15:09 UTC (rev 104578)
+++ grok/trunk/doc/upgrade.txt	2009-09-27 20:08:12 UTC (rev 104579)
@@ -102,12 +102,28 @@
 
     bin/projectname-ctl fg
 
-  You can also start it with ``parts/etc/debug.ini`` to get exception
-  formatting.
+  Alternatively there's a profile available that can help debugging errors in
+  your application::
 
+    bin/paster serve parts/etc/debug.ini
+
+  When using this profile it is not the ``zope.publisher`` that handles the
+  exceptions that are raised, but a special middleware is. This middleware
+  then provides a pdb-like debugging user interdace in the browser.
+
+  Note that the ``IUnauthorized`` exception is treated specially: Grok will
+  make sure that this types of exception is actaully still handled by
+  ``zope.publisher`` in order to make login forms or Basic Auth
+  authentication still function properly.
+
+  Also note that as a consequence the ``handleErrors`` attribute on
+  ``zope.testbrowser.testing.Browser`` instances used in functional tests
+  does not effect the ``IUnauthorized`` exception.
+
   Interpreter name has been changed from ``bin/python`` to
   ``bin/grokpy`` to avoid conflicts with virtualenv.
 
+
 * Old ``buildout.cfg`` contain a ``find-links`` line like this::
 
    find-links = http://download.zope.org/distribution/