diff --git a/gobject/gvaluearray.c b/gobject/gvaluearray.c
index 553152d5a..83e03f7ec 100644
--- a/gobject/gvaluearray.c
+++ b/gobject/gvaluearray.c
@@ -55,6 +55,9 @@
  *   GArray *array = g_array_sized_new (FALSE, TRUE, sizeof (GValue), 10);
  *   g_array_set_clear_func (array, (GDestroyNotify) g_value_unset);
  * ]|
+ *
+ * Deprecated: 2.32: Use #GArray instead, if possible for the given use case,
+ *    as described above.
  */
 
 #define	GROUP_N_VALUES	(8)	/* power of 2 !! */