From 5227897b17d04fc6b8604d84847f85a1deb0c1f2 Mon Sep 17 00:00:00 2001 From: Behdad Esfahbod Date: Fri, 8 Aug 2008 17:06:21 -0400 Subject: [PATCH] Add note about zero-glyph clusters --- src/cairo.h | 3 +++ 1 file changed, 3 insertions(+) diff --git a/src/cairo.h b/src/cairo.h index 8b50c045a..52a34e949 100644 --- a/src/cairo.h +++ b/src/cairo.h @@ -847,6 +847,9 @@ cairo_glyph_free (cairo_glyph_t *glyphs); * * For a cluster to be valid, both @num_bytes and @num_glyphs should * be non-negative, and at least one should be non-zero. + * Note that clusters with zero glyphs are not as well supported as + * normal clusters. For example, PDF rendering applications typically + * ignore those clusters when PDF text is being selected. * * See cairo_show_text_glyphs() for how clusters are used in advanced * text operations.