[gimp-help-2] Update menus/select/border.xml

[Julien Hardlin <jhardlin src gnome org>]

commit a46bef166ebf1551a11ebec25bebbf0faaf19e2f
Author: Julien Hardelin <jhardlin orange fr>
Date:   Tue Mar 21 15:02:54 2017 +0100

    Update menus/select/border.xml

 images/C/menus/select/border-feathered.png |  Bin 0 -> 2396 bytes
 images/C/menus/select/border-hard.png      |  Bin 1477 -> 1867 bytes
 images/C/menus/select/border-smooth.png    |  Bin 0 -> 2138 bytes
 src/menus/select/border.xml                |  117 ++++++++++++++++++++++++----
 4 files changed, 101 insertions(+), 16 deletions(-)
---
diff --git a/images/C/menus/select/border-feathered.png b/images/C/menus/select/border-feathered.png
new file mode 100644
index 0000000..d9c502e
Binary files /dev/null and b/images/C/menus/select/border-feathered.png differ
diff --git a/images/C/menus/select/border-hard.png b/images/C/menus/select/border-hard.png
index 539939e..667ad69 100644
Binary files a/images/C/menus/select/border-hard.png and b/images/C/menus/select/border-hard.png differ
diff --git a/images/C/menus/select/border-smooth.png b/images/C/menus/select/border-smooth.png
new file mode 100644
index 0000000..db677cb
Binary files /dev/null and b/images/C/menus/select/border-smooth.png differ
diff --git a/src/menus/select/border.xml b/src/menus/select/border.xml
index c5fd8e4..ee584c5 100644
--- a/src/menus/select/border.xml
+++ b/src/menus/select/border.xml
@@ -1,8 +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";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+                       "http://www.docbook.org/xml/4.5/docbookx.dtd";>
 <!-- section history:
-  2009-01-10 j.h: reviewed for v2.6
+  2017-03-20 j.h: update to v2.9
   2007-08-05 ude: added new options of GIMP 2.4.
 -->
 <sect2 id="gimp-selection-border">
@@ -55,11 +55,35 @@
       You can access this command from the image menubar through
       <menuchoice>
         <guimenu>Select</guimenu>
-        <guimenuitem>Border</guimenuitem>
+        <guimenuitem>Border…</guimenuitem>
       </menuchoice>.
     </para>
+    <para>
+      This command is grayed out, inactive, if there is no selection.
+    </para>
+    <!--</sect3>
+  <sect3>
+    <note>-->
+      <para>
+        Two conditions must be respected to use this command:         
+        <itemizedlist>
+          <listitem>
+            <para>
+              The image must have an alpha channel.
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              The original image must be created with the 
+              <quote>Antialiasing</quote> option checked in the selection tool 
+              that is used.
+            </para>
+          </listitem>
+        </itemizedlist>
+      </para>
+      <!--</note>-->
   </sect3>
-
+  
   <sect3>
     <title>Description of the <quote>Border</quote> dialog window</title>
     <figure>
@@ -82,29 +106,90 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Feather border</term>
+        <term>Border Style</term>
         <listitem>
-          <para>
-            If this option is checked, the edges of the selection will be
-            feathered. This creates a smooth transition between the selection
-            and its surroundings. Note than you can't use the
-            <guilabel>Feather Edges</guilabel> option of the selection tools
-            for this purpose.
-          </para>
+          <itemizedlist>
+            <listitem>
+              <para>
+                <emphasis role="bold">Hard</emphasis>: this option does not 
+                keep antialiasing. This can be useful in some cases.
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+                <emphasis role="bold">Smooth</emphasis>: this option does not 
+                keeps antialiasing. Note that <quote>Smooth</quote> does not 
+                create any antialiasing. That's why antialiasing must be 
+                added when creating the original selection. This option is 
+                the best one.
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+                <emphasis role="bold">Feathered</emphasis>: this option does 
+                the same things as <quote>Hard</quote>, but instead of the 
+                resulting border being fully selected, it fades outwards. The 
+                result is not very good; if you want a feathered border, 
+                better is use one of the other modes, and then feather the 
+                result. It's there for history reason.
+              </para>
+            </listitem>
+          </itemizedlist>
+          
+          <figure>
+            <title>Border Style Comparison</title>           
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG" 
+                  fileref="images/menus/select/border-hard.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  <quote>Hard</quote> option. Selection editor, zoom 800%
+                </para>
+              </caption>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG" 
+                  fileref="images/menus/select/border-smooth.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  <quote>Smooth</quote> option. Selection editor, zoom 800%
+                </para>
+              </caption>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG" 
+                  fileref="images/menus/select/border-feathered.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  <quote>Feathered</quote> option. Selection editor, zoom 800%
+                </para>
+              </caption>
+            </mediaobject>
+          </figure>             
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Lock selection to image edges</term>
+        <term>Selected areas continue outside the image</term>
         <listitem>
           <para>
+            This option was <quote>Lock selection to image edges</quote>. Its 
+            function is unchanged.           
+          </para>
+          <para>
             With this option enabled, an edge of an (usually rectangle)
             selection remains unchanged if it is aligned with an edge of the
             image; no new selection will be created around it.
           </para>
           <figure>
             <title>
-              Select border with and without <quote>Lock to image
-              edges</quote>
+              Select border with and without <quote>Selected areas continue 
+              outside the image</quote>
             </title>
             <mediaobject>
               <imageobject>