[gimp] Bug 679083: proper documentation for plug-in-autocrop-layer

[Jehan Pagès <jehanp src gnome org>]

commit ba9fbde28844acc90211fdd2eb243ba9505c31c8
Author: Jehan <jehan girinstud io>
Date:   Fri Jul 5 13:12:55 2013 +0900

    Bug 679083: proper documentation for plug-in-autocrop-layer
    
    The current documentation have users think the argument layer is going
    to be cropped, whereas it actually only serves as a base for determining
    cropping extents. The active layer is the one to be cropped.
    Slightly more complete documentation explaining this.

 app/pdb/plug-in-compat-cmds.c       |    4 ++--
 tools/pdbgen/pdb/plug_in_compat.pdb |    5 +++--
 2 files changed, 5 insertions(+), 4 deletions(-)
---
diff --git a/app/pdb/plug-in-compat-cmds.c b/app/pdb/plug-in-compat-cmds.c
index 66575b3..051c6aa 100644
--- a/app/pdb/plug-in-compat-cmds.c
+++ b/app/pdb/plug-in-compat-cmds.c
@@ -975,8 +975,8 @@ register_plug_in_compat_procs (GimpPDB *pdb)
                                "plug-in-autocrop-layer");
   gimp_procedure_set_static_strings (procedure,
                                      "plug-in-autocrop-layer",
-                                     "Remove empty borders from the layer",
-                                     "Remove empty borders from the layer.",
+                                     "Crop the active layer based on empty borders of the input drawable",
+                                     "Crop the active layer of the input \"image\" based on empty borders of 
the input \"drawable\". \n\nThe input drawable serves as a base for detecting cropping extents (transparency 
or background color), and is not necessarily the cropped layer (the current active layer).",
                                      "Spencer Kimball & Peter Mattis",
                                      "Spencer Kimball & Peter Mattis",
                                      "1997",
diff --git a/tools/pdbgen/pdb/plug_in_compat.pdb b/tools/pdbgen/pdb/plug_in_compat.pdb
index 152fb2c..c5ae609 100644
--- a/tools/pdbgen/pdb/plug_in_compat.pdb
+++ b/tools/pdbgen/pdb/plug_in_compat.pdb
@@ -73,10 +73,11 @@ CODE
 }
 
 sub plug_in_autocrop_layer {
-    $blurb = 'Remove empty borders from the layer';
+    $blurb = 'Crop the active layer based on empty borders of the input drawable';
 
     $help = <<'HELP';
-Remove empty borders from the layer.
+Crop the active layer of the input "image" based on empty borders of the input "drawable".
+\n\nThe input drawable serves as a base for detecting cropping extents (transparency or background color), 
and is not necessarily the cropped layer (the current active layer).
 HELP
 
     &std_pdb_misc;