gimp-help-2 r2786 - in trunk: . images/C/toolbox src/toolbox



Author: jhardlin
Date: Wed Mar 18 20:11:18 2009
New Revision: 2786
URL: http://svn.gnome.org/viewvc/gimp-help-2?rev=2786&view=rev

Log:
2009-03-15 Julien hardelin <jm hard wanadoo fr>

        * src/toolbox/tool-pencil.xml
        * src/toolbox/tool-airbrush.xml
        * src/toolbox/tool-ink.xml
        * src/toolbox/tool-smudge.xml
        * src/toolbox/tool-blend.xml
        * src/toolbox/tool-perspective.xml
        * src/toolbox/tool-convolve.xml
        * src/toolbox/tool-clone.xml
        * src/toolbox/tool-bucket-fill.xml
        * src/toolbox/tool-heal.xml
        * src/toolbox/tool-transform.xml
        * src/toolbox/tool-paintbrush.xml
        * src/toolbox/tool-dodge-burn.xml
        * src/toolbox/tool-perspective-clone.xml: cleaned and updated files

        * src/toolbox/tool-eraser.xml
        * images/C/toolbox/eraser-ex1.png
        * images/C/toolbox/eraser-ex2.png: Added example

        * images/C/toolbox/tool-options-blur-sharpen.png
        * images/C/toolbox/tool-options-convolve.png: renamed


Added:
   trunk/images/C/toolbox/eraser-ex1.png   (contents, props changed)
   trunk/images/C/toolbox/eraser-ex2.png   (contents, props changed)
   trunk/images/C/toolbox/tool-options-blur-sharpen.png   (props changed)
      - copied unchanged from r2784, /trunk/images/C/toolbox/tool-options-convolve.png
Removed:
   trunk/images/C/toolbox/tool-options-convolve.png
Modified:
   trunk/ChangeLog
   trunk/src/toolbox/tool-airbrush.xml
   trunk/src/toolbox/tool-blend.xml
   trunk/src/toolbox/tool-bucket-fill.xml
   trunk/src/toolbox/tool-clone.xml
   trunk/src/toolbox/tool-convolve.xml
   trunk/src/toolbox/tool-dodge-burn.xml
   trunk/src/toolbox/tool-eraser.xml
   trunk/src/toolbox/tool-heal.xml
   trunk/src/toolbox/tool-ink.xml
   trunk/src/toolbox/tool-paintbrush.xml
   trunk/src/toolbox/tool-pencil.xml
   trunk/src/toolbox/tool-perspective-clone.xml
   trunk/src/toolbox/tool-perspective.xml
   trunk/src/toolbox/tool-smudge.xml
   trunk/src/toolbox/tool-transform.xml

Added: trunk/images/C/toolbox/eraser-ex1.png
==============================================================================
Binary file. No diff available.

Added: trunk/images/C/toolbox/eraser-ex2.png
==============================================================================
Binary file. No diff available.

Modified: trunk/src/toolbox/tool-airbrush.xml
==============================================================================
--- trunk/src/toolbox/tool-airbrush.xml	(original)
+++ trunk/src/toolbox/tool-airbrush.xml	Wed Mar 18 20:11:18 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-03-16 j.h: reviewed for v2.6. No change
   2008-04-07 JPL reviewed fr
   2007-10-21 lexa: reviewed de for GIMP 2.4
   2007-06-15 kost: added norwegian
@@ -11,9 +12,7 @@
   050522 de reviewed by axel.wernicke
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-airbrush">
-  <title>
-    <phrase>Airbrush Tool</phrase>
-  </title>
+  <title>Airbrush Tool</title>
   <indexterm>
     <primary>Airbrush</primary>
   </indexterm>
@@ -23,9 +22,7 @@
   </indexterm>
 
   <figure>
-    <title>
-      <phrase>The Airbrush tool in Toolbox</phrase>
-    </title>
+    <title>The Airbrush tool in Toolbox</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/toolbox-airbrush.png" format="PNG"/>
@@ -38,9 +35,7 @@
     for painting soft areas of color.
   </para>
   <sect3>
-    <title>
-      <phrase>Activate the Tool</phrase>
-    </title>
+    <title>Activating the Tool</title>
     <para>You can activate the Airbrush tool in several ways :</para>
     <itemizedlist>
       <listitem>
@@ -56,7 +51,9 @@
       <listitem>
         <para>
           By clicking on the tool icon:
-          <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/stock-tool-airbrush-22.png"/></imageobject></inlinemediaobject></guiicon>
+          <guiicon><inlinegraphic
+            fileref="images/toolbox/stock-tool-airbrush-22.png"/>
+          </guiicon>
           in the Toolbox,
         </para>
       </listitem>
@@ -69,9 +66,7 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers (Defaults)</phrase>
-    </title>
+    <title>Key modifiers (Defaults)</title>
     <variablelist>
       <varlistentry>
         <term>
@@ -100,13 +95,9 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase>Airbrush options</phrase>
-      </title>
+      <title>Airbrush options</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/tool-options-airbrush.png" format="PNG"/>

Modified: trunk/src/toolbox/tool-blend.xml
==============================================================================
--- trunk/src/toolbox/tool-blend.xml	(original)
+++ trunk/src/toolbox/tool-blend.xml	Wed Mar 18 20:11:18 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-03-16 j.h: reviewed for v2.6. No change
      2008-04-07 JPL rewied "fr"
      2008-03-19 Mr.Dust : added korean contents
      2008-01-25  PP rewied "fr" for GIMP 2.4
@@ -17,9 +18,7 @@
      050817 de reviewed by axel.wernicke
      -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-blend">
-  <title>
-    <phrase>Blend</phrase>
-  </title>
+  <title>Blend</title>
   <indexterm>
     <primary>Blend</primary>
   </indexterm>
@@ -33,9 +32,7 @@
   </indexterm>
 
   <figure>
-    <title>
-      <phrase>The Blend tool in Toolbox.</phrase>
-    </title>
+    <title>The Blend tool in Toolbox</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/toolbox-gradient.png" format="PNG"/>
@@ -83,9 +80,7 @@
   </tip>
 
   <sect3>
-    <title>
-      <phrase>Activate the Tool</phrase>
-    </title>
+    <title>Activating the Tool</title>
     <para>
       There are different possibilities to activate the tool:
     </para>
@@ -103,7 +98,9 @@
       <listitem>
         <para>
           By clicking the tool icon
-          <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/stock-tool-blend-22.png"/></imageobject></inlinemediaobject></guiicon>.
+          <guiicon><inlinegraphic
+            fileref="images/toolbox/stock-tool-blend-22.png"/>
+          </guiicon>.
         </para>
       </listitem>
       <listitem>
@@ -115,9 +112,7 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers (Defaults)</phrase>
-    </title>
+    <title>Key modifiers (Defaults)</title>
     <variablelist>
       <varlistentry>
         <term>
@@ -134,13 +129,9 @@
     </variablelist>
   </sect3>
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Blend</quote> tool options</phrase>
-      </title>
+      <title><quote>Blend</quote> tool options</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/blend-tool-options.png" format="PNG"/>

Modified: trunk/src/toolbox/tool-bucket-fill.xml
==============================================================================
--- trunk/src/toolbox/tool-bucket-fill.xml	(original)
+++ trunk/src/toolbox/tool-bucket-fill.xml	Wed Mar 18 20:11:18 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-03-15 j.h: reviewed for v2.6. No change
   2008-03-31 JPL reviewed de for GIMP 2.4
   2008-03-15 Mr.Dust : added korean contents
   2008-02-20 j.h: updated to v2.4 en;fr. Added Fill feathered selection
@@ -11,9 +12,7 @@
   050815 de reviewed by axel.wernicke
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-bucket-fill">
-  <title>
-    <phrase>Bucket Fill</phrase>
-  </title>
+  <title>Bucket Fill</title>
   <indexterm>
     <primary>Tools</primary>
     <secondary>Bucket Fill</secondary>
@@ -23,9 +22,7 @@
   </indexterm>
 
   <figure>
-    <title>
-      <phrase>Toolbox Fill</phrase>
-    </title>
+    <title>Toolbox Fill</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/toolbox-fill.png" format="PNG"/>
@@ -64,9 +61,7 @@
   </para>
 
   <sect3>
-    <title>
-      <phrase>Activate tool</phrase>
-    </title>
+    <title>Activating the tool</title>
     <itemizedlist>
       <listitem>
         <para>
@@ -81,8 +76,11 @@
       <listitem>
         <para>
           You can also call it by clicking the tool icon:
-          <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/stock-tool-bucket-fill-22.png"/></imageobject></inlinemediaobject> in the Toolbox,
+          <guiicon>
+            <inlinegraphic
+              fileref="images/toolbox/stock-tool-bucket-fill-22.png"/>
           </guiicon>
+          in the toolbox.
         </para>
       </listitem>
       <listitem>
@@ -95,9 +93,7 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers (Defaults)</phrase>
-    </title>
+    <title><phrase>Key modifiers (Defaults)</phrase></title>
     <itemizedlist>
       <listitem>
         <para><keycap>Ctrl</keycap> toggles the use of BG Color Fill or FG
@@ -113,13 +109,9 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Bucket Fill</quote> tool options</phrase>
-      </title>
+      <title><phrase><quote>Bucket Fill</quote> tool options</phrase></title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/tool-options-fill.png" format="PNG"/>
@@ -356,19 +348,13 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Fill a feathered selection</phrase>
-    </title>
+    <title><phrase>Fill a feathered selection</phrase></title>
     <para>
       By clicking repeatedly in a selection with feathered edges, you
       progressively fill the feathered border:
     </para>
     <figure>
-      <title>
-        <phrase>
-          Example for <quote>Fill a feathered Selection</quote>
-        </phrase>
-      </title>
+      <title>Example for <quote>Fill a feathered Selection</quote></title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/fill-feathered-1.png" format="PNG"/>

Modified: trunk/src/toolbox/tool-clone.xml
==============================================================================
--- trunk/src/toolbox/tool-clone.xml	(original)
+++ trunk/src/toolbox/tool-clone.xml	Wed Mar 18 20:11:18 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-03-16 j.h: reviewed for v2.6. No change.
   2008-04-11 JPL reviewed fr
   2008-02-05 j.h : updated fr to v2.4 and enhanced align modes
                    examples for 'en' and 'fr'
@@ -17,9 +18,7 @@
   2005-05-23 de reviewed by axel.wernicke
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-clone">
-  <title>
-    <phrase>Clone</phrase>
-  </title>
+  <title>Clone</title>
   <indexterm>
     <primary>Tools</primary>
     <secondary>Clone</secondary>
@@ -27,18 +26,16 @@
   <indexterm>
     <primary>Clone</primary>
   </indexterm>
-  
+
   <figure>
-    <title>
-      <phrase>Clone tool icon in the Toolbox</phrase>
-    </title>
+    <title>Clone tool icon in the Toolbox</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/toolbox-clone.png" format="PNG"/>
       </imageobject>
     </mediaobject>
   </figure>
-  
+
   <para>
     The Clone tool uses the current brush to copy from an image or pattern.
     It has many uses: one of the most important is to repair problem areas in
@@ -56,15 +53,11 @@
     Until you have set the source in this way, you will not be able to paint
     with the Clone tool: the tool cursor tells you this by showing
     <guiicon>
-      <inlinemediaobject>
-        <imageobject>
-          <imagedata fileref="images/toolbox/clone-bad.png"/>
-        </imageobject>
-      </inlinemediaobject>
+      <inlinegraphic fileref="images/toolbox/clone-bad.png"/>
     </guiicon>.
   </para>
   <para>
-    If you clone from a pattern, the pattern is <emphasis>tiled</emphasis>; 
+    If you clone from a pattern, the pattern is <emphasis>tiled</emphasis>;
     that is, when the point you are copying from moves past one of the
     edges, it jumps to the opposite edge and continues, as though the pattern
     were repeated side-by-side, indefinitely. When you clone from an image
@@ -79,23 +72,27 @@
     layer to an Indexed layer or a layer mask), then the colors will be
     converted to the closest possible approximations.
   </para>
-  
+
   <sect3>
-    <title>
-      <phrase>How to Activate</phrase>
-    </title>
+    <title>Activating the tool</title>
     <para>You can activate the Clone tool in several ways :</para>
     <itemizedlist>
       <listitem>
         <para>
           From the image menu through
-          <menuchoice><guimenu>Tools</guimenu><guisubmenu>Paint Tools</guisubmenu><guimenuitem>Clone</guimenuitem></menuchoice>.
+          <menuchoice>
+            <guimenu>Tools</guimenu>
+            <guisubmenu>Paint Tools</guisubmenu>
+            <guimenuitem>Clone</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
         <para>
           By clicking on the tool icon
-          <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/stock-tool-clone-22.png"/></imageobject></inlinemediaobject></guiicon> in Toolbox.
+          <guiicon><inlinegraphic
+            fileref="images/toolbox/stock-tool-clone-22.png"/>
+          </guiicon> in Toolbox.
         </para>
       </listitem>
       <listitem>
@@ -105,17 +102,15 @@
       </listitem>
     </itemizedlist>
   </sect3>
-  
+
   <sect3>
-    <title>
-      <phrase>Key modifiers</phrase>
-    </title>
+    <title>Key modifiers (default)</title>
     <para>
       See the <link linkend="gimp-tools-brush-modifiers">Brush tools key
       modifiers</link> for a description of key modifiers that have the same
       effect on all brush tools.
     </para>
-    
+
     <variablelist>
       <varlistentry>
         <term>
@@ -134,21 +129,19 @@
             be used when you first begin painting with the Clone tool. In
             source-selection mode, the cursor changes to a reticle cross
             symbol
-            <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/clone-cross.png"/></imageobject></inlinemediaobject></guiicon>.
+            <guiicon>
+              <inlinegraphic fileref="images/toolbox/clone-cross.png"/>
+            </guiicon>.
           </para>
         </listitem>
       </varlistentry>
     </variablelist>
   </sect3>
-  
+
   <sect3>
-    <title>
-      <phrase>Tool Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase>Tool Options for the Clone tool</phrase>
-      </title>
+      <title>Tool Options for the Clone tool</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/tool-options-clone.png" format="PNG"/>
@@ -187,11 +180,11 @@
                   Ctrl-clicking on it, before you can paint with the tool.
                 </para>
                 <para>
-                  If you check <keycap>Sample merged</keycap> it's what you 
-                  <quote>see</quote> (color made with all the layers of a 
-                  multi-layer image) that's cloned. If it's unchecked, only 
-                  the selected layer is cloned. For more information see the 
-                  glossary entry 
+                  If you check <keycap>Sample merged</keycap> it's what you
+                  <quote>see</quote> (color made with all the layers of a
+                  multi-layer image) that's cloned. If it's unchecked, only
+                  the selected layer is cloned. For more information see the
+                  glossary entry
                   <link linkend="glossary-samplemerge">Sample Merge</link>
                 </para>
               </listitem>
@@ -389,11 +382,9 @@
       </varlistentry>
     </variablelist>
   </sect3>
-  
+
   <sect3 id="filter-and-history-brushes">
-    <title>
-      <phrase>Further Information</phrase>
-    </title>
+    <title>Further Information</title>
     <variablelist>
       <varlistentry>
         <term>Transparency</term>
@@ -441,7 +432,11 @@
       <varlistentry>
         <term><quote>Filter</quote> brushes</term>
         <listitem>
-          <para><indexterm><primary>Brushes</primary><secondary><quote>Filter</quote> brushes</secondary></indexterm>
+          <para>
+            <indexterm>
+              <primary>Brushes</primary>
+              <secondary><quote>Filter</quote>brushes</secondary>
+            </indexterm>
             There are a few non-obvious ways to use the Clone tool to obtain
             powerful effects. One thing you can do is to create <quote>Filter
             brushes</quote>, that is, create the effect of applying a filter
@@ -458,7 +453,11 @@
       <varlistentry>
         <term>History brush</term>
         <listitem>
-          <para><indexterm><primary>Brushes</primary><secondary>History brush</secondary></indexterm>
+          <para>
+            <indexterm>
+              <primary>Brushes</primary>
+              <secondary>History brush</secondary>
+            </indexterm>
             You can use a similar approach to imitate Photoshop's
             <quote>History brush</quote>, which allows you to selectively
             undo or redo changes using a brush. To do this, start by

Modified: trunk/src/toolbox/tool-convolve.xml
==============================================================================
--- trunk/src/toolbox/tool-convolve.xml	(original)
+++ trunk/src/toolbox/tool-convolve.xml	Wed Mar 18 20:11:18 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-03-18 j.h: updated to v2.6. Name changed to Blur/Sharpen. "id" unchanged.
   2008-04-21 JPL reviewed fr
   2008-02-27 j.h updated to v2.4 en;fr
   2007-06-17 kost: added norwegian
@@ -11,20 +12,18 @@
   050523 de reviewed by axel.wernicke
   -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-convolve">
-  <title>
-    <phrase>Convolve (Blur/Sharpen)</phrase>
-  </title>
+  <title>Blur/Sharpen</title>
   <indexterm>
     <primary>Tools</primary>
-    <secondary>Convolve</secondary>
+    <secondary>Blur/Sharpen</secondary>
   </indexterm>
   <indexterm>
-    <primary>Convolve</primary>
+    <primary>Blur/Sharpen</primary>
   </indexterm>
 
   <figure>
     <title>
-      <phrase>Convolve tool icon in the Toolbox</phrase>
+      <phrase>Blur/Sharpen tool icon in the Toolbox</phrase>
     </title>
     <mediaobject>
       <imageobject>
@@ -33,7 +32,7 @@
     </mediaobject>
   </figure>
   <para>
-    The Convolve tool uses the current brush to locally blur or sharpen your
+    The Blur/Sharpen tool uses the current brush to locally blur or sharpen your
     image. Blurring with it can be useful if some element of your image stands
     out too much, and you would like to soften it. If you want to blur a whole
     layer, or a large part of one, you will probably be better off using one
@@ -74,9 +73,7 @@
   </para>
 
   <sect3>
-    <title>
-      <phrase>Activating the Tool</phrase>
-    </title>
+    <title>Activating the Tool</title>
     <para>
       There are different possibilities to activate the tool:
     </para>
@@ -86,17 +83,16 @@
           From the image-menu:
           <menuchoice><guimenu>Tools</guimenu>
             <guisubmenu>Paint tools</guisubmenu>
-            <guimenuitem>Convolve</guimenuitem>
-          </menuchoice>,
+            <guimenuitem>Blur/Sharpen</guimenuitem>
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
         <para>
           The Tool can also be called by clicking the tool icon:
           <guiicon>
-            <inlinemediaobject><imageobject><imagedata
-              fileref="images/toolbox/stock-tool-blur-22.png"/></imageobject>
-            </inlinemediaobject>
+            <inlinegraphic
+              fileref="images/toolbox/stock-tool-blur-22.png"/>
           </guiicon>
           in the Toolbox.
         </para>
@@ -110,9 +106,7 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers</phrase>
-    </title>
+    <title>Key modifiers (Defaults)</title>
     <para>
       See the <link linkend="gimp-tool-brush">Brush Tools
       Overview</link> for a description of key modifiers that have the
@@ -129,16 +123,13 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Tool Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase>Tool Options for the Convolve tool</phrase>
-      </title>
+      <title>Tool Options for the Blur/Sharpen tool</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/tool-options-convolve.png" format="PNG"/>
+          <imagedata fileref="images/toolbox/tool-options-Blur/Sharpen.png"
+format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -178,7 +169,7 @@
         <listitem>
           <para>
             The <guilabel>Rate</guilabel>
-            slider sets the strength of the convolve effect.
+            slider sets the strength of the Blur/Sharpen effect.
           </para>
         </listitem>
       </varlistentry>

Modified: trunk/src/toolbox/tool-dodge-burn.xml
==============================================================================
--- trunk/src/toolbox/tool-dodge-burn.xml	(original)
+++ trunk/src/toolbox/tool-dodge-burn.xml	Wed Mar 18 20:11:18 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-03-18 j.h: reviewed for v2.6. No change
   2008-04-21 JPL reviewed fr
   2007-06-17 kost: added norwegian
   2006-05-01 added italian content by ciampix
@@ -9,9 +10,7 @@
   050523 de reviewed by axel.wernicke
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-dodge-burn">
-  <title>
-    <phrase>Dodge or Burn</phrase>
-  </title>
+  <title>Dodge or Burn</title>
   <indexterm>
     <primary>Tools</primary>
     <secondary>Dodge/Burn</secondary>
@@ -21,9 +20,7 @@
   </indexterm>
 
   <figure>
-    <title>
-      <phrase>Dodge tool</phrase>
-    </title>
+    <title>Dodge tool</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/toolbox-dodge.png" format="PNG"/>
@@ -37,9 +34,7 @@
   </para>
 
   <sect3>
-    <title>
-      <phrase>Activating the Tool</phrase>
-    </title>
+    <title>Activating the Tool</title>
     <para>
       There are different possibilities to activate the tool:
     </para>
@@ -61,7 +56,7 @@
               <imageobject><imagedata
                 fileref="images/toolbox/stock-tool-dodge-22.png"/>
               </imageobject></inlinemediaobject>
-          </guiicon>
+          </guiicon>,
         </para>
       </listitem>
       <listitem>
@@ -75,9 +70,7 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers (Defaults)</phrase>
-    </title>
+    <title>Key modifiers (Defaults)</title>
     <variablelist>
       <varlistentry>
         <term>
@@ -108,14 +101,9 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Tool Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Dodge/Burn</quote> tool options
-        </phrase>
-      </title>
+      <title><quote>Dodge/Burn</quote> tool options</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/tool-options-dodge.png" format="PNG"/>

Modified: trunk/src/toolbox/tool-eraser.xml
==============================================================================
--- trunk/src/toolbox/tool-eraser.xml	(original)
+++ trunk/src/toolbox/tool-eraser.xml	Wed Mar 18 20:11:18 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-03-16 j.h: reviewed for v2.6
      2008-04-07 JPL reviewed fr
      2008-02-13 j.h: added tip
      2008-01-26  PP updating to v2.4
@@ -13,9 +14,7 @@
      050521 de reviewed by axel.wernicke
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-eraser">
-  <title>
-    <phrase>Eraser</phrase>
-  </title>
+  <title>Eraser</title>
   <indexterm>
     <primary>Tools</primary>
     <secondary>Eraser</secondary>
@@ -29,9 +28,7 @@
   </indexterm>
 
   <figure>
-    <title>
-      <phrase>Eraser tool icon in the Toolbox</phrase>
-    </title>
+    <title>Eraser tool icon in the Toolbox</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/toolbox-eraser.png" format="PNG"/>
@@ -50,6 +47,31 @@
     the tool options. You can learn more on how to add an alpha channel to a
     layer in <xref linkend="gimp-layer-alpha-add"/>.
   </para>
+  <figure>
+    <title>Eraser and Alpha channel</title>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="images/toolbox/eraser-ex1.png" format="PNG"/>
+      </imageobject>
+      <caption>
+        <para>
+          The Background Color is White. The image has no Alpha channel. The
+          Eraser (Opacity 10%) shows the BG color.
+        </para>
+      </caption>
+    </mediaobject>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="images/toolbox/eraser-ex2.png" format="PNG"/>
+      </imageobject>
+      <caption>
+        <para>
+          The image has an Alpha channel. The Eraser shows transparency.
+        </para>
+      </caption>
+    </mediaobject>
+  </figure>
+
   <para>
     If you need to erase some group of pixels completely, leaving no trace
     behind of their previous contents, you should check the "Hard edge" box in
@@ -71,9 +93,7 @@
   </tip>
 
   <sect3>
-    <title>
-      <phrase>How to Activate</phrase>
-    </title>
+    <title>Activating the tool</title>
     <para>You can activate the Eraser tool in several ways :</para>
     <itemizedlist>
       <listitem>
@@ -89,7 +109,9 @@
       <listitem>
         <para>
           from the Toolbox by clicking on the tool icon
-          <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/stock-tool-eraser-22.png"/></imageobject></inlinemediaobject></guiicon>;
+          <guiicon><inlinegraphic
+            fileref="images/toolbox/stock-tool-eraser-22.png"/>
+          </guiicon>;
         </para>
       </listitem>
       <listitem>
@@ -102,9 +124,7 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers</phrase>
-    </title>
+    <title>Key modifiers</title>
     <para>
       See the <xref linkend="gimp-tool-brush"/> for a description of key
       modifiers that have the same effect on all brush tools.
@@ -146,13 +166,9 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Tool Options</phrase>
-    </title>
+    <title>Tool Options</title>
     <figure>
-      <title>
-        <phrase>Tool Options for the Eraser tool</phrase>
-      </title>
+      <title>Tool Options for the Eraser tool</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/tool-options-eraser.png" format="PNG"/>
@@ -165,8 +181,8 @@
     <variablelist>
       <varlistentry>
         <term>
-          Brush; Pressure sensitivity; Scale; Fade out; Incremental;
-          Hard edges
+          Mode; Opacity; Brush; Scale; Brush Dynamics; Fade Out; Apply
+          Jitter; Incremental
         </term>
         <listitem>
           <xi:include href="about-common-brush-options.xml"/>
@@ -184,6 +200,15 @@
         </listitem>
       </varlistentry>
       <varlistentry>
+        <term>Hard Edge</term>
+        <listitem>
+          <para>
+            This option avoids partial erasure at the edges of the
+            brush-stroke. See above.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
         <term>Anti Erase</term>
         <listitem>
           <para>

Modified: trunk/src/toolbox/tool-heal.xml
==============================================================================
--- trunk/src/toolbox/tool-heal.xml	(original)
+++ trunk/src/toolbox/tool-heal.xml	Wed Mar 18 20:11:18 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-03-16 j.h: reviewed for v2.6. No change
   2008-09-25 aprokoudine added 'ru'
   2008-04-17 JPL reviewed fr
   2007-11-12 KoSt: added 'no'
@@ -8,9 +9,7 @@
   2007-10-27 j.h: created
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-heal">
-  <title>
-    <phrase>Heal</phrase>
-  </title>
+  <title>Heal</title>
   <indexterm>
     <primary>Tools</primary>
     <secondary>Heal</secondary>
@@ -20,9 +19,7 @@
   </indexterm>
 
   <figure>
-    <title>
-      <phrase>The <quote>Heal tool</quote> in the Toolbox</phrase>
-    </title>
+    <title>The <quote>Heal tool</quote> in the Toolbox</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/toolbox-heal.png" format="PNG"/>
@@ -50,9 +47,7 @@
   </para>
 
   <sect3>
-    <title>
-      <phrase>Activating the Tool</phrase>
-    </title>
+    <title>Activating the Tool</title>
     <para>
       There are different possibilities to activate the tool:
     </para>
@@ -89,9 +84,7 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers (Defaults)</phrase>
-    </title>
+    <title>Key modifiers (Defaults)</title>
     <variablelist>
       <varlistentry>
         <term>
@@ -129,13 +122,9 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase>Heal Tool options</phrase>
-      </title>
+      <title>Heal Tool options</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/tool-options-heal.png" format="PNG"/>
@@ -183,19 +172,13 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Healing is not cloning</phrase>
-    </title>
+    <title>Healing is not cloning</title>
     <para>
      Although the Heal tool has common features with the Clone tool on using,
      the result is quite different.
    </para>
-    <figure>
-      <title>
-        <phrase>
-         Comparing <quote>Clone</quote> and <quote>Heal</quote>
-       </phrase>
-      </title>
+   <figure>
+     <title>Comparing <quote>Clone</quote> and <quote>Heal</quote></title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/heal-compar.png" format="PNG"/>

Modified: trunk/src/toolbox/tool-ink.xml
==============================================================================
--- trunk/src/toolbox/tool-ink.xml	(original)
+++ trunk/src/toolbox/tool-ink.xml	Wed Mar 18 20:11:18 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-03-16 j.h: reviwed for v2.6. No change
   2008-04-07 JPL reviewed fr
   2007-10-21 lexa: reviewed de for GIMP 2.4
   2007-06-17 kost: added norwegian
@@ -11,9 +12,7 @@
   050522 de reviewed by axel.wernicke
   -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-ink">
-  <title>
-    <phrase>Ink</phrase>
-  </title>
+  <title>Ink</title>
   <indexterm>
     <primary>Tools</primary>
     <secondary>Ink</secondary>
@@ -23,11 +22,7 @@
   </indexterm>
 
   <figure>
-    <title>
-      <phrase>
-        The <quote>Ink</quote> tool in Toolbox
-      </phrase>
-    </title>
+    <title>The <quote>Ink</quote> tool in Toolbox</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/toolbox-pen.png" format="PNG"/>
@@ -42,9 +37,7 @@
   </para>
 
   <sect3>
-    <title>
-      <phrase>Activate the Tool</phrase>
-    </title>
+    <title>Activating the Tool</title>
     <para>You can find the Ink tool in several ways :</para>
     <itemizedlist>
       <listitem>
@@ -60,32 +53,28 @@
       <listitem>
         <para>
           By clicking on the tool icon:
-          <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/stock-tool-ink-22.png"/></imageobject></inlinemediaobject></guiicon> in Toolbox.
+          <guiicon><inlinegraphic
+            fileref="images/toolbox/stock-tool-ink-22.png"/>
+          </guiicon> in Toolbox,
         </para>
       </listitem>
       <listitem>
         <para>
-          By using the <keycap>K</keycap> keyboard shortcut.
+          or by using the <keycap>K</keycap> keyboard shortcut.
         </para>
       </listitem>
     </itemizedlist>
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers (Defaults)</phrase>
-    </title>
+    <title>Key modifiers (Defaults)</title>
     <para>This tool has no special modifier keys.</para>
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase>Ink Tool options</phrase>
-      </title>
+      <title>Ink Tool options</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/tool-options-ink.png" format="PNG"/>

Modified: trunk/src/toolbox/tool-paintbrush.xml
==============================================================================
--- trunk/src/toolbox/tool-paintbrush.xml	(original)
+++ trunk/src/toolbox/tool-paintbrush.xml	Wed Mar 18 20:11:18 2009
@@ -7,9 +7,7 @@
      2007-06-17 kost: added norwegian
      -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-paintbrush">
-  <title>
-    <phrase>Paintbrush</phrase>
-  </title>
+  <title>Paintbrush</title>
   <indexterm>
     <primary>Tools</primary>
     <secondary>Paintbrush</secondary>
@@ -19,9 +17,7 @@
   </indexterm>
 
   <figure>
-    <title>
-      <phrase>Paintbrush</phrase>
-    </title>
+    <title>Paintbrush</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/toolbox-brush.png" format="PNG"/>
@@ -35,9 +31,7 @@
   </para>
 
   <sect3>
-    <title>
-      <phrase>Activating the Tool</phrase>
-    </title>
+    <title>Activating the Tool</title>
     <itemizedlist>
       <listitem>
         <para>
@@ -53,7 +47,9 @@
       <listitem>
         <para>
           The Tool can also be called by clicking the tool icon:
-          <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/stock-tool-paintbrush-22.png"/></imageobject></inlinemediaobject></guiicon>
+          <guiicon><inlinegraphic
+            fileref="images/toolbox/stock-tool-paintbrush-22.png"/>
+          </guiicon>
         </para>
       </listitem>
       <listitem>
@@ -65,9 +61,7 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers (Defaults)</phrase>
-    </title>
+    <title>Key modifiers (Defaults)</title>
     <variablelist>
       <varlistentry>
         <term>
@@ -98,13 +92,9 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase>Paintbrush tool options</phrase>
-      </title>
+      <title>Paintbrush tool options</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/tool-options-paintbrush.png" format="PNG"/>
@@ -117,8 +107,8 @@
     <variablelist>
       <varlistentry>
         <term>
-          Mode; Opacity; Brush; Scale; Pressure Sensibility; Fade Out; Apply
-          Jitter; use Color from Gradient
+          Mode; Opacity; Brush; Scale; Brush Dynamics; Fade Out; Apply
+          Jitter; Incremental; Use Color from Gradient
         </term>
         <listitem>
           <xi:include href="about-common-brush-options.xml"/>

Modified: trunk/src/toolbox/tool-pencil.xml
==============================================================================
--- trunk/src/toolbox/tool-pencil.xml	(original)
+++ trunk/src/toolbox/tool-pencil.xml	Wed Mar 18 20:11:18 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-03-16 j.h Reviewed for v2.6
      2008-04-07 JPL reviewed fr
      2008-03-21 Mr.Dust : added korean contents
      2008-25-01  PP reviewed for v2.4 ; options rebuilt
@@ -9,9 +10,7 @@
      2007-01-06 lexa: enhanced docbook compliance
      -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-pencil">
-  <title>
-    <phrase>Pencil</phrase>
-  </title>
+  <title>Pencil</title>
   <indexterm>
     <primary>Tools</primary>
     <secondary>Pencil</secondary>
@@ -21,9 +20,7 @@
   </indexterm>
 
   <figure>
-    <title>
-      <phrase>Pencil tool</phrase>
-    </title>
+    <title>Pencil tool</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/toolbox-pencil.png" format="PNG"/>
@@ -55,9 +52,7 @@
   </tip>
 
   <sect3>
-    <title>
-      <phrase>Activating the Tool</phrase>
-    </title>
+    <title>Activating the Tool</title>
     <itemizedlist>
       <listitem>
         <para>
@@ -73,7 +68,9 @@
       <listitem>
         <para>
           The Tool can also be called by clicking the tool icon:
-          <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/stock-tool-pencil-22.png"/></imageobject></inlinemediaobject></guiicon>
+          <guiicon><inlinegraphic
+            fileref="images/toolbox/stock-tool-pencil-22.png"/>
+          </guiicon>
         </para>
       </listitem>
       <listitem>
@@ -85,9 +82,7 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers (Defaults)</phrase>
-    </title>
+    <title>Key modifiers (Defaults)</title>
     <variablelist>
       <varlistentry>
         <term>
@@ -118,13 +113,9 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Pencil</quote> Tool options</phrase>
-      </title>
+      <title><quote>Pencil</quote> Tool options</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/tool-options-pencil.png" format="PNG"/>
@@ -137,8 +128,8 @@
     <variablelist>
       <varlistentry>
         <term>
-          Mode; Opacity; Brush; Scale, Pressure Sensibility; Fade Out; Apply
-          Jitter, Use Color from Gradient
+          Mode; Opacity; Brush; Scale; Brush Dynamics; Fade Out; Apply
+          Jitter; Incremental; Use Color from Gradient
         </term>
         <listitem>
           <xi:include href="about-common-brush-options.xml"/>

Modified: trunk/src/toolbox/tool-perspective-clone.xml
==============================================================================
--- trunk/src/toolbox/tool-perspective-clone.xml	(original)
+++ trunk/src/toolbox/tool-perspective-clone.xml	Wed Mar 18 20:11:18 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-03-17 j.h: reviewed for v2.6. No change
   2008-09-25 aprokoudine added 'ru'
   2008-04-17 JPL reviewed fr
   2007-11-12 KoSt: added 'no'
@@ -8,9 +9,7 @@
   2007-11-01 j.h: created
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-perspective-clone">
-  <title>
-    <phrase>Perspective Clone</phrase>
-  </title>
+  <title>Perspective Clone</title>
   <indexterm>
     <primary>Tools</primary>
     <secondary>Perspective Clone</secondary>
@@ -20,11 +19,7 @@
   </indexterm>
 
   <figure>
-    <title>
-      <phrase>
-        The <quote>Perspective Clone</quote> tool in the Toolbox
-      </phrase>
-    </title>
+    <title>The <quote>Perspective Clone</quote> tool in the Toolbox</title>
     <mediaobject>
       <imageobject>
         <imagedata format="PNG"
@@ -42,9 +37,7 @@
   </para>
 
   <sect3>
-    <title>
-      <phrase>Activating the Tool</phrase>
-    </title>
+    <title>Activating the Tool</title>
     <para>
       There are different possibilities to activate the tool:
     </para>
@@ -56,7 +49,7 @@
             <guimenu>Tools</guimenu>
             <guisubmenu>Paint tools</guisubmenu>
             <guimenuitem>Perspective Clone</guimenuitem>
-          </menuchoice>,
+          </menuchoice>.
         </para>
       </listitem>
       <listitem>
@@ -76,9 +69,7 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers (Defaults)</phrase>
-    </title>
+    <title>Key modifiers (Defaults)</title>
     <variablelist>
       <varlistentry>
         <term>
@@ -108,13 +99,9 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase>Perspective Clone tool options</phrase>
-      </title>
+      <title>Perspective Clone tool options</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/perspective-clone-options.png" format="PNG"/>
@@ -143,7 +130,7 @@
       <varlistentry>
         <term>
           Mode, Opacity, Brush, Scale, Brush Dynamics, Fade out, Apply Jitter,
-          Hard Edges
+          Hard Edge
         </term>
         <listitem>
           <xi:include href="about-common-brush-options.xml"/>
@@ -164,13 +151,9 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Example</phrase>
-    </title>
+    <title>Example</title>
     <figure>
-      <title>
-        <phrase><quote>Perspective Clone</quote> example</phrase>
-      </title>
+      <title><quote>Perspective Clone</quote> example</title>
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"

Modified: trunk/src/toolbox/tool-perspective.xml
==============================================================================
--- trunk/src/toolbox/tool-perspective.xml	(original)
+++ trunk/src/toolbox/tool-perspective.xml	Wed Mar 18 20:11:18 2009
@@ -11,18 +11,7 @@
   050806 de reviewed by axel.wernicke
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-perspective">
-<!--  <sect2info>
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2008-01-13</date>
-        <authorinitials>j.h</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
-  <title>
-    <phrase>Perspective</phrase>
-  </title>
+  <title>Perspective</title>
   <indexterm>
     <primary>Tools</primary>
     <secondary>Perspective</secondary>
@@ -30,18 +19,16 @@
   <indexterm>
     <primary>Perspective</primary>
   </indexterm>
-  
+
   <figure>
-    <title>
-      <phrase>Perspective tool</phrase>
-    </title>
+    <title>Perspective tool</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/toolbox-perspective.png" format="PNG"/>
       </imageobject>
     </mediaobject>
   </figure>
-  <para><!--TODO es;it;pl-->
+  <para>
     The Perspective Tool is used to change the <quote>perspective</quote> of
     the active layer content, of a selection content or of a path. When you
     click on the image, according to the Preview type you have selected, a
@@ -53,18 +40,16 @@
     the center of the element, a circle lets you move the element by
     click-and-drag.
   </para>
-  
+
   <note>
     <para>
       This tool is not actually a perspective tool, as it doesn't impose
       perspective rules. It is better described as a distort tool.
     </para>
   </note>
-  
+
   <sect3>
-    <title>
-      <phrase>Activating the Tool</phrase>
-    </title>
+    <title>Activating the Tool</title>
     <para>
       You can access to the Perspective tool in different ways:
     </para>
@@ -80,7 +65,9 @@
       <listitem>
         <para>
           By clicking the tool icon:
-          <guiicon><inlinemediaobject><imageobject><imagedata fileref="images/toolbox/stock-tool-perspective-22.png"/></imageobject></inlinemediaobject></guiicon>
+          <guiicon><inlinegraphic
+            fileref="images/toolbox/stock-tool-perspective-22.png"/>
+          </guiicon>
           in Toolbox,
         </para>
       </listitem>
@@ -93,25 +80,20 @@
       </listitem>
     </itemizedlist>
   </sect3>
-  
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Perspective</quote> tool options
-        </phrase>
-      </title>
+      <title><quote>Perspective</quote> tool options</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/tool-options-perspective.png" format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>
-    
+
     <xi:include href="about-common-options-display.xml"/>
-    
+
     <variablelist>
       <varlistentry>
         <term>
@@ -123,7 +105,7 @@
       </varlistentry>
     </variablelist>
   </sect3>
-  
+
   <sect3>
     <title>
       <phrase>

Modified: trunk/src/toolbox/tool-smudge.xml
==============================================================================
--- trunk/src/toolbox/tool-smudge.xml	(original)
+++ trunk/src/toolbox/tool-smudge.xml	Wed Mar 18 20:11:18 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-03-18 j.h: reviewed for v2.6. No change ("scale" exists)
   2008-01-06 j.h: updated to v2.4. Ctrl key modifier added
   2007-06-17 kost: added norwegian
   2006-07-15 added es content by mq
@@ -10,9 +11,7 @@
   050523 de reviewed by axel.wernicke
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-smudge">
-  <title>
-    <phrase>Smudge</phrase>
-  </title>
+  <title>Smudge</title>
   <indexterm>
     <primary>Tools</primary>
     <secondary>Smudge</secondary>
@@ -22,9 +21,7 @@
   </indexterm>
 
   <figure>
-    <title>
-      <phrase>Smudge tool</phrase>
-    </title>
+    <title>Smudge tool</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/toolbox-smudge.png" format="PNG"/>
@@ -38,9 +35,7 @@
   </para>
 
   <sect3>
-    <title>
-      <phrase>Activating the Tool</phrase>
-    </title>
+    <title>Activating the Tool</title>
     <para>
       You can find the Smudge tool in various ways :
     </para>
@@ -65,7 +60,7 @@
                 fileref="images/toolbox/stock-tool-smudge-22.png"/>
               </imageobject></inlinemediaobject>
           </guiicon>
-          in Toolbox.
+          in Toolbox,
         </para>
       </listitem>
       <listitem>
@@ -77,9 +72,7 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Key modifiers (Defaults)</phrase>
-    </title>
+    <title>Key modifiers (Defaults)</title>
     <variablelist>
       <varlistentry>
         <term>
@@ -111,13 +104,9 @@
   </sect3>
 
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase>The Smudge tool in Toolbox</phrase>
-      </title>
+      <title>The Smudge tool in Toolbox</title>
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"

Modified: trunk/src/toolbox/tool-transform.xml
==============================================================================
--- trunk/src/toolbox/tool-transform.xml	(original)
+++ trunk/src/toolbox/tool-transform.xml	Wed Mar 18 20:11:18 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-03-17 j.h: updated to v2.6. Added Opacity
   2008-02-26 kost: updated 'no' v2.4
   2007-06-10 kost: added 'no'
   2007-05-06 fixed the description for "direction"
@@ -11,17 +12,13 @@
   0500606 de extracted general tool features by axel.wernicke
 -->
 <sect2 id="gimp-tool-transform">
-  <title>
-    <phrase>Common Features</phrase>
-  </title>
+  <title>Common Features</title>
   <indexterm>
     <primary>Tools</primary>
     <secondary>Transform Tools</secondary>
   </indexterm>
   <figure>
-    <title>
-      <phrase>An overview of the transform tools</phrase>
-    </title>
+    <title>An overview of the transform tools</title>
     <mediaobject>
       <imageobject>
         <imagedata fileref="images/toolbox/transform-tools.png" format="PNG"/>
@@ -39,9 +36,7 @@
       <phrase>Tool Options</phrase>
     </title>
     <figure>
-      <title>
-        <phrase>Common options of transform tools</phrase>
-      </title>
+      <title>Common options of transform tools</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/transform-tools-common-options.png" format="PNG"/>
@@ -155,14 +150,10 @@
           <para>You can choose between several ways to clip:</para>
           <variablelist>
             <varlistentry>
-              <term>
-                <phrase>Adjust</phrase>
-              </term>
+              <term>Adjust</term>
               <listitem>
                 <figure>
-                  <title>
-                    <phrase>Original image for examples</phrase>
-                  </title>
+                  <title>Original image for examples</title>
                   <mediaobject>
                     <imageobject>
                       <imagedata fileref="images/toolbox/clip-orig.png" format="PNG"/>
@@ -206,14 +197,10 @@
               </listitem>
             </varlistentry>
             <varlistentry>
-              <term>
-                <phrase>Clip</phrase>
-              </term>
+              <term>Clip</term>
               <listitem>
                 <figure>
-                  <title>
-                    <phrase>Example for Clip</phrase>
-                  </title>
+                  <title>Example for Clip</title>
                   <mediaobject>
                     <imageobject>
                       <imagedata fileref="images/toolbox/clip-crop.png" format="PNG"/>
@@ -229,14 +216,10 @@
               </listitem>
             </varlistentry>
             <varlistentry>
-              <term>
-                <phrase>Crop to result</phrase>
-              </term>
+              <term>Crop to result</term>
               <listitem>
                 <figure>
-                  <title>
-                    <phrase>Example for Crop to result</phrase>
-                  </title>
+                  <title>Example for Crop to result</title>
                   <mediaobject>
                     <imageobject>
                       <imagedata fileref="images/toolbox/clip-3.png" format="PNG"/>
@@ -254,14 +237,10 @@
               </listitem>
             </varlistentry>
             <varlistentry>
-              <term>
-                <phrase>Crop with aspect</phrase>
-              </term>
+              <term>Crop with aspect</term>
               <listitem>
                 <figure>
-                  <title>
-                    <phrase>Example for Crop with aspect</phrase>
-                  </title>
+                  <title>Example for Crop with aspect</title>
                   <mediaobject>
                     <imageobject>
                       <imagedata fileref="images/toolbox/clip-4.png" format="PNG"/>
@@ -292,51 +271,55 @@
           </para>
           <variablelist>
             <varlistentry>
-              <term>Outline</term>
-              <listitem>
-                <para>
-                  Puts a frame to mark the image outline, with a handle on
-                  each corner. Movements will affect this frame only on the
-                  Preview, but the result of the transformation will concern
-                  either the content or the boundaries of the selection
-                  according to the selected Affect mode.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Grid</term>
+              <term>The drop-down list</term>
               <listitem>
                 <para>
-                  Puts a grid on the image, with four handles. Movements will
-                  affect this grid only on the Preview, but the result of the
-                  transformation will concern either the content or the
-                  boundaries of the selection according to the selected
-                  Transform mode.
+                  This list lets you select among four Preview possibilities:
                 </para>
+                <itemizedlist>
+                  <listitem>
+                    <para><guilabel>Outline</guilabel> :
+                      Puts a frame to mark the image outline, with a handle
+                      on each corner. Movements will affect this frame only
+                      on the Preview, but the result of the transformation
+                      will concern either the content or the boundaries of
+                      the selection according to the selected Affect mode.
+                    </para>
+                  </listitem>
+                  <listitem>
+                    <para><guilabel>Grid</guilabel> :
+                      Puts a grid on the image, with four handles. Movements
+                      will affect this grid only on the Preview, but the
+                      result of the transformation will concern either the
+                      content or the boundaries of the selection according to
+                      the selected Transform mode.
+                    </para>
+                  </listitem>
+                  <listitem>
+                    <para><guilabel>Image</guilabel> :
+                      Here, the preview is a copy of the image superimposed
+                      on the image, with an outline. Movements affect this
+                      copy and the underlying image appears.
+                    </para>
+                  </listitem>
+                  <listitem>
+                    <para><guilabel>Grid+Image</guilabel> :
+                      Both turn at the same time.
+                    </para>
+                  </listitem>
+                </itemizedlist>
               </listitem>
             </varlistentry>
             <varlistentry>
-              <term>Image</term>
+              <term>Opacity</term>
               <listitem>
                 <para>
-                  Here, the preview is a copy of the image superimposed on the
-                  image, with an outline. Movements affect this copy and the
-                  underlying image appears.
+                  This slider lets you set the preview opacity.
                 </para>
               </listitem>
             </varlistentry>
-            <varlistentry>
-              <term>Grid+Image</term>
-              <listitem>
-                <para>Both turn at the same time.</para>
-              </listitem>
-            </varlistentry>
           </variablelist>
           <para>
-            Preview is only for greater convenience. Whatever your choice,
-            result will be the same when you validate the transformation.
-          </para>
-          <para>
             Options with grid activate a drop-list with two options:
             <guilabel>Number of Grid Lines</guilabel> will allow control
             over the total number of displayed grid lines. Use the



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