[gimp-help] Update Free selection tool. Add animated gif to Spyrogimp filter for better understanding what gears

[Julien Hardlin <jhardlin src gnome org>]

commit 704b7a5d42d3a61a79c25beda6e478c46d55dcae
Author: Julien Hardelin <jhardlin orange fr>
Date:   Mon Apr 22 15:52:24 2019 +0200

    Update Free selection tool. Add animated gif to Spyrogimp filter for better understanding what gears and 
holes are.

 .../C/filters/examples/render/Spiograph_Animation.gif  | Bin 0 -> 821872 bytes
 src/filters/render/spyrogimp.xml                       |  17 ++++++++++++++++-
 src/toolbox/selection/free.xml                         |   6 +++++-
 3 files changed, 21 insertions(+), 2 deletions(-)
---
diff --git a/images/C/filters/examples/render/Spiograph_Animation.gif 
b/images/C/filters/examples/render/Spiograph_Animation.gif
new file mode 100644
index 000000000..c1a0af045
Binary files /dev/null and b/images/C/filters/examples/render/Spiograph_Animation.gif differ
diff --git a/src/filters/render/spyrogimp.xml b/src/filters/render/spyrogimp.xml
index b3d276ebd..83e0f80bc 100644
--- a/src/filters/render/spyrogimp.xml
+++ b/src/filters/render/spyrogimp.xml
@@ -33,9 +33,24 @@
       Immediate feedback is provided, by drawing to a temporary
       layer.
     </para>
+    <para>
+      It reproduces curves drawn by Spirograph© toys. Here is an example 
+      from Wikipedia showing what gears and holes are:
+      <mediaobject>
+        <imageobject>
+          <imagedata format="GIF"
+            fileref="images/filters/examples/render/Spiograph_Animation.gif" />
+        </imageobject>
+        <caption>
+          <para>
+            <emphasis>Moving gear</emphasis> is inside <emphasis>fixed 
+              gear</emphasis> and only one <emphasis>hole</emphasis> is used.
+          </para>
+        </caption>
+      </mediaobject>
+    </para>
   </sect3>
 
-
   <sect3>
     <title>Activating the filter</title>
     <para>
diff --git a/src/toolbox/selection/free.xml b/src/toolbox/selection/free.xml
index da03d9448..aa4a2caf0 100644
--- a/src/toolbox/selection/free.xml
+++ b/src/toolbox/selection/free.xml
@@ -55,7 +55,11 @@
         <para>
           Or release the mouse button and drag to draw a polygonal selection. 
           When the <emphasis>end point</emphasis> comes superimposed on the 
-          starting point, click to <emphasis>close the selection</emphasis>.
+          starting point, click to <emphasis>close the selection</emphasis>. 
+          Since GIMP-2.10, closing polygonal selection doesn't confirm the 
+          selection automatically; you still can tweak positions of nodes.Then 
+          press <keycap>Enter</keycap> or switch to another tool to confirm the 
+          selection.
         </para>
         <para>
           Press the <keycap>Ctrl</keycap> keyboard key and click on the end