Commit 469d333a authored by William Jon McCann's avatar William Jon McCann

docs: use Returns: consistently

Instead of Return value:
parent a6084e26
...@@ -382,7 +382,7 @@ gdk_get_display_arg_name (void) ...@@ -382,7 +382,7 @@ gdk_get_display_arg_name (void)
* display has previously been set, simply returns that. An internal * display has previously been set, simply returns that. An internal
* function that should not be used by applications. * function that should not be used by applications.
* *
* Return value: (transfer none): the default display, if it could be * Returns: (transfer none): the default display, if it could be
* opened, otherwise %NULL. * opened, otherwise %NULL.
**/ **/
GdkDisplay * GdkDisplay *
...@@ -701,7 +701,7 @@ gdk_threads_dispatch_free (gpointer data) ...@@ -701,7 +701,7 @@ gdk_threads_dispatch_free (gpointer data)
* } * }
* ]| * ]|
* *
* Return value: the ID (greater than 0) of the event source. * Returns: the ID (greater than 0) of the event source.
* *
* Since: 2.12 * Since: 2.12
*/ */
...@@ -736,7 +736,7 @@ gdk_threads_add_idle_full (gint priority, ...@@ -736,7 +736,7 @@ gdk_threads_add_idle_full (gint priority,
* *
* See gdk_threads_add_idle_full(). * See gdk_threads_add_idle_full().
* *
* Return value: the ID (greater than 0) of the event source. * Returns: the ID (greater than 0) of the event source.
* *
* Since: 2.12 * Since: 2.12
*/ */
...@@ -803,7 +803,7 @@ gdk_threads_add_idle (GSourceFunc function, ...@@ -803,7 +803,7 @@ gdk_threads_add_idle (GSourceFunc function,
* } * }
* ]| * ]|
* *
* Return value: the ID (greater than 0) of the event source. * Returns: the ID (greater than 0) of the event source.
* *
* Since: 2.12 * Since: 2.12
*/ */
...@@ -842,7 +842,7 @@ gdk_threads_add_timeout_full (gint priority, ...@@ -842,7 +842,7 @@ gdk_threads_add_timeout_full (gint priority,
* *
* See gdk_threads_add_timeout_full(). * See gdk_threads_add_timeout_full().
* *
* Return value: the ID (greater than 0) of the event source. * Returns: the ID (greater than 0) of the event source.
* *
* Since: 2.12 * Since: 2.12
*/ */
...@@ -869,7 +869,7 @@ gdk_threads_add_timeout (guint interval, ...@@ -869,7 +869,7 @@ gdk_threads_add_timeout (guint interval,
* See g_timeout_add_seconds_full() for a discussion of why it is * See g_timeout_add_seconds_full() for a discussion of why it is
* a good idea to use this function if you don’t need finer granularity. * a good idea to use this function if you don’t need finer granularity.
* *
* Return value: the ID (greater than 0) of the event source. * Returns: the ID (greater than 0) of the event source.
* *
* Since: 2.14 * Since: 2.14
*/ */
...@@ -907,7 +907,7 @@ gdk_threads_add_timeout_seconds_full (gint priority, ...@@ -907,7 +907,7 @@ gdk_threads_add_timeout_seconds_full (gint priority,
* *
* For details, see gdk_threads_add_timeout_full(). * For details, see gdk_threads_add_timeout_full().
* *
* Return value: the ID (greater than 0) of the event source. * Returns: the ID (greater than 0) of the event source.
* *
* Since: 2.14 * Since: 2.14
*/ */
......
...@@ -51,7 +51,7 @@ ...@@ -51,7 +51,7 @@
* *
* The result must be freed using gdk_color_free(). * The result must be freed using gdk_color_free().
* *
* Return value: a copy of @color * Returns: a copy of @color
*/ */
GdkColor* GdkColor*
gdk_color_copy (const GdkColor *color) gdk_color_copy (const GdkColor *color)
...@@ -86,7 +86,7 @@ gdk_color_free (GdkColor *color) ...@@ -86,7 +86,7 @@ gdk_color_free (GdkColor *color)
* A hash function suitable for using for a hash * A hash function suitable for using for a hash
* table that stores #GdkColors. * table that stores #GdkColors.
* *
* Return value: The hash function applied to @color * Returns: The hash function applied to @color
*/ */
guint guint
gdk_color_hash (const GdkColor *color) gdk_color_hash (const GdkColor *color)
...@@ -104,7 +104,7 @@ gdk_color_hash (const GdkColor *color) ...@@ -104,7 +104,7 @@ gdk_color_hash (const GdkColor *color)
* *
* Compares two colors. * Compares two colors.
* *
* Return value: %TRUE if the two colors compare equal * Returns: %TRUE if the two colors compare equal
*/ */
gboolean gboolean
gdk_color_equal (const GdkColor *colora, gdk_color_equal (const GdkColor *colora,
...@@ -138,7 +138,7 @@ G_DEFINE_BOXED_TYPE (GdkColor, gdk_color, ...@@ -138,7 +138,7 @@ G_DEFINE_BOXED_TYPE (GdkColor, gdk_color,
* (White in the four forms is “\#fff”, “\#ffffff”, “\#fffffffff” * (White in the four forms is “\#fff”, “\#ffffff”, “\#fffffffff”
* and “\#ffffffffffff”). * and “\#ffffffffffff”).
* *
* Return value: %TRUE if the parsing succeeded * Returns: %TRUE if the parsing succeeded
*/ */
gboolean gboolean
gdk_color_parse (const gchar *spec, gdk_color_parse (const gchar *spec,
...@@ -168,7 +168,7 @@ gdk_color_parse (const gchar *spec, ...@@ -168,7 +168,7 @@ gdk_color_parse (const gchar *spec,
* *
* The returned string can be parsed by gdk_color_parse(). * The returned string can be parsed by gdk_color_parse().
* *
* Return value: a newly-allocated text string * Returns: a newly-allocated text string
* *
* Since: 2.12 * Since: 2.12
*/ */
......
...@@ -153,7 +153,7 @@ gdk_cursor_init (GdkCursor *cursor) ...@@ -153,7 +153,7 @@ gdk_cursor_init (GdkCursor *cursor)
* *
* Adds a reference to @cursor. * Adds a reference to @cursor.
* *
* Return value: (transfer full): Same @cursor that was passed in * Returns: (transfer full): Same @cursor that was passed in
* *
* Deprecated: 3.0: Use g_object_ref() instead * Deprecated: 3.0: Use g_object_ref() instead
*/ */
...@@ -191,7 +191,7 @@ gdk_cursor_unref (GdkCursor *cursor) ...@@ -191,7 +191,7 @@ gdk_cursor_unref (GdkCursor *cursor)
* *
* To make the cursor invisible, use %GDK_BLANK_CURSOR. * To make the cursor invisible, use %GDK_BLANK_CURSOR.
* *
* Return value: a new #GdkCursor * Returns: a new #GdkCursor
*/ */
GdkCursor* GdkCursor*
gdk_cursor_new (GdkCursorType cursor_type) gdk_cursor_new (GdkCursorType cursor_type)
...@@ -205,7 +205,7 @@ gdk_cursor_new (GdkCursorType cursor_type) ...@@ -205,7 +205,7 @@ gdk_cursor_new (GdkCursorType cursor_type)
* *
* Returns the cursor type for this cursor. * Returns the cursor type for this cursor.
* *
* Return value: a #GdkCursorType * Returns: a #GdkCursorType
* *
* Since: 2.22 * Since: 2.22
**/ **/
...@@ -243,7 +243,7 @@ gdk_cursor_get_cursor_type (GdkCursor *cursor) ...@@ -243,7 +243,7 @@ gdk_cursor_get_cursor_type (GdkCursor *cursor)
* - ![](sb_v_double_arrow.png) #GDK_SB_V_DOUBLE_ARROW (move horizontal splitter) * - ![](sb_v_double_arrow.png) #GDK_SB_V_DOUBLE_ARROW (move horizontal splitter)
* - #GDK_BLANK_CURSOR (Blank cursor). Since 2.16 * - #GDK_BLANK_CURSOR (Blank cursor). Since 2.16
* *
* Return value: a new #GdkCursor * Returns: a new #GdkCursor
* *
* Since: 2.2 * Since: 2.2
**/ **/
......
...@@ -53,7 +53,7 @@ gdk_pointer_ungrab (guint32 time) ...@@ -53,7 +53,7 @@ gdk_pointer_ungrab (guint32 time)
* Note that this does not take the inmplicit pointer grab on button * Note that this does not take the inmplicit pointer grab on button
* presses into account. * presses into account.
* *
* Return value: %TRUE if the pointer is currently grabbed by this application. * Returns: %TRUE if the pointer is currently grabbed by this application.
* *
* Deprecated: 3.0: Use gdk_display_device_is_grabbed() instead. * Deprecated: 3.0: Use gdk_display_device_is_grabbed() instead.
**/ **/
...@@ -94,7 +94,7 @@ gdk_keyboard_ungrab (guint32 time) ...@@ -94,7 +94,7 @@ gdk_keyboard_ungrab (guint32 time)
* NOTE: For multihead-aware widgets or applications use * NOTE: For multihead-aware widgets or applications use
* gdk_display_get_window_at_pointer() instead. * gdk_display_get_window_at_pointer() instead.
* *
* Return value: (transfer none): window under the mouse pointer * Returns: (transfer none): window under the mouse pointer
* *
* Deprecated: 3.0: Use gdk_device_get_window_at_position() instead. * Deprecated: 3.0: Use gdk_device_get_window_at_position() instead.
**/ **/
......
...@@ -597,7 +597,7 @@ gdk_device_get_window_at_position (GdkDevice *device, ...@@ -597,7 +597,7 @@ gdk_device_get_window_at_position (GdkDevice *device,
* more motion events delivered directly, independent of the windowing * more motion events delivered directly, independent of the windowing
* system. * system.
* *
* Return value: %TRUE if the windowing system supports motion history and * Returns: %TRUE if the windowing system supports motion history and
* at least one event was found. * at least one event was found.
**/ **/
gboolean gboolean
...@@ -667,7 +667,7 @@ gdk_device_free_history (GdkTimeCoord **events, ...@@ -667,7 +667,7 @@ gdk_device_free_history (GdkTimeCoord **events,
* *
* Determines the name of the device. * Determines the name of the device.
* *
* Return value: a name * Returns: a name
* *
* Since: 2.20 * Since: 2.20
**/ **/
...@@ -685,7 +685,7 @@ gdk_device_get_name (GdkDevice *device) ...@@ -685,7 +685,7 @@ gdk_device_get_name (GdkDevice *device)
* *
* Determines whether the pointer follows device motion. * Determines whether the pointer follows device motion.
* *
* Return value: %TRUE if the pointer follows device motion * Returns: %TRUE if the pointer follows device motion
* *
* Since: 2.20 * Since: 2.20
**/ **/
...@@ -704,7 +704,7 @@ gdk_device_get_has_cursor (GdkDevice *device) ...@@ -704,7 +704,7 @@ gdk_device_get_has_cursor (GdkDevice *device)
* *
* Determines the type of the device. * Determines the type of the device.
* *
* Return value: a #GdkInputSource * Returns: a #GdkInputSource
* *
* Since: 2.20 * Since: 2.20
**/ **/
...@@ -722,7 +722,7 @@ gdk_device_get_source (GdkDevice *device) ...@@ -722,7 +722,7 @@ gdk_device_get_source (GdkDevice *device)
* *
* Determines the mode of the device. * Determines the mode of the device.
* *
* Return value: a #GdkInputSource * Returns: a #GdkInputSource
* *
* Since: 2.20 * Since: 2.20
**/ **/
...@@ -1169,7 +1169,7 @@ gdk_device_get_axis_value (GdkDevice *device, ...@@ -1169,7 +1169,7 @@ gdk_device_get_axis_value (GdkDevice *device,
* Interprets an array of double as axis values for a given device, * Interprets an array of double as axis values for a given device,
* and locates the value in the array for a given axis use. * and locates the value in the array for a given axis use.
* *
* Return value: %TRUE if the given axis use was found, otherwise %FALSE * Returns: %TRUE if the given axis use was found, otherwise %FALSE
**/ **/
gboolean gboolean
gdk_device_get_axis (GdkDevice *device, gdk_device_get_axis (GdkDevice *device,
......
...@@ -306,7 +306,7 @@ gdk_display_is_closed (GdkDisplay *display) ...@@ -306,7 +306,7 @@ gdk_display_is_closed (GdkDisplay *display)
* Gets the next #GdkEvent to be processed for @display, fetching events from the * Gets the next #GdkEvent to be processed for @display, fetching events from the
* windowing system if necessary. * windowing system if necessary.
* *
* Return value: the next #GdkEvent to be processed, or %NULL if no events * Returns: the next #GdkEvent to be processed, or %NULL if no events
* are pending. The returned #GdkEvent should be freed with gdk_event_free(). * are pending. The returned #GdkEvent should be freed with gdk_event_free().
* *
* Since: 2.2 * Since: 2.2
...@@ -331,7 +331,7 @@ gdk_display_get_event (GdkDisplay *display) ...@@ -331,7 +331,7 @@ gdk_display_get_event (GdkDisplay *display)
* not get more events from the windowing system. It only checks the events * not get more events from the windowing system. It only checks the events
* that have already been moved to the GDK event queue.) * that have already been moved to the GDK event queue.)
* *
* Return value: a copy of the first #GdkEvent on the event queue, or %NULL * Returns: a copy of the first #GdkEvent on the event queue, or %NULL
* if no events are in the queue. The returned #GdkEvent should be freed with * if no events are in the queue. The returned #GdkEvent should be freed with
* gdk_event_free(). * gdk_event_free().
* *
...@@ -1288,7 +1288,7 @@ _gdk_display_pointer_info_foreach (GdkDisplay *display, ...@@ -1288,7 +1288,7 @@ _gdk_display_pointer_info_foreach (GdkDisplay *display,
* Determines information about the current keyboard grab. * Determines information about the current keyboard grab.
* This is not public API and must not be used by applications. * This is not public API and must not be used by applications.
* *
* Return value: %TRUE if this application currently has the * Returns: %TRUE if this application currently has the
* keyboard grabbed. * keyboard grabbed.
**/ **/
gboolean gboolean
...@@ -1553,7 +1553,7 @@ gdk_display_flush (GdkDisplay *display) ...@@ -1553,7 +1553,7 @@ gdk_display_flush (GdkDisplay *display)
* on @display. This window is implicitly created by GDK. * on @display. This window is implicitly created by GDK.
* See gdk_window_set_group(). * See gdk_window_set_group().
* *
* Return value: (transfer none): The default group leader window * Returns: (transfer none): The default group leader window
* for @display * for @display
* *
* Since: 2.4 * Since: 2.4
...@@ -1573,7 +1573,7 @@ gdk_display_get_default_group (GdkDisplay *display) ...@@ -1573,7 +1573,7 @@ gdk_display_get_default_group (GdkDisplay *display)
* Returns whether #GdkEventOwnerChange events will be * Returns whether #GdkEventOwnerChange events will be
* sent when the owner of a selection changes. * sent when the owner of a selection changes.
* *
* Return value: whether #GdkEventOwnerChange events will * Returns: whether #GdkEventOwnerChange events will
* be sent. * be sent.
* *
* Since: 2.6 * Since: 2.6
...@@ -1595,7 +1595,7 @@ gdk_display_supports_selection_notification (GdkDisplay *display) ...@@ -1595,7 +1595,7 @@ gdk_display_supports_selection_notification (GdkDisplay *display)
* Request #GdkEventOwnerChange events for ownership changes * Request #GdkEventOwnerChange events for ownership changes
* of the selection named by the given atom. * of the selection named by the given atom.
* *
* Return value: whether #GdkEventOwnerChange events will * Returns: whether #GdkEventOwnerChange events will
* be sent. * be sent.
* *
* Since: 2.6 * Since: 2.6
...@@ -1727,7 +1727,7 @@ gdk_display_supports_composite (GdkDisplay *display) ...@@ -1727,7 +1727,7 @@ gdk_display_supports_composite (GdkDisplay *display)
* Returns the list of available input devices attached to @display. * Returns the list of available input devices attached to @display.
* The list is statically allocated and should not be freed. * The list is statically allocated and should not be freed.
* *
* Return value: (transfer none) (element-type GdkDevice): * Returns: (transfer none) (element-type GdkDevice):
* a list of #GdkDevice * a list of #GdkDevice
* *
* Since: 2.2 * Since: 2.2
...@@ -1780,7 +1780,7 @@ gdk_display_get_app_launch_context (GdkDisplay *display) ...@@ -1780,7 +1780,7 @@ gdk_display_get_app_launch_context (GdkDisplay *display)
* *
* Opens a display. * Opens a display.
* *
* Return value: (transfer none): a #GdkDisplay, or %NULL * Returns: (transfer none): a #GdkDisplay, or %NULL
* if the display could not be opened * if the display could not be opened
* *
* Since: 2.2 * Since: 2.2
...@@ -2069,7 +2069,7 @@ _gdk_display_create_window (GdkDisplay *display) ...@@ -2069,7 +2069,7 @@ _gdk_display_create_window (GdkDisplay *display)
* *
* Returns the #GdkKeymap attached to @display. * Returns the #GdkKeymap attached to @display.
* *
* Return value: (transfer none): the #GdkKeymap attached to @display. * Returns: (transfer none): the #GdkKeymap attached to @display.
* *
* Since: 2.2 * Since: 2.2
*/ */
...@@ -2215,7 +2215,7 @@ gdk_error_trap_pop_ignored (void) ...@@ -2215,7 +2215,7 @@ gdk_error_trap_pop_ignored (void)
* sync for you, so you had to gdk_flush() if your last * sync for you, so you had to gdk_flush() if your last
* call to Xlib was not a blocking round trip. * call to Xlib was not a blocking round trip.
* *
* Return value: X error code or 0 on success * Returns: X error code or 0 on success
*/ */
gint gint
gdk_error_trap_pop (void) gdk_error_trap_pop (void)
......
...@@ -392,7 +392,7 @@ gdk_display_manager_set_default_display (GdkDisplayManager *manager, ...@@ -392,7 +392,7 @@ gdk_display_manager_set_default_display (GdkDisplayManager *manager,
* *
* List all currently open displays. * List all currently open displays.
* *
* Return value: (transfer container) (element-type GdkDisplay): a newly * Returns: (transfer container) (element-type GdkDisplay): a newly
* allocated #GSList of #GdkDisplay objects. Free with g_slist_free() * allocated #GSList of #GdkDisplay objects. Free with g_slist_free()
* when you are done with it. * when you are done with it.
* *
...@@ -411,7 +411,7 @@ gdk_display_manager_list_displays (GdkDisplayManager *manager) ...@@ -411,7 +411,7 @@ gdk_display_manager_list_displays (GdkDisplayManager *manager)
* *
* Opens a display. * Opens a display.
* *
* Return value: (transfer none): a #GdkDisplay, or %NULL * Returns: (transfer none): a #GdkDisplay, or %NULL
* if the display could not be opened * if the display could not be opened
* *
* Since: 3.0 * Since: 3.0
......
...@@ -51,7 +51,7 @@ ...@@ -51,7 +51,7 @@
* *
* Retrieves the list of targets of the context. * Retrieves the list of targets of the context.
* *
* Return value: (transfer none) (element-type GdkAtom): a #GList of targets * Returns: (transfer none) (element-type GdkAtom): a #GList of targets
* *
* Since: 2.22 * Since: 2.22
**/ **/
...@@ -70,7 +70,7 @@ gdk_drag_context_list_targets (GdkDragContext *context) ...@@ -70,7 +70,7 @@ gdk_drag_context_list_targets (GdkDragContext *context)
* Determines the bitmask of actions proposed by the source if * Determines the bitmask of actions proposed by the source if
* gdk_drag_context_get_suggested_action() returns GDK_ACTION_ASK. * gdk_drag_context_get_suggested_action() returns GDK_ACTION_ASK.
* *
* Return value: the #GdkDragAction flags * Returns: the #GdkDragAction flags
* *
* Since: 2.22 * Since: 2.22
**/ **/
...@@ -88,7 +88,7 @@ gdk_drag_context_get_actions (GdkDragContext *context) ...@@ -88,7 +88,7 @@ gdk_drag_context_get_actions (GdkDragContext *context)
* *
* Determines the suggested drag action of the context. * Determines the suggested drag action of the context.
* *
* Return value: a #GdkDragAction value * Returns: a #GdkDragAction value
* *
* Since: 2.22 * Since: 2.22
**/ **/
...@@ -106,7 +106,7 @@ gdk_drag_context_get_suggested_action (GdkDragContext *context) ...@@ -106,7 +106,7 @@ gdk_drag_context_get_suggested_action (GdkDragContext *context)
* *
* Determines the action chosen by the drag destination. * Determines the action chosen by the drag destination.
* *
* Return value: a #GdkDragAction value * Returns: a #GdkDragAction value
* *
* Since: 2.22 * Since: 2.22
**/ **/
...@@ -124,7 +124,7 @@ gdk_drag_context_get_selected_action (GdkDragContext *context) ...@@ -124,7 +124,7 @@ gdk_drag_context_get_selected_action (GdkDragContext *context)
* *
* Returns the #GdkWindow where the DND operation started. * Returns the #GdkWindow where the DND operation started.
* *
* Return value: (transfer none): a #GdkWindow * Returns: (transfer none): a #GdkWindow
* *
* Since: 2.22 * Since: 2.22
**/ **/
...@@ -142,7 +142,7 @@ gdk_drag_context_get_source_window (GdkDragContext *context) ...@@ -142,7 +142,7 @@ gdk_drag_context_get_source_window (GdkDragContext *context)
* *
* Returns the destination windw for the DND operation. * Returns the destination windw for the DND operation.
* *
* Return value: (transfer none): a #GdkWindow * Returns: (transfer none): a #GdkWindow
* *
* Since: 3.0 * Since: 3.0
**/ **/
...@@ -427,7 +427,7 @@ gdk_drop_finish (GdkDragContext *context, ...@@ -427,7 +427,7 @@ gdk_drop_finish (GdkDragContext *context,
* handling a %GDK_DROP_FINISHED event, its return value is * handling a %GDK_DROP_FINISHED event, its return value is
* meaningless at other times. * meaningless at other times.
* *
* Return value: %TRUE if the drop was successful. * Returns: %TRUE if the drop was successful.
* *
* Since: 2.6 * Since: 2.6
**/ **/
...@@ -445,7 +445,7 @@ gdk_drag_drop_succeeded (GdkDragContext *context) ...@@ -445,7 +445,7 @@ gdk_drag_drop_succeeded (GdkDragContext *context)
* *
* Returns the selection atom for the current source window. * Returns the selection atom for the current source window.
* *
* Return value: (transfer none): the selection atom, or %GDK_NONE * Returns: (transfer none): the selection atom, or %GDK_NONE
*/ */
GdkAtom GdkAtom
gdk_drag_get_selection (GdkDragContext *context) gdk_drag_get_selection (GdkDragContext *context)
......
...@@ -80,7 +80,7 @@ _gdk_event_emit (GdkEvent *event) ...@@ -80,7 +80,7 @@ _gdk_event_emit (GdkEvent *event)
* Find the first event on the queue that is not still * Find the first event on the queue that is not still
* being filled in. * being filled in.
* *
* Return value: Pointer to the list node for that event, or NULL. * Returns: Pointer to the list node for that event, or NULL.
**/ **/
GList* GList*
_gdk_event_queue_find_first (GdkDisplay *display) _gdk_event_queue_find_first (GdkDisplay *display)
...@@ -241,7 +241,7 @@ _gdk_event_queue_remove_link (GdkDisplay *display, ...@@ -241,7 +241,7 @@ _gdk_event_queue_remove_link (GdkDisplay *display,
* Removes and returns the first event from the event * Removes and returns the first event from the event
* queue that is not still being filled in. * queue that is not still being filled in.
* *
* Return value: the event, or %NULL. Ownership is transferred * Returns: the event, or %NULL. Ownership is transferred
* to the caller. * to the caller.
**/ **/
GdkEvent* GdkEvent*
...@@ -365,7 +365,7 @@ gdk_event_handler_set (GdkEventFunc func, ...@@ -365,7 +365,7 @@ gdk_event_handler_set (GdkEventFunc func,
* *
* Checks if any events are ready to be processed for any display. * Checks if any events are ready to be processed for any display.
* *
* Return value: %TRUE if any events are pending. * Returns: %TRUE if any events are pending.
*/ */
gboolean gboolean
gdk_events_pending (void) gdk_events_pending (void)
...@@ -406,7 +406,7 @@ gdk_events_pending (void) ...@@ -406,7 +406,7 @@ gdk_events_pending (void)
* on, fetching events from the windowing system if necessary. * on, fetching events from the windowing system if necessary.
* See gdk_display_get_event(). * See gdk_display_get_event().
* *
* Return value: the next #GdkEvent to be processed, or %NULL if no events * Returns: the next #GdkEvent to be processed, or %NULL if no events
* are pending. The returned #GdkEvent should be freed with gdk_event_free(). * are pending. The returned #GdkEvent should be freed with gdk_event_free().
**/ **/
GdkEvent* GdkEvent*
...@@ -435,7 +435,7 @@ gdk_event_get (void) ...@@ -435,7 +435,7 @@ gdk_event_get (void)
* If there is an event waiting in the event queue of some open * If there is an event waiting in the event queue of some open
* display, returns a copy of it. See gdk_display_peek_event(). * display, returns a copy of it. See gdk_display_peek_event().
* *
* Return value: a copy of the first #GdkEvent on some event queue, or %NULL if no * Returns: a copy of the first #GdkEvent on some event queue, or %NULL if no
* events are in any queues. The returned #GdkEvent should be freed with * events are in any queues. The returned #GdkEvent should be freed with
* gdk_event_free(). * gdk_event_free().
**/ **/
...@@ -494,7 +494,7 @@ static GHashTable *event_hash = NULL; ...@@ -494,7 +494,7 @@ static GHashTable *event_hash = NULL;
* *
* Creates a new event of the given type. All fields are set to 0. * Creates a new event of the given type. All fields are set to 0.
* *
* Return value: a newly-allocated #GdkEvent. The returned #GdkEvent * Returns: a newly-allocated #GdkEvent. The returned #GdkEvent
* should be freed with gdk_event_free(). * should be freed with gdk_event_free().
* *
* Since: 2.2 * Since: 2.2
...@@ -613,7 +613,7 @@ _gdk_event_get_pointer_emulated (GdkEvent *event) ...@@ -613,7 +613,7 @@ _gdk_event_get_pointer_emulated (GdkEvent *event)
* Copies a #GdkEvent, copying or incrementing the reference count of the * Copies a #GdkEvent, copying or incrementing the reference count of the
* resources associated with it (e.g. #GdkWindow’s and strings). * resources associated with it (e.g. #GdkWindow’s and strings).
* *
* Return value: a copy of @event. The returned #GdkEvent should be freed with * Returns: a copy of @event. The returned #GdkEvent should be freed with
* gdk_event_free(). * gdk_event_free().
**/ **/
GdkEvent* GdkEvent*
...@@ -820,7 +820,7 @@ gdk_event_free (GdkEvent *event) ...@@ -820,7 +820,7 @@ gdk_event_free (GdkEvent *event)
* *
* Extracts the #GdkWindow associated with an event. * Extracts the #GdkWindow associated with an event.
* *
* Return value: (transfer none): The #GdkWindow associated with the event * Returns: (transfer none): The #GdkWindow associated with the event
* *
* Since: 3.10 * Since: 3.10
*/ */
...@@ -839,7 +839,7 @@ gdk_event_get_window (const GdkEvent *event) ...@@ -839,7 +839,7 @@ gdk_event_get_window (const GdkEvent *event)
* Returns the time stamp from @event, if there is one; otherwise * Returns the time stamp from @event, if there is one; otherwise
* returns #GDK_CURRENT_TIME. If @event is %NULL, returns #GDK_CURRENT_TIME. * returns #GDK_CURRENT_TIME. If @event is %NULL, returns #GDK_CURRENT_TIME.
* *
* Return value: time stamp field from @event * Returns: time stamp field from @event