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)
* display has previously been set, simply returns that. An internal
* 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.
**/
GdkDisplay *
......@@ -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
*/
......@@ -736,7 +736,7 @@ gdk_threads_add_idle_full (gint priority,
*
* 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
*/
......@@ -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
*/
......@@ -842,7 +842,7 @@ gdk_threads_add_timeout_full (gint priority,
*
* 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
*/
......@@ -869,7 +869,7 @@ gdk_threads_add_timeout (guint interval,
* 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.
*
* Return value: the ID (greater than 0) of the event source.
* Returns: the ID (greater than 0) of the event source.
*
* Since: 2.14
*/
......@@ -907,7 +907,7 @@ gdk_threads_add_timeout_seconds_full (gint priority,
*
* 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
*/
......
......@@ -51,7 +51,7 @@
*
* The result must be freed using gdk_color_free().
*
* Return value: a copy of @color
* Returns: a copy of @color
*/
GdkColor*
gdk_color_copy (const GdkColor *color)
......@@ -86,7 +86,7 @@ gdk_color_free (GdkColor *color)
* A hash function suitable for using for a hash
* table that stores #GdkColors.
*
* Return value: The hash function applied to @color
* Returns: The hash function applied to @color
*/
guint
gdk_color_hash (const GdkColor *color)
......@@ -104,7 +104,7 @@ gdk_color_hash (const GdkColor *color)
*
* Compares two colors.
*
* Return value: %TRUE if the two colors compare equal
* Returns: %TRUE if the two colors compare equal
*/
gboolean
gdk_color_equal (const GdkColor *colora,
......@@ -138,7 +138,7 @@ G_DEFINE_BOXED_TYPE (GdkColor, gdk_color,
* (White in the four forms is “\#fff”, “\#ffffff”, “\#fffffffff”
* and “\#ffffffffffff”).
*
* Return value: %TRUE if the parsing succeeded
* Returns: %TRUE if the parsing succeeded
*/
gboolean
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().
*
* Return value: a newly-allocated text string
* Returns: a newly-allocated text string
*
* Since: 2.12
*/
......
......@@ -153,7 +153,7 @@ gdk_cursor_init (GdkCursor *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
*/
......@@ -191,7 +191,7 @@ gdk_cursor_unref (GdkCursor *cursor)
*
* To make the cursor invisible, use %GDK_BLANK_CURSOR.
*
* Return value: a new #GdkCursor
* Returns: a new #GdkCursor
*/
GdkCursor*
gdk_cursor_new (GdkCursorType cursor_type)
......@@ -205,7 +205,7 @@ gdk_cursor_new (GdkCursorType cursor_type)
*
* Returns the cursor type for this cursor.
*
* Return value: a #GdkCursorType
* Returns: a #GdkCursorType
*
* Since: 2.22
**/
......@@ -243,7 +243,7 @@ gdk_cursor_get_cursor_type (GdkCursor *cursor)
* - ![](sb_v_double_arrow.png) #GDK_SB_V_DOUBLE_ARROW (move horizontal splitter)
* - #GDK_BLANK_CURSOR (Blank cursor). Since 2.16
*
* Return value: a new #GdkCursor
* Returns: a new #GdkCursor
*
* Since: 2.2
**/
......
......@@ -53,7 +53,7 @@ gdk_pointer_ungrab (guint32 time)
* Note that this does not take the inmplicit pointer grab on button
* 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.
**/
......@@ -94,7 +94,7 @@ gdk_keyboard_ungrab (guint32 time)
* NOTE: For multihead-aware widgets or applications use
* 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.
**/
......
......@@ -597,7 +597,7 @@ gdk_device_get_window_at_position (GdkDevice *device,
* more motion events delivered directly, independent of the windowing
* 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.
**/
gboolean
......@@ -667,7 +667,7 @@ gdk_device_free_history (GdkTimeCoord **events,
*
* Determines the name of the device.
*
* Return value: a name
* Returns: a name
*
* Since: 2.20
**/
......@@ -685,7 +685,7 @@ gdk_device_get_name (GdkDevice *device)
*
* 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
**/
......@@ -704,7 +704,7 @@ gdk_device_get_has_cursor (GdkDevice *device)
*
* Determines the type of the device.
*
* Return value: a #GdkInputSource
* Returns: a #GdkInputSource
*
* Since: 2.20
**/
......@@ -722,7 +722,7 @@ gdk_device_get_source (GdkDevice *device)
*
* Determines the mode of the device.
*
* Return value: a #GdkInputSource
* Returns: a #GdkInputSource
*
* Since: 2.20
**/
......@@ -1169,7 +1169,7 @@ gdk_device_get_axis_value (GdkDevice *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.
*
* Return value: %TRUE if the given axis use was found, otherwise %FALSE
* Returns: %TRUE if the given axis use was found, otherwise %FALSE
**/
gboolean
gdk_device_get_axis (GdkDevice *device,
......
......@@ -306,7 +306,7 @@ gdk_display_is_closed (GdkDisplay *display)
* Gets the next #GdkEvent to be processed for @display, fetching events from the
* 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().
*
* Since: 2.2
......@@ -331,7 +331,7 @@ gdk_display_get_event (GdkDisplay *display)
* not get more events from the windowing system. It only checks the events
* 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
* gdk_event_free().
*
......@@ -1288,7 +1288,7 @@ _gdk_display_pointer_info_foreach (GdkDisplay *display,
* Determines information about the current keyboard grab.
* 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.
**/
gboolean
......@@ -1553,7 +1553,7 @@ gdk_display_flush (GdkDisplay *display)
* on @display. This window is implicitly created by GDK.
* See gdk_window_set_group().
*
* Return value: (transfer none): The default group leader window
* Returns: (transfer none): The default group leader window
* for @display
*
* Since: 2.4
......@@ -1573,7 +1573,7 @@ gdk_display_get_default_group (GdkDisplay *display)
* Returns whether #GdkEventOwnerChange events will be
* sent when the owner of a selection changes.
*
* Return value: whether #GdkEventOwnerChange events will
* Returns: whether #GdkEventOwnerChange events will
* be sent.
*
* Since: 2.6
......@@ -1595,7 +1595,7 @@ gdk_display_supports_selection_notification (GdkDisplay *display)
* Request #GdkEventOwnerChange events for ownership changes
* of the selection named by the given atom.
*
* Return value: whether #GdkEventOwnerChange events will
* Returns: whether #GdkEventOwnerChange events will
* be sent.
*
* Since: 2.6
......@@ -1727,7 +1727,7 @@ gdk_display_supports_composite (GdkDisplay *display)
* Returns the list of available input devices attached to @display.
* 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
*
* Since: 2.2
......@@ -1780,7 +1780,7 @@ gdk_display_get_app_launch_context (GdkDisplay *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
*
* Since: 2.2
......@@ -2069,7 +2069,7 @@ _gdk_display_create_window (GdkDisplay *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
*/
......@@ -2215,7 +2215,7 @@ gdk_error_trap_pop_ignored (void)
* sync for you, so you had to gdk_flush() if your last
* 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
gdk_error_trap_pop (void)
......
......@@ -392,7 +392,7 @@ gdk_display_manager_set_default_display (GdkDisplayManager *manager,
*
* 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()
* when you are done with it.
*
......@@ -411,7 +411,7 @@ gdk_display_manager_list_displays (GdkDisplayManager *manager)
*
* 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
*
* Since: 3.0
......
......@@ -51,7 +51,7 @@
*
* 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
**/
......@@ -70,7 +70,7 @@ gdk_drag_context_list_targets (GdkDragContext *context)
* Determines the bitmask of actions proposed by the source if
* gdk_drag_context_get_suggested_action() returns GDK_ACTION_ASK.
*
* Return value: the #GdkDragAction flags
* Returns: the #GdkDragAction flags
*
* Since: 2.22
**/
......@@ -88,7 +88,7 @@ gdk_drag_context_get_actions (GdkDragContext *context)
*
* Determines the suggested drag action of the context.
*
* Return value: a #GdkDragAction value
* Returns: a #GdkDragAction value
*
* Since: 2.22
**/
......@@ -106,7 +106,7 @@ gdk_drag_context_get_suggested_action (GdkDragContext *context)
*
* Determines the action chosen by the drag destination.
*
* Return value: a #GdkDragAction value
* Returns: a #GdkDragAction value
*
* Since: 2.22
**/
......@@ -124,7 +124,7 @@ gdk_drag_context_get_selected_action (GdkDragContext *context)
*
* Returns the #GdkWindow where the DND operation started.
*
* Return value: (transfer none): a #GdkWindow
* Returns: (transfer none): a #GdkWindow
*
* Since: 2.22
**/
......@@ -142,7 +142,7 @@ gdk_drag_context_get_source_window (GdkDragContext *context)
*
* Returns the destination windw for the DND operation.
*
* Return value: (transfer none): a #GdkWindow
* Returns: (transfer none): a #GdkWindow
*
* Since: 3.0
**/
......@@ -427,7 +427,7 @@ gdk_drop_finish (GdkDragContext *context,
* handling a %GDK_DROP_FINISHED event, its return value is
* meaningless at other times.
*
* Return value: %TRUE if the drop was successful.
* Returns: %TRUE if the drop was successful.
*
* Since: 2.6
**/
......@@ -445,7 +445,7 @@ gdk_drag_drop_succeeded (GdkDragContext *context)
*
* 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
gdk_drag_get_selection (GdkDragContext *context)
......
......@@ -80,7 +80,7 @@ _gdk_event_emit (GdkEvent *event)
* Find the first event on the queue that is not still
* 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*
_gdk_event_queue_find_first (GdkDisplay *display)
......@@ -241,7 +241,7 @@ _gdk_event_queue_remove_link (GdkDisplay *display,
* Removes and returns the first event from the event
* 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.
**/
GdkEvent*
......@@ -365,7 +365,7 @@ gdk_event_handler_set (GdkEventFunc func,
*
* 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
gdk_events_pending (void)
......@@ -406,7 +406,7 @@ gdk_events_pending (void)
* on, fetching events from the windowing system if necessary.
* 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().
**/
GdkEvent*
......@@ -435,7 +435,7 @@ gdk_event_get (void)
* If there is an event waiting in the event queue of some open
* 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
* gdk_event_free().
**/
......@@ -494,7 +494,7 @@ static GHashTable *event_hash = NULL;
*
* 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().
*
* Since: 2.2
......@@ -613,7 +613,7 @@ _gdk_event_get_pointer_emulated (GdkEvent *event)
* Copies a #GdkEvent, copying or incrementing the reference count of the
* 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().
**/
GdkEvent*
......@@ -820,7 +820,7 @@ gdk_event_free (GdkEvent *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
*/
......@@ -839,7 +839,7 @@ gdk_event_get_window (const GdkEvent *event)
* Returns the time stamp from @event, if there is one; otherwise
* 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
**/
guint32
gdk_event_get_time (const GdkEvent *event)
......@@ -916,7 +916,7 @@ gdk_event_get_time (const GdkEvent *event)
* in the event. @event may be %NULL, in which case it’s treated
* as if the event had no state field.
*
* Return value: %TRUE if there was a state field in the event
* Returns: %TRUE if there was a state field in the event
**/
gboolean
gdk_event_get_state (const GdkEvent *event,
......@@ -997,7 +997,7 @@ gdk_event_get_state (const GdkEvent *event,
*
* Extract the event window relative x/y coordinates from an event.
*
* Return value: %TRUE if the event delivered event window coordinates
* Returns: %TRUE if the event delivered event window coordinates
**/
gboolean
gdk_event_get_coords (const GdkEvent *event,
......@@ -1063,7 +1063,7 @@ gdk_event_get_coords (const GdkEvent *event,
*
* Extract the root window relative x/y coordinates from an event.
*
* Return value: %TRUE if the event delivered root window coordinates
* Returns: %TRUE if the event delivered root window coordinates
**/
gboolean
gdk_event_get_root_coords (const GdkEvent *event,
......@@ -1133,7 +1133,7 @@ gdk_event_get_root_coords (const GdkEvent *event,
*
* Extract the button number from an event.
*
* Return value: %TRUE if the event delivered a button number
* Returns: %TRUE if the event delivered a button number
*
* Since: 3.2
**/
......@@ -1172,7 +1172,7 @@ gdk_event_get_button (const GdkEvent *event,
*
* Extracts the click count from an event.
*
* Return value: %TRUE if the event delivered a click count
* Returns: %TRUE if the event delivered a click count
*
* Since: 3.2
*/
......@@ -1215,7 +1215,7 @@ gdk_event_get_click_count (const GdkEvent *event,
*
* Extracts the keyval from an event.
*
* Return value: %TRUE if the event delivered a key symbol
* Returns: %TRUE if the event delivered a key symbol
*
* Since: 3.2
*/
......@@ -1250,7 +1250,7 @@ gdk_event_get_keyval (const GdkEvent *event,
*
* Extracts the hardware keycode from an event.
*
* Return value: %TRUE if the event delivered a hardware keycode
* Returns: %TRUE if the event delivered a hardware keycode
*
* Since: 3.2
*/
......@@ -1285,7 +1285,7 @@ gdk_event_get_keycode (const GdkEvent *event,
*
* Extracts the scroll direction from an event.
*
* Return value: %TRUE if the event delivered a scroll direction
* Returns: %TRUE if the event delivered a scroll direction
*
* Since: 3.2
*/
......@@ -1370,7 +1370,7 @@ gdk_event_get_scroll_deltas (const GdkEvent *event,
* Extract the axis value for a particular axis use from
* an event structure.
*
* Return value: %TRUE if the specified axis was found, otherwise %FALSE
* Returns: %TRUE if the specified axis was found, otherwise %FALSE
**/
gboolean
gdk_event_get_axis (const GdkEvent *event,
......@@ -1921,7 +1921,7 @@ gdk_event_set_screen (GdkEvent *event,
* to which `event->motion.x_root` and
* `event->motion.y_root` are relative.
*
* Return value: (transfer none): the screen for the event
* Returns: (transfer none): the screen for the event
*
* Since: 2.2
**/
......@@ -1992,7 +1992,7 @@ gdk_set_show_events (gboolean show_events)
*
* Gets whether event debugging output is enabled.
*
* Return value: %TRUE if event debugging output is enabled.
* Returns: %TRUE if event debugging output is enabled.
**/
gboolean
gdk_get_show_events (void)
......@@ -2225,7 +2225,7 @@ gdk_setting_get (const gchar *name,
*
* Retrieves the type of the event.
*
* Return value: a #GdkEventType
* Returns: a #GdkEventType
*
* Since: 3.10
*/
......
......@@ -259,7 +259,7 @@ gdk_frame_clock_init (GdkFrameClock *clock)
* time.
*
* Since: 3.8
* Return value: a timestamp in microseconds, in the timescale of
* Returns: a timestamp in microseconds, in the timescale of
* of g_get_monotonic_time().
*/
gint64
......@@ -387,7 +387,7 @@ gdk_frame_clock_get_frame_counter (GdkFrameClock *frame_clock)
* gdk_frame_clock_get_history_start() and
* gdk_frame_clock_get_frame_counter(), inclusive.
*
* Return value: the frame counter value for the oldest frame
* Returns: the frame counter value for the oldest frame
* that is available in the internal frame history of the
* #GdkFrameClock.
* Since: 3.8
......@@ -436,7 +436,7 @@ _gdk_frame_clock_begin_frame (GdkFrameClock *frame_clock)
* for the current frame or a recent frame. The #GdkFrameTimings
* object may not yet be complete: see gdk_frame_timings_get_complete().
*
* Return value: the #GdkFrameTimings object for the specified
* Returns: the #GdkFrameTimings object for the specified
* frame, or %NULL if it is not available. See
* gdk_frame_clock_get_history_start().
* Since: 3.8
......
......@@ -398,7 +398,7 @@ gdk_keymap_get_modifier_state (GdkKeymap *keymap)
* The returned array should be freed
* with g_free().
*
* Return value: %TRUE if keys were found and returned
* Returns: %TRUE if keys were found and returned
**/
gboolean
gdk_keymap_get_entries_for_keyval (GdkKeymap *keymap,
......@@ -459,7 +459,7 @@ gdk_keymap_get_entries_for_keycode (GdkKeymap *keymap,
* this function, since the effective group/level may not be
* the same as the current keyboard state.
*
* Return value: a keyval, or 0 if none was mapped to the given @key
* Returns: a keyval, or 0 if none was mapped to the given @key
**/
guint
gdk_keymap_lookup_key (GdkKeymap *keymap,
......@@ -532,7 +532,7 @@ gdk_keymap_lookup_key (GdkKeymap *keymap,
* you store accelerators, you should always store them with consumed
* modifiers removed. Store `<Control>plus`, not `<Control><Shift>plus`,
*
* Return value: %TRUE if there was a keyval bound to the keycode/state/group
* Returns: %TRUE if there was a keyval bound to the keycode/state/group
**/
gboolean
gdk_keymap_translate_keyboard_state (GdkKeymap *keymap,
......@@ -680,7 +680,7 @@ gdk_keymap_get_modifier_mask (GdkKeymap *keymap,
* `gdk/gdkkeysyms.h` header file
* but without the leading “GDK_KEY_”.
*
* Return value: (transfer none): a string containing the name of the key,
* Returns: (transfer none): a string containing the name of the key,
* or %NULL if @keyval is not a valid key. The string should not be
* modified.
*/
......
......@@ -879,7 +879,7 @@ static const struct {
* Convert from a GDK key symbol to the corresponding ISO10646 (Unicode)
* character.
*
* Return value: the corresponding unicode character, or 0 if there
* Returns: the corresponding unicode character, or 0 if there
* is no corresponding character.
**/
guint32
......@@ -1678,7 +1678,7 @@ static const struct {
*
* Convert from a ISO10646 character to a key symbol.
*
* Return value: the corresponding GDK key symbol, if one exists.
* Returns: the corresponding GDK key symbol, if one exists.
* or, if there is no corresponding symbol,
* wc | 0x01000000
**/
......
......@@ -212,7 +212,7 @@ layout_iter_get_line_clip_region (PangoLayoutIter *iter,
* the clip region. The clip region is mainly useful for highlightling parts
* of text, such as when text is selected.
*
* Return value: a clip region containing the given ranges
* Returns: a clip region containing the given ranges
**/
cairo_region_t*
gdk_pango_layout_line_get_clip_region (PangoLayoutLine *line,
......@@ -256,7 +256,7 @@ gdk_pango_layout_line_get_clip_region (PangoLayoutLine *line,
* the clip region. The clip region is mainly useful for highlightling parts
* of text, such as when text is selected.
*
* Return value: a clip region containing the given ranges
* Returns: a clip region containing the given ranges
**/
cairo_region_t*
gdk_pango_layout_get_clip_region (PangoLayout *layout,
......@@ -317,7 +317,7 @@ gdk_pango_layout_get_clip_region (PangoLayout *layout,
* is more convenient if you want to keep a context around and track
* changes to the screen’s font rendering settings.
*
* Return value: (transfer full): a new #PangoContext for the default display
* Returns: (transfer full): a new #PangoContext for the default display
**/
PangoContext *
gdk_pango_context_get (void)
......@@ -343,7 +343,7 @@ gdk_pango_context_get (void)
* is more convenient if you want to keep a context around and track
* changes to the screen’s font rendering settings.
*
* Return value: (transfer full): a new #PangoContext for @screen
* Returns: (transfer full): a new #PangoContext for @screen
*
* Since: 2.2
**/
......
......@@ -77,7 +77,7 @@
* (In short, there are several ways this function can fail, and if it fails
* it returns %NULL; so check the return value.)
*
* Return value: (transfer full): A newly-created pixbuf with a reference
* Returns: (transfer full): A newly-created pixbuf with a reference
* count of 1, or %NULL on error
*/
GdkPixbuf *
......@@ -225,7 +225,7 @@ convert_no_alpha (guchar *dest_data,
* This function will create an RGB pixbuf with 8 bits per channel.
* The pixbuf will contain an alpha channel if the @surface contains one.
*
* Return value: (transfer full): A newly-created pixbuf with a reference
* Returns: (transfer full): A newly-created pixbuf with a reference
* count of 1, or %NULL on error
*/
GdkPixbuf *
......
......@@ -281,7 +281,7 @@ gdk_rgba_parse (GdkRGBA *rgba,
* A hash function suitable for using for a hash
* table that stores #GdkRGBAs.
*
* Return value: The hash value for @p