From 22841e0c11a12916a82ebd17ef0571e264b41661 Mon Sep 17 00:00:00 2001
From: Daniel Juyung Seo <seojuyung@gmail.com>
Date: Thu, 18 Apr 2013 02:50:39 +0900
Subject: [PATCH] elm_list.h: added documentations for label parameter of item
 insertion.

The label parameter is copied inside the list. So if an application dynamically
allocated the label, the application should free the label after tem insertion
call.
---
 legacy/elementary/src/lib/elm_list.h | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/legacy/elementary/src/lib/elm_list.h b/legacy/elementary/src/lib/elm_list.h
index cf517c05ce..e5f5e4a197 100644
--- a/legacy/elementary/src/lib/elm_list.h
+++ b/legacy/elementary/src/lib/elm_list.h
@@ -667,6 +667,10 @@ EAPI Elm_Object_Select_Mode       elm_list_select_mode_get(const Evas_Object *ob
  * If such function isn't needed, just passing
  * @c NULL as @p func is enough. The same should be done for @p data.
  *
+ * @note Remember that the label parameter is copied inside the list. So if an
+ * application dynamically allocated the label, the application should free the
+ * label after this call.
+ *
  * Simple example (with no function callback or data associated):
  * @code
  * li = elm_list_add(win);
@@ -718,6 +722,10 @@ EAPI Elm_Object_Item               *elm_list_item_append(Evas_Object *obj, const
  * If such function isn't needed, just passing
  * @c NULL as @p func is enough. The same should be done for @p data.
  *
+ * @note Remember that the label parameter is copied inside the list. So if an
+ * application dynamically allocated the label, the application should free the
+ * label after this call.
+ *
  * @see elm_list_item_append() for a simple code example.
  * @see elm_list_select_mode_set()
  * @see elm_object_item_del()
@@ -760,6 +768,10 @@ EAPI Elm_Object_Item               *elm_list_item_prepend(Evas_Object *obj, cons
  * If such function isn't needed, just passing
  * @c NULL as @p func is enough. The same should be done for @p data.
  *
+ * @note Remember that the label parameter is copied inside the list. So if an
+ * application dynamically allocated the label, the application should free the
+ * label after this call.
+ *
  * @see elm_list_item_append() for a simple code example.
  * @see elm_list_select_mode_set()
  * @see elm_object_item_del()
@@ -802,6 +814,10 @@ EAPI Elm_Object_Item               *elm_list_item_insert_before(Evas_Object *obj
  * If such function isn't needed, just passing
  * @c NULL as @p func is enough. The same should be done for @p data.
  *
+ * @note Remember that the label parameter is copied inside the list. So if an
+ * application dynamically allocated the label, the application should free the
+ * label after this call.
+ *
  * @see elm_list_item_append() for a simple code example.
  * @see elm_list_select_mode_set()
  * @see elm_object_item_del()
@@ -852,6 +868,10 @@ EAPI Elm_Object_Item               *elm_list_item_insert_after(Evas_Object *obj,
  * If such function isn't needed, just passing
  * @c NULL as @p func is enough. The same should be done for @p data.
  *
+ * @note Remember that the label parameter is copied inside the list. So if an
+ * application dynamically allocated the label, the application should free the
+ * label after this call.
+ *
  * @see elm_list_item_append() for a simple code example.
  * @see elm_list_select_mode_set()
  * @see elm_object_item_del()