diff --git a/ChangeLog b/ChangeLog
index d3abc828e..ee714a4d0 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2008-09-23  Emmanuele Bassi  <ebassi@linux.intel.com>
+
+	* clutter/clutter-timeout-pool.c: Reword previous commit.
+
 2008-09-23  Emmanuele Bassi  <ebassi@linux.intel.com>
 
 	* clutter/clutter-timeout-pool.c:
diff --git a/clutter/clutter-timeout-pool.c b/clutter/clutter-timeout-pool.c
index 560ff4ff7..2d367d433 100644
--- a/clutter/clutter-timeout-pool.c
+++ b/clutter/clutter-timeout-pool.c
@@ -422,9 +422,13 @@ clutter_timeout_pool_finalize (GSource *source)
  * Inside Clutter, every #ClutterTimeline share the same timeout pool, unless
  * the CLUTTER_TIMELINE=no-pool environment variable is set.
  *
+ * #ClutterTimeoutPool is part of the #ClutterTimeline implementation
+ * and should not be used by application developers.
+ *
  * Return value: the newly created #ClutterTimeoutPool. The created pool
- *   is owned by the GLib default context and should not be unreferenced
- *   or freed
+ *   is owned by the GLib default context and will be automatically
+ *   destroyed when the context is destroyed. It is possible to force
+ *   the destruction of the timeout pool using g_source_destroy()
  *
  * Since: 0.4
  */