[cairo-commit] 2 commits - src/cairo.c src/cairo-clip.c src/cairo.h

[Carl Worth]

 src/cairo-clip.c |   10 ++++++++++
 src/cairo.c      |    4 ++++
 src/cairo.h      |    6 +++++-
 3 files changed, 19 insertions(+), 1 deletion(-)

New commits:
diff-tree 3b58d92f5a449e7d5edf39484465e2ce6acf4874 (from 9cacced88fa9dbaa53ff8dec6ff31c8e56c85f08)
Author: Carl Worth <cworth at cworth.org>
Date:   Fri Sep 29 17:47:01 2006 -0700

    Add missing 'Since: 1.4' tags to documentation of 'clip getter' functions.
    
    The following documented symbols were missing this tag:
    
    	cairo_clip_extents
    	cairo_copy_clip_rectangles
    	CAIRO_STATUS_INVALID_INDEX
    	cairo_rectangle_t
    	cairo_rectangle_list_t

diff --git a/src/cairo.c b/src/cairo.c
index cda9b0e..b47dd48 100644
--- a/src/cairo.c
+++ b/src/cairo.c
@@ -2232,6 +2232,8 @@ cairo_reset_clip (cairo_t *cr)
  *
  * Computes a bounding box in user coordinates covering the area inside the
  * current clip.
+ *
+ * Since: 1.4
  **/
 void
 cairo_clip_extents (cairo_t *cr,
@@ -2273,6 +2275,8 @@ _cairo_rectangle_list_create_for_status 
  *
  * The caller must always call cairo_rectangle_list_destroy on the result of
  * this function.
+ *
+ * Since: 1.4
  **/
 cairo_rectangle_list_t *
 cairo_copy_clip_rectangles (cairo_t *cr)
diff --git a/src/cairo.h b/src/cairo.h
index 7a3b653..a53a8b8 100644
--- a/src/cairo.h
+++ b/src/cairo.h
@@ -169,7 +169,7 @@ typedef struct _cairo_user_data_key {
  * @CAIRO_STATUS_FILE_NOT_FOUND: file not found
  * @CAIRO_STATUS_INVALID_DASH: invalid value for a dash setting
  * @CAIRO_STATUS_INVALID_DSC_COMMENT: invalid value for a DSC comment (Since 1.2)
- * @CAIRO_STATUS_INVALID_INDEX: invalid index passed to getter
+ * @CAIRO_STATUS_INVALID_INDEX: invalid index passed to getter (Since 1.4)
  * @CAIRO_STATUS_CLIP_NOT_REPRESENTABLE: clip region not representable in desired format (Since 1.4)
  *
  * #cairo_status_t is used to indicate errors that can occur when
@@ -600,6 +600,8 @@ cairo_clip_extents (cairo_t *cr,
  * cairo_rectangle_t:
  * 
  * A data structure for holding a rectangle.
+ *
+ * Since: 1.4
  */
 typedef struct _cairo_rectangle {
     double x, y, width, height;
@@ -610,6 +612,8 @@ typedef struct _cairo_rectangle {
  * 
  * A data structure for holding a dynamically allocated
  * array of rectangles.
+ *
+ * Since: 1.4
  */
 typedef struct _cairo_rectangle_list {
     cairo_status_t     status;
diff-tree 9cacced88fa9dbaa53ff8dec6ff31c8e56c85f08 (from 34d11aa3c45ba672b34d0a17f672f907305f3893)
Author: Carl Worth <cworth at cworth.org>
Date:   Fri Sep 29 17:44:34 2006 -0700

    Add documentation for cairo_rectangle_list_destroy

diff --git a/src/cairo-clip.c b/src/cairo-clip.c
index a0f67fa..3f7c0c0 100644
--- a/src/cairo-clip.c
+++ b/src/cairo-clip.c
@@ -649,6 +649,16 @@ _cairo_clip_copy_rectangles (cairo_clip_
     return list;
 }
 
+/**
+ * cairo_rectangle_list_destroy:
+ * @rectangle_list: a rectangle list, as obtained from cairo_copy_clip_rectangles()
+ *
+ * Unconditionally frees @rectangle_list and all associated
+ * references. After this call, the @rectangle_list pointer must not
+ * be dereferenced.
+ *
+ * Since: 1.4
+ **/
 void
 cairo_rectangle_list_destroy (cairo_rectangle_list_t *rectangle_list)
 {