From 59885c6a122f593b417cb47dbd676eeac0cd8f69 Mon Sep 17 00:00:00 2001 From: Carl Worth Date: Tue, 23 May 2006 12:08:20 -0700 Subject: [PATCH] Clarify the documentation for cairo_set_dash Note that dash length units are evaluated in the user space at the time of the stroke operation, (not the user space at the time of cairo_set_dash). --- src/cairo.c | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/src/cairo.c b/src/cairo.c index cf87464e8..e9a0f33ac 100644 --- a/src/cairo.c +++ b/src/cairo.c @@ -897,9 +897,13 @@ cairo_set_line_join (cairo_t *cr, cairo_line_join_t line_join) * * Sets the dash pattern to be used by cairo_stroke(). A dash pattern * is specified by @dashes, an array of positive values. Each value - * provides the user-space length of alternate "on" and "off" portions - * of the stroke. The @offset specifies an offset into the pattern at - * which the stroke begins. + * provides the length of alternate "on" and "off" portions of the + * stroke. The @offset specifies an offset into the pattern at which + * the stroke begins. + * + * Note: The length values are in user-space units as evaluated at the + * time of stroking. This is not necessarily the same as the user + * space at the time of cairo_set_dash(). * * If @num_dashes is 0 dashing is disabled. *