gimp-help-2 r2767 - in trunk: . src/dialogs



Author: jhardlin
Date: Sat Feb 28 07:45:49 2009
New Revision: 2767
URL: http://svn.gnome.org/viewvc/gimp-help-2?rev=2767&view=rev

Log:
2009-02-28 Julien hardelin <jm hard wanadoo fr>

        * src/dialogs/fonts-dialog.xml
        * src/dialogs/path-dialog.xml
        * src/dialogs/templates-dialog.xml
        * src/dialogs/sample-points.xml
        * src/dialogs/images-dialog.xml
        * src/dialogs/channel-dialog.xml
        * src/dialogs/pointer-dialog.xml
        * src/dialogs/device-status-dialog.xml
        * src/dialogs/dialogs-structure.xml
        * src/dialogs/dialogs_introduction.xml
        * src/dialogs/channel-selection-mask.xml
        * src/dialogs/buffers-dialog.xml
        * src/dialogs/error-console.xml
        * src/dialogs/gradient-dialog.xml
        * src/dialogs/histogram-dialog.xml
        * src/dialogs/edit-template-dialog.xml
        * src/dialogs/export-file-dialog.xml
        * src/dialogs/navigation-dialog.xml
        * src/dialogs/patterns-dialog.xml
        * src/dialogs/tools-dialog.xml
        * src/dialogs/undo-history-dialog.xml
        * src/dialogs/layer-mask.xml
        * src/dialogs/brushes-dialog.xml
        * src/dialogs/layer-dialog.xml
        * src/dialogs/indexed-palette-dialog.xml
        * src/dialogs/channel-menu.xml
        * src/dialogs/color-dialog.xml
        * src/dialogs/document-dialog.xml
        * src/dialogs/qmask.xml
        * src/dialogs/palettes-dialog.xml
        * src/dialogs/gradient-editor-dialog.xml: cleaned xml files


Modified:
   trunk/ChangeLog
   trunk/src/dialogs/brushes-dialog.xml
   trunk/src/dialogs/buffers-dialog.xml
   trunk/src/dialogs/channel-dialog.xml
   trunk/src/dialogs/channel-menu.xml
   trunk/src/dialogs/channel-selection-mask.xml
   trunk/src/dialogs/color-dialog.xml
   trunk/src/dialogs/device-status-dialog.xml
   trunk/src/dialogs/dialogs-structure.xml
   trunk/src/dialogs/dialogs_introduction.xml
   trunk/src/dialogs/document-dialog.xml
   trunk/src/dialogs/edit-template-dialog.xml
   trunk/src/dialogs/error-console.xml
   trunk/src/dialogs/export-file-dialog.xml
   trunk/src/dialogs/fonts-dialog.xml
   trunk/src/dialogs/gradient-dialog.xml
   trunk/src/dialogs/gradient-editor-dialog.xml
   trunk/src/dialogs/histogram-dialog.xml
   trunk/src/dialogs/images-dialog.xml
   trunk/src/dialogs/indexed-palette-dialog.xml
   trunk/src/dialogs/layer-dialog.xml
   trunk/src/dialogs/layer-mask.xml
   trunk/src/dialogs/navigation-dialog.xml
   trunk/src/dialogs/palettes-dialog.xml
   trunk/src/dialogs/path-dialog.xml
   trunk/src/dialogs/patterns-dialog.xml
   trunk/src/dialogs/pointer-dialog.xml
   trunk/src/dialogs/qmask.xml
   trunk/src/dialogs/sample-points.xml
   trunk/src/dialogs/templates-dialog.xml
   trunk/src/dialogs/tools-dialog.xml
   trunk/src/dialogs/undo-history-dialog.xml

Modified: trunk/src/dialogs/brushes-dialog.xml
==============================================================================
--- trunk/src/dialogs/brushes-dialog.xml	(original)
+++ trunk/src/dialogs/brushes-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -12,15 +12,6 @@
   2005-11-28 replaced informalfigures by figures by lexa
 -->
 <sect2 id="gimp-brush-dialog">
-  <!--<sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-13</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Brushes Dialog</phrase>
   </title>
@@ -59,35 +50,52 @@
   </para>
   <sect3 id="gimp-brush-dialog-activate">
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the Dialog</phrase>
     </title>
     <para>
-      The Brushes dialog is a dockable dialog; see the section on
-      <link linkend="gimp-concepts-docks">Dialogs and Docking</link>
-      for help on manipulating it. It can be activated in several ways:
+      The <quote>Brushes</quote> dialog is a dockable dialog; see the
+      section <xref linkend="gimp-concepts-docks"/> for help on manipulating
+      it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          From the Toolbox, by clicking on the brush symbol in the
+          from the Toolbox, by clicking on the brush symbol in
           Brush/Pattern/Gradient area.
         </para>
       </listitem>
       <listitem>
         <para>
           From an image menu:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Windows</guisubmenu><guimenuitem>Brushes</guimenuitem></menuchoice>.
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Brushes</guimenuitem>
+          </menuchoice>;
         </para>
       </listitem>
       <listitem>
         <para>
-          From the Tab menu in any dockable dialog:
-          <menuchoice><guimenu>Add Tab</guimenu><guimenuitem>Brushes</guimenuitem></menuchoice>.
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Brushes</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
         <para>
-          From the Tool Options dialog for any of the paint tools, by
+          from the Tool Options dialog for any of the paint tools, by
           clicking on the Brush icon button, you get a popup with similar
           functionality that permits you to quickly choose a brush from the
           list; if you click on the button present on the right bottom of
@@ -156,7 +164,8 @@
         </title>
         <mediaobject>
           <imageobject>
-            <imagedata fileref="images/dialogs/brushes-grid-view.png" format="PNG"/>
+            <imagedata format="PNG"
+                       fileref="images/dialogs/brushes-grid-view.png"/>
           </imageobject>
           <caption>
             <para>View as Grid</para>
@@ -164,7 +173,8 @@
         </mediaobject>
         <mediaobject>
           <imageobject>
-            <imagedata fileref="images/dialogs/brushes-list-view.png" format="PNG"/>
+            <imagedata format="PNG"
+                       fileref="images/dialogs/brushes-list-view.png"/>
           </imageobject>
           <caption>
             <para>View as List</para>
@@ -226,7 +236,8 @@
       When you click on a brush preview, it becomes the current brush and
       it gets selected in the brush area of Toolbox and the Brush option of
       painting tools. When you double-click on a brush preview, you will
-      activate the <link linkend="gimp-brush-editor-dialog">BrushÂEditor</link>. You can also
+      activate the
+      <link linkend="gimp-brush-editor-dialog">BrushÂEditor</link>. You can also
       click on buttons at the bottom of the dialog to perform various actions.
     </para>
       <para>
@@ -263,7 +274,8 @@
       <variablelist>
         <mediaobject>
           <imageobject>
-            <imagedata fileref="images/dialogs/brushes-buttons.png" format="PNG"/>
+            <imagedata format="PNG"
+                       fileref="images/dialogs/brushes-buttons.png"/>
           </imageobject>
         </mediaobject>
         <varlistentry>
@@ -358,7 +370,8 @@
           </title>
           <mediaobject>
             <imageobject>
-              <imagedata fileref="images/dialogs/brushes-context-menu.png" format="PNG"/>
+              <imagedata format="PNG"
+                         fileref="images/dialogs/brushes-context-menu.png"/>
             </imageobject>
           </mediaobject>
         </figure>
@@ -373,7 +386,10 @@
         The other commands of this submenu are described with the Buttons,
         except for <guilabel>Copy Brush Location</guilabel> which allows to
         copy brush path into clipboard. By using the
-        <menuchoice><guimenu>File</guimenu><guimenuitem>Open Location</guimenuitem></menuchoice>,
+        <menuchoice>
+          <guimenu>File</guimenu>
+          <guimenuitem>Open Location</guimenuitem>
+        </menuchoice>,
         command, you can open the brush as a new image.
       </para>
     </sect4>
@@ -388,7 +404,8 @@
       </title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/dialogs/brushes-editor-dialog.png" format="PNG"/>
+          <imagedata format="PNG"
+                     fileref="images/dialogs/brushes-editor-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -511,8 +528,11 @@
     <note>
       <para>
         You can save this clipboard brush by using the
-        <menuchoice><guimenu>Edit</guimenu><guisubmenu>Paste
-        as</guisubmenu><guimenuitem>NewÂbrush</guimenuitem></menuchoice>
+        <menuchoice>
+          <guimenu>Edit</guimenu>
+          <guisubmenu>Paste as</guisubmenu>
+          <guimenuitem>New brush</guimenuitem>
+        </menuchoice>
         as soon as it appears in the Brushes dialog. (See
         <xref linkend="script-fu-paste-as-brush"/>.)
       </para>

Modified: trunk/src/dialogs/buffers-dialog.xml
==============================================================================
--- trunk/src/dialogs/buffers-dialog.xml	(original)
+++ trunk/src/dialogs/buffers-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
+  2009-02-25 j.h: revised for v2.6
   2007-08-09 revised for v2.4 by j.h
   2007-05-03 Added Spanish translation by AntI
   2006-09-03 lexa: added german translation
@@ -9,18 +10,10 @@
   2005-11-28 replaced informalfigures by figures by lexa
 -->
 <sect2 id="gimp-buffer-dialog">
-  <!--<sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2007-08-09</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Buffers Dialog</phrase>
   </title>
+
   <indexterm>
     <primary>Dialogs</primary>
     <secondary>Buffers</secondary>
@@ -50,6 +43,7 @@
   <indexterm>
     <primary>Paste Named</primary>
   </indexterm>
+
   <figure>
     <title>
       <phrase>The Buffers dialog (as a list)</phrase>
@@ -64,11 +58,19 @@
     Buffers are temporary repositories for image data, created when
     you cut or copy part of a drawable (a layer, layer mask, etc.).
     You can save a document in this buffer in two ways:
-    <menuchoice><guimenu>Edit</guimenu><guisubmenu>Buffer</guisubmenu><guimenuitem>Copy Named</guimenuitem></menuchoice>
+    <menuchoice>
+      <guimenu>Edit</guimenu>
+      <guisubmenu>Buffer</guisubmenu>
+      <guimenuitem>Copy Named</guimenuitem>
+    </menuchoice>
     or
-    <menuchoice><guimenu>Edit</guimenu><guisubmenu>Buffer</guisubmenu><guimenuitem>Cut Named</guimenuitem></menuchoice>
+    <menuchoice>
+      <guimenu>Edit</guimenu>
+      <guisubmenu>Buffer</guisubmenu>
+      <guimenuitem>Cut Named</guimenuitem>
+    </menuchoice>
     A dialog pops up asking you to name a buffer to store the data
-    in.  There is no hard limit on the number of named buffers you
+    in. There is no hard limit on the number of named buffers you
     can create, although, of course, each one consumes a share of memory.
   </para>
   <para>
@@ -83,41 +85,59 @@
       contents is to paste them into images.
     </para>
   </caution>
+
   <sect3 id="gimp-buffer-dialog-activate">
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the Dialog</phrase>
     </title>
     <para>
-      The Buffers dialog is a dockable dialog; see the section
-      <xref linkend="gimp-concepts-docks"/>
-      for help on manipulating it. It can be activated in several ways:
+      This dialog is a dockable dialog; see the
+      section <xref linkend="gimp-concepts-docks"/> for help on manipulating
+      it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          From the Toolbox menu:
-          <menuchoice><guimenu>File</guimenu><guisubmenu>Dialogs</guisubmenu><guimenuitem>Buffer</guimenuitem></menuchoice>.
+          from an image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Buffers</guimenuitem>
+          </menuchoice>;
         </para>
       </listitem>
       <listitem>
         <para>
-          From an image menu:
-          <menuchoice><guimenu>Dialogs</guimenu><guimenuitem>Buffer</guimenuitem></menuchoice>,
-          <!-- TODO: en please double check this - I doubt that this opens the dialog -->
-          <!-- Why this TODO? the following actually opens the Buffer dialog
-          -->
-          or
-          <menuchoice><guimenu>Edit</guimenu><guisubmenu>Buffer</guisubmenu><guimenuitem>Paste Named</guimenuitem></menuchoice>.
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          From the Tab menu in any dockable dialog:
-          <menuchoice><guimenu>Add Tab</guimenu><guimenuitem>Buffer</guimenuitem></menuchoice>.
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Buffers</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
     </itemizedlist>
+    <para>
+      In the <guimenu>Windows</guimenu> menu, there is a list of
+      <link linkend="gimp-dockable-menu">detached layers</link> which exists
+      only if at least one dialog remains open. In this case, you can raise
+      the <quote>Layers</quote> dialog from the image-menu:
+      <menuchoice>
+        <guimenu>Windows</guimenu>
+        <guimenuitem>Buffers</guimenuitem>
+      </menuchoice>.
+    </para>
   </sect3>
+
   <sect3 id="gimp-buffer-dialog-using">
     <title>
       <phrase>Using the Buffers dialog</phrase>
@@ -140,7 +160,7 @@
       floating selection; this is a quick way of executing the <quote>Paste
       Buffer</quote> command.
     </para>
-    <para><!--Changed 060226-->
+    <para>
       At the bottom of the dialog are four buttons. The operations they
       perform can also be accessed from the Buffers Menu that you get by right
       clicking on the active buffer.
@@ -151,7 +171,8 @@
       </title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/dialogs/buffers-dialog-grid.png" format="PNG"/>
+          <imagedata format="PNG"
+                     fileref="images/dialogs/buffers-dialog-grid.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -170,6 +191,7 @@
         the <quote>Preview Size</quote> submenu of the dialog's Tab menu.
       </para>
     </note>
+
     <sect4 id="gimp-buffer-dialog-buttons">
       <title>
         <phrase>Buttons at the bottom</phrase>
@@ -199,7 +221,8 @@
             <para>
               This command pastes the contents of the selected buffer into
               the active image's selection, as a floating selection. The
-              only difference between this and the ordinary <link linkend="gimp-edit-paste-into">Paste Into</link> command is
+              only difference between this and the ordinary
+              <link linkend="gimp-edit-paste-into">Paste Into</link> command is
               that it uses the selected buffer rather than the global
               clipboard buffer.
             </para>
@@ -212,7 +235,8 @@
             <para>
               This command creates a new single-layer image out of the
               contents of the selected buffer. The only difference between
-              this and the ordinary <link linkend="gimp-edit-paste-as-new">Paste as New</link> command
+              this and the ordinary
+              <link linkend="gimp-edit-paste-as-new">Paste as New</link> command
               is that it uses the selected buffer rather than the content
               of the global clipboard buffer.
             </para>
@@ -230,6 +254,7 @@
         </varlistentry>
       </variablelist>
     </sect4>
+
     <sect4 id="gimp-buffer-dialog-menu">
       <title>
         <phrase>Context menu</phrase>
@@ -242,7 +267,8 @@
         </title>
         <mediaobject>
           <imageobject>
-            <imagedata fileref="images/dialogs/buffers-context-menu.png" format="PNG"/>
+            <imagedata format="PNG"
+                       fileref="images/dialogs/buffers-context-menu.png"/>
           </imageobject>
         </mediaobject>
       </figure>

Modified: trunk/src/dialogs/channel-dialog.xml
==============================================================================
--- trunk/src/dialogs/channel-dialog.xml	(original)
+++ trunk/src/dialogs/channel-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -6,15 +6,6 @@
   2006-03-06 lexa: reviewed and made docbook compliant
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-channel-dialog">
-  <!--<sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-07</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Channels Dialog</phrase>
   </title>
@@ -76,7 +67,8 @@
     </title>
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/dialogs/wilber-channels-red.png" format="PNG"/>
+        <imagedata format="PNG"
+                   fileref="images/dialogs/wilber-channels-red.png"/>
       </imageobject>
       <caption>
         <para>Red channel</para>
@@ -84,7 +76,8 @@
     </mediaobject>
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/dialogs/wilber-channels-green.png" format="PNG"/>
+        <imagedata format="PNG"
+                   fileref="images/dialogs/wilber-channels-green.png"/>
       </imageobject>
       <caption>
         <para>Green channel</para>
@@ -92,7 +85,8 @@
     </mediaobject>
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/dialogs/wilber-channels-blue.png" format="PNG"/>
+        <imagedata format="PNG"
+                   fileref="images/dialogs/wilber-channels-blue.png"/>
       </imageobject>
       <caption>
         <para>Blue channel</para>
@@ -100,7 +94,8 @@
     </mediaobject>
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/dialogs/wilber-channels-alpha.png" format="PNG"/>
+        <imagedata format="PNG"
+                   fileref="images/dialogs/wilber-channels-alpha.png"/>
       </imageobject>
       <caption>
         <para>Alpha channel</para>
@@ -108,7 +103,8 @@
     </mediaobject>
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/dialogs/wilber-channels-combined.png" format="PNG"/>
+        <imagedata format="PNG"
+                   fileref="images/dialogs/wilber-channels-combined.png"/>
       </imageobject>
       <caption>
         <para><!-- All channels combined -->All Channels</para>
@@ -126,36 +122,56 @@
   </para>
   <sect3 id="gimp-channel-dialog-calling">
     <title>
-      <phrase>Calling the Dialog</phrase>
+      <phrase>Activating the Dialog</phrase>
     </title>
-    <para>The Channel dialog can be activated in two ways:</para>
+    <para>
+      The <quote>Channels</quote> dialog is a dockable dialog; see the
+      section <xref linkend="gimp-concepts-docks"/> for help on manipulating
+      it.
+    </para>
+    <para>
+      You can access it:
+    </para>
     <itemizedlist>
       <listitem>
         <para>
-          from the image-menu:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Channels</guimenuitem></menuchoice>
+          from an image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Channels</guimenuitem>
+          </menuchoice>;
         </para>
       </listitem>
       <listitem>
         <para>
-          from the tab menu of any other dialog-menu:
-          <menuchoice><guimenu>Add Tab</guimenu><guimenuitem>Channels</guimenuitem></menuchoice>.
-        </para>
-      </listitem>
-    </itemizedlist>
-    <itemizedlist>
-      <para>
-        If there is an open <quote>Channels</quote> dialog window (for
-        example, if the <quote>Channels</quote> tab has been
-        <link linkend="gimp-dockable-menu">detached</link>), you can raise the
-        dialog from the image-menu:
-      </para>
-      <listitem>
-        <para><menuchoice><guimenu>Windows</guimenu><guimenuitem>Channels</guimenuitem></menuchoice>.
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Channels</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
     </itemizedlist>
+    <para>
+      In the <guimenu>Windows</guimenu> menu, there is a list of
+      <link linkend="gimp-dockable-menu">detached layers</link> which exists
+      only if at least one dialog remains open. In this case, you can raise
+      the <quote>Layers</quote> dialog from the image-menu:
+      <menuchoice>
+        <guimenu>Windows</guimenu>
+        <guimenuitem>Channels</guimenuitem>
+      </menuchoice>.
+    </para>
   </sect3>
+
   <sect3 id="gimp-channel-dialog-using">
     <title>
       <phrase>Using the Channel dialog</phrase>
@@ -186,7 +202,8 @@
         <anchor id="channel-attributes"/>
         <mediaobject>
           <imageobject>
-            <imagedata fileref="images/dialogs/channel-list-entry.png" format="PNG"/>
+            <imagedata format="PNG"
+                       fileref="images/dialogs/channel-list-entry.png"/>
           </imageobject>
         </mediaobject>
         <varlistentry>
@@ -316,7 +333,8 @@
             <guiicon>
               <inlinemediaobject>
                 <imageobject>
-                  <imagedata fileref="images/dialogs/stock-edit-16.png" format="PNG"/>
+                  <imagedata format="PNG"
+                             fileref="images/dialogs/stock-edit-16.png"/>
                 </imageobject>
               </inlinemediaobject>
             </guiicon>
@@ -338,7 +356,8 @@
             <guiicon>
               <inlinemediaobject>
                 <imageobject>
-                  <imagedata fileref="images/dialogs/dialogs-icon-new.png" format="PNG"/>
+                  <imagedata format="PNG"
+                             fileref="images/dialogs/dialogs-icon-new.png"/>
                 </imageobject>
               </inlinemediaobject>
             </guiicon>
@@ -364,7 +383,8 @@
             <guiicon>
               <inlinemediaobject>
                 <imageobject>
-                  <imagedata fileref="images/dialogs/dialogs-icon-raise.png" format="PNG"/>
+                  <imagedata format="PNG"
+                             fileref="images/dialogs/dialogs-icon-raise.png"/>
                 </imageobject>
               </inlinemediaobject>
             </guiicon>
@@ -384,7 +404,8 @@
             <guiicon>
               <inlinemediaobject>
                 <imageobject>
-                  <imagedata fileref="images/dialogs/dialogs-icon-lower.png" format="PNG"/>
+                  <imagedata format="PNG"
+                             fileref="images/dialogs/dialogs-icon-lower.png"/>
                 </imageobject>
               </inlinemediaobject>
             </guiicon>
@@ -404,7 +425,8 @@
             <guiicon>
               <inlinemediaobject>
                 <imageobject>
-                  <imagedata fileref="images/dialogs/stock-duplicate-16.png" format="PNG"/>
+                  <imagedata format="PNG"
+                             fileref="images/dialogs/stock-duplicate-16.png"/>
                 </imageobject>
               </inlinemediaobject>
             </guiicon>
@@ -430,7 +452,8 @@
             <guiicon>
               <inlinemediaobject>
                 <imageobject>
-                  <imagedata fileref="images/dialogs/stock-selection-16.png" format="PNG"/>
+                  <imagedata format="PNG"
+                             fileref="images/dialogs/stock-selection-16.png"/>
                 </imageobject>
               </inlinemediaobject>
             </guiicon>
@@ -473,7 +496,8 @@
             <guiicon>
               <inlinemediaobject>
                 <imageobject>
-                  <imagedata fileref="images/dialogs/dialogs-icon-delete.png" format="PNG"/>
+                  <imagedata format="PNG"
+                             fileref="images/dialogs/dialogs-icon-delete.png"/>
                 </imageobject>
               </inlinemediaobject>
             </guiicon>

Modified: trunk/src/dialogs/channel-menu.xml
==============================================================================
--- trunk/src/dialogs/channel-menu.xml	(original)
+++ trunk/src/dialogs/channel-menu.xml	Sat Feb 28 07:45:49 2009
@@ -5,15 +5,6 @@
   2006-04-29 lexa: minor changes to docbook compliance
 -->
 <sect4 id="gimp-channel-menu">
-  <!--<sect4info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-07</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect4info>-->
   <title>
     <phrase>Channels Context Menu</phrase>
   </title>
@@ -27,7 +18,8 @@
     </title>
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/dialogs/channels-context-menu.png" format="PNG"/>
+        <imagedata format="PNG"
+                   fileref="images/dialogs/channels-context-menu.png"/>
       </imageobject>
     </mediaobject>
   </figure>

Modified: trunk/src/dialogs/channel-selection-mask.xml
==============================================================================
--- trunk/src/dialogs/channel-selection-mask.xml	(original)
+++ trunk/src/dialogs/channel-selection-mask.xml	Sat Feb 28 07:45:49 2009
@@ -6,15 +6,6 @@
   2006-02-25 romanofski fixed broken image references
 -->
 <sect3 id="dialogs-selection-masks">
-  <!--<sect3info>
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-02-27</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect3info>-->
   <title>
     <phrase>Selection masks</phrase>
   </title>
@@ -38,6 +29,7 @@
     <primary>Masks</primary>
     <secondary>Quick mask</secondary>
   </indexterm>
+
   <figure>
     <title>
       <phrase>A selection composed out of channels.</phrase>
@@ -65,6 +57,7 @@
     fill the selection or when you erase its content after isolating a subject
     from background.
   </para>
+
   <variablelist>
     <varlistentry>
       <term>Creating Selection Masks</term>
@@ -72,7 +65,10 @@
         <para>
           There are several ways to initialize a selection mask.  From the
           image window menu
-          <menuchoice><guimenu>Select</guimenu><guimenuitem>Save to Channel</guimenuitem></menuchoice>
+          <menuchoice>
+            <guimenu>Select</guimenu>
+            <guimenuitem>Save to Channel</guimenuitem>
+          </menuchoice>
           if there is an active selection.  From the image window
           the bottom-left button creates a <link linkend="gimp-qmask">Quick
             Mask</link>; the content will be initialized with the active

Modified: trunk/src/dialogs/color-dialog.xml
==============================================================================
--- trunk/src/dialogs/color-dialog.xml	(original)
+++ trunk/src/dialogs/color-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -11,15 +11,6 @@
   2006-03-29 lexa: added german translation an made docbook compliant
 -->
 <sect2 id="gimp-color-dialog">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-13</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>The <quote>FG/BG Color</quote> Dialog</phrase>
   </title>
@@ -49,7 +40,7 @@
   </para>
   <para>
     The dialog called from the FG/BG area in the toolbox is a bit different
-    compared to the one called from the toolbox or image menu. The two
+    compared to the one called from the image menu. The two
     dialogs are used in the same way except that in the dialog called from
     the toolbox the sliders are permanently visible instead of selected
     from the scale menu. I addition the dialog called from the toolbox
@@ -60,39 +51,62 @@
   </para>
   <sect3>
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the Dialog</phrase>
     </title>
     <para>
-      You can get to this dialog in various ways :
+      The <quote>Colors</quote> dialog is a dockable dialog; see the
+      section <xref linkend="gimp-concepts-docks"/> for help on manipulating
+      it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          from the toolbox-menu:
-          <menuchoice><guimenu>File</guimenu><guisubmenu>Dialogs</guisubmenu><guimenuitem>Colors</guimenuitem></menuchoice>
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          from the toolbox: click on the current Foreground or Background
-          color.
+          from an image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Colors</guimenuitem>
+          </menuchoice>;
         </para>
       </listitem>
       <listitem>
         <para>
-          from the image-menu:
-          <menuchoice><guimenu>Dialogs</guimenu><guimenuitem>Colors</guimenuitem></menuchoice>
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Colors</guimenuitem>
+          </menuchoice>,
         </para>
       </listitem>
       <listitem>
         <para>
-          from an other dialog-menu, by clicking on the
-          <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/dialogs/stock-menu-left-12.png" format="PNG"/></imageobject></inlinemediaobject></guiicon> and selecting
-          <menuchoice><guimenu>Add Tab</guimenu><guimenuitem>Colors</guimenuitem></menuchoice>
+          from the toolbox: click on the current Foreground or Background
+          color.
         </para>
       </listitem>
     </itemizedlist>
+    <para>
+      In the <guimenu>Windows</guimenu> menu, there is a list of
+      <link linkend="gimp-dockable-menu">detached layers</link> which exists
+      only if at least one dialog remains open. In this case, you can raise
+      the <quote>Layers</quote> dialog from the image-menu:
+      <menuchoice>
+        <guimenu>Windows</guimenu>
+        <guimenuitem>Colors</guimenuitem>
+      </menuchoice>.
+    </para>
   </sect3>
+
   <sect3>
     <title>
       <phrase>Using the <quote>FG/BG color</quote> dialog</phrase>
@@ -152,7 +166,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/color-triangle.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/color-triangle.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -181,7 +196,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/color-watercolor.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/color-watercolor.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -218,11 +234,12 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/color-palette.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/color-palette.png"/>
               </imageobject>
             </mediaobject>
           </figure>
-          <para><!--Changed 2008-02-03-->
+          <para>
             This color selector brings up a list of the colors of the current
             palette in the
             <link linkend="gimp-palette-dialog">Palettes dialog </link>.
@@ -282,7 +299,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/css-keywords.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/css-keywords.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -293,7 +311,8 @@
             leads to various <guilabel>Input Methods</guilabel> that allow
             you to use foreign characters, and to the possibility to
             <guilabel>Insert Unicode Control Characters</guilabel>. This is
-            a vast field, beyond this help. Please see www.unicode.org.
+            a vast field, beyond this help. Please see
+            <ulink url="http://www.unicode.org";>Unicode</ulink>.
           </para>
           <figure>
             <title>
@@ -301,7 +320,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/html_notation-menu.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/html_notation-menu.png"/>
               </imageobject>
             </mediaobject>
           </figure>

Modified: trunk/src/dialogs/device-status-dialog.xml
==============================================================================
--- trunk/src/dialogs/device-status-dialog.xml	(original)
+++ trunk/src/dialogs/device-status-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -7,15 +7,6 @@
   2006-07-05 created en;fr by j.h
 -->
 <sect2 id="gimp-device-status-dialog">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-07-05</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Device Status Dialog</phrase>
   </title>
@@ -50,26 +41,34 @@
     window, seems to have the same action as the <quote>Record device
     status now</quote> option in the Input Devices section in preferences.
   </para>
+
   <sect3>
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the Dialog</phrase>
     </title>
     <para>
       The device status dialog is a dockable dialog; see the section
       <xref linkend="gimp-concepts-docks"/>
-      for help on manipulating it. It can be activated in several ways:
+      for help on manipulating it. It can be activated in two ways:
     </para>
     <itemizedlist>
       <listitem>
         <para>
           From an image menuÂ:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Device Status</guimenuitem></menuchoice>.
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Device Status</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
         <para>
           From the Tab menu in any dialogÂ:
-          <menuchoice><guimenu>Add a Dock</guimenu><guimenuitem>Device Status</guimenuitem></menuchoice>
+          <menuchoice>
+            <guimenu>Add a Dock</guimenu>
+            <guimenuitem>Device Status</guimenuitem>
+          </menuchoice>
         </para>
       </listitem>
     </itemizedlist>

Modified: trunk/src/dialogs/dialogs-structure.xml
==============================================================================
--- trunk/src/dialogs/dialogs-structure.xml	(original)
+++ trunk/src/dialogs/dialogs-structure.xml	Sat Feb 28 07:45:49 2009
@@ -4,15 +4,6 @@
   2006-03-13 lexa: created new structure for dialogs
 -->
 <sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-dialogs-structure">
-<!--  <sect1info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-17</date>
-        <authorinitials>ude</authorinitials>
-      </revision>
-    </revhistory>
-  </sect1info>-->
   <title>
     <phrase>Image Structure Related Dialogs</phrase>
   </title>

Modified: trunk/src/dialogs/dialogs_introduction.xml
==============================================================================
--- trunk/src/dialogs/dialogs_introduction.xml	(original)
+++ trunk/src/dialogs/dialogs_introduction.xml	Sat Feb 28 07:45:49 2009
@@ -4,15 +4,6 @@
   2006-03-06 lexa: reviewed and made docbook compliant
 -->
 <sect1 id="gimp-dialogs-introduction">
-<!--  <sect1info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-03-06</date>
-        <authorinitials>lexa</authorinitials>
-      </revision>
-    </revhistory>
-  </sect1info>-->
   <title>
     <phrase>Dialog Introduction</phrase>
   </title>

Modified: trunk/src/dialogs/document-dialog.xml
==============================================================================
--- trunk/src/dialogs/document-dialog.xml	(original)
+++ trunk/src/dialogs/document-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -9,15 +9,6 @@
   2006-02-29 Added Activate Dialog en;fr by j.h
 -->
 <sect2 id="gimp-document-dialog">
-<!--  <sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2007-09-03</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Document History Dialog</phrase>
   </title>
@@ -45,32 +36,56 @@
   </para>
   <sect3>
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the Dialog</phrase>
     </title>
     <para>
-      You can access to this dialog in different ways:
+      The <quote>History</quote> dialog is a dockable dialog; see the
+      section <xref linkend="gimp-concepts-docks"/> for help on manipulating
+      it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          From the toolbox-menu and the image Menu bar:
-          <menuchoice><guimenu>File</guimenu><guisubmenu>Open Recent</guisubmenu><guimenuitem>Document History</guimenuitem></menuchoice>
+          from an image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Document History</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
         <para>
-          From the image Menu-bar:
-          <menuchoice><guimenu>Dialogs</guimenu><guimenuitem>Document History</guimenuitem></menuchoice>
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Channels</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
         <para>
-          Through the
-          <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>H</keycap></keycombo> key shortcut.
+          From the image Menu bar through:
+          <menuchoice>
+            <guimenu>File</guimenu>
+            <guisubmenu>Open Recent</guisubmenu>
+            <guimenuitem>Document History</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
     </itemizedlist>
   </sect3>
+
   <sect3>
     <title>
       <phrase>Options</phrase>
@@ -80,9 +95,10 @@
     </para>
     <para>
       The <emphasis>Open the selected entry</emphasis>
-      button allows you to open the image you have selected. With "Shift" key
-      pressed, it raises an image hidden behind others. With "Ctrl" key
-      pressed, it opens the Open Image dialog.
+      button allows you to open the image you have selected. With the
+      <keycap>Shift</keycap> key pressed, it raises an image hidden behind
+      others. With the <keycap>Ctrl</keycap> key pressed, it opens the Open Image
+      dialog.
     </para>
     <para>
       The <emphasis>Remove the selected entry</emphasis>
@@ -90,15 +106,15 @@
       is removed from the recently open images list also. But the image itself
       is not deleted.
     </para>
-    <para><!--TODO v2.4 es;it-->
+    <para>
       The <emphasis>Clear the entire file history</emphasis> : all the files
       will be removed from the history.
     </para>
     <para>
       The <emphasis>Recreate Preview</emphasis>
-      button updates preview in case of change. With "Shift" key pressed, it
-      acts on all previews. With "Ctrl" key pressed, previews that can't be
-      found out are deleted.
+      button updates preview in case of change. With <keycap>Shift</keycap>
+      key pressed, it acts on all previews. With <keycap>Ctrl</keycap> key
+      pressed, previews that can't be found out are deleted.
     </para>
   </sect3>
 </sect2>

Modified: trunk/src/dialogs/edit-template-dialog.xml
==============================================================================
--- trunk/src/dialogs/edit-template-dialog.xml	(original)
+++ trunk/src/dialogs/edit-template-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -10,15 +10,6 @@
   2005-11-28 replaced informalfigures by figures by lexa
 -->
 <sect3 id="edit-template-dialog">
-<!--  <sect3info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-15</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect3info>-->
   <title>
     <phrase>Edit Template</phrase>
   </title>
@@ -29,6 +20,7 @@
   <indexterm>
     <primary>Edit Template</primary>
   </indexterm>
+
   <figure>
     <title>
       <phrase>The Edit Template dialog</phrase>
@@ -39,6 +31,7 @@
       </imageobject>
     </mediaobject>
   </figure>
+
   <para>
     The dialog allows you to set the specifications of the selected template.
   </para>
@@ -47,6 +40,7 @@
     <guibutton>Edit Template</guibutton> button in the
     <link linkend="gimp-template-dialog">Templates</link> dialog.
   </para>
+
   <variablelist>
     <title>
       <phrase>Options</phrase>
@@ -104,6 +98,7 @@
       </listitem>
     </varlistentry>
   </variablelist>
+
   <variablelist>
     <title>
       <phrase>Advanced Options</phrase>

Modified: trunk/src/dialogs/error-console.xml
==============================================================================
--- trunk/src/dialogs/error-console.xml	(original)
+++ trunk/src/dialogs/error-console.xml	Sat Feb 28 07:45:49 2009
@@ -8,15 +8,6 @@
   2006-07-15 created en;fr by j.h
 -->
 <sect2 id="gimp-errors-dialog">
-  <!--<sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-16</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Error Console</phrase>
   </title>
@@ -31,26 +22,46 @@
   </para>
   <sect3>
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the Dialog</phrase>
     </title>
     <para>
-      You can access to this dialog in different ways:
+      The <quote>Error Console</quote> dialog is a dockable dialog; see the
+      section <xref linkend="gimp-concepts-docks"/> for help on manipulating
+      it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          From the image menu:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Error Console</guimenuitem></menuchoice>.
+          from an image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Error Console</guimenuitem>
+          </menuchoice>;
         </para>
       </listitem>
       <listitem>
         <para>
-          Or from the Tab menu in any dialogÂ:
-          <menuchoice><guimenu>Add a dock</guimenu><guimenuitem>Error Console</guimenuitem></menuchoice>.
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Error Console</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
     </itemizedlist>
   </sect3>
+
   <sect3>
     <title>
       <phrase>

Modified: trunk/src/dialogs/export-file-dialog.xml
==============================================================================
--- trunk/src/dialogs/export-file-dialog.xml	(original)
+++ trunk/src/dialogs/export-file-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -9,15 +9,6 @@
   2006-12-26 Created by j.h
 -->
 <sect2 id="gimp-export-dialog">
-  <!--<sect2info>
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-16</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Export File</phrase>
   </title>
@@ -48,8 +39,6 @@
           </title>
           <mediaobject>
             <imageobject>
-              <!--TODO it: check: image replaced-->
-              <!-- was: images/dialogs/dialogs-file-export-png.png -->
               <imagedata fileref="images/using/save-png-dialog.png" format="PNG"/>
             </imageobject>
           </mediaobject>
@@ -80,8 +69,8 @@
           </title>
           <mediaobject>
             <imageobject>
-              <!--TODO it: check: image -->
-              <imagedata fileref="images/using/save-jpeg-dialog.png" format="JPG"/>
+              <imagedata fileref="images/using/save-jpeg-dialog.png"
+format="JPG"/>
             </imageobject>
           </mediaobject>
         </figure>
@@ -112,7 +101,8 @@
           </title>
           <mediaobject>
             <imageobject>
-              <imagedata fileref="images/dialogs/export-file-mng.png" format="JPG"/>
+              <imagedata format="JPG"
+                         fileref="images/dialogs/export-file-mng.png"/>
             </imageobject>
           </mediaobject>
         </figure>
@@ -141,7 +131,8 @@
           </title>
           <mediaobject>
             <imageobject>
-              <imagedata fileref="images/dialogs/export-file-gif.png" format="PNG"/>
+              <imagedata format="PNG"
+                         fileref="images/dialogs/export-file-gif.png"/>
             </imageobject>
           </mediaobject>
         </figure>

Modified: trunk/src/dialogs/fonts-dialog.xml
==============================================================================
--- trunk/src/dialogs/fonts-dialog.xml	(original)
+++ trunk/src/dialogs/fonts-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -6,15 +6,6 @@
   2007-09-03 j.h : reviewed en;fr for v2.4. No change.
 -->
 <sect2 id="gimp-font-dialog">
-  <!--<sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-03-02</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Fonts Dialog</phrase>
   </title>
@@ -36,44 +27,74 @@
       </imageobject>
     </mediaobject>
   </figure>
+
   <para>
     The Fonts dialog is used for selecting fonts for the
     <link linkend="gimp-tool-text">Text tool</link>.
     It also allows you to refresh the list of available fonts, if you add
     new ones to your system while GIMP is running.
   </para>
+
   <sect3 id="gimp-font-dialog-activate">
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the Dialog</phrase>
     </title>
     <para>
-      The Fonts dialog is a dockable dialog; see the section on
-      <link linkend="gimp-concepts-docks">Dialogs and Docking</link>
-      for help on manipulating it. It can be activated in several ways:
+      The <quote>Fonts</quote> dialog is a dockable dialog; see the section
+      <xref linkend="gimp-concepts-docks"/>
+      for help on manipulating it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          From the image menu bar:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Fonts</guimenuitem></menuchoice>.
+          from an image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Fonts</guimenuitem>
+          </menuchoice>;
         </para>
       </listitem>
       <listitem>
         <para>
-          From the Tool Options for the Text tool. If you click on the
-					<quote>Font</quote> button, a Font-selector pops up. In the lower
-					right corner is a button that, if pressed, brings up the
-					<quote>Fonts</quote> dialog.
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Fonts</guimenuitem>
+          </menuchoice>,
         </para>
       </listitem>
       <listitem>
         <para>
-          From the Tab menu in any dockable dialog:
-          <menuchoice><guimenu>Add Tab</guimenu><guimenuitem>Fonts</guimenuitem></menuchoice>.
+          from the Tool Options for the Text tool. If you click on the
+          <quote>Font</quote> button, a Font-selector pops up. In the lower
+          right corner is a button that, if pressed, brings up the
+          <quote>Fonts</quote> dialog.
         </para>
       </listitem>
     </itemizedlist>
+    <para>
+      In the <guimenu>Windows</guimenu> menu, there is a list of
+      <link linkend="gimp-dockable-menu">detached layers</link> which exists
+      only if at least one dialog remains open. In this case, you can raise
+      the <quote>Layers</quote> dialog from the image-menu:
+      <menuchoice>
+        <guimenu>Windows</guimenu>
+        <guimenuitem>Fonts</guimenuitem>
+      </menuchoice>.
+    </para>
   </sect3>
+
   <sect3 id="gimp-font-dialog-using">
     <title>
       <phrase>Using the Fonts dialog</phrase>
@@ -92,11 +113,11 @@
           <figure>
             <title>
               <phrase>The Fonts dialog</phrase>
-              <phrase>ÅriftÅ dialogas</phrase>
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/fonts-grid-dialog.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/fonts-grid-dialog.png"/>
               </imageobject>
               <caption>
                 <para>Dialog in Grid View</para>
@@ -104,7 +125,8 @@
             </mediaobject>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/fonts-dialog.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/fonts-dialog.png"/>
               </imageobject>
               <caption>
                 <para>Dialog in List View</para>
@@ -130,14 +152,14 @@
             font list to be rescanned. This may be useful if you add new fonts
             while GIMP is running, and want to make them accessible for the
             Text tool. You can also cause the font list to be rescanned by
-            right-clicking in the font display, and selecting "Rescan Font
-            List" from the menu that pops up (it is actually the only option
-            in the menu).
+            right-clicking in the font display, and selecting <quote>Rescan
+            Font List</quote> from the menu that pops up (it is actually the
+            only option in the menu).
           </para>
           <tip>
             <para>
               You can change the size of the font previews in the dialog using
-              the "Preview Size" submenu of the dialog's Tab menu.
+              the <quote>Preview Size</quote> submenu of the dialog's Tab menu.
             </para>
           </tip>
         </listitem>

Modified: trunk/src/dialogs/gradient-dialog.xml
==============================================================================
--- trunk/src/dialogs/gradient-dialog.xml	(original)
+++ trunk/src/dialogs/gradient-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -9,15 +9,6 @@
   2006-04-29 lexa: made file docbook compliant
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-gradient-dialog">
-  <!--<sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-15</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Gradients Dialog</phrase>
   </title>
@@ -80,29 +71,47 @@
   </itemizedlist>
   <sect3 id="gimp-gradient-dialog-activate">
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the Dialog</phrase>
     </title>
     <para>
-      The Gradients dialog is a dockable dialog; see the section on <link linkend="gimp-concepts-docks">Dialogs and Docking</link> for help on
-      manipulating it.  It can be activated in several ways:
+      The <quote>Gradients</quote> dialog is a dockable dialog; see the
+      section <xref linkend="gimp-concepts-docks"/>
+      for help on manipulating it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          From the Toolbox, by clicking on the current gradient in the
-          Brush/Pattern/Gradient area.
+          from an image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Gradients</guimenuitem>
+          </menuchoice>;
         </para>
       </listitem>
       <listitem>
         <para>
-          From an image menu:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Gradients</guimenuitem></menuchoice>.
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Gradients</guimenuitem>
+          </menuchoice>,
         </para>
       </listitem>
       <listitem>
         <para>
-          From the Tab menu in any dockable dialog:
-          <menuchoice><guimenu>Add Tab</guimenu><guimenuitem>Gradients</guimenuitem></menuchoice>.
+          from the Toolbox, by clicking on the current gradient in the
+          Brush/Pattern/Gradient area,
         </para>
       </listitem>
       <listitem>
@@ -111,7 +120,18 @@
         </para>
       </listitem>
     </itemizedlist>
+    <para>
+      In the <guimenu>Windows</guimenu> menu, there is a list of
+      <link linkend="gimp-dockable-menu">detached layers</link> which exists
+      only if at least one dialog remains open. In this case, you can raise
+      the <quote>Layers</quote> dialog from the image-menu:
+      <menuchoice>
+        <guimenu>Windows</guimenu>
+        <guimenuitem>Gradients</guimenuitem>
+      </menuchoice>.
+    </para>
   </sect3>
+
   <sect3 id="gimp-gradient-dialog-using">
     <title>
       <phrase>Using the Gradients dialog</phrase>

Modified: trunk/src/dialogs/gradient-editor-dialog.xml
==============================================================================
--- trunk/src/dialogs/gradient-editor-dialog.xml	(original)
+++ trunk/src/dialogs/gradient-editor-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -10,15 +10,6 @@
   2005-11-28 replaced informalfigures by figures by lexa
 -->
 <sect3 id="gimp-gradient-editor-dialog">
-  <!--<sect3info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2007-09-27</date>
-        <authorinitials>ude</authorinitials>
-      </revision>
-    </revhistory>
-  </sect3info>-->
   <title>
     <phrase>The Gradient Editor</phrase>
   </title>
@@ -33,7 +24,8 @@
     </title>
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/dialogs/gradient-editor-dialog.png" format="PNG"/>
+        <imagedata format="PNG"
+                   fileref="images/dialogs/gradient-editor-dialog.png"/>
       </imageobject>
     </mediaobject>
   </figure>
@@ -50,6 +42,7 @@
     the left and right edges of each segment, and with several options for the
     shape of the transition from left to right.
   </para>
+
   <sect4 id="gimp-gradient-editor-dialog-activate">
     <title>
       <phrase>How to Activate the Gradient Editor</phrase>
@@ -77,12 +70,20 @@
       </listitem>
       <listitem>
         <para>
-          From the Gradient Menu you get by clicking on the small triangle
-          representing the Tab Menu in the Gradient Dialog.
+          From the Gradient Menu you get by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon>
+          in the Gradient Dialog.
         </para>
       </listitem>
     </itemizedlist>
   </sect4>
+
   <sect4 id="gimp-gradient-editor-dialog-using">
     <title>
       <phrase>Display</phrase>
@@ -170,7 +171,7 @@
       <varlistentry>
         <term>Feedback Area</term>
         <listitem>
-          <para><!--TODO es: v2.4-->
+          <para>
             Below, a color swatch shows the color pointed by the mouse
             cursor. Informations about this color and helpful hints or
             feedback messages may appear here.
@@ -242,6 +243,7 @@
       </varlistentry>
     </variablelist>
   </sect4>
+
   <sect4 id="gimp-gradient-editor-dialog-menu">
     <title>
       <phrase>The Gradient Editor pop-up Menu</phrase>
@@ -279,11 +281,12 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/gradient-editor-colortype-submenu.png" format="PNG"/>
+                <imagedata format="PNG"
+                fileref="images/dialogs/gradient-editor-colortype-submenu.png"/>
               </imageobject>
             </mediaobject>
           </figure>
-          <para><!--changed 2007-09-27-->
+          <para>
             This submenu allows you to select the endpoint color from the
             toolbox foreground and background colors.
             Whenever you change the foreground or background color, this
@@ -320,7 +323,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/gradient-editor-colorfrom.png" format="PNG"/>
+                <imagedata format="PNG"
+                      fileref="images/dialogs/gradient-editor-colorfrom.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -352,7 +356,7 @@
             <varlistentry>
               <term>FG/BG color</term>
               <listitem>
-                <para><!--changed 2007-09-27-->
+                <para>
                   This choice causes GIMP's current foreground or background
                   color, as shown in the Toolbox, to be assigned to the
                   endpoint. Note that changing foreground or background color
@@ -364,8 +368,9 @@
               <term>RGBA slots</term>
               <listitem>
                 <para>
-                  At the bottom of the menu are 10 "memory slots". You can
-                  assign colors to them using the "Save" menu option described
+                  At the bottom of the menu are
+                  10 <quote>memory slots</quote>. You can assign colors to
+                  them using the <quote>Save</quote> menu option described
                   below. If you choose one of the slots, the color in it will
                   be assigned to the endpoint.
                 </para>
@@ -381,7 +386,8 @@
           <anchor id="gimp-gradient-editor-right-save"/>
           <para>
             These options cause the color of the endpoint in question to be
-            assigned to the "memory slot" selected from the submenu.
+            assigned to the <quote>memory slot</quote> selected from the
+            submenu.
           </para>
         </listitem>
       </varlistentry>
@@ -402,7 +408,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/gradient-editor-blend.png" format="PNG"/>
+                <imagedata format="PNG"
+                       fileref="images/dialogs/gradient-editor-blend.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -470,7 +477,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/gradient-editor-color.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/gradient-editor-color.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -600,6 +608,7 @@
       </para>
     </caution>
   </sect4>
+
   <sect4>
     <title>
       <phrase>Using example for the Gradient Editor</phrase>
@@ -629,7 +638,8 @@
           </title>
           <mediaobject>
             <imageobject>
-              <imagedata fileref="images/dialogs/examples/new-gradient-1.png" format="PNG"/>
+              <imagedata format="PNG"
+                        fileref="images/dialogs/examples/new-gradient-1.png"/>
             </imageobject>
           </mediaobject>
         </figure>
@@ -646,7 +656,8 @@
           </title>
           <mediaobject>
             <imageobject>
-              <imagedata fileref="images/dialogs/examples/new-gradient-2.png" format="PNG"/>
+              <imagedata format="PNG"
+                         fileref="images/dialogs/examples/new-gradient-2.png"/>
             </imageobject>
             <caption>
               <para>
@@ -655,9 +666,6 @@
                 <keycap>Shift</keycap> key, you can select several contiguous
                 segments.
               </para>
-              <para>
-                ÐÐÐÐÑÐ ÑÐÐÐÐÐÑ ÐÑÐÐÐÐÐ ÑÑÑÐÑÐÐ ÑÑÐÑÐÐÐÑÐÐÐÐÐÐ.
-              </para>
             </caption>
           </mediaobject>
         </figure>
@@ -675,7 +683,8 @@
           </title>
           <mediaobject>
             <imageobject>
-              <imagedata fileref="images/dialogs/examples/new-gradient-3.png" format="PNG"/>
+              <imagedata format="PNG"
+                         fileref="images/dialogs/examples/new-gradient-3.png"/>
             </imageobject>
             <caption>
               <para>

Modified: trunk/src/dialogs/histogram-dialog.xml
==============================================================================
--- trunk/src/dialogs/histogram-dialog.xml	(original)
+++ trunk/src/dialogs/histogram-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -9,15 +9,6 @@
   2005-11-29 replaced informalfigures by figures by lexa
 -->
 <sect2 id="gimp-histogram-dialog">
-  <!--<sect2info>
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-13</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Histogram dialog</phrase>
   </title>
@@ -34,7 +25,8 @@
     </title>
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/dialogs/histogram-basic-dialog.png" format="PNG"/>
+        <imagedata format="PNG"
+                   fileref="images/dialogs/histogram-basic-dialog.png"/>
       </imageobject>
     </mediaobject>
   </figure>
@@ -50,28 +42,66 @@
   </para>
   <sect3>
     <title>
-      <phrase>Dialog call</phrase>
+      <phrase>Activating the dialog</phrase>
     </title>
     <para>
-      This is a dockable dialog; see the section on
-      <link linkend="gimp-concepts-docks">Dialogs and Docking</link>
-      for help on manipulating it. It can be activated in two ways:
+      The <quote>Histogram</quote> dialog is a dockable dialog; see the section
+      <xref linkend="gimp-concepts-docks"/>
+      for help on manipulating it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          From the image menu:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Histogram</guimenuitem></menuchoice>.
+          from the image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Histogram</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
         <para>
-          From the image menu:
-          <menuchoice><guimenu>Colors</guimenu><guisubmenu>Info</guisubmenu><guimenuitem>Histogram</guimenuitem></menuchoice>.
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Histogram</guimenuitem>
+          </menuchoice>,
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          from the image menu:
+          <menuchoice>
+            <guimenu>Colors</guimenu>
+            <guisubmenu>Info</guisubmenu>
+            <guimenuitem>Histogram</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
     </itemizedlist>
+    <para>
+      In the <guimenu>Windows</guimenu> menu, there is a list of
+      <link linkend="gimp-dockable-menu">detached layers</link> which exists
+      only if at least one dialog remains open. In this case, you can raise
+      the <quote>Layers</quote> dialog from the image-menu:
+      <menuchoice>
+        <guimenu>Windows</guimenu>
+        <guimenuitem>Histogram</guimenuitem>
+      </menuchoice>.
+    </para>
   </sect3>
+
   <sect3>
     <title>
       <phrase>About Histograms</phrase>
@@ -99,6 +129,7 @@
       <xref linkend="gimp-concepts-image-types"/>.
     </para>
   </sect3>
+
   <sect3>
     <title>
       <phrase>Using the Histogram dialog</phrase>
@@ -118,7 +149,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/histogram-drop-down-menu.png" format="PNG"/>
+                <imagedata format="PNG"
+                         fileref="images/dialogs/histogram-drop-down-menu.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -138,10 +170,10 @@
                   image, they are taken from the Value pseudochannel.
                 </para>
                 <para>
-                  For an indexed image, the "Value" channel actually shows the
-                  distribution of frequencies for each colormap index: thus,
-                  it is a "pseudocolor" histogram rather than a true color
-                  histogram.
+                  For an indexed image, the <quote>Value</quote> channel
+                  actually shows the distribution of frequencies for each
+                  colormap index: thus, it is a <quote>pseudocolor</quote>
+                  histogram rather than a true color histogram.
                 </para>
               </listitem>
             </varlistentry>
@@ -177,7 +209,8 @@
                   </title>
                   <mediaobject>
                     <imageobject>
-                      <imagedata fileref="images/dialogs/histogram-rgb.png" format="PNG"/>
+                      <imagedata format="PNG"
+                                 fileref="images/dialogs/histogram-rgb.png" />
                     </imageobject>
                   </mediaobject>
                 </figure>
@@ -202,7 +235,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/histogram-log.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/histogram-log.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -225,7 +259,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/histogram-range.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/histogram-range.png"/>
               </imageobject>
             </mediaobject>
           </figure>

Modified: trunk/src/dialogs/images-dialog.xml
==============================================================================
--- trunk/src/dialogs/images-dialog.xml	(original)
+++ trunk/src/dialogs/images-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -10,15 +10,6 @@
   2005-11-29 replaced informalfigures by figures by lexa
 -->
 <sect2 id="gimp-image-dialog">
-  <!--<sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-15</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Images Dialog</phrase>
   </title>
@@ -45,38 +36,68 @@
     many overlapping images on your screen: thus, you can raise the wanted
     image to foreground.
   </para>
+
   <sect3>
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the dialog</phrase>
     </title>
     <para>
-      The Images dialog is a dockable dialog; see the section on <link linkend="gimp-concepts-docks">Dialogs and Docking</link> for help on
-      manipulating it.  It can be activated in several ways:
+      The <quote>Images</quote> dialog is a dockable dialog; see the section
+      <xref linkend="gimp-concepts-docks"/>
+      for help on manipulating it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          From an image menu:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Images</guimenuitem></menuchoice>.
+          from the image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Images</guimenuitem>
+          </menuchoice>;
         </para>
       </listitem>
       <listitem>
         <para>
-          From the Tab menu in any dockable dialog:
-          <menuchoice><guimenu>Add Tab</guimenu><guimenuitem>Images</guimenuitem></menuchoice>.
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Histogram</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
     </itemizedlist>
+    <para>
+      In the <guimenu>Windows</guimenu> menu, there is a list of
+      <link linkend="gimp-dockable-menu">detached layers</link> which exists
+      only if at least one dialog remains open. In this case, you can raise
+      the <quote>Layers</quote> dialog from the image-menu:
+      <menuchoice>
+        <guimenu>Windows</guimenu>
+        <guimenuitem>Images</guimenuitem>
+      </menuchoice>.
+    </para>
   </sect3>
+
   <sect3>
     <title>
       <phrase>Using the Images dialog</phrase>
     </title>
-    <para><!--TODO es;it-->
+    <para>
       At the top of the dialog, a drop-list of open images appears if the
       <quote>Show Image Selection</quote> option is checked in the Tab Menu.
     </para>
-    <para><!--Changed 2007-09-16-->
+    <para>
       At center, open images appear, as a list or a grid, according to the
       selected mode. The current image is highlighted in list mode, outlined
       in grid mode. With a double click on an image name,  you raise this
@@ -110,7 +131,7 @@
       <varlistentry>
         <term>Raise this image displays</term>
         <listitem>
-          <para><!--TODO es;it-->
+          <para>
             The selected image appears at the foreground of your screen. If
             this image has another view, this view also is raised but
             remains behind the original. The same option in the pop-up menu,

Modified: trunk/src/dialogs/indexed-palette-dialog.xml
==============================================================================
--- trunk/src/dialogs/indexed-palette-dialog.xml	(original)
+++ trunk/src/dialogs/indexed-palette-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -9,15 +9,6 @@
   2005-11-29 replaced informalfigures by figures by lexa
 -->
 <sect2 id="gimp-indexed-palette-dialog">
-  <!--<sect2info>
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2006-09-29</date>
-        <authorinitials>scb</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Colormap Dialog</phrase>
   </title>
@@ -45,7 +36,7 @@
       </imageobject>
     </mediaobject>
   </figure>
-  <para><!--TODO v2.6 es;it;lt;no;ru-->
+  <para>
     The Colormap (Indexed Palette is a better name) dialog allows you to edit
     the colormap of an indexed image. (If the mode of the active image is RGB
     or Grayscale instead of Indexed, the dialog is empty and unusable.) This
@@ -55,17 +46,56 @@
   </para>
   <sect3 id="gimp-indexed-palette-dialog-activate">
     <title>
-      <phrase>Activate dialog</phrase>
+      <phrase>Activating the dialog</phrase>
     </title>
+    <para>
+      The <quote>Colormap</quote> dialog is a dockable dialog; see the section
+      <xref linkend="gimp-concepts-docks"/>
+      for help on manipulating it.
+    </para>
+    <para>
+      You can access it:
+    </para>
     <itemizedlist>
       <listitem>
         <para>
-          From the image menu:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Colormap</guimenuitem></menuchoice>
+          from the image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Colormap</guimenuitem>
+          </menuchoice>;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Colormap</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
     </itemizedlist>
+    <para>
+      In the <guimenu>Windows</guimenu> menu, there is a list of
+      <link linkend="gimp-dockable-menu">detached layers</link> which exists
+      only if at least one dialog remains open. In this case, you can raise
+      the <quote>Layers</quote> dialog from the image-menu:
+      <menuchoice>
+        <guimenu>Windows</guimenu>
+        <guimenuitem>Colormap</guimenuitem>
+      </menuchoice>.
+    </para>
   </sect3>
+
   <sect3 id="gimp-indexed-palette-dialog-colormaps">
     <title>
       <phrase>Colormaps and Indexed Images</phrase>
@@ -130,7 +160,7 @@
       <varlistentry>
         <term>Ctrl-click on a color entry</term>
         <listitem>
-          <para><!-- FIXME: cs -->
+          <para>
             This sets GIMP's background color to the color you Ctrl-click on,
             as shown in the Toolbox color area.
           </para>
@@ -200,7 +230,10 @@
         If you make a mistake, you can undo it by focusing the pointer in
         the image whose colormap you have changed, and then pressing
         <keycap>Ctrl-Z</keycap> or choosing
-        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem></menuchoice>
+        <menuchoice>
+          <guimenu>Edit</guimenu>
+          <guimenuitem>Undo</guimenuitem>
+        </menuchoice>
         in the image menu.
       </para>
     </tip>
@@ -210,8 +243,9 @@
         colormap for an indexed image. The color tools, such as
         Brightness/Contrast, Hue/Saturation, etc, do not operate on indexed
         images. There are a few plug-ins that do so, including the
-        "Normalize", "Color Enhance", and "Stretch Contrast" operations, and
-        it is possible to create others as well.
+        <quote>Normalize</quote>, <quote>VColor Enhance</quote>, and
+        <quote>Stretch Contrast</quote> operations, and it is possible to
+        create others as well.
       </para>
     </note>
     <note>
@@ -235,7 +269,8 @@
       </title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/dialogs/colormap-contextmenu.png" format="PNG"/>
+          <imagedata format="PNG"
+                     fileref="images/dialogs/colormap-contextmenu.png"/>
         </imageobject>
       </mediaobject>
     </figure>

Modified: trunk/src/dialogs/layer-dialog.xml
==============================================================================
--- trunk/src/dialogs/layer-dialog.xml	(original)
+++ trunk/src/dialogs/layer-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -60,51 +60,62 @@
   </figure>
 
   <sect3 id="gimp-layer-dialog-activate">
-    <title>Activate Dialog</title>
-    <para>The Layer dialog can be called in various ways:</para>
+    <title>
+      <phrase>Activating the dialog</phrase>
+    </title>
+    <para>
+      The <quote>Layers</quote> dialog is a dockable dialog; see the section
+      <xref linkend="gimp-concepts-docks"/>
+      for help on manipulating it.
+    </para>
+    <para>
+      You can access it:
+    </para>
     <itemizedlist>
       <listitem>
         <para>
-          from the image-menu:
+          from the image menu:
           <menuchoice>
             <guimenu>Windows</guimenu>
             <guisubmenu>Dockable Dialogs</guisubmenu>
             <guimenuitem>Layers</guimenuitem>
-          </menuchoice>
+          </menuchoice>;
         </para>
       </listitem>
       <listitem>
         <para>
-          from the tab menu in a dialog:
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
           <menuchoice>
             <guimenu>Add Tab</guimenu>
             <guimenuitem>Layers</guimenuitem>
-          </menuchoice>
+          </menuchoice>,
         </para>
       </listitem>
       <listitem>
         <para>
           from the (default) shortcut:
-          <keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo>
-        </para>
-      </listitem>
-    </itemizedlist>
-    <itemizedlist>
-      <para>
-        If there is an open <quote>Layers</quote> dialog window (for example,
-        if the <quote>Layers</quote> tab has been
-        <link linkend="gimp-dockable-menu">detached</link>), you can raise the
-        dialog from the image-menu:
-      </para>
-      <listitem>
-        <para>
-          <menuchoice>
-            <guimenu>Windows</guimenu>
-            <guimenuitem>Layers</guimenuitem>
-          </menuchoice>.
+          <keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo>.
         </para>
       </listitem>
     </itemizedlist>
+
+    <para>
+      In the <guimenu>Windows</guimenu> menu, there is a list of
+      <link linkend="gimp-dockable-menu">detached layers</link> which exists
+      only if at least one dialog remains open. In this case, you can raise
+      the <quote>Layers</quote> dialog from the image-menu:
+      <menuchoice>
+        <guimenu>Windows</guimenu>
+        <guimenuitem>Layers</guimenuitem>
+      </menuchoice>.
+    </para>
   </sect3>
 
   <sect3 id="gimp-layer-dialog-using">

Modified: trunk/src/dialogs/layer-mask.xml
==============================================================================
--- trunk/src/dialogs/layer-mask.xml	(original)
+++ trunk/src/dialogs/layer-mask.xml	Sat Feb 28 07:45:49 2009
@@ -7,15 +7,6 @@
   2006-03-09 lexa: reviewed and made docbook compliant
 -->
 <sect3 id="gimp-layer-mask">
-  <!--<sect3info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2007-09-30</date>
-        <authorinitials>lexa</authorinitials>
-      </revision>
-    </revhistory>
-  </sect3info>-->
   <title>
     <phrase>Layer masks</phrase>
   </title>
@@ -26,6 +17,7 @@
     <primary>Masks</primary>
     <secondary>Layer mask</secondary>
   </indexterm>
+
   <figure>
     <title>
       <phrase><quote>Add mask</quote> dialog</phrase>
@@ -36,6 +28,7 @@
       </imageobject>
     </mediaobject>
   </figure>
+
   <variablelist>
     <varlistentry>
       <term>Overview</term>
@@ -59,7 +52,8 @@
         </para>
         <itemizedlist>
           <listitem>
-            <para><!--changed 070615--><guilabel>White (full opacity)</guilabel>: the mask is white
+            <para><guilabel>White (full opacity)</guilabel>:
+              the mask is white
               in the Layer Dialog. So, all pixels of the layer are visible
               in the image window since painting the mask with white makes
               layer pixels fully visible. You will paint with black to make
@@ -67,7 +61,7 @@
             </para>
           </listitem>
           <listitem>
-            <para><!--changed 070615--><guilabel>Black (full transparency)</guilabel>: the mask is
+            <para><guilabel>Black (full transparency)</guilabel>: the mask is
               black in the Layer Dialog. So, the layer is fully transparent
               since painting the mask with black makes layer pixels
               transparent. Painting with white will remove the mask and make
@@ -109,7 +103,7 @@
             </para>
           </listitem>
         </itemizedlist>
-        <para><!--TODO it;lt-->
+        <para>
           When the mask is created it appears as a thumbnail right to the
           layer thumbnail. By clicking alternatively on the layer and mask
           thumbnail you can enable one or other. The active item has a white
@@ -117,7 +111,6 @@
           important point. Always keep the Layers Dialog prominently when
           working with masks, because you can't see, looking at the canvas,
           which of the layer or the mask is active.
-          <!--TODO check: make the last sentence a tip?! (cf. 'de')-->
         </para>
         <para>
           Pressing <keycap>Alt</keycap> (or
@@ -142,7 +135,8 @@
           </title>
           <mediaobject>
             <imageobject>
-              <imagedata fileref="images/dialogs/examples/layer-mask-1.png" format="PNG"/>
+              <imagedata format="PNG"
+                         fileref="images/dialogs/examples/layer-mask-1.png" />
             </imageobject>
             <caption>
               <para>
@@ -160,7 +154,8 @@
           </title>
           <mediaobject>
             <imageobject>
-              <imagedata fileref="images/dialogs/examples/layer-mask-2.png" format="PNG"/>
+              <imagedata format="PNG"
+                         fileref="images/dialogs/examples/layer-mask-2.png" />
             </imageobject>
             <caption>
               <para>

Modified: trunk/src/dialogs/navigation-dialog.xml
==============================================================================
--- trunk/src/dialogs/navigation-dialog.xml	(original)
+++ trunk/src/dialogs/navigation-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -8,15 +8,6 @@
   2006-03-11 lexa: made file docbook compliant
 -->
 <sect2 id="gimp-navigation-dialog">
-  <!--<sect2info>
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-13</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Navigation Dialog</phrase>
   </title>
@@ -24,6 +15,7 @@
     <primary>Navigation</primary>
     <secondary>Dialog</secondary>
   </indexterm>
+
   <figure>
     <title>
       <phrase>Navigation Dialog</phrase>
@@ -41,43 +33,70 @@
     location of the current view area in respect to the image. This
     rectangular outline can be dragged to change the viewing region.
   </para>
+
   <sect3>
     <title>
-      <phrase>Activate the dialog</phrase>
+      <phrase>Activating the dialog</phrase>
     </title>
     <para>
-      The Navigation window dialog can be called in many ways:
+      The <quote>Navigation</quote> dialog is a dockable dialog; see the section
+      <xref linkend="gimp-concepts-docks"/>
+      for help on manipulating it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          from the image-menu:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Navigation</guimenuitem></menuchoice>,
+          from the image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Navigation</guimenuitem>
+          </menuchoice>;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Navigation</guimenuitem>
+          </menuchoice>,
         </para>
       </listitem>
       <listitem>
         <para>
           from the image-menu:
-          <menuchoice><guimenu>View</guimenu><guimenuitem>Navigation window</guimenuitem></menuchoice>,
+          <menuchoice>
+            <guimenu>View</guimenu>
+            <guimenuitem>Navigation window</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
         <para>
-          from another dialog-menu:
-          <menuchoice><guimenu>Add Tab</guimenu><guimenuitem>Navigation</guimenuitem></menuchoice>.
+          You can access more quickly to it (but without the zoom functions)
+          by clicking on the icon at the right bottom corner of the image window:
+          <mediaobject>
+            <imageobject>
+              <imagedata format="PNG"
+                         fileref="images/dialogs/icon-navigation.png"/>
+            </imageobject>
+          </mediaobject>
         </para>
       </listitem>
     </itemizedlist>
-    <para>
-      You can access more quickly to it (but without the zoom functions)
-      by clicking on the icon at the right bottom corner of the image window:
-      <mediaobject>
-        <imageobject>
-          <imagedata fileref="images/dialogs/icon-navigation.png" format="PNG"/>
-        </imageobject>
-      </mediaobject>
-    </para>
   </sect3>
+
   <sect3>
     <title>
       <phrase>Using the Navigation Dialog</phrase>
@@ -100,7 +119,7 @@
           </para>
           <variablelist>
             <varlistentry>
-              <term><!-- FIXME: cs -->
+              <term>
                 Adjust the zoom ratio so that the image becomes fully visible
               </term>
               <listitem>
@@ -115,7 +134,7 @@
                 Adjust the zoom ratio so that the window is used optimally
               </term>
               <listitem>
-                <para><!-- FIXME: cs -->
+                <para>
                   The image size and the zoom are adjusted so that the image
                   is fully displayed with the lesser zoom.
                 </para>

Modified: trunk/src/dialogs/palettes-dialog.xml
==============================================================================
--- trunk/src/dialogs/palettes-dialog.xml	(original)
+++ trunk/src/dialogs/palettes-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -11,15 +11,6 @@
   2005-11-29 replaced informalfigures by figures by lexa
 -->
 <sect2 id="gimp-palette-dialog">
-  <!--<sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-15</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Palettes Dialog</phrase>
   </title>
@@ -35,9 +26,11 @@
     <primary>Color</primary>
     <secondary>Color palettes</secondary>
   </indexterm>
+
   <para>
     A <emphasis>palette</emphasis> is a set of discrete colors, in no
-    particular order.  See the <link linkend="gimp-concepts-palettes">Palettes</link> section for basic
+    particular order.  See the
+    <link linkend="gimp-concepts-palettes">Palettes</link> section for basic
     information on palettes and how they can be created and used.
   </para>
   <para>
@@ -55,34 +48,54 @@
       which is used to manipulate the colormaps of indexed images.
     </para>
   </note>
+
   <sect3 id="gimp-palette-activate">
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the dialog</phrase>
     </title>
     <para>
-      The Palettes dialog is a dockable dialog; see the section on <link linkend="gimp-concepts-docks">Dialogs and Docking</link> for help on
-      manipulating it.  It can be activated in several ways:
+      The <quote>Palettes</quote> dialog is a dockable dialog; see the section
+      <xref linkend="gimp-concepts-docks"/>
+      for help on manipulating it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          From an image menu:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Palettes</guimenuitem></menuchoice>.
+          from the image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Palettes</guimenuitem>
+          </menuchoice>;
         </para>
       </listitem>
       <listitem>
         <para>
-          From the Tab menu in any dockable dialog:
-          <menuchoice><guimenu>Add Tab</guimenu><guimenuitem>Palettes</guimenuitem></menuchoice>.
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Palettes</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
     </itemizedlist>
   </sect3>
+
   <sect3 id="gimp-palette-dialog-using">
     <title>
       <phrase>Using the Palettes dialog</phrase>
     </title>
-    <para><!--TODO es;it: v2.4-->
+    <para>
       Clicking on a palette in the dialog selects this palette and brings up
       the <link linkend="gimp-palette-editor-dialog">Palette Editor</link>,
       which allows you to set GIMP's foreground or background colors by
@@ -107,7 +120,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/palettes-grid-dialog.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/palettes-grid-dialog.png" />
               </imageobject>
               <caption>
                 <para>Grid View</para>
@@ -115,7 +129,8 @@
             </mediaobject>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/palettes-dialog.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/palettes-dialog.png"/>
               </imageobject>
               <caption>
                 <para>List View</para>
@@ -269,7 +284,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/palette-import-dialog.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/palette-import-dialog.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -298,9 +314,9 @@
                   file (with extension <filename>.pal</filename>), of the
                   type used by several Microsoft Windows applications.
                 </para>
-                <para><!--TODO es;it: v2.4-->
-                  Two new options in GIMP-2.4 concerning image as source,
-                  available for RGB images only:
+                <para>
+                  Two options concerning image as source, available for RGB
+                  images only:
                 </para>
                 <itemizedlist>
                   <listitem>
@@ -460,7 +476,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/palettes-offset-options.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/palettes-offset-options.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -480,7 +497,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/examples/palettes-offset.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/examples/palettes-offset.png"/>
               </imageobject>
               <caption>
                 <para>
@@ -529,7 +547,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/examples/palettes-repeat-gradient.png" format="PNG"/>
+                <imagedata format="PNG"
+                fileref="images/dialogs/examples/palettes-repeat-gradient.png"/>
               </imageobject>
               <caption>
                 <para>
@@ -556,7 +575,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/palettes-sort.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/palettes-sort.png"/>
               </imageobject>
             </mediaobject>
           </figure>
@@ -599,7 +619,8 @@
       </title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/dialogs/palette-editor-dialog.png" format="PNG"/>
+          <imagedata format="PNG"
+                     fileref="images/dialogs/palette-editor-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -753,7 +774,8 @@
       </title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/dialogs/palette-editor-context-menu.png" format="PNG"/>
+          <imagedata format="PNG"
+                     fileref="images/dialogs/palette-editor-context-menu.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -770,10 +792,11 @@
         </term>
         <listitem>
           <para>
-            "Edit Color" brings up a color editor that allows you to modify
-            the color of the selected palette entry. If the palette is one
-            that you are not allowed to edit (that is, one supplied by GIMP
-            when it is installed), then the menu entry will be insensitive.
+            <quote>Edit Color</quote> brings up a color editor that allows
+            you to modify the color of the selected palette entry. If
+            the palette is one that you are not allowed to edit (that is, one
+            supplied by GIMP when it is installed), then the menu entry will
+            beinsensitive.
           </para>
         </listitem>
       </varlistentry>
@@ -795,7 +818,8 @@
         </term>
         <listitem>
           <para>
-            "Delete Color" removes the selected color entry from the palette.
+            <quote>Delete Color</quote> removes the selected color entry
+            from the palette.
             If the palette is one that you are not allowed to edit, then the
             menu entry will be insensitive.
           </para>
@@ -807,8 +831,8 @@
         </term>
         <listitem>
           <para>
-            "Zoom Out" reduces the vertical scale of the entries in the
-            palette display.
+            <quote>Zoom Out</quote> reduces the vertical scale of the
+            entries in the palette display.
           </para>
         </listitem>
       </varlistentry>
@@ -818,8 +842,8 @@
         </term>
         <listitem>
           <para>
-            "Zoom In" increases the vertical scale of the entries in the
-            palette display.
+            <quote>Zoom In</quote> increases the vertical scale of the
+            entries in the palette display.
           </para>
         </listitem>
       </varlistentry>

Modified: trunk/src/dialogs/path-dialog.xml
==============================================================================
--- trunk/src/dialogs/path-dialog.xml	(original)
+++ trunk/src/dialogs/path-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -22,6 +22,7 @@
     Please see <xref linkend="gimp-using-paths"/> if you don't know what a
     path is.
   </para>
+
   <figure>
     <title>
       <phrase>The Paths dialog</phrase>
@@ -32,46 +33,64 @@
       </imageobject>
     </mediaobject>
   </figure>
+
   <para>
     The Paths dialog is used to manage paths, allowing you to create or
     delete them, save them, convert them to and from selections, etc.
   </para>
+
   <sect3 id="gimp-path-dialog-activate">
     <title>
-      <phrase>Activate dialog</phrase>
+      <phrase>Activating the dialog</phrase>
     </title>
     <para>
-      The Paths dialog is a dockable dialog; see the section on
-      <link linkend="gimp-concepts-docks">Dialogs and Docking</link>
-      for help on manipulating it. It can be activated in several ways:
+      The <quote>Paths</quote> dialog is a dockable dialog; see the section
+      <xref linkend="gimp-concepts-docks"/>
+      for help on manipulating it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          From an image menu:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Paths</guimenuitem></menuchoice>.
+          from the image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Paths</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
         <para>
-          From the Tab menu in any dockable dialog:
-          <menuchoice><guimenu>Add Tab</guimenu><guimenuitem>Paths</guimenuitem></menuchoice>.
-        </para>
-      </listitem>
-    </itemizedlist>
-    <itemizedlist>
-      <para>
-        If there is an open <quote>Paths</quote> dialog window (for example,
-        if the <quote>Paths</quote> tab has been
-        <link linkend="gimp-dockable-menu">detached</link>), you can raise it
-        from the image-menu:
-      </para>
-      <listitem>
-        <para><menuchoice><guimenu>Windows</guimenu><guimenuitem>Paths</guimenuitem></menuchoice>.
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Paths</guimenuitem>
+          </menuchoice>,
         </para>
       </listitem>
     </itemizedlist>
+    <para>
+      In the <guimenu>Windows</guimenu> menu, there is a list of
+      <link linkend="gimp-dockable-menu">detached layers</link> which exists
+      only if at least one dialog remains open. In this case, you can raise
+      the <quote>Paths</quote> dialog from the image-menu:
+      <menuchoice>
+        <guimenu>Windows</guimenu>
+        <guimenuitem>Paths</guimenuitem>
+      </menuchoice>.
+    </para>
   </sect3>
+
   <sect3 id="gimp-path-dialog-using">
     <title>
       <phrase>Using the Paths dialog</phrase>
@@ -182,6 +201,7 @@
       You can also access the Paths Menu from the dialog Tab menu.
     </para>
   </sect3>
+
   <sect3 id="gimp-path-dialog-buttons">
     <title>
       <phrase>Buttons</phrase>
@@ -297,6 +317,7 @@
       </varlistentry>
     </variablelist>
   </sect3>
+
   <sect3 id="gimp-concepts-paths-menu">
     <title>
       <phrase>The <quote>Paths</quote> context menu</phrase>
@@ -442,7 +463,10 @@
             <listitem>
               <para>
                 From an image menubar, as
-                <menuchoice><guimenu>Select</guimenu><guimenuitem>To Path</guimenuitem></menuchoice>
+                <menuchoice>
+                  <guimenu>Select</guimenu>
+                  <guimenuitem>To Path</guimenuitem>
+                </menuchoice>
               </para>
             </listitem>
             <listitem>
@@ -498,7 +522,10 @@
             <listitem>
               <para>
                 From an image menubar, as
-                <menuchoice><guimenu>Edit</guimenu><guimenuitem>Stroke Path</guimenuitem></menuchoice>
+                <menuchoice>
+                  <guimenu>Edit</guimenu>
+                  <guimenuitem>Stroke Path</guimenuitem>
+                </menuchoice>
               </para>
             </listitem>
             <listitem>
@@ -523,7 +550,8 @@
           <para><quote>Stroke Path</quote> renders the active path on the active
             layer of
             the image, permitting a wide variety of line styles and
-            stroking options.  See the section on <link linkend="gimp-selection-stroke">Stroking</link> for more
+            stroking options.  See the section on
+            <link linkend="gimp-selection-stroke">Stroking</link> for more
             information.
           </para>
         </listitem>
@@ -585,7 +613,8 @@
             SVG:  this means that vector-graphics programs such as
             <application>Sodipodi</application> or
             <application>Inkscape</application> will also be able to
-            import the paths you save.  See the <link linkend="gimp-concepts-paths">Paths</link> section for more
+            import the paths you save.  See the
+            <link linkend="gimp-concepts-paths">Paths</link> section for more
             information on SVG files and how they relate to GIMP paths.
           </para>
         </listitem>

Modified: trunk/src/dialogs/patterns-dialog.xml
==============================================================================
--- trunk/src/dialogs/patterns-dialog.xml	(original)
+++ trunk/src/dialogs/patterns-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -9,15 +9,6 @@
   2005-11-29 replaced informalfigures by figures by lexa
 -->
 <sect2 id="gimp-pattern-dialog">
-  <!--<sect2info>
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-13</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Patterns Dialog</phrase>
   </title>
@@ -29,6 +20,7 @@
     <primary>Patterns</primary>
     <secondary>Dialog</secondary>
   </indexterm>
+
   <para>
     In GIMP, a <emphasis>pattern</emphasis>
     is a small image used to fill areas by placing copies of side by side. See
@@ -49,14 +41,18 @@
     randomly chosen patterns are supplied with GIMP, and you can easily add
     new patterns of your own.
   </para>
+
   <sect3 id="gimp-pattern-dialog-activate">
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the dialog</phrase>
     </title>
     <para>
-      The Patterns dialog is a dockable dialog; see the section on
-      <link linkend="gimp-concepts-docks">Dialogs and Docking</link>
-      for help on manipulating it. It can be activated in several ways:
+      The <quote>Patterns</quote> dialog is a dockable dialog; see the section
+      <xref linkend="gimp-concepts-docks"/>
+      for help on manipulating it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
@@ -67,16 +63,28 @@
       </listitem>
       <listitem>
         <para>
-          From an image menu:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Patterns</guimenuitem></menuchoice>.
+          from the image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Patterns</guimenuitem>
+          </menuchoice>;
         </para>
       </listitem>
       <listitem>
         <para>
-          From the Tab menu in any dockable dialog, that you get by
-          clicking on
-          <guiicon><inlinegraphic fileref="images/dialogs/stock-menu-left-12.png"/></guiicon> :
-          <menuchoice><guimenu>Add Tab</guimenu><guimenuitem>Patterns</guimenuitem></menuchoice>.
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Patterns</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
@@ -99,6 +107,7 @@
       </listitem>
     </itemizedlist>
   </sect3>
+
   <sect3 id="gimp-pattern-dialog-using">
     <title>
       <phrase>Using the pattern dialog</phrase>
@@ -139,7 +148,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/patterns-dialog-list.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/patterns-dialog-list.png"/>
               </imageobject>
               <caption>
                 <para>List view</para>
@@ -147,7 +157,8 @@
             </mediaobject>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/dialogs/patterns-dialog.png" format="PNG"/>
+                <imagedata format="PNG"
+                           fileref="images/dialogs/patterns-dialog.png"/>
               </imageobject>
               <caption>
                 <para>Grid mode</para>
@@ -239,6 +250,7 @@
       </varlistentry>
     </variablelist>
   </sect3>
+
   <sect3>
     <title>
       <phrase>The Pattern context menu</phrase>
@@ -250,6 +262,7 @@
       copy the path to pattern into clipboard.
     </para>
   </sect3>
+
   <sect3 id="clipboard-pattern">
     <title>
       <phrase>The Clipboard pattern</phrase>
@@ -262,7 +275,7 @@
       <secondary>Clipboard pattern</secondary>
     </indexterm>
     <para>
-      This is a novelty in GIMP-2.4. When you use the Copy command, a copy
+      When you use the Copy command, a copy
       appears as a new pattern in the upper left corner of the Patterns
       dialog. This brush will persist until you use the Copy command again.
       It disapears when you close GIMP.
@@ -273,14 +286,19 @@
       </title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/dialogs/patterns-dialog-clipboard.png" format="PNG"/>
+          <imagedata format="PNG"
+                     fileref="images/dialogs/patterns-dialog-clipboard.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <note>
       <para>
         You can save this clipboard pattern by using the
-        <menuchoice><guimenu>Edit</guimenu><guisubmenu>Paste as</guisubmenu><guimenuitem>New pattern</guimenuitem></menuchoice>
+        <menuchoice>
+          <guimenu>Edit</guimenu>
+          <guisubmenu>Paste as</guisubmenu>
+          <guimenuitem>New pattern</guimenuitem>
+        </menuchoice>
         as soon as it appears in the Patterns dialog.
       </para>
     </note>

Modified: trunk/src/dialogs/pointer-dialog.xml
==============================================================================
--- trunk/src/dialogs/pointer-dialog.xml	(original)
+++ trunk/src/dialogs/pointer-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -8,15 +8,6 @@
   2007-11-22 j.h: created
 -->
 <sect2 id="gimp-pointer-info-dialog">
-  <!--<sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-16</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Pointer Dialog</phrase>
   </title>
@@ -27,6 +18,7 @@
   <indexterm>
     <primary>Pointer</primary>
   </indexterm>
+
   <figure>
     <title>
       <phrase>Pointer dialog</phrase>
@@ -37,29 +29,55 @@
       </imageobject>
     </mediaobject>
   </figure>
+
   <para>
     This dialog offers you, in a same window, in real time, the position of
     the mouse pointer, and the channel values of the pointed pixel, in the
     chosen color model.
   </para>
+
   <sect3>
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the dialog</phrase>
     </title>
     <para>
-      The <quote>Pointer</quote> dialog is dockable. Read
-      <xref linkend="gimp-concepts-docks"/> to learn more about the concept
-      of dockability. You can access to this dialog in different ways:
+      The <quote>Pointer</quote> dialog is a dockable dialog; see the section
+      <xref linkend="gimp-concepts-docks"/>
+      for help on manipulating it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          From the image Menu-bar:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Pointer</guimenuitem></menuchoice>,
+          from the image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Pointer</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Pointeur</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
     </itemizedlist>
   </sect3>
+
   <sect3>
     <title>
       <phrase><quote>Pointer</quote> dialog options</phrase>

Modified: trunk/src/dialogs/qmask.xml
==============================================================================
--- trunk/src/dialogs/qmask.xml	(original)
+++ trunk/src/dialogs/qmask.xml	Sat Feb 28 07:45:49 2009
@@ -7,15 +7,8 @@
   2006-03-06 lexa: reviewed and made docbook compliant
 -->
 <sect3 id="gimp-qmask">
-  <!--<sect3info>
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2007-08-24</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect3info>-->
+
+  <!-- This dialog is called from channel-dialog.xml-->
   <title>
     <phrase>Quick Mask</phrase>
   </title>
@@ -42,14 +35,17 @@
   </para>
   <sect4>
     <title>
-      <phrase>Activate dialog</phrase>
+      <phrase>Activating the dialog</phrase>
     </title>
     <itemizedlist>
       <listitem>
         <para>
           The QuickMask can be activated in the following order, from the
-          image-menu: <guimenuitem>Select/Toggle
-            QuickMask</guimenuitem>.
+          image-menu:
+          <menuchoice>
+            <guimenu>Select</guimenu>
+            <guimenuitem>Toggle QuickMask</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
@@ -77,7 +73,13 @@
       border is covered with a translucent red color. If no selection was
       active then all the image is covered with a translucent red color. At
       every moment you can hide the mask by clicking on the eye icon
-      <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/dialogs/stock-eye-20.png"/></imageobject></inlinemediaobject></guiicon>
+      <guiicon>
+        <inlinemediaobject>
+          <imageobject>
+            <imagedata
+              fileref="images/dialogs/stock-eye-20.png"/></imageobject>
+        </inlinemediaobject>
+      </guiicon>
       in front of the <guilabel>QMask</guilabel>.
       From the channel dialog you can double click on the name or the
       thumbnail to edit the <guilabel>QMask</guilabel>
@@ -99,11 +101,12 @@
   </sect4>
   <sect4>
     <title>
-      <phrase>Using Quick Mask's</phrase>
+      <phrase>Using Quick Mask with a gradient</phrase>
     </title>
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/dialogs/channel-masks-gradient.png" format="PNG"/>
+        <imagedata format="PNG"
+                   fileref="images/dialogs/channel-masks-gradient.png"/>
       </imageobject>
     </mediaobject>
     <orderedlist>
@@ -112,24 +115,24 @@
       </title>
       <listitem>
         <para>
-          Screenshot of the image window with activated QuickMask. The
-          QuickMask is filled with a gradient from black (left) to white
-          (right).
+          Screenshot of the image window with activated QuickMask. As long as
+          the Quickmask is activated, all operations are done on it. A
+          gradient from black (left) to white (right) has been applied to the
+          mask.
         </para>
       </listitem>
       <listitem>
         <para>
-          The QuickMask is now disabled and a selection is initialised from
-          the QuickMask, which was filled by a gradient before. You see the
-          selection borders in the middle of the image.
+          The QuickMask is now disabled. The selection occupies the right half
+          part of the image (marching ants) because the limit of the selection
+          is at the middle of the gradient.
         </para>
       </listitem>
       <listitem>
         <para>
-          A stroke is now added during the enabled selection. The key is,
-          that the black color will have no opacity of the resulting stroke
-          (right) and white color will have a full opacity of the stroke
-          (left).
+          A stroke is now added during the enabled selection. Weird! The
+          gradient, although not visible, remains active all over the image,
+          in selected and non selected areas!
         </para>
       </listitem>
     </orderedlist>

Modified: trunk/src/dialogs/sample-points.xml
==============================================================================
--- trunk/src/dialogs/sample-points.xml	(original)
+++ trunk/src/dialogs/sample-points.xml	Sat Feb 28 07:45:49 2009
@@ -8,15 +8,6 @@
   2007-11-18 j.h: created
 -->
 <sect2 id="gimp-sample-point-dialog">
-  <!--<sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-16</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Sample Points Dialog</phrase>
   </title>
@@ -37,19 +28,41 @@
   </para>
   <sect3>
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the dialog</phrase>
     </title>
     <para>
-      The dialog <quote>Sample points</quote>
-      is dockable. Read <xref linkend="gimp-concepts-docks"/> to learn more
-      about the concept of dockability. You can access to this dialog in
-      different ways:
+      The <quote>Sample Points</quote> dialog is a dockable dialog; see the
+      section <xref linkend="gimp-concepts-docks"/> for help on manipulating
+      it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          From the image Menu-bar:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Sample Points</guimenuitem></menuchoice>,
+          from the image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Sample Points</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Sample Points</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
     </itemizedlist>
@@ -93,7 +106,8 @@
       </title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/dialogs/sample-points-menu.png" format="PNG"/>
+          <imagedata format="PNG"
+                     fileref="images/dialogs/sample-points-menu.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -109,7 +123,8 @@
       </title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/dialogs/sample-points-dialog.png" format="PNG"/>
+          <imagedata format="PNG"
+                     fileref="images/dialogs/sample-points-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>

Modified: trunk/src/dialogs/templates-dialog.xml
==============================================================================
--- trunk/src/dialogs/templates-dialog.xml	(original)
+++ trunk/src/dialogs/templates-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -10,15 +10,6 @@
   2005-05-19 created by j.h
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-template-dialog">
-  <!--<sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-26</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Templates Dialog</phrase>
   </title>
@@ -29,6 +20,7 @@
   <indexterm>
     <primary>Templates</primary>
   </indexterm>
+
   <figure>
     <title>
       <phrase>The <quote>Templates</quote> dialog</phrase>
@@ -39,6 +31,7 @@
       </imageobject>
     </mediaobject>
   </figure>
+
   <para>
     Templates are templates for an image format to be created. GIMP offers you
     a lot of templates and you can create your owns. When you create a New
@@ -46,23 +39,49 @@
     manage them. The <quote>Templates</quote>
     dialog allows you to manage all these templates.
   </para>
+
   <sect3>
     <title>
-      <phrase>Activate Dialog</phrase>
+      <phrase>Activating the dialog</phrase>
     </title>
     <para>
-      The Templates dialog is a dockable dialog; see the section on <link linkend="gimp-concepts-docks">Dialogs and Docking</link> for help on
-      manipulating it.
+      The <quote>Templates</quote> dialog is a dockable dialog; see the
+      section <xref linkend="gimp-concepts-docks"/> for help on manipulating
+      it.
     </para>
     <para>
-      It can be activated from an image menu through:
-      <menuchoice>
-        <guimenu>Dockable Windows</guimenu>
-        <guimenuitem>Templates</guimenuitem>
-      </menuchoice>.
+      You can access it:
     </para>
-
+    <itemizedlist>
+      <listitem>
+        <para>
+          from the image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Templates</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Templates</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+    </itemizedlist>
   </sect3>
+
   <sect3>
     <title>
       <phrase>Using the <quote>Templates</quote> dialog</phrase>
@@ -90,6 +109,7 @@
         you to change the size of thumbnails.
       </para>
     </sect4>
+
     <sect4>
       <title>
         <phrase>Buttons at the bottom</phrase>

Modified: trunk/src/dialogs/tools-dialog.xml
==============================================================================
--- trunk/src/dialogs/tools-dialog.xml	(original)
+++ trunk/src/dialogs/tools-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -51,24 +51,49 @@
     clicking on its symbol, but for this purpose you might as well just use
     the Toolbox.
   </para>
-  <para>
-    The Tools dialog is a dockable dialog; see the section on <link linkend="gimp-concepts-docks">Dialogs and Docking</link> for help on
-    manipulating it.  It can be activated in several ways:
-  </para>
-  <itemizedlist>
-    <listitem>
-      <para>
-        From an image menu:
-        <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Tools</guimenuitem></menuchoice>.
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        From the Tab menu in any dockable dialog:
-        <menuchoice><guimenu>Add Tab</guimenu><guimenuitem>Tools</guimenuitem></menuchoice>.
-      </para>
-    </listitem>
-  </itemizedlist>
+
+  <sect3>
+    <title>
+      <phrase>Activating the dialog</phrase>
+    </title>
+    <para>
+      The <quote>Tools</quote> dialog is a dockable dialog; see the
+      section <xref linkend="gimp-concepts-docks"/> for help on manipulating
+      it.
+    </para>
+    <para>
+      You can access it:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          from the image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Tools</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Tools</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+
   <sect3>
     <title>
       <phrase>Grid/List modes</phrase>
@@ -82,6 +107,7 @@
       if the tool is currently visible in the Toolbox.
     </para>
   </sect3>
+
   <sect3>
     <title>
       <phrase>Using the Tools dialog</phrase>

Modified: trunk/src/dialogs/undo-history-dialog.xml
==============================================================================
--- trunk/src/dialogs/undo-history-dialog.xml	(original)
+++ trunk/src/dialogs/undo-history-dialog.xml	Sat Feb 28 07:45:49 2009
@@ -8,15 +8,6 @@
   2005-11-29 replaced informalfigures by figures by lexa
 -->
 <sect2 id="gimp-undo-dialog">
-  <!--<sect2info role="cvs">
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-12-13</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
   <title>
     <phrase>Undo History Dialog</phrase>
   </title>
@@ -27,6 +18,7 @@
   <indexterm>
     <primary>Undo History</primary>
   </indexterm>
+
   <figure>
     <title>
       <phrase>The Undo History dialog</phrase>
@@ -45,36 +37,49 @@
     information on GIMP's Undo mechanism and how it works, see the section on
     <link linkend="gimp-concepts-undo">Undoing</link>.
   </para>
+
   <sect3>
     <title>
-      <phrase>Activate the dialog</phrase>
+      <phrase>Activating the dialog</phrase>
     </title>
     <para>
-      The Undo History dialog is a dockable dialog; see the section on
-      <link linkend="gimp-concepts-docks">Dialogs and Docking</link>
-      for help on manipulating it. It can be activated in several ways:
+      The <quote>Undo History</quote> dialog is a dockable dialog; see the
+      section <xref linkend="gimp-concepts-docks"/> for help on manipulating
+      it.
+    </para>
+    <para>
+      You can access it:
     </para>
     <itemizedlist>
       <listitem>
         <para>
-          From an image menu:
-          <menuchoice><guimenu>Edit</guimenu><guimenuitem>Undo History</guimenuitem></menuchoice>.
+          from the image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Undo History</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
         <para>
-          From an image menu:
-          <menuchoice><guimenu>Windows</guimenu><guisubmenu>Dockable Dialogs</guisubmenu><guimenuitem>Undo History</guimenuitem></menuchoice>.
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          From the Tab menu in any dockable dialog:
-          <menuchoice><guimenu>Add Tab</guimenu><guimenuitem>Undo History</guimenuitem></menuchoice>.
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Undo History</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
     </itemizedlist>
   </sect3>
+
   <sect3>
     <title>
       <phrase>Using the Undo History dialog</phrase>
@@ -92,7 +97,10 @@
         <listitem>
           <para>
             This button has the same effect as choosing
-            <menuchoice><guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem></menuchoice>
+            <menuchoice>
+              <guimenu>Edit</guimenu>
+              <guimenuitem>Undo</guimenuitem>
+            </menuchoice>
             from the menu, or pressing
             <keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo>;
             it reverts the image to the next state back in the undo history.
@@ -104,9 +112,13 @@
         <listitem>
           <para>
             This button has the same effect as choosing
-            <menuchoice><guimenu>Edit</guimenu><guimenuitem>Redo</guimenuitem></menuchoice> from the menu, or pressing
-            <keycombo><keycap>Ctrl</keycap><keycap>Y</keycap></keycombo>; it advances the image to the next state forward in
-            the undo history.
+            <menuchoice>
+              <guimenu>Edit</guimenu>
+              <guimenuitem>Redo</guimenuitem>
+            </menuchoice>
+            from the menu, or pressing
+            <keycombo><keycap>Ctrl</keycap><keycap>Y</keycap></keycombo>;
+            it advances the image to the next state forward in the Undo History.
           </para>
         </listitem>
       </varlistentry>
@@ -127,7 +139,8 @@
               <guiicon>
                 <inlinemediaobject>
                   <imageobject>
-                    <imagedata fileref="images/dialogs/stock-undo-history-16.png" format="PNG"/>
+                    <imagedata format="PNG"
+                      fileref="images/dialogs/stock-undo-history-16.png"/>
                   </imageobject>
                 </inlinemediaobject>
               </guiicon>
@@ -136,7 +149,8 @@
           </note>
           <note>
             <para>
-              You can set the number of undo levels in <link linkend="gimp-prefs-environment">Preferences/Environment</link>.
+              You can set the number of undo levels in <link
+              linkend="gimp-prefs-environment">Preferences/Environment</link>.
             </para>
           </note>
         </listitem>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]