From de7270cb1e9510cb230e80045c812fa68fcfa585 Mon Sep 17 00:00:00 2001 From: Chris Wilson Date: Fri, 13 Feb 2009 10:03:22 +0000 Subject: [PATCH] [cairo] Describe the restrictions upon cairo_set_tolerance() Truc Troung reported that the behaviour of cairo_set_tolerance()/cairo_get_tolerance() was inconsistent with the documentation, i.e. we failed to mention that the tolerance would be restricted to the smalled fixed-point value. Add a sentence to the documentation that describes the restriction without mentioning what that is... Hopefully that is sufficient detail to accommodate the reporter, without exposing internal implementation details. Fixes https://bugs.freedesktop.org/show_bug.cgi?id=20095 Bug 20095 - The cairo_set_tolerance() function behavior is inconsistency with the spec --- src/cairo.c | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/src/cairo.c b/src/cairo.c index cefc92538..5f8d26616 100644 --- a/src/cairo.c +++ b/src/cairo.c @@ -816,7 +816,10 @@ cairo_get_source (cairo_t *cr) * is less than @tolerance. The default value is 0.1. A larger * value will give better performance, a smaller value, better * appearance. (Reducing the value from the default value of 0.1 - * is unlikely to improve appearance significantly.) + * is unlikely to improve appearance significantly.) The accuracy of paths + * within Cairo is limited by the precision of its internal arithmetic, and + * the prescribed @tolerance is restricted to the smallest + * representable internal value. **/ void cairo_set_tolerance (cairo_t *cr, double tolerance)