Evas.SmartObject: Add more docs to move_children_relative()

1 files changed, 13 insertions, 1 deletions

diff --git a/efl/evas/efl.evas_object_smart.pxi b/efl/evas/efl.evas_object_smart.pxi
index 3014e08..c6287c9 100644
--- a/efl/evas/efl.evas_object_smart.pxi
+++ b/efl/evas/efl.evas_object_smart.pxi
@@ -769,7 +769,19 @@ cdef class SmartObject(Object):
         return self.smart
 
     def move_children_relative(self, int dx, int dy):
-        """Move all children relatively."""
+        """Moves all children objects relative to a given offset.
+
+        This will make each of object's children to move, from where
+        they before, with those delta values (offsets) on both directions.
+
+        .. note:: This is most useful on custom :func:`Smart.move` functions.
+
+        .. note:: Clipped smart objects already make use of this function on
+            their :func:`Smart.move` function definition.
+
+        :param dx: horizontal offset (delta).
+        :param dy: vertical offset (delta).
+        """
         evas_object_smart_move_children_relative(self.obj, dx, dy)
 
     def changed(self):