[gtk/matthiasc/for-master: 16/16] Bring back gdk_display_put_event

[Matthias Clasen <matthiasc src gnome org>]

commit 346bba65922542cd6502b0369db4801991bc674b
Author: Matthias Clasen <mclasen redhat com>
Date:   Fri May 29 09:25:17 2020 -0400

    Bring back gdk_display_put_event
    
    It is still needed in WebKit.

 docs/reference/gdk/gdk4-sections.txt | 3 +++
 gdk/gdkdisplay.c                     | 7 +++++--
 gdk/gdkdisplay.h                     | 4 ++++
 gdk/gdkdisplayprivate.h              | 2 --
 4 files changed, 12 insertions(+), 4 deletions(-)
---
diff --git a/docs/reference/gdk/gdk4-sections.txt b/docs/reference/gdk/gdk4-sections.txt
index 2a25039548..d2ac4a1514 100644
--- a/docs/reference/gdk/gdk4-sections.txt
+++ b/docs/reference/gdk/gdk4-sections.txt
@@ -95,6 +95,9 @@ gdk_display_get_setting
 gdk_display_get_startup_notification_id
 gdk_display_setup_window_visual
 
+<SUBSECTION>
+gdk_display_put_event
+
 <SUBSECTION>
 gdk_display_map_keyval
 gdk_display_map_keycode
diff --git a/gdk/gdkdisplay.c b/gdk/gdkdisplay.c
index 2994416805..81277b9f7b 100644
--- a/gdk/gdkdisplay.c
+++ b/gdk/gdkdisplay.c
@@ -466,10 +466,13 @@ gdk_display_peek_event (GdkDisplay *display)
  *
  * Appends the given event onto the front of the event
  * queue for @display.
+ *
+ * This function is only useful in very special situations
+ * and should not be used by applications.
  **/
 void
-gdk_display_put_event (GdkDisplay     *display,
-                      GdkEvent       *event)
+gdk_display_put_event (GdkDisplay *display,
+                       GdkEvent   *event)
 {
   g_return_if_fail (GDK_IS_DISPLAY (display));
   g_return_if_fail (event != NULL);
diff --git a/gdk/gdkdisplay.h b/gdk/gdkdisplay.h
index 12a3f99faf..217fbb6b57 100644
--- a/gdk/gdkdisplay.h
+++ b/gdk/gdkdisplay.h
@@ -100,6 +100,10 @@ GDK_AVAILABLE_IN_ALL
 GdkMonitor * gdk_display_get_monitor_at_surface (GdkDisplay *display,
                                                 GdkSurface  *surface);
 
+GDK_AVAILABLE_IN_ALL
+void      gdk_display_put_event  (GdkDisplay     *display,
+                                  GdkEvent       *event);
+
 GDK_AVAILABLE_IN_ALL
 gboolean       gdk_display_map_keyval  (GdkDisplay    *display,
                                         guint          keyval,
diff --git a/gdk/gdkdisplayprivate.h b/gdk/gdkdisplayprivate.h
index f6a1b32b06..8f70e12aa4 100644
--- a/gdk/gdkdisplayprivate.h
+++ b/gdk/gdkdisplayprivate.h
@@ -246,8 +246,6 @@ void                gdk_display_setting_changed       (GdkDisplay       *display
 
 GdkEvent *          gdk_display_get_event             (GdkDisplay       *display);
 GdkEvent *          gdk_display_peek_event            (GdkDisplay       *display);
-void                gdk_display_put_event             (GdkDisplay       *display,
-                                                       GdkEvent         *event);
 gboolean            gdk_display_has_pending           (GdkDisplay       *display);