From bc492eb83d6c4ad51ea0dffbf8aa6b57990f2916 Mon Sep 17 00:00:00 2001
From: David King <amigadave@amigadave.com>
Date: Fri, 17 Feb 2012 15:34:26 +0000
Subject: [PATCH] docs: Improve g_fopen description for Win32

https://bugzilla.gnome.org/show_bug.cgi?id=572466
---
 glib/gstdio.c | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/glib/gstdio.c b/glib/gstdio.c
index 71431f1fe..4317bccdd 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
  *