[clutter] grid-layout: Clarify the scope of the orientation property

[Emmanuele Bassi <ebassi src gnome org>]

commit dbec3be99686685dfb704cba468cb807a8b5760d
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Fri Sep 4 13:53:04 2015 +0100

    grid-layout: Clarify the scope of the orientation property
    
    Just like GtkGrid, changing the orientation of a ClutterGridLayout does
    not change the existing layout; the orientation property is only used as
    a hint when adding new children.

 clutter/clutter-grid-layout.c |    7 ++++++-
 1 files changed, 6 insertions(+), 1 deletions(-)
---
diff --git a/clutter/clutter-grid-layout.c b/clutter/clutter-grid-layout.c
index f39e58d..f7b8f9e 100644
--- a/clutter/clutter-grid-layout.c
+++ b/clutter/clutter-grid-layout.c
@@ -1749,7 +1749,12 @@ clutter_grid_layout_attach_next_to (ClutterGridLayout   *layout,
  * @layout: a #ClutterGridLayout
  * @orientation: the orientation of the #ClutterGridLayout
  *
- * Sets the orientation of the @layout
+ * Sets the orientation of the @layout.
+ *
+ * #ClutterGridLayout uses the orientation as a hint when adding
+ * children to the #ClutterActor using it as a layout manager via
+ * clutter_actor_add_child(); changing this value will not have
+ * any effect on children that are already part of the layout.
  *
  * Since: 1.12
  */