Deprecate clutter_[sg]et_font_flags()

We already have two mechanisms for controlling the font rendering
quality on a per-application basis:

  • ClutterSettings properties
  • clutter_backend_set_font_options()

The font flags were always a stop-gap solution, and one that tried to
simplify a fairly complex issue beyond the point of actually being
useful.

https://bugzilla.gnome.org/show_bug.cgi?id=660786

clutter/clutter-main.c

@@ -2846,6 +2846,9 @@ clutter_clear_glyph_cache (void)
  * introduce some artifacts if the text is animated.
  *
  * Since: 1.0
+ *
+ * Deprecated: 1.10: Use clutter_backend_set_font_options() and the
+ *   #cairo_font_option_t API.
  */
 void
 clutter_set_font_flags (ClutterFontFlags flags)
@@ -2897,6 +2900,9 @@ clutter_set_font_flags (ClutterFontFlags flags)
  * Return value: The font flags
  *
  * Since: 1.0
+ *
+ * Deprecated: 1.10: Use clutter_backend_get_font_options() and the
+ *   #cairo_font_options_t API.
  */
 ClutterFontFlags
 clutter_get_font_flags (void)

clutter/clutter-main.h

@@ -167,10 +167,9 @@ ClutterActor *   clutter_get_keyboard_grab           (void);
 
 #if !defined(CLUTTER_DISABLE_DEPRECATED) || defined(CLUTTER_COMPILATION)
 void             clutter_clear_glyph_cache           (void);
-#endif
-
 void             clutter_set_font_flags              (ClutterFontFlags flags);
 ClutterFontFlags clutter_get_font_flags              (void);
+#endif /* CLUTTER_DISABLE_DEPRECATED */
 
 #if !defined(CLUTTER_DISABLE_DEPRECATED) || defined(CLUTTER_COMPILATION)
 ClutterInputDevice *clutter_get_input_device_for_id  (gint id_);

clutter/clutter-types.h

@@ -429,6 +429,8 @@ typedef enum {
  * clutter_set_font_flags().
  *
  * Since: 1.0
+ *
+ * Deprecated: 1.10: Use the #ClutterBackend and #cairo_font_options_t instead
  */
 typedef enum
 {