[gimp-help] Update distort/apply-lens filter

[Julien Hardlin <jhardlin src gnome org>]

commit 35bea66e0cc195cf29bcb87c9388bec8a0104769
Author: Julien Hardelin <jhardlin orange fr>
Date:   Wed Dec 5 07:41:02 2018 +0100

    Update distort/apply-lens filter

 .directory                                       |   3 ++
 images/C/filters/distort/apply-lens-dialog.png   | Bin 0 -> 19748 bytes
 images/C/filters/light-and-shadow/apply-lens.png | Bin 25748 -> 0 bytes
 src/filters/distort.xml                          |  18 ++++++---
 src/filters/distort/apply_lens.xml               |  47 ++++++++++++++---------
 5 files changed, 43 insertions(+), 25 deletions(-)
---
diff --git a/.directory b/.directory
new file mode 100644
index 000000000..9a621134e
--- /dev/null
+++ b/.directory
@@ -0,0 +1,3 @@
+[Dolphin]
+Timestamp=2018,12,5,7,37,10
+Version=3
diff --git a/images/C/filters/distort/apply-lens-dialog.png b/images/C/filters/distort/apply-lens-dialog.png
new file mode 100644
index 000000000..3497b4f92
Binary files /dev/null and b/images/C/filters/distort/apply-lens-dialog.png differ
diff --git a/src/filters/distort.xml b/src/filters/distort.xml
index 8b59c606f..845bb57ec 100644
--- a/src/filters/distort.xml
+++ b/src/filters/distort.xml
@@ -18,22 +18,28 @@
     </mediaobject>
   </figure>
   <xi:include href="distort/introduction.xml"/>
-  <xi:include href="distort/blinds.xml"/>
-  <xi:include href="distort/curve_bend.xml"/>
+  <xi:include href="distort/apply_lens.xml"/>
   <xi:include href="distort/emboss.xml"/>
   <xi:include href="distort/engrave.xml"/>
-  <xi:include href="distort/erase_rows.xml"/>
   <xi:include href="distort/lens-distortion.xml"/>
+  <!--<xi:include href="distort/kaleidoscope.xml"/>-->
   <xi:include href="distort/mosaic.xml"/>
-  <xi:include href="distort/newsprint.xml"/>
-  <xi:include href="distort/pagecurl.xml"/>
   <xi:include href="distort/polarcoords.xml"/>
   <xi:include href="distort/ripple.xml"/>
   <xi:include href="distort/shift.xml"/>
+  <!--<xi:include href="distort/spherize.xml"/>-->
   <xi:include href="distort/vpropagate.xml"/>
   <xi:include href="distort/video.xml"/>
   <xi:include href="distort/waves.xml"/>
   <xi:include href="distort/whirlpinch.xml"/>
   <xi:include href="distort/wind.xml"/>
-  <xi:include href="distort/apply_lens.xml"/>
+  <xi:include href="distort/curve_bend.xml"/>
+  <!--<xi:include href="distort/emboss (legacy).xml"/>-->
+  <xi:include href="distort/newsprint.xml"/>
+  <xi:include href="distort/pagecurl.xml"/>
+
+  <!-- Suppr
+  <xi:include href="distort/blinds.xml"/>
+  <xi:include href="distort/erase_rows.xml"/>-->
+
 </sect1>
diff --git a/src/filters/distort/apply_lens.xml b/src/filters/distort/apply_lens.xml
index 1967940ff..3d881ed11 100644
--- a/src/filters/distort/apply_lens.xml
+++ b/src/filters/distort/apply_lens.xml
@@ -1,7 +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:
+<!-- 
+section history:
   2008-06-09 ude: rearranged options ('en')
   2008-06-02 j.h: replaced "image" with "active layer"
   2007-12-21 MikaS: updated 'fr'
@@ -73,20 +74,27 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/light-and-shadow/apply-lens.png"/>
+            fileref="images/filters/distort/apply-lens-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Preview</term>
+        <term><guilabel>Presets</guilabel>, <guilabel>Preview</guilabel>, 
+          <guilabel>Split view</guilabel></term>
         <listitem>
           <para>
-            If checked, parameter setting results are interactively displayed
-            in preview. Scroll bars allow you to move around the image.
+            These options are common to GEGL-based filters. Please refer to 
+            <xref linkend="gimp-filters-common"/>.
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Lens refraction index</term>
+        <listitem>
+          <para>Lens will be more or less convergent (1-100).</para>
+        </listitem>
+      </varlistentry>
       <varlistentry>
         <term>Keep original surroundings</term>
         <listitem>
@@ -94,29 +102,30 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Set surroundings to background color</term>
+        <term>Background color</term>
         <listitem>
           <para>
             The part of the active layer outside the lens will have the
             background color selected in the toolbox.
           </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Make surroundings transparent</term>
-        <listitem>
           <para>
-            The part of the active layer outside the lens will be transparent.
-            This option exists only if the active layer has an alpha channel.
+            You can select the color:
+            <itemizedlist>
+              <listitem>
+                <para>
+                  Click on color dwell to open the color selector dialog.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  Click on the eye-drop button on the right to pick color from 
+                  the image.
+                </para>
+              </listitem>
+            </itemizedlist>
           </para>
         </listitem>
       </varlistentry>
-      <varlistentry>
-        <term>Lens refraction index</term>
-        <listitem>
-          <para>Lens will be more or less convergent (1-100).</para>
-        </listitem>
-      </varlistentry>
     </variablelist>
   </sect3>
 </sect2>