diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 751177aeb..8027bef19 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2005-07-25  Matthias Clasen  <mclasen@redhat.com>
+
+	* glib/tmpl/arrays.sgml: Add some details.  (#311310,
+	Jochen Baier)
+
 2005-07-21  Matthias Clasen  <mclasen@redhat.com>
 
 	* === Released 2.7.4 ===
diff --git a/docs/reference/glib/tmpl/arrays.sgml b/docs/reference/glib/tmpl/arrays.sgml
index 47092c19d..427e9b1d1 100644
--- a/docs/reference/glib/tmpl/arrays.sgml
+++ b/docs/reference/glib/tmpl/arrays.sgml
@@ -287,7 +287,9 @@ If the array was created with @clear_ set to %TRUE, the new elements are set to
 <!-- ##### FUNCTION g_array_free ##### -->
 <para>
 Frees the memory allocated for the #GArray.
-If @free_segment is %TRUE it frees the actual element data as well.
+If @free_segment is %TRUE it frees the memory block holding the elements
+as well. Pass %FALSE if you want to free the #GArray wrapper but preserve
+the underlying array for use elsewhere.
 </para>
 
 @array: a #GArray.