[gimp-help] Updates in selection tools

[Julien Hardlin <jhardlin src gnome org>]

commit d9a80d315bc5b033d33d0b18247bad99302e5d6e
Author: Julien Hardelin <jhardlin orange fr>
Date:   Tue Nov 19 07:13:33 2019 +0100

    Updates in selection tools

 src/toolbox/selection/foreground.xml | 38 ++++++++++++++++++++++++------------
 src/toolbox/selection/free.xml       | 10 ++++++++++
 2 files changed, 36 insertions(+), 12 deletions(-)
---
diff --git a/src/toolbox/selection/foreground.xml b/src/toolbox/selection/foreground.xml
index d321c874c..222f4472d 100644
--- a/src/toolbox/selection/foreground.xml
+++ b/src/toolbox/selection/foreground.xml
@@ -33,7 +33,7 @@ xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-foreground-select">
     This tool lets you extract the foreground from the active layer or from a
     selection. With <acronym>GIMP</acronym>-2.10, selection refinement has 
     been improved. After the selection is made, with its marching ants, you can 
-    copy-paste or click-and-drag it to another image used as background,and, 
+    copy-paste or click-and-drag it to another image used as background, and, 
     inverting the selection, you can can make changes in background.
   </para>
 
@@ -169,11 +169,11 @@ xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-foreground-select">
       <step>
         <para>
           <emphasis>Draw a line through the foreground</emphasis>: using the
-          paintbrush, whose size can be changed in options, draw a continuous
-          line in the selected foreground going over colors which will be
-          kept for the extraction. The color used to draw the line is of no
-          importance; not using the same color as foreground is better. Be
-          careful not painting background pixels.
+          default selected paintbrush, whose size can be changed in options, 
+          draw a continuous line in the selected foreground going over colors 
+          which will be kept for the extraction. The color used to draw the 
+          line is of no importance; not using the same color as foreground is 
+          better. Be careful not painting background pixels.
         </para>
         <para>
           With this one-color object distinctly different from background, a 
@@ -257,8 +257,8 @@ xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-foreground-select">
             background.
           </para>
           <para>
-            <guilabel>Draw unknown</guilabel>: to add to your selection pixels 
-            that are in background.
+            <guilabel>Draw unknown</guilabel>: to add pixels 
+            that are in background to your selection.
           </para>
         </listitem>
       </varlistentry>
@@ -271,11 +271,25 @@ xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-foreground-select">
         </listitem>
       </varlistentry>  
       <varlistentry>
-        <term>Preview mask</term>
+        <term>Preview mode</term>
         <listitem>
-          <para>
-            You can adapt the color of the preview to your image.
-          </para>
+          <itemizedlist>
+            <listitem>
+              <para>
+                <guilabel>Color</guilabel> (default): you can adapt the color 
+                of the preview to your image, clicking on the color swatch.
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+                <guilabel>Grayscale</guilabel> : new in GIMP-2.10.14, to see 
+                the resulting mask in black and white. This preview is similar 
+                to a layer mask. It is useful in images where FG color and BG 
+                color are not very different and limit between them nor very 
+                evident.
+              </para>
+            </listitem>
+          </itemizedlist>
         </listitem>
       </varlistentry> 
       <varlistentry>
diff --git a/src/toolbox/selection/free.xml b/src/toolbox/selection/free.xml
index 7ca558f04..574ce5d44 100644
--- a/src/toolbox/selection/free.xml
+++ b/src/toolbox/selection/free.xml
@@ -198,5 +198,15 @@
       See <link linkend="gimp-tool-select">Selection Tools</link> for
       help with these.
     </para>
+    <para>
+      Since GIMP-2.10.12, selection modes work differently. Marching ants 
+      come with a continuous line, meaning that the selection is not validated 
+      yet and that you can still change the selection shape (mouse pointer 
+      comes with the Move icon). But you can't use "Hold Shift, Ctrl...) yet. 
+      You have to hit the <keycap>Enter</keycap> key. Then you can use Hold 
+      Shift to add a selection, Hold Ctrl to subtract a selection, Hold Shift 
+      + Ctrl to intersect two selections. When you are satisfied with 
+      your changes, hit <keycap>Enter</keycap> key to validate the selection.
+    </para>
   </sect3>
 </sect2>