[gimp] app: add a quick doc for gimp_item_mask_intersect()

[Michael Natterer <mitch src gnome org>]

commit 7e962d36e2de20f861b7b81bae434d2db5896fe5
Author: Michael Muré <batolettre gmail com>
Date:   Sat Jul 2 22:27:48 2011 +0200

    app: add a quick doc for gimp_item_mask_intersect()

 app/core/gimpitem.c |   12 ++++++++++++
 1 files changed, 12 insertions(+), 0 deletions(-)
---
diff --git a/app/core/gimpitem.c b/app/core/gimpitem.c
index c6bf279..3fe4b61 100644
--- a/app/core/gimpitem.c
+++ b/app/core/gimpitem.c
@@ -2188,6 +2188,18 @@ gimp_item_mask_bounds (GimpItem *item,
   return retval;
 }
 
+/**
+ * gimp_item_mask_intersect:
+ * @item:   a #GimpItem
+ * @x:      return location for x
+ * @y:      return location for y
+ * @width:  return location for the width
+ * @height: return location for the height
+ *
+ * Intersect the area of the @item and its image's selection mask.
+ * The computed area is the bounding box of he selection within the
+ * item.
+ **/
 gboolean
 gimp_item_mask_intersect (GimpItem *item,
                           gint     *x,