[gtk+] docs: add docs for GtkWidgetClass

[William Jon McCann <mccann src gnome org>]

commit 1763b94fb291ae3d41414a84869555582356a49c
Author: William Jon McCann <william jon mccann gmail com>
Date:   Tue Jan 21 10:22:50 2014 -0500

    docs: add docs for GtkWidgetClass

 gtk/gtkwidget.h |  144 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 144 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index 8c5df6a..72e0c3f 100644
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -138,6 +138,46 @@ struct _GtkWidget
  * @activate_signal: The signal to emit when a widget of this class is
  *   activated, gtk_widget_activate() handles the emission.
  *   Implementation of this signal is optional.
+ * @dispatch_child_properties_changed: Seldomly overidden.
+ * @destroy: Signals that all holders of a reference to the widget
+ *   should release the reference that they hold.
+ * @show: Signal emitted when widget is shown
+ * @show_all: Recursively shows a widget, and any child widgets (if the widget is
+ * a container).
+ * @hide: Signal emitted when widget is hidden.
+ * @map: Signal emitted when widget is going to be mapped, that is
+ *   when the widget is visible (which is controlled with
+ *   gtk_widget_set_visible()) and all its parents up to the toplevel
+ *   widget are also visible.
+ * @unmap: Signal emitted when widget is going to be unmapped, which
+ *   means that either it or any of its parents up to the toplevel
+ *   widget have been set as hidden.
+ * @realize: Signal emitted when widget is associated with a
+ *   #GdkWindow, which means that gtk_wiget_realize() has been called or
+ *   the widget has been mapped (that is, it is going to be drawn).
+ * @unrealize: Signal emitted when the GdkWindow associated with
+ *   widget is destroyed, which means that gtk_widget_unrealize() has
+ *   been called or the widget has been unmapped (that is, it is going
+ *   to be hidden).
+ * @size_allocate: Signal emitted to get the widget allocation.
+ * @state_changed: Signal emitted when the widget state
+ *   changes. Deprecated: 3.0
+ * @state_flags_changed: Signal emitted when the widget state changes,
+ *   see gtk_widget_get_state_flags().
+ * @parent_set: Signal emitted when a new parent has been set on a
+ *   widget.
+ * @hierarchy_changed: Signal emitted when the anchored state of a
+ *   widget changes.
+ * @style_set: Signal emitted when a new style has been set on a
+ * widget. Deprecated: 3.0
+ * @direction_changed: Signal emitted when the text direction of a
+ *   widget changes.
+ * @grab_notify: Signal emitted when a widget becomes shadowed by a
+ *   GTK+ grab (not a pointer or keyboard grab) on another widget, or
+ *   when it becomes unshadowed due to a grab being removed.
+ * @child_notify: Signal emitted for each child property that has
+ *   changed on an object.
+ * @draw: Signal emitted when a widget is supposed to render itself.
  * @get_request_mode: This allows a widget to tell its parent container whether
  *   it prefers to be allocated in %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH or
  *   %GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT mode.
@@ -206,6 +246,110 @@ struct _GtkWidget
  *   passed in should be adjusted in the same way as the allocated size,
  *   which allows adjustments to perform alignments or other changes
  *   based on natural size.
+ * @mnemonic_activate: Activates the @widget if @group_cycling is
+ *   %FALSE, and just grabs the focus if @group_cycling is %TRUE.
+ * @grab_focus: Causes @widget to have the keyboard focus for the
+ *   #GtkWindow it's inside.
+ * @focus:
+ * @move_focus: Signal emitted when a change of focus is requested
+ * @keynav_failed: Signal emitted if keyboard navigation fails.
+ * @event: The GTK+ main loop will emit three signals for each GDK
+ *   event delivered to a widget: one generic ::event signal, another,
+ *   more specific, signal that matches the type of event delivered
+ *   (e.g. "key-press-event") and finally a generic "event-after"
+ *   signal.
+ * @button_press_event: Signal will be emitted when a button
+ *   (typically from a mouse) is pressed.
+ * @button_release_event: Signal will be emitted when a button
+ *   (typically from a mouse) is released.
+ * @scroll_event: Signal emitted when a button in the 4 to 7 range is
+ *   pressed.
+ * @motion_notify_event: Signal emitted when the pointer moves over
+ *   the widget's #GdkWindow.
+ * @delete_event: Signal emitted if a user requests that a toplevel
+ *   window is closed.
+ * @destroy_event: Signal is emitted when a #GdkWindow is destroyed.
+ * @key_press_event: Signal emitted when a key is pressed.
+ * @key_release_event: Signal is emitted when a key is released.
+ * @enter_notify_event: Signal event will be emitted when the pointer
+ *   enters the widget's window.
+ * @leave_notify_event: Will be emitted when the pointer leaves the
+ *   widget's window.
+ * @configure_event: Signal will be emitted when the size, position or
+ *   stacking of the widget's window has changed.
+ * @focus_in_event: Signal emitted when the keyboard focus enters the
+ * widget's window.
+ * @focus_out_event: Signal emitted when the keyboard focus leaves the
+ * widget's window.
+ * @map_event: Signal emitted when the widget's window is mapped.
+ * @unmap_event: Signal will be emitted when the widget's window is
+ *   unmapped.
+ * @property_notify_event: Signal will be emitted when a property on
+ *   the widget's window has been changed or deleted.
+ * @selection_clear_event: Signal will be emitted when the the
+ *   widget's window has lost ownership of a selection.
+ * @selection_request_event: Signal will be emitted when another
+ *   client requests ownership of the selection owned by the widget's
+ *   window.
+ * @selection_notify_event:
+ * @proximity_in_event:
+ * @proximity_out_event:
+ * @visibility_notify_event: Signal emitted when the widget's window is
+ *   obscured or unobscured.
+ * @window_state_event: Signal emitted when the state of the toplevel
+ *   window associated to the widget changes.
+ * @damage_event: Signal emitted when a redirected window belonging to
+ *   widget gets drawn into.
+ * @grab_broken_event: Signal emitted when a pointer or keyboard grab
+ *   on a window belonging to widget gets broken.
+ * @selection_get:
+ * @selection_received:
+ * @drag_begin: Signal emitted on the drag source when a drag is
+ *   started.
+ * @drag_end: Signal emitted on the drag source when a drag is
+ *   finished.
+ * @drag_data_get: Signal emitted on the drag source when the drop
+ *   site requests the data which is dragged.
+ * @drag_data_delete: Signal emitted on the drag source when a drag
+ *   with the action %GDK_ACTION_MOVE is successfully completed.
+ * @drag_leave: Signal emitted on the drop site when the cursor leaves
+ *   the widget.
+ * @drag_motion: signal emitted on the drop site when the user moves
+ *   the cursor over the widget during a drag.
+ * @drag_drop: Signal emitted on the drop site when the user drops the
+ *   data onto the widget.
+ * @drag_data_received: Signal emitted on the drop site when the
+ *   dragged data has been received.
+ * @drag_failed: Signal emitted on the drag source when a drag has
+ *   failed.
+ * @popup_menu: Signal emitted whenever a widget should pop up a
+ *   context menu.
+ * @show_help:
+ * @get_accessible: Returns the accessible object that describes the
+ *   widget to an assistive technology.
+ * @screen_changed: Signal emitted when the screen of a widget has
+ *   changed.
+ * @can_activate_accel: Signal allows applications and derived widgets
+ *   to override the default GtkWidget handling for determining whether
+ *   an accelerator can be activated.
+ * @composited_changed: Signal emitted when the composited status of
+ *   widgets screen changes. See gdk_screen_is_composited().
+ * @query_tooltip: Signal emitted when "has-tooltip" is %TRUE and the
+ *   hover timeout has expired with the cursor hovering "above"
+ *   widget; or emitted when widget got focus in keyboard mode.
+ * @compute_expand: Computes whether a container should give this
+ *   widget extra space when possible.
+ * @adjust_size_request:
+ * @adjust_size_allocation:
+ * @style_updated: Signal emitted when the GtkStyleContext of a widget
+ *   is changed.
+ * @touch_event:
+ * @get_preferred_height_and_baseline_for_width:
+ * @adjust_baseline_request:
+ * @adjust_baseline_allocation:
+ * @queue_draw_region: Invalidates the area of widget defined by
+ *   region by calling gdk_window_invalidate_region() on the widget's
+ *   window and all its child windows.
  */
 struct _GtkWidgetClass
 {