diff --git a/README b/README
index 775343e5d..f7f263887 100644
--- a/README
+++ b/README
@@ -132,6 +132,9 @@ wanting to port to newer releases (See NEWS for general new feature info).
 Release Notes for Clutter 0.4.0
 -------------------------------
 
+* clutter_actor_show_all does not recurse for groups at least (this is to
+  match the original group_show_all behaviour)
+
 * FIXME
 
 Release Notes for Clutter 0.3.1
diff --git a/clutter/clutter-actor.c b/clutter/clutter-actor.c
index a20fbbcc0..b5c8d61c9 100644
--- a/clutter/clutter-actor.c
+++ b/clutter/clutter-actor.c
@@ -153,8 +153,7 @@ clutter_actor_show (ClutterActor *self)
  * clutter_actor_show_all:
  * @self: a #ClutterActor
  *
- * Recursively show an actor, and any child actor if @self has
- * child actors.
+ * Call show() on all children of a actor (if any).   
  *
  * Since: 0.2
  */
@@ -205,8 +204,7 @@ clutter_actor_hide (ClutterActor *self)
  * clutter_actor_hide_all:
  * @self: a #ClutterActor
  *
- * Recursively hides an actor, and any child actor if @self
- * has child actors.
+ * Call hide() on all child actors (if any).
  *
  * Since: 0.2
  */