Docs: explanatory diagram for error-handling flow.

2 files changed, 12 insertions, 0 deletions

diff --git a/docs/book/xml/errorhandling.xml b/docs/book/xml/errorhandling.xml
index f4bb7675..183b0c51 100644
--- a/docs/book/xml/errorhandling.xml
+++ b/docs/book/xml/errorhandling.xml
@@ -2,6 +2,15 @@
 <section xmlns:db="http://docbook.org/docbook-ng" xmlns:xi="http://www.w3.org/2001/XInclude"
          xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xml:id="globaloverviewcherrypy">
     <title>Exceptions and Error Handling</title>
+    <para>As you read this section, refer to the following diagram to understand the flow of
+    execution:</para>
+    <figure>
+        <mediaobject>
+            <imageobject>
+                <imagedata fileref="errors.gif" />
+            </imageobject>
+        </mediaobject>
+    </figure>
     <section>
         <title>Unanticipated exceptions</title>
         <para>When an unhandled exception is raised inside CherryPy, three actions occur (in
@@ -14,6 +23,9 @@
                 <para>a <code>_cpOnError</code> method is called</para>
             </listitem>
             <listitem>
+                <para><code>response.finalize</code> is called</para>
+            </listitem>
+            <listitem>
                 <para><code>afterErrorResponse</code> filter methods are called</para>
             </listitem>
         </itemizedlist>
diff --git a/docs/book/xml/errors.gif b/docs/book/xml/errors.gif
new file mode 100644
index 00000000..a272790a
--- /dev/null
+++ b/docs/book/xml/errors.gif