[gimp-help] Updates in paint tools. Rename convolve.xml to blur-sharpen.xml. Fix issues #114, #96, #90.



commit eb969b649d451b4ef728600dada5cfb95d10a381
Author: Julien Hardelin <jhardlin orange fr>
Date:   Mon Oct 15 07:25:38 2018 +0200

    Updates in paint tools. Rename convolve.xml to blur-sharpen.xml. Fix issues #114, #96, #90.

 README                                             |   6 +-
 images/C/tool-options/brush-option-force-ex.png    | Bin 0 -> 1770 bytes
 images/C/tool-options/brush-option-hardness-ex.png | Bin 0 -> 1847 bytes
 images/C/tool-options/brush-option-spacing-ex.png  | Bin 0 -> 585 bytes
 images/C/toolbox/airbrush-dialog.png               | Bin 0 -> 34427 bytes
 images/C/toolbox/blur-sharpen-dialog.png           | Bin 0 -> 38766 bytes
 images/C/toolbox/brush-tools-box.png               | Bin 8790 -> 30643 bytes
 images/C/toolbox/brush-tools.png                   | Bin 32886 -> 0 bytes
 images/C/toolbox/clone-dialog.png                  | Bin 0 -> 37793 bytes
 images/C/toolbox/dodge-burn-dialog.png             | Bin 0 -> 42910 bytes
 images/C/toolbox/eraser-dialog.png                 | Bin 0 -> 26548 bytes
 images/C/toolbox/heal-dialog.png                   | Bin 0 -> 35419 bytes
 images/C/toolbox/paint-dynamics-tool-options.png   | Bin 5778 -> 0 bytes
 images/C/toolbox/paint-tools.png                   | Bin 0 -> 38366 bytes
 images/C/toolbox/paintbrush-dialog.png             | Bin 0 -> 26394 bytes
 images/C/toolbox/pencil-dialog.png                 | Bin 0 -> 26548 bytes
 images/C/toolbox/perspective-clone-dialog.png      | Bin 0 -> 41415 bytes
 images/C/toolbox/smudge-dialog.png                 | Bin 0 -> 37200 bytes
 images/C/toolbox/smudge-options.png                | Bin 42211 -> 0 bytes
 images/C/toolbox/tool-options-airbrush.png         | Bin 6569 -> 0 bytes
 images/C/toolbox/tool-options-blur-sharpen.png     | Bin 7130 -> 0 bytes
 images/C/toolbox/tool-options-brushcommon.png      | Bin 8543 -> 0 bytes
 images/C/toolbox/tool-options-clone.png            | Bin 7200 -> 0 bytes
 images/C/toolbox/tool-options-dodge.png            | Bin 7669 -> 0 bytes
 images/C/toolbox/tool-options-heal.png             | Bin 6438 -> 0 bytes
 images/C/toolbox/tool-options-paintbrush.png       | Bin 5998 -> 0 bytes
 images/C/toolbox/tool-options-pencil.png           | Bin 5985 -> 0 bytes
 .../C/toolbox/tool-options-perspective-clone.png   | Bin 8182 -> 0 bytes
 images/C/toolbox/toolbox-gradient.png              | Bin 21287 -> 21960 bytes
 images/C/toolbox/toolbox-tool-options.png          | Bin 7208 -> 0 bytes
 src/appendix/bibliography.xml                      |   4 +-
 src/gimp.xml                                       |  18 +-----
 src/toolbox/intro.xml                              |   5 +-
 src/toolbox/paint-tools.xml                        |   4 +-
 src/toolbox/paint/airbrush.xml                     |  12 +++-
 .../paint/{convolve.xml => blur-sharpen.xml}       |  20 ++++---
 src/toolbox/paint/clone.xml                        |  29 ++++++----
 src/toolbox/paint/common-features.xml              |  63 +++++++++++++++++----
 src/toolbox/paint/dodge-burn.xml                   |  17 +++---
 src/toolbox/paint/dynamics.xml                     |  30 +++-------
 src/toolbox/paint/eraser.xml                       |  22 ++-----
 src/toolbox/paint/gradient.xml                     |   2 +-
 src/toolbox/paint/heal.xml                         |  18 +++---
 src/toolbox/paint/paintbrush.xml                   |  10 ++--
 src/toolbox/paint/pencil.xml                       |  11 ++--
 src/toolbox/paint/perspective-clone.xml            |  17 +++---
 src/toolbox/paint/smudge.xml                       |   8 ++-
 src/toolbox/toolbox-color-area.xml                 |  13 -----
 48 files changed, 163 insertions(+), 146 deletions(-)
---
diff --git a/README b/README
index b16b03fdf..f67715aa7 100644
--- a/README
+++ b/README
@@ -6,7 +6,7 @@ GIMP-Help is a help system designed for use with the internal GIMP help
 browser, external web browser and HTML renderers, and human eyeballs. 
 Docbook is used to create a highly customizable system for all needs. 
 
-The current manual documents features for GIMP 2.8.
+The current manual documents features for GIMP 2.10.
 
 
 Project page and news
@@ -14,7 +14,7 @@ Project page and news
 
 Recent changes and updates about the modules are available at:
 
-  https://docs.gimp.org
+  https://www.gimp.org/docs/
 
 
 Tips for contribution
@@ -211,7 +211,7 @@ stop after the first few stable versions of GIMP 1.2 were released. This is
 due to several reasons, one of them being that all of the original
 documentation had been converted from HTML to DocBook/SGML and apart from a
 bit new content, lots of markup and proofreading not too much happened to
-the organisation of the complete mess.
+the organization of the complete mess.
 
 Daniel Egger and Mel Boyce were not too happy about the quirks with 
 this help system. So they started completely from scratch creating a new
diff --git a/images/C/tool-options/brush-option-force-ex.png b/images/C/tool-options/brush-option-force-ex.png
new file mode 100644
index 000000000..89fd4f250
Binary files /dev/null and b/images/C/tool-options/brush-option-force-ex.png differ
diff --git a/images/C/tool-options/brush-option-hardness-ex.png 
b/images/C/tool-options/brush-option-hardness-ex.png
new file mode 100644
index 000000000..5c127e34d
Binary files /dev/null and b/images/C/tool-options/brush-option-hardness-ex.png differ
diff --git a/images/C/tool-options/brush-option-spacing-ex.png 
b/images/C/tool-options/brush-option-spacing-ex.png
new file mode 100644
index 000000000..8db3ee1ae
Binary files /dev/null and b/images/C/tool-options/brush-option-spacing-ex.png differ
diff --git a/images/C/toolbox/airbrush-dialog.png b/images/C/toolbox/airbrush-dialog.png
new file mode 100644
index 000000000..4d1f204ee
Binary files /dev/null and b/images/C/toolbox/airbrush-dialog.png differ
diff --git a/images/C/toolbox/blur-sharpen-dialog.png b/images/C/toolbox/blur-sharpen-dialog.png
new file mode 100644
index 000000000..92ad41e55
Binary files /dev/null and b/images/C/toolbox/blur-sharpen-dialog.png differ
diff --git a/images/C/toolbox/brush-tools-box.png b/images/C/toolbox/brush-tools-box.png
index d9b703946..4ea2d1078 100644
Binary files a/images/C/toolbox/brush-tools-box.png and b/images/C/toolbox/brush-tools-box.png differ
diff --git a/images/C/toolbox/clone-dialog.png b/images/C/toolbox/clone-dialog.png
new file mode 100644
index 000000000..582555dda
Binary files /dev/null and b/images/C/toolbox/clone-dialog.png differ
diff --git a/images/C/toolbox/dodge-burn-dialog.png b/images/C/toolbox/dodge-burn-dialog.png
new file mode 100644
index 000000000..c8ec8d8d3
Binary files /dev/null and b/images/C/toolbox/dodge-burn-dialog.png differ
diff --git a/images/C/toolbox/eraser-dialog.png b/images/C/toolbox/eraser-dialog.png
new file mode 100644
index 000000000..26e9ba7d2
Binary files /dev/null and b/images/C/toolbox/eraser-dialog.png differ
diff --git a/images/C/toolbox/heal-dialog.png b/images/C/toolbox/heal-dialog.png
new file mode 100644
index 000000000..02504ebca
Binary files /dev/null and b/images/C/toolbox/heal-dialog.png differ
diff --git a/images/C/toolbox/paint-tools.png b/images/C/toolbox/paint-tools.png
new file mode 100644
index 000000000..eadbbb138
Binary files /dev/null and b/images/C/toolbox/paint-tools.png differ
diff --git a/images/C/toolbox/paintbrush-dialog.png b/images/C/toolbox/paintbrush-dialog.png
new file mode 100644
index 000000000..48d2749b1
Binary files /dev/null and b/images/C/toolbox/paintbrush-dialog.png differ
diff --git a/images/C/toolbox/pencil-dialog.png b/images/C/toolbox/pencil-dialog.png
new file mode 100644
index 000000000..2be249b5d
Binary files /dev/null and b/images/C/toolbox/pencil-dialog.png differ
diff --git a/images/C/toolbox/perspective-clone-dialog.png b/images/C/toolbox/perspective-clone-dialog.png
new file mode 100644
index 000000000..e2b5e8e9e
Binary files /dev/null and b/images/C/toolbox/perspective-clone-dialog.png differ
diff --git a/images/C/toolbox/smudge-dialog.png b/images/C/toolbox/smudge-dialog.png
new file mode 100644
index 000000000..c8220209f
Binary files /dev/null and b/images/C/toolbox/smudge-dialog.png differ
diff --git a/images/C/toolbox/toolbox-gradient.png b/images/C/toolbox/toolbox-gradient.png
index 035a86cda..e8cc50c73 100644
Binary files a/images/C/toolbox/toolbox-gradient.png and b/images/C/toolbox/toolbox-gradient.png differ
diff --git a/src/appendix/bibliography.xml b/src/appendix/bibliography.xml
index 5704095f8..52ee0cce1 100644
--- a/src/appendix/bibliography.xml
+++ b/src/appendix/bibliography.xml
@@ -352,8 +352,8 @@
       <abbrev>GIMP-DOCS</abbrev>
       <title>GIMP Documentation project page</title>
       <releaseinfo>
-        <ulink url="http://docs.gimp.org";>
-          http://docs.gimp.org
+        <ulink url="https://www.gimp.org/docs/";>
+          https://www.gimp.org/docs/
         </ulink>
       </releaseinfo>
     </biblioentry>
diff --git a/src/gimp.xml b/src/gimp.xml
index 26d8d0bdf..6ef17bf6c 100755
--- a/src/gimp.xml
+++ b/src/gimp.xml
@@ -26,23 +26,7 @@
     <title>GNU Image Manipulation Program</title>
     <subtitle>User Manual</subtitle>
     <copyright>
-      <year>2002</year>
-      <year>2003</year>
-      <year>2004</year>
-      <year>2005</year>
-      <year>2006</year>
-      <year>2007</year>
-      <year>2008</year>
-      <year>2009</year>
-      <year>2010</year>
-      <year>2011</year>
-      <year>2012</year>
-      <year>2013</year>
-      <year>2014</year>
-      <year>2015</year>
-      <year>2016</year>
-      <year>2017</year>
-      <year>2018</year>
+      <year>2002-2018</year>
       <holder>The GIMP Documentation Team</holder>
     </copyright>
     <legalnotice>
diff --git a/src/toolbox/intro.xml b/src/toolbox/intro.xml
index c33540290..4bdf924f3 100644
--- a/src/toolbox/intro.xml
+++ b/src/toolbox/intro.xml
@@ -38,7 +38,7 @@
     <para>
       <acronym>GIMP</acronym> has a diverse assortment of tools that let you
       perform a large variety of tasks. The tools can be thought of as falling
-      into five categories:
+      into four categories:
     </para>
     <itemizedlist>
       <listitem>
@@ -137,8 +137,7 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/toolbox/toolbox-tool-options.png"/>
-            <!--fileref="images/toolbox/tool-options-rectsel.png"/-->
+            fileref="images/toolbox/airbrush-dialog.png"/>
         </imageobject>
         <caption>
           <para>
diff --git a/src/toolbox/paint-tools.xml b/src/toolbox/paint-tools.xml
index 385ecf4f7..e8b0756a2 100644
--- a/src/toolbox/paint-tools.xml
+++ b/src/toolbox/paint-tools.xml
@@ -27,7 +27,7 @@
     <title>The Paint Tools (Tools menu)</title>
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/toolbox/brush-tools.png" format="PNG"/>
+        <imagedata fileref="images/toolbox/paint-tools.png" format="PNG"/>
       </imageobject>
     </mediaobject>
   </figure>
@@ -46,7 +46,7 @@
   <xi:include href="paint/clone.xml"/>
   <xi:include href="paint/heal.xml"/>
   <xi:include href="paint/perspective-clone.xml"/>
-  <xi:include href="paint/convolve.xml"/>
+  <xi:include href="paint/blur-sharpen.xml"/>
   <xi:include href="paint/smudge.xml"/>
   <xi:include href="paint/dodge-burn.xml"/>
 </sect1>
diff --git a/src/toolbox/paint/airbrush.xml b/src/toolbox/paint/airbrush.xml
index 5a13bf47d..57a16042b 100644
--- a/src/toolbox/paint/airbrush.xml
+++ b/src/toolbox/paint/airbrush.xml
@@ -102,7 +102,8 @@
       <title>Airbrush options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/tool-options-airbrush.png" format="PNG"/>
+          <imagedata fileref="images/toolbox/airbrush-dialog.png" 
+format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -112,11 +113,16 @@
     <variablelist>
       <varlistentry>
         <term>
-          Mode; Opacity; Brush; Size; Dynamics; Dynamic Options; Fade Options; 
-                                       Color Options; Apply Jitter
+          Mode; Opacity; Brush; Size; Aspect Ratio; Angle; Spacing; 
+          Hardness; Dynamics; Dynamics Options; Force;
+          Apply Jitter; Smooth Stroke; Lock brush size to view
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
+          <para>
+            <guilabel>Motion only</guilabel>: if this option is checked, the 
+            airbrush paints only when it moves.
+          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
diff --git a/src/toolbox/paint/convolve.xml b/src/toolbox/paint/blur-sharpen.xml
similarity index 92%
rename from src/toolbox/paint/convolve.xml
rename to src/toolbox/paint/blur-sharpen.xml
index a0f6aae4a..8ac747b9d 100644
--- a/src/toolbox/paint/convolve.xml
+++ b/src/toolbox/paint/blur-sharpen.xml
@@ -2,18 +2,15 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
+  2018-10-14 j.h: update to v2.10
   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
-  2006-07-11 es introduced by m.q
-  2006-04-30 added italian content by ciampix
+  2008-02-27 j.h updated to v2.4
   2005-12-07 replaced <simplesect> by <sect3> by lexa
   2005-12-01 informalfigure replaced by figure by lexa
-  050523 de reviewed by axel.wernicke
   -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-convolve">
   <title>Blur/Sharpen</title>
+  <!--This file was named convolve.xml-->
   <indexterm>
     <primary>Tools</primary>
     <secondary>Blur/Sharpen</secondary>
@@ -133,7 +130,7 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/toolbox/tool-options-blur-sharpen.png"/>
+            fileref="images/toolbox/blur-sharpen-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -143,11 +140,16 @@
     <variablelist>
       <varlistentry>
         <term>
-          Opacity; Brush; Dynamics; Dynamics Options; 
-                                       Apply Jitter; Hard Edges
+          Mode; Opacity; Brush; Size; Aspect Ratio; Angle; Spacing; 
+          Hardness; Dynamics; Dynamics Options; Force;
+          Apply Jitter; Smooth Stroke; Lock brush to view
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
+          <para>
+            <guilabel>Hard edge</guilabel>: this option gives a hard contour to 
+            the blurred/sharpened area.
+          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
diff --git a/src/toolbox/paint/clone.xml b/src/toolbox/paint/clone.xml
index eb8bef6d2..9af43cfcb 100644
--- a/src/toolbox/paint/clone.xml
+++ b/src/toolbox/paint/clone.xml
@@ -2,21 +2,15 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
+  2018-10-14 j.h: update to v2.10
   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'
   2008-01-18 ude: enhanced(?) align mode examples
-  2007-11-11 KoSt updated 'no' 2.4
-  2007-10-21 lexa: reviewed de for GIMP 2.4
-  2007-06-16 kost: added norwegian
   2007-05-23 Rebuilt Aligment section by j.h
-  2006-07-01 added es translation by m.q
-  2006-04-20 added it translation by ciampix
   2006-02-05 fr revised; shortcut modified in "en" by j.h
   2005-12-07 replaced <simplesect> by <sect3> by lexa
   2005-11-30 replaced informalfigure by figure by lexa
-  2005-05-23 de reviewed by axel.wernicke
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-clone">
   <title>Clone</title>
@@ -147,7 +141,7 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/toolbox/tool-options-clone.png"/>
+            fileref="images/toolbox/clone-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -166,11 +160,16 @@
     <variablelist>
       <varlistentry>
         <term>
-          Mode; Opacity; Brush; Dynamics; Dynamics Options; 
-                                       Fade Options; Apply Jitter; Smooth Stroke; Hard Edge
+          Mode; Opacity; Brush; Size; Aspect Ratio; Angle; Spacing; 
+          Hardness; Dynamics; Dynamics Options; Force;
+          Apply Jitter; Smooth Stroke; Lock brush to view
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
+          <para>
+            <guilabel>Hard edge</guilabel>: this option gives a hard contour to 
+            the cloned area.
+          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
@@ -216,6 +215,16 @@
                 </para>
               </listitem>
             </varlistentry>
+            <varlistentry>
+              <term>Sample merged</term>
+              <listitem>
+                <para>
+                  If this option is not checked (default), Clone tool samples 
+                  from the active layer. If this option is checked, Clone tool 
+                  samples from all layers.
+                </para>
+              </listitem>
+            </varlistentry>
           </variablelist>
         </listitem>
       </varlistentry>
diff --git a/src/toolbox/paint/common-features.xml b/src/toolbox/paint/common-features.xml
index 6eead20c3..46f22960d 100644
--- a/src/toolbox/paint/common-features.xml
+++ b/src/toolbox/paint/common-features.xml
@@ -50,12 +50,18 @@
       </para>
     </listitem>
   </itemizedlist>
+  
+  <para>
+    and <link linkend="gimp-tool-mypaint-brush">MyPaint brushes</link>, a new 
+    feature in Gimp-2.10.6,
+  </para>
 
   <para>
     behave like the intuitive notion of <quote>painting</quote> with a brush.
     Pencil, Paintbrush, and Airbrush are called <quote>basic painting
     tools</quote> or <link linkend="gimp-tools-brush">brush&nbsp;tools</link>.
   </para>
+
   <para>
     The other tools use a brush to modify an image in some way rather than
     paint on it:
@@ -209,7 +215,7 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/toolbox/tool-options-brushcommon.png"/>
+            fileref="images/toolbox/paintbrush-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -329,8 +335,22 @@
         <term>Spacing</term>
         <listitem>
           <para>
-            TODO
+            This option sets the distance between the brush marks in a stroke. 
           </para>
+          <figure>
+            <title>Spacing option</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/tool-options/brush-option-spacing-ex.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Different spacings
+                </para>
+              </caption>
+            </mediaobject>
+          </figure>
         </listitem>
       </varlistentry>
       
@@ -338,8 +358,22 @@
         <term>Hardness</term>
         <listitem>
           <para>
-            TODO
+            Modifies the size of the brush hard center.
           </para>
+          <figure>
+            <title>Hardness option</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/tool-options/brush-option-hardness-ex.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  On the left: hardness=50  On the right: hardness=100.
+                </para>
+              </caption>
+            </mediaobject>
+          </figure>
         </listitem>
       </varlistentry>
       
@@ -347,23 +381,28 @@
         <term>Force</term>
         <listitem>
           <para>
-            TODO
+            Modifies gain.
           </para>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry id="gimp-tool-brush-dynamics" xreflabel="Brush Dynamics">
-        <term>Dynamics</term>
-        <listitem>
           <figure>
-            <title>The Brush Dynamics in the Tool Options Dialog </title>
+            <title>Force option</title>
             <mediaobject>
               <imageobject>
                 <imagedata format="PNG"
-                  fileref="images/toolbox/paint-dynamics-tool-options.png"/>
+                  fileref="images/tool-options/brush-option-force-ex.png"/>
               </imageobject>
+              <caption>
+                <para>
+                  Force is 10%, 20%, 40%, 80%.
+                </para>
+              </caption>
             </mediaobject>
           </figure>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="gimp-tool-brush-dynamics" xreflabel="Brush Dynamics">
+        <term>Dynamics</term>
+        <listitem>
           <para>
             Brush dynamics let you map different brush parameters to several 
             input dynamics. They are mostly used with graphic tablets, but 
diff --git a/src/toolbox/paint/dodge-burn.xml b/src/toolbox/paint/dodge-burn.xml
index 7b125b2a1..c2f3134cc 100644
--- a/src/toolbox/paint/dodge-burn.xml
+++ b/src/toolbox/paint/dodge-burn.xml
@@ -1,13 +1,10 @@
 <?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:
+  2018-10-14 j.h: update to v2.10
   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
   2005-12-07 replaced <simplesect> by <sect3> by lexa
   2005-12-01 informalfigure replaced by figure by lexa
-  050523 de reviewed by axel.wernicke
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-dodge-burn">
   <title>Dodge/Burn</title>
@@ -106,7 +103,8 @@
       <title><quote>Dodge/Burn</quote> tool options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/tool-options-dodge.png" format="PNG"/>
+          <imagedata fileref="images/toolbox/dodge-burn-dialog.png" 
+format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -116,11 +114,16 @@
     <variablelist>
       <varlistentry>
         <term>
-          Opacity; Brush; Dynamics; Size; Aspect Ratio; Angle; Dynamics Options; 
-                                       Apply Jitter; Smooth stroke; Hard Edge
+          Mode; Opacity; Brush; Size; Aspect Ratio; Angle; Spacing; 
+          Hardness; Dynamics; Dynamics Options; Force;
+          Apply Jitter; Smooth Stroke; Lock brush to view
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
+          <para>
+            <guilabel>Hard edge</guilabel>: this option gives a hard contour to 
+            the treated area.
+          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
diff --git a/src/toolbox/paint/dynamics.xml b/src/toolbox/paint/dynamics.xml
index 38bf8b629..82c7f7e87 100755
--- a/src/toolbox/paint/dynamics.xml
+++ b/src/toolbox/paint/dynamics.xml
@@ -29,27 +29,15 @@
     like the physical (<quote>real</quote>) tools.
   </para>
 
-  <figure>
-    <title>Dynamics in Tool Options </title>
-    <mediaobject>
-      <imageobject>
-        <imagedata fileref="images/toolbox/paint-dynamics-tool-options.png"
-        format="PNG"/>
-      </imageobject>
-      <caption>
-        <para>The Dynamics in Tool Options Dialog</para>
-      </caption>
-    </mediaobject>
-    <mediaobject>
-      <imageobject>
-        <imagedata fileref="images/toolbox/paint-dynamics-list.png"
-        format="PNG"/>
-      </imageobject>
-      <caption>
-        <para>The Dynamics Preset List</para>
-      </caption>
-    </mediaobject>
-  </figure>
+  <mediaobject>
+    <imageobject>
+      <imagedata fileref="images/toolbox/paint-dynamics-list.png"
+      format="PNG"/>
+    </imageobject>
+    <caption>
+      <para>The Dynamics Preset List</para>
+    </caption>
+  </mediaobject>
 
   <para>
     The Dynamics area in the Tool Option dialog shows from left to right, the
diff --git a/src/toolbox/paint/eraser.xml b/src/toolbox/paint/eraser.xml
index 47d932885..1cfaa6630 100644
--- a/src/toolbox/paint/eraser.xml
+++ b/src/toolbox/paint/eraser.xml
@@ -2,17 +2,13 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
+  2018-10-12 j.h Update to v2.10
   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
   2007-10-07 lexa: reviewed de for GIMP 2.4
-  2007-06-18 kost: added norwegian
   2007-02-10 lexA: fixed bug #396404 for en and de
-  2006-06-04 changed first para, added para in anti-erase, en;fr by j.h
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  2005-12-01 informalfigure replaced by figure by lexa
-  2005-05-21 de reviewed by axel.wernicke
+
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-eraser">
   <title>Eraser</title>
@@ -174,7 +170,7 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/toolbox/tool-options-eraser.png"/>
+            fileref="images/toolbox/eraser-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -184,7 +180,9 @@
     <variablelist>
       <varlistentry>
         <term>
-          Brush; Size; Brush Dynamics; Dynamic Options; Apply Jitter; Incremental
+          Opacity; Brush; Size; Aspect Ratio; Angle; Spacing; 
+          Hardness; Dynamics; Dynamics Options; Force;
+          Apply Jitter; Smooth Stroke; Lock brush size to view; Incremental
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
@@ -232,14 +230,6 @@
               still there, you simply can't see it. Anti-erasing increases the
               alpha value so that you can see the RGB data once again.
             </para>
-            <!--TODO: CHECK: I can't reproduce it and it doesn't make
-                any sense to me - ude, 2009-05-03
-            <para>
-              An annoying feature: on a layer you have created with a
-              transparent background, using anti-erasing on non-painted areas
-              paints with black!
-            </para>
-            -->
           </note>
         </listitem>
       </varlistentry>
diff --git a/src/toolbox/paint/gradient.xml b/src/toolbox/paint/gradient.xml
index f5c1707e2..855148bd2 100644
--- a/src/toolbox/paint/gradient.xml
+++ b/src/toolbox/paint/gradient.xml
@@ -94,7 +94,7 @@ you
       </listitem>
       <listitem>
         <para>
-          By clicking on the <keycap>L</keycap> keyboard shortcut.
+          By clicking on the <keycap>G</keycap> keyboard shortcut.
         </para>
       </listitem>
     </itemizedlist>
diff --git a/src/toolbox/paint/heal.xml b/src/toolbox/paint/heal.xml
index 5f80136d8..bd02a3909 100644
--- a/src/toolbox/paint/heal.xml
+++ b/src/toolbox/paint/heal.xml
@@ -2,11 +2,7 @@
 <!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'
-  2007-11-06 ude: added German translation
+  2018-10-14 j.h: update to v2.10
   2007-10-27 j.h: created
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-heal">
@@ -125,7 +121,8 @@
       <title>Heal Tool options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/tool-options-heal.png" format="PNG"/>
+          <imagedata fileref="images/toolbox/heal-dialog.png" 
+format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -135,11 +132,16 @@
     <variablelist>
       <varlistentry>
         <term>
-          Mode; Opacity; Brush; Dynamics; Dynamics Options; Apply Jitter; Smoot 
-                                       Stroke; Hard Edge
+          Mode; Opacity; Brush; Size; Aspect Ratio; Angle; Spacing; 
+          Hardness; Dynamics; Dynamics Options; Force;
+          Apply Jitter; Smooth Stroke; Lock brush to view
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
+          <para>
+            <guilabel>Hard edge</guilabel>: this option gives a hard contour to 
+            the healed area.
+          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
diff --git a/src/toolbox/paint/paintbrush.xml b/src/toolbox/paint/paintbrush.xml
index 22923ad4c..490309eb2 100644
--- a/src/toolbox/paint/paintbrush.xml
+++ b/src/toolbox/paint/paintbrush.xml
@@ -1,10 +1,10 @@
 <?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:
+     2018-10-12 j.h Update to v2.10
      2008-04-07 JPL reviewed fr
      2008-01-25  PP update to v2.4 ; options rebuilt
      2007-10-07 lexa: reviewed de for GIMP 2.4
-     2007-06-17 kost: added norwegian
      -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-paintbrush">
   <title>Paintbrush</title>
@@ -97,7 +97,8 @@
       <title>Paintbrush tool options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/tool-options-paintbrush.png" format="PNG"/>
+          <imagedata fileref="images/toolbox/paintbrush-dialog.png" 
+format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -107,8 +108,9 @@
     <variablelist>
       <varlistentry>
         <term>
-          Mode; Opacity; Brush; Dynamics; Dynamics Options; 
-                                       Apply Jitter; Smoot Stroke; Incremental:
+          Mode; Opacity; Brush; Size; Aspect Ratio; Angle; Spacing; 
+          Hardness; Dynamics; Dynamics Options; Force;
+          Apply Jitter; Smooth Stroke; Lock brush size to view; Incremental
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
diff --git a/src/toolbox/paint/pencil.xml b/src/toolbox/paint/pencil.xml
index ad3104a2e..411ac3a08 100644
--- a/src/toolbox/paint/pencil.xml
+++ b/src/toolbox/paint/pencil.xml
@@ -2,12 +2,10 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
+  2018-10-12 j.h: update to v2.10.6
   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
   2007-10-07 lexa: reviewed de for GIMP 2.4
-  2007-06-17 kost: added norwegian
   2007-01-06 lexa: enhanced docbook compliance
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-pencil">
@@ -118,7 +116,7 @@
       <title><quote>Pencil</quote> Tool options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/tool-options-pencil.png" format="PNG"/>
+          <imagedata fileref="images/toolbox/pencil-dialog.png" format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -128,8 +126,9 @@
     <variablelist>
       <varlistentry>
         <term>
-          Mode; Opacity; Brush; Dynamics; Dynamics Options; 
-                                       Apply Jitter; Smooth Stroke; Incremental
+          Mode; Opacity; Brush; Size; Aspect Ratio; Angle; Spacing; 
+          Hardness; Dynamics; Dynamics Options; Force;
+                                       Apply Jitter; Smooth Stroke; Lock brush size to view; Incremental
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
diff --git a/src/toolbox/paint/perspective-clone.xml b/src/toolbox/paint/perspective-clone.xml
index 88aa9089a..252223686 100644
--- a/src/toolbox/paint/perspective-clone.xml
+++ b/src/toolbox/paint/perspective-clone.xml
@@ -1,11 +1,8 @@
 <?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:
+  2018-10-14 j.h: update to v2.10
   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'
-  2007-11-06 ude: added German translation
   2007-11-01 j.h: created
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-perspective-clone">
@@ -101,7 +98,8 @@
       <title>Perspective Clone tool options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/tool-options-perspective-clone.png" format="PNG"/>
+          <imagedata fileref="images/toolbox/perspective-clone-dialog.png" 
+format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -124,11 +122,16 @@
       </varlistentry>
       <varlistentry>
         <term>
-          Mode; Opacity; Brush; Dynamics; Dynamics Options; Fade Options; 
-                                       Apply Jitter; Smooth Stroke; Hard Edge
+          Mode; Opacity; Brush; Size; Aspect Ratio; Angle; Spacing; 
+          Hardness; Dynamics; Dynamics Options; Force;
+          Apply Jitter; Smooth Stroke; Lock brush to view
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
+          <para>
+            <guilabel>Hard edge</guilabel>: this option gives a hard contour to 
+            the cloned area.
+          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
diff --git a/src/toolbox/paint/smudge.xml b/src/toolbox/paint/smudge.xml
index 2742a90aa..d6ad57741 100644
--- a/src/toolbox/paint/smudge.xml
+++ b/src/toolbox/paint/smudge.xml
@@ -132,7 +132,7 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-                     fileref="images/toolbox/smudge-options.png"/>
+                     fileref="images/toolbox/smudge-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -144,10 +144,14 @@
         <term>
           Opacity; Brush; Size; Aspect ratio; Angle; Spacing; 
           Hardness; Force; Dynamics; Dynamics Options;  
-                                       Apply Jitter; Smooth stroke; Lock brush size to zoom; Hard edge
+                                       Apply Jitter; Smooth stroke; Lock brush to zoom
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
+          <para>
+            <guilabel>Hard edge</guilabel>: this option gives a hard contour to 
+            the smudged area.
+          </para>
         </listitem>
       </varlistentry>
       
diff --git a/src/toolbox/toolbox-color-area.xml b/src/toolbox/toolbox-color-area.xml
index 81d1a57a5..dd287bf94 100644
--- a/src/toolbox/toolbox-color-area.xml
+++ b/src/toolbox/toolbox-color-area.xml
@@ -154,18 +154,5 @@
       </para></footnote>
       file manager to directly save the corresponding image.
     </para>
-<!--
-      file manager to directly save the corresponding image; this opens a
-      dialog where you can enter a name for the image:
-    </para>
-    <figure>
-      <title>A Direct Save Protocol (XDS) dialog</title>
-      <mediaobject>
-        <imageobject>
-          <imagedata fileref="images/toolbox/XDS.png" format="PNG"/>
-        </imageobject>
-      </mediaobject>
-    </figure>
--->
   </sect3>
 </sect2>


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