[cairo] patches for cairo_arc and cairo_pattern_type_t documentation
Jonathan Watt
jwatt at jwatt.org
Sat Sep 30 10:54:41 PDT 2006
Hi,
I had some questions after reading the manual's description of cairo_arc which
Carl kindly cleared up for me. I've attached a suggested patch for the cairo_arc
documentation, and an additional patch for a typo in the description of
cairo_pattern_type_t.
Regards,
Jonathan
-------------- next part --------------
diff --git a/src/cairo.c b/src/cairo.c
index cda9b0e..ad3eba8 100644
--- a/src/cairo.c
+++ b/src/cairo.c
@@ -1405,7 +1405,14 @@ slim_hidden_def (cairo_curve_to);
*
* If there is a current point, an initial line segment will be added
* to the path to connect the current point to the beginning of the
- * arc.
+ * arc. To prevent an initial line segment from being added to the path,
+ * preceed the call to cairo_arc with a call to cairo_new_sub_path to
+ * remove the current point. With no current point an initial move_to
+ * will be added to the path instead of the line_to.
+ *
+ * Calls to cairo_arc insert as many curve_to path segments as
+ * necessary to approximate the arc to the tolerance specified by
+ * cairo_set_tolerance.
*
* Angles are measured in radians. An angle of 0.0 is in the direction
* of the positive X axis (in user space). An angle of %M_PI/2.0 radians
-------------- next part --------------
diff --git a/src/cairo.h b/src/cairo.h
index 7a3b653..c3d4eb6 100644
--- a/src/cairo.h
+++ b/src/cairo.h
@@ -1493,7 +1493,7 @@ cairo_pattern_status (cairo_pattern_t *p
* cairo_pattern_type_t
* @CAIRO_PATTERN_TYPE_SOLID: The pattern is a solid (uniform)
* color. It may be opaque or translucent.
- * @CAIRO_PATTERN_TYPE_SURFACE: The pattern is a based on a surface (an image).
+ * @CAIRO_PATTERN_TYPE_SURFACE: The pattern is based on a surface (an image).
* @CAIRO_PATTERN_TYPE_LINEAR: The pattern is a linear gradient.
* @CAIRO_PATTERN_TYPE_RADIAL: The pattern is a radial gradient.
*
More information about the cairo
mailing list