*
* This call does no blocking i/o.
*
- * Returns: #GFile that is a duplicate of the given #GFile.
+ * Returns: a new #GFile that is a duplicate of the given #GFile.
**/
GFile *
g_file_dup (GFile *file)
* Other errors are possible too.
*
* Returns: A #GFileEnumerator if successful, %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFileEnumerator *
g_file_enumerate_children (GFile *file,
* See g_file_enumerate_children_async().
*
* Returns: a #GFileEnumerator or %NULL if an error occurred.
+ * Free the returned object with g_object_unref().
**/
GFileEnumerator *
g_file_enumerate_children_finish (GFile *file,
* 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.
+ * Free the returned object with g_object_unref().
**/
GFileInfo *
g_file_query_info (GFile *file,
* See g_file_query_info_async().
*
* Returns: #GFileInfo for given @file or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFileInfo *
g_file_query_info_finish (GFile *file,
* 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.
+ * Free the returned object with g_object_unref().
**/
GFileInfo *
g_file_query_filesystem_info (GFile *file,
* g_file_query_filesystem_info_async().
*
* Returns: #GFileInfo for given @file or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFileInfo *
g_file_query_filesystem_info_finish (GFile *file,
* was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
*
* Returns: a #GMount where the @file is located or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GMount *
g_file_find_enclosing_mount (GFile *file,
* See g_file_find_enclosing_mount_async().
*
* Returns: #GMount for given @file or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GMount *
g_file_find_enclosing_mount_finish (GFile *file,
* Other errors are possible too, and depend on what kind of filesystem the file is on.
*
* Returns: #GFileInputStream or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFileInputStream *
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: a #GFileOutputStream, or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFileOutputStream *
g_file_append_to (GFile *file,
* filesystem the file is on.
*
* Returns: a #GFileOutputStream for the newly created file, or
- * %NULL on error.
+ * %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFileOutputStream *
g_file_create (GFile *file,
* filesystem the file is on.
*
* Returns: a #GFileOutputStream or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFileOutputStream *
g_file_replace (GFile *file,
* g_file_read_async().
*
* Returns: a #GFileInputStream or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFileInputStream *
g_file_read_finish (GFile *file,
* g_file_append_to_async().
*
* Returns: a valid #GFileOutputStream or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFileOutputStream *
g_file_append_to_finish (GFile *file,
* g_file_create_async().
*
* Returns: a #GFileOutputStream or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFileOutputStream *
g_file_create_finish (GFile *file,
* g_file_replace_async().
*
* Returns: a #GFileOutputStream, or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFileOutputStream *
g_file_replace_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 #GFile specifying what @file was renamed to, or %NULL if there was an error.
+ * Returns: a #GFile specifying what @file was renamed to, or %NULL
+ * if there was an error.
+ * Free the returned object with g_object_unref().
**/
GFile *
g_file_set_display_name (GFile *file,
* g_file_set_display_name_async().
*
* Returns: a #GFile or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFile *
g_file_set_display_name_finish (GFile *file,
* with g_file_mount_mountable().
*
* Returns: a #GFile or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFile *
g_file_mount_mountable_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 #GFileMonitor for the given @file,
- * or %NULL on error.
+ * Returns: a #GFileMonitor for the given @file, or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFileMonitor*
g_file_monitor_directory (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.
+ * Returns: a #GFileMonitor for the given @file, or %NULL on error.
+ * Free the returned object with g_object_unref().
**/
GFileMonitor*
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.
+ * Returns: a #GFileMonitor for the given @file, or %NULL on error.
+ * Free the returned object with g_object_unref().
*
* Since: 2.18
*/