Commit 20f4d182 authored by William Jon McCann's avatar William Jon McCann

docs: use "Returns:" consistently

Instead of "Return value:".
parent 9cb53851
......@@ -389,7 +389,7 @@ g_action_group_has_action (GActionGroup *action_group,
* possible for an action to be removed and for a new action to be added
* with the same name but a different parameter type.
*
* Return value: the parameter type
* Returns: the parameter type
*
* Since: 2.28
**/
......@@ -463,7 +463,7 @@ g_action_group_get_action_state_type (GActionGroup *action_group,
* The return value (if non-%NULL) should be freed with
* g_variant_unref() when it is no longer required.
*
* Return value: (transfer full): the state range hint
* Returns: (transfer full): the state range hint
*
* Since: 2.28
**/
......@@ -487,7 +487,7 @@ g_action_group_get_action_state_hint (GActionGroup *action_group,
* An action must be enabled in order to be activated or in order to
* have its state changed from outside callers.
*
* Return value: whether or not the action is currently enabled
* Returns: whether or not the action is currently enabled
*
* Since: 2.28
**/
......@@ -515,7 +515,7 @@ g_action_group_get_action_enabled (GActionGroup *action_group,
* The return value (if non-%NULL) should be freed with
* g_variant_unref() when it is no longer required.
*
* Return value: (allow-none): the current state of the action
* Returns: (allow-none): the current state of the action
*
* Since: 2.28
**/
......
......@@ -925,7 +925,7 @@ g_app_launch_context_unsetenv (GAppLaunchContext *context,
* This is a %NULL-terminated array of strings, where each string has
* the form `KEY=VALUE`.
*
* Return value: (array zero-terminated=1) (transfer full): the
* Returns: (array zero-terminated=1) (transfer full): the
* child's environment
*
* Since: 2.32
......
......@@ -715,7 +715,7 @@ static GSourceFuncs cancellable_source_funcs =
* For convenience, you can call this with a %NULL #GCancellable,
* in which case the source will never trigger.
*
* Return value: (transfer full): the new #GSource.
* Returns: (transfer full): the new #GSource.
*
* Since: 2.28
*/
......
......@@ -4188,7 +4188,7 @@ append_desktop_entry (GList *list,
*
* Optionally doesn't list the desktop ids given in the @except
*
* Return value: a #GList containing the desktop ids which claim
* Returns: a #GList containing the desktop ids which claim
* to handle @mime_type.
*/
static GList *
......
......@@ -191,7 +191,7 @@ g_file_enumerator_init (GFileEnumerator *enumerator)
* enumerator is at the end, %NULL will be returned and @error will
* be unset.
*
* Return value: (transfer full): A #GFileInfo or %NULL on error or end of enumerator.
* Returns: (transfer full): A #GFileInfo or %NULL on error or end of enumerator.
* Free the returned object with g_object_unref() when no longer needed.
**/
GFileInfo *
......@@ -254,7 +254,7 @@ g_file_enumerator_next_file (GFileEnumerator *enumerator,
* is dropped, but you might want to call this function to make
* sure resources are released as early as possible.
*
* Return value: #TRUE on success or #FALSE on error.
* Returns: #TRUE on success or #FALSE on error.
**/
gboolean
g_file_enumerator_close (GFileEnumerator *enumerator,
......
......@@ -206,7 +206,7 @@ g_filter_input_stream_get_base_stream (GFilterInputStream *stream)
* Returns whether the base stream will be closed when @stream is
* closed.
*
* Return value: %TRUE if the base stream will be closed.
* Returns: %TRUE if the base stream will be closed.
**/
gboolean
g_filter_input_stream_get_close_base_stream (GFilterInputStream *stream)
......
......@@ -210,7 +210,7 @@ g_filter_output_stream_get_base_stream (GFilterOutputStream *stream)
* Returns whether the base stream will be closed when @stream is
* closed.
*
* Return value: %TRUE if the base stream will be closed.
* Returns: %TRUE if the base stream will be closed.
**/
gboolean
g_filter_output_stream_get_close_base_stream (GFilterOutputStream *stream)
......
......@@ -330,7 +330,7 @@ g_inet_address_mask_new_from_string (const gchar *mask_string,
*
* Converts @mask back to its corresponding string form.
*
* Return value: a string corresponding to @mask.
* Returns: a string corresponding to @mask.
*
* Since: 2.32
*/
......@@ -358,7 +358,7 @@ g_inet_address_mask_to_string (GInetAddressMask *mask)
*
* Gets the #GSocketFamily of @mask's address
*
* Return value: the #GSocketFamily of @mask's address
* Returns: the #GSocketFamily of @mask's address
*
* Since: 2.32
*/
......@@ -376,7 +376,7 @@ g_inet_address_mask_get_family (GInetAddressMask *mask)
*
* Gets @mask's base address
*
* Return value: (transfer none): @mask's base address
* Returns: (transfer none): @mask's base address
*
* Since: 2.32
*/
......@@ -394,7 +394,7 @@ g_inet_address_mask_get_address (GInetAddressMask *mask)
*
* Gets @mask's length
*
* Return value: @mask's length
* Returns: @mask's length
*
* Since: 2.32
*/
......@@ -413,7 +413,7 @@ g_inet_address_mask_get_length (GInetAddressMask *mask)
*
* Tests if @address falls within the range described by @mask.
*
* Return value: whether @address falls within the range described by
* Returns: whether @address falls within the range described by
* @mask.
*
* Since: 2.32
......@@ -457,7 +457,7 @@ g_inet_address_mask_matches (GInetAddressMask *mask,
*
* Tests if @mask and @mask2 are the same mask.
*
* Return value: whether @mask and @mask2 are the same mask
* Returns: whether @mask and @mask2 are the same mask
*
* Since: 2.32
*/
......
......@@ -447,7 +447,7 @@ g_inet_socket_address_get_port (GInetSocketAddress *address)
* Gets the `sin6_flowinfo` field from @address,
* which must be an IPv6 address.
*
* Return value: the flowinfo field
* Returns: the flowinfo field
*
* Since: 2.32
*/
......@@ -467,7 +467,7 @@ g_inet_socket_address_get_flowinfo (GInetSocketAddress *address)
* Gets the `sin6_scope_id` field from @address,
* which must be an IPv6 address.
*
* Return value: the scope id field
* Returns: the scope id field
*
* Since: 2.32
*/
......
......@@ -127,7 +127,7 @@ g_initable_init (GInitable *initable,
* similar to g_object_new() but also initializes the object
* and returns %NULL, setting an error on failure.
*
* Return value: (type GObject.Object) (transfer full): a newly allocated
* Returns: (type GObject.Object) (transfer full): a newly allocated
* #GObject, or %NULL on error
*
* Since: 2.22
......@@ -164,7 +164,7 @@ g_initable_new (GType object_type,
* similar to g_object_newv() but also initializes the object
* and returns %NULL, setting an error on failure.
*
* Return value: (type GObject.Object) (transfer full): a newly allocated
* Returns: (type GObject.Object) (transfer full): a newly allocated
* #GObject, or %NULL on error
*
* Since: 2.22
......@@ -205,7 +205,7 @@ g_initable_newv (GType object_type,
* similar to g_object_new_valist() but also initializes the object
* and returns %NULL, setting an error on failure.
*
* Return value: (type GObject.Object) (transfer full): a newly allocated
* Returns: (type GObject.Object) (transfer full): a newly allocated
* #GObject, or %NULL on error
*
* Since: 2.22
......
......@@ -149,7 +149,7 @@ g_input_stream_init (GInputStream *stream)
*
* On error -1 is returned and @error is set accordingly.
*
* Return value: Number of bytes read, or -1 on error, or 0 on end of file.
* Returns: Number of bytes read, or -1 on error, or 0 on end of file.
**/
gssize
g_input_stream_read (GInputStream *stream,
......@@ -223,7 +223,7 @@ g_input_stream_read (GInputStream *stream,
* is set to indicate the error status, @bytes_read is updated to contain
* the number of bytes read into @buffer before the error occurred.
*
* Return value: %TRUE on success, %FALSE if there was an error
* Returns: %TRUE on success, %FALSE if there was an error
**/
gboolean
g_input_stream_read_all (GInputStream *stream,
......@@ -294,7 +294,7 @@ g_input_stream_read_all (GInputStream *stream,
*
* On error %NULL is returned and @error is set accordingly.
*
* Return value: a new #GBytes, or %NULL on error
* Returns: a new #GBytes, or %NULL on error
**/
GBytes *
g_input_stream_read_bytes (GInputStream *stream,
......@@ -343,7 +343,7 @@ g_input_stream_read_bytes (GInputStream *stream,
* operation was partially finished when the operation was cancelled the
* partial result will be returned, without an error.
*
* Return value: Number of bytes skipped, or -1 on error
* Returns: Number of bytes skipped, or -1 on error
**/
gssize
g_input_stream_skip (GInputStream *stream,
......@@ -468,7 +468,7 @@ g_input_stream_real_skip (GInputStream *stream,
* Cancelling a close will still leave the stream closed, but some streams
* can use a faster close that doesn't block to e.g. check errors.
*
* Return value: %TRUE on success, %FALSE on failure
* Returns: %TRUE on success, %FALSE on failure
**/
gboolean
g_input_stream_close (GInputStream *stream,
......@@ -995,7 +995,7 @@ g_input_stream_has_pending (GInputStream *stream)
* already set or @stream is closed, it will return %FALSE and set
* @error.
*
* Return value: %TRUE if pending was previously unset and is now set.
* Returns: %TRUE if pending was previously unset and is now set.
**/
gboolean
g_input_stream_set_pending (GInputStream *stream, GError **error)
......
......@@ -36,7 +36,7 @@
*
* Gets the GIO Error Quark.
*
* Return value: a #GQuark.
* Returns: a #GQuark.
**/
G_DEFINE_QUARK (g-io-error-quark, g_io_error)
......
......@@ -665,7 +665,7 @@ try_class (GIOExtension *extension,
* The result is cached after it is generated the first time, and
* the function is thread-safe.
*
* Return value: (transfer none): an object implementing
* Returns: (transfer none): an object implementing
* @extension_point, or %NULL if there are no usable
* implementations.
*/
......@@ -788,7 +788,7 @@ try_implementation (GIOExtension *extension,
* The result is cached after it is generated the first time, and
* the function is thread-safe.
*
* Return value: (transfer none): an object implementing
* Returns: (transfer none): an object implementing
* @extension_point, or %NULL if there are no usable
* implementations.
*/
......
......@@ -262,7 +262,7 @@ g_io_stream_has_pending (GIOStream *stream)
* already set or @stream is closed, it will return %FALSE and set
* @error.
*
* Return value: %TRUE if pending was previously unset and is now set.
* Returns: %TRUE if pending was previously unset and is now set.
*
* Since: 2.22
*/
......@@ -370,7 +370,7 @@ g_io_stream_real_close (GIOStream *stream,
* The default implementation of this method just calls close on the
* individual input/output streams.
*
* Return value: %TRUE on success, %FALSE on failure
* Returns: %TRUE on success, %FALSE on failure
*
* Since: 2.22
*/
......
......@@ -379,7 +379,7 @@ g_memory_output_stream_init (GMemoryOutputStream *stream)
* stream3 = g_memory_output_stream_new (data, 200, NULL, free);
* ]|
*
* Return value: A newly created #GMemoryOutputStream object.
* Returns: A newly created #GMemoryOutputStream object.
**/
GOutputStream *
g_memory_output_stream_new (gpointer data,
......
......@@ -268,7 +268,7 @@ g_network_address_parse_sockaddr (GNetworkAddress *addr)
* Creates a new #GSocketConnectable for connecting to the given
* @hostname and @port.
*
* Return value: (transfer full) (type GNetworkAddress): the new #GNetworkAddress
* Returns: (transfer full) (type GNetworkAddress): the new #GNetworkAddress
*
* Since: 2.22
*/
......@@ -310,7 +310,7 @@ g_network_address_new (const gchar *hostname,
* is deprecated, because it depends on the contents of /etc/services,
* which is generally quite sparse on platforms other than Linux.)
*
* Return value: (transfer full): the new #GNetworkAddress, or %NULL on error
* Returns: (transfer full): the new #GNetworkAddress, or %NULL on error
*
* Since: 2.22
*/
......@@ -721,7 +721,7 @@ _g_uri_from_authority (const gchar *protocol,
* g_network_address_parse() allows #GSocketClient to determine
* when to use application-specific proxy protocols.
*
* Return value: (transfer full): the new #GNetworkAddress, or %NULL on error
* Returns: (transfer full): the new #GNetworkAddress, or %NULL on error
*
* Since: 2.26
*/
......@@ -767,7 +767,7 @@ g_network_address_parse_uri (const gchar *uri,
* Gets @addr's hostname. This might be either UTF-8 or ASCII-encoded,
* depending on what @addr was created with.
*
* Return value: @addr's hostname
* Returns: @addr's hostname
*
* Since: 2.22
*/
......@@ -785,7 +785,7 @@ g_network_address_get_hostname (GNetworkAddress *addr)
*
* Gets @addr's port number
*
* Return value: @addr's port (which may be 0)
* Returns: @addr's port (which may be 0)
*
* Since: 2.22
*/
......@@ -803,7 +803,7 @@ g_network_address_get_port (GNetworkAddress *addr)
*
* Gets @addr's scheme
*
* Return value: @addr's scheme (%NULL if not built from URI)
* Returns: @addr's scheme (%NULL if not built from URI)
*
* Since: 2.26
*/
......
......@@ -85,7 +85,7 @@ g_network_monitor_get_default (void)
* IPv6. It does not necessarily imply that the public Internet is
* reachable. See #GNetworkMonitor:network-available for more details.
*
* Return value: whether the network is available
* Returns: whether the network is available
*
* Since: 2.32
*/
......@@ -123,7 +123,7 @@ g_network_monitor_get_network_available (GNetworkMonitor *monitor)
* trying to do multicast DNS on the local network), so if you do not
* want to block, you should use g_network_monitor_can_reach_async().
*
* Return value: %TRUE if @connectable is reachable, %FALSE if not.
* Returns: %TRUE if @connectable is reachable, %FALSE if not.
*
* Since: 2.32
*/
......@@ -208,7 +208,7 @@ g_network_monitor_real_can_reach_finish (GNetworkMonitor *monitor,
* Finishes an async network connectivity test.
* See g_network_monitor_can_reach_async().
*
* Return value: %TRUE if network is reachable, %FALSE if not.
* Returns: %TRUE if network is reachable, %FALSE if not.
*/
gboolean
g_network_monitor_can_reach_finish (GNetworkMonitor *monitor,
......
......@@ -241,7 +241,7 @@ g_network_service_get_property (GObject *object,
* @protocol, and @domain. This will initially be unresolved; use the
* #GSocketConnectable interface to resolve it.
*
* Return value: (transfer full) (type GNetworkService): a new #GNetworkService
* Returns: (transfer full) (type GNetworkService): a new #GNetworkService
*
* Since: 2.22
*/
......@@ -263,7 +263,7 @@ g_network_service_new (const gchar *service,
*
* Gets @srv's service name (eg, "ldap").
*
* Return value: @srv's service name
* Returns: @srv's service name
*
* Since: 2.22
*/
......@@ -281,7 +281,7 @@ g_network_service_get_service (GNetworkService *srv)
*
* Gets @srv's protocol name (eg, "tcp").
*
* Return value: @srv's protocol name
* Returns: @srv's protocol name
*
* Since: 2.22
*/
......@@ -300,7 +300,7 @@ g_network_service_get_protocol (GNetworkService *srv)
* Gets the domain that @srv serves. This might be either UTF-8 or
* ASCII-encoded, depending on what @srv was created with.
*
* Return value: @srv's domain name
* Returns: @srv's domain name
*
* Since: 2.22
*/
......@@ -319,7 +319,7 @@ g_network_service_get_domain (GNetworkService *srv)
* Get's the URI scheme used to resolve proxies. By default, the service name
* is used as scheme.
*
* Return value: @srv's scheme name
* Returns: @srv's scheme name
*
* Since: 2.26
*/
......
......@@ -176,7 +176,7 @@ g_output_stream_init (GOutputStream *stream)
*
* Virtual: write_fn
*
* Return value: Number of bytes written, or -1 on error
* Returns: Number of bytes written, or -1 on error
**/
gssize
g_output_stream_write (GOutputStream *stream,
......@@ -249,7 +249,7 @@ g_output_stream_write (GOutputStream *stream,
* is set to indicate the error status, @bytes_written is updated to contain
* the number of bytes written into the stream before the error occurred.
*
* Return value: %TRUE on success, %FALSE if there was an error
* Returns: %TRUE on success, %FALSE if there was an error
**/
gboolean
g_output_stream_write_all (GOutputStream *stream,
......@@ -314,7 +314,7 @@ g_output_stream_write_all (GOutputStream *stream,
*
* Since: 2.40
*
* Return value: %TRUE on success, %FALSE if there was an error
* Returns: %TRUE on success, %FALSE if there was an error
**/
gboolean
g_output_stream_printf (GOutputStream *stream,
......@@ -360,7 +360,7 @@ g_output_stream_printf (GOutputStream *stream,
*
* Since: 2.40
*
* Return value: %TRUE on success, %FALSE if there was an error
* Returns: %TRUE on success, %FALSE if there was an error
**/
gboolean
g_output_stream_vprintf (GOutputStream *stream,
......@@ -406,7 +406,7 @@ g_output_stream_vprintf (GOutputStream *stream,
* #GBytes instance multiple times potentially can result in duplicated
* data in the output stream.
*
* Return value: Number of bytes written, or -1 on error
* Returns: Number of bytes written, or -1 on error
**/
gssize
g_output_stream_write_bytes (GOutputStream *stream,
......@@ -441,7 +441,7 @@ g_output_stream_write_bytes (GOutputStream *stream,
* triggering the cancellable object from another thread. If the operation
* was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
*
* Return value: %TRUE on success, %FALSE on error
* Returns: %TRUE on success, %FALSE on error
**/
gboolean
g_output_stream_flush (GOutputStream *stream,
......@@ -692,7 +692,7 @@ g_output_stream_internal_close (GOutputStream *stream,
* cancellation (as with any error) there is no guarantee that all written
* data will reach the target.
*
* Return value: %TRUE on success, %FALSE on failure
* Returns: %TRUE on success, %FALSE on failure
**/
gboolean
g_output_stream_close (GOutputStream *stream,
......@@ -1450,7 +1450,7 @@ g_output_stream_has_pending (GOutputStream *stream)
* already set or @stream is closed, it will return %FALSE and set
* @error.
*
* Return value: %TRUE if pending was previously unset and is now set.
* Returns: %TRUE if pending was previously unset and is now set.
**/
gboolean
g_output_stream_set_pending (GOutputStream *stream,
......
......@@ -178,7 +178,7 @@ g_pollable_input_stream_default_read_nonblocking (GPollableInputStream *stream,
* to having been cancelled.
*
* Virtual: read_nonblocking
* Return value: the number of bytes read, or -1 on error (including
* Returns: the number of bytes read, or -1 on error (including
* %G_IO_ERROR_WOULD_BLOCK).
*/
gssize
......
......@@ -179,7 +179,7 @@ g_pollable_output_stream_default_write_nonblocking (GPollableOutputStream *stre
* to having been cancelled.
*
* Virtual: write_nonblocking
* Return value: the number of bytes written, or -1 on error (including
* Returns: the number of bytes written, or -1 on error (including
* %G_IO_ERROR_WOULD_BLOCK).
*/
gssize
......
......@@ -101,7 +101,7 @@ static GSourceFuncs pollable_source_funcs =
* anything on its own; use g_source_add_child_source() to add other
* sources to it to cause it to trigger.
*
* Return value: (transfer full): the new #GSource.
* Returns: (transfer full): the new #GSource.
*
* Since: 2.28
*/
......@@ -134,7 +134,7 @@ g_pollable_source_new (GObject *pollable_stream)
* g_pollable_source_new(), but also attaching @child_source (with a
* dummy callback), and @cancellable, if they are non-%NULL.
*
* Return value: (transfer full): the new #GSource.
* Returns: (transfer full): the new #GSource.
*
* Since: 2.34
*/
......@@ -289,7 +289,7 @@ g_pollable_stream_write (GOutputStream *stream,
* behavior is undefined. If @blocking is %TRUE, then @stream does not
* need to be a #GPollableOutputStream.
*
* Return value: %TRUE on success, %FALSE if there was an error
* Returns: %TRUE on success, %FALSE if there was an error
*
* Since: 2.34
*/
......
......@@ -55,7 +55,7 @@ g_proxy_default_init (GProxyInterface *iface)
* Lookup "gio-proxy" extension point for a proxy implementation that supports
* specified protocol.
*
* Return value: (transfer full): return a #GProxy or NULL if protocol
* Returns: (transfer full): return a #GProxy or NULL if protocol
* is not supported.
*
* Since: 2.26
......@@ -92,7 +92,7 @@ g_proxy_get_default_for_protocol (const gchar *protocol)
* does the necessary handshake to connect to @proxy_address, and if
* required, wraps the #GIOStream to handle proxy payload.
*
* Return value: (transfer full): a #GIOStream that will replace @connection. This might
* Returns: (transfer full): a #GIOStream that will replace @connection. This might
* be the same as @connection, in which case a reference
* will be added.
*
......@@ -161,7 +161,7 @@ g_proxy_connect_async (GProxy *proxy,
*
* See g_proxy_connect().
*
* Return value: (transfer full): a #GIOStream.
* Returns: (transfer full): a #GIOStream.
*
* Since: 2.26
*/
......@@ -191,7 +191,7 @@ g_proxy_connect_finish (GProxy *proxy,
* #GProxyAddress containing the stringified IP address to
* g_proxy_connect() or g_proxy_connect_async().
*
* Return value: %TRUE if hostname resolution is supported.
* Returns: %TRUE if hostname resolution is supported.
*
* Since: 2.26
*/
......
......@@ -53,7 +53,7 @@ g_proxy_resolver_default_init (GProxyResolverInterface *iface)
*
* Gets the default #GProxyResolver for the system.
*
* Return value: (transfer none): the default #GProxyResolver.
* Returns: (transfer none): the default #GProxyResolver.
*
* Since: 2.26
*/
......@@ -73,7 +73,7 @@ g_proxy_resolver_get_default (void)
* internally; g_proxy_resolver_get_default() will only return a proxy
* resolver that returns %TRUE for this method.)
*
* Return value: %TRUE if @resolver is supported.
* Returns: %TRUE if @resolver is supported.
*
* Since: 2.26
*/
......@@ -112,7 +112,7 @@ g_proxy_resolver_is_supported (GProxyResolver *resolver)
* Direct connection should not be attempted unless it is part of the
* returned array of proxies.
*
* Return value: (transfer full) (array zero-terminated=1): A
* Returns: (transfer full) (array zero-terminated=1): A
* NULL-terminated array of proxy URIs. Must be freed
* with g_strfreev().
*
......@@ -174,7 +174,7 @@ g_proxy_resolver_lookup_async (GProxyResolver *resolver,
* g_proxy_resolver_lookup_async() is complete. See
* g_proxy_resolver_lookup() for more details.
*
* Return value: (transfer full) (array zero-terminated=1): A
* Returns: (transfer full) (array zero-terminated=1): A
* NULL-terminated array of proxy URIs. Must be freed
* with g_strfreev().
*
......
......@@ -192,7 +192,7 @@ static GResolver *default_resolver;
* with it. #GResolver may use its reference count as a hint about how
* many threads it should allocate for concurrent DNS resolutions.
*
* Return value: (transfer full): the default #GResolver.
* Returns: (transfer full): the default #GResolver.
*
* Since: 2.22
*/
......@@ -355,7 +355,7 @@ handle_ip_address (const char *hostname,
* address, it may be easier to create a #GNetworkAddress and use its
* #GSocketConnectable interface.
*
* Return value: (element-type GInetAddress) (transfer full): a #GList
* Returns: (element-type GInetAddress) (transfer full): a #GList
* of #GInetAddress, or %NULL on error. You
* must unref each of the addresses and free the list when you are
* done with it. (You can use g_resolver_free_addresses() to do this.)
......@@ -458,7 +458,7 @@ g_resolver_lookup_by_name_async (GResolver *resolver,
* a value from #GResolverError. If the operation was cancelled,
* @error will be set to %G_IO_ERROR_CANCELLED.
*
* Return value: (element-type GInetAddress) (transfer full): a #GList
* Returns: (element-type GInetAddress) (transfer full): a #GList
* of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
* for more details.
*
......@@ -527,7 +527,7 @@ g_resolver_free_addresses (GList *addresses)
* operation, in which case @error (if non-%NULL) will be set to
* %G_IO_ERROR_CANCELLED.
*
* Return value: a hostname (either ASCII-only, or in ASCII-encoded
* Returns: a hostname (either ASCII-only, or in ASCII-encoded
* form), or %NULL on error.
*
* Since: 2.22
......@@ -588,7 +588,7 @@ g_resolver_lookup_by_address_async (GResolver *resolver,
* a value from #GResolverError. If the operation was cancelled,
* @error will be set to %G_IO_ERROR_CANCELLED.
*
* Return value: a hostname (either ASCII-only, or in ASCII-encoded
* Returns: a hostname (either ASCII-only, or in ASCII-encoded
* form), or %NULL on error.
*
* Since: 2.22
......@@ -654,7 +654,7 @@ g_resolver_get_service_rrname (const char *service,
* to create a #GNetworkService and use its #GSocketConnectable
* interface.
*
* Return value: (element-type GSrvTarget) (transfer full): a #GList of #GSrvTarget,
* Returns: (element-type GSrvTarget) (transfer full): a #GList of #GSrvTarget,
* or %NULL on error. You must free each of the targets and the list when you are
* done with it. (You can use g_resolver_free_targets() to do this.)
*
......@@ -742,7 +742,7 @@ g_resolver_lookup_service_async (GResolver *resolver,
* a value from #GResolverError. If the operation was cancelled,
* @error will be set to %G_IO_ERROR_CANCELLED.
*
* Return value: (element-type GSrvTarget) (transfer full): a #GList of #GSrvTarget,
* Returns: (element-type GSrvTarget) (transfer full): a #GList of #GSrvTarget,
* or %NULL on error. See g_resolver_lookup_service() for more details.
*
* Since: 2.22
......@@ -801,7 +801,7 @@ g_resolver_free_targets (GList *targets)
* operation, in which case @error (if non-%NULL) will be set to
* %G_IO_ERROR_CANCELLED.
*
* Return value: (element-type GVariant) (transfer full): a #GList of #GVariant,
* Returns: (element-type GVariant) (transfer full): a #GList of #GVariant,
* or %NULL on error. You must free each of the records and the list when you are
* done with it. (You can use g_list_free_full() with g_variant_unref() to do this.)
*
......@@ -872,7 +872,7 @@ g_resolver_lookup_records_async (GResolver *resolver,
* a value from #GResolverError. If the operation was cancelled,
* @error will be set to %G_IO_ERROR_CANCELLED.
*
* Return value: (element-type GVariant) (transfer full): a #GList of #GVariant,
* Returns: (element-type GVariant) (transfer full): a #GList of #GVariant,
* or %NULL on error. You must free each of the records and the list when you are
* done with it. (You can use g_list_free_full() with g_variant_unref() to do this.)
*
......@@ -907,7 +907,7 @@ g_resolver_get_serial (GResolver *resolver)
*
* Gets the #GResolver Error Quark.
*
* Return value: a #GQuark.
* Returns: a #GQuark.
*
* Since: 2.22
*/
......
......@@ -134,7 +134,7 @@ G_DEFINE_BOXED_TYPE (GResource, g_resource, g_resource_ref, g_resource_unref)
*
* Gets the #GResource Error Quark.
*
* Return value: a #GQuark
* Returns: a #GQuark
*
* Since: 2.32
*/
......@@ -209,7 +209,7 @@ g_resource_new_from_table (GvdbTable *table)
* If you want to use this resource in the global resource namespace you need
* to register it with g_resources_register().
*
* Return value: (transfer full): a new #GResource, or %NULL on error
* Returns: (transfer full): a new #GResource, or %NULL on error
*
* Since: 2.32
**/
......@@ -244,7 +244,7 @@ g_resource_new_from_data (GBytes *data,
* If you want to use this resource in the global resource namespace you need
* to register it with g_resources_register().
*
* Return value: (transfer full): a new #GResource, or %NULL on error
* Returns: (transfer full): a new #GResource, or %NULL on error
*
* Since: 2.32
**/
......@@ -1015,7 +1015,7 @@ g_static_resource_fini (GStaticResource *static_resource)
* [glib-compile-resources][glib-compile-resources]
* and is not typically used by other code.
*
* Return value: (transfer none): a #GResource
* Returns: (transfer none): a #GResource
*
* Since: 2.32
**/
......
......@@ -65,7 +65,7 @@ g_socket_address_enumerator_class_init (GSocketAddressEnumeratorClass *enumerato
* internal errors (other than @cancellable being triggered) will be
* ignored.
*
* Return value: (transfer full): a #GSocketAddress (owned by the caller), or %NULL on
* Returns: (transfer full): a #GSocketAddress (owned by the caller), or %NULL on
* error (in which case *@error will be set) or if there are no
* more addresses.
*/
......@@ -156,7 +156,7 @@ g_socket_address_enumerator_real_next_finish (GSocketAddressEnumerator *enumera
* g_socket_address_enumerator_next() for more information about
* error handling.
*
* Return value: (transfer full): a #GSocketAddress (owned by the caller), or %NULL on
* Returns: (transfer full): a #GSocketAddress (owned by the caller), or %NULL on
* error (in which case *@error will be set) or if there are no
* more addresses.
*/
......