diff --git a/gio/ChangeLog b/gio/ChangeLog
index 0b83fad51..b7e21b70d 100644
--- a/gio/ChangeLog
+++ b/gio/ChangeLog
@@ -1,3 +1,13 @@
+2008-08-09  Loïc Minier  <lool@dooz.org>
+
+	Bug 535124 – umask 002 not being applied for new directories, new
+	files get the correct umask
+
+	* gfile.c (g_file_make_directory)
+	(g_file_make_directory_with_parents): Document ownership and
+	permissions of newly created directories as being the default
+	ones of the process.
+
 2008-08-08  Loïc Minier  <lool@dooz.org>
 
 	Bug 535124 – umask 002 not being applied for new directories, new
diff --git a/gio/gfile.c b/gio/gfile.c
index 2b7d285f0..52eb6df32 100644
--- a/gio/gfile.c
+++ b/gio/gfile.c
@@ -2705,6 +2705,9 @@ g_file_move (GFile                  *source,
  * @error to %G_IO_ERROR_NOT_FOUND. If the file system doesn't support creating
  * directories, this function will fail, setting @error to 
  * %G_IO_ERROR_NOT_SUPPORTED.
+ *
+ * For a local #GFile the newly created directory will have the default
+ * (current) ownership and permissions of the current process.
  * 
  * If @cancellable is not %NULL, then the operation can be cancelled by
  * triggering the cancellable object from another thread. If the operation
@@ -2747,6 +2750,9 @@ g_file_make_directory (GFile         *file,
  * 'mkdir -p'. If the file system does not support creating directories, this
  * function will fail, setting @error to %G_IO_ERROR_NOT_SUPPORTED.
  * 
+ * For a local #GFile the newly created directories will have the default
+ * (current) ownership and permissions of the current process.
+ * 
  * 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.