[gimp] devel-docs: Update contexts.txt with single-window mode

[Martin Nordholts <martinn src gnome org>]

commit 0902cd4136f00b11b4a29f7c8c3e92db726678f7
Author: Martin Nordholts <martinn src gnome org>
Date:   Wed Jan 6 13:34:25 2010 +0100

    devel-docs: Update contexts.txt with single-window mode

 devel-docs/contexts.txt |   31 ++++++++++++++++++++++++++++---
 1 files changed, 28 insertions(+), 3 deletions(-)
---
diff --git a/devel-docs/contexts.txt b/devel-docs/contexts.txt
index db6b3df..08ca87c 100644
--- a/devel-docs/contexts.txt
+++ b/devel-docs/contexts.txt
@@ -33,7 +33,6 @@ factory getter), and the layer dockable have connected a signal
 handler to image changes in the dock window context. The sequence of
 events is as follows:
 
-
                     GimpContext                  GimpContext   GimpItemTreeView,
  GimpDisplayShell      user      GimpDockWindow  dock window   GimpLayerTreeView
 
@@ -55,10 +54,36 @@ events is as follows:
         |                |              |              |------------>|
         |                |              |              |             |
 
+In single-window mode, the dockables listens directly to the user
+context. When switching between single-window and multi-window modes,
+the dockables are updated with their new context. Just as when moving
+a dockable between different dock windows and thus also different
+contexts. The sequence diagram for single-window mode is:
+
+                    GimpContext  GimpItemTreeView
+ GimpDisplayShell      user      GimpLayerTreeView
+
+        |                |              |
+ focus event             |              |
+------->|                |              |
+        |  gimp_context_set_display()   |
+        |--------------->|----------+   |
+        |                |          |   |
+        |  gimp_context_set_image() |   |
+        |                |<---------+   |
+        |                |              |
+        |                |    "image-changed" /
+        |                |       set_image()
+        |                |------------->|
+        |                |              |
+        |                |              |
+        |                |              |
+        |                |              |
+        |                |              |
+        |                |              |
+
 
 Parent/child relationships
 --------------------------
 
 TODO
-
-