[gtk+/gtk-3-16] docs: Improve deprecation notices for GtkMisc

[Matthias Clasen <matthiasc src gnome org>]

commit 5ae01c4f2c0feb749006715326fd80c7f1944bc7
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Wed Jun 10 17:12:02 2015 +0100

    docs: Improve deprecation notices for GtkMisc
    
    Point to the replacement properties and functions.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=750718

 gtk/deprecated/gtkmisc.c |   37 +++++++++++++++++++++++++++++++++++++
 1 files changed, 37 insertions(+), 0 deletions(-)
---
diff --git a/gtk/deprecated/gtkmisc.c b/gtk/deprecated/gtkmisc.c
index 124516f..55eca88 100644
--- a/gtk/deprecated/gtkmisc.c
+++ b/gtk/deprecated/gtkmisc.c
@@ -98,6 +98,16 @@ gtk_misc_class_init (GtkMiscClass *class)
   
   widget_class->realize = gtk_misc_realize;
 
+  /**
+   * GtkMisc:xalign:
+   *
+   * The horizontal alignment. A value of 0.0 means left alignment (or right
+   * on RTL locales); a value of 1.0 means right alignment (or left on RTL
+   * locales).
+   *
+   * Deprecated: 3.14: Use gtk_widget_set_halign() instead. If you are using
+   *   #GtkLabel, use #GtkLabel:xalign instead.
+   */
   g_object_class_install_property (gobject_class,
                                    PROP_XALIGN,
                                    g_param_spec_float ("xalign",
@@ -108,6 +118,15 @@ gtk_misc_class_init (GtkMiscClass *class)
                                                       0.5,
                                                       GTK_PARAM_READWRITE|G_PARAM_DEPRECATED));
 
+  /**
+   * GtkMisc:yalign:
+   *
+   * The vertical alignment. A value of 0.0 means top alignment;
+   * a value of 1.0 means bottom alignment.
+   *
+   * Deprecated: 3.14: Use gtk_widget_set_valign() instead. If you are using
+   *   #GtkLabel, use #GtkLabel:yalign instead.
+   */
   g_object_class_install_property (gobject_class,
                                    PROP_YALIGN,
                                    g_param_spec_float ("yalign",
@@ -118,6 +137,15 @@ gtk_misc_class_init (GtkMiscClass *class)
                                                       0.5,
                                                       GTK_PARAM_READWRITE|G_PARAM_DEPRECATED));
 
+  /**
+   * GtkMisc:xpad:
+   *
+   * The amount of space to add on the left and right of the widget, in
+   * pixels.
+   *
+   * Deprecated: 3.14: Use gtk_widget_set_margin_start() and
+   *   gtk_widget_set_margin_end() instead
+   */
   g_object_class_install_property (gobject_class,
                                    PROP_XPAD,
                                    g_param_spec_int ("xpad",
@@ -128,6 +156,15 @@ gtk_misc_class_init (GtkMiscClass *class)
                                                     0,
                                                     GTK_PARAM_READWRITE|G_PARAM_DEPRECATED));
 
+  /**
+   * GtkMisc:ypad:
+   *
+   * The amount of space to add on the top and bottom of the widget, in
+   * pixels.
+   *
+   * Deprecated: 3.14: Use gtk_widget_set_margin_top() and
+   *   gtk_widget_set_margin_bottom() instead
+   */
   g_object_class_install_property (gobject_class,
                                    PROP_YPAD,
                                    g_param_spec_int ("ypad",