[gimp-help-2] Add new sliders

[Julien Hardlin <jhardlin src gnome org>]

commit a59f34ac8ab4e10400636e4c7f60551b50a25567
Author: Julien Hardelin <jm hard wanadoo fr>
Date:   Sun Dec 9 07:55:39 2012 +0100

    Add new sliders

 images/C/toolbox/slider-fast.png         |  Bin 0 -> 3943 bytes
 images/C/toolbox/slider-slow.png         |  Bin 0 -> 3731 bytes
 images/C/using/stretch-shrink-cursor.png |  Bin 3459 -> 2575 bytes
 src/toolbox/intro.xml                    |   79 ++++++++++++++++++++++++++++++
 4 files changed, 79 insertions(+), 0 deletions(-)
---
diff --git a/images/C/toolbox/slider-fast.png b/images/C/toolbox/slider-fast.png
new file mode 100644
index 0000000..46105a0
Binary files /dev/null and b/images/C/toolbox/slider-fast.png differ
diff --git a/images/C/toolbox/slider-slow.png b/images/C/toolbox/slider-slow.png
new file mode 100644
index 0000000..9038bc8
Binary files /dev/null and b/images/C/toolbox/slider-slow.png differ
diff --git a/images/C/using/stretch-shrink-cursor.png b/images/C/using/stretch-shrink-cursor.png
index c11fdf2..c871f65 100644
Binary files a/images/C/using/stretch-shrink-cursor.png and b/images/C/using/stretch-shrink-cursor.png differ
diff --git a/src/toolbox/intro.xml b/src/toolbox/intro.xml
old mode 100755
new mode 100644
index 910e42f..3512aa0
--- a/src/toolbox/intro.xml
+++ b/src/toolbox/intro.xml
@@ -2,6 +2,7 @@
 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
+  2012-12-08 add sliders by j.h
   2012-04-27 update to v2.8 by j.h
   2007-12-01 up to v2.4 fr; en by PP
   2005-11-26 fixed images and tips structure by romanofski
@@ -272,5 +273,83 @@
         </listitem>
       </varlistentry>
     </variablelist>
+    
+    <variablelist>
+      <varlistentry>
+        <term>New sliders</term>
+        <listitem>
+          <indexterm>
+            <primary>Sliders</primary>
+          </indexterm>
+          <para>
+            Option sliders have changed with GIMP-2.8: it is not visible, but
+            the slider area is now divided into upper and lower parts.
+          </para>
+          <figure>
+            <title>The new sliders of tool options dialogs</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                    fileref="images/toolbox/slider-fast.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  The upwards arrow pointer in the top half of the slider area
+                </para>
+              </caption>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                    fileref="images/toolbox/slider-slow.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  The horizontal two-way arrow pointer in the lower half of
+                  the slider area
+                </para>
+              </caption>
+            </mediaobject>
+          </figure>
+          <itemizedlist>
+            <listitem>
+              <formalpara>
+                <title>In the top half of the slider area:</title>
+                <para>
+                  Clicking with the up arrow pointer sets slider to a value that
+                  depends on the position of the pointer (no reference,
+                  imprecise).
+                  Clicking and dragging the up arrow pointer sets the value by
+                  large amounts.
+                </para>
+              </formalpara>
+            </listitem>
+            <listitem>
+              <formalpara>
+                <title>In the lower half of the slider area:</title>
+                <para>
+                  Clicking with the two-way arrow pointer has no effect.
+                  Clicking and dragging the two-way arrow pointer sets the value
+                  by small amounts.
+                </para>
+              </formalpara>
+            </listitem>
+          </itemizedlist>
+          <para>
+            Once you have set the value approximately, you can tune it precisely
+            using the two small arrow buttons at the right of the slider.
+          </para>
+          <para>
+            The value area in the slider area works as a text editor: there, you
+            can edit the value or enter a new value directly.
+          </para>
+          <para>
+            For some options, you can drag the pointer outside the tool dialog.
+            For example with the size slider, whose maximum value is 10,000, 
+            you can drag the mouse pointer up to the right side of your screen.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
   </sect2>
 </sect1>