diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 8027bef19..a8d3ec4d9 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,7 @@
+2005-07-26  Matthias Clasen  <mclasen@redhat.com>
+
+	* glib/tmpl/arrays.sgml: One more improvement.
+
 2005-07-25  Matthias Clasen  <mclasen@redhat.com>
 
 	* glib/tmpl/arrays.sgml: Add some details.  (#311310,
diff --git a/docs/reference/glib/tmpl/arrays.sgml b/docs/reference/glib/tmpl/arrays.sgml
index 427e9b1d1..4ed62071f 100644
--- a/docs/reference/glib/tmpl/arrays.sgml
+++ b/docs/reference/glib/tmpl/arrays.sgml
@@ -291,6 +291,12 @@ 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>
+<note>
+<para>
+If array elements contain dynamically-allocated memory, they should be freed
+first.
+</para>
+</note>
 
 @array: a #GArray.
 @free_segment: if %TRUE the actual element data is freed as well.