[gtk/ricotz/for-master: 3/5] gdk/x11: Add annotations to improve GIR API

[Rico Tzschichholz <ricotz src gnome org>]

commit 7830bc0b8786ba276b829b9641c53dcac873589d
Author: Rico Tzschichholz <ricotz ubuntu com>
Date:   Fri Jul 31 19:11:23 2020 +0200

    gdk/x11: Add annotations to improve GIR API

 gdk/x11/gdkdisplay-x11.c   | 8 ++++----
 gdk/x11/gdkglcontext-x11.c | 2 +-
 gdk/x11/gdkmonitor-x11.c   | 6 +++++-
 gdk/x11/gdksurface-x11.c   | 2 +-
 gdk/x11/gdkx11display.h    | 2 +-
 5 files changed, 12 insertions(+), 8 deletions(-)
---
diff --git a/gdk/x11/gdkdisplay-x11.c b/gdk/x11/gdkdisplay-x11.c
index 92a3e7dbf1..e895a07867 100644
--- a/gdk/x11/gdkdisplay-x11.c
+++ b/gdk/x11/gdkdisplay-x11.c
@@ -1831,7 +1831,7 @@ gdk_x11_display_has_pending (GdkDisplay *display)
 
 /**
  * gdk_x11_display_get_default_group:
- * @display: a #GdkDisplay
+ * @display: (type GdkX11Display): a #GdkDisplay
  *
  * Returns the default group leader surface for all toplevel surfaces
  * on @display. This surface is implicitly created by GDK.
@@ -2773,7 +2773,7 @@ gdk_x11_display_get_max_request_size (GdkDisplay *display)
 
 /**
  * gdk_x11_display_get_screen:
- * @display: a #GdkX11Display
+ * @display: (type GdkX11Display): a #GdkX11Display
  *
  * Retrieves the #GdkX11Screen of the @display.
  *
@@ -2845,7 +2845,7 @@ gdk_x11_display_get_monitors (GdkDisplay *display)
 
 /**
  * gdk_x11_display_get_primary_monitor:
- * @self: a #GdkDisplay
+ * @display: (type GdkX11Display): a #GdkDisplay
  *
  * Gets the primary monitor for the display.
  *
@@ -2968,7 +2968,7 @@ gdk_x11_display_class_init (GdkX11DisplayClass * class)
 
   /**
    * GdkX11Display::xevent:
-   * @display: the object on which the signal is emitted
+   * @display: (type GdkX11Display): the object on which the signal is emitted
    * @xevent: a pointer to the XEvent to process
    *
    * The ::xevent signal is a low level signal that is emitted
diff --git a/gdk/x11/gdkglcontext-x11.c b/gdk/x11/gdkglcontext-x11.c
index d3f6d7df42..d628dbcaf2 100644
--- a/gdk/x11/gdkglcontext-x11.c
+++ b/gdk/x11/gdkglcontext-x11.c
@@ -1511,7 +1511,7 @@ gdk_x11_display_make_gl_context_current (GdkDisplay   *display,
 
 /**
  * gdk_x11_display_get_glx_version:
- * @display: a #GdkDisplay
+ * @display: (type GdkX11Display): a #GdkDisplay
  * @major: (out): return location for the GLX major version
  * @minor: (out): return location for the GLX minor version
  *
diff --git a/gdk/x11/gdkmonitor-x11.c b/gdk/x11/gdkmonitor-x11.c
index 8d7a4e5807..3227e0bd1b 100644
--- a/gdk/x11/gdkmonitor-x11.c
+++ b/gdk/x11/gdkmonitor-x11.c
@@ -63,7 +63,7 @@ gdk_monitor_has_fullscreen_window (GdkMonitor *monitor)
 
 /**
  * gdk_x11_monitor_get_workarea:
- * @monitor: a #GdkMonitor
+ * @monitor: (type GdkX11Monitor): a #GdkMonitor
  * @workarea: (out): a #GdkRectangle to be filled with
  *     the monitor workarea
  *
@@ -114,6 +114,10 @@ gdk_x11_monitor_class_init (GdkX11MonitorClass *class)
 {
 }
 
+/**
+ * gdk_x11_monitor_get_output:
+ * @monitor: (type GdkX11Monitor): a #GdkMonitor
+ */
 XID
 gdk_x11_monitor_get_output (GdkMonitor *monitor)
 {
diff --git a/gdk/x11/gdksurface-x11.c b/gdk/x11/gdksurface-x11.c
index 9ca81d8e9f..d797368d79 100644
--- a/gdk/x11/gdksurface-x11.c
+++ b/gdk/x11/gdksurface-x11.c
@@ -3270,7 +3270,7 @@ gdk_x11_surface_unfullscreen (GdkSurface *surface)
 
 /**
  * gdk_x11_surface_get_group:
- * @surface: The #GdkSurface
+ * @surface: (type GdkX11Surface): The #GdkSurface
  *
  * Returns the group this surface belongs to.
  *
diff --git a/gdk/x11/gdkx11display.h b/gdk/x11/gdkx11display.h
index 299864d217..5c6a0c36e7 100644
--- a/gdk/x11/gdkx11display.h
+++ b/gdk/x11/gdkx11display.h
@@ -106,7 +106,7 @@ GDK_AVAILABLE_IN_ALL
 GdkX11Screen *gdk_x11_display_get_screen (GdkDisplay *display);
 
 GDK_AVAILABLE_IN_ALL
-GdkMonitor * gdk_x11_display_get_primary_monitor (GdkDisplay *self);
+GdkMonitor * gdk_x11_display_get_primary_monitor (GdkDisplay *display);
 
 GDK_AVAILABLE_IN_ALL
 void        gdk_x11_display_grab              (GdkDisplay *display);