[gimp-help-2] Re-write auto-shrink

[Julien Hardlin <jhardlin src gnome org>]

commit ab6250946396e45a9bd2810a4c7fd0c6c1d59929
Author: Julien Hardelin <jhardlin orange fr>
Date:   Sun Dec 27 07:57:21 2015 +0100

    Re-write auto-shrink

 images/C/toolbox/auto-shrink1.png         |  Bin 527 -> 0 bytes
 images/C/toolbox/auto-shrink2.png         |  Bin 474 -> 0 bytes
 images/C/toolbox/autoshrink-1.png         |  Bin 0 -> 1975 bytes
 images/C/toolbox/autoshrink-2.png         |  Bin 0 -> 1771 bytes
 images/C/toolbox/tool-options-rectsel.png |  Bin 6922 -> 30988 bytes
 src/toolbox/selection/rectangle.xml       |   47 ++++++++++++++++++++++++++++-
 6 files changed, 46 insertions(+), 1 deletions(-)
---
diff --git a/images/C/toolbox/autoshrink-1.png b/images/C/toolbox/autoshrink-1.png
new file mode 100644
index 0000000..aa624ae
Binary files /dev/null and b/images/C/toolbox/autoshrink-1.png differ
diff --git a/images/C/toolbox/autoshrink-2.png b/images/C/toolbox/autoshrink-2.png
new file mode 100644
index 0000000..b37738b
Binary files /dev/null and b/images/C/toolbox/autoshrink-2.png differ
diff --git a/images/C/toolbox/tool-options-rectsel.png b/images/C/toolbox/tool-options-rectsel.png
index 0c3f8a3..6087b32 100644
Binary files a/images/C/toolbox/tool-options-rectsel.png and b/images/C/toolbox/tool-options-rectsel.png 
differ
diff --git a/src/toolbox/selection/rectangle.xml b/src/toolbox/selection/rectangle.xml
index a4d90ec..b27e87c 100644
--- a/src/toolbox/selection/rectangle.xml
+++ b/src/toolbox/selection/rectangle.xml
@@ -2,7 +2,7 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2015-12-21 j.h fixed bug #758890: deleted autoshrink option that no longer exists
+  2015-12-27 j.h rewrite auto-shrink 
   2008-03-19 JPL rewiewed & modified en
   2006-06-12 changed Ctrl+Shift section by j.h
   2005-12-06 replaced simplesect by sect3 by lexa
@@ -417,6 +417,51 @@
           </para>
         </listitem>
       </varlistentry>
+      
+      <varlistentry>
+        <term>Auto Shrink Selection</term>
+        <listitem>
+          <para>
+            This option is active when a rectangle selection is drawn.
+            Clicking on the <guibutton>Auto Shrink Selection</guibutton> 
+            button will make the selection automatically shrink to the 
+            nearest rectangular shape including elements in the selection. 
+            The algorithm for finding the best rectangle to shrink to is
+            <quote>intelligent</quote>, which in this case means that it
+            sometimes does surprisingly sophisticated things, and sometimes
+            does surprisingly strange things. In any case, if the region
+            that you want to select has a solid-colored surround,
+            auto-shrinking will always pick it out correctly. Note that
+            the resulting selection does not need to have the
+            same shape as the one you sweep out.
+          </para>
+          <figure>
+            <title>Auto Shrink example</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/toolbox/autoshrink-1.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Image with two distinct elements selected
+                </para>
+              </caption>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/toolbox/autoshrink-2.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Auto Shrink applied
+                </para>
+              </caption>
+            </mediaobject>
+          </figure>             
+        </listitem>
+      </varlistentry>
 
       <varlistentry>
         <term>Shrink merged</term>