[glib] [gio] Improve doc for g_file_make_directory_with_parents()

[Bastien Nocera <hadess src gnome org>]

commit 82fae72ae9d68bcce23c47c9f7046a50bb226105
Author: Bastien Nocera <hadess hadess net>
Date:   Mon Oct 3 15:27:15 2011 +0100

    [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 files changed, 3 insertions(+), 1 deletions(-)
---
diff --git a/gio/gfile.c b/gio/gfile.c
index dcd7433..442afe0 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.