diff --git a/gio/ChangeLog b/gio/ChangeLog
index 064f4a40d..e2229a5a8 100644
--- a/gio/ChangeLog
+++ b/gio/ChangeLog
@@ -1,3 +1,10 @@
+2008-06-30  Matthias Clasen  <mclasen@redhat.com>
+
+	Bug 540331 – g_file_append_to () documentation: can return NULL
+
+	* gfile.c (g_file_append_to): Clarify docs.
+	Patch by Jared Moore
+
 2008-06-30  Matthias Clasen  <mclasen@redhat.com>
 
 	Bug 539090 – g_content_type_from_mime_type() should unalias
diff --git a/gio/gfile.c b/gio/gfile.c
index 498d3379a..4194f6c60 100644
--- a/gio/gfile.c
+++ b/gio/gfile.c
@@ -1427,12 +1427,12 @@ g_file_read (GFile         *file,
  * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. 
  *
  * Some file systems don't allow all file names, and may
- * return an G_IO_ERROR_INVALID_FILENAME error.
- * If the file is a directory the G_IO_ERROR_IS_DIRECTORY error will be
+ * return an %G_IO_ERROR_INVALID_FILENAME error.
+ * If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will be
  * returned. Other errors are possible too, and depend on what kind of
  * filesystem the file is on.
  * 
- * Returns: a #GFileOutputStream.
+ * Returns: a #GFileOutputStream, or %NULL on error
  **/
 GFileOutputStream *
 g_file_append_to (GFile             *file,