diff --git a/ChangeLog b/ChangeLog
index f42a6e313..3b4cb22d8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-11-18  Matthias Clasen  <mclasen@redhat.com>
+
+	* glib/gbase64.c: Documentation improvements.  (#496518,
+	Stefan Schulze Frielinghaus)
+
 2007-11-18  Matthias Clasen  <mclasen@redhat.com>
 
 	* configure.in: Check whether assembler supports numerical local
diff --git a/glib/gbase64.c b/glib/gbase64.c
index f45df1e6c..344ce0b80 100644
--- a/glib/gbase64.c
+++ b/glib/gbase64.c
@@ -217,7 +217,8 @@ g_base64_encode_close (gboolean  break_lines,
  * representation.
  *
  * Return value: a newly allocated, zero-terminated Base-64 encoded
- *               string representing @data.
+ *               string representing @data. The returned string must 
+ *               be freed with g_free().
  *
  * Since: 2.12
  */
@@ -349,7 +350,8 @@ g_base64_decode_step (const gchar  *in,
  * Decode a sequence of Base-64 encoded text into binary data
  *
  * Return value: a newly allocated buffer containing the binary data
- *               that @text represents
+ *               that @text represents. The returned buffer must
+ *               be freed with g_free().
  *
  * Since: 2.12
  */