[gtk+] dialog: Mark gtk_dialog_get_action_area as deprecated

[Matthias Clasen <matthiasc src gnome org>]

commit 32a290129417772954926cfdc42adcdfd68b2a94
Author: Matthias Clasen <mclasen redhat com>
Date:   Fri Jan 17 12:01:47 2014 -0500

    dialog: Mark gtk_dialog_get_action_area as deprecated
    
    Direct access to the action area by applications makes it much more
    difficult to make changes to GtkDialog. Therefore, deprecate this
    function.

 gtk/gtkdialog.c |    7 +++++--
 gtk/gtkdialog.h |    2 +-
 2 files changed, 6 insertions(+), 3 deletions(-)
---
diff --git a/gtk/gtkdialog.c b/gtk/gtkdialog.c
index 57eeb43..d5a54a0 100644
--- a/gtk/gtkdialog.c
+++ b/gtk/gtkdialog.c
@@ -1524,10 +1524,13 @@ gtk_dialog_buildable_custom_finished (GtkBuildable *buildable,
  *
  * Returns the action area of @dialog.
  *
- * Returns: (transfer none): the action area.
+ * Returns: (transfer none): the action area
  *
  * Since: 2.14
- **/
+ *
+ * Deprecated:3.12: Direct access to the action area
+ *   is discouraged; use gtk_dialog_add_button(), etc.
+ */
 GtkWidget *
 gtk_dialog_get_action_area (GtkDialog *dialog)
 {
diff --git a/gtk/gtkdialog.h b/gtk/gtkdialog.h
index 641b450..1742985 100644
--- a/gtk/gtkdialog.h
+++ b/gtk/gtkdialog.h
@@ -188,7 +188,7 @@ void gtk_dialog_response           (GtkDialog *dialog,
 GDK_AVAILABLE_IN_ALL
 gint gtk_dialog_run                (GtkDialog *dialog);
 
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_10
 GtkWidget * gtk_dialog_get_action_area  (GtkDialog *dialog);
 GDK_AVAILABLE_IN_ALL
 GtkWidget * gtk_dialog_get_content_area (GtkDialog *dialog);