[gimp/soc-2011-warp: 42/56] gimpitem: add a quick doc for gimp_item_mask_intersect

[Michael Murà <mmure src gnome org>]

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

    gimpitem: add a quick doc for gimp_item_mask_intersect

 app/core/gimpitem.c |   13 ++++++++++++-
 1 files changed, 12 insertions(+), 1 deletions(-)
---
diff --git a/app/core/gimpitem.c b/app/core/gimpitem.c
index 92e5dbe..e3a6ec9 100644
--- a/app/core/gimpitem.c
+++ b/app/core/gimpitem.c
@@ -2100,9 +2100,20 @@ gimp_item_mask_bounds (GimpItem *item,
   if (x2) *x2 = tmp_x2;
   if (y2) *y2 = tmp_y2;
 
-  return retval;;
+  return retval;
 }
 
+/**
+ * gimp_item_mask_intersect:
+ * @item: a #GimpItem
+ * @x: return value for x
+ * @y: return value for y
+ * @width: return value for the width
+ * @height: return value for the height
+ *
+ * Intersect the area of the @item and his selection mask.
+ * The computed area is the bounding box of he selection within the item.
+ */
 gboolean
 gimp_item_mask_intersect (GimpItem *item,
                           gint     *x,