[gimp-help] Update Distorts/Waves filter

[Julien Hardlin <jhardlin src gnome org>]

commit c32312a2aadba1ada4df6338c81256d0dd7f381b
Author: Julien Hardelin <jhardlin orange fr>
Date:   Sun Dec 30 08:17:26 2018 +0100

    Update Distorts/Waves filter

 images/C/filters/distort/waves-dialog.png       | Bin 0 -> 32388 bytes
 images/C/filters/distort/waves.png              | Bin 33238 -> 0 bytes
 images/C/filters/examples/distort-taj-waves.jpg | Bin 38202 -> 71189 bytes
 src/filters/distort/waves.xml                   |  80 ++++++++++++------------
 4 files changed, 41 insertions(+), 39 deletions(-)
---
diff --git a/images/C/filters/distort/waves-dialog.png b/images/C/filters/distort/waves-dialog.png
new file mode 100644
index 000000000..405d29d7f
Binary files /dev/null and b/images/C/filters/distort/waves-dialog.png differ
diff --git a/images/C/filters/examples/distort-taj-waves.jpg b/images/C/filters/examples/distort-taj-waves.jpg
index 727bb8855..a1a272c44 100644
Binary files a/images/C/filters/examples/distort-taj-waves.jpg and 
b/images/C/filters/examples/distort-taj-waves.jpg differ
diff --git a/src/filters/distort/waves.xml b/src/filters/distort/waves.xml
index 1ec698317..ff2cdf7e4 100644
--- a/src/filters/distort/waves.xml
+++ b/src/filters/distort/waves.xml
@@ -2,11 +2,9 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-04-25 KoSt: added 'no'
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  050910 de added by axel.wernicke
+  2012-12-29 j.h: update to v2.10
 -->
-<sect2 id="gimp-filter-waves">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-waves">
   <title>Waves</title>
 
   <indexterm>
@@ -32,7 +30,8 @@
             fileref="images/filters/examples/distort-taj-waves.jpg"/>
         </imageobject>
         <caption>
-          <para>Filter <quote>Waves</quote> applied</para>
+          <para>Filter <quote>Waves</quote> applied with default options 
+          and period = 20.0</para>
         </caption>
       </mediaobject>
     </figure>
@@ -60,70 +59,73 @@
       <title><quote>Waves</quote> filter options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/distort/waves.png" format="PNG"/>
+    <imagedata fileref="images/filters/distort/waves-dialog.png" format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Preview</term>
+        <term>Presets, Preview, Split view</term>
+        <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Center X, Center Y</term>
         <listitem>
           <para>
-            All your setting changes will appear in the Preview without
-            affecting the image until you click on <guilabel>OK</guilabel>.
-            Don't keep <guilabel>Preview</guilabel> checked if your computer
-            is too slow.
+           Move the center of the waves
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Mode</term>
+        <term>Amplitude</term>
         <listitem>
-          <variablelist>
-            <varlistentry>
-              <term><guilabel>Smear</guilabel></term>
-              <listitem>
-                <para>
-                  Because of the waves, areas are rendered empty on sides. The
-                  adjacent pixels will spread to fill them.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term><guilabel>Blacken</guilabel></term>
-              <listitem>
-                <para>
-                  The empty areas will be filled by black color.
-                </para>
-            </listitem>
-            </varlistentry>
-          </variablelist>
+          <para>Varies the height of the waves.</para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Reflective</term>
+        <term>Period</term>
         <listitem>
           <para>
-            Waves bounce on sides and interfere with the arriving ones.
+            That is wavelength. Varies the distance between the top of waves.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Amplitude</term>
+        <term>Phase shift</term>
+        <listitem>
+          <para>This command shifts the top of the ripple.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Aspect ratio</term>
         <listitem>
-          <para>Varies the height of waves.</para>
+          <para>
+            Values less than 1.00 render waves oval, with major axis vertical. 
+            Values higher than 1.00 give a major axis horizontal.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Resampling method</term>
+        <listitem>
+          <para>
+            These interpolation methods are described in 
+            <xref linkend="gimp-tool-interpolation-methods"/>.
+          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Phase</term>
+        <term>Clamp deformation</term>
         <listitem>
-          <para>This command shifts the top of waves.</para>
+          <para>TODO.</para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Wavelength</term>
+        <term>Use the selection as input, Use the entire layer as input</term>
         <listitem>
-          <para>Varies the distance between the top of waves.</para>
+          <xi:include href="../about-common-features.xml"/>
         </listitem>
       </varlistentry>
     </variablelist>