Recommit the code which was removed by commit 3f4c3e03c600c87782543cf08de886016f2c192e

diff --git a/legacy/elementary/src/lib/elm_genlist.c b/legacy/elementary/src/lib/elm_genlist.c
index 9af7f22..7ea4558 100644 (file)
--- a/legacy/elementary/src/lib/elm_genlist.c
+++ b/legacy/elementary/src/lib/elm_genlist.c
@@ -3499,12 +3499,20 @@ _item_block_new(Elm_Genlist_Smart_Data *sd,
    return itb;
 }
 
+/**
+ * @internal
+ *
+ * This function adds an item to a block's item list. This may or may not
+ * rearrange existing blocks and create a new block.
+ *
+ */
 static Eina_Bool
 _item_block_add(Elm_Genlist_Smart_Data *sd,
                 Elm_Gen_Item *it)
 {
    Item_Block *itb = NULL;
 
+   // when a new item does not depend on another item
    if (!it->item->rel)
      {
 newblock:
@@ -3572,6 +3580,7 @@ newblock:
           }
         else
           {
+             // item move_before, prepend, insert_before, sorted_insert with before
              if (it->item->before)
                {
                   if (sd->blocks)
@@ -3592,6 +3601,7 @@ newblock:
 
                   _item_position_update(itb->items, 0);
                }
+             // item move_after, append, insert_after, sorted_insert without before
              else
                {
                   if (sd->blocks)
@@ -3613,6 +3623,7 @@ newblock:
                }
           }
      }
+   // when a new item depends on another item
    else
      {
         Eina_List *tmp;