Document that the mode argument is ignored on Windows (g_stat): Document

2007-04-27  Tor Lillqvist  <tml@novell.com>

	* glib/gstdio.c (g_mkdir): Document that the mode argument is
	ignored on Windows
	(g_stat): Document that st_mode is mostly useless on Windows.

svn path=/trunk/; revision=5463

diff --git a/ChangeLog b/ChangeLog
index af364c9..44f112e 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2007-04-27  Tor Lillqvist  <tml@novell.com>
+
+       * glib/gstdio.c (g_mkdir): Document that the mode argument is
+       ignored on Windows
+       (g_stat): Document that st_mode is mostly useless on Windows.
+
 2007-04-25  Paolo Borelli  <pborelli@katamail.com>
 
        * glib/gstrfuncs.c (g_strsplit): small cleanup. (#433387)

diff --git a/glib/gstdio.c b/glib/gstdio.c
index a9dc98b..f76e6aa 100644 (file)
--- a/glib/gstdio.c
+++ b/glib/gstdio.c
@@ -316,6 +316,7 @@ g_rename (const gchar *oldfilename,
  *
  * A wrapper for the POSIX mkdir() function. The mkdir() function 
  * attempts to create a directory with the given name and permissions.
+ * The mode argument is ignored on Windows.
  * 
  * See the C library manual for more details about mkdir().
  *
@@ -396,8 +397,11 @@ g_chdir (const gchar *path)
  * @buf: a pointer to a <structname>stat</structname> struct, which
  *    will be filled with the file information
  *
- * A wrapper for the POSIX stat() function. The stat() function 
- * returns information about a file.
+ * A wrapper for the POSIX stat() function. The stat() function
+ * returns information about a file. On Windows the stat() function in
+ * the C library checks only the READONLY attribute and does not look
+ * at the ACL at all. Thus the protection bits in the st_mode field
+ * are a fabrication of little use.
  * 
  * See the C library manual for more details about stat().
  *