[gimp-help-2] New section: dynamics.xml. Updated toolbox/paint



commit 7ba760ac581fd0b2bf9f5c3a0ce067ebfb3827e7
Author: kolbjoern <kolbjoern git gnome org>
Date:   Mon Oct 22 21:42:54 2012 +0200

    New section: dynamics.xml. Updated toolbox/paint

 images/C/toolbox/dynamics-options.png              |  Bin 0 -> 5821 bytes
 images/C/toolbox/paint-dynamics-edit.png           |  Bin 0 -> 5677 bytes
 images/C/toolbox/paint-dynamics-options.png        |  Bin 0 -> 3952 bytes
 images/C/toolbox/paint-dynamics-select.png         |  Bin 0 -> 6746 bytes
 images/C/toolbox/paint-dynamics-tuning-color.png   |  Bin 0 -> 7456 bytes
 images/C/toolbox/paint-dynamics-tuning.png         |  Bin 0 -> 5895 bytes
 .../C/toolbox/stock-tool-folders-dynamics-22.png   |  Bin 0 -> 997 bytes
 images/C/toolbox/tool-options-airbrush.png         |  Bin 25497 -> 6569 bytes
 images/C/toolbox/tool-options-blur-sharpen.png     |  Bin 21283 -> 7130 bytes
 images/C/toolbox/tool-options-brushcommon.png      |  Bin 11247 -> 8543 bytes
 images/C/toolbox/tool-options-clone.png            |  Bin 22613 -> 7200 bytes
 images/C/toolbox/tool-options-dodge.png            |  Bin 24207 -> 7669 bytes
 images/C/toolbox/tool-options-eraser.png           |  Bin 19989 -> 6377 bytes
 images/C/toolbox/tool-options-heal.png             |  Bin 19900 -> 6438 bytes
 images/C/toolbox/tool-options-ink.png              |  Bin 13767 -> 5392 bytes
 images/C/toolbox/tool-options-paintbrush.png       |  Bin 23189 -> 5998 bytes
 images/C/toolbox/tool-options-pencil.png           |  Bin 23712 -> 5985 bytes
 .../C/toolbox/tool-options-perspective-clone.png   |  Bin 0 -> 8182 bytes
 images/C/toolbox/tool-options-smudge.png           |  Bin 18677 -> 6409 bytes
 src/toolbox/paint-tools.xml                        |    1 +
 src/toolbox/paint/airbrush.xml                     |    6 +-
 src/toolbox/paint/clone.xml                        |   15 +-
 src/toolbox/paint/common-features.xml              |  337 +++--------
 src/toolbox/paint/convolve.xml                     |    4 +-
 src/toolbox/paint/dodge-burn.xml                   |    4 +-
 src/toolbox/paint/dynamics.xml                     |  679 ++++++++++++++++++++
 src/toolbox/paint/eraser.xml                       |   10 +-
 src/toolbox/paint/heal.xml                         |    4 +-
 src/toolbox/paint/paintbrush.xml                   |    4 +-
 src/toolbox/paint/pencil.xml                       |    4 +-
 src/toolbox/paint/perspective-clone.xml            |    6 +-
 src/toolbox/paint/smudge.xml                       |    4 +-
 32 files changed, 793 insertions(+), 285 deletions(-)
---
diff --git a/images/C/toolbox/dynamics-options.png b/images/C/toolbox/dynamics-options.png
new file mode 100755
index 0000000..2354ff2
Binary files /dev/null and b/images/C/toolbox/dynamics-options.png differ
diff --git a/images/C/toolbox/paint-dynamics-edit.png b/images/C/toolbox/paint-dynamics-edit.png
new file mode 100755
index 0000000..6dac3e5
Binary files /dev/null and b/images/C/toolbox/paint-dynamics-edit.png differ
diff --git a/images/C/toolbox/paint-dynamics-options.png b/images/C/toolbox/paint-dynamics-options.png
new file mode 100755
index 0000000..2675b2b
Binary files /dev/null and b/images/C/toolbox/paint-dynamics-options.png differ
diff --git a/images/C/toolbox/paint-dynamics-select.png b/images/C/toolbox/paint-dynamics-select.png
new file mode 100755
index 0000000..7f631c8
Binary files /dev/null and b/images/C/toolbox/paint-dynamics-select.png differ
diff --git a/images/C/toolbox/paint-dynamics-tuning-color.png b/images/C/toolbox/paint-dynamics-tuning-color.png
new file mode 100755
index 0000000..56058bf
Binary files /dev/null and b/images/C/toolbox/paint-dynamics-tuning-color.png differ
diff --git a/images/C/toolbox/paint-dynamics-tuning.png b/images/C/toolbox/paint-dynamics-tuning.png
new file mode 100755
index 0000000..03b7bfa
Binary files /dev/null and b/images/C/toolbox/paint-dynamics-tuning.png differ
diff --git a/images/C/toolbox/stock-tool-folders-dynamics-22.png b/images/C/toolbox/stock-tool-folders-dynamics-22.png
new file mode 100755
index 0000000..39e57ba
Binary files /dev/null and b/images/C/toolbox/stock-tool-folders-dynamics-22.png differ
diff --git a/images/C/toolbox/tool-options-airbrush.png b/images/C/toolbox/tool-options-airbrush.png
index f2dbffb..7fc1241 100644
Binary files a/images/C/toolbox/tool-options-airbrush.png and b/images/C/toolbox/tool-options-airbrush.png differ
diff --git a/images/C/toolbox/tool-options-blur-sharpen.png b/images/C/toolbox/tool-options-blur-sharpen.png
index f906ffe..575db92 100644
Binary files a/images/C/toolbox/tool-options-blur-sharpen.png and b/images/C/toolbox/tool-options-blur-sharpen.png differ
diff --git a/images/C/toolbox/tool-options-brushcommon.png b/images/C/toolbox/tool-options-brushcommon.png
index e64bfcf..2f296d5 100644
Binary files a/images/C/toolbox/tool-options-brushcommon.png and b/images/C/toolbox/tool-options-brushcommon.png differ
diff --git a/images/C/toolbox/tool-options-clone.png b/images/C/toolbox/tool-options-clone.png
index a9a9ba3..690a335 100644
Binary files a/images/C/toolbox/tool-options-clone.png and b/images/C/toolbox/tool-options-clone.png differ
diff --git a/images/C/toolbox/tool-options-dodge.png b/images/C/toolbox/tool-options-dodge.png
index 721d85c..a30b22d 100644
Binary files a/images/C/toolbox/tool-options-dodge.png and b/images/C/toolbox/tool-options-dodge.png differ
diff --git a/images/C/toolbox/tool-options-eraser.png b/images/C/toolbox/tool-options-eraser.png
index ebfd394..1f6518a 100644
Binary files a/images/C/toolbox/tool-options-eraser.png and b/images/C/toolbox/tool-options-eraser.png differ
diff --git a/images/C/toolbox/tool-options-heal.png b/images/C/toolbox/tool-options-heal.png
index 9a089b9..9388f7f 100644
Binary files a/images/C/toolbox/tool-options-heal.png and b/images/C/toolbox/tool-options-heal.png differ
diff --git a/images/C/toolbox/tool-options-ink.png b/images/C/toolbox/tool-options-ink.png
index a658ef2..927d009 100644
Binary files a/images/C/toolbox/tool-options-ink.png and b/images/C/toolbox/tool-options-ink.png differ
diff --git a/images/C/toolbox/tool-options-paintbrush.png b/images/C/toolbox/tool-options-paintbrush.png
index 30a5dae..cfc966c 100644
Binary files a/images/C/toolbox/tool-options-paintbrush.png and b/images/C/toolbox/tool-options-paintbrush.png differ
diff --git a/images/C/toolbox/tool-options-pencil.png b/images/C/toolbox/tool-options-pencil.png
index 7d74ffe..4618578 100644
Binary files a/images/C/toolbox/tool-options-pencil.png and b/images/C/toolbox/tool-options-pencil.png differ
diff --git a/images/C/toolbox/tool-options-perspective-clone.png b/images/C/toolbox/tool-options-perspective-clone.png
new file mode 100755
index 0000000..63b832e
Binary files /dev/null and b/images/C/toolbox/tool-options-perspective-clone.png differ
diff --git a/images/C/toolbox/tool-options-smudge.png b/images/C/toolbox/tool-options-smudge.png
index 9aa1f38..1cc03a7 100644
Binary files a/images/C/toolbox/tool-options-smudge.png and b/images/C/toolbox/tool-options-smudge.png differ
diff --git a/src/toolbox/paint-tools.xml b/src/toolbox/paint-tools.xml
index 0ebbe45..c555bc1 100644
--- a/src/toolbox/paint-tools.xml
+++ b/src/toolbox/paint-tools.xml
@@ -33,6 +33,7 @@
   </figure>
 
   <xi:include href="paint/common-features.xml"/>
+	<xi:include href="paint/dynamics.xml"/>
   <xi:include href="paint/brush-tools.xml"/>
   <xi:include href="paint/bucket-fill.xml"/>
   <xi:include href="paint/blend.xml"/>
diff --git a/src/toolbox/paint/airbrush.xml b/src/toolbox/paint/airbrush.xml
index 5c50b84..97a16ca 100644
--- a/src/toolbox/paint/airbrush.xml
+++ b/src/toolbox/paint/airbrush.xml
@@ -112,8 +112,8 @@
     <variablelist>
       <varlistentry>
         <term>
-          Mode; Opacity; Brush; Scale; Brush Dynamics; Fade out;
-          Apply Jitter; Use color from gradient
+          Mode; Opacity; Brush; Size; Dynamics; Dynamic Options; Fade Options; 
+					Color Options; Apply Jitter
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
@@ -131,7 +131,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Pressure</term>
+        <term>Flow</term>
         <listitem>
           <para>
             This slider controls the amount of color that the airbrush paints.
diff --git a/src/toolbox/paint/clone.xml b/src/toolbox/paint/clone.xml
index 980aa76..eb8bef6 100644
--- a/src/toolbox/paint/clone.xml
+++ b/src/toolbox/paint/clone.xml
@@ -41,12 +41,11 @@
   <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
-    digital photos, by <quote>painting over</quote> them with pixel data from
-    other areas.
-    This technique takes a while to learn, but in the hands of a skilled user
-    it is very powerful. Another important use is to draw patterned lines or
-    curves: see <link linkend="gimp-concepts-patterns">Patterns</link>
-    for examples.
+    digital photos, by <quote>painting over</quote> them with pixel data from 
+    other areas. This technique takes a while to learn, but in the hands of a 
+		skilled user it is very powerful. Another important use is to draw 
+		patterned lines or curves: see 
+		<link linkend="gimp-concepts-patterns">Patterns</link> for examples.
   </para>
   <para>
     If you want to clone from an image, instead of a pattern, you must tell
@@ -167,8 +166,8 @@
     <variablelist>
       <varlistentry>
         <term>
-          Mode; Opacity; Brush; Scale; Brush Dynamics; Fade out; Apply Jitter;
-          Hard Edges
+          Mode; Opacity; Brush; Dynamics; Dynamics Options; 
+					Fade Options; Apply Jitter; Smooth Stroke; Hard Edge
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
diff --git a/src/toolbox/paint/common-features.xml b/src/toolbox/paint/common-features.xml
index 15141d6..e4ed6b3 100644
--- a/src/toolbox/paint/common-features.xml
+++ b/src/toolbox/paint/common-features.xml
@@ -95,8 +95,8 @@
     </listitem>
     <listitem>
       <para>
-        the <link linkend="gimp-tool-perspective-clone">Perspective
-          Clone</link> tool copies into a changed perspective;
+        the <link linkend="gimp-tool-perspective-clone">Perspective 
+        Clone</link> tool copies into a changed perspective;
       </para>
     </listitem>
     <listitem>
@@ -224,10 +224,9 @@
     </figure>
 
     <para>
-      Many tool options are shared by several paint tools: these are described
-      here. Options that apply only to one specific
-      tool, or to a small number of tools, are described in the sections
-      devoted to those tools.
+      Many tool options are shared by several paint tools: these are described 
+      here. Options that apply only to one specific tool, or to a small number
+			of tools, are described in the sections devoted to those tools.
     </para>
     <variablelist id="gimp-tool-painting-modes" xreflabel="Painting Modes">
       <varlistentry>
@@ -271,12 +270,11 @@
             altering the active layer, the tool creates a transparent layer
             above the active layer and acts on that layer. Changing Opacity in
             the Tool Options has the same effect that changing opacity in the
-            Layers dialog would have in the latter situation. It controls the
-            <quote>strength</quote>
-            of all paint tools, not just those that paint on the active layer.
-            In the case of the Eraser, this can come across as a bit
-            confusing: it works out that the higher the <quote>opacity</quote>
-            is, the more transparency you get.
+            Layers dialog would have in the latter situation. It controls the 
+            <quote>strength</quote> of all paint tools, not just those that 
+						paint on the active layer. In the case of the Eraser, this can 
+						come across as a bit confusing: it works out that the higher the 
+						<quote>opacity</quote> is, the more transparency you get.
           </para>
         </listitem>
       </varlistentry>
@@ -300,128 +298,84 @@
       </varlistentry>
 
       <varlistentry>
-        <term>Scale</term>
+        <term>Size</term>
         <listitem>
           <para>
             This option lets you to modify precisely the size of the brush.
             You can use the arrow keys to vary by Â0.01 or the Page-Up and
-            Page-Down keys to vary by Â0.05. You can obtain the same result if
+            Page-Down keys to vary by Â1.00. You can obtain the same result if
             you have correctly set your mouse-wheel in the Preferences. See
             <link linkend="gimp-using-variable-size-brush">How to vary the
             size of a brush</link>
           </para>
         </listitem>
       </varlistentry>
+			
+      <varlistentry>
+        <term>Aspect Ratio</term>
+        <listitem>
+          <para>
+            This determines the ratio between the height and the width
+						of the brush. The slider is scaled from -20.00 to 20.00 with the 
+						default value set to 0.00. A negative value from 0.00 to -20 will 
+						narrow the height of the brush while a positive value between 0.00 
+						and 20.00 indicates the narrowing rate of the width of the brush.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>Angle</term>
+        <listitem>
+          <para>
+            TO DO
+          </para>
+        </listitem>
+      </varlistentry>			
 
       <varlistentry id="gimp-tool-brush-dynamics" xreflabel="Brush Dynamics">
-        <term>Brush Dynamics</term>
+        <term>Dynamics</term>
         <listitem>
           <figure>
-            <title>The Brush Dynamics check box. </title>
+            <title>The Brush Dynamics in the Tool Options Dialog </title>
             <mediaobject>
               <imageobject>
                 <imagedata format="PNG"
-                  fileref="images/toolbox/brush-dynamics.png"/>
+                  fileref="images/toolbox/paint-dynamics-options.png"/>
               </imageobject>
             </mediaobject>
           </figure>
           <para>
-            Brush dynamics let you map different brush parameters, commonly at
-            least size and opacity, to one or more of three input dynamics:
-            pressure, velocity and random. They are mostly used with tablets,
-            but Velocity and Random are also usable with a mouse. The
-            Ink tool, that supported velocity before, has been overhauled and
-            now handles velocity-dependent painting much better.
-          </para>
-          <para>
-            A new option has been added in stroking paths. Stoke Path and
-            Stroke Selection have now a check box for emulating brush
-            dynamics when you stroke using a paint tool. That means that when
-            you stoke, brush pressure and velocity are varying along the length
-            of the stroke. Pressure starts with zero, ramps up to full pressure
-            and then ramps down again to no pressure. Velocity starts from
-            zero and ramps up to full speed by the end of the stroke.
+            Brush dynamics let you map different brush parameters to several 
+						input dynamics. They are mostly used with tablets,
+            but some of them are also usable with a mouse.
           </para>
+					<para>
+						You may read more about dynamics in 
+						<link linkend="gimp-tool-dynamics">Dynamics</link>
+					</para>					
           <para>
-            The Pressure Sensitivity section is only meaningful if you are
-            using a tablet:  it allows you to decide which aspects of the
-            tool's action should be affected by how hard you press the stylus
-            against the tablet.  The possibilities are
-            <guilabel>opacity</guilabel>, <guilabel>hardness</guilabel>,
-            <guilabel>rate</guilabel>, <guilabel>size</guilabel>, and
-            <guilabel>color</guilabel>.  They  work together:  you can enable
-            as many of them as you like.
-            For each tool, only the ones that are meaningful are listed.
-            Here is what they do:
-          </para>
-          <variablelist>
-            <varlistentry>
-              <term>Opacity</term>
-              <listitem>
-                <para>
-                  The effect of this option is described above.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Hardness</term>
-              <listitem>
-                <para>
-                  This option applies to brushes with fuzzy edges. If it is
-                  enabled, the harder you press, the darker the fuzzy parts of
-                  the brush will appear.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Rate</term>
-              <listitem>
-                <para>
-                  This option applies to the Airbrush, Convolve tool, and
-                  Smudge tool, all of which have time-based effects. Pressing
-                  harder makes these tools act more rapidly.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Size</term>
-              <listitem>
-                <para>
-                  This option applies to all of the pressure sensitive paint
-                  tools. If the option is checked, then pressing harder will
-                  increase the size of the area affected by the brush.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Color</term>
-              <listitem>
-                <para>
-                  This option only applies to the brush tools: the Pencil,
-                  Paintbrush, and Airbrush; and only if you are using colors
-                  from a gradient. If these conditions are met, then pressing
-                  harder causes colors to be taken from higher in the
-                  gradient.
-                </para>
-              </listitem>
-            </varlistentry>
-          </variablelist>
+            When stroking paths and selections using a paint tool there is a an 
+						option to select <quote>Emulate brush dynamics</quote>. That means 
+						that when you stoke, brush pressure and velocity are varying along 
+						the length of the stroke. Pressure starts with zero, ramps up to 
+						full pressure and then ramps down again to no pressure. Velocity 
+						starts from zero and ramps up to full speed by the end of the  
+						stroke.
+          </para>          
         </listitem>
       </varlistentry>
 
       <varlistentry>
-        <term>Fade Out</term>
+        <term>Dynamics Options</term>
         <listitem>
-          <para>
-            This option causes each stroke to fade out over the specified
-            distance. It is easiest to visual for <quote>real</quote> painting
-            tools, and applies to all of the brush tools. It is equivalent to
-            gradually reducing the opacity along the trajectory of the stroke.
-            Note that, if you are using a tablet, this option does not change
-            the effects of brush pressure.
-          </para>
+					<para>
+						This belongs to the dynamics and is described in 
+						<link linkend="gimp-tool-dynamic-options">Dynamics Options</link>
+					</para>					        
         </listitem>
-      </varlistentry>
+      </varlistentry>			
+
       <varlistentry>
         <term>Apply Jitter</term>
         <listitem>
@@ -433,7 +387,7 @@
             made of successive brush marks which, when they are very near,
             seem to draw a continuous line. Here, instead of being aligned
             brush marks are scattered over a distance you can set with the
-            <guimenuitem>Quantity</guimenuitem> slider.
+            <guimenuitem>Amount</guimenuitem> slider.
           </para>
           <figure>
             <title><quote>Jitter</quote> example</title>
@@ -449,167 +403,42 @@
               </caption>
             </mediaobject>
           </figure>
+					<para>
+						Jitter is also available in the Paint Dynamic Editor where you may 
+						connect jitter to the behaviour of the brush.
+					</para>
         </listitem>
       </varlistentry>
-
+			
       <varlistentry>
-        <term>Incremental</term>
+        <term>Smooth Stroke</term>
         <listitem>
           <para>
-            The Incremental check-box activates incremental mode for the tool.
-            If it is deactivated, the maximum effect of a single stroke is
-            determined by the opacity, and moving the brush repeatedly over
-            the same spot will not increase the effect beyond this limit. If
-            Incremental is active, each additional pass with the brush will
-            increase the effect, but the opacity can't exceed the opacity set
-            for the tool. This option is available for all paint tools except
-            those which have a <quote>rate</quote>
-            control, which automatically implies an incremental effect. See
-            also <xref linkend="gimp-concepts-layer-modes"/>.
+            TO DO
           </para>
         </listitem>
-      </varlistentry>
+      </varlistentry>			
 
-      <varlistentry id="gimp-tool-painting-gradient">
-        <term>Color from Gradient</term>
+      <varlistentry>
+        <term>Incremental</term>
         <listitem>
-          <figure>
-            <title>Gradient options for painting tools. </title>
-            <mediaobject>
-              <imageobject>
-                <imagedata format="PNG"
-                  fileref="images/toolbox/tool-options-paint-gradient.png"/>
-              </imageobject>
-            </mediaobject>
-          </figure>
-          <para>
-            Instead of using the foreground color (as shown in the Color Area
-            of the Toolbox), by checking the "Use color from gradient" option
-            you can choose to paint with a gradient, giving colors that change
-            gradually along the brush trajectory. For basic information on
-            gradients, see the
-            <link linkend="gimp-concepts-gradients">Gradients</link> section.
-          </para>
           <para>
-            You have several options to control what gradient is used and how
-            it is laid out:
+            At least in my version of GIMP 2.8 the incremental check-box does 
+						not works quite as I expected. If it is deactivated (the default 
+						value) the maximum effect of a single stroke is determined by the 
+						opacity set in the opacity slider. If the opacity is set to less 
+						than 100, moving the brush over the same spot will increase the 
+						opacity if the brush is lifted in the meantime. Painting over with 
+						the same stroke has no such effect. If Incremental is active the 
+						brush will paint with full opacity independent of the slider 
+						setting. This option is available for all paint tools except those 
+						which have a <quote>rate</quote> control, which automatically 
+						implies an incremental effect. See 
+            also <xref linkend="gimp-concepts-layer-modes"/>.
           </para>
-          <variablelist>
-            <varlistentry>
-              <term>Gradient</term>
-              <listitem>
-                <para>
-                  Here you see a display of the current gradient. Clicking on
-                  it brings up a Gradient Selector, which will allow you to
-                  choose a different gradient.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Reverse</term>
-              <listitem>
-                <para>
-                  Normally a brushstroke starts with colors from the left side
-                  of the gradient, and progresses rightward. If
-                  the <quote>Reverse</quote>
-                  <guiicon>
-                    <inlinegraphic
-                      fileref="images/dialogs/stock-flip-horizontal-16.png"/>
-                  </guiicon>
-                  is checked, the stroke starts with colors from the right
-                  side, and progresses leftward.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Length</term>
-              <listitem>
-                <para>
-                  This option sets the distance corresponding to one complete
-                  cycle through the gradient colors. The default units are
-                  pixels, but you can choose a different unit from the
-                  adjoining Units menu.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Repeat</term>
-              <listitem>
-                <figure>
-                  <title>
-                    Illustration of the effects of the three gradient-repeat
-                    options, for the <quote>Abstract 2</quote> gradient.
-                  </title>
-                  <mediaobject>
-                    <imageobject>
-                      <imagedata format="PNG"
-                        fileref="images/tool-options/brush-gradient-normal.png"/>
-                    </imageobject>
-                    <caption>
-                      <para>Abstract2 Gradient</para>
-                    </caption>
-                  </mediaobject>
-                  <mediaobject>
-                    <imageobject>
-                      <imagedata format="PNG"
-                        fileref="images/tool-options/brush-gradient-none.png"/>
-                    </imageobject>
-                    <caption>
-                      <para>None</para>
-                    </caption>
-                  </mediaobject>
-                  <mediaobject>
-                    <imageobject>
-                      <imagedata format="PNG"
-                        fileref="images/tool-options/brush-gradient-sawtooth.png"/>
-                    </imageobject>
-                    <caption>
-                      <para>Sawtooth</para>
-                    </caption>
-                  </mediaobject>
-                  <mediaobject>
-                    <imageobject>
-                      <imagedata format="PNG"
-                        fileref="images/tool-options/brush-gradient-triangular.png"/>
-                    </imageobject>
-                    <caption>
-                      <para>Triangular</para>
-                    </caption>
-                  </mediaobject>
-                </figure>
-                <para>
-                  This option determines what happens if a brushstroke extends
-                  farther than the Length specified above. There are three
-                  possibilities:
-                </para>
-                <itemizedlist>
-                  <listitem>
-                    <para>
-                      <guilabel>None</guilabel> means that the color from the end of
-                      the gradient will be used throughout the remainder of the
-                      stroke;
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para>
-                      <guilabel>Sawtooth wave</guilabel> means that the
-                      gradient will be restarted from the beginning, which
-                      will often produce a color discontinuity;
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para>
-                      <guilabel>Triangular wave</guilabel> means that the
-                      gradient will be traversed in reverse, afterwards bouncing
-                      back and forth until the end of the brushstroke.
-                    </para>
-                  </listitem>
-                </itemizedlist>
-              </listitem>
-            </varlistentry>
-          </variablelist>
         </listitem>
       </varlistentry>
+			
     </variablelist>
   </sect3>
 
diff --git a/src/toolbox/paint/convolve.xml b/src/toolbox/paint/convolve.xml
index 45bc3a8..f5d2f54 100644
--- a/src/toolbox/paint/convolve.xml
+++ b/src/toolbox/paint/convolve.xml
@@ -143,8 +143,8 @@
     <variablelist>
       <varlistentry>
         <term>
-          Opacity; Brush; Scale; Brush Dynamics; Fade Out; Apply Jitter;
-          Hard Edges
+          Opacity; Brush; Dynamics; Dynamics Options; 
+					Apply Jitter; Hard Edges
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
diff --git a/src/toolbox/paint/dodge-burn.xml b/src/toolbox/paint/dodge-burn.xml
index 3dba008..be280ff 100644
--- a/src/toolbox/paint/dodge-burn.xml
+++ b/src/toolbox/paint/dodge-burn.xml
@@ -116,8 +116,8 @@
     <variablelist>
       <varlistentry>
         <term>
-          Opacity; Brush; Scale; Brush Dynamics; Fade out; Apply
-          Jitter, Hard edges
+          Opacity; Brush; Dynamics; Dynamics Options; 
+					Apply Jitter; Hard Edge
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
diff --git a/src/toolbox/paint/dynamics.xml b/src/toolbox/paint/dynamics.xml
new file mode 100755
index 0000000..07a043b
--- /dev/null
+++ b/src/toolbox/paint/dynamics.xml
@@ -0,0 +1,679 @@
+<?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";>
+<!-- comments:
+  This is at the moment a suggestion. Hoping somebody will enhance it.
+	Kolbjoern
+-->
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-dynamics">
+  <title>Dynamics</title>
+  <indexterm>
+    <primary>Tools</primary>
+    <secondary>Dynamics</secondary>
+  </indexterm>
+  <indexterm>
+    <primary>Dynamics</primary>
+  </indexterm>
+
+	<para>
+    The dynamics apply a more <quote>real feeling</quote> to the brush by
+		connecting one or more of the brush parameters to the way of using the 
+		brush. You may for instance let the width of the pencil vary according to 
+		the speed of the stylus or the mouse, make the color saturation 
+		depending on the stylus pressure, make the color changing as the 
+		direction of the brush changes on the canvas, and so on. You may choose 
+		among several presets or define your own. The dynamics are created to be 
+		used together with drawing tablets, but some are available using the mouse.
+  </para>
+	
+  <figure>
+    <title>Dynamics in Tool Options </title>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="images/toolbox/paint-dynamics-options.png" format="PNG"/>
+      </imageobject>
+    </mediaobject>
+  </figure>
+
+  <para>
+    The Dynamics area in the tools option dialog shows from left to right, the 
+		button to open the list containing the available dynamic presets, a field 
+		displaying the name of the current preset, and rightmost the edit button.		
+		Click on the button 
+		<guiicon>
+      <inlinegraphic fileref="images/toolbox/stock-tool-folders-dynamics-22.png"/>
+    </guiicon>
+		to open the dialog window displaying the available dynamics presets to select 
+		another preset.
+  </para>
+
+	<sect3>
+    <title>The Paint Dynamics Selection Dialog</title>
+    <figure>
+      <title>The Paint Dynamics Selection Dialog</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/toolbox/paint-dynamics-select.png" format="PNG"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+		<para>
+			The paint dynamics dialog window can be opened
+		</para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          from the image-menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Paint Dynamics</guimenuitem>
+          </menuchoice>,
+        </para>
+      </listitem>				
+      <listitem>
+        <para>
+          or by clicking on the button <guibutton>Open the dynamics selection</guibutton> 
+					in the list of dynamics presets.
+        </para>
+      </listitem>
+    </itemizedlist>
+		<para>
+		  The <guilabel>Dynamics Selection</guilabel> dialog is a dockable dialog; see 
+			the section <xref linkend="gimp-concepts-docks"/> for help on 
+			manipulating it.
+		</para>
+
+		<itemizedlist>
+		  <para>
+			  From this dialog you can select from all the available presets, just 
+				as from the list of dynamic presets. In addition there are five 
+				buttons:			  
+			</para>
+      <listitem>
+        <para>
+          Edit dynamics: Click on this to edit the selected dynamics. 
+        </para>
+      </listitem>		
+      <listitem>
+        <para>
+          Create a new dynamics: Do just that.
+        </para>
+      </listitem>
+			<listitem>
+        <para>
+          Duplicate this dynamics: Make a copy of the selected dynamics.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Delete this dynamics: Delete the selected dynamics.
+        </para>
+      </listitem>	
+      <listitem>
+        <para>
+          Refresh dynamics: Update the dynamics list.
+        </para>
+      </listitem>				
+    </itemizedlist>
+
+  </sect3>
+	
+	<sect3>
+    <title>Editing Paint Dynamics</title>
+    <figure>
+      <title>Editing Paint Dynamics</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/toolbox/paint-dynamics-edit.png" format="PNG"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <itemizedlist>
+		  <para>
+			  The paint dynamics edit dialog can be called from
+			</para>
+      <listitem>
+        <para>
+          the edit button in the Tool options dialog,
+        </para>
+      </listitem>		
+      <listitem>
+        <para>
+          from the Paint Dynamics Selection dialog by either clicking the 
+					button <guibutton>Edit Dynamics</guibutton> or the button <guibutton>Create a New 
+					Dynamics</guibutton>.
+        </para>
+      </listitem>
+    </itemizedlist>
+	  <para>
+		  You select the desirable behavior by clicking in the small squares. 
+			Clicking a second time unselect the marking. 
+		</para>		
+    <note>
+      <para>
+        If you open a dynamics in the edit dialog it is usually grayed out 
+				meaning you are not allowed to change the settings. To edit the 
+				options you have to work on a copy made from one of the preinstalled 
+				dynamics or create a new dynamics.
+      </para>
+    </note>
+		
+	</sect3>
+	<sect3>
+		<title>The Paint Dynamics Matrix</title>
+		<indexterm>
+			<primary>Tools</primary>
+			<secondary>Dynamics Matrix</secondary>
+		</indexterm>
+		<indexterm>
+			<primary>Dynamics Matrix</primary>
+		</indexterm>
+		<para>
+      The main part of the edit dialog is a table where you can decide 
+			which brush parameters should be affected by the way you use the stylus or the 
+			mouse. You may enable as many parameters and parameter combinations as you wish
+			but usually the fewer the better.
+    </para>
+		
+		<itemizedlist>
+		  <para>
+			  Each column in the table represents a stylus or mouse action except 
+				the random and the fade functions.
+			</para>
+      <listitem>
+        <para>
+          <guilabel>Pressure</guilabel>: This is only meaningful if you are
+					using a graphic tablet. It allows you to decide which aspects of the
+					tool's action should be affected by the press of the stylus
+					against the tablet.
+        </para>
+      </listitem>		
+      <listitem>
+        <para>
+          <guilabel>Velocity</guilabel>: This is the speed of the stylus or the 
+					mouse. 
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          <guilabel>Direction</guilabel>: This is the direction of the stylus or the mouse.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          <guilabel>Tilt</guilabel>: This is only meaningful if you are using a 
+					graphic tablet. The behavior of the function depends on the tilting
+					of the stylus.
+        </para>
+      </listitem>	
+      <listitem>
+        <para>
+          <guilabel>Wheel</guilabel>: This is only meaningful if you are using a 
+					graphic tablet. The output depends on the rotation of the stylus or 
+					the setting of the wheel on the airbrush pen.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          <guilabel>Random</guilabel>: The selected option will change at random. 
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          <guilabel>Fade</guilabel>: The selected option will be faded in or out 
+					depending on the settings of the fade options in the Dynamic Options
+					menu.
+        </para>
+      </listitem>			
+    </itemizedlist>
+		
+		<para>
+			Each line shows a brush parameter and seven check-boxes, one for each 
+			action. You connect the parameters to the actions by clicking the 
+			appropriate boxes. Clicking on a box a second time will unselect the 
+			connection.
+    </para>
+		<variablelist>
+      <varlistentry>
+        <term>Opacity</term>
+        <listitem>
+					<para>
+            <guilabel>Pressure</guilabel>: Press harder to make the drawing less transparent.
+					</para>	
+					<para>
+						<guilabel>Velocity</guilabel>: The opacity decrease as the speed 
+						of the stylus increase. 
+					</para>
+					<para>
+						<guilabel>Direction</guilabel>: The opacity depends on the 
+						direction of the stylus or the mouse. The effect seems to have a 
+						touch of randomness built in. 
+					</para>
+					<para>
+						<guilabel>Tilt</guilabel>: The opacity depends on the tilt of the 
+						stylus.
+					</para>
+					<para>
+						<guilabel>Wheel</guilabel>: TO DO 
+					</para>
+					<para>
+						<guilabel>Random</guilabel>: The opacity change at random in the interval set by the 
+						opacity slider in the toolbox. 
+					</para>
+					<para>
+						<guilabel>Fade</guilabel>: Starting with full transparency and ending with the
+						opacity set by the opacity slider in the toolbox.
+					</para>
+        </listitem>
+      </varlistentry>
+			
+      <varlistentry>
+        <term>Size</term>
+				<listitem>
+					<para>
+            <guilabel>Pressure</guilabel>: Press harder to make the brush 
+						wider.
+					</para>	
+					<para>
+						<guilabel>Velocity</guilabel>: Increasing speed decrease the
+						width of the brush. 
+					</para>
+					<para>
+						<guilabel>Direction</guilabel>: The size of the brush depends on 
+						the direction of the stylus or the mouse. The effect seems to 
+						have a touch of randomness built in. 
+					</para>
+					<para>
+						<guilabel>Tilt</guilabel>: The size of the brush depends on the tilt of the stylus.
+					</para>
+					<para>
+						<guilabel>Wheel</guilabel>:  
+					</para>
+					<para>
+						<guilabel>Random</guilabel>: The size of the brush change at random up to the size  
+						set in the brush size slider in the toolbox. 
+					</para>
+					<para>
+						<guilabel>Fade</guilabel>: Fades from a narrow brush to the size set in the brush
+						size slider in the toolbox.
+					</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>Angle</term>
+				<listitem>
+					<para>
+            TO DO 
+					</para>						
+        </listitem>				
+      </varlistentry>
+
+      <varlistentry>
+        <term>Color</term>
+				<listitem>
+					<para>
+						By default the color is picked from the foreground color in the 
+						toolbox. However, if the color is activated in the dynamics 
+						editor, the color is instead collected from the active gradient.
+					</para>
+
+					<para>
+						<guilabel>Velocity</guilabel>: At slow speeds the color is 
+						collected from the right side of the gradient. As the speed 
+						increase the color is picked more and more from the left side 
+						of the gradient. 
+					</para>
+					<para>
+						<guilabel>Direction</guilabel>: The direction determine where on 
+						the gradient the color is picked from. Mostly moving to the right 
+						and moving downward the color is picked from the left side of the 
+						gradient and the other directions get the color picked from the 
+						right half of the gradient. 
+					</para>
+
+					<para>
+						<guilabel>Random</guilabel>: The color is picked at random from 
+						the gradient. 
+					</para>
+					<para>
+						<guilabel>Fade</guilabel>: The start color is collected from the 
+						left side of the gradient and then more and more from the right 
+						side during the stroke. The behavior of the fading is set in the 
+						fade options in the toolbox.
+					</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+				<term>Hardness</term>
+				<listitem>
+					<para>
+						The hardness option is useful only for fuzzy brushes.
+					</para>				
+
+					<para>
+						<guilabel>Velocity</guilabel>: At slow speed the brush is hard 
+						and become more fuzzy as the speed increase. 
+					</para>
+
+					<para>
+						<guilabel>Random</guilabel>: The fussiness of the brush varies at 
+						random.  
+					</para>
+					<para>
+						<guilabel>Fade</guilabel>: The brush become less fuzzy during the 
+						stroke. The behavior of the fading is set in the fade options in 
+						the toolbox.
+					</para>
+        </listitem>					
+      </varlistentry>
+			
+      <varlistentry>
+        <term>Force</term>
+        <listitem>
+          <para>
+            TO DO
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>Aspect Ratio</term>
+				<listitem>
+					<para>
+						The Aspect Ratio Slider in the Tool Options must be set to other 
+						values than the default value of 0.00 to activate the dynamics. 
+						If the aspect ratio slider is set to a negative value the height 
+						of the brush is constant but the width of the brush will vary. If 
+						the slider is set to a positive value the height of the brush 
+						will vary.
+					</para>				
+	
+					<para>
+						<guilabel>Velocity</guilabel>: The aspect ratio of the brush 
+						(width / height) varies with the speed.
+					</para>
+					<para>
+						<guilabel>Direction</guilabel>: The aspect ratio of the brush 
+						varies with the moving direction of the brush. 
+					</para>
+
+					<para>
+						<guilabel>Random</guilabel>: The aspect ratio of the brush varies 
+						at random.   
+					</para>
+					<para>
+						<guilabel>Fade</guilabel>:  
+						If the Aspect Ratio Slider is set to a positive value the brush 
+						will fade from full height at the start of the stroke to the 
+						height set by the aspect ratio slider. If the slider is set to a 
+						negative value the brush fades from full width to the width set 
+						by the aspect ratio slider. The behavior of the fading is set in 
+						the fade options in the toolbox.
+					</para>
+        </listitem>				
+      </varlistentry>
+
+      <varlistentry>
+        <term>Spacing</term>				
+				<listitem>
+					<para>
+						Spacing is the distance between the marks set by the 						
+						brush when drawing lines. With this option set the spacing 
+						is affected by how the the stylus is used.
+					</para>				
+	
+					<para>
+						<guilabel>Velocity</guilabel>: The spacing between the footprints 
+						of the brush increase with increasing speed.
+					</para>
+					<para>
+						<guilabel>Direction</guilabel>: The spacing varies with the 
+						moving direction of the brush. 
+					</para>
+
+					<para>
+						<guilabel>Random</guilabel>: The spacing varies at random.   
+					</para>
+					<para>
+						<guilabel>Fade</guilabel>:  
+						Starting with a wide spacing and gradually make the spacing 
+						narrower. The behavior of the fading is set in the fade options 
+						in the toolbox.
+					</para>
+        </listitem>					
+      </varlistentry>
+
+      <varlistentry>
+        <term>Rate</term>				
+				<listitem>
+					<para>
+						This option applies to the Airbrush, Convolve tool, and 
+						Smudge tool, all of which have time-based effects.
+					</para>				
+					<para>
+            TO DO
+					</para>	
+        </listitem>					
+      </varlistentry>	
+			
+      <varlistentry>
+        <term>Flow</term>			
+				<listitem>
+					<para>
+            TO DO
+					</para>	
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>Jitter</term>			
+				<listitem>
+					<para>
+						Normally the brush draw a line by printing the brush marks close 
+						together. Adding jitter means that the brush prints are scattered 
+						along the line. The amount of scattering depends on the setting 
+						of the jitter slider in the tool options dialog window.
+					</para>				
+					<para>
+            <guilabel>Pressure</guilabel>: 
+					</para>	
+					<para>
+						<guilabel>Velocity</guilabel>: At slow speed the brush prints are 
+						spread according to the value set in the jitter amount slider. As 
+						the speed increase the scattering amount decrease.
+					</para>
+					<para>
+						<guilabel>Direction</guilabel>: The jitter effect depends on the 
+						direction of the brush. 
+					</para>
+
+					<para>
+						<guilabel>Random</guilabel>: The jitter varies at random.   
+					</para>
+					<para>
+						<guilabel>Fade</guilabel>:  
+						Starting with no jitter and ending with the amount of jitter set 
+						in the jitter amount slider. The behavior of the fading is set in 
+						the fade options in the toolbox.
+					</para>
+        </listitem>				
+      </varlistentry>			
+		</variablelist>		
+	</sect3>
+	
+	<sect3>
+		<title>Fine Tuning the Dynamics</title>
+		<figure>
+      <title>Fine Tuning the Dynamics</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/toolbox/paint-dynamics-tuning.png" format="PNG"/>
+        </imageobject>
+      </mediaobject>
+    </figure>		
+		<para>
+			If the current options do not suits you, you may fine-tune the settings 
+			from the Paint Dynamics Editor. Click on the down arrow to open the 
+			drop down menu and then select what option to change.
+		</para>
+		
+		<figure>
+      <title>The Fine Tuning Curve</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/toolbox/paint-dynamics-tuning-color.png" format="PNG"/>
+        </imageobject>
+      </mediaobject>
+    </figure>	
+		<para>
+			Click on one of the options to open the fine tuning dialog.
+		</para>
+		<para>
+			On top of the dialog you find the name of the dynamics. Below this
+			there is a drop down list where you can select what option to edit.
+		</para>
+		<para>	
+			The fine tuning is done by moving the curve by grabbing it by the
+			mouse pointer the usual way.
+		</para>
+		<para>
+			Downmost there is a list where you mark what action to be tuned.		
+		</para>
+	</sect3>
+	
+<!-- ****** Dynamic Options: ****** -->	
+	
+	<sect3 id="gimp-tool-dynamic-options">
+		<title>Dynamics Options</title>
+		
+		<indexterm>
+			<primary>Tools</primary>
+			<secondary>Dynamics Options</secondary>
+		</indexterm>
+		<indexterm>
+			<primary>Dynamics Options</primary>
+		</indexterm>
+	
+		<figure>
+      <title>Dynamics Options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/toolbox/dynamics-options.png" format="PNG"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+		<para>
+			Many of the dynamics behaviours also depends on the settings of the 
+			Dynamics Options in the tool options dialog and vice versa. For example 
+			will the fading not work if it is not applied in the Dynamics section.
+		</para>
+		<variablelist>
+      <varlistentry>
+        <term>Fade Options</term>
+        <listitem>
+          <para>
+            This slider determinds the length of the fading. What will 
+            actually happen depends on the setting of the Dynamic. If 
+						set to act on the color for example, the color will be taken from 
+						the current gradient starting from the left side of the gradient
+						and moving toward the right side of the gradient.
+          </para>
+					<para>
+						The Fade Options has a drop down list determining how the
+						fading is repeated.  
+					</para>					
+					<figure>
+						<title>
+						  Illustration of the effects of the three gradient-repeat
+              options, for the <guilabel>Abstract 2</guilabel> gradient.
+						</title>
+						<mediaobject>
+							<imageobject>
+								<imagedata format="PNG"
+									fileref="images/tool-options/brush-gradient-normal.png"/>
+							</imageobject>
+							<caption>
+                  <para>Abstract2 Gradient</para>
+              </caption>
+						</mediaobject>
+						<mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/tool-options/brush-gradient-none.png"/>
+              </imageobject>
+                <caption>
+                  <para>None</para>
+                </caption>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/tool-options/brush-gradient-sawtooth.png"/>
+              </imageobject>
+                <caption>
+                  <para>Sawtooth</para>
+                </caption>
+            </mediaobject>						
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/tool-options/brush-gradient-triangular.png"/>
+              </imageobject>
+                <caption>
+                  <para>Triangular</para>
+                </caption>
+            </mediaobject>						
+					</figure>
+					<para>
+            This option determines what happens if a brush stroke extends
+            farther than the Length specified by the slider. There are three
+            possibilities:
+          </para>
+          <itemizedlist>
+            <listitem>
+              <para>
+                <guilabel>None</guilabel> means that the color from the end of
+                the gradient will be used throughout the remainder of the
+                stroke;
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+                <guilabel>Sawtooth wave</guilabel> means that the
+                gradient will be restarted from the beginning, which
+                will often produce a color discontinuity;
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+                <guilabel>Triangular wave</guilabel> means that the
+                gradient will be traversed in reverse, afterwards bouncing
+                back and forth until the end of the brush stroke.
+              </para>
+            </listitem>
+          </itemizedlist>					
+        </listitem>
+			</varlistentry>
+			<varlistentry>
+        <term>Color Options</term>
+        <listitem>
+          <para>
+            Here you may choose which gradient to use as the color source 
+						when using the brush with the color option set. Click on the box 
+						showing the gradient to change to another one from the gradient
+						list. 
+          </para>
+					<para>
+					  If none of the color options are selected in the currently used 
+						dynamics, the brush will use the foreground color set in the 
+						toolbox.
+					</para>
+        </listitem>				
+			</varlistentry>	
+
+		</variablelist>			
+	</sect3>
+</sect2>
diff --git a/src/toolbox/paint/eraser.xml b/src/toolbox/paint/eraser.xml
index b25c8ef..47d9328 100644
--- a/src/toolbox/paint/eraser.xml
+++ b/src/toolbox/paint/eraser.xml
@@ -184,7 +184,7 @@
     <variablelist>
       <varlistentry>
         <term>
-          Brush; Scale; Brush Dynamics; Fade Out; Apply Jitter; Incremental
+          Brush; Size; Brush Dynamics; Dynamic Options; Apply Jitter; Incremental
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
@@ -195,9 +195,9 @@
         <listitem>
           <para>
             The <guilabel>Opacity</guilabel> slider, in spite of its name,
-            determines the <quote>strength</quote> of the tool. Thus, when
-            you erase on a layer with an alpha channel, the higher the
-            opacity you use, the more transparency you get!
+            in this tool determines the <quote>strength</quote> of the tool. 
+						Thus, when you erase on a layer with an alpha channel, the higher 
+						the opacity you use, the more transparency you get!
           </para>
         </listitem>
       </varlistentry>
@@ -233,7 +233,7 @@
               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
-                make any sense to me - ude, 2009-05-03
+                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
diff --git a/src/toolbox/paint/heal.xml b/src/toolbox/paint/heal.xml
index e83494f..5f80136 100644
--- a/src/toolbox/paint/heal.xml
+++ b/src/toolbox/paint/heal.xml
@@ -135,8 +135,8 @@
     <variablelist>
       <varlistentry>
         <term>
-          Mode; Opacity; Brush; Scale; Brush Dynamics, Fade out, Apply Jitter,
-          Hard Edges
+          Mode; Opacity; Brush; Dynamics; Dynamics Options; Apply Jitter; Smoot 
+					Stroke; Hard Edge
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
diff --git a/src/toolbox/paint/paintbrush.xml b/src/toolbox/paint/paintbrush.xml
index 8618e25..22923ad 100644
--- a/src/toolbox/paint/paintbrush.xml
+++ b/src/toolbox/paint/paintbrush.xml
@@ -107,8 +107,8 @@
     <variablelist>
       <varlistentry>
         <term>
-          Mode; Opacity; Brush; Scale; Brush Dynamics; Fade Out; Apply
-          Jitter; Incremental; Use Color from Gradient
+          Mode; Opacity; Brush; Dynamics; Dynamics Options; 
+					Apply Jitter; Smoot Stroke; 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 12eab4b..7300aac 100644
--- a/src/toolbox/paint/pencil.xml
+++ b/src/toolbox/paint/pencil.xml
@@ -128,8 +128,8 @@
     <variablelist>
       <varlistentry>
         <term>
-          Mode; Opacity; Brush; Scale; Brush Dynamics; Fade Out; Apply
-          Jitter; Incremental; Use Color from Gradient
+          Mode; Opacity; Brush; Dynamics; Dynamics Options; 
+					Apply Jitter; Smooth Stroke; 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 fdae5a6..88aa908 100644
--- a/src/toolbox/paint/perspective-clone.xml
+++ b/src/toolbox/paint/perspective-clone.xml
@@ -101,7 +101,7 @@
       <title>Perspective Clone tool options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/perspective-clone-options.png" format="PNG"/>
+          <imagedata fileref="images/toolbox/tool-options-perspective-clone.png" format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -124,8 +124,8 @@
       </varlistentry>
       <varlistentry>
         <term>
-          Mode, Opacity, Brush, Scale, Brush Dynamics, Fade out, Apply Jitter,
-          Hard Edge
+          Mode; Opacity; Brush; Dynamics; Dynamics Options; Fade Options; 
+					Apply Jitter; Smooth Stroke; Hard Edge
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>
diff --git a/src/toolbox/paint/smudge.xml b/src/toolbox/paint/smudge.xml
index 60c2a53..0f4354b 100644
--- a/src/toolbox/paint/smudge.xml
+++ b/src/toolbox/paint/smudge.xml
@@ -119,8 +119,8 @@
     <variablelist>
       <varlistentry>
         <term>
-          Opacity; Brush; Scale; Brush Dynamics; Fade out; Apply Jitter; Hard
-          edges; Rate
+          Opacity; Brush; Dynamics; Dynamics Options; Fade Options; 
+					Apply Jitter; Hard Edge; Rate
         </term>
         <listitem>
           <xi:include href="about-common-paint-options.xml"/>



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