From f393e805874db16334c5c4f4aa7fa1c73964ca34 Mon Sep 17 00:00:00 2001
From: Dan Winship <danw@gnome.org>
Date: Tue, 8 Sep 2009 11:19:13 -0400
Subject: [PATCH] Clarify g_ptr_array_set_size() docs re: free_func

---
 docs/reference/glib/tmpl/arrays_pointer.sgml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/docs/reference/glib/tmpl/arrays_pointer.sgml b/docs/reference/glib/tmpl/arrays_pointer.sgml
index 07c4569..6cf53bc 100644
--- a/docs/reference/glib/tmpl/arrays_pointer.sgml
+++ b/docs/reference/glib/tmpl/arrays_pointer.sgml
@@ -252,8 +252,11 @@ the array.
 
 <!-- ##### FUNCTION g_ptr_array_set_size ##### -->
 <para>
-Sets the size of the array, expanding it if necessary.
-New elements are set to %NULL.
+Sets the size of the array. When making the array larger, newly-added
+elements will be set to %NULL. When making it smaller, if @array has a
+non-%NULL #GDestroyNotify function then it will be called for the
+removed elements.
+
 </para>
 
 @array: a #GPtrArray.
-- 
2.7.4