[gimp-help] Add Clipping option to Blur and Enhance filters



commit 668c1d706337f3a561e11370df659b65dfdfc816
Author: Julien Hardelin <jhardlin orange fr>
Date:   Sun Dec 29 17:28:16 2019 +0100

    Add Clipping option to Blur and Enhance filters

 images/C/filters/blur/circular-options.png         | Bin 24730 -> 28877 bytes
 images/C/filters/blur/gauss-options.png            | Bin 20915 -> 30329 bytes
 .../C/filters/blur/gaussian-selective-options.png  | Bin 20289 -> 28399 bytes
 images/C/filters/blur/linear-options.png           | Bin 21095 -> 24557 bytes
 images/C/filters/blur/mean_curvature-dialog.png    | Bin 17289 -> 20439 bytes
 images/C/filters/blur/median_blur-dialog.png       | Bin 0 -> 32652 bytes
 images/C/filters/blur/pixelize-options.png         | Bin 26947 -> 35432 bytes
 images/C/filters/blur/zoom-options.png             | Bin 23578 -> 27858 bytes
 images/C/filters/enhance/deinterlace-dialog.png    | Bin 20272 -> 23057 bytes
 images/C/filters/enhance/high-pass-dialog.png      | Bin 14222 -> 20990 bytes
 .../C/filters/enhance/noise-reduction-dialog.png   | Bin 0 -> 19249 bytes
 images/C/filters/enhance/sharpen-dialog.png        | Bin 19501 -> 25035 bytes
 images/C/filters/enhance/snn-dialog.png            | Bin 17040 -> 22151 bytes
 images/C/menus/filters/enhance.png                 | Bin 0 -> 16331 bytes
 src/filters/blur/circular-motion.xml               |   9 +++---
 src/filters/blur/gauss.xml                         |   8 ++++-
 src/filters/blur/gauss_select.xml                  |   9 +++++-
 src/filters/blur/linear-motion.xml                 |   9 +++---
 src/filters/blur/mean-curvature-blur.xml           |   9 +++++-
 src/filters/blur/median-blur.xml                   |  17 +++++++++-
 src/filters/blur/pixelize.xml                      |  35 ++++-----------------
 src/filters/blur/zoom-motion.xml                   |   9 +++---
 src/filters/clipping-feature.xml                   |  13 ++++++++
 src/filters/enhance/deinterlace.xml                |   8 ++++-
 src/filters/enhance/high-pass.xml                  |  16 ++++++++--
 src/filters/enhance/noise-reduction.xml            |  13 ++++++--
 src/filters/enhance/symmetric-nearest-neighbor.xml |   9 +++++-
 src/filters/enhance/unsharp_mask.xml               |   8 ++++-
 src/filters/light-and-shadow/drop-shadow.xml       |   6 ++++
 src/filters/light-and-shadow/long-shadow.xml       |   6 ++++
 src/menus/select/feather.xml                       |   2 +-
 src/menus/select/shrink.xml                        |   6 ++--
 32 files changed, 133 insertions(+), 59 deletions(-)
---
diff --git a/images/C/filters/blur/circular-options.png b/images/C/filters/blur/circular-options.png
index 8f6f5176a..141ac4f14 100644
Binary files a/images/C/filters/blur/circular-options.png and b/images/C/filters/blur/circular-options.png 
differ
diff --git a/images/C/filters/blur/gauss-options.png b/images/C/filters/blur/gauss-options.png
index 576c8c971..80778cfd8 100644
Binary files a/images/C/filters/blur/gauss-options.png and b/images/C/filters/blur/gauss-options.png differ
diff --git a/images/C/filters/blur/gaussian-selective-options.png 
b/images/C/filters/blur/gaussian-selective-options.png
index e54a8453e..88c1956ed 100644
Binary files a/images/C/filters/blur/gaussian-selective-options.png and 
b/images/C/filters/blur/gaussian-selective-options.png differ
diff --git a/images/C/filters/blur/linear-options.png b/images/C/filters/blur/linear-options.png
index b8ce90378..80660c730 100644
Binary files a/images/C/filters/blur/linear-options.png and b/images/C/filters/blur/linear-options.png differ
diff --git a/images/C/filters/blur/mean_curvature-dialog.png b/images/C/filters/blur/mean_curvature-dialog.png
index 4067ed1d2..ec0a8c216 100644
Binary files a/images/C/filters/blur/mean_curvature-dialog.png and 
b/images/C/filters/blur/mean_curvature-dialog.png differ
diff --git a/images/C/filters/blur/median_blur-dialog.png b/images/C/filters/blur/median_blur-dialog.png
new file mode 100644
index 000000000..dcca2b3ba
Binary files /dev/null and b/images/C/filters/blur/median_blur-dialog.png differ
diff --git a/images/C/filters/blur/pixelize-options.png b/images/C/filters/blur/pixelize-options.png
index ca3edc7de..ef955c81a 100644
Binary files a/images/C/filters/blur/pixelize-options.png and b/images/C/filters/blur/pixelize-options.png 
differ
diff --git a/images/C/filters/blur/zoom-options.png b/images/C/filters/blur/zoom-options.png
index 0f17f473b..d04c8e3a2 100644
Binary files a/images/C/filters/blur/zoom-options.png and b/images/C/filters/blur/zoom-options.png differ
diff --git a/images/C/filters/enhance/deinterlace-dialog.png b/images/C/filters/enhance/deinterlace-dialog.png
index 3070b2876..d5475a17c 100644
Binary files a/images/C/filters/enhance/deinterlace-dialog.png and 
b/images/C/filters/enhance/deinterlace-dialog.png differ
diff --git a/images/C/filters/enhance/high-pass-dialog.png b/images/C/filters/enhance/high-pass-dialog.png
index 6f5bc303a..cc44601f2 100644
Binary files a/images/C/filters/enhance/high-pass-dialog.png and 
b/images/C/filters/enhance/high-pass-dialog.png differ
diff --git a/images/C/filters/enhance/noise-reduction-dialog.png 
b/images/C/filters/enhance/noise-reduction-dialog.png
new file mode 100644
index 000000000..f257b1db3
Binary files /dev/null and b/images/C/filters/enhance/noise-reduction-dialog.png differ
diff --git a/images/C/filters/enhance/sharpen-dialog.png b/images/C/filters/enhance/sharpen-dialog.png
index b852723bb..7cbc4731f 100644
Binary files a/images/C/filters/enhance/sharpen-dialog.png and b/images/C/filters/enhance/sharpen-dialog.png 
differ
diff --git a/images/C/filters/enhance/snn-dialog.png b/images/C/filters/enhance/snn-dialog.png
index 199c4dcde..fd3e8b12c 100644
Binary files a/images/C/filters/enhance/snn-dialog.png and b/images/C/filters/enhance/snn-dialog.png differ
diff --git a/images/C/menus/filters/enhance.png b/images/C/menus/filters/enhance.png
new file mode 100644
index 000000000..700ebdeb5
Binary files /dev/null and b/images/C/menus/filters/enhance.png differ
diff --git a/src/filters/blur/circular-motion.xml b/src/filters/blur/circular-motion.xml
index 001a70370..c3ab49909 100644
--- a/src/filters/blur/circular-motion.xml
+++ b/src/filters/blur/circular-motion.xml
@@ -4,7 +4,8 @@
 <!-- section history:
   2019-05-14 j.h: update to v2.10.10
 -->
-<sect2 id="gimp-filter-motion-blur-circular">
+<sect2 
+xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-motion-blur-circular">
   <title>Circular Motion Blur</title>
 
   <indexterm>
@@ -94,11 +95,9 @@
       </varlistentry>
       
       <varlistentry>
-        <term><guilabel>Use selection as input</guilabel></term>
+        <term><guilabel>Clipping</guilabel></term>
         <listitem>
-          <para>
-            Explained in <xref linkend="gimp-filter-pixelize"/>.
-          </para>
+          <xi:include href="../clipping-feature.xml"/>
         </listitem>
       </varlistentry>
       
diff --git a/src/filters/blur/gauss.xml b/src/filters/blur/gauss.xml
index 6953cc4e9..0d9d807a3 100644
--- a/src/filters/blur/gauss.xml
+++ b/src/filters/blur/gauss.xml
@@ -5,7 +5,7 @@
   2018-11-17 j.h Fix TODO
   2017-10-12 j.h : some updates
 -->
-<sect2 id="gimp-filter-gaussian-blur">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-gaussian-blur">
   <title>Gaussian Blur</title>
 
   <indexterm>
@@ -173,6 +173,12 @@
           </figure>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Clipping</term>
+        <listitem>
+          <xi:include href="../clipping-feature.xml"/>
+        </listitem>
+      </varlistentry>
     </variablelist>
     <para>
       The Gaussian Blur filter doesn't preserve edges in the image:
diff --git a/src/filters/blur/gauss_select.xml b/src/filters/blur/gauss_select.xml
index b86a8068b..2dcf18dfd 100644
--- a/src/filters/blur/gauss_select.xml
+++ b/src/filters/blur/gauss_select.xml
@@ -4,7 +4,8 @@
 <!-- section history:
   2017-10-14 j.h: some updates
 -->
-<sect2 id="gimp-filter-gaussian-blur-selective">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; 
+id="gimp-filter-gaussian-blur-selective">
   <title>Selective Gaussian Blur</title>
 
   <indexterm>
@@ -113,6 +114,12 @@
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term><guilabel>Clipping</guilabel></term>
+        <listitem>
+          <xi:include href="../clipping-feature.xml"/>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
 </sect2>
diff --git a/src/filters/blur/linear-motion.xml b/src/filters/blur/linear-motion.xml
index 509253c5c..37f593a9b 100644
--- a/src/filters/blur/linear-motion.xml
+++ b/src/filters/blur/linear-motion.xml
@@ -4,7 +4,8 @@
 <!-- section history:
   2019-05-14 j.h: update to v2.10.10
 -->
-<sect2 id="gimp-filter-motion-blur-linear">
+<sect2 
+xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-motion-blur-linear">
   <title>Linear Motion Blur</title>
   <indexterm>
     <primary>Filters</primary>
@@ -91,11 +92,9 @@
       </varlistentry>
       
       <varlistentry>
-        <term><guilabel>Use selection as input</guilabel></term>
+        <term><guilabel>Clipping</guilabel></term>
         <listitem>
-          <para>
-            Explained in <xref linkend="gimp-filter-pixelize"/>.
-          </para>
+          <xi:include href="../clipping-feature.xml"/>
         </listitem>
       </varlistentry>
       
diff --git a/src/filters/blur/mean-curvature-blur.xml b/src/filters/blur/mean-curvature-blur.xml
index f35cb1888..457d48267 100644
--- a/src/filters/blur/mean-curvature-blur.xml
+++ b/src/filters/blur/mean-curvature-blur.xml
@@ -4,7 +4,8 @@
 <!-- section history:
   2019-12-29 j.h : initial version
 -->
-<sect2 id="gimp-filter-mean-curvature-blur">
+<sect2 
+xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-mean-curvature-blur">
   <title>Mean Curvature Blur</title>
 
   <indexterm>
@@ -72,6 +73,12 @@
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Clipping</term>
+        <listitem>
+          <xi:include href="../clipping-feature.xml"/>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
   
diff --git a/src/filters/blur/median-blur.xml b/src/filters/blur/median-blur.xml
index 78be80cb6..513dc753f 100644
--- a/src/filters/blur/median-blur.xml
+++ b/src/filters/blur/median-blur.xml
@@ -4,7 +4,7 @@
 <!-- section history:
   2018-10-29 j.h : created
 -->
-<sect2 id="gimp-filter-median-blur">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-median-blur">
   <title>Median Blur</title>
 
   <indexterm>
@@ -231,6 +231,21 @@
           </mediaobject>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term><guilabel>Abyss policy</guilabel></term>
+        <listitem>
+          <para>
+            Abyss policy (border management) is treated with 
+              <xref linkend="abyss-policy"/>.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Clipping</term>
+        <listitem>
+          <xi:include href="../clipping-feature.xml"/>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
   
diff --git a/src/filters/blur/pixelize.xml b/src/filters/blur/pixelize.xml
index f904352b4..4cf754986 100644
--- a/src/filters/blur/pixelize.xml
+++ b/src/filters/blur/pixelize.xml
@@ -4,7 +4,7 @@
 <!-- section history:
   2017-10-14 j.h: Some updates
 -->
-<sect2 id="gimp-filter-pixelize">
+<sect2 id="gimp-filter-pixelize" xmlns:xi="http://www.w3.org/2001/XInclude";>
   <title>Pixelize</title>
 
   <indexterm>
@@ -72,11 +72,10 @@
     </figure>
     <variablelist>
       <varlistentry>
-        <term><guilabel>Presets</guilabel>, <guilabel>Preview</guilabel>, 
-          <guilabel>Split view</guilabel></term>
+        <term><guilabel>Presets</guilabel></term>
         <listitem>
           <para>
-            These options are common to GEGL-based filters. Please refer to 
+            This option is common to GEGL-based filters. Please refer to 
             <xref linkend="gimp-filters-common"/>.
           </para>
         </listitem>
@@ -127,34 +126,12 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term><guilabel>Use the selection as input</guilabel></term>
+        <term><guilabel>Clipping</guilabel></term>
         <listitem>
-          <para>
-            If this option is selected, the filter uses pixels in selection 
-            only.
-          </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><guilabel>Use the entire layer as input</guilabel></term>
-        <listitem>
-          <para>
-            If this option is selected, the filter uses pixels adjacent to the 
-            selection to create a more progressive border.
-          </para>
-          <para>
-            <mediaobject>
-              <imageobject>
-                <imagedata format="PNG"
-                  fileref="images/filters/examples/blur/pixelize-use.png"/>
-              </imageobject>
-              <caption>
-                <para>Left: selection only     Right: entire layer</para>
-              </caption>
-            </mediaobject>
-          </para>
+          <xi:include href="../clipping-feature.xml"/>
         </listitem>
       </varlistentry>
+      
     </variablelist>
   </sect3>
 </sect2>
diff --git a/src/filters/blur/zoom-motion.xml b/src/filters/blur/zoom-motion.xml
index a362c95d7..bb18a1547 100644
--- a/src/filters/blur/zoom-motion.xml
+++ b/src/filters/blur/zoom-motion.xml
@@ -4,7 +4,8 @@
 <!-- section history:
   2019-05-14 j.h: update to v2.10.10
 -->
-<sect2 id="gimp-filter-motion-blur-zoom">
+<sect2 id="gimp-filter-motion-blur-zoom" 
+xmlns:xi="http://www.w3.org/2001/XInclude";>
   <title>Zoom Motion Blur</title>
   
   <indexterm>
@@ -96,11 +97,9 @@
       </varlistentry>
       
       <varlistentry>
-        <term><guilabel>Use selection/entire layer as input</guilabel></term>
+        <term><guilabel>Clipping</guilabel></term>
         <listitem>
-          <para>
-            Explained in <xref linkend="gimp-filter-pixelize"/>.
-          </para>
+          <xi:include href="../clipping-feature.xml"/>
         </listitem>
       </varlistentry>
       
diff --git a/src/filters/clipping-feature.xml b/src/filters/clipping-feature.xml
new file mode 100644
index 000000000..42e71841c
--- /dev/null
+++ b/src/filters/clipping-feature.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                      "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!--
+  This file is meant to be included by GEGL filters files
+-->
+<para>
+  The result of this filter can be larger than the original image. 
+  With the default <guilabel>Adjust</guilabel> option, the layer 
+  will be automatically resized as necessary when the filter is
+  applied. With the <guilabel>Clip</guilabel> option the result 
+  will be clipped to the layer boundary.
+</para>
\ No newline at end of file
diff --git a/src/filters/enhance/deinterlace.xml b/src/filters/enhance/deinterlace.xml
index cb4b3b3b0..d6c9dca27 100644
--- a/src/filters/enhance/deinterlace.xml
+++ b/src/filters/enhance/deinterlace.xml
@@ -2,7 +2,7 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 
-<sect2 id="gimp-filter-deinterlace">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-deinterlace">
   <title>Deinterlace</title>
 
   <indexterm>
@@ -81,6 +81,12 @@
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Clipping</term>
+        <listitem>
+          <xi:include href="../clipping-feature.xml"/>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
 
diff --git a/src/filters/enhance/high-pass.xml b/src/filters/enhance/high-pass.xml
index 9227e46d0..a9645e9d5 100644
--- a/src/filters/enhance/high-pass.xml
+++ b/src/filters/enhance/high-pass.xml
@@ -6,7 +6,7 @@
   2018-11-15 j.h: Created
 -->
 
-<sect2 id="gimp-filter-high-pass">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-high-pass">
   <title>High Pass</title>
 
   <indexterm>
@@ -21,7 +21,12 @@
   <sect3>
     <title>Overview</title>
     <para>
-      In sound processing, a high-pass filter filters high frequencies above a threshold. In digital images, 
frequency refers to sudden changes in brightness or color in neighboring pixels. The High Pass filter filters 
high essential details, and larger scale gradients are removed. This result, combined with the original image 
and "Soft Light" or "Hard Light" merge mode, is used to sharpen images.
+      In sound processing, a high-pass filter filters high frequencies above 
+      a threshold. In digital images, frequency refers to sudden changes in 
+      brightness or color in neighboring pixels. The High Pass filter filters 
+      high essential details, and larger scale gradients are removed. This 
+      result, combined with the original image and "Soft Light" or "Hard 
+      Light" merge mode, is used to sharpen images. It enhances fine details.
     </para>
   </sect3>
 
@@ -78,6 +83,13 @@
           </para>
         </listitem>
       </varlistentry>
+      
+      <varlistentry>
+        <term><guilabel>Clipping</guilabel></term>
+        <listitem>
+          <xi:include href="../clipping-feature.xml"/>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
 
diff --git a/src/filters/enhance/noise-reduction.xml b/src/filters/enhance/noise-reduction.xml
index c55c6d435..577ae479b 100644
--- a/src/filters/enhance/noise-reduction.xml
+++ b/src/filters/enhance/noise-reduction.xml
@@ -2,7 +2,7 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 
-<sect2 id="gimp-filter-noise-reduction">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-noise-reduction">
   <title>Noise Reduction</title>
 
   <indexterm>
@@ -39,8 +39,8 @@
       <title>Noise Reduction filter options</title>
       <mediaobject>
         <imageobject>
-          <imagedata format="JPG"
-            fileref="images/filters/enhance/noise-reduction-dialog.jpg"/>
+          <imagedata format="PNG"
+            fileref="images/filters/enhance/noise-reduction-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -66,6 +66,13 @@
           </para>
         </listitem>
       </varlistentry>
+      
+      <varlistentry>
+        <term><guilabel>Clipping</guilabel></term>
+        <listitem>
+          <xi:include href="../clipping-feature.xml"/>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
   
diff --git a/src/filters/enhance/symmetric-nearest-neighbor.xml 
b/src/filters/enhance/symmetric-nearest-neighbor.xml
index 0963789cb..219e91bbb 100644
--- a/src/filters/enhance/symmetric-nearest-neighbor.xml
+++ b/src/filters/enhance/symmetric-nearest-neighbor.xml
@@ -6,7 +6,7 @@
   2018-11-25 j.h: Created
 -->
 
-<sect2 id="gimp-filter-snn-mean">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-snn-mean">
   <title>Symmetric Nearest Neighbor</title>
 
   <indexterm>
@@ -105,6 +105,13 @@
           </para>
         </listitem>
       </varlistentry>
+      
+      <varlistentry>
+        <term><guilabel>Clipping</guilabel></term>
+        <listitem>
+          <xi:include href="../clipping-feature.xml"/>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
 
diff --git a/src/filters/enhance/unsharp_mask.xml b/src/filters/enhance/unsharp_mask.xml
index 281920fa5..ddcc951f2 100644
--- a/src/filters/enhance/unsharp_mask.xml
+++ b/src/filters/enhance/unsharp_mask.xml
@@ -5,7 +5,7 @@
   2018-12-01 j.h: rename to Sharpen (Unsharp mask). Fix issue #88
   2006-12-17 Added a sect3 to explain Unsharp Mask by j.h
 -->
-<sect2 id="gimp-filter-unsharp-mask">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-unsharp-mask">
   <title>Sharpen (Unsharp Mask)</title>
 
   <indexterm>
@@ -150,6 +150,12 @@
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Clipping</term>
+        <listitem>
+          <xi:include href="../clipping-feature.xml"/>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
 
diff --git a/src/filters/light-and-shadow/drop-shadow.xml b/src/filters/light-and-shadow/drop-shadow.xml
index 5db247b62..34ce9831d 100644
--- a/src/filters/light-and-shadow/drop-shadow.xml
+++ b/src/filters/light-and-shadow/drop-shadow.xml
@@ -135,6 +135,12 @@
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Clipping</term>
+        <listitem>
+          <xi:include href="../clipping-feature.xml"/>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
   
diff --git a/src/filters/light-and-shadow/long-shadow.xml b/src/filters/light-and-shadow/long-shadow.xml
index 25c795f89..12c3e0638 100644
--- a/src/filters/light-and-shadow/long-shadow.xml
+++ b/src/filters/light-and-shadow/long-shadow.xml
@@ -184,6 +184,12 @@ fileref="images/filters/examples/light-and-shadow/long-shadow-ex-shadminus.png"/
           </figure>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Clipping</term>
+        <listitem>
+          <xi:include href="../clipping-feature.xml"/>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
 </sect2>
\ No newline at end of file
diff --git a/src/menus/select/feather.xml b/src/menus/select/feather.xml
index 74b947fd2..d1edf7fe5 100644
--- a/src/menus/select/feather.xml
+++ b/src/menus/select/feather.xml
@@ -56,7 +56,7 @@ format="PNG"/>
          </para>
         </listitem>
       </varlistentry>
-      <varlistentry>
+      <varlistentry id="selection-outside">
         <term>Selected area continue outside image</term>
         <listitem>
           <para>
diff --git a/src/menus/select/shrink.xml b/src/menus/select/shrink.xml
index ea1caddf0..cf7701e2f 100644
--- a/src/menus/select/shrink.xml
+++ b/src/menus/select/shrink.xml
@@ -56,14 +56,16 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Shrink from image border</term>
+        <term>Selected area continue outside image</term>
         <listitem>
           <para>
+            Was <quote>Shrink from image border</quote>; the action is 
+            unchanged.
             This option is only of interest if the selection runs along
             the edge of the image. If it does and this option is checked,
             then the selection shrinks away from the edge of the image. If
             this option is not checked, the selection continues to extend to
-            the image border.
+            the image border. See <xref linkend="selection-outside"/>.
           </para>
         </listitem>
       </varlistentry>


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