[gedit/zbrown/deteplification-src: 34/633] Utils: deprecate menu_position_under_widget()

[Zander Brown <zbrown src gnome org>]

commit cd6930c2ecce465646b16b84eaea9645ecf11f64
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Tue Nov 19 04:22:02 2019 +0100

    Utils: deprecate menu_position_under_widget()
    
    It was still used in gedit-plugins in the terminal plugin (in Python),
    but has been replaced there.

 docs/reference/gedit-sections.txt |  2 +-
 gedit/gedit-utils.c               | 10 ++++++++++
 gedit/gedit-utils.h               | 12 +++++++-----
 3 files changed, 18 insertions(+), 6 deletions(-)
---
diff --git a/docs/reference/gedit-sections.txt b/docs/reference/gedit-sections.txt
index 3ac3b24cc..fdb445622 100644
--- a/docs/reference/gedit-sections.txt
+++ b/docs/reference/gedit-sections.txt
@@ -351,7 +351,6 @@ gedit_menu_extension_get_type
 <FILE>gedit-utils</FILE>
 GBOOLEAN_TO_POINTER
 GPOINTER_TO_BOOLEAN
-gedit_utils_menu_position_under_widget
 gedit_utils_menu_position_under_tree_view
 gedit_utils_set_atk_name_description
 gedit_utils_set_atk_relation
@@ -369,4 +368,5 @@ gedit_utils_is_valid_location
 gedit_utils_location_get_dirname_for_display
 gedit_utils_set_direct_save_filename
 gedit_utils_newline_type_to_string
+gedit_utils_menu_position_under_widget
 </SECTION>
diff --git a/gedit/gedit-utils.c b/gedit/gedit-utils.c
index 847463541..0ff221002 100644
--- a/gedit/gedit-utils.c
+++ b/gedit/gedit-utils.c
@@ -45,6 +45,16 @@ widget_get_origin (GtkWidget *widget,
        gdk_window_get_origin (window, x, y);
 }
 
+/**
+ * gedit_utils_menu_position_under_widget:
+ * @menu:
+ * @x:
+ * @y:
+ * @push_in:
+ * @user_data:
+ *
+ * Deprecated: 3.36: Use gtk_menu_popup_at_widget() instead.
+ */
 void
 gedit_utils_menu_position_under_widget (GtkMenu  *menu,
                                        gint     *x,
diff --git a/gedit/gedit-utils.h b/gedit/gedit-utils.h
index 37f2d39ee..18be3fcf5 100644
--- a/gedit/gedit-utils.h
+++ b/gedit/gedit-utils.h
@@ -33,11 +33,6 @@ G_BEGIN_DECLS
 
 enum { GEDIT_ALL_WORKSPACES = 0xffffffff };
 
-void                       gedit_utils_menu_position_under_widget             (GtkMenu         *menu,
-                                                                               gint            *x,
-                                                                               gint            *y,
-                                                                               gboolean        *push_in,
-                                                                               gpointer         user_data);
 gboolean                   gedit_utils_menu_position_under_tree_view          (GtkTreeView     *tree_view,
                                                                                GdkRectangle    *rect);
 
@@ -81,6 +76,13 @@ gchar                     *gedit_utils_set_direct_save_filename               (G
 const gchar               *gedit_utils_newline_type_to_string                 (GtkSourceNewlineType  
newline_type);
 
 
+G_DEPRECATED_FOR (gtk_menu_popup_at_widget)
+void                       gedit_utils_menu_position_under_widget             (GtkMenu         *menu,
+                                                                               gint            *x,
+                                                                               gint            *y,
+                                                                               gboolean        *push_in,
+                                                                               gpointer         user_data);
+
 G_END_DECLS
 
 #endif /* GEDIT_UTILS_H */