luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-12-24 14:36:13 +01:00
Code Issues Packages Projects Releases Wiki Activity

Add a lot of missing annotations

Browse Source
This commit is contained in:
Johan Dahlin 2010-09-24 18:24:41 -03:00 committed by Johan Dahlin
parent 701ce5d201
commit 30132c44c1
61 changed files with 172 additions and 161 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
gio/gaction.h
View File

@ -66,7 +66,7 @@ struct _GActionInterface
gboolean (* get_enabled) (GAction *action);
GVariant * (* get_state) (GAction *action);
void (* set_state) (GAction *action,
GVariant *state);
GVariant *value);
void (* activate) (GAction *action,
GVariant *parameter);

3
gio/gappinfo.c
View File

@ -681,7 +681,8 @@ g_app_info_can_delete (GAppInfo *appinfo)
* On some platforms, there may be a difference between user-defined
* #GAppInfo<!-- -->s which can be deleted, and system-wide ones which
* cannot. See g_app_info_can_delete().
*
*
* Virtual: do_delete
* Returns: %TRUE if @appinfo has been deleted
*
* Since: 2.20

4
gio/gasyncresult.c
View File

@ -122,7 +122,7 @@ g_async_result_default_init (GAsyncResultInterface *iface)
*
* Gets the user data from a #GAsyncResult.
*
* Returns: the user data for @res.
* Returns: (transfer full): the user data for @res.
**/
gpointer
g_async_result_get_user_data (GAsyncResult *res)
@ -142,7 +142,7 @@ g_async_result_get_user_data (GAsyncResult *res)
*
* Gets the source object from a #GAsyncResult.
*
* Returns: a new reference to the source object for the @res,
* Returns: (transfer full): a new reference to the source object for the @res,
* or %NULL if there is none.
*/
GObject *

2
gio/gcancellable.c
View File

@ -333,7 +333,7 @@ g_cancellable_pop_current (GCancellable *cancellable)
*
* Gets the top cancellable from the stack.
*
* Returns: a #GCancellable from the top of the stack, or %NULL
* Returns: (transfer none): a #GCancellable from the top of the stack, or %NULL
* if the stack is empty.
**/
GCancellable *

4
gio/gcontenttype.c
View File

@ -743,7 +743,7 @@ g_content_type_get_mime_type (const char *type)
*
* Gets the icon for a content type.
*
* Returns: #GIcon corresponding to the content type. Free the returned
* Returns: (transfer full): #GIcon corresponding to the content type. Free the returned
* object with g_object_unref()
*/
GIcon *
@ -1651,7 +1651,7 @@ match_match (TreeMatch *match,
* This function is useful in the implementation of
* g_mount_guess_content_type().
*
* Returns: an %NULL-terminated array of zero or more content types,
* Returns: (transfer full): an %NULL-terminated array of zero or more content types,
* or %NULL. Free with g_strfreev()
*
* Since: 2.18

2
gio/gconverterinputstream.c
View File

@ -542,7 +542,7 @@ g_converter_input_stream_read (GInputStream *stream,
*
* Gets the #GConverter that is used by @converter_stream.
*
* Returns: the converter of the converter input stream
* Returns: (transfer none): the converter of the converter input stream
*
* Since: 2.24
*/

2
gio/gconverteroutputstream.c
View File

@ -602,7 +602,7 @@ g_converter_output_stream_flush (GOutputStream *stream,
*
* Gets the #GConverter that is used by @converter_stream.
*
* Returns: the converter of the converter output stream
* Returns: (transfer none): the converter of the converter output stream
*
* Since: 2.24
*/

2
gio/gcredentials.c
View File

@ -250,7 +250,7 @@ g_credentials_is_same_user (GCredentials *credentials,
}
/**
* g_credentials_get_native:
* g_credentials_get_native: (skip)
* @credentials: A #GCredentials.
* @native_type: The type of native credentials to get.
*

4
gio/gdbusaddress.c
View File

@ -867,7 +867,7 @@ g_dbus_address_get_stream (const gchar *address,
*
* Finishes an operation started with g_dbus_address_get_stream().
*
* Returns: A #GIOStream or %NULL if @error is set.
* Returns: (transfer full): A #GIOStream or %NULL if @error is set.
*
* Since: 2.26
*/
@ -913,7 +913,7 @@ g_dbus_address_get_stream_finish (GAsyncResult *res,
* This is a synchronous failable function. See
* g_dbus_address_get_stream() for the asynchronous version.
*
* Returns: A #GIOStream or %NULL if @error is set.
* Returns: (transfer full): A #GIOStream or %NULL if @error is set.
*
* Since: 2.26
*/

12
gio/gdbusconnection.c
View File

@ -950,7 +950,7 @@ g_dbus_connection_init (GDBusConnection *connection)
*
* Gets the underlying stream used for IO.
*
* Returns: the stream used for IO
* Returns: (transfer none): the stream used for IO
*
* Since: 2.26
*/
@ -1878,7 +1878,7 @@ g_dbus_connection_send_message_with_reply (GDBusConnection *connection,
* linkend="gdbus-unix-fd-client"/> for an example of how to use this
* low-level API to send and receive UNIX file descriptors.
*
* Returns: A locked #GDBusMessage or %NULL if @error is set.
* Returns: (transfer full): A locked #GDBusMessage or %NULL if @error is set.
*
* Since: 2.26
*/
@ -1974,7 +1974,7 @@ send_message_with_reply_sync_cb (GDBusConnection *connection,
* Note that @message must be unlocked, unless @flags contain the
* %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
*
* Returns: A locked #GDBusMessage that is the reply to @message or %NULL if @error is set.
* Returns: (transfer full): A locked #GDBusMessage that is the reply to @message or %NULL if @error is set.
*
* Since: 2.26
*/
@ -2802,7 +2802,7 @@ g_dbus_connection_get_unique_name (GDBusConnection *connection)
* each application is a client. So this method will always return
* %NULL for message bus clients.
*
* Returns: A #GCredentials or %NULL if not available. Do not free
* Returns: (transfer none): A #GCredentials or %NULL if not available. Do not free
* this object, it is owned by @connection.
*
* Since: 2.26
@ -6236,7 +6236,7 @@ get_uninitialized_connection (GBusType bus_type,
* Note that the returned #GDBusConnection object will (usually) have
* the #GDBusConnection:exit-on-close property set to %TRUE.
*
* Returns: A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
* Returns: (transfer full): A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
*
* Since: 2.26
*/
@ -6359,7 +6359,7 @@ g_bus_get (GBusType bus_type,
* Note that the returned #GDBusConnection object will (usually) have
* the #GDBusConnection:exit-on-close property set to %TRUE.
*
* Returns: A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
* Returns: (transfer full): A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
*
* Since: 2.26
*/

12
gio/gdbusmessage.c
View File

@ -294,7 +294,7 @@ g_dbus_message_new_signal (const gchar *path,
*
* Creates a new #GDBusMessage that is a reply to @method_call_message.
*
* Returns: A #GDBusMessage. Free with g_object_unref().
* Returns: (transfer full): #GDBusMessage. Free with g_object_unref().
*
* Since: 2.26
*/
@ -332,7 +332,7 @@ g_dbus_message_new_method_reply (GDBusMessage *method_call_message)
*
* Creates a new #GDBusMessage that is an error reply to @method_call_message.
*
* Returns: A #GDBusMessage. Free with g_object_unref().
* Returns: (transfer full): A #GDBusMessage. Free with g_object_unref().
*
* Since: 2.26
*/
@ -364,7 +364,7 @@ g_dbus_message_new_method_error (GDBusMessage *method_call_message,
*
* Creates a new #GDBusMessage that is an error reply to @method_call_message.
*
* Returns: A #GDBusMessage. Free with g_object_unref().
* Returns: (transfer full): A #GDBusMessage. Free with g_object_unref().
*
* Since: 2.26
*/
@ -409,7 +409,7 @@ g_dbus_message_new_method_error_literal (GDBusMessage *method_call_message,
*
* Like g_dbus_message_new_method_error() but intended for language bindings.
*
* Returns: A #GDBusMessage. Free with g_object_unref().
* Returns: (transfer full): A #GDBusMessage. Free with g_object_unref().
*
* Since: 2.26
*/
@ -780,7 +780,7 @@ g_dbus_message_set_body (GDBusMessage *message,
*
* This method is only available on UNIX.
*
* Returns: A #GUnixFDList or %NULL if no file descriptors are
* Returns: (transfer none):A #GUnixFDList or %NULL if no file descriptors are
* associated. Do not free, this object is owned by @message.
*
* Since: 2.26
@ -3195,7 +3195,7 @@ g_dbus_message_lock (GDBusMessage *message)
* This operation can fail if e.g. @message contains file descriptors
* and the per-process or system-wide open files limit is reached.
*
* Returns: A new #GDBusMessage or %NULL if @error is set. Free with
* Returns: (transfer full): A new #GDBusMessage or %NULL if @error is set. Free with
* g_object_unref().
*
* Since: 2.26

6
gio/gdbusmethodinvocation.c
View File

@ -210,7 +210,7 @@ g_dbus_method_invocation_get_method_name (GDBusMethodInvocation *invocation)
*
* Gets the #GDBusConnection the method was invoked on.
*
* Returns: A #GDBusConnection. Do not free, it is owned by @invocation.
* Returns: (transfer none):A #GDBusConnection. Do not free, it is owned by @invocation.
*
* Since: 2.26
*/
@ -234,7 +234,7 @@ g_dbus_method_invocation_get_connection (GDBusMethodInvocation *invocation)
* linkend="gdbus-unix-fd-client"/> for an example of how to use this
* low-level API to send and receive UNIX file descriptors.
*
* Returns: A #GDBusMessage. Do not free, it is owned by @invocation.
* Returns: (transfer none): #GDBusMessage. Do not free, it is owned by @invocation.
*
* Since: 2.26
*/
@ -263,7 +263,7 @@ g_dbus_method_invocation_get_parameters (GDBusMethodInvocation *invocation)
}
/**
* g_dbus_method_invocation_get_user_data:
* g_dbus_method_invocation_get_user_data: (skip)
* @invocation: A #GDBusMethodInvocation.
*
* Gets the @user_data #gpointer passed to g_dbus_connection_register_object().

2
gio/gdbusproxy.c
View File

@ -1905,7 +1905,7 @@ g_dbus_proxy_new_for_bus_sync (GBusType bus_type,
*
* Gets the connection @proxy is for.
*
* Returns: A #GDBusConnection owned by @proxy. Do not free.
* Returns: (transfer none): A #GDBusConnection owned by @proxy. Do not free.
*
* Since: 2.26
*/

2
gio/gdesktopappinfo.c
View File

@ -2701,7 +2701,7 @@ g_desktop_app_info_lookup_default_init (GDesktopAppInfoLookupInterface *iface)
* in a GIO module. There is no reason for applications to use it
* directly. Applications should use g_app_info_get_default_for_uri_scheme().
*
* Returns: #GAppInfo for given @uri_scheme or %NULL on error.
* Returns: (transfer full): #GAppInfo for given @uri_scheme or %NULL on error.
*/
GAppInfo *
g_desktop_app_info_lookup_get_default_for_uri_scheme (GDesktopAppInfoLookup *lookup,

4
gio/gdrive.c
View File

@ -159,7 +159,7 @@ g_drive_get_name (GDrive *drive)
*
* Gets the icon for @drive.
*
* Returns: #GIcon for the @drive.
* Returns: (transfer full): #GIcon for the @drive.
* Free the returned object with g_object_unref().
**/
GIcon *
@ -594,7 +594,7 @@ g_drive_get_identifier (GDrive *drive,
* Use g_drive_get_identifer() to obtain the identifiers
* themselves.
*
* Returns: a %NULL-terminated array of strings containing
* Returns: (transfer full): a %NULL-terminated array of strings containing
* kinds of identifiers. Use g_strfreev() to free.
*/
char **

2
gio/gemblem.c
View File

@ -220,7 +220,7 @@ g_emblem_new_with_origin (GIcon *icon,
*
* Gives back the icon from @emblem.
*
* Returns: a #GIcon. The returned object belongs to the emblem
* Returns: (transfer full): a #GIcon. The returned object belongs to the emblem
* and should not be modified or freed.
*
* Since: 2.18

4
gio/gemblemedicon.c
View File

@ -99,7 +99,7 @@ g_emblemed_icon_init (GEmblemedIcon *emblemed)
*
* Creates a new emblemed icon for @icon with the emblem @emblem.
*
* Returns: a new #GIcon
* Returns: (transfer full): a new #GIcon
*
* Since: 2.18
**/
@ -128,7 +128,7 @@ g_emblemed_icon_new (GIcon *icon,
*
* Gets the main icon for @emblemed.
*
* Returns: a #GIcon that is owned by @emblemed
* Returns: (transfer full): a #GIcon that is owned by @emblemed
*
* Since: 2.18
**/

67
gio/gfile.c
View File

@ -542,7 +542,8 @@ g_file_dup (GFile *file)
* Creates a hash value for a #GFile.
*
* This call does no blocking i/o.
*
*
* Virtual: hash
* Returns: 0 if @file is not a valid #GFile, otherwise an
* integer that can be used as hash value for the #GFile.
* This function is intended for easily hashing a #GFile to
@ -603,7 +604,7 @@ g_file_equal (GFile *file1,
*
* This call does no blocking i/o.
*
* Returns: a #GFile structure to the parent of the given
* Returns: (transfer full): a #GFile structure to the parent of the given
* #GFile or %NULL if there is no parent.
* Free the returned object with g_object_unref().
**/
@ -736,6 +737,7 @@ g_file_get_child_for_display_name (GFile *file,
* filesystem point of view), because the prefix of @file is an alias
* of @prefix.
*
* Virtual: prefix_matches
* Returns: %TRUE if the @files's parent, grandparent, etc is @prefix.
* %FALSE otherwise.
**/
@ -797,7 +799,7 @@ g_file_get_relative_path (GFile *parent,
*
* This call does no blocking i/o.
*
* Returns: #GFile to the resolved path. %NULL if @relative_path
* Returns: (transfer full): #GFile to the resolved path. %NULL if @relative_path
* is %NULL or if @file is invalid.
* Free the returned object with g_object_unref().
**/
@ -1074,7 +1076,7 @@ g_file_query_file_type (GFile *file,
* If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
* Other errors are possible too, and depend on what kind of filesystem the file is on.
*
* Returns: a #GFileInfo for the given @file, or %NULL on error.
* Returns: (transfer full): a #GFileInfo for the given @file, or %NULL on error.
* Free the returned object with g_object_unref().
**/
GFileInfo *
@ -1157,7 +1159,7 @@ g_file_query_info_async (GFile *file,
* Finishes an asynchronous file info query.
* See g_file_query_info_async().
*
* Returns: #GFileInfo for given @file or %NULL on error.
* Returns: (transfer full): #GFileInfo for given @file or %NULL on error.
* Free the returned object with g_object_unref().
**/
GFileInfo *
@ -1210,7 +1212,7 @@ g_file_query_info_finish (GFile *file,
* If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
* Other errors are possible too, and depend on what kind of filesystem the file is on.
*
* Returns: a #GFileInfo or %NULL if there was an error.
* Returns: (transfer full): a #GFileInfo or %NULL if there was an error.
* Free the returned object with g_object_unref().
**/
GFileInfo *
@ -1291,7 +1293,7 @@ g_file_query_filesystem_info_async (GFile *file,
* Finishes an asynchronous filesystem info query. See
* g_file_query_filesystem_info_async().
*
* Returns: #GFileInfo for given @file or %NULL on error.
* Returns: (transfer full): #GFileInfo for given @file or %NULL on error.
* Free the returned object with g_object_unref().
**/
GFileInfo *
@ -1331,7 +1333,7 @@ g_file_query_filesystem_info_finish (GFile *file,
* triggering the cancellable object from another thread. If the operation
* was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
*
* Returns: a #GMount where the @file is located or %NULL on error.
* Returns: (transfer full): a #GMount where the @file is located or %NULL on error.
* Free the returned object with g_object_unref().
**/
GMount *
@ -1405,7 +1407,7 @@ g_file_find_enclosing_mount_async (GFile *file,
* Finishes an asynchronous find mount request.
* See g_file_find_enclosing_mount_async().
*
* Returns: #GMount for given @file or %NULL on error.
* Returns: (transfer full): #GMount for given @file or %NULL on error.
* Free the returned object with g_object_unref().
**/
GMount *
@ -1447,7 +1449,8 @@ g_file_find_enclosing_mount_finish (GFile *file,
* If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned.
* Other errors are possible too, and depend on what kind of filesystem the file is on.
*
* Returns: #GFileInputStream or %NULL on error.
* Virtual: read_fn
* Returns: (transfer full): #GFileInputStream or %NULL on error.
* Free the returned object with g_object_unref().
**/
GFileInputStream *
@ -1500,7 +1503,7 @@ g_file_read (GFile *file,
* returned. Other errors are possible too, and depend on what kind of
* filesystem the file is on.
*
* Returns: a #GFileOutputStream, or %NULL on error.
* Returns: (transfer full): a #GFileOutputStream, or %NULL on error.
* Free the returned object with g_object_unref().
**/
GFileOutputStream *
@ -1556,7 +1559,7 @@ g_file_append_to (GFile *file,
* Other errors are possible too, and depend on what kind of
* filesystem the file is on.
*
* Returns: a #GFileOutputStream for the newly created file, or
* Returns: (transfer full): a #GFileOutputStream for the newly created file, or
* %NULL on error.
* Free the returned object with g_object_unref().
**/
@ -1638,7 +1641,7 @@ g_file_create (GFile *file,
* Other errors are possible too, and depend on what kind of
* filesystem the file is on.
*
* Returns: a #GFileOutputStream or %NULL on error.
* Returns: (transfer full): a #GFileOutputStream or %NULL on error.
* Free the returned object with g_object_unref().
**/
GFileOutputStream *
@ -1694,7 +1697,7 @@ g_file_replace (GFile *file,
* so make sure you really need to do read and write streaming, rather than
* just opening for reading or writing.
*
* Returns: #GFileIOStream or %NULL on error.
* Returns: (transfer full): #GFileIOStream or %NULL on error.
* Free the returned object with g_object_unref().
*
* Since: 2.22
@ -1753,7 +1756,7 @@ g_file_open_readwrite (GFile *file,
* supported, so make sure you really need to do read and write streaming,
* rather than just opening for reading or writing.
*
* Returns: a #GFileIOStream for the newly created file, or %NULL on error.
* Returns: (transfer full): a #GFileIOStream for the newly created file, or %NULL on error.
* Free the returned object with g_object_unref().
*
* Since: 2.22
@ -1805,7 +1808,7 @@ g_file_create_readwrite (GFile *file,
* supported, so make sure you really need to do read and write streaming,
* rather than just opening for reading or writing.
*
* Returns: a #GFileIOStream or %NULL on error.
* Returns: (transfer full): a #GFileIOStream or %NULL on error.
* Free the returned object with g_object_unref().
*
* Since: 2.22
@ -1883,7 +1886,7 @@ g_file_read_async (GFile *file,
* Finishes an asynchronous file read operation started with
* g_file_read_async().
*
* Returns: a #GFileInputStream or %NULL on error.
* Returns: (transfer full): a #GFileInputStream or %NULL on error.
* Free the returned object with g_object_unref().
**/
GFileInputStream *
@ -1955,7 +1958,7 @@ g_file_append_to_async (GFile *file,
* Finishes an asynchronous file append operation started with
* g_file_append_to_async().
*
* Returns: a valid #GFileOutputStream or %NULL on error.
* Returns: (transfer full): a valid #GFileOutputStream or %NULL on error.
* Free the returned object with g_object_unref().
**/
GFileOutputStream *
@ -2028,7 +2031,7 @@ g_file_create_async (GFile *file,
* Finishes an asynchronous file create operation started with
* g_file_create_async().
*
* Returns: a #GFileOutputStream or %NULL on error.
* Returns: (transfer full): a #GFileOutputStream or %NULL on error.
* Free the returned object with g_object_unref().
**/
GFileOutputStream *
@ -2108,7 +2111,7 @@ g_file_replace_async (GFile *file,
* Finishes an asynchronous file replace operation started with
* g_file_replace_async().
*
* Returns: a #GFileOutputStream, or %NULL on error.
* Returns: (transfer full): a #GFileOutputStream, or %NULL on error.
* Free the returned object with g_object_unref().
**/
GFileOutputStream *
@ -2180,7 +2183,7 @@ g_file_open_readwrite_async (GFile *file,
* Finishes an asynchronous file read operation started with
* g_file_open_readwrite_async().
*
* Returns: a #GFileIOStream or %NULL on error.
* Returns: (transfer full): a #GFileIOStream or %NULL on error.
* Free the returned object with g_object_unref().
*
* Since: 2.22
@ -2258,7 +2261,7 @@ g_file_create_readwrite_async (GFile *file,
* Finishes an asynchronous file create operation started with
* g_file_create_readwrite_async().
*
* Returns: a #GFileIOStream or %NULL on error.
* Returns: (transfer full): a #GFileIOStream or %NULL on error.
* Free the returned object with g_object_unref().
*
* Since: 2.22
@ -2342,7 +2345,7 @@ g_file_replace_readwrite_async (GFile *file,
* Finishes an asynchronous file replace operation started with
* g_file_replace_readwrite_async().
*
* Returns: a #GFileIOStream, or %NULL on error.
* Returns: (transfer full): a #GFileIOStream, or %NULL on error.
* Free the returned object with g_object_unref().
*
* Since: 2.22
@ -3506,7 +3509,8 @@ g_file_make_symbolic_link (GFile *file,
* If @cancellable is not %NULL, then the operation can be cancelled by
* triggering the cancellable object from another thread. If the operation
* was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
*
*
* Virtual: delete_file
* Returns: %TRUE if the file was deleted. %FALSE otherwise.
**/
gboolean
@ -3599,7 +3603,7 @@ g_file_trash (GFile *file,
* triggering the cancellable object from another thread. If the operation
* was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
*
* Returns: a #GFile specifying what @file was renamed to, or %NULL
* Returns: (transfer full): a #GFile specifying what @file was renamed to, or %NULL
* if there was an error.
* Free the returned object with g_object_unref().
**/
@ -3680,7 +3684,7 @@ g_file_set_display_name_async (GFile *file,
* Finishes setting a display name started with
* g_file_set_display_name_async().
*
* Returns: a #GFile or %NULL on error.
* Returns: (transfer full): a #GFile or %NULL on error.
* Free the returned object with g_object_unref().
**/
GFile *
@ -4279,7 +4283,7 @@ g_file_mount_mountable (GFile *file,
* Finish an asynchronous mount operation that was started
* with g_file_mount_mountable().
*
* Returns: a #GFile or %NULL on error.
* Returns: (transfer full): a #GFile or %NULL on error.
* Free the returned object with g_object_unref().
**/
GFile *
@ -4686,8 +4690,9 @@ g_file_eject_mountable_with_operation_finish (GFile *file,
* If @cancellable is not %NULL, then the operation can be cancelled by
* triggering the cancellable object from another thread. If the operation
* was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
*
* Returns: a #GFileMonitor for the given @file, or %NULL on error.
*
* Virtual: monitor_dir
* Returns: (transfer full): a #GFileMonitor for the given @file, or %NULL on error.
* Free the returned object with g_object_unref().
**/
GFileMonitor*
@ -4775,7 +4780,7 @@ g_file_monitor_file (GFile *file,
* triggering the cancellable object from another thread. If the operation
* was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
*
* Returns: a #GFileMonitor for the given @file, or %NULL on error.
* Returns: (transfer full): a #GFileMonitor for the given @file, or %NULL on error.
* Free the returned object with g_object_unref().
*
* Since: 2.18
@ -6097,7 +6102,7 @@ g_file_mount_enclosing_volume_finish (GFile *location,
* triggering the cancellable object from another thread. If the operation
* was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
*
* Returns: a #GAppInfo if the handle was found, %NULL if there were errors.
* Returns: (transfer full): a #GAppInfo if the handle was found, %NULL if there were errors.
* When you are done with it, release it with g_object_unref()
**/
GAppInfo *

2
gio/gfileenumerator.c
View File

@ -390,7 +390,7 @@ g_file_enumerator_next_files_async (GFileEnumerator *enumerator,
*
* Finishes the asynchronous operation started with g_file_enumerator_next_files_async().
*
* Returns: (transfer full) (element-type FileInfo): a #GList of #GFileInfo<!---->s. You must free the list with
* Returns: (transfer full) (element-type Gio.FileInfo): a #GList of #GFileInfo<!---->s. You must free the list with
* g_list_free() and unref the infos with g_object_unref() when you're
* done with them.
**/

4
gio/gfileicon.c
View File

@ -158,7 +158,7 @@ g_file_icon_init (GFileIcon *file)
*
* Creates a new icon for a file.
*
* Returns: a #GIcon for the given @file, or %NULL on error.
* Returns: (transfer full): a #GIcon for the given @file, or %NULL on error.
**/
GIcon *
g_file_icon_new (GFile *file)
@ -174,7 +174,7 @@ g_file_icon_new (GFile *file)
*
* Gets the #GFile associated with the given @icon.
*
* Returns: a #GFile, or %NULL.
* Returns: (transfer none): a #GFile, or %NULL.
**/
GFile *
g_file_icon_get_file (GFileIcon *icon)

4
gio/gfileinfo.c
View File

@ -407,7 +407,7 @@ g_file_info_copy_into (GFileInfo *src_info,
*
* Duplicates a file info structure.
*
* Returns: a duplicate #GFileInfo of @other.
* Returns: (transfer full): a duplicate #GFileInfo of @other.
**/
GFileInfo *
g_file_info_dup (GFileInfo *other)
@ -921,7 +921,7 @@ g_file_info_get_attribute_byte_string (GFileInfo *info,
* Gets the value of a stringv attribute. If the attribute does
* not contain a stringv, %NULL will be returned.
*
* Returns: the contents of the @attribute value as a stringv, or
* Returns: (transfer none): the contents of the @attribute value as a stringv, or
* %NULL otherwise. Do not free.
*
* Since: 2.22

4
gio/gfileinputstream.c
View File

@ -122,7 +122,7 @@ g_file_input_stream_init (GFileInputStream *stream)
* stream is blocked, the stream will set the pending flag internally, and
* any other operations on the stream will fail with %G_IO_ERROR_PENDING.
*
* Returns: a #GFileInfo, or %NULL on error.
* Returns: (transfer full): a #GFileInfo, or %NULL on error.
**/
GFileInfo *
g_file_input_stream_query_info (GFileInputStream *stream,
@ -240,7 +240,7 @@ g_file_input_stream_query_info_async (GFileInputStream *stream,
*
* Finishes an asynchronous info query operation.
*
* Returns: #GFileInfo.
* Returns: (transfer full): #GFileInfo.
**/
GFileInfo *
g_file_input_stream_query_info_finish (GFileInputStream *stream,

4
gio/gfileiostream.c
View File

@ -136,7 +136,7 @@ g_file_io_stream_init (GFileIOStream *stream)
* was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
* be returned.
*
* Returns: a #GFileInfo for the @stream, or %NULL on error.
* Returns: (transfer full): a #GFileInfo for the @stream, or %NULL on error.
*
* Since: 2.22
**/
@ -252,7 +252,7 @@ g_file_io_stream_query_info_async (GFileIOStream *stream,
* Finalizes the asynchronous query started
* by g_file_io_stream_query_info_async().
*
* Returns: A #GFileInfo for the finished query.
* Returns: (transfer full): A #GFileInfo for the finished query.
*
* Since: 2.22
**/

4
gio/gfileoutputstream.c
View File

@ -137,7 +137,7 @@ g_file_output_stream_init (GFileOutputStream *stream)
* was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
* be returned.
*
* Returns: a #GFileInfo for the @stream, or %NULL on error.
* Returns: (transfer full): a #GFileInfo for the @stream, or %NULL on error.
**/
GFileInfo *
g_file_output_stream_query_info (GFileOutputStream *stream,
@ -250,7 +250,7 @@ g_file_output_stream_query_info_async (GFileOutputStream *stream,
* Finalizes the asynchronous query started
* by g_file_output_stream_query_info_async().
*
* Returns: A #GFileInfo for the finished query.
* Returns: (transfer full): A #GFileInfo for the finished query.
**/
GFileInfo *
g_file_output_stream_query_info_finish (GFileOutputStream *stream,

4
gio/gicon.c
View File

@ -75,7 +75,8 @@ g_icon_default_init (GIconInterface *iface)
* @icon: #gconstpointer to an icon object.
*
* Gets a hash for an icon.
*
*
* Virtual: hash
* Returns: a #guint containing a hash for the @icon, suitable for
* use in a #GHashTable or similar data structure.
**/
@ -198,6 +199,7 @@ g_icon_to_string_tokenized (GIcon *icon, GString *s)
* </para></listitem>
* </itemizedlist>
*
* Virtual: to_tokens
* Returns: An allocated NUL-terminated UTF8 string or %NULL if @icon can't
* be serialized. Use g_free() to free.
*

2
gio/ginetsocketaddress.c
View File

@ -289,7 +289,7 @@ g_inet_socket_address_new (GInetAddress *address,
*
* Gets @address's #GInetAddress.
*
* Returns: the #GInetAddress for @address, which must be
* Returns: (transfer full): the #GInetAddress for @address, which must be
* g_object_ref()'d if it will be stored
*
* Since: 2.22

6
gio/ginitable.c
View File

@ -120,7 +120,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: a newly allocated #GObject, or %NULL on error
* Return value: (transfer full): a newly allocated #GObject, or %NULL on error
*
* Since: 2.22
*/
@ -156,7 +156,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: a newly allocated #GObject, or %NULL on error
* Return value: (transfer full): a newly allocated #GObject, or %NULL on error
*
* Since: 2.22
*/
@ -196,7 +196,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: a newly allocated #GObject, or %NULL on error
* Return value: (transfer full): a newly allocated #GObject, or %NULL on error
*
* Since: 2.22
*/

4
gio/giomodule.c
View File

@ -764,7 +764,7 @@ g_io_extension_point_get_extensions (GIOExtensionPoint *extension_point)
*
* Finds a #GIOExtension for an extension point by name.
*
* Returns: the #GIOExtension for @extension_point that has the
* Returns: (transfer none): the #GIOExtension for @extension_point that has the
* given name, or %NULL if there is no extension with that name
*/
GIOExtension *
@ -872,7 +872,7 @@ g_io_extension_point_implement (const char *extension_point_name,
* Gets a reference to the class for the type that is
* associated with @extension.
*
* Returns: the #GTypeClass for the type of @extension
* Returns: (transfer full): the #GTypeClass for the type of @extension
*/
GTypeClass *
g_io_extension_ref_class (GIOExtension *extension)

2
gio/giomodule.h
View File

@ -119,7 +119,7 @@ void g_io_module_unload (GIOModule *module);
* run gio-querymodules in order to build the cache files required for
* lazy loading.
*
* Returns: A %NULL-terminated array of strings, listing the supported
* Returns: (transfer full): A %NULL-terminated array of strings, listing the supported
* extension points of the module. The array must be suitable for
* freeing with g_strfreev().
*

2
gio/gkeyfilesettingsbackend.c
View File

@ -571,7 +571,7 @@ dir_changed (GFileMonitor *monitor,
* @root_path: the path under which all settings keys appear
* @root_group: (allow-none): the group name corresponding to
* @root_path, or %NULL
* @returns: a keyfile-backed #GSettingsBackend
* @returns: (transfer full): a keyfile-backed #GSettingsBackend
*
* Creates a keyfile-backed #GSettingsBackend.
*

4
gio/gloadableicon.c
View File

@ -70,7 +70,7 @@ g_loadable_icon_default_init (GLoadableIconIface *iface)
* Loads a loadable icon. For the asynchronous version of this function,
* see g_loadable_icon_load_async().
*
* Returns: a #GInputStream to read the icon from.
* Returns: (transfer full): a #GInputStream to read the icon from.
**/
GInputStream *
g_loadable_icon_load (GLoadableIcon *icon,
@ -126,7 +126,7 @@ g_loadable_icon_load_async (GLoadableIcon *icon,
*
* Finishes an asynchronous icon load started in g_loadable_icon_load_async().
*
* Returns: a #GInputStream to read the icon from.
* Returns: (transfer full): a #GInputStream to read the icon from.
**/
GInputStream *
g_loadable_icon_load_finish (GLoadableIcon *icon,

2
gio/gmemoryoutputstream.c
View File

@ -376,7 +376,7 @@ g_memory_output_stream_new (gpointer data,
}
/**
* g_memory_output_stream_get_data:
* g_memory_output_stream_get_data: (skip)
* @ostream: a #GMemoryOutputStream
*
* Gets any loaded data from the @ostream.

6
gio/gmount.c
View File

@ -146,7 +146,7 @@ g_mount_get_root (GMount *mount)
* @mount is a path that reflects the main entry point for the user (e.g.
* the home directory, or the root of the volume).
*
* Returns: a #GFile.
* Returns: (transfer full): a #GFile.
* The returned object should be unreffed with
* g_object_unref() when no longer needed.
**/
@ -800,7 +800,7 @@ g_mount_guess_content_type (GMount *mount,
* %G_IO_ERROR_NOT_SUPPORTED if the mount does not support content
* guessing.
*
* Returns: a %NULL-terminated array of content types or %NULL on error.
* Returns: (transfer full) (element-type utf8): a %NULL-terminated array of content types or %NULL on error.
* Caller should free this array with g_strfreev() when done with it.
*
* Since: 2.18
@ -844,7 +844,7 @@ g_mount_guess_content_type_finish (GMount *mount,
* This is an synchronous operation and as such may block doing IO;
* see g_mount_guess_content_type() for the asynchronous version.
*
* Returns: a %NULL-terminated array of content types or %NULL on error.
* Returns: (transfer full) (element-type utf8): a %NULL-terminated array of content types or %NULL on error.
* Caller should free this array with g_strfreev() when done with it.
*
* Since: 2.18

8
gio/gnetworkaddress.c
View File

@ -251,7 +251,7 @@ g_network_address_set_addresses (GNetworkAddress *addr,
* Creates a new #GSocketConnectable for connecting to the given
* @hostname and @port.
*
* Return value: the new #GNetworkAddress
* Return value: (transfer full): the new #GNetworkAddress
*
* Since: 2.22
*/
@ -275,7 +275,7 @@ g_network_address_new (const gchar *hostname,
* @hostname and @port. May fail and return %NULL in case
* parsing @host_and_port fails.
*
* @host_and_port may be in any of a number of recognised formats: an IPv6
* @host_and_port may be in any of a number of recognised formats; an IPv6
* address, an IPv4 address, or a domain name (in which case a DNS
* lookup is performed). Quoting with [] is supported for all address
* types. A port override may be specified in the usual way with a
@ -289,7 +289,7 @@ g_network_address_new (const gchar *hostname,
* (allowing them to give the hostname, and a port overide if necessary)
* and @default_port is expected to be provided by the application.
*
* Return value: the new #GNetworkAddress, or %NULL on error
* Return value: (transfer full): the new #GNetworkAddress, or %NULL on error
*
* Since: 2.22
*/
@ -680,7 +680,7 @@ _g_uri_from_authority (const gchar *protocol,
* g_network_address_parse_host() allows #GSocketClient to determine
* when to use application-specific proxy protocols.
*
* Return value: the new #GNetworkAddress, or %NULL on error
* Return value: (transfer full): the new #GNetworkAddress, or %NULL on error
*
* Since: 2.26
*/

2
gio/gnetworkservice.c
View File

@ -245,7 +245,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: a new #GNetworkService
* Return value: (transfer full): a new #GNetworkService
*
* Since: 2.22
*/

6
gio/goutputstream.c
View File

@ -148,7 +148,7 @@ g_output_stream_init (GOutputStream *stream)
/**
* g_output_stream_write:
* @stream: a #GOutputStream.
* @buffer: (array length=count) (element-type uint8): the buffer containing the data to write.
* @buffer: (array length=count) (element-type guint8): the buffer containing the data to write.
* @count: the number of bytes to write
* @cancellable: optional cancellable object
* @error: location to store the error occuring, or %NULL to ignore
@ -227,7 +227,7 @@ g_output_stream_write (GOutputStream *stream,
/**
* g_output_stream_write_all:
* @stream: a #GOutputStream.
* @buffer: (array length=count) (element-type uint8): the buffer containing the data to write.
* @buffer: (array length=count) (element-type guint8): the buffer containing the data to write.
* @count: the number of bytes to write
* @bytes_written: location to store the number of bytes that was
* written to the stream
@ -651,7 +651,7 @@ async_ready_close_flushed_callback_wrapper (GObject *source_object,
/**
* g_output_stream_write_async:
* @stream: A #GOutputStream.
* @buffer: (array length=count) (element-type uint8): the buffer containing the data to write.
* @buffer: (array length=count) (element-type guint8): the buffer containing the data to write.
* @count: the number of bytes to write
* @io_priority: the io priority of the request.
* @cancellable: optional #GCancellable object, %NULL to ignore.

4
gio/gproxy.c
View File

@ -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: a #GIOStream that will replace @connection. This might
* Return value: (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: a #GIOStream.
* Return value: (transfer full): a #GIOStream.
*
* Since: 2.26
*/

6
gio/gproxyresolver.c
View File

@ -101,7 +101,7 @@ get_default_proxy_resolver (gpointer arg)
*
* Gets the default #GProxyResolver for the system.
*
* Return value: the default #GProxyResolver.
* Return value: (transfer none): the default #GProxyResolver.
*
* Since: 2.26
*/
@ -160,7 +160,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: A NULL-terminated array of proxy URIs. Must be freed with
* Return value: (transfer full) (element-type utf8): A NULL-terminated array of proxy URIs. Must be freed with
* g_strfreev().
*
* Since: 2.26
@ -221,7 +221,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: A NULL-terminated array of proxy URIs. Must be freed with
* Return value: (transfer full) (element-type utf8): A NULL-terminated array of proxy URIs. Must be freed with
* g_strfreev().
*
* Since: 2.26

2
gio/gresolver.c
View File

@ -144,7 +144,7 @@ static GResolver *default_resolver;
* many threads/processes, etc it should allocate for concurrent DNS
* resolutions.
*
* Return value: the default #GResolver.
* Return value: (transfer full): the default #GResolver.
*
* Since: 2.22
*/

3
gio/gseekable.c
View File

@ -154,7 +154,8 @@ g_seekable_can_truncate (GSeekable *seekable)
* was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
* operation was partially finished when the operation was cancelled the
* partial result will be returned, without an error.
*
*
* Virtual: truncate_fn
* Returns: %TRUE if successful. If an error
* has occurred, this function will return %FALSE and set @error
* appropriately if present.

8
gio/gsettings.c
View File

@ -1525,7 +1525,7 @@ g_settings_set (GSettings *settings,
* @mapping: the function to map the value in the settings database to
* the value used by the application
* @user_data: user data for @mapping
* @returns: the result, which may be %NULL
* @returns: (transfer full): the result, which may be %NULL
*
* Gets the value that is stored at @key in @settings, subject to
* application-level validation/mapping.
@ -2050,7 +2050,7 @@ g_settings_is_writable (GSettings *settings,
* g_settings_get_child:
* @settings: a #GSettings object
* @name: the name of the 'child' schema
* @returns: a 'child' settings object
* @returns: (transfer full): a 'child' settings object
*
* Creates a 'child' settings object which has a base path of
* <replaceable>base-path</replaceable>/@name", where
@ -2093,7 +2093,7 @@ g_settings_get_child (GSettings *settings,
/**
* g_settings_list_keys:
* @settings: a #GSettings object
* @returns: a list of the keys on @settings
* @returns: (transfer full) (element-type utf8): a list of the keys on @settings
*
* Introspects the list of keys on @settings.
*
@ -2129,7 +2129,7 @@ g_settings_list_keys (GSettings *settings)
/**
* g_settings_list_children:
* @settings: a #GSettings object
* @returns: a list of the children on @settings
* @returns: (transfer full) (element-type utf8): a list of the children on @settings
*
* Gets the list of children on @settings.
*

6
gio/gsettingsbackend.c
View File

@ -386,7 +386,7 @@ g_settings_backend_dispatch_signal (GSettingsBackend *backend,
* implementations should call this if a key has possibly changed its
* value.
*
* @key must be a valid key (ie: starting with a slash, not containing
* @key must be a valid key (ie starting with a slash, not containing
* '//', and not ending with a slash).
*
* The implementation must call this function during any call to
@ -432,7 +432,7 @@ g_settings_backend_changed (GSettingsBackend *backend,
* implementations should call this if keys have possibly changed their
* values.
*
* @path must be a valid path (ie: starting and ending with a slash and
* @path must be a valid path (ie starting and ending with a slash and
* not containing '//'). Each string in @items must form a valid key
* name when @path is prefixed to it (ie: each item must not start or
* end with '/' and must not contain '//').
@ -483,7 +483,7 @@ g_settings_backend_keys_changed (GSettingsBackend *backend,
* Backend implementations should call this if an entire path of keys
* have possibly changed their values.
*
* @path must be a valid path (ie: starting and ending with a slash and
* @path must be a valid path (ie starting and ending with a slash and
* not containing '//').
*
* The meaning of this signal is that any of the key which has a name

2
gio/gsettingsschema.c
View File

@ -97,7 +97,7 @@ add_item (gpointer key,
* g_settings_list_schemas:
* @returns: a list of the schemas installed on the system
*
* Returns a list of GSettings schemas that are available. The list
* Returns: (element-type utf8) (transfer none): a list of GSettings schemas that are available. The list
* must not be modified or freed.
**/
const gchar * const *

4
gio/gsimpleasyncresult.c
View File

@ -439,7 +439,7 @@ g_simple_async_result_set_handle_cancellation (GSimpleAsyncResult *simple,
}
/**
* g_simple_async_result_get_source_tag:
* g_simple_async_result_get_source_tag: (skip)
* @simple: a #GSimpleAsyncResult.
*
* Gets the source tag for the #GSimpleAsyncResult.
@ -500,7 +500,7 @@ g_simple_async_result_set_op_res_gpointer (GSimpleAsyncResult *simple,
}
/**
* g_simple_async_result_get_op_res_gpointer:
* g_simple_async_result_get_op_res_gpointer: (skip):
* @simple: a #GSimpleAsyncResult.
*
* Gets a pointer result as returned by the asynchronous function.

10
gio/gsocket.c
View File

@ -1203,7 +1203,7 @@ g_socket_get_fd (GSocket *socket)
* useful if the socket has been bound to a local address,
* either explicitly or implicitly when connecting.
*
* Returns: a #GSocketAddress or %NULL on error.
* Returns: (transfer full): a #GSocketAddress or %NULL on error.
* Free the returned object with g_object_unref().
*
* Since: 2.22
@ -1236,7 +1236,7 @@ g_socket_get_local_address (GSocket *socket,
* Try to get the remove address of a connected socket. This is only
* useful for connection oriented sockets that have been connected.
*
* Returns: a #GSocketAddress or %NULL on error.
* Returns: (transfer full): a #GSocketAddress or %NULL on error.
* Free the returned object with g_object_unref().
*
* Since: 2.22
@ -1471,7 +1471,7 @@ g_socket_speaks_ipv4 (GSocket *socket)
* or return %G_IO_ERROR_WOULD_BLOCK if non-blocking I/O is enabled.
* To be notified of an incoming connection, wait for the %G_IO_IN condition.
*
* Returns: a new #GSocket, or %NULL on error.
* Returns: (transfer full): a new #GSocket, or %NULL on error.
* Free the returned object with g_object_unref().
*
* Since: 2.22
@ -2564,7 +2564,7 @@ socket_source_new (GSocket *socket,
* marked as having had a timeout, and so the next #GSocket I/O method
* you call will then fail with a %G_IO_ERROR_TIMED_OUT.
*
* Returns: a newly allocated %GSource, free with g_source_unref().
* Returns: (transfer full): a newly allocated %GSource, free with g_source_unref().
*
* Since: 2.22
*/
@ -3445,7 +3445,7 @@ g_socket_receive_message (GSocket *socket,
* g_unix_connection_send_credentials() /
* g_unix_connection_receive_credentials() functions.
*
* Returns: %NULL if @error is set, otherwise a #GCredentials object
* Returns: (transfer full): %NULL if @error is set, otherwise a #GCredentials object
* that must be freed with g_object_unref().
*
* Since: 2.26

4
gio/gsocketaddressenumerator.c
View File

@ -67,7 +67,7 @@ g_socket_address_enumerator_class_init (GSocketAddressEnumeratorClass *enumerato
* internal errors (other than @cancellable being triggered) will be
* ignored.
*
* Return value: a #GSocketAddress (owned by the caller), or %NULL on
* Return value: (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.
*/
@ -168,7 +168,7 @@ g_socket_address_enumerator_real_next_finish (GSocketAddressEnumerator *enumera
* g_socket_address_enumerator_next() for more information about
* error handling.
*
* Return value: a #GSocketAddress (owned by the caller), or %NULL on
* Return value: (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.
*/

18
gio/gsocketclient.c
View File

@ -621,7 +621,7 @@ g_socket_client_class_init (GSocketClientClass *class)
* If a local address is specified with g_socket_client_set_local_address() the
* socket will be bound to this address before connecting.
*
* Returns: a #GSocketConnection on success, %NULL on error.
* Returns: (transfer full): a #GSocketConnection on success, %NULL on error.
*
* Since: 2.22
*/
@ -772,7 +772,7 @@ g_socket_client_connect (GSocketClient *client,
*
* Attempts to create a TCP connection to the named host.
*
* @host_and_port may be in any of a number of recognised formats: an IPv6
* @host_and_port may be in any of a number of recognised formats; an IPv6
* address, an IPv4 address, or a domain name (in which case a DNS
* lookup is performed). Quoting with [] is supported for all address
* types. A port override may be specified in the usual way with a
@ -799,7 +799,7 @@ g_socket_client_connect (GSocketClient *client,
* connectable) %NULL is returned and @error (if non-%NULL) is set
* accordingly.
*
Returns: a #GSocketConnection on success, %NULL on error.
* Returns: (transfer full): a #GSocketConnection on success, %NULL on error.
*
* Since: 2.22
*/
@ -831,7 +831,7 @@ g_socket_client_connect_to_host (GSocketClient *client,
* @service: the name of the service to connect to
* @cancellable: a #GCancellable, or %NULL
* @error: a pointer to a #GError, or %NULL
* @returns: a #GSocketConnection if successful, or %NULL on error
* @returns: (transfer full): a #GSocketConnection if successful, or %NULL on error
*
* Attempts to create a TCP connection to a service.
*
@ -894,7 +894,7 @@ g_socket_client_connect_to_service (GSocketClient *client,
* connectable) %NULL is returned and @error (if non-%NULL) is set
* accordingly.
*
* Returns: a #GSocketConnection on success, %NULL on error.
* Returns: (transfer full): a #GSocketConnection on success, %NULL on error.
*
* Since: 2.26
*/
@ -1379,7 +1379,7 @@ g_socket_client_connect_to_uri_async (GSocketClient *client,
*
* Finishes an async connect operation. See g_socket_client_connect_async()
*
* Returns: a #GSocketConnection on success, %NULL on error.
* Returns: (transfer full): a #GSocketConnection on success, %NULL on error.
*
* Since: 2.22
*/
@ -1405,7 +1405,7 @@ g_socket_client_connect_finish (GSocketClient *client,
*
* Finishes an async connect operation. See g_socket_client_connect_to_host_async()
*
* Returns: a #GSocketConnection on success, %NULL on error.
* Returns: (transfer full): a #GSocketConnection on success, %NULL on error.
*
* Since: 2.22
*/
@ -1426,7 +1426,7 @@ g_socket_client_connect_to_host_finish (GSocketClient *client,
*
* Finishes an async connect operation. See g_socket_client_connect_to_service_async()
*
* Returns: a #GSocketConnection on success, %NULL on error.
* Returns: (transfer full): a #GSocketConnection on success, %NULL on error.
*
* Since: 2.22
*/
@ -1447,7 +1447,7 @@ g_socket_client_connect_to_service_finish (GSocketClient *client,
*
* Finishes an async connect operation. See g_socket_client_connect_to_uri_async()
*
* Returns: a #GSocketConnection on success, %NULL on error.
* Returns: (transfer full): a #GSocketConnection on success, %NULL on error.
*
* Since: 2.26
*/

4
gio/gsocketconnectable.c
View File

@ -105,7 +105,7 @@ g_socket_connectable_default_init (GSocketConnectableInterface *iface)
*
* Creates a #GSocketAddressEnumerator for @connectable.
*
* Return value: a new #GSocketAddressEnumerator.
* Return value: (transfer full): a new #GSocketAddressEnumerator.
*
* Since: 2.22
*/
@ -133,7 +133,7 @@ g_socket_connectable_enumerate (GSocketConnectable *connectable)
* g_socket_connectable_proxy_enumerate(), this will fall back to
* calling g_socket_connectable_enumerate().
*
* Return value: a new #GSocketAddressEnumerator.
* Return value: (transfer full): a new #GSocketAddressEnumerator.
*
* Since: 2.26
*/

6
gio/gsocketconnection.c
View File

@ -141,7 +141,7 @@ g_socket_connection_get_socket (GSocketConnection *connection)
*
* Try to get the local address of a socket connection.
*
* Returns: a #GSocketAddress or %NULL on error.
* Returns: (transfer full): a #GSocketAddress or %NULL on error.
* Free the returned object with g_object_unref().
*
* Since: 2.22
@ -160,7 +160,7 @@ g_socket_connection_get_local_address (GSocketConnection *connection,
*
* Try to get the remote address of a socket connection.
*
* Returns: a #GSocketAddress or %NULL on error.
* Returns: (transfer full): a #GSocketAddress or %NULL on error.
* Free the returned object with g_object_unref().
*
* Since: 2.22
@ -504,7 +504,7 @@ g_socket_connection_factory_lookup_type (GSocketFamily family,
* Creates a #GSocketConnection subclass of the right type for
* @socket.
*
* Returns: a #GSocketConnection
* Returns: (transfer full): a #GSocketConnection
*
* Since: 2.22
*/

2
gio/gsocketcontrolmessage.c
View File

@ -163,7 +163,7 @@ g_socket_control_message_class_init (GSocketControlMessageClass *class)
* If there is no implementation for this kind of control message, %NULL
* will be returned.
*
* Returns: the deserialized message or %NULL
* Returns: (transfer full): the deserialized message or %NULL
*
* Since: 2.22
*/

8
gio/gsocketlistener.c
View File

@ -581,7 +581,7 @@ accept_callback (GSocket *socket,
* triggering the cancellable object from another thread. If the operation
* was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
*
* Returns: a #GSocket on success, %NULL on error.
* Returns: (transfer full): a #GSocket on success, %NULL on error.
*
* Since: 2.22
*/
@ -655,7 +655,7 @@ g_socket_listener_accept_socket (GSocketListener *listener,
* triggering the cancellable object from another thread. If the operation
* was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
*
* Returns: a #GSocketConnection on success, %NULL on error.
* Returns: (transfer full): a #GSocketConnection on success, %NULL on error.
*
* Since: 2.22
*/
@ -777,7 +777,7 @@ g_socket_listener_accept_socket_async (GSocketListener *listener,
*
* Finishes an async accept operation. See g_socket_listener_accept_socket_async()
*
* Returns: a #GSocket on success, %NULL on error.
* Returns: (transfer full): a #GSocket on success, %NULL on error.
*
* Since: 2.22
*/
@ -844,7 +844,7 @@ g_socket_listener_accept_async (GSocketListener *listener,
*
* Finishes an async accept operation. See g_socket_listener_accept_async()
*
* Returns: a #GSocketConnection on success, %NULL on error.
* Returns: (transfer full): a #GSocketConnection on success, %NULL on error.
*
* Since: 2.22
*/

2
gio/gsrvtarget.c
View File

@ -227,7 +227,7 @@ compare_target (gconstpointer a, gconstpointer b)
*
* Sorts @targets in place according to the algorithm in RFC 2782.
*
* Return value: the head of the sorted list.
* Return value: (transfer full): the head of the sorted list.
*
* Since: 2.22
*/

8
gio/gthemedicon.c
View File

@ -263,7 +263,7 @@ g_themed_icon_init (GThemedIcon *themed)
*
* Creates a new themed icon for @iconname.
*
* Returns: a new #GThemedIcon.
* Returns: (transfer full): a new #GThemedIcon.
**/
GIcon *
g_themed_icon_new (const char *iconname)
@ -281,7 +281,7 @@ g_themed_icon_new (const char *iconname)
*
* Creates a new themed icon for @iconnames.
*
* Returns: a new #GThemedIcon
* Returns: (transfer full): a new #GThemedIcon
**/
GIcon *
g_themed_icon_new_from_names (char **iconnames,
@ -333,7 +333,7 @@ g_themed_icon_new_from_names (char **iconnames,
* icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio");
* ]|
*
* Returns: a new #GThemedIcon.
* Returns: (transfer full): a new #GThemedIcon.
*/
GIcon *
g_themed_icon_new_with_default_fallbacks (const char *iconname)
@ -350,7 +350,7 @@ g_themed_icon_new_with_default_fallbacks (const char *iconname)
*
* Gets the names of icons from within @icon.
*
* Returns: a list of icon names.
* Returns: (transfer full): a list of icon names.
*/
const char * const *
g_themed_icon_get_names (GThemedIcon *icon)

2
gio/gunionvolumemonitor.c
View File

@ -555,7 +555,7 @@ g_union_volume_monitor_new (void)
*
* Gets the volume monitor used by gio.
*
* Returns: a reference to the #GVolumeMonitor used by gio. Call
* Returns: (transfer full): a reference to the #GVolumeMonitor used by gio. Call
* g_object_unref() when done with it.
**/
GVolumeMonitor *

2
gio/gunixconnection.c
View File

@ -386,7 +386,7 @@ g_unix_connection_send_credentials (GUnixConnection *connection,
* Other ways to exchange credentials with a foreign peer includes the
* #GUnixCredentialsMessage type and g_socket_get_credentials() function.
*
* Returns: Received credentials on success (free with
* Returns: (transfer full): Received credentials on success (free with
* g_object_unref()), %NULL if @error is set.
*
* Since: 2.26

2
gio/gunixcredentialsmessage.c
View File

@ -380,7 +380,7 @@ g_unix_credentials_message_new_with_credentials (GCredentials *credentials)
*
* Gets the credentials stored in @message.
*
* Returns: A #GCredentials instance. Do not free, it is owned by @message.
* Returns: (transfer none): A #GCredentials instance. Do not free, it is owned by @message.
*
* Since: 2.26
*/

2
gio/gunixfdmessage.c
View File

@ -157,7 +157,7 @@ g_unix_fd_message_set_property (GObject *object, guint prop_id,
* return a reference to the caller, but the returned list is valid for
* the lifetime of @message.
*
* Returns: the #GUnixFDList from @message
* Returns: (transfer none): the #GUnixFDList from @message
*
* Since: 2.24
**/

6
gio/gunixmounts.c
View File

@ -1103,7 +1103,7 @@ g_unix_mounts_get (guint64 *time_read)
* is set, it will be filled with a unix timestamp for checking
* if the mounts have changed since with g_unix_mounts_changed_since().
*
* Returns: a #GUnixMount.
* Returns: (transfer full): a #GUnixMount.
**/
GUnixMountEntry *
g_unix_mount_at (const char *mount_path,
@ -1856,7 +1856,7 @@ g_unix_mount_guess_name (GUnixMountEntry *mount_entry)
*
* Guesses the icon of a Unix mount.
*
* Returns: a #GIcon
* Returns: (transfer full): a #GIcon
*/
GIcon *
g_unix_mount_guess_icon (GUnixMountEntry *mount_entry)
@ -1893,7 +1893,7 @@ g_unix_mount_point_guess_name (GUnixMountPoint *mount_point)
*
* Guesses the icon of a Unix mount point.
*
* Returns: a #GIcon
* Returns: (transfer full): a #GIcon
*/
GIcon *
g_unix_mount_point_guess_icon (GUnixMountPoint *mount_point)

12
gio/gvfs.c
View File

@ -77,7 +77,7 @@ g_vfs_is_active (GVfs *vfs)
*
* Gets a #GFile for @path.
*
* Returns: a #GFile.
* Returns: (transfer full): a #GFile.
* Free the returned object with g_object_unref().
**/
GFile *
@ -105,7 +105,7 @@ g_vfs_get_file_for_path (GVfs *vfs,
* might not support any I/O operation if the URI
* is malformed or if the URI scheme is not supported.
*
* Returns: a #GFile.
* Returns: (transfer full): a #GFile.
* Free the returned object with g_object_unref().
**/
GFile *
@ -128,7 +128,7 @@ g_vfs_get_file_for_uri (GVfs *vfs,
*
* Gets a list of URI schemes supported by @vfs.
*
* Returns: a %NULL-terminated array of strings.
* Returns: (transfer none): a %NULL-terminated array of strings.
* The returned array belongs to GIO and must
* not be freed or modified.
**/
@ -153,7 +153,7 @@ g_vfs_get_supported_uri_schemes (GVfs *vfs)
* not support any I/O operations if the @parse_name cannot
* be parsed by the #GVfs module.
*
* Returns: a #GFile for the given @parse_name.
* Returns: (transfer full): a #GFile for the given @parse_name.
* Free the returned object with g_object_unref().
**/
GFile *
@ -222,7 +222,7 @@ get_default_vfs (gpointer arg)
*
* Gets the default #GVfs for the system.
*
* Returns: a #GVfs.
* Returns: (transfer none): a #GVfs.
**/
GVfs *
g_vfs_get_default (void)
@ -237,7 +237,7 @@ g_vfs_get_default (void)
*
* Gets the local #GVfs for the system.
*
* Returns: a #GVfs.
* Returns: (transfer none): a #GVfs.
**/
GVfs *
g_vfs_get_local (void)

2
gio/gvolume.c
View File

@ -308,6 +308,8 @@ g_volume_should_automount (GVolume *volume)
* Mounts a volume. This is an asynchronous operation, and is
* finished by calling g_volume_mount_finish() with the @volume
* and #GAsyncResult returned in the @callback.
*
* Virtual: mount_fn
**/
void
g_volume_mount (GVolume *volume,

2
gio/gvolumemonitor.c
View File

@ -373,7 +373,7 @@ g_volume_monitor_get_volume_for_uuid (GVolumeMonitor *volume_monitor,
*
* Finds a #GMount object by its UUID (see g_mount_get_uuid())
*
* Returns: a #GMount or %NULL if no such mount is available.
* Returns: (transfer full): a #GMount or %NULL if no such mount is available.
* Free the returned object with g_object_unref().
**/
GMount *