efl_ui/box_flow: Improve docs a bit further

1 files changed, 7 insertions, 5 deletions

diff --git a/src/lib/elementary/efl_ui_box_flow.eo b/src/lib/elementary/efl_ui_box_flow.eo
index cbd0777703..7e4f6f5552 100644
--- a/src/lib/elementary/efl_ui_box_flow.eo
+++ b/src/lib/elementary/efl_ui_box_flow.eo
@@ -1,10 +1,12 @@
 class @beta Efl.Ui.Box_Flow extends Efl.Ui.Box
 {
-   [[A Flow Box is a customized type of @Efl.Ui.Box. It will fill along the given axis
-     until items will no longer fit in the available space, at which point it will begin
-     filling items in a new row/column after the current one. This is useful if an application
-     wants to e.g., present a group of items and wrap them onto subsequent lines when the number
-     of items grows too large to fit on the screen.
+   [[A Flow Box is a customized type of @Efl.Ui.Box. It will fill along the axis selected with
+     @Efl.Ui.Layout_Orientable.orientation (which defaults to Horizontal), until items will no
+     longer fit in the available space, at which point it will begin filling items in a new
+     row/column after the current one.
+     This is useful if an application wants to e.g., present a group of items and wrap them onto
+     subsequent lines when the number of items grows too large to fit on the screen.
+     Adding or removing items in the middle re-arrange the rest of the items as expected.
    ]]
    implements {
       Efl.Pack_Layout.layout_update;