[show_text_glyphs] Replace the bool backward with cairo_text_cluster_flags

Chris rightfully complained that having a boolean function argument is
new in cairo_show_text_glyphs, and indeed avoiding them has been one
of the API design criteria for cairo.  Trying to come up with alternatives,
Owen suggested using a flag type which nicely solves the problem AND
future-proofs such a complex API.

Please welcome _flags_t APIs to cairo.h

4 files changed, 11 insertions, 3 deletions

diff --git a/doc/public/cairo-sections.txt b/doc/public/cairo-sections.txt
index 160de465..c179e922 100644
--- a/doc/public/cairo-sections.txt
+++ b/doc/public/cairo-sections.txt
@@ -398,6 +398,7 @@ cairo_glyph_t
 cairo_font_slant_t
 cairo_font_weight_t
 cairo_text_cluster_t
+cairo_text_cluster_flags_t
 cairo_select_font_face
 cairo_set_font_size
 cairo_set_font_matrix
diff --git a/doc/public/tmpl/cairo-scaled-font.sgml b/doc/public/tmpl/cairo-scaled-font.sgml
index 1abf0f3b..0a0599a5 100644
--- a/doc/public/tmpl/cairo-scaled-font.sgml
+++ b/doc/public/tmpl/cairo-scaled-font.sgml
@@ -133,7 +133,7 @@ size and transformation and a certain set of font options.
 @num_glyphs: 
 @clusters: 
 @num_clusters: 
-@backward: 
+@cluster_flags: 
 @Returns: 
 
 
diff --git a/doc/public/tmpl/cairo-text.sgml b/doc/public/tmpl/cairo-text.sgml
index 0883f270..64c63dae 100644
--- a/doc/public/tmpl/cairo-text.sgml
+++ b/doc/public/tmpl/cairo-text.sgml
@@ -79,6 +79,13 @@ Cairo has two sets of text rendering capabilities:
 @num_bytes: 
 @num_glyphs: 
 
+<!-- ##### ENUM cairo_text_cluster_flags_t ##### -->
+<para>
+
+</para>
+
+@CAIRO_TEXT_CLUSTER_FLAG_BACKWARD: 
+
 <!-- ##### FUNCTION cairo_select_font_face ##### -->
 <para>
 
@@ -211,7 +218,7 @@ Cairo has two sets of text rendering capabilities:
 @num_glyphs: 
 @clusters: 
 @num_clusters: 
-@backward: 
+@cluster_flags: 
 
 
 <!-- ##### FUNCTION cairo_font_extents ##### -->
diff --git a/doc/public/tmpl/cairo-user-fonts.sgml b/doc/public/tmpl/cairo-user-fonts.sgml
index c8f35346..5b6dc582 100644
--- a/doc/public/tmpl/cairo-user-fonts.sgml
+++ b/doc/public/tmpl/cairo-user-fonts.sgml
@@ -68,7 +68,7 @@ this feature (1.8 and later).
 @num_glyphs: 
 @clusters: 
 @num_clusters: 
-@backward: 
+@cluster_flags: 
 @Returns: