diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 0534e7b31..d94e07ba4 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,9 @@
+2005-12-07  Matthias Clasen  <mclasen@redhat.com>
+
+	* gobject/tmpl/gparamspec.sgml: 
+	* gobject/tmpl/gtype.sgml: Document n_preallocs as
+	ignored.
+
 2005-12-05  Matthias Clasen  <mclasen@redhat.com>
 
 	* glib/glib-sections.txt: Updates
diff --git a/docs/reference/gobject/tmpl/gparamspec.sgml b/docs/reference/gobject/tmpl/gparamspec.sgml
index c1b793bad..5370c8335 100644
--- a/docs/reference/gobject/tmpl/gparamspec.sgml
+++ b/docs/reference/gobject/tmpl/gparamspec.sgml
@@ -416,7 +416,7 @@ g_param_type_register_static().
 </para>
 
 @instance_size: Size of the instance (object) structure.
-@n_preallocs: Number of pre-allocated (cached) instances to reserve memory for (0 indicates no caching).
+@n_preallocs: Prior to GLib 2.10, it specified the number of pre-allocated (cached) instances to reserve memory for (0 indicates no caching). Since GLib 2.10, it is ignored, since instances are allocated with the <link linkend="glib-Memory-Slices">slice allocator</link> now.
 @instance_init: Location of the instance initialization function (optional).
 @value_type: The #GType of values conforming to this #GParamSpec
 @finalize: The instance finalization function (optional).
diff --git a/docs/reference/gobject/tmpl/gtype.sgml b/docs/reference/gobject/tmpl/gtype.sgml
index 1688e62a7..bdcdde2ff 100644
--- a/docs/reference/gobject/tmpl/gtype.sgml
+++ b/docs/reference/gobject/tmpl/gtype.sgml
@@ -221,7 +221,7 @@ across invocation of g_type_register_static().
   function for interface types. (optional)
 @class_data: 	 User-supplied data passed to the class init/finalize functions.
 @instance_size:  Size of the instance (object) structure (required for instantiatable types only).
-@n_preallocs: 	 Number of pre-allocated (cached) instances to reserve memory for (0 indicates no caching).
+@n_preallocs: 	 Prior to GLib 2.10, it specified the number of pre-allocated (cached) instances to reserve memory for (0 indicates no caching). Since GLib 2.10, it is ignored, since instances are allocated with the <link linkend="glib-Memory-Slices">slice allocator</link> now.
 @instance_init:  Location of the instance initialization function (optional, for instantiatable types only).
 @value_table: 	 A #GTypeValueTable function table for generic handling of GValues of this type (usually only
 		 useful for fundamental types).