From cdf69b4bede018994230590acd856ab56465d09b Mon Sep 17 00:00:00 2001
From: "John (J5) Palmieri" <johnp@redhat.com>
Date: Thu, 3 Mar 2011 16:05:28 -0500
Subject: [PATCH] [gi] add missing annotations for signals that emit Gdk.Events

---
 gtk/gtkclipboard.c  | 2 +-
 gtk/gtkentry.c      | 6 +++---
 gtk/gtkstatusicon.c | 9 ++++++---
 gtk/gtkwidget.c     | 6 +++---
 4 files changed, 13 insertions(+), 10 deletions(-)

diff --git a/gtk/gtkclipboard.c b/gtk/gtkclipboard.c
index 2bf5cefb16..e918495ffc 100644
--- a/gtk/gtkclipboard.c
+++ b/gtk/gtkclipboard.c
@@ -176,7 +176,7 @@ gtk_clipboard_class_init (GtkClipboardClass *class)
   /**
    * GtkClipboard::owner-change:
    * @clipboard: the #GtkClipboard on which the signal is emitted
-   * @event: the @GdkEventOwnerChange event 
+   * @event: (type Gdk.EventOwnerChange): the @GdkEventOwnerChange event 
    *
    * The ::owner-change signal is emitted when GTK+ receives an
    * event that indicates that the ownership of the selection 
diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 1d299d331d..e468fcbf48 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -1603,7 +1603,7 @@ gtk_entry_class_init (GtkEntryClass *class)
    * GtkEntry::icon-press:
    * @entry: The entry on which the signal is emitted
    * @icon_pos: The position of the clicked icon
-   * @event: the button press event
+   * @event: (type Gdk.EventButton): the button press event
    *
    * The ::icon-press signal is emitted when an activatable icon
    * is clicked.
@@ -1625,7 +1625,7 @@ gtk_entry_class_init (GtkEntryClass *class)
    * GtkEntry::icon-release:
    * @entry: The entry on which the signal is emitted
    * @icon_pos: The position of the clicked icon
-   * @event: the button release event
+   * @event: (type Gdk.EventButton): the button release event
    *
    * The ::icon-release signal is emitted on the button release from a
    * mouse click over an activatable icon.
@@ -5880,7 +5880,7 @@ gtk_entry_reset_im_context (GtkEntry *entry)
 /**
  * gtk_entry_im_context_filter_keypress:
  * @entry: a #GtkEntry
- * @event: the key event
+ * @event: (type Gdk.EventKey): the key event
  *
  * Allow the #GtkEntry input method to internally handle key press
  * and release events. If this function returns %TRUE, then no further
diff --git a/gtk/gtkstatusicon.c b/gtk/gtkstatusicon.c
index 00cf525805..79abc48bea 100644
--- a/gtk/gtkstatusicon.c
+++ b/gtk/gtkstatusicon.c
@@ -493,7 +493,8 @@ gtk_status_icon_class_init (GtkStatusIconClass *class)
   /**
    * GtkStatusIcon::button-press-event:
    * @status_icon: the object which received the signal
-   * @event: the #GdkEventButton which triggered this signal
+   * @event: (type Gdk.EventButton): the #GdkEventButton which triggered 
+   *                                 this signal
    *
    * The ::button-press-event signal will be emitted when a button
    * (typically from a mouse) is pressed.
@@ -519,7 +520,8 @@ gtk_status_icon_class_init (GtkStatusIconClass *class)
   /**
    * GtkStatusIcon::button-release-event:
    * @status_icon: the object which received the signal
-   * @event: the #GdkEventButton which triggered this signal
+   * @event: (type Gdk.EventButton): the #GdkEventButton which triggered 
+   *                                 this signal
    *
    * The ::button-release-event signal will be emitted when a button
    * (typically from a mouse) is released.
@@ -545,7 +547,8 @@ gtk_status_icon_class_init (GtkStatusIconClass *class)
   /**
    * GtkStatusIcon::scroll-event:
    * @status_icon: the object which received the signal.
-   * @event: the #GdkEventScroll which triggered this signal
+   * @event: (type Gdk.EventScroll): the #GdkEventScroll which triggered 
+   *                                 this signal
    *
    * The ::scroll-event signal is emitted when a button in the 4 to 7
    * range is pressed. Wheel mice are usually configured to generate
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 9afc8fe69f..828f857932 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -2287,7 +2287,7 @@ gtk_widget_class_init (GtkWidgetClass *klass)
   /**
    * GtkWidget::selection-notify-event:
    * @widget: the object which received the signal.
-   * @event:
+   * @event: (type Gdk.EventSelection):
    *
    * Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
    */
@@ -2796,7 +2796,7 @@ gtk_widget_class_init (GtkWidgetClass *klass)
   /**
    * GtkWidget::damage-event:
    * @widget: the object which received the signal
-   * @event: the #GdkEventExpose event
+   * @event: (type Gdk.EventExpose): the #GdkEventExpose event
    *
    * Emitted when a redirected window belonging to @widget gets drawn into.
    * The region/area members of the event shows what area of the redirected
@@ -2820,7 +2820,7 @@ gtk_widget_class_init (GtkWidgetClass *klass)
 /**
    * GtkWidget::grab-broken-event:
    * @widget: the object which received the signal
-   * @event: the #GdkEventGrabBroken event
+   * @event: (type Gdk.EventGrabBroken): the #GdkEventGrabBroken event
    *
    * Emitted when a pointer or keyboard grab on a window belonging
    * to @widget gets broken.