[glib/wip/doc-fixes: 1193/1200] docs: Improve g_fopen description for Win32

[David King <davidk src gnome org>]

commit bc492eb83d6c4ad51ea0dffbf8aa6b57990f2916
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 71431f1..4317bcc 100644
--- a/glib/gstdio.c
+++ b/glib/gstdio.c
@@ -694,6 +694,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
  *