[glib/wip/doc-fixes: 4/33] docs: Improve g_fopen description for Win32

[David King <davidk src gnome org>]

commit fb26543af43e023e84d19144905023b92ab12f02
Author: David King <amigadave amigadave com>
Date:   Fri Feb 17 15:34:26 2012 +0000

    docs: Improve g_fopen description for Win32
    
    https://bugzilla.gnome.org/show_bug.cgi?id=572466

 glib/gstdio.c |    7 +++++++
 1 files changed, 7 insertions(+), 0 deletions(-)
---
diff --git a/glib/gstdio.c b/glib/gstdio.c
index 1908918..9bc70e8 100644
--- a/glib/gstdio.c
+++ b/glib/gstdio.c
@@ -689,6 +689,13 @@ g_rmdir (const gchar *filename)
  *
  * See your C library manual for more details about fopen().
  *
+ * <note><para>
+ * As close() and fclose() are part of the C library, this implies that it is
+ * impossible to close a file if the application C library and the C library
+ * used by GLib are different. Convenience functions like g_file_set_contents()
+ * avoid this problem.
+ * </para></note>
+ *
  * Returns: A <type>FILE</type> pointer if the file was successfully
  *    opened, or %NULL if an error occurred
  *