[gimp-help-2] Change in prefs-window-management.xml

[Julien Hardlin <jhardlin src gnome org>]

commit dabfa0ce0e74976c99391388a074bdbbdcbd8ceb
Author: Julien Hardelin <jm hard wanadoo fr>
Date:   Wed May 20 22:10:50 2009 +0200

    Change in prefs-window-management.xml
---
 src/using/preferences/prefs-window-management.xml |   59 ++++++++++++++++++---
 1 files changed, 52 insertions(+), 7 deletions(-)

diff --git a/src/using/preferences/prefs-window-management.xml b/src/using/preferences/prefs-window-management.xml
index 8c8edf3..9959b9c 100644
--- a/src/using/preferences/prefs-window-management.xml
+++ b/src/using/preferences/prefs-window-management.xml
@@ -47,13 +47,58 @@
         <listitem>
           <para>
             The choices you make here determine how the Toolbox, and the docks
-            that hold dialogs, will be treated. If you choose "Normal Window",
-            they will be treated like any other windows. If you choose
-            "Utility Window", they will be raised into visibility whenever you
-            activate an image window, and kept in front of every image window.
-            If you choose "Keep above", they will be kept in front of every
-            other window at all times. Note that changes you make here will
-            not take effect until the next time you start GIMP.
+            that hold dialogs, will be treated. You have three possibilities
+            for them:
+            <itemizedlist>
+              <listitem>
+                <para>
+                  If you choose <guilabel>Normal Window</guilabel>, they will
+                  be treated like any other windows.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  If you choose <guilabel>Utility Window</guilabel>, the
+                  reduce button in the title bar is absent and the dock will
+                  remain permanently on your screen.
+                </para>
+                <figure>
+                  <title>Utility window title bar</title>
+                  <mediaobject>
+                    <imageobject>
+                      <imagedata format="PNG"
+                        fileref="images/preferences/normal-title-bar.png" />
+                    </imageobject>
+                    <caption>
+                      <para>
+                        Normal title bar
+                      </para>
+                    </caption>
+                  </mediaobject>
+                  <mediaobject>
+                    <imageobject>
+                      <imagedata format="PNG"
+                        fileref="images/preferences/utility-title-bar.png" />
+                    </imageobject>
+                    <caption>
+                      <para>
+                        The title bar in a utility window
+                      </para>
+                    </caption>
+                  </mediaobject>
+                </figure>
+              </listitem>
+              <listitem>
+                <para>
+                  If you choose <guilabel>Keep above</guilabel>, they will be
+                  kept in front of every other window at all times.
+                </para>
+              </listitem>
+            </itemizedlist>
+          </para>
+          <para>
+            Note that changes you make here will not take effect until the
+            next time you start GIMP.
           </para>
         </listitem>
       </varlistentry>