diff options
author | Johan Dahlin <johan@gnome.org> | 2010-09-24 18:25:04 -0300 |
---|---|---|
committer | Johan Dahlin <johan@gnome.org> | 2010-09-24 18:25:46 -0300 |
commit | 9062c5e873254aec9fbe3588d14cda6ad82f65a2 (patch) | |
tree | f035012b2a2e856d3d9332c94d84c03399df7d0f /gir | |
parent | 787b1a8b897a9b29193f3dca0d81d3f12a4ad6a2 (diff) | |
download | gobject-introspection-9062c5e873254aec9fbe3588d14cda6ad82f65a2.tar.gz |
Re-generate against HEAD of Gio
Diffstat (limited to 'gir')
-rw-r--r-- | gir/gio-2.0.c | 304 |
1 files changed, 155 insertions, 149 deletions
diff --git a/gir/gio-2.0.c b/gir/gio-2.0.c index 8e6fd2be..30cf3c28 100644 --- a/gir/gio-2.0.c +++ b/gir/gio-2.0.c @@ -370,7 +370,7 @@ * * Gets the user data from a #GAsyncResult. * - * Returns: the user data for @res. + * Returns: (transfer full): the user data for @res. */ @@ -669,7 +669,7 @@ * * Guesses the icon of a Unix mount point. * - * Returns: a #GIcon + * Returns: (transfer full): a #GIcon */ @@ -789,7 +789,7 @@ * 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. */ @@ -842,7 +842,7 @@ * themselves. * kinds of identifiers. Use g_strfreev() to free. * - * Returns: a %NULL-terminated array of strings containing + * Returns: (transfer full): a %NULL-terminated array of strings containing */ @@ -1115,7 +1115,7 @@ * 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. */ @@ -1230,7 +1230,7 @@ * returned array of proxies. * g_strfreev(). * - * Returns: A NULL-terminated array of proxy URIs. Must be freed with + * Returns: (transfer full) (element-type utf8): A NULL-terminated array of proxy URIs. Must be freed with * Since: 2.26 */ @@ -1331,7 +1331,7 @@ * * Gets the #GFile associated with the given @icon. * - * Returns: a #GFile, or %NULL. + * Returns: (transfer none): a #GFile, or %NULL. */ @@ -1513,7 +1513,7 @@ * 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 */ @@ -1560,7 +1560,7 @@ * * Finishes an asynchronous info query operation. * - * Returns: #GFileInfo. + * Returns: (transfer full): #GFileInfo. */ @@ -1846,7 +1846,7 @@ * 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 */ @@ -1881,7 +1881,7 @@ * 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 */ @@ -2304,7 +2304,7 @@ * Gives back the icon from @emblem. * and should not be modified or freed. * - * Returns: a #GIcon. The returned object belongs to the emblem + * Returns: (transfer full): a #GIcon. The returned object belongs to the emblem * Since: 2.18 */ @@ -2810,7 +2810,7 @@ * * Creates a #GSocketConnection subclass of the right type for * - * Returns: a #GSocketConnection + * Returns: (transfer full): a #GSocketConnection * Since: 2.22 */ @@ -3032,7 +3032,7 @@ * Gets the top cancellable from the stack. * if the stack is empty. * - * Returns: a #GCancellable from the top of the stack, or %NULL + * Returns: (transfer none): a #GCancellable from the top of the stack, or %NULL */ @@ -3290,7 +3290,7 @@ * * Duplicates a file info structure. * - * Returns: a duplicate #GFileInfo of @other. + * Returns: (transfer full): a duplicate #GFileInfo of @other. */ @@ -3435,7 +3435,7 @@ * * Creates a new #GSocketConnectable for connecting to the given * - * Returns: the new #GNetworkAddress + * Returns: (transfer full): the new #GNetworkAddress * Since: 2.22 */ @@ -3515,7 +3515,7 @@ * * 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. */ @@ -3618,7 +3618,7 @@ * 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 */ @@ -3744,7 +3744,7 @@ * 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 */ @@ -3759,6 +3759,7 @@ * This function is intended for easily hashing a #GFile to * add to a #GHashTable or similar data structure. * + * Virtual: hash * Returns: 0 if @file is not a valid #GFile, otherwise an */ @@ -3876,7 +3877,7 @@ * g_list_free() and unref the infos with g_object_unref() when you're * done with them. * - * 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 */ @@ -4549,7 +4550,7 @@ * %NULL on error. * Free the returned object with g_object_unref(). * - * Returns: a #GFileOutputStream for the newly created file, or + * Returns: (transfer full): a #GFileOutputStream for the newly created file, or */ @@ -4743,7 +4744,7 @@ * rather than just opening for reading or writing. * Free the returned object with g_object_unref(). * - * 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. * Since: 2.22 */ @@ -5199,7 +5200,6 @@ * @host_and_port: the hostname and optionally a port * @default_port: the default port if not in @host_and_port * @error: a pointer to a #GError, or %NULL - * @host_and_port may be in any of a number of recognised formats: an IPv6 * * Creates a new #GSocketConnectable for connecting to the given * parsing @host_and_port fails. @@ -5214,7 +5214,7 @@ * (allowing them to give the hostname, and a port overide if necessary) * and @default_port is expected to be provided by the application. * - * Returns: the new #GNetworkAddress, or %NULL on error + * Returns: (transfer full): the new #GNetworkAddress, or %NULL on error * Since: 2.22 */ @@ -5251,7 +5251,6 @@ * @backend: a #GSettingsBackend implementation * @path: the path containing the changes * @origin_tag: the origin tag - * @path must be a valid path (ie: starting and ending with a slash and * * Signals that all keys below a given path may have possibly changed. * Backend implementations should call this if an entire path of keys @@ -5293,7 +5292,7 @@ * 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 */ @@ -5359,7 +5358,7 @@ * * Gets the default #GVfs for the system. * - * Returns: a #GVfs. + * Returns: (transfer none): a #GVfs. */ @@ -5389,7 +5388,7 @@ * with g_file_mount_mountable(). * Free the returned object with g_object_unref(). * - * Returns: a #GFile or %NULL on error. + * Returns: (transfer full): a #GFile or %NULL on error. */ @@ -5836,7 +5835,7 @@ * 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 */ @@ -5916,7 +5915,7 @@ * The returned object should be unreffed with * g_object_unref() when no longer needed. * - * Returns: a #GFile. + * Returns: (transfer full): a #GFile. */ @@ -6159,7 +6158,7 @@ * * 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 */ @@ -6431,7 +6430,7 @@ * 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 */ @@ -6476,7 +6475,7 @@ * see g_mount_guess_content_type() for the asynchronous version. * Caller should free this array with g_strfreev() when done with it. * - * 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. * Since: 2.18 */ @@ -6762,7 +6761,7 @@ * The returned array belongs to GIO and must * not be freed or modified. * - * Returns: a %NULL-terminated array of strings. + * Returns: (transfer none): a %NULL-terminated array of strings. */ @@ -6899,7 +6898,8 @@ * Other errors are possible too, and depend on what kind of filesystem the file is on. * Free the returned object with g_object_unref(). * - * Returns: #GFileInputStream or %NULL on error. + * Virtual: read_fn + * Returns: (transfer full): #GFileInputStream or %NULL on error. */ @@ -6960,7 +6960,7 @@ * g_file_replace_readwrite_async(). * Free the returned object with g_object_unref(). * - * Returns: a #GFileIOStream, or %NULL on error. + * Returns: (transfer full): a #GFileIOStream, or %NULL on error. * Since: 2.22 */ @@ -7023,7 +7023,7 @@ * extension points of the module. The array must be suitable for * freeing with g_strfreev(). * - * Returns: A %NULL-terminated array of strings, listing the supported + * Returns: (transfer full): A %NULL-terminated array of strings, listing the supported * Since: 2.24 */ @@ -7127,7 +7127,7 @@ * * Creates a new themed icon for @iconname. * - * Returns: a new #GThemedIcon. + * Returns: (transfer full): a new #GThemedIcon. */ @@ -7376,7 +7376,7 @@ * g_file_replace_async(). * Free the returned object with g_object_unref(). * - * Returns: a #GFileOutputStream, or %NULL on error. + * Returns: (transfer full): a #GFileOutputStream, or %NULL on error. */ @@ -7419,7 +7419,7 @@ * Try to get the remote address of a socket connection. * Free the returned object with g_object_unref(). * - * Returns: a #GSocketAddress or %NULL on error. + * Returns: (transfer full): a #GSocketAddress or %NULL on error. * Since: 2.22 */ @@ -7759,7 +7759,7 @@ * 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. */ @@ -7806,6 +7806,7 @@ * #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 */ @@ -8210,7 +8211,7 @@ * rather than just opening for reading or writing. * Free the returned object with g_object_unref(). * - * Returns: a #GFileIOStream or %NULL on error. + * Returns: (transfer full): a #GFileIOStream or %NULL on error. * Since: 2.22 */ @@ -8248,7 +8249,7 @@ * g_file_query_filesystem_info_async(). * Free the returned object with g_object_unref(). * - * Returns: #GFileInfo for given @file or %NULL on error. + * Returns: (transfer full): #GFileInfo for given @file or %NULL on error. */ @@ -8400,7 +8401,7 @@ * See g_file_find_enclosing_mount_async(). * Free the returned object with g_object_unref(). * - * Returns: #GMount for given @file or %NULL on error. + * Returns: (transfer full): #GMount for given @file or %NULL on error. */ @@ -8523,7 +8524,7 @@ * 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 */ @@ -8610,7 +8611,7 @@ * * Gets the names of icons from within @icon. * - * Returns: a list of icon names. + * Returns: (transfer full): a list of icon names. */ @@ -8715,7 +8716,7 @@ * filesystem the file is on. * Free the returned object with g_object_unref(). * - * Returns: a #GFileOutputStream, or %NULL on error. + * Returns: (transfer full): a #GFileOutputStream, or %NULL on error. */ @@ -8931,6 +8932,7 @@ * 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. */ @@ -9091,7 +9093,7 @@ * * 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 */ @@ -9184,7 +9186,7 @@ /** * 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 @@ -9281,7 +9283,7 @@ * * 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 */ @@ -9622,7 +9624,7 @@ * * 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. */ @@ -9650,7 +9652,7 @@ * many threads/processes, etc it should allocate for concurrent DNS * resolutions. * - * Returns: the default #GResolver. + * Returns: (transfer full): the default #GResolver. * Since: 2.22 */ @@ -9827,7 +9829,7 @@ * * See g_proxy_connect(). * - * Returns: a #GIOStream. + * Returns: (transfer full): a #GIOStream. * Since: 2.26 */ @@ -9894,7 +9896,7 @@ * icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio"); * ]| * - * Returns: a new #GThemedIcon. + * Returns: (transfer full): a new #GThemedIcon. */ @@ -10008,7 +10010,7 @@ /** * 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. @@ -10145,7 +10147,7 @@ * @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. * This call looks up the SRV record for @service at @domain for the @@ -10544,7 +10546,7 @@ * be the same as @connection, in which case a reference * will be added. * - * Returns: a #GIOStream that will replace @connection. This might + * Returns: (transfer full): a #GIOStream that will replace @connection. This might * Since: 2.26 */ @@ -10572,7 +10574,6 @@ * @path: the path containing the changes * @items: the %NULL-terminated list of changed keys * @origin_tag: the origin tag - * @path must be a valid path (ie: starting and ending with a slash and * * Signals that a list of keys have possibly changed. Backend * implementations should call this if keys have possibly changed their @@ -10676,7 +10677,7 @@ * * 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 */ @@ -10721,7 +10722,7 @@ * * Gets the default #GProxyResolver for the system. * - * Returns: the default #GProxyResolver. + * Returns: (transfer none): the default #GProxyResolver. * Since: 2.26 */ @@ -10951,7 +10952,7 @@ * * Creates a new emblemed icon for @icon with the emblem @emblem. * - * Returns: a new #GIcon + * Returns: (transfer full): a new #GIcon * Since: 2.18 */ @@ -11420,7 +11421,6 @@ * @default_port: the default port to connect to * @cancellable: a #GCancellable, or %NULL * @error: a pointer to a #GError, or %NULL - * @host_and_port may be in any of a number of recognised formats: an IPv6 * * This is a helper function for g_socket_client_connect(). * Attempts to create a TCP connection to the named host. @@ -11444,6 +11444,7 @@ * connectable) %NULL is returned and @error (if non-%NULL) is set * accordingly. * + * Returns: (transfer full): a #GSocketConnection on success, %NULL on error. * Since: 2.22 */ @@ -11512,7 +11513,7 @@ * is malformed or if the URI scheme is not supported. * Free the returned object with g_object_unref(). * - * Returns: a #GFile. + * Returns: (transfer full): a #GFile. */ @@ -11580,7 +11581,7 @@ * 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 */ @@ -11814,7 +11815,7 @@ * g_unix_connection_receive_credentials() functions. * that must be freed with g_object_unref(). * - * Returns: %NULL if @error is set, otherwise a #GCredentials object + * Returns: (transfer full): %NULL if @error is set, otherwise a #GCredentials object * Since: 2.26 */ @@ -12426,7 +12427,7 @@ * g_file_append_to_async(). * Free the returned object with g_object_unref(). * - * Returns: a valid #GFileOutputStream or %NULL on error. + * Returns: (transfer full): a valid #GFileOutputStream or %NULL on error. */ @@ -12532,7 +12533,7 @@ * #GUnixCredentialsMessage type and g_socket_get_credentials() function. * g_object_unref()), %NULL if @error is set. * - * Returns: Received credentials on success (free with + * Returns: (transfer full): Received credentials on success (free with * Since: 2.26 */ @@ -12548,7 +12549,7 @@ * g_proxy_resolver_lookup() for more details. * g_strfreev(). * - * Returns: A NULL-terminated array of proxy URIs. Must be freed with + * Returns: (transfer full) (element-type utf8): A NULL-terminated array of proxy URIs. Must be freed with * Since: 2.26 */ @@ -12660,7 +12661,7 @@ * * 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 */ @@ -12762,7 +12763,7 @@ * * Creates a #GSocketAddressEnumerator for @connectable. * - * Returns: a new #GSocketAddressEnumerator. + * Returns: (transfer full): a new #GSocketAddressEnumerator. * Since: 2.22 */ @@ -12887,9 +12888,8 @@ /** * g_settings_list_schemas: - * @returns: a list of the schemas installed on the system + * @returns: (element-type utf8) (transfer none): a list of GSettings schemas that are available. The list * - * Returns a list of GSettings schemas that are available. The list * must not be modified or freed. */ @@ -13136,7 +13136,7 @@ * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * When you are done with it, release it with g_object_unref() * - * 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. */ @@ -13166,7 +13166,7 @@ * %NULL for message bus clients. * this object, it is owned by @connection. * - * Returns: A #GCredentials or %NULL if not available. Do not free + * Returns: (transfer none): A #GCredentials or %NULL if not available. Do not free * Since: 2.26 */ @@ -13451,7 +13451,7 @@ * useful for connection oriented sockets that have been connected. * Free the returned object with g_object_unref(). * - * Returns: a #GSocketAddress or %NULL on error. + * Returns: (transfer full): a #GSocketAddress or %NULL on error. * Since: 2.22 */ @@ -13473,7 +13473,7 @@ * * 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 */ @@ -13504,7 +13504,7 @@ * * 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 */ @@ -13618,7 +13618,7 @@ * 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 */ @@ -13748,6 +13748,7 @@ * </itemizedlist> * be serialized. Use g_free() to free. * + * Virtual: to_tokens * Returns: An allocated NUL-terminated UTF8 string or %NULL if @icon can't * Since: 2.20 */ @@ -13774,7 +13775,7 @@ * * 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 */ @@ -13944,7 +13945,7 @@ * guessing. * Caller should free this array with g_strfreev() when done with it. * - * 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. * Since: 2.18 */ @@ -14561,6 +14562,8 @@ * 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 */ @@ -14859,7 +14862,7 @@ * * 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 */ @@ -15524,7 +15527,7 @@ * 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 */ @@ -15652,6 +15655,7 @@ * has occurred, this function will return %FALSE and set @error * appropriately if present. * + * Virtual: truncate_fn * Returns: %TRUE if successful. If an error */ @@ -15665,7 +15669,7 @@ * * 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 */ @@ -15842,7 +15846,7 @@ * See g_file_query_info_async(). * Free the returned object with g_object_unref(). * - * Returns: #GFileInfo for given @file or %NULL on error. + * Returns: (transfer full): #GFileInfo for given @file or %NULL on error. */ @@ -16077,7 +16081,7 @@ * This method is only available on UNIX. * associated. Do not free, this object is owned by @message. * - * Returns: A #GUnixFDList or %NULL if no file descriptors are + * Returns: (transfer none): A #GUnixFDList or %NULL if no file descriptors are * Since: 2.26 */ @@ -16363,7 +16367,7 @@ * Finds a #GIOExtension for an extension point by name. * given name, or %NULL if there is no extension with that name * - * Returns: the #GIOExtension for @extension_point that has the + * Returns: (transfer none): the #GIOExtension for @extension_point that has the */ @@ -16854,7 +16858,7 @@ * either explicitly or implicitly when connecting. * Free the returned object with g_object_unref(). * - * Returns: a #GSocketAddress or %NULL on error. + * Returns: (transfer full): a #GSocketAddress or %NULL on error. * Since: 2.22 */ @@ -16978,7 +16982,7 @@ * Other errors are possible too, and depend on what kind of filesystem the file is on. * Free the returned object with g_object_unref(). * - * Returns: a #GFileInfo for the given @file, or %NULL on error. + * Returns: (transfer full): a #GFileInfo for the given @file, or %NULL on error. */ @@ -17421,6 +17425,7 @@ * of @prefix. * %FALSE otherwise. * + * Virtual: prefix_matches * Returns: %TRUE if the @files's parent, grandparent, etc is @prefix. */ @@ -17999,7 +18004,7 @@ * @key: the key to get the value for * @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. @@ -18300,7 +18305,7 @@ * #GFile or %NULL if there is no parent. * Free the returned object with g_object_unref(). * - * Returns: a #GFile structure to the parent of the given + * Returns: (transfer full): a #GFile structure to the parent of the given */ @@ -18500,7 +18505,7 @@ * * Gets the local #GVfs for the system. * - * Returns: a #GVfs. + * Returns: (transfer none): a #GVfs. */ @@ -18987,6 +18992,7 @@ * Gets a hash for an icon. * use in a #GHashTable or similar data structure. * + * Virtual: hash * Returns: a #guint containing a hash for the @icon, suitable for */ @@ -19087,7 +19093,7 @@ * 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 @@ -19746,7 +19752,7 @@ * Gets the source object from a #GAsyncResult. * or %NULL if there is none. * - * Returns: a new reference to the source object for the @res, + * Returns: (transfer full): a new reference to the source object for the @res, */ @@ -19780,7 +19786,7 @@ * g_file_set_display_name_async(). * Free the returned object with g_object_unref(). * - * Returns: a #GFile or %NULL on error. + * Returns: (transfer full): a #GFile or %NULL on error. */ @@ -19865,7 +19871,7 @@ * is %NULL or if @file is invalid. * Free the returned object with g_object_unref(). * - * Returns: #GFile to the resolved path. %NULL if @relative_path + * Returns: (transfer full): #GFile to the resolved path. %NULL if @relative_path */ @@ -19953,7 +19959,7 @@ * filesystem the file is on. * Free the returned object with g_object_unref(). * - * Returns: a #GFileOutputStream or %NULL on error. + * Returns: (transfer full): a #GFileOutputStream or %NULL on error. */ @@ -19978,7 +19984,7 @@ * and the per-process or system-wide open files limit is reached. * g_object_unref(). * - * 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 * Since: 2.26 */ @@ -20147,7 +20153,7 @@ * * 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 */ @@ -20357,7 +20363,7 @@ * * Guesses the icon of a Unix mount. * - * Returns: a #GIcon + * Returns: (transfer full): a #GIcon */ @@ -20402,7 +20408,7 @@ * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * Free the returned object with g_object_unref(). * - * Returns: a #GFileMonitor for the given @file, or %NULL on error. + * Returns: (transfer full): a #GFileMonitor for the given @file, or %NULL on error. * Since: 2.18 */ @@ -21051,7 +21057,7 @@ * g_file_open_readwrite_async(). * Free the returned object with g_object_unref(). * - * Returns: a #GFileIOStream or %NULL on error. + * Returns: (transfer full): a #GFileIOStream or %NULL on error. * Since: 2.22 */ @@ -21106,7 +21112,7 @@ * * 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 */ @@ -21167,7 +21173,7 @@ * 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. */ @@ -21381,7 +21387,7 @@ * Other errors are possible too, and depend on what kind of filesystem the file is on. * Free the returned object with g_object_unref(). * - * Returns: a #GFileInfo or %NULL if there was an error. + * Returns: (transfer full): a #GFileInfo or %NULL if there was an error. */ @@ -21482,7 +21488,7 @@ * 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 */ @@ -21682,7 +21688,7 @@ * be parsed by the #GVfs module. * Free the returned object with g_object_unref(). * - * Returns: a #GFile for the given @parse_name. + * Returns: (transfer full): a #GFile for the given @parse_name. */ @@ -21760,7 +21766,7 @@ * g_mount_guess_content_type(). * or %NULL. Free with g_strfreev() * - * Returns: an %NULL-terminated array of zero or more content types, + * Returns: (transfer full): an %NULL-terminated array of zero or more content types, * Since: 2.18 */ @@ -21820,7 +21826,7 @@ * 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 */ @@ -21919,7 +21925,7 @@ * * 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 */ @@ -21945,7 +21951,7 @@ * error (in which case *@error will be set) or if there are no * more addresses. * - * Returns: a #GSocketAddress (owned by the caller), or %NULL on + * Returns: (transfer full): a #GSocketAddress (owned by the caller), or %NULL on */ @@ -22025,7 +22031,7 @@ * * Creates a new themed icon for @iconnames. * - * Returns: a new #GThemedIcon + * Returns: (transfer full): a new #GThemedIcon */ @@ -22076,7 +22082,7 @@ * similar to g_object_new_valist() but also initializes the object * and returns %NULL, setting an error on failure. * - * Returns: a newly allocated #GObject, or %NULL on error + * Returns: (transfer full): a newly allocated #GObject, or %NULL on error * Since: 2.22 */ @@ -22097,7 +22103,7 @@ * To be notified of an incoming connection, wait for the %G_IO_IN condition. * Free the returned object with g_object_unref(). * - * Returns: a new #GSocket, or %NULL on error. + * Returns: (transfer full): a new #GSocket, or %NULL on error. * Since: 2.22 */ @@ -22646,7 +22652,7 @@ * * Sorts @targets in place according to the algorithm in RFC 2782. * - * Returns: the head of the sorted list. + * Returns: (transfer full): the head of the sorted list. * Since: 2.22 */ @@ -22755,7 +22761,7 @@ * * Gets the underlying stream used for IO. * - * Returns: the stream used for IO + * Returns: (transfer none): the stream used for IO * Since: 2.26 */ @@ -22769,7 +22775,7 @@ * Creates a new #GNetworkService representing the given @service, * #GSocketConnectable interface to resolve it. * - * Returns: a new #GNetworkService + * Returns: (transfer full): a new #GNetworkService * Since: 2.22 */ @@ -23028,7 +23034,7 @@ * 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 */ @@ -23243,7 +23249,7 @@ * g_socket_connectable_proxy_enumerate(), this will fall back to * calling g_socket_connectable_enumerate(). * - * Returns: a new #GSocketAddressEnumerator. + * Returns: (transfer full): a new #GSocketAddressEnumerator. * Since: 2.26 */ @@ -23491,7 +23497,7 @@ * Gets the volume monitor used by gio. * g_object_unref() when done with it. * - * Returns: a reference to the #GVolumeMonitor used by gio. Call + * Returns: (transfer full): a reference to the #GVolumeMonitor used by gio. Call */ @@ -23918,7 +23924,7 @@ * if there was an error. * Free the returned object with g_object_unref(). * - * Returns: a #GFile specifying what @file was renamed to, or %NULL + * Returns: (transfer full): a #GFile specifying what @file was renamed to, or %NULL */ @@ -24098,7 +24104,7 @@ * similar to g_object_newv() but also initializes the object * and returns %NULL, setting an error on failure. * - * Returns: a newly allocated #GObject, or %NULL on error + * Returns: (transfer full): a newly allocated #GObject, or %NULL on error * Since: 2.22 */ @@ -24242,7 +24248,7 @@ * similar to g_object_new() but also initializes the object * and returns %NULL, setting an error on failure. * - * Returns: a newly allocated #GObject, or %NULL on error + * Returns: (transfer full): a newly allocated #GObject, or %NULL on error * Since: 2.22 */ @@ -24913,7 +24919,7 @@ * Finds a #GMount object by its UUID (see g_mount_get_uuid()) * Free the returned object with g_object_unref(). * - * Returns: a #GMount or %NULL if no such mount is available. + * Returns: (transfer full): a #GMount or %NULL if no such mount is available. */ @@ -24958,7 +24964,7 @@ * g_file_create_readwrite_async(). * Free the returned object with g_object_unref(). * - * Returns: a #GFileIOStream or %NULL on error. + * Returns: (transfer full): a #GFileIOStream or %NULL on error. * Since: 2.22 */ @@ -24969,7 +24975,7 @@ * * 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 */ @@ -25020,7 +25026,7 @@ * g_file_create_async(). * Free the returned object with g_object_unref(). * - * Returns: a #GFileOutputStream or %NULL on error. + * Returns: (transfer full): a #GFileOutputStream or %NULL on error. */ @@ -25137,7 +25143,6 @@ * @backend: a #GSettingsBackend implementation * @key: the name of the key * @origin_tag: the origin tag - * @key must be a valid key (ie: starting with a slash, not containing * * Signals that a single key has possibly changed. Backend * implementations should call this if a key has possibly changed its @@ -25186,7 +25191,7 @@ * Gets the icon for a content type. * object with g_object_unref() * - * Returns: #GIcon corresponding to the content type. Free the returned + * Returns: (transfer full): #GIcon corresponding to the content type. Free the returned */ @@ -25360,7 +25365,7 @@ * 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 */ @@ -25754,7 +25759,7 @@ * Gets a #GFile for @path. * Free the returned object with g_object_unref(). * - * Returns: a #GFile. + * Returns: (transfer full): a #GFile. */ @@ -25857,7 +25862,7 @@ * Gets the icon for @drive. * Free the returned object with g_object_unref(). * - * Returns: #GIcon for the @drive. + * Returns: (transfer full): #GIcon for the @drive. */ @@ -25928,7 +25933,7 @@ * 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. */ @@ -26095,7 +26100,7 @@ * * 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 */ @@ -26125,7 +26130,7 @@ /** * 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. * You should probably not be calling this function from "normal" code @@ -26159,7 +26164,7 @@ * error (in which case *@error will be set) or if there are no * more addresses. * - * Returns: a #GSocketAddress (owned by the caller), or %NULL on + * Returns: (transfer full): a #GSocketAddress (owned by the caller), or %NULL on */ @@ -26296,7 +26301,7 @@ * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * Free the returned object with g_object_unref(). * - * 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. */ @@ -26713,7 +26718,7 @@ * 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. */ @@ -26952,7 +26957,8 @@ * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * Free the returned object with g_object_unref(). * - * 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. */ @@ -27215,7 +27221,7 @@ * Gets @address's #GInetAddress. * g_object_ref()'d if it will be stored * - * Returns: the #GInetAddress for @address, which must be + * Returns: (transfer full): the #GInetAddress for @address, which must be * Since: 2.22 */ @@ -27273,7 +27279,7 @@ * just opening for reading or writing. * Free the returned object with g_object_unref(). * - * Returns: #GFileIOStream or %NULL on error. + * Returns: (transfer full): #GFileIOStream or %NULL on error. * Since: 2.22 */ @@ -27905,7 +27911,7 @@ * not contain a stringv, %NULL will be returned. * %NULL otherwise. Do not free. * - * Returns: the contents of the @attribute value as a stringv, or + * Returns: (transfer none): the contents of the @attribute value as a stringv, or * Since: 2.22 */ @@ -28558,7 +28564,7 @@ /** * 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. * The list is exactly the list of strings for which it is not an error @@ -28605,7 +28611,7 @@ * * 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 */ @@ -28648,7 +28654,7 @@ * g_file_read_async(). * Free the returned object with g_object_unref(). * - * Returns: a #GFileInputStream or %NULL on error. + * Returns: (transfer full): a #GFileInputStream or %NULL on error. */ @@ -28660,7 +28666,7 @@ * * 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 */ @@ -28751,7 +28757,7 @@ /** * 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 * @cancellable: optional #GCancellable object, %NULL to ignore. @@ -28887,7 +28893,7 @@ * Try to get the local address of a socket connection. * Free the returned object with g_object_unref(). * - * Returns: a #GSocketAddress or %NULL on error. + * Returns: (transfer full): a #GSocketAddress or %NULL on error. * Since: 2.22 */ @@ -29243,7 +29249,7 @@ * g_network_address_parse_host() allows #GSocketClient to determine * when to use application-specific proxy protocols. * - * Returns: the new #GNetworkAddress, or %NULL on error + * Returns: (transfer full): the new #GNetworkAddress, or %NULL on error * Since: 2.26 */ @@ -29264,7 +29270,7 @@ * @filename: the filename of the keyfile * @root_path: the path under which all settings keys appear * @root_group: (allow-none): the group name corresponding to - * @returns: a keyfile-backed #GSettingsBackend + * @returns: (transfer full): a keyfile-backed #GSettingsBackend * * Creates a keyfile-backed #GSettingsBackend. * The filename of the keyfile to use is given by @filename. |