[gtk] Fix some g-i annotation warnings

[Rico Tzschichholz <ricotz src gnome org>]

commit 2cf55c16860c44bb42047d6c1e4f5fb47e96fb34
Author: Rico Tzschichholz <ricotz ubuntu com>
Date:   Tue May 1 12:35:32 2018 +0200

    Fix some g-i annotation warnings

 gdk/gdkcairocontext.c |  2 +-
 gdk/gdkdnd.c          |  2 +-
 gtk/gtksnapshot.c     | 12 ++++++------
 3 files changed, 8 insertions(+), 8 deletions(-)
---
diff --git a/gdk/gdkcairocontext.c b/gdk/gdkcairocontext.c
index 5b6deef1f9..d89271f545 100644
--- a/gdk/gdkcairocontext.c
+++ b/gdk/gdkcairocontext.c
@@ -68,7 +68,7 @@ gdk_cairo_context_init (GdkCairoContext *self)
 
 /**
  * gdk_cairo_context_cairo_create:
- * @context: a #GdkCairoContext that is currently drawing
+ * @self: a #GdkCairoContext that is currently drawing
  *
  * Retrieves a Cairo context to be used to draw on the #GdkSurface
  * of @context. A call to gdk_draw_context_begin_frame() with this
diff --git a/gdk/gdkdnd.c b/gdk/gdkdnd.c
index 7e26eceb76..d480ea3737 100644
--- a/gdk/gdkdnd.c
+++ b/gdk/gdkdnd.c
@@ -366,7 +366,7 @@ gdk_drag_context_class_init (GdkDragContextClass *klass)
                          G_PARAM_EXPLICIT_NOTIFY);
 
   /**
-   * GdkDragContext:display:
+   * GdkDragContext:device:
    *
    * The #GdkDevice that is performing the drag.
    */
diff --git a/gtk/gtksnapshot.c b/gtk/gtksnapshot.c
index e8b49d92d3..10ea6556e5 100644
--- a/gtk/gtksnapshot.c
+++ b/gtk/gtksnapshot.c
@@ -1341,12 +1341,12 @@ gtk_snapshot_render_layout (GtkSnapshot     *snapshot,
   gtk_snapshot_offset (snapshot, -x, -y);
 }
 
-/*
+/**
  * gtk_snapshot_append_linear_gradient:
  * @snapshot: a #GtkSnapshot
  * @bounds: the rectangle to render the linear gradient into
- * @start: the point at which the linear gradient will begin
- * @end: the point at which the linear gradient will finish
+ * @start_point: the point at which the linear gradient will begin
+ * @end_point: the point at which the linear gradient will finish
  * @stops: (array length=n_stops): a pointer to an array of #GskColorStop defining the gradient
  * @n_stops: the number of elements in @stops
  *
@@ -1388,12 +1388,12 @@ gtk_snapshot_append_linear_gradient (GtkSnapshot            *snapshot,
   gsk_render_node_unref (node);
 }
 
-/*
+/**
  * gtk_snapshot_append_repeating_linear_gradient:
  * @snapshot: a #GtkSnapshot
  * @bounds: the rectangle to render the linear gradient into
- * @start: the point at which the linear gradient will begin
- * @end: the point at which the linear gradient will finish
+ * @start_point: the point at which the linear gradient will begin
+ * @end_point: the point at which the linear gradient will finish
  * @stops: (array length=n_stops): a pointer to an array of #GskColorStop defining the gradient
  * @n_stops: the number of elements in @stops
  *