widget: Add/Fix internal documentations.

diff --git a/src/lib/elm_panel.c b/src/lib/elm_panel.c
index 21c5484..ebe43c9 100644 (file)
--- a/src/lib/elm_panel.c
+++ b/src/lib/elm_panel.c
@@ -1005,7 +1005,7 @@ _elm_panel_evas_object_smart_del(Eo *obj, Elm_Panel_Data *sd)
 
    ELM_SAFE_FREE(sd->timer, ecore_timer_del);
 
-   /* let's make our box object the *last* to be processed, since it
+   /* let's make our panel object the *last* to be processed, since it
     * may (smart) parent other sub objects here */
    EINA_LIST_FOREACH(wd->subobjs, l, child)
      {

diff --git a/src/lib/elm_widget.h b/src/lib/elm_widget.h
index ff53d61..520b642 100644 (file)
--- a/src/lib/elm_widget.h
+++ b/src/lib/elm_widget.h
@@ -370,12 +370,12 @@ typedef struct _Elm_Widget_Smart_Class
  */
 typedef struct _Elm_Widget_Smart_Data
 {
-   Evas_Object                  *obj;
-   Evas_Object                  *parent_obj;
-   Evas_Object                  *parent2;
+   Evas_Object                  *obj; /**< object pointer for this widget smart data */
+   Evas_Object                  *parent_obj; /**< parent object of a widget in the elementary tree */
+   Evas_Object                  *parent2; /**< parent object for an inlined window */
    Evas_Coord                    x, y, w, h;
-   Eina_List                    *subobjs;
-   Evas_Object                  *resize_obj;
+   Eina_List                    *subobjs; /**< list of widgets' sub objects in the elementary tree */
+   Evas_Object                  *resize_obj; /**< an unique object for each widget that shows the look of a widget. Resize object's geometry is same as the widget. This resize object is different from that of window's resize object. */
    Evas_Object                  *hover_obj;
    Eina_List                    *tooltips, *cursors;
    Evas_Object                  *focus_previous, *focus_next;