From 82fae72ae9d68bcce23c47c9f7046a50bb226105 Mon Sep 17 00:00:00 2001 From: Bastien Nocera Date: Mon, 3 Oct 2011 15:27:15 +0100 Subject: [PATCH] [gio] Improve doc for g_file_make_directory_with_parents() g_file_make_directory_with_parents() will fail for already existing directories, unlike g_mkdir_with_parents(), so mention this clearly in the docs. https://bugzilla.gnome.org/show_bug.cgi?id=660791 --- gio/gfile.c | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/gio/gfile.c b/gio/gfile.c index dcd743388..442afe0b1 100644 --- a/gio/gfile.c +++ b/gio/gfile.c @@ -3373,7 +3373,9 @@ g_file_make_directory (GFile *file, * * Creates a directory and any parent directories that may not exist similar to * 'mkdir -p'. If the file system does not support creating directories, this - * function will fail, setting @error to %G_IO_ERROR_NOT_SUPPORTED. + * function will fail, setting @error to %G_IO_ERROR_NOT_SUPPORTED. If the + * directory itself already exists, this function will fail setting @error + * to %G_IO_ERROR_EXISTS, unlike the similar g_mkdir_with_parents(). * * For a local #GFile the newly created directories will have the default * (current) ownership and permissions of the current process.