[gimp-help] Fix issue #289: incorrect documentation for Image > Crop to content

[Jacob Boerema <jboerema src gnome org>]

commit 89c39a31ea8eea42f13f5c10f70e6f0fc759d20c
Author: Jacob Boerema <jgboerema gmail com>
Date:   Sun Mar 20 21:37:53 2022 -0400

    Fix issue #289: incorrect documentation for Image > Crop to content
    
    The Image -> Crop to content documentation, including the example
    images, still mostly had the old documentation for the previous
    Autocrop image, which functioned a bit different.
    
    We update the documentation here, add two new example images, and
    remove the old autocrop images.

 images/C/menus/image/autocrop-1.png             | Bin 1630 -> 0 bytes
 images/C/menus/image/autocrop-2.png             | Bin 1402 -> 0 bytes
 images/C/menus/image/crop-to-content-after.png  | Bin 0 -> 2357 bytes
 images/C/menus/image/crop-to-content-before.png | Bin 0 -> 3033 bytes
 src/menus/image/crop.xml                        |  34 +++++++++---------------
 5 files changed, 13 insertions(+), 21 deletions(-)
---
diff --git a/images/C/menus/image/crop-to-content-after.png b/images/C/menus/image/crop-to-content-after.png
new file mode 100644
index 000000000..0611d5265
Binary files /dev/null and b/images/C/menus/image/crop-to-content-after.png differ
diff --git a/images/C/menus/image/crop-to-content-before.png b/images/C/menus/image/crop-to-content-before.png
new file mode 100644
index 000000000..0b1c19ccf
Binary files /dev/null and b/images/C/menus/image/crop-to-content-before.png differ
diff --git a/src/menus/image/crop.xml b/src/menus/image/crop.xml
index 6a0a22552..bad934366 100644
--- a/src/menus/image/crop.xml
+++ b/src/menus/image/crop.xml
@@ -56,11 +56,11 @@
       <para>
         This command crops all of the image layers. To crop the active layer 
         only, use the <link linkend="crop-layer-to-selection">Crop to 
-        selection</link> command.
+        selection</link> command from the Layer menu.
       </para>
     </note>
     <para>
-      You can access this command on the image menu bar through
+      You can access this command from the menu through
       <menuchoice>
         <guimenu>Image</guimenu>
         <guimenuitem>Crop to Selection</guimenuitem>
@@ -71,53 +71,45 @@
   <sect3 id="crop-image-to-content">
     <title>Crop to content</title>
     <para>
-      Before GIMP-2.10, this command was named <quote>Autocrop image</quote>. 
+      Before GIMP-2.10, this command was named <quote>Autocrop image</quote>
+      and functioned a bit different. 
       The <guimenuitem>Crop to content</guimenuitem> command removes the
-      borders from an image. It searches the active layer for the largest
+      borders from an image. It searches the layers for the largest
       possible border area that is all the same color, and then crops this
       area from the image, as if you had used the
       <link linkend="gimp-tool-crop">Crop</link> tool.
     </para>
-    <caution>
-      <para>
-        Note carefully that this command only uses the
-        <emphasis>active layer</emphasis> of the image to find borders. 
-        Other layers are cropped according to the same limits as limits in 
-        the active layer.
-      </para>
-    </caution>
     <figure>
       <title><quote>Crop to content</quote> example</title>
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/menus/image/autocrop-1.png"/>
+            fileref="images/menus/image/crop-to-content-before.png"/>
         </imageobject>
         <caption>
           <para>
             This image is made of three layers. One with a red square,
-            another with a green square; both on a yellow semi-transparent
-            background. The green layer is active.
+            another with a green square, and a yellow background.
+            The green layer is active.
           </para>
         </caption>
       </mediaobject>
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/menus/image/autocrop-2.png"/>
+            fileref="images/menus/image/crop-to-content-after.png"/>
         </imageobject>
         <caption>
           <para>
-            <quote>Crop to content</quote> has cropped the green square and 
-            made a layer from it. The other layers have been cropped to the 
-            same size as the green one. Only a small part of the red square has
-            been kept.
+            <quote>Crop to content</quote> has cropped the image to the outer
+            borders of the green and red layers. Only the part of the yellow
+            layer inside the red-green area has been kept.
           </para>
         </caption>
       </mediaobject>
     </figure>
     <para>
-      You can access this command on the image menu bar through
+      You can access this command from the menu through
       <menuchoice>
         <guimenu>Image</guimenu>
         <guimenuitem>Crop to Content</guimenuitem>