diff --git a/ChangeLog b/ChangeLog
index b66b8153d..df1d6f20b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-01-18  Matthew Allum <mallum@openedhand.com>
+
+        * doc/reference/clutter-docs.sgml
+	Update.
+
 2007-01-18  Tomas Frydrych  <tf@openedhand.com>
 
 	* clutter/clutter-fixed.h: fixed a typo in comment
diff --git a/doc/reference/ChangeLog b/doc/reference/ChangeLog
index 9502fb103..199391b74 100644
--- a/doc/reference/ChangeLog
+++ b/doc/reference/ChangeLog
@@ -1,3 +1,16 @@
+2007-01-18  Matthew Allum  <mallum@openedhand.com>
+
+	reviewed by: <delete if not using a buddy>
+
+	* ChangeLog:
+	* clutter-docs.sgml:
+
+2007-01-18  Matthew Allum  <mallum@openedhand.com>
+
+	reviewed by: <delete if not using a buddy>
+
+	* clutter-docs.sgml:
+
 2007-01-18  Tomas Frydrych  <tf@openedhand.com>
 
 	* clutter-docs.sgml: added clutter-fixed
diff --git a/doc/reference/clutter-docs.sgml b/doc/reference/clutter-docs.sgml
index ab4c5e793..3cfa7219b 100644
--- a/doc/reference/clutter-docs.sgml
+++ b/doc/reference/clutter-docs.sgml
@@ -42,26 +42,24 @@
     <para>
 
     Clutter is a GObject based library for creating fast, visually
-    rich graphical user interfaces. It is intended for creating single
-    window stylised applications such as media box UI's, presentations
-    or kiosk style apps in preference to regular 'desktop' style
-    applications.
+    rich graphical user interfaces.
 
     </para>
     <para>
 
-    Clutter's underlying graphics rendering is OpenGL ( version 1.2+ )
-    based.  The clutter API is intended to be easy to use, attempting
-    to hide many of the GL complexities. It targets maily 2D based
-    graphics and is definetly not intended to be a general interface
-    for all OpenGL functionality ( yet ).
+    Clutter semantics work by having a stage (a window) and then
+    adding actors (widgets) to the stage and manipulating via the
+    actor api. Actors can contain child actors (ClutterGroup for
+    example) and be manipulated as a whole.
 
     </para>
     <para>
 
-    As well as OpenGL Clutter depends on and uses GLib, GObject,
-    GDKPixbuf and GStreamer. Clutter is released under the GNU Library
-    General Public License (GNU LGPL)
+    Animations and visual effects can be created via the use of
+    timelines and behaviours. Timelines provide accurate frame based
+    animations. Behaviours further extend this by taking a timeline, a
+    control function (ClutterAlpha) and then applying to actors as to
+    modify a property as a function of time.
 
     </para>
   </chapter>