[gedit] Utils: deprecate menu_position_under_widget()

[Sébastien Wilmet <swilmet src gnome org>]

commit c4ecd5354d6bee46a9f76229b7c3f7d5925b74ea
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 0306edd9d..2a57cbb22 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
@@ -371,4 +370,5 @@ gedit_utils_make_valid_utf8
 gedit_utils_str_middle_truncate
 gedit_utils_str_end_truncate
 gedit_utils_replace_home_dir_with_tilde
+gedit_utils_menu_position_under_widget
 </SECTION>
diff --git a/gedit/gedit-utils.c b/gedit/gedit-utils.c
index 705d2fd0a..84ae2cffc 100644
--- a/gedit/gedit-utils.c
+++ b/gedit/gedit-utils.c
@@ -46,6 +46,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 b9a31a4c4..6ae9e9251 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);
 
@@ -87,6 +82,13 @@ gchar                     *gedit_utils_str_end_truncate                       (c
 G_DEPRECATED_FOR (tepl_utils_replace_home_dir_with_tilde)
 gchar                     *gedit_utils_replace_home_dir_with_tilde             (const gchar    *uri);
 
+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 */