[gtk/wip/carlosg/input-cleanups: 13/26] gdk: Drop gdk_device_get_last_event_surface()

[Carlos Garnacho <carlosg src gnome org>]

commit 469a4a73f971e142f707cf22902ca9af124b5aef
Author: Carlos Garnacho <carlosg gnome org>
Date:   Wed Jun 24 11:20:15 2020 +0200

    gdk: Drop gdk_device_get_last_event_surface()
    
    This kind of transient state sets the expectative that events update
    devices, while it's more accurate to say that devices generate events.
    It does not make to expose this function anymore.

 docs/reference/gdk/gdk4-sections.txt |  1 -
 gdk/gdkdevice.c                      | 27 ---------------------------
 gdk/gdkdevice.h                      |  3 ---
 3 files changed, 31 deletions(-)
---
diff --git a/docs/reference/gdk/gdk4-sections.txt b/docs/reference/gdk/gdk4-sections.txt
index 158fba7ec1..474b1cdb2f 100644
--- a/docs/reference/gdk/gdk4-sections.txt
+++ b/docs/reference/gdk/gdk4-sections.txt
@@ -379,7 +379,6 @@ gdk_device_get_surface_at_position
 GdkTimeCoord
 gdk_device_get_axis
 gdk_device_get_axis_names
-gdk_device_get_last_event_surface
 
 <SUBSECTION>
 gdk_device_tool_get_serial
diff --git a/gdk/gdkdevice.c b/gdk/gdkdevice.c
index 29a1fcab47..4889d7b232 100644
--- a/gdk/gdkdevice.c
+++ b/gdk/gdkdevice.c
@@ -1282,33 +1282,6 @@ _gdk_device_surface_at_position (GdkDevice       *device,
                                                              mask);
 }
 
-/**
- * gdk_device_get_last_event_surface:
- * @device: a #GdkDevice, with a source other than %GDK_SOURCE_KEYBOARD
- *
- * Gets information about which surface the given pointer device is in, based on events
- * that have been received so far from the display server. If another application
- * has a pointer grab, or this application has a grab with owner_events = %FALSE,
- * %NULL may be returned even if the pointer is physically over one of this
- * application's surfaces.
- *
- * Returns: (transfer none) (allow-none): the last surface the device
- */
-GdkSurface *
-gdk_device_get_last_event_surface (GdkDevice *device)
-{
-  GdkDisplay *display;
-  GdkPointerSurfaceInfo *info;
-
-  g_return_val_if_fail (GDK_IS_DEVICE (device), NULL);
-  g_return_val_if_fail (device->source != GDK_SOURCE_KEYBOARD, NULL);
-
-  display = gdk_device_get_display (device);
-  info = _gdk_display_get_pointer_info (display, device);
-
-  return info->surface_under_pointer;
-}
-
 /**
  * gdk_device_get_vendor_id:
  * @device: a physical #GdkDevice
diff --git a/gdk/gdkdevice.h b/gdk/gdkdevice.h
index 0eefbb6cac..058d0b67bd 100644
--- a/gdk/gdkdevice.h
+++ b/gdk/gdkdevice.h
@@ -143,9 +143,6 @@ GList *      gdk_device_list_physical_devices (GdkDevice     *device);
 GDK_AVAILABLE_IN_ALL
 GdkDeviceType gdk_device_get_device_type (GdkDevice *device);
 
-GDK_AVAILABLE_IN_ALL
-GdkSurface *gdk_device_get_last_event_surface (GdkDevice *device);
-
 GDK_AVAILABLE_IN_ALL
 const gchar *gdk_device_get_vendor_id       (GdkDevice *device);
 GDK_AVAILABLE_IN_ALL