From 02b54ca6200b3e5a914b293dd4a0d56f432a5a9b Mon Sep 17 00:00:00 2001 From: Carl Worth Date: Wed, 2 Aug 2006 11:18:14 -0400 Subject: [PATCH] Improve docs for cairo_surface_create_similar() --- src/cairo-surface.c | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/src/cairo-surface.c b/src/cairo-surface.c index cad5a33c8..8e24773e4 100644 --- a/src/cairo-surface.c +++ b/src/cairo-surface.c @@ -276,11 +276,12 @@ _cairo_surface_create_similar_scratch (cairo_surface_t *other, * @height: height of the new surface (in device-space units) * * Create a new surface that is as compatible as possible with an - * existing surface. The new surface will use the same backend as - * @other unless that is not possible for some reason. However, the - * created surface will have same fallback resolution and font options - * as the existing surface. The type of the returned surface may be - * examined with cairo_surface_get_type(). + * existing surface. For example the new surface will have the same + * fallback resolution and font options as @other. Generally, the new + * surface will also use the same backend as @other, unless that is + * not possible for some reason. The type of the returned surface may + * be examined with cairo_surface_get_type(). + * * Initially the surface contents are all 0 (transparent if contents * have transparency, black otherwise.) *