[gtk+/gtk-3-22] font button: Deprecate the font-name property

[Matthias Clasen <matthiasc src gnome org>]

commit 87e16156105938c5b31b6fc1efc4e113d62238cc
Author: Matthias Clasen <mclasen redhat com>
Date:   Thu Dec 21 11:12:23 2017 -0500

    font button: Deprecate the font-name property
    
    It has long been redundant with the GtkFontChooser::font
    property.

 gtk/gtkfontbutton.c |   25 +++++++++++++++++++------
 gtk/gtkfontbutton.h |    4 ++--
 2 files changed, 21 insertions(+), 8 deletions(-)
---
diff --git a/gtk/gtkfontbutton.c b/gtk/gtkfontbutton.c
index b1e0000..3cf5da3 100644
--- a/gtk/gtkfontbutton.c
+++ b/gtk/gtkfontbutton.c
@@ -133,6 +133,9 @@ static void dialog_destroy                          (GtkWidget         *widget,
 static void gtk_font_button_label_use_font          (GtkFontButton     *gfs);
 static void gtk_font_button_update_font_info        (GtkFontButton     *gfs);
 
+static void font_button_set_font_name               (GtkFontButton     *font_button,
+                                                     const char        *fontname);
+
 static guint font_button_signals[LAST_SIGNAL] = { 0 };
 
 static void
@@ -484,6 +487,7 @@ gtk_font_button_class_init (GtkFontButtonClass *klass)
    * The name of the currently selected font.
    *
    * Since: 2.4
+   * @Deprecated: Use the #GtkFontChooser::font property instead
    */
   g_object_class_install_property (gobject_class,
                                    PROP_FONT_NAME,
@@ -491,7 +495,7 @@ gtk_font_button_class_init (GtkFontButtonClass *klass)
                                                         P_("Font name"),
                                                         P_("The name of the selected font"),
                                                         _("Sans 12"),
-                                                        GTK_PARAM_READWRITE));
+                                                        GTK_PARAM_READWRITE | G_PARAM_DEPRECATED));
 
   /**
    * GtkFontButton:use-font:
@@ -662,7 +666,7 @@ gtk_font_button_set_property (GObject      *object,
       break;
     case GTK_FONT_CHOOSER_PROP_FONT:
     case PROP_FONT_NAME:
-      gtk_font_button_set_font_name (font_button, g_value_get_string (value));
+      font_button_set_font_name (font_button, g_value_get_string (value));
       break;
     case PROP_USE_FONT:
       gtk_font_button_set_use_font (font_button, g_value_get_boolean (value));
@@ -1003,6 +1007,7 @@ gtk_font_button_set_show_size (GtkFontButton *font_button,
  * Returns: an internal copy of the font name which must not be freed.
  *
  * Since: 2.4
+ * Deprecated: 3.22: Use gtk_font_chooser_get_font() instead
  */
 const gchar *
 gtk_font_button_get_font_name (GtkFontButton *font_button)
@@ -1012,6 +1017,16 @@ gtk_font_button_get_font_name (GtkFontButton *font_button)
   return font_button->priv->fontname;
 }
 
+static void
+font_button_set_font_name (GtkFontButton *font_button,
+                           const char    *fontname)
+{
+  PangoFontDescription *font_desc;
+
+  font_desc = pango_font_description_from_string (fontname);
+  gtk_font_button_take_font_desc (font_button, font_desc);
+}
+
 /**
  * gtk_font_button_set_font_name:
  * @font_button: a #GtkFontButton
@@ -1022,18 +1037,16 @@ gtk_font_button_get_font_name (GtkFontButton *font_button)
  * Returns: %TRUE
  *
  * Since: 2.4
+ * Deprecated: 3.22: Use gtk_font_chooser_set_font() instead
  */
 gboolean 
 gtk_font_button_set_font_name (GtkFontButton *font_button,
                                const gchar    *fontname)
 {
-  PangoFontDescription *font_desc;
-
   g_return_val_if_fail (GTK_IS_FONT_BUTTON (font_button), FALSE);
   g_return_val_if_fail (fontname != NULL, FALSE);
 
-  font_desc = pango_font_description_from_string (fontname);
-  gtk_font_button_take_font_desc (font_button, font_desc);
+  font_button_set_font_name (font_button, fontname);
 
   return TRUE;
 }
diff --git a/gtk/gtkfontbutton.h b/gtk/gtkfontbutton.h
index 2a7dae6..d8609a6 100644
--- a/gtk/gtkfontbutton.h
+++ b/gtk/gtkfontbutton.h
@@ -92,9 +92,9 @@ gboolean              gtk_font_button_get_use_size   (GtkFontButton *font_button
 GDK_AVAILABLE_IN_ALL
 void                  gtk_font_button_set_use_size   (GtkFontButton *font_button,
                                                       gboolean       use_size);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_22
 const gchar *         gtk_font_button_get_font_name  (GtkFontButton *font_button);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_22
 gboolean              gtk_font_button_set_font_name  (GtkFontButton *font_button,
                                                       const gchar   *fontname);
 GDK_AVAILABLE_IN_ALL