[gegl] Improve docs in gegl-utils
- From: Daniel Sabo <daniels src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gegl] Improve docs in gegl-utils
- Date: Tue, 25 Feb 2014 01:16:05 +0000 (UTC)
commit b18b2d05640a17f2e76903bd2d592429fe35175f
Author: Daniel Sabo <DanielSabo gmail com>
Date: Tue Feb 11 13:41:10 2014 -0800
Improve docs in gegl-utils
* Note that the destination pointers may alias the inputs.
* Fix some typos.
gegl/gegl-utils.h | 14 ++++++++++----
1 files changed, 10 insertions(+), 4 deletions(-)
---
diff --git a/gegl/gegl-utils.h b/gegl/gegl-utils.h
index 0b1fc92..d4d3d03 100644
--- a/gegl/gegl-utils.h
+++ b/gegl/gegl-utils.h
@@ -125,6 +125,8 @@ GeglRectangle *gegl_rectangle_dup (const GeglRectangle *rectangle);
*
* Copies the rectangle information stored in @source over the information in
* @destination.
+ *
+ * @destination may point to the same object as @source.
*/
void gegl_rectangle_copy (GeglRectangle *destination,
const GeglRectangle *source);
@@ -137,6 +139,8 @@ void gegl_rectangle_copy (GeglRectangle *destination,
*
* Computes the bounding box of the rectangles @source1 and @source2 and stores the
* resulting bounding box in @destination.
+ *
+ * @destination may point to the same object as @source1 or @source2.
*/
void gegl_rectangle_bounding_box (GeglRectangle *destination,
const GeglRectangle *source1,
@@ -148,9 +152,11 @@ void gegl_rectangle_bounding_box (GeglRectangle *destination,
* @src1: a #GeglRectangle
* @src2: a #GeglRectangle
*
- * Calculates the intersection of two rectangles. It is allows for dest to be the same
- * as either @src1 or @src2. If the rectangles do not intersect, dest's width and height
- * are set to 0 and its x and y values are undefined.
+ * Calculates the intersection of two rectangles. If the rectangles do not
+ * intersect, dest's width and height are set to 0 and its x and y values
+ * are undefined.
+ *
+ * @dest may point to the same object as @src1 or @src2.
*
* Returns TRUE if the rectangles intersect.
*/
@@ -236,7 +242,7 @@ gpointer gegl_calloc (gsize size, int n_memb) G_GNUC_MALLOC;
* @pattern_size: the length of @src_ptr
* @count: number of copies
*
- * Fill @dst_ptr with @count copies of the byes in @src_ptr.
+ * Fill @dst_ptr with @count copies of the bytes in @src_ptr.
*/
void gegl_memset_pattern (void * dst_ptr,
const void * src_ptr,
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]