Added comment for data files and added comment skeleton for util and widget files 17/151617/2 tizen_4.0 submit/tizen_4.0/20170926.130622 submit/tizen_4.0/20170927.093649 submit/tizen_4.0/20171025.043257 tizen_4.0.IoT.p2_release
authorShubham Kumar <shubham.srib@samsung.com>
Thu, 21 Sep 2017 08:58:47 +0000 (14:28 +0530)
committerShubham Kumar <shubham.srib@samsung.com>
Thu, 21 Sep 2017 09:09:15 +0000 (14:39 +0530)
Change-Id: I86b271106d2a89fd74d1cad5e175aaf516aac3ce
Signed-off-by: Shubham Kumar <shubham.srib@samsung.com>
30 files changed:
src/data/gl-data-type.c
src/data/gl-data-util.c
src/data/gl-data.c
src/data/gl-local-data.c
src/features/gl-entry.c
src/features/gl-main.c
src/features/gl-pinchzoom.c
src/gallery.c
src/util/gl-db-update.c
src/util/gl-ext-ug-load.c
src/util/gl-file-util.c
src/util/gl-fs.c
src/util/gl-lang.c
src/util/gl-thread-util.c
src/util/gl-ui-util.c
src/util/gl-util.c
src/widget/gl-button.c
src/widget/gl-controlbar.c
src/widget/gl-ctxpopup.c
src/widget/gl-editfield.c
src/widget/gl-gesture.c
src/widget/gl-nocontents.c
src/widget/gl-notify.c
src/widget/gl-popup.c
src/widget/gl-progressbar.c
src/widget/gl-rotate-bg.c
src/widget/gl-thumb.c
src/widget/gl-tile.c
widget/src/gl_widget_create.c
widget/src/gl_widget_main.c

index e852d33..2053ca7 100644 (file)
 #include "gl-data-type.h"
 #include "gl-debug.h"
 
+/**
+ * Create new media album data
+ * @param album : media album data pointer
+ * @return
+ */
 int _gl_data_type_new_album(gl_album_s ** album)
 {
        GL_CHECK_VAL(album, -1);
@@ -27,7 +32,11 @@ int _gl_data_type_new_album(gl_album_s ** album)
        return 0;
 }
 
-
+/**
+ * free media item data
+ * @param item : media item data
+ * @return
+ */
 static int __gl_data_type_free_media(gl_media_s ** item)
 {
        GL_CHECK_VAL(item, -1);
@@ -77,6 +86,11 @@ static int __gl_data_type_free_media(gl_media_s ** item)
        return 0;
 }
 
+/**
+ * free media album data
+ * @param album : media album data
+ * @return
+ */
 static int __gl_data_type_free_album(gl_album_s ** album)
 {
        GL_CHECK_VAL(album, -1);
@@ -95,6 +109,11 @@ static int __gl_data_type_free_album(gl_album_s ** album)
        return 0;
 }
 
+/**
+ * free media item data
+ * @param item : media item data
+ * @return
+ */
 int _gl_data_type_free_glitem(void **item)
 {
        GL_CHECK_VAL(item, -1);
index baa48f5..fcc223d 100644 (file)
 #include "gl-debug.h"
 #include "gl-strings.h"
 
+/**
+ * gets the file dir name from file path
+ * @param file_path : file path
+ * @param filename : file name
+ * @param dir_name : dir name
+ * @param dir_path : dir path
+ * @return
+ */
 bool _gl_data_util_get_file_dir_name(const char *file_path, char *filename,
                                                                         char *dir_name, char *dir_path)
 {
@@ -61,9 +69,10 @@ bool _gl_data_util_get_file_dir_name(const char *file_path, char *filename,
        return false;
 }
 
-/*
-*  create a gl_item
-*/
+/**
+ * create a gl_item
+ * @return
+ */
 gl_item *_gl_data_util_calloc_gitem(void)
 {
        gl_item *gitem = (gl_item *) calloc(1, sizeof(gl_item));
@@ -71,6 +80,11 @@ gl_item *_gl_data_util_calloc_gitem(void)
        return gitem;
 }
 
+/**
+ * free media item data
+ * @param gitem
+ * @return
+ */
 int _gl_data_util_free_gitem(gl_item * gitem)
 {
        GL_CHECK_VAL(gitem, -1);
@@ -84,6 +98,10 @@ int _gl_data_util_free_gitem(gl_item * gitem)
        return 0;
 }
 
+/**
+ * create memory for media album data
+ * @return
+ */
 gl_cluster *_gl_data_util_calloc_gcluster(void)
 {
        gl_cluster *gcluster = (gl_cluster *) calloc(1, sizeof(gl_cluster));
@@ -91,6 +109,11 @@ gl_cluster *_gl_data_util_calloc_gcluster(void)
        return gcluster;
 }
 
+/**
+ * free media album data
+ * @param gcluster : media album data
+ * @return
+ */
 int _gl_data_util_free_gcluster(gl_cluster * gcluster)
 {
        GL_CHECK_VAL(gcluster, -1);
@@ -107,6 +130,12 @@ int _gl_data_util_free_gcluster(gl_cluster * gcluster)
        return 0;
 }
 
+/**
+ * create fav media labum
+ * @param data : App data
+ * @param count : fav media count
+ * @return
+ */
 gl_cluster *_gl_data_util_new_gcluster_fav(void *data, int count)
 {
        gl_dbg("");
@@ -132,6 +161,10 @@ gl_cluster *_gl_data_util_new_gcluster_fav(void *data, int count)
        return gcluster;
 }
 
+/**
+ * create memory for media album data list
+ * @return
+ */
 gl_cluster_list *_gl_data_util_calloc_cluster_list(void)
 {
        gl_cluster_list *clus_list = (gl_cluster_list *) calloc(1,
@@ -141,7 +174,11 @@ gl_cluster_list *_gl_data_util_calloc_cluster_list(void)
        return clus_list;
 }
 
-/* Clear eina_list got from DB */
+/**
+ * Clear eina_list got from DB
+ * @param elist : list
+ * @return
+ */
 int _gl_data_util_clear_gtype_item_list(Eina_List ** elist)
 {
        void *current = NULL;
@@ -160,6 +197,11 @@ int _gl_data_util_clear_gtype_item_list(Eina_List ** elist)
        return 0;
 }
 
+/**
+ * clear media item lisr
+ * @param elist : list
+ * @return
+ */
 int _gl_data_util_clear_item_list(Eina_List ** elist)
 {
        GL_CHECK_VAL(elist, -1);
@@ -176,6 +218,11 @@ int _gl_data_util_clear_item_list(Eina_List ** elist)
 
 }
 
+/**
+ * clear media album data list
+ * @param elist : list
+ * @return
+ */
 int _gl_data_util_clear_cluster_list(Eina_List ** elist)
 {
        GL_CHECK_VAL(elist, -1);
@@ -190,6 +237,12 @@ int _gl_data_util_clear_cluster_list(Eina_List ** elist)
        return 0;
 }
 
+/**
+ * get selected media album id in edit view
+ * @param data : App data
+ * @param sel_id_list : selected media labum data list
+ * @return
+ */
 int _gl_data_util_get_selected_cluster_id_list(void *data,
                                                                                           Eina_List ** sel_id_list)
 {
@@ -211,6 +264,12 @@ int _gl_data_util_get_selected_cluster_id_list(void *data,
        return 0;
 }
 
+/**
+ * get list of selected media item
+ * @param sel_list : selected list
+ * @param elist : new list
+ * @return
+ */
 int _gl_data_util_get_selected_str_ids(Eina_List ** sel_list,
                                                                           Eina_List ** elist)
 {
@@ -230,6 +289,12 @@ int _gl_data_util_get_selected_str_ids(Eina_List ** sel_list,
        return 0;
 }
 
+/**
+ * create the list containing the id of selected media item data in edit view
+ * @param sel_list : selected list
+ * @param elist : list contains id of selected media item data
+ * @return
+ */
 int _gl_data_util_filter_selected_str_ids(Eina_List ** sel_list,
                                                                                  Eina_List ** elist)
 {
@@ -249,7 +314,12 @@ int _gl_data_util_filter_selected_str_ids(Eina_List ** sel_list,
        return 0;
 }
 
-/* Check ID is in the list or not */
+/**
+ * Check ID is in the list or not
+ * @param sel_id_list : selected id list
+ * @param id : id to be checked
+ * @return
+ */
 bool _gl_data_util_check_selected_str_id(Eina_List ** sel_id_list,
                                                                                 const char *id)
 {
@@ -281,7 +351,11 @@ bool _gl_data_util_check_selected_str_id(Eina_List ** sel_id_list,
        return false;
 }
 
-/* Free list of selected IDs */
+/**
+ * Free list of selected IDs
+ * @param sel_id_list : list of selected ids
+ * @return
+ */
 int _gl_data_util_free_selected_str_list(Eina_List ** sel_id_list)
 {
        GL_CHECK_VAL(sel_id_list, -1);
@@ -302,6 +376,14 @@ int _gl_data_util_free_selected_str_list(Eina_List ** sel_id_list)
        return 0;
 }
 
+/**
+ * get the count of media in different category
+ * @param album : media album data
+ * @param img_cnt : images count
+ * @param sel_cnt : selected image count
+ * @param web_cnt : web image count
+ * @return
+ */
 int _gl_data_util_check_album_selected_files(gl_cluster * album,
                                                                                         int *img_cnt, int *sel_cnt,
                                                                                         int *web_cnt)
@@ -374,8 +456,11 @@ int _gl_data_util_check_album_selected_files(gl_cluster * album,
        return 0;
 }
 
-/* Set viewby_m as -1 or GL_VIEW_BY_NUM to get cond view default viewby mode
+/**
+ * Set viewby_m as -1 or GL_VIEW_BY_NUM to get cond view default viewby mode
  * @cond is allocated by caller, maybe it's an array
+ * @param cond : condition
+ * @return
  */
 int _gl_data_util_get_cond(char *cond)
 {
@@ -384,6 +469,11 @@ int _gl_data_util_get_cond(char *cond)
        return 0;
 }
 
+/**
+ * create filter condition for fav media
+ * @param cond  :fav media condition
+ * @return
+ */
 int _gl_data_util_get_fav_cond(char *cond)
 {
        GL_CHECK_VAL(cond, -1);
index 8d7ddb8..2e84730 100644 (file)
 #include "gl-db-update.h"
 #include "gl-file-util.h"
 
+/**
+ * Append the album cluster to the list
+ * @param data : App data
+ * @param elist : temp list which contains the media album cluster
+ * @param store_type : storage type
+ * @param p_elist : einal list to hold the media folders
+ * @return
+ */
 static int __gl_data_append_gitems(void *data, Eina_List * elist,
                                                                   int store_type, Eina_List ** p_elist)
 {
@@ -54,6 +62,11 @@ static int __gl_data_append_gitems(void *data, Eina_List * elist,
        return 0;
 }
 
+/**
+ * Gets the number for Fav images in device
+ * @param count : cfav image count
+ * @return
+ */
 int _gl_get_fav_image_count(int *count)
 {
        gl_filter_s filter;
@@ -75,6 +88,12 @@ int _gl_get_fav_image_count(int *count)
        return err;
 }
 
+/**
+ * get the media album list and arrange them based of display order
+ * @param data : App data
+ * @param b_update : update flag
+ * @return
+ */
 static int __gl_data_get_cluster_list(void *data, bool b_update)
 {
        GL_PROFILE_IN;
@@ -250,19 +269,22 @@ static int __gl_data_get_cluster_list(void *data, bool b_update)
                                        ad->albuminfo.elist->clist =
                                                        eina_list_prepend(ad->albuminfo.elist->clist,
                                                                        gcluster);
+                                       default_album = gcluster;
                                }
                        } else
                                if (_gl_data_is_default_album(GL_STR_ALBUM_DOWNLOADS, f_data)
                                                || _gl_data_is_screenshot_album(GL_STR_ALBUM_SCREENSHOTS,
                                                                f_data)) {
-                                       if (default_album)
+                                       if (default_album) {
                                                ad->albuminfo.elist->clist =
                                                                eina_list_append_relative(ad->albuminfo.elist->clist,
                                                                                gcluster, default_album);
-                                       else
+                                       } else {
                                                ad->albuminfo.elist->clist =
                                                                eina_list_prepend(ad->albuminfo.elist->clist,
                                                                                gcluster);
+                                               default_album = gcluster;
+                                       }
                                } else {
                                        ad->albuminfo.elist->clist =
                                                        eina_list_append(ad->albuminfo.elist->clist, gcluster);
@@ -344,9 +366,12 @@ static int __gl_data_get_cluster_list(void *data, bool b_update)
        return length;
 }
 
-/*
-*   Check it's default album under root path
-*/
+/**
+ * Check it's default album under root path
+ * @param match_folder : path to be checked
+ * @param album : Album data
+ * @return
+ */
 bool _gl_data_is_default_album(const char *match_folder,
                                                           gl_album_s * album)
 {
@@ -379,9 +404,12 @@ bool _gl_data_is_default_album(const char *match_folder,
        return false;
 }
 
-/*
-*   Check it's screenshot album under Image path
-*/
+/**
+ * Check it's screenshot album under Image path
+ * @param match_folder : album path
+ * @param album : apbum data
+ * @return
+ */
 bool _gl_data_is_screenshot_album(const char *match_folder,
                                                                  gl_album_s * album)
 {
@@ -410,9 +438,11 @@ bool _gl_data_is_screenshot_album(const char *match_folder,
        return false;
 }
 
-/*
-*   Check it's default album camera
-*/
+/**
+ * Check it's default album camera
+ * @param album : album data
+ * @return
+ */
 bool _gl_data_is_camera_album(gl_album_s * album)
 {
        GL_CHECK_FALSE(album);
@@ -438,6 +468,12 @@ bool _gl_data_is_camera_album(gl_album_s * album)
        return false;
 }
 
+/**
+ * clear the media album data list
+ * @param data : App data
+ * @param b_force : flag
+ * @return
+ */
 int _gl_data_clear_cluster_list(void *data, bool b_force)
 {
        GL_CHECK_VAL(data, -1);
@@ -454,6 +490,14 @@ int _gl_data_clear_cluster_list(void *data, bool b_force)
        return 0;
 }
 
+/**
+ * Copy the media album list to different
+ * list in case of update in edit mode
+ * @param data : App data
+ * @param b_force : flag
+ * @param list : new temp list
+ * @return
+ */
 int _gl_data_copy_cluster_list(void *data, bool b_force, Eina_List ** list)
 {
        GL_CHECK_VAL(data, -1);
@@ -480,6 +524,11 @@ int _gl_data_copy_cluster_list(void *data, bool b_force, Eina_List ** list)
        return 0;
 }
 
+/**
+ * get media album cluser list
+ * @param data : App data
+ * @return
+ */
 bool _gl_data_get_cluster_list(void *data)
 {
        GL_PROFILE_IN;
@@ -503,6 +552,12 @@ bool _gl_data_get_cluster_list(void *data)
        return true;
 }
 
+/**
+ * Update the selected album data in case
+ * of update in edit mode to updated list
+ * @param data : App data
+ * @param list : temp list
+ */
 void _gl_update_album_selected_data(void *data, Eina_List ** list)
 {
        GL_CHECK(data);
@@ -541,6 +596,11 @@ void _gl_update_album_selected_data(void *data, Eina_List ** list)
        }
 }
 
+/**
+ * get the updated media album list in case of edit mode
+ * @param data : App data
+ * @return
+ */
 bool _gl_data_get_cluster_list_edit_mode(void *data)
 {
        GL_PROFILE_IN;
@@ -566,6 +626,13 @@ bool _gl_data_get_cluster_list_edit_mode(void *data)
        return true;
 }
 
+/**
+ * Get the media album data by album id
+ * @param data : App data
+ * @param cluster_id : ambul id
+ * @param cluster : album data
+ * @return
+ */
 int _gl_data_get_cluster_by_id(void *data, const char *cluster_id,
                                                           gl_cluster ** cluster)
 {
@@ -600,6 +667,13 @@ int _gl_data_get_cluster_by_id(void *data, const char *cluster_id,
        return -1;
 }
 
+/**
+ * Get the media album data by album path
+ * @param data : App data
+ * @param path : album path
+ * @param cluster : empty album data structure
+ * @return
+ */
 int _gl_data_get_cluster_by_path(void *data, const char *path,
                                                                 gl_cluster ** cluster)
 {
@@ -634,9 +708,12 @@ int _gl_data_get_cluster_by_path(void *data, const char *path,
        return -1;
 }
 
-/*
-*   append album to selected_albums_elist
-*/
+/**
+ * append album to selected_albums_elist
+ * @param data : App data
+ * @param item : media album data
+ * @return
+ */
 int _gl_data_albums_selected_list_append(void *data, gl_cluster * item)
 {
        GL_CHECK_VAL(item, -1);
@@ -664,8 +741,12 @@ int _gl_data_albums_selected_list_append(void *data, gl_cluster * item)
 }
 
 /**
-* Get medias count of album
-*/
+ * Get medias count of album
+ * @param cluster_id : album id
+ * @param album_type : album type
+ * @param item_cnt : media count
+ * @return
+ */
 int _gl_data_get_item_cnt(const char *cluster_id, int album_type,
                                                  int *item_cnt)
 {
@@ -710,6 +791,13 @@ int _gl_data_get_item_cnt(const char *cluster_id, int album_type,
        return 0;
 }
 
+/**
+ * get the media items between range
+ * @param start_pos : start range
+ * @param end_pos : end range
+ * @param list : list
+ * @return
+ */
 int _gl_data_get_items(int start_pos, int end_pos, Eina_List ** list)
 {
        GL_CHECK_VAL(list, -1);
@@ -737,6 +825,15 @@ int _gl_data_get_items(int start_pos, int end_pos, Eina_List ** list)
        return err;
 }
 
+/**
+ * Get item from a particular album
+ * @param data : App data
+ * @param album : media album data
+ * @param start_pos : start range
+ * @param end_pos : end range
+ * @param p_elist : list
+ * @return
+ */
 int _gl_data_get_items_album(void *data, gl_cluster * album, int start_pos,
                                                         int end_pos, Eina_List ** p_elist)
 {
@@ -829,6 +926,13 @@ int _gl_data_get_items_album(void *data, gl_cluster * album, int start_pos,
        return err;
 }
 
+/**
+ * Update media item list
+ * @param data : App data
+ * @param sel_id_list : selected items list
+ * @param p_elist : item list
+ * @return
+ */
 int _gl_data_update_item_list(void *data, Eina_List ** sel_id_list,
                                                          Eina_List ** p_elist)
 {
@@ -948,6 +1052,13 @@ int _gl_data_update_item_list(void *data, Eina_List ** sel_id_list,
        return err;
 }
 
+/**
+ * Get the media album cover thumbnail
+ * @param album : media album id
+ * @param pgitem : album item
+ * @param sort_type : sort type flag
+ * @return
+ */
 int _gl_data_get_album_cover(gl_cluster * album, gl_item ** pgitem,
                                                         media_content_order_e sort_type)
 {
@@ -983,12 +1094,17 @@ int _gl_data_get_album_cover(gl_cluster * album, gl_item ** pgitem,
                        }
                        return -1;
                }
-
+               bool data_set = false;
                EINA_LIST_FREE(item_list, item) {
                        if (item == NULL) {
                                gl_dbgE("Invalid gl_media_s!");
                                return -1;
                        }
+                       if (data_set) {
+                               gl_dbgE("_gl_data_util_calloc_gitem failed!");
+                               _gl_data_type_free_glitem((void **) &item);
+                               continue;
+                       }
                        gitem = _gl_data_util_calloc_gitem();
                        if (gitem == NULL) {
                                gl_dbgE("_gl_data_util_calloc_gitem failed!");
@@ -998,7 +1114,7 @@ int _gl_data_get_album_cover(gl_cluster * album, gl_item ** pgitem,
                        gitem->item = item;
                        gitem->album = album;
                        *pgitem = gitem;
-                       break;
+                       data_set = true;
                }
        } else if (album->cluster->type == GL_STORE_T_ALL) {
                /* add "All" album */
@@ -1015,12 +1131,17 @@ int _gl_data_get_album_cover(gl_cluster * album, gl_item ** pgitem,
 
                        return -1;
                }
-
+               bool data_set = false;
                EINA_LIST_FREE(item_list, item) {
                        if (item == NULL) {
                                gl_dbgE("Invalid gl_media_s!");
                                return -1;
                        }
+                       if (data_set) {
+                               gl_dbgE("_gl_data_util_calloc_gitem failed!");
+                               _gl_data_type_free_glitem((void **) &item);
+                               continue;
+                       }
                        gitem = _gl_data_util_calloc_gitem();
                        if (gitem == NULL) {
                                gl_dbgE("_gl_data_util_calloc_gitem failed!");
@@ -1033,7 +1154,7 @@ int _gl_data_get_album_cover(gl_cluster * album, gl_item ** pgitem,
                        *pgitem = gitem;
                        /* Get latest item for saving lastest modified time */
                        ad->maininfo.last_mtime = item->mtime;
-                       break;
+                       data_set = true;
                }
        } else if (album->cluster->type == GL_STORE_T_FAV) {
                /* add "fav" album */
@@ -1058,12 +1179,17 @@ int _gl_data_get_album_cover(gl_cluster * album, gl_item ** pgitem,
                        }
                        return -1;
                }
-
+               bool data_set = false;
                EINA_LIST_FREE(item_list, item) {
                        if (item == NULL) {
                                gl_dbgE("Invalid gl_media_s!");
                                return -1;
                        }
+                       if (data_set) {
+                               gl_dbgE("_gl_data_util_calloc_gitem failed!");
+                               _gl_data_type_free_glitem((void **) &item);
+                               continue;
+                       }
                        gitem = _gl_data_util_calloc_gitem();
                        if (gitem == NULL) {
                                gl_dbgE("_gl_data_util_calloc_gitem failed!");
@@ -1074,7 +1200,7 @@ int _gl_data_get_album_cover(gl_cluster * album, gl_item ** pgitem,
                        gitem->album = album;
                        gitem->store_type = album->cluster->type;
                        *pgitem = gitem;
-                       break;
+                       data_set = true;
                }
        } else {
                gl_dbgE("Wrong cluster type!");
@@ -1087,7 +1213,13 @@ int _gl_data_get_album_cover(gl_cluster * album, gl_item ** pgitem,
        return 0;
 }
 
-/* Remove file from DB and file system */
+/**
+ * Remove file from DB and file system
+ * @param path : file path
+ * @param uuid : file id
+ * @param is_hide : hidden flag
+ * @return
+ */
 int _gl_data_delete_file(char *path, char *uuid, bool is_hide)
 {
        GL_CHECK_VAL(uuid, -1);
@@ -1114,6 +1246,12 @@ int _gl_data_delete_file(char *path, char *uuid, bool is_hide)
        return 0;
 }
 
+/**
+ * Get the nth item in selected data list
+ * @param data : App data
+ * @param idx : index
+ * @return
+ */
 gl_item *_gl_data_selected_list_get_nth(void *data, int idx)
 {
        GL_CHECK_NULL(data);
@@ -1122,7 +1260,12 @@ gl_item *_gl_data_selected_list_get_nth(void *data, int idx)
        return eina_list_nth(ad->selinfo.elist, idx);
 }
 
-/* b_selall, append item for select-all case */
+/**
+ * append item in selected list
+ * @param data : App data
+ * @param gitem : media item
+ * @return
+ */
 int _gl_data_selected_list_append(void *data, gl_item * gitem)
 {
        GL_CHECK_VAL(gitem, -1);
@@ -1144,6 +1287,12 @@ int _gl_data_selected_list_append(void *data, gl_item * gitem)
        return 0;
 }
 
+/**
+ * Remove fav media item from fav selected media list
+ * @param data : App data
+ * @param gitem : media item
+ * @return
+ */
 int _gl_data_selected_fav_list_remove(void *data, gl_item * gitem)
 {
        GL_CHECK_VAL(gitem, -1);
@@ -1169,7 +1318,12 @@ int _gl_data_selected_fav_list_remove(void *data, gl_item * gitem)
        return 0;
 }
 
-/* b_selall, remove item for select-all case */
+/**
+ * Remove item from selected list
+ * @param data : App data
+ * @param gitem : media item
+ * @return
+ */
 int _gl_data_selected_list_remove(void *data, gl_item * gitem)
 {
        GL_CHECK_VAL(gitem, -1);
@@ -1225,6 +1379,11 @@ int _gl_data_selected_list_remove(void *data, gl_item * gitem)
        return 0;
 }
 
+/**
+ * Finalised the selected media list
+ * @param data : App data
+ * @return
+ */
 int _gl_data_selected_list_finalize(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1259,6 +1418,11 @@ int _gl_data_selected_list_finalize(void *data)
        return 0;
 }
 
+/**
+ * Clear selected information
+ * @param data : App data
+ * @return
+ */
 int _gl_data_clear_selected_info(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1277,6 +1441,12 @@ int _gl_data_clear_selected_info(void *data)
        return 0;
 }
 
+/**
+ * Copy the selected media information in case of media data base update
+ * @param data : App data
+ * @param elist : media list
+ * @return
+ */
 int _gl_data_copy_selected_info_save_current_selected(void *data,
                                                                                                          Eina_List ** elist)
 {
@@ -1310,6 +1480,11 @@ int _gl_data_copy_selected_info_save_current_selected(void *data,
        return 0;
 }
 
+/**
+ * get the selected media count
+ * @param data : App data
+ * @return
+ */
 int _gl_data_selected_list_count(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1318,6 +1493,11 @@ int _gl_data_selected_list_count(void *data)
        return eina_list_count(ad->selinfo.elist);
 }
 
+/**
+ * check for root path
+ * @param path : path
+ * @return
+ */
 bool _gl_data_is_root_path(const char *path)
 {
        if (path == NULL) {
@@ -1341,6 +1521,12 @@ bool _gl_data_is_root_path(const char *path)
        return false;
 }
 
+/**
+ *  check for root path (SDCard root path/ device root path)
+ * @param path : path to be checked
+ * @param root : path to be compared
+ * @return
+ */
 bool _gl_data_check_root_type(const char *path, const char *root)
 {
        if (path == NULL || root == NULL) {
@@ -1359,6 +1545,10 @@ bool _gl_data_check_root_type(const char *path, const char *root)
  * If 'All albums' selected for share, only append files contained in 'All albums';
  * If both local albums and web albums selected, 'Share' item should be disabled.
  * path_str -> local albums, path_str2 -> web albums
+ * @param data : App data
+ * @param get_cb : callback
+ * @param cb_data : callback data
+ * @return
  */
 int _gl_data_get_albums_selected_files(void *data, void *get_cb,
                                                                           void *cb_data)
@@ -1417,6 +1607,11 @@ int _gl_data_get_albums_selected_files(void *data, void *get_cb,
        return count;
 }
 
+/**
+ * get the selected media album count
+ * @param data : App data
+ * @return
+ */
 int _gl_data_get_albums_selected_cnt(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1425,6 +1620,12 @@ int _gl_data_get_albums_selected_cnt(void *data)
        return eina_list_count(ad->albuminfo.sel_elist);
 }
 
+/**
+ * remove the Media album from selected media album list
+ * @param data : App data
+ * @param item : media album data
+ * @return
+ */
 int _gl_data_albums_selected_list_remove(void *data, gl_cluster * item)
 {
        GL_CHECK_VAL(item, -1);
@@ -1471,6 +1672,11 @@ int _gl_data_albums_selected_list_remove(void *data, gl_cluster * item)
        return 0;
 }
 
+/**
+ * finalise the selected media album list
+ * @param data : App data
+ * @return
+ */
 int _gl_data_finalize_albums_selected_list(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1491,6 +1697,11 @@ int _gl_data_finalize_albums_selected_list(void *data)
        return 0;
 }
 
+/**
+ * connect to media database
+ * @param data : App data
+ * @return
+ */
 int _gl_data_init(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1501,6 +1712,11 @@ int _gl_data_init(void *data)
        return err;
 }
 
+/**
+ * Disconnect to media database
+ * @param data : App data
+ * @return
+ */
 int _gl_data_finalize(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1511,13 +1727,25 @@ int _gl_data_finalize(void *data)
        return err;
 }
 
+/**
+ * Delete the media from media database
+ * @param data : App data
+ * @param media_item : media item data
+ * @return
+ */
 int _gl_data_delete_media(void *data, gl_media_s * media_item)
 {
        GL_CHECK_VAL(media_item, -1);
        return media_info_delete_from_db(media_item->uuid);
 }
 
-/* Creates a thumbnail image for given the media, asynchronously */
+/**
+ * Creates a thumbnail image for given the media, asynchronously
+ * @param item : media item data
+ * @param callback : callback to be called once job is done
+ * @param user_data : user data to be passed to callback
+ * @return
+ */
 int _gl_data_create_thumb(gl_media_s * item,
                                                  media_thumbnail_completed_cb callback,
                                                  void *user_data)
@@ -1536,6 +1764,11 @@ int _gl_data_create_thumb(gl_media_s * item,
        return 0;
 }
 
+/**
+ * Cancel the thumbnail generation request
+ * @param item : media item data
+ * @return
+ */
 int _gl_data_cancel_thumb(gl_media_s * item)
 {
        GL_CHECK_VAL(item, -1);
@@ -1546,6 +1779,12 @@ int _gl_data_cancel_thumb(gl_media_s * item)
        return 0;
 }
 
+/**
+ * save seleted media data list
+ * @param data : App data
+ * @param elist : media data list
+ * @return
+ */
 int _gl_data_save_selected_str_ids(void *data, Eina_List ** elist)
 {
        GL_CHECK_VAL(data, -1);
@@ -1561,6 +1800,12 @@ int _gl_data_save_selected_str_ids(void *data, Eina_List ** elist)
        return 0;
 }
 
+/**
+ * resotre saved selected media data list
+ * @param sel_ids : selected media ids
+ * @param gitem : media item data
+ * @return
+ */
 int _gl_data_restore_selected(Eina_List * sel_ids, gl_item * gitem)
 {
        GL_CHECK_VAL(gitem, -1);
@@ -1581,6 +1826,12 @@ int _gl_data_restore_selected(Eina_List * sel_ids, gl_item * gitem)
        return 0;
 }
 
+/**
+ * resotre saved selected media data list
+ * @param sel_ids : selected media ids
+ * @param gitem : media item data
+ * @return
+ */
 int _gl_data_restore_update_selected(Eina_List * sel_ids, gl_item * gitem)
 {
        GL_CHECK_VAL(gitem, -1);
@@ -1602,6 +1853,12 @@ int _gl_data_restore_update_selected(Eina_List * sel_ids, gl_item * gitem)
        return 0;
 }
 
+/**
+ * check for selected ids
+ * @param sel_id_list : list of selected media data list
+ * @param id : media id
+ * @return
+ */
 bool _gl_data_check_selected_id(Eina_List * sel_id_list, const char *id)
 {
        GL_CHECK_FALSE(sel_id_list);
index 9bf8630..9110f46 100644 (file)
@@ -37,6 +37,12 @@ struct _gl_foreach_data_t {
        bool with_meta;
 };
 
+/**
+ * create media filter condition to get local media album
+ * @param condition : filter condition
+ * @param filter : filter handle
+ * @return
+ */
 static int __gl_local_data_create_filter(gl_filter_s * condition,
                                                                                 filter_h * filter)
 {
@@ -92,6 +98,11 @@ static int __gl_local_data_create_filter(gl_filter_s * condition,
        return -1;
 }
 
+/**
+ * destroy filter handle
+ * @param filter : filter handle
+ * @return
+ */
 static int __gl_local_data_destroy_filter(filter_h filter)
 {
        GL_CHECK_VAL(filter, -1);
@@ -103,6 +114,13 @@ static int __gl_local_data_destroy_filter(filter_h filter)
        return 0;
 }
 
+/**
+ * Get media album and media album related data and
+ * set these data to media album data list
+ * @param folder : media folder handle
+ * @param data : transfer data
+ * @return
+ */
 static bool __gl_local_data_get_album_list_cb(media_folder_h folder,
                                                                                          void *data)
 {
@@ -182,6 +200,13 @@ static bool __gl_local_data_get_album_list_cb(media_folder_h folder,
        return false;
 }
 
+/**
+ * Get media item and media item  related data and
+ * set these data to media item data list
+ * @param media : media item handle
+ * @param data : transfer data
+ * @return
+ */
 static bool __gl_local_data_get_media_list_cb(media_info_h media,
                                                                                          void *data)
 {
@@ -400,6 +425,13 @@ static bool __gl_local_data_get_media_list_cb(media_info_h media,
        return false;
 }
 
+/**
+ * Get media  fav item and media fav item  related data and
+ * set these data to media fav item data list
+ * @param media : media handle
+ * @param data : transfer data
+ * @return
+ */
 static bool __gl_local_data_get_fav_media_list_cb(media_info_h media,
                                                                                                  void *data)
 {
@@ -408,6 +440,12 @@ static bool __gl_local_data_get_fav_media_list_cb(media_info_h media,
        return ret;
 }
 
+/**
+ * Get media  album cover
+ * @param media : media handle
+ * @param data : transfer data
+ * @return
+ */
 static bool __gl_local_data_get_album_cover_cb(media_info_h media,
                                                                                           void *data)
 {
@@ -453,6 +491,12 @@ static bool __gl_local_data_get_album_cover_cb(media_info_h media,
        return false;
 }
 
+/**
+ * get fav album cover
+ * @param media : media handle
+ * @param data : transfer data
+ * @return
+ */
 static bool __gl_local_data_get_fav_album_cover_cb(media_info_h media,
                                                                                                   void *data)
 {
@@ -498,6 +542,12 @@ static bool __gl_local_data_get_fav_album_cover_cb(media_info_h media,
        return false;
 }
 
+/**
+ * delete media album CB
+ * @param media : media handle
+ * @param data : eina list
+ * @return
+ */
 static bool __gl_local_data_delete_album_cb(media_info_h media, void *data)
 {
        GL_CHECK_FALSE(data);
@@ -518,7 +568,10 @@ static bool __gl_local_data_delete_album_cb(media_info_h media, void *data)
        return true;
 }
 
-/* Connect to media-content database */
+/**
+ * Connect to media-content database
+ * @return
+ */
 int _gl_local_data_connect(void)
 {
        int ret = -1;
@@ -532,7 +585,10 @@ int _gl_local_data_connect(void)
        }
 }
 
-/* Disconnect from media-content database */
+/**
+ * Disconnect from media-content database
+ * @return
+ */
 int _gl_local_data_disconnect(void)
 {
        int ret = -1;
@@ -546,6 +602,12 @@ int _gl_local_data_disconnect(void)
        }
 }
 
+/**
+ * get media album by album path
+ * @param path : album path
+ * @param album : media album data
+ * @return
+ */
 int _gl_local_data_get_album_by_path(char *path, gl_album_s ** album)
 {
        GL_CHECK_VAL(path, -1);
@@ -601,6 +663,12 @@ int _gl_local_data_get_album_by_path(char *path, gl_album_s ** album)
        return ret;
 }
 
+/**
+ * get local media ablum list
+ * @param condition : filter condition for local album
+ * @param elist : list to store local media album
+ * @return
+ */
 int _gl_local_data_get_album_list(gl_filter_s * condition,
                                                                  Eina_List ** elist)
 {
@@ -660,6 +728,13 @@ int _gl_local_data_get_album_list(gl_filter_s * condition,
        return 0;
 }
 
+/**
+ * get local media item count
+ * @param cluster_id : media album id
+ * @param condition : filter condition
+ * @param item_cnt : item count
+ * @return
+ */
 int _gl_local_data_get_media_count(const char *cluster_id,
                                                                   gl_filter_s * condition, int *item_cnt)
 {
@@ -690,6 +765,12 @@ int _gl_local_data_get_media_count(const char *cluster_id,
        return 0;
 }
 
+/**
+ * get all  media count in device
+ * @param condtion : filter condition
+ * @param item_cnt : item count
+ * @return
+ */
 int _gl_local_data_get_all_media_count(gl_filter_s * condtion,
                                                                           int *item_cnt)
 {
@@ -720,6 +801,13 @@ int _gl_local_data_get_all_media_count(gl_filter_s * condtion,
        return 0;
 }
 
+/**
+ * get local media item list from media album
+ * @param condition : filter condition
+ * @param album_id : album id
+ * @param elist : media item list
+ * @return
+ */
 int _gl_local_data_get_album_media_list(gl_filter_s * condition,
                                                                                const char *album_id,
                                                                                Eina_List ** elist)
@@ -760,6 +848,13 @@ int _gl_local_data_get_album_media_list(gl_filter_s * condition,
        return 0;
 }
 
+/**
+ * get local album cover
+ * @param condition : filter condition
+ * @param album_id : album id
+ * @param elist : media item list
+ * @return
+ */
 int _gl_local_data_get_album_cover(gl_filter_s * condition,
                                                                   const char *album_id,
                                                                   Eina_List ** elist)
@@ -793,6 +888,12 @@ int _gl_local_data_get_album_cover(gl_filter_s * condition,
        return 0;
 }
 
+/**
+ * get all media item in device
+ * @param condition : filter condition
+ * @param elist : media item list
+ * @return
+ */
 int _gl_local_data_get_all_albums_media_list(gl_filter_s * condition,
                                                                                         Eina_List ** elist)
 {
@@ -830,6 +931,12 @@ int _gl_local_data_get_all_albums_media_list(gl_filter_s * condition,
        return 0;
 }
 
+/**
+ * get fav media item in device
+ * @param condition : filter condition
+ * @param elist : fav media item list
+ * @return
+ */
 int _gl_local_data_get_fav_albums_media_list(gl_filter_s * condition,
                                                                                         Eina_List ** elist)
 {
@@ -867,6 +974,12 @@ int _gl_local_data_get_fav_albums_media_list(gl_filter_s * condition,
        return 0;
 }
 
+/**
+ * get all album cluster cover
+ * @param condition : filter condition
+ * @param elist : media item list
+ * @return
+ */
 int _gl_local_data_get_all_albums_cover(gl_filter_s * condition,
                                                                                Eina_List ** elist)
 {
@@ -897,6 +1010,12 @@ int _gl_local_data_get_all_albums_cover(gl_filter_s * condition,
        return 0;
 }
 
+/**
+ * get fav album cover
+ * @param condition  : filter condition
+ * @param elist : fav media item list
+ * @return
+ */
 int _gl_local_data_get_fav_albums_cover(gl_filter_s * condition,
                                                                                Eina_List ** elist)
 {
@@ -927,6 +1046,14 @@ int _gl_local_data_get_fav_albums_cover(gl_filter_s * condition,
        return 0;
 }
 
+/**
+ * delete local album and media item in that album
+ * @param cluster : album data
+ * @param cb : callback
+ * @param data : data
+ * @param is_hide : flag
+ * @return
+ */
 int _gl_local_data_delete_album(gl_album_s * cluster, void *cb, void *data,
                                                                bool is_hide)
 {
@@ -995,6 +1122,12 @@ int _gl_local_data_delete_album(gl_album_s * cluster, void *cb, void *data,
        return 0;
 }
 
+/**
+ * insert media database
+ * @param file_url : file path
+ * @param info : media info
+ * @return
+ */
 int _gl_local_data_add_media(const char *file_url, media_info_h * info)
 {
        GL_CHECK_VAL(file_url, -1);
@@ -1021,6 +1154,12 @@ int _gl_local_data_add_media(const char *file_url, media_info_h * info)
        return 0;
 }
 
+/**
+ * move media to different location in media data base
+ * @param mitem : media item data
+ * @param dst : destination
+ * @return
+ */
 int _gl_local_data_move_media(gl_media_s * mitem, const char *dst)
 {
        GL_CHECK_VAL(dst, -1);
index bdd861a..a17f57c 100644 (file)
@@ -33,6 +33,12 @@ struct _gl_entry_t {
        void *ad;
 };
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_entry_done_cb(void *data, Evas_Object * obj, void *ei)
 {
        GL_CHECK(data);
@@ -57,6 +63,12 @@ static void __gl_entry_done_cb(void *data, Evas_Object * obj, void *ei)
        GL_FREEIF(ad->albuminfo.temp_album_name);
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_entry_cancel_cb(void *data, Evas_Object * obj, void *ei)
 {
        GL_CHECK(obj);
@@ -74,6 +86,15 @@ static void __gl_entry_cancel_cb(void *data, Evas_Object * obj, void *ei)
  *  Use naviframe api to push albums rename view to stack.
  *  @param obj is the content to be pushed.
  */
+/**
+ *
+ * @param data
+ * @param parent
+ * @param obj
+ * @param title
+ * @param entry_d
+ * @return
+ */
 static int __gl_entry_push_view(void *data, Evas_Object * parent,
                                                                Evas_Object * obj, char *title,
                                                                gl_entry_s * entry_d)
@@ -105,6 +126,12 @@ static int __gl_entry_push_view(void *data, Evas_Object * parent,
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param event_info
+ */
 void _gl_popup_create_folder_imf_changed_cb(void *data, Evas_Object * obj,
                                                                                        void *event_info)
 {
@@ -136,6 +163,12 @@ void _gl_popup_create_folder_imf_changed_cb(void *data, Evas_Object * obj,
        free(name);
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param event_info
+ */
 static void _showFinishedCb(void *data, Evas_Object * obj,
                                                        void *event_info)
 {
@@ -145,6 +178,13 @@ static void _showFinishedCb(void *data, Evas_Object * obj,
                                                                   _showFinishedCb);
 }
 
+/**
+ *
+ * @param data
+ * @param name
+ * @param title
+ * @return
+ */
 int _gl_entry_create_view(void *data, char *name, char *title)
 {
        GL_CHECK_VAL(data, -1);
@@ -232,6 +272,11 @@ int _gl_entry_create_view(void *data, char *name, char *title)
 
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_entry_resume_view(void *data)
 {
        GL_CHECK_VAL(data, -1);
index af9ed16..31fdfbb 100644 (file)
 #define GL_BG_COLOR_DEFAULT 0
 #define GL_BG_COLOR_A 255
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_main_win_del_cb(void *data, Evas_Object * obj, void *ei)
 {
        gl_dbgW("_gl_main_win_del_cb!!");
@@ -43,7 +49,10 @@ static void __gl_main_win_del_cb(void *data, Evas_Object * obj, void *ei)
  *
  * Please set NULL to app_device_orientation_cb member of app_event_callback_s structure.
  * And don't use app_device_orientation_cb callback which is supported by capi
-*/
+ * @param data
+ * @param obj
+ * @param event
+ */
 static void __gl_main_win_rot_changed_cb(void *data, Evas_Object * obj,
                                                                                 void *event)
 {
@@ -66,6 +75,11 @@ static void __gl_main_win_rot_changed_cb(void *data, Evas_Object * obj,
 }
 
 /* Parent is main window */
+/**
+ *
+ * @param parent
+ * @return
+ */
 static Evas_Object *__gl_main_create_bg(Evas_Object * parent)
 {
        GL_PROFILE_IN;
@@ -85,6 +99,11 @@ static Evas_Object *__gl_main_create_bg(Evas_Object * parent)
 }
 
 /* Parent is main window */
+/**
+ *
+ * @param parent
+ * @return
+ */
 static Evas_Object *__gl_main_create_conform(Evas_Object * parent)
 {
        GL_PROFILE_IN;
@@ -101,6 +120,12 @@ static Evas_Object *__gl_main_create_conform(Evas_Object * parent)
        return conform;
 }
 
+/**
+ *
+ * @param ad
+ * @param parent
+ * @return
+ */
 static int __gl_main_create_ctrl_ly(gl_appdata * ad, Evas_Object * parent)
 {
        GL_PROFILE_IN;
@@ -117,6 +142,11 @@ static int __gl_main_create_ctrl_ly(gl_appdata * ad, Evas_Object * parent)
        return 0;
 }
 
+/**
+ *
+ * @param parent
+ * @return
+ */
 static Evas_Object *__gl_main_create_ly(Evas_Object * parent)
 {
        GL_PROFILE_IN;
@@ -134,6 +164,11 @@ static Evas_Object *__gl_main_create_ly(Evas_Object * parent)
        return layout;
 }
 
+/**
+ *
+ * @param parent
+ * @return
+ */
 static Evas_Object *__gl_main_create_naviframe(Evas_Object * parent)
 {
        GL_PROFILE_IN;
@@ -154,6 +189,11 @@ static Evas_Object *__gl_main_create_naviframe(Evas_Object * parent)
        return nf;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static Eina_Bool __gl_main_reg_idler_cb(void *data)
 {
        gl_dbg("start");
@@ -176,9 +216,14 @@ static Eina_Bool __gl_main_reg_idler_cb(void *data)
        return ECORE_CALLBACK_CANCEL;
 }
 
-/* pause gallery and change view to background after tap Back button in main view */
-/* Return EINA_FALSE to keep current view unchanged, no pop operation */
-/* Always return EINA_FALSE in the first item of naviframe */
+
+/**
+ * pause gallery and change view to background after tap Back button in main view
+ * Return EINA_FALSE to keep current view unchanged, no pop operation
+ * Always return EINA_FALSE in the first item of naviframe
+ * @param data
+ * @return
+ */
 static Eina_Bool __gl_main_pop_op(void *data)
 {
        GL_CHECK_FALSE(data);
@@ -250,6 +295,12 @@ static int __gl_main_push_view(void *data, Evas_Object * parent,
 }
 
 /* Add albums view and append nothing */
+/**
+ *
+ * @param data
+ * @param parent
+ * @return
+ */
 static int __gl_main_add_view(void *data, Evas_Object * parent)
 {
        GL_PROFILE_IN;
@@ -272,6 +323,12 @@ static int __gl_main_add_view(void *data, Evas_Object * parent)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param name
+ * @return
+ */
 static Evas_Object *__gl_main_create_win(void *data, const char *name)
 {
        GL_PROFILE_IN;
@@ -320,6 +377,11 @@ static Evas_Object *__gl_main_create_win(void *data, const char *name)
 }
 
 /* Register service in idler for reducing launching time */
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_main_add_reg_idler(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -343,6 +405,11 @@ int _gl_main_add_reg_idler(void *data)
  *                     |-> Elm_layout(ctrlbar_view_ly)
  *                          |-> Elm_gengrid(albums_view/tags_view/places_view/...)
 */
+/**
+ *
+ * @param ad
+ * @return
+ */
 int _gl_main_create_view(gl_appdata * ad)
 {
        GL_PROFILE_IN;
@@ -419,6 +486,11 @@ int _gl_main_create_view(gl_appdata * ad)
        return 0;
 }
 
+/**
+ *
+ * @param ad
+ * @return
+ */
 int _gl_main_clear_view(gl_appdata * ad)
 {
        GL_CHECK_VAL(ad, -1);
@@ -433,6 +505,11 @@ int _gl_main_clear_view(gl_appdata * ad)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 Eina_Bool _gl_main_update_view(void *data)
 {
        GL_PROFILE_IN;
@@ -457,6 +534,11 @@ Eina_Bool _gl_main_update_view(void *data)
        return ECORE_CALLBACK_CANCEL;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_main_reset_view(void *data)
 {
        GL_CHECK_VAL(data, -1);
index 66c6f6c..2aa7be2 100644 (file)
 #include "gl-thumbs.h"
 #include "gl-debug.h"
 
+/**
+ *
+ * @param gesture
+ * @param data
+ * @return
+ */
 static Eina_Bool __gl_pinch_zoom_out_cb(Evas_Object * gesture, void *data)
 {
        GL_CHECK_CANCEL(data);
@@ -50,6 +56,12 @@ static Eina_Bool __gl_pinch_zoom_out_cb(Evas_Object * gesture, void *data)
        return ECORE_CALLBACK_CANCEL;
 }
 
+/**
+ *
+ * @param gesture
+ * @param data
+ * @return
+ */
 static Eina_Bool __gl_pinch_zoom_in_cb(Evas_Object * gesture, void *data)
 {
        GL_CHECK_CANCEL(data);
@@ -80,6 +92,12 @@ static Eina_Bool __gl_pinch_zoom_in_cb(Evas_Object * gesture, void *data)
        return ECORE_CALLBACK_CANCEL;
 }
 
+/**
+ *
+ * @param data
+ * @param layout
+ * @return
+ */
 int _gl_pinch_add_event(void *data, Evas_Object * layout)
 {
        GL_CHECK_VAL(layout, -1);
@@ -109,6 +127,11 @@ int _gl_pinch_add_event(void *data, Evas_Object * layout)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_pinch_reset_flag(void *data)
 {
        GL_CHECK_VAL(data, -1);
index 2efe71a..e91d40f 100644 (file)
 */
 
 static bool _gallery_create(void *data);
+
+/**
+ *
+ * @param signum
+ */
 static void __gallery_sigterm_handler(int signum)
 {
        /* do something for signal handling */
@@ -36,6 +41,11 @@ static void __gallery_sigterm_handler(int signum)
        elm_exit();
 }
 
+/**
+ *
+ * @param event_info
+ * @param data
+ */
 static void _gallery_lang_changed_cb(app_event_info_h event_info,
                                                                         void *data)
 {
@@ -47,6 +57,10 @@ static void _gallery_lang_changed_cb(app_event_info_h event_info,
        _gl_lang_update(data);
 }
 
+/**
+ *
+ * @param data
+ */
 static void _gallery_resume(void *data)
 {
        gl_dbgW("==Resume==");
@@ -84,6 +98,11 @@ static void _gallery_resume(void *data)
        _gl_entry_resume_view(ad);
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static int _gallery_close_app(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -118,6 +137,10 @@ static int _gallery_close_app(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ */
 static void _gallery_terminate(void *data)
 {
        gl_dbgW("==Terminate==");
@@ -126,6 +149,13 @@ static void _gallery_terminate(void *data)
        _gallery_close_app(data);
 }
 
+/**
+ *
+ * @param data
+ * @param type
+ * @param event
+ * @return
+ */
 static Eina_Bool __gallery_key_down_cb(void *data, int type, void *event)
 {
        if (!data) {
@@ -148,6 +178,11 @@ static Eina_Bool __gallery_key_down_cb(void *data, int type, void *event)
        return ECORE_CALLBACK_PASS_ON;
 }
 
+/**
+ *
+ * @param event_info
+ * @param data
+ */
 static void _gallery_low_battery_cb(app_event_info_h event_info,
                                                                        void *data)
 {
@@ -157,6 +192,11 @@ static void _gallery_low_battery_cb(app_event_info_h event_info,
        /* 0 : default handler, 1:user handler */
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static bool _gallery_create(void *data)
 {
        GL_PROFILE_IN;
@@ -204,6 +244,10 @@ static bool _gallery_create(void *data)
        return true;
 }
 
+/**
+ *
+ * @param data
+ */
 static void _gallery_pause(void *data)
 {
        gl_dbgW("==Pause==");
@@ -222,7 +266,12 @@ static void _gallery_pause(void *data)
 }
 
 
-/* analysis parameters */
+/**
+ *
+ * @param data
+ * @param service
+ * @return
+ */
 static int __gallery_parse_param(void *data, app_control_h service)
 {
        GL_CHECK_VAL(service, -1);
@@ -243,6 +292,11 @@ static int __gallery_parse_param(void *data, app_control_h service)
        return -1;
 }
 
+/**
+ *
+ * @param service
+ * @param data
+ */
 static void _gallery_reset(app_control_h service, void *data)
 {
        GL_PROFILE_IN;
@@ -286,6 +340,12 @@ static void _gallery_reset(app_control_h service, void *data)
        GL_PROFILE_OUT;
 }
 
+/**
+ *
+ * @param argc
+ * @param argv
+ * @return
+ */
 EXPORT_API int main(int argc, char *argv[])
 {
        gl_dbgW("==Gallery==");
index b32898d..9711ac1 100644 (file)
@@ -42,6 +42,11 @@ struct gl_db_noti_t {
        media_content_noti_h noti_handle;
 };
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static Eina_Bool __gl_db_update_idler(void *data)
 {
        GL_CHECK_FALSE(data);
@@ -55,6 +60,11 @@ static Eina_Bool __gl_db_update_idler(void *data)
        return ECORE_CALLBACK_CANCEL;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static Eina_Bool __gl_db_update_timer_cb(void *data)
 {
        GL_CHECK_FALSE(data);
@@ -77,6 +87,19 @@ static Eina_Bool __gl_db_update_timer_cb(void *data)
        return ECORE_CALLBACK_CANCEL;
 }
 
+/**
+ *
+ * @param error
+ * @param pid
+ * @param update_item
+ * @param update_type
+ * @param media_type
+ * @param uuid
+ * @param path
+ * @param mime_type
+ * @param data
+ * @return
+ */
 static int __gl_db_update_op(media_content_error_e error, int pid,
                                                         media_content_db_update_item_type_e
                                                         update_item,
@@ -137,6 +160,18 @@ static int __gl_db_update_op(media_content_error_e error, int pid,
        return 0;
 }
 
+/**
+ *
+ * @param error
+ * @param pid
+ * @param update_item
+ * @param update_type
+ * @param media_type
+ * @param uuid
+ * @param path
+ * @param mime_type
+ * @param data
+ */
 static void __gl_db_update_cb(media_content_error_e error, int pid,
                                                          media_content_db_update_item_type_e
                                                          update_item,
@@ -152,6 +187,11 @@ static void __gl_db_update_cb(media_content_error_e error, int pid,
                                          uuid, path, mime_type, data);
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_db_update_add_timer(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -166,6 +206,12 @@ int _gl_db_update_add_timer(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param status
+ * @return
+ */
 bool _gl_db_update_lock_once(void *data, bool status)
 {
        gl_dbg("");
@@ -181,6 +227,12 @@ bool _gl_db_update_lock_once(void *data, bool status)
        return true;
 }
 
+/**
+ *
+ * @param data
+ * @param status
+ * @return
+ */
 bool _gl_db_update_lock_always(void *data, bool status)
 {
        gl_dbg("");
@@ -196,6 +248,12 @@ bool _gl_db_update_lock_always(void *data, bool status)
        return true;
 }
 
+/**
+ *
+ * @param data
+ * @param count
+ * @return
+ */
 bool _gl_db_update_set_count(void *data, int count)
 {
        gl_dbg("count: %d", count);
@@ -207,7 +265,11 @@ bool _gl_db_update_set_count(void *data, int count)
        return true;
 }
 
-/*Add media-content update callback*/
+/**
+ * Add media-content update callback
+ * @param data
+ * @return
+ */
 bool _gl_db_update_reg_cb(void *data)
 {
        GL_CHECK_FALSE(data);
@@ -225,7 +287,11 @@ bool _gl_db_update_reg_cb(void *data)
        return true;
 }
 
-/* calloc memory */
+/**
+ * Allocate memory to gl_db_noti_s
+ * @param data
+ * @return
+ */
 bool _gl_db_update_init(void *data)
 {
        GL_CHECK_FALSE(data);
@@ -239,6 +305,11 @@ bool _gl_db_update_init(void *data)
        return true;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 bool _gl_db_update_finalize(void *data)
 {
        int ret = -1;
index 722d4a5..bccd4c0 100644 (file)
 #define GL_ARGC_SELECTED_FILES "Selected index"
 #define GL_ARGV_IV_INDEX_VALUE "1"
 
+/**
+ *
+ * @param request
+ * @param reply
+ * @param result
+ * @param user_data
+ */
 static void __gl_appcontrol_select_result_cb(app_control_h request,
                                                                                         app_control_h reply,
                                                                                         app_control_result_e result,
@@ -238,6 +245,12 @@ static void __gl_appcontrol_select_result_cb(app_control_h request,
        }
 }
 
+/**
+ *
+ * @param service
+ * @param sort
+ * @return
+ */
 static int __gl_ext_add_sortby(app_control_h service, int sort)
 {
        GL_CHECK_VAL(service, GL_UG_FAIL);
@@ -277,6 +290,12 @@ static int __gl_ext_add_sortby(app_control_h service, int sort)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_ext_popup_resp_cb(void *data, Evas_Object * obj, void *ei)
 {
        GL_CHECK(obj);
@@ -285,6 +304,13 @@ static void __gl_ext_popup_resp_cb(void *data, Evas_Object * obj, void *ei)
        GL_IF_DEL_OBJ(ad->popupinfo.popup);
 }
 
+/**
+ *
+ * @param data
+ * @param service
+ * @param type
+ * @return
+ */
 static int __gl_ext_set_thumbs_mode(void *data, app_control_h service,
                                                                        int type)
 {
@@ -301,6 +327,14 @@ static int __gl_ext_set_thumbs_mode(void *data, app_control_h service,
        return GL_UG_SUCCESS;
 }
 
+/**
+ *
+ * @param data
+ * @param service
+ * @param type
+ * @param item
+ * @return
+ */
 static int __gl_ext_albums_set_iv(void *data, app_control_h service,
                                                                  int type, gl_item * item)
 {
@@ -331,6 +365,13 @@ static int __gl_ext_albums_set_iv(void *data, app_control_h service,
        return GL_UG_SUCCESS;
 }
 
+/**
+ *
+ * @param data
+ * @param service
+ * @param type
+ * @return
+ */
 static int __gl_ext_albums_set_iv_select_mode(void *data,
                                                                                          app_control_h service,
                                                                                          int type)
@@ -385,6 +426,12 @@ static int __gl_ext_albums_set_iv_select_mode(void *data,
        return GL_UG_SUCCESS;
 }
 
+/**
+ *
+ * @param service
+ * @param data
+ * @return
+ */
 static int _gl_ext_load_iv_selected_list(app_control_h service, void *data)
 {
        GL_CHECK_VAL(data, GL_UG_FAIL);
@@ -460,6 +507,14 @@ static int _gl_ext_load_iv_selected_list(app_control_h service, void *data)
        return GL_UG_SUCCESS;
 }
 
+/**
+ *
+ * @param data
+ * @param item
+ * @param type
+ * @param sort_type
+ * @return
+ */
 int gl_ext_load_iv_time_ug_select_mode(void *data, gl_media_s * item,
                                                                           gl_ext_iv_type type, int sort_type)
 {
@@ -477,6 +532,13 @@ int gl_ext_load_iv_time_ug_select_mode(void *data, gl_media_s * item,
        return ret;
 }
 
+/**
+ *
+ * @param data
+ * @param item
+ * @param type
+ * @return
+ */
 int gl_ext_load_iv_ug_select_mode(void *data, gl_media_s * item,
                                                                  gl_ext_iv_type type)
 {
@@ -552,6 +614,13 @@ int gl_ext_load_iv_ug_select_mode(void *data, gl_media_s * item,
 }
 
 /* Invoke Imageviewer UG */
+/**
+ *
+ * @param data
+ * @param item
+ * @param type
+ * @return
+ */
 int gl_ext_load_iv_ug(void *data, gl_item * item, gl_ext_iv_type type)
 {
        GL_CHECK_VAL(item, GL_UG_FAIL);
@@ -644,6 +713,14 @@ int gl_ext_load_iv_ug(void *data, gl_item * item, gl_ext_iv_type type)
 }
 
 /* Invoke Imageviewer UG from timeline view */
+/**
+ *
+ * @param data
+ * @param path
+ * @param sequence
+ * @param sort_type
+ * @return
+ */
 int _gl_ext_load_iv_timeline(void *data, const char *path, int sequence,
                                                         int sort_type)
 {
index 45041ce..b272d9a 100644 (file)
 static mode_t default_mode =
        S_IRUSR | S_IWUSR | S_IXUSR | S_IRGRP | S_IXGRP | S_IROTH | S_IXOTH;
 
+/**
+ *
+ * @param path
+ * @return
+ */
 int gl_file_exists(const char *path)
 {
        struct stat info = { 0, };
@@ -33,6 +38,11 @@ int gl_file_exists(const char *path)
        }
 }
 
+/**
+ *
+ * @param path
+ * @return
+ */
 int gl_file_is_dir(const char *path)
 {
        struct stat info = { 0, };
@@ -46,6 +56,11 @@ int gl_file_is_dir(const char *path)
        return 0;
 }
 
+/**
+ *
+ * @param path
+ * @return
+ */
 int gl_file_dir_is_empty(const char *path)
 {
        struct dirent *dp = NULL;
@@ -67,6 +82,11 @@ int gl_file_dir_is_empty(const char *path)
        return 1;
 }
 
+/**
+ *
+ * @param dir
+ * @return
+ */
 int gl_mkdir(const char *dir)
 {
        if (mkdir(dir, default_mode) < 0) {
@@ -76,6 +96,11 @@ int gl_mkdir(const char *dir)
        }
 }
 
+/**
+ *
+ * @param path
+ * @return
+ */
 static int gl_mkpath_if_not_exists(const char *path)
 {
        struct stat st = { 0, };
@@ -88,6 +113,11 @@ static int gl_mkpath_if_not_exists(const char *path)
        }
 }
 
+/**
+ *
+ * @param path
+ * @return
+ */
 int gl_file_mkpath(const char *path)
 {
        char ss[500] = { 0, };
@@ -114,6 +144,11 @@ int gl_file_mkpath(const char *path)
        return gl_mkpath_if_not_exists(ss);
 }
 
+/**
+ *
+ * @param filename
+ * @return
+ */
 int gl_file_unlink(const char *filename)
 {
        int status = unlink(filename);
@@ -124,6 +159,11 @@ int gl_file_unlink(const char *filename)
        }
 }
 
+/**
+ *
+ * @param filename
+ * @return
+ */
 int gl_file_size(const char *filename)
 {
        struct stat info = { 0, };
@@ -136,6 +176,11 @@ int gl_file_size(const char *filename)
        return 0;
 }
 
+/**
+ *
+ * @param filename
+ * @return
+ */
 int gl_file_rmdir(const char *filename)
 {
        int status = rmdir(filename);
@@ -146,6 +191,11 @@ int gl_file_rmdir(const char *filename)
        }
 }
 
+/**
+ *
+ * @param dir
+ * @return
+ */
 int gl_file_recursive_rm(const char *dir)
 {
        char buf[PATH_MAX] = { 0, };
index ebcffd7..a827d96 100644 (file)
 #include "gl-thread-util.h"
 #include "gl-file-util.h"
 
+/**
+ *
+ * @param pnode
+ * @return
+ */
 static int __gl_fs_free_node(gl_node_info_s * pnode)
 {
        GL_CHECK_VAL(pnode, -1);
@@ -36,6 +41,11 @@ static int __gl_fs_free_node(gl_node_info_s * pnode)
        return 0;
 }
 
+/**
+ *
+ * @param elist
+ * @return
+ */
 static int __gl_fs_clear_list(Eina_List ** elist)
 {
        GL_CHECK_VAL(elist, -1);
@@ -50,6 +60,13 @@ static int __gl_fs_clear_list(Eina_List ** elist)
        return 0;
 }
 
+/**
+ *
+ * @param path
+ * @param dir_list
+ * @param file_list
+ * @return
+ */
 static int __gl_fs_read_dir(char *path, Eina_List ** dir_list,
                                                        Eina_List ** file_list)
 {
@@ -127,6 +144,13 @@ static int __gl_fs_read_dir(char *path, Eina_List ** dir_list,
        return 0;
 }
 
+/**
+ *
+ * @param folder_name
+ * @param dir_list
+ * @param file_list
+ * @return
+ */
 static int __gl_fs_get_file_list(GString * folder_name,
                                                                 Eina_List ** dir_list,
                                                                 Eina_List ** file_list)
@@ -137,6 +161,10 @@ static int __gl_fs_get_file_list(GString * folder_name,
        return __gl_fs_read_dir(folder_name->str, dir_list, file_list);
 }
 
+/**
+ *
+ * @param state
+ */
 unsigned long long gl_fs_get_free_space(int state)
 {
        struct statvfs info;
@@ -153,7 +181,13 @@ unsigned long long gl_fs_get_free_space(int state)
                ((unsigned long long) (info.f_bavail));
 }
 
-/* Add checking for cancellation to terminate RW loop */
+/**
+ * Add checking for cancellation to terminate RW loop
+ * @param data
+ * @param src
+ * @param dst
+ * @return
+ */
 Eina_Bool __gl_fs_cp_file(void *data, const char *src, const char *dst)
 {
 #define PATH_MAX 4096
@@ -201,6 +235,12 @@ Eina_Bool __gl_fs_cp_file(void *data, const char *src, const char *dst)
        return ret;
 }
 
+/**
+ *
+ * @param filename
+ * @param node
+ * @return
+ */
 int _gl_fs_get_file_stat(const char *filename, gl_node_info_s ** node)
 {
        struct stat statbuf;
@@ -218,6 +258,10 @@ int _gl_fs_get_file_stat(const char *filename, gl_node_info_s ** node)
        return 0;
 }
 
+/**
+ *
+ * @param path
+ */
 unsigned long long _gl_fs_get_folder_size(char *path)
 {
        if (!gl_file_is_dir(path)) {
@@ -293,6 +337,13 @@ unsigned long long _gl_fs_get_folder_size(char *path)
 /*
 *   return file extension, f.e. jpg; then return new path without ext.
 */
+/**
+ * get file extension and file name without extension
+ * @param file_path
+ * @param file_ext
+ * @param new_path
+ * @return
+ */
 bool _gl_fs_get_path_without_ext(const char *file_path, char *file_ext,
                                                                 char *new_path)
 {
@@ -312,6 +363,13 @@ bool _gl_fs_get_path_without_ext(const char *file_path, char *file_ext,
        return true;
 }
 
+/**
+ *
+ * @param data
+ * @param src
+ * @param dst
+ * @return
+ */
 Eina_Bool _gl_fs_copy(void *data, const char *src, const char *dst)
 {
        GL_CHECK_FALSE(src);
@@ -346,18 +404,20 @@ Eina_Bool _gl_fs_copy(void *data, const char *src, const char *dst)
 }
 
 /*
-* Use gl_file_mv() to move medias to other album.
-* Media-server, which is different with libmedia-info, watches src and dest folder,
-* it updates libmedia-info DB asynchronously.
-* While move/copy mass data in My Files appliation,
-* After move/copy done in My files, check the dest folder in Gallery.
-* You'll find its content is changing.
-* gl_file_mv() operate libmedia-info DB synchronously, so it's faster than media-server.
-*/
-
-/*
-*  stop using "rename" when moving from mmc to phone for correct db update.
-*/
+ * Use gl_file_mv() to move medias to other album.
+ * Media-server, which is different with libmedia-info, watches src and dest folder,
+ * it updates libmedia-info DB asynchronously.
+ * While move/copy mass data in My Files appliation,
+ * After move/copy done in My files, check the dest folder in Gallery.
+ * You'll find its content is changing.
+ * gl_file_mv() operate libmedia-info DB synchronously, so it's faster than media-server.
+ *  stop using "rename" when moving from mmc to phone for correct db update.
+ *
+ * @param data
+ * @param src
+ * @param dst
+ * @return
+ */
 Eina_Bool _gl_fs_move(void *data, const char *src, const char *dst)
 {
        GL_CHECK_FALSE(src);
@@ -422,6 +482,12 @@ Eina_Bool _gl_fs_move(void *data, const char *src, const char *dst)
        return EINA_TRUE;
 }
 
+/**
+ *
+ * @param file_path
+ * @param ext
+ * @return
+ */
 char *_gl_fs_get_unique_full_path(char *file_path, char *ext)
 {
        char *file_name = file_path;
@@ -496,6 +562,13 @@ char *_gl_fs_get_unique_full_path(char *file_path, char *ext)
        return final_path;
 }
 
+/**
+ *
+ * @param parent_path
+ * @param default_name
+ * @param new_name
+ * @return
+ */
 char *_gl_fs_get_unique_new_album_name(char *parent_path,
                                                                           char *default_name, char **new_name)
 {
@@ -570,6 +643,11 @@ char *_gl_fs_get_unique_new_album_name(char *parent_path,
        return final_path;
 }
 
+/**
+ *
+ * @param new_name
+ * @return
+ */
 bool _gl_fs_validate_name(const char *new_name)
 {
        GL_CHECK_FALSE(new_name);
@@ -592,6 +670,11 @@ bool _gl_fs_validate_name(const char *new_name)
        return true;
 }
 
+/**
+ *
+ * @param path
+ * @return
+ */
 bool _gl_fs_mkdir(const char *path)
 {
        GL_CHECK_FALSE(path);
index 5f07192..549e35e 100644 (file)
 #include "gl-thumbs-sel.h"
 #include "gl-thumbs-edit.h"
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static int __gl_lang_update_albums(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -42,6 +47,11 @@ static int __gl_lang_update_albums(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_lang_update(void *data)
 {
        char *locale = NULL;
index 32e83ba..46d6d95 100644 (file)
@@ -41,6 +41,11 @@ typedef struct {
 
 #define GL_TID syscall(__NR_gettid)
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static int _gl_thread_operate_medias(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -63,6 +68,11 @@ static int _gl_thread_operate_medias(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static int _gl_thread_update_view(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -80,6 +90,10 @@ static int _gl_thread_update_view(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ */
 static void *_gl_thread_data_thread(void *data)
 {
        GL_CHECK_NULL(data);
@@ -112,6 +126,11 @@ static void *_gl_thread_data_thread(void *data)
        return (void *) 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static Eina_Bool _gl_thread_del_pbar_idler_cb(void *data)
 {
        gl_dbg("Delete progressbar...");
@@ -128,6 +147,12 @@ static Eina_Bool _gl_thread_del_pbar_idler_cb(void *data)
        return ECORE_CALLBACK_CANCEL;
 }
 
+/**
+ *
+ * @param data
+ * @param buffer
+ * @param nbyte
+ */
 static void _gl_thread_pipe_cb(void *data, void *buffer,
                                                           unsigned int nbyte)
 {
@@ -559,6 +584,12 @@ int gl_thread_init_lock(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param op_cb
+ * @return
+ */
 int _gl_thread_set_op_cb(void *data, void *op_cb)
 {
        GL_CHECK_VAL(data, -1);
@@ -567,6 +598,12 @@ int _gl_thread_set_op_cb(void *data, void *op_cb)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param update_cb
+ * @return
+ */
 int _gl_thread_set_update_cb(void *data, void *update_cb)
 {
        GL_CHECK_VAL(data, -1);
@@ -575,6 +612,12 @@ int _gl_thread_set_update_cb(void *data, void *update_cb)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param del_item_cb
+ * @return
+ */
 int _gl_thread_set_del_item_cb(void *data, void *del_item_cb)
 {
        GL_CHECK_VAL(data, -1);
@@ -583,6 +626,12 @@ int _gl_thread_set_del_item_cb(void *data, void *del_item_cb)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param total_cnt
+ * @return
+ */
 int _gl_thread_set_total_cnt(void *data, int total_cnt)
 {
        GL_CHECK_VAL(data, -1);
index 1ef3307..870cc5c 100644 (file)
 #include "gl-strings.h"
 #include "gl-timeline.h"
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_ui_clear_btns(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -40,6 +45,13 @@ int _gl_ui_clear_btns(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param parent
+ * @param file
+ * @param group
+ * @return
+ */
 Evas_Object *gl_ui_load_edj(Evas_Object * parent, const char *file,
                                                        const char *group)
 {
@@ -60,6 +72,11 @@ Evas_Object *gl_ui_load_edj(Evas_Object * parent, const char *file,
        return eo;
 }
 
+/**
+ *
+ * @param btn
+ * @return
+ */
 int _gl_ui_disable_btn(Evas_Object * btn)
 {
        if (btn) {
@@ -69,6 +86,12 @@ int _gl_ui_disable_btn(Evas_Object * btn)
 }
 
 /* Set button more */
+/**
+ *
+ * @param nf_it
+ * @param b_disabled
+ * @return
+ */
 int _gl_ui_disable_menu(Elm_Object_Item * nf_it, bool b_disabled)
 {
        GL_CHECK_VAL(nf_it, -1);
@@ -82,6 +105,13 @@ int _gl_ui_disable_menu(Elm_Object_Item * nf_it, bool b_disabled)
 }
 
 /* Get button*/
+/**
+ *
+ * @param data
+ * @param nf_it
+ * @param part
+ * @return
+ */
 Evas_Object *_gl_ui_get_btn(void *data, Elm_Object_Item * nf_it,
                                                        const char *part)
 {
@@ -97,6 +127,14 @@ Evas_Object *_gl_ui_get_btn(void *data, Elm_Object_Item * nf_it,
        return elm_object_item_part_content_get(_nf_it, part);
 }
 
+/**
+ *
+ * @param view
+ * @param part1
+ * @param part2
+ * @param state
+ * @return
+ */
 int _gl_ui_update_realized_grid_ck(Evas_Object * view, const char *part1,
                                                                   const char *part2, Eina_Bool state)
 {
@@ -123,6 +161,13 @@ int _gl_ui_update_realized_grid_ck(Evas_Object * view, const char *part1,
        return 0;
 }
 
+/**
+ *
+ * @param it
+ * @param part
+ * @param state
+ * @return
+ */
 int _gl_ui_set_checkbox_state(Elm_Object_Item * it, const char *part,
                                                          Eina_Bool state)
 {
@@ -142,6 +187,11 @@ int _gl_ui_set_checkbox_state(Elm_Object_Item * it, const char *part,
        return 0;
 }
 
+/**
+ *
+ * @param obj
+ * @return
+ */
 int _gl_ui_reset_scroller_pos(Evas_Object * obj)
 {
        GL_CHECK_VAL(obj, -1);
@@ -152,6 +202,11 @@ int _gl_ui_reset_scroller_pos(Evas_Object * obj)
        return 0;
 }
 
+/**
+ *
+ * @param obj
+ * @return
+ */
 int _gl_ui_del_scroller_pos(Evas_Object * obj)
 {
        GL_CHECK_VAL(obj, -1);
@@ -162,6 +217,11 @@ int _gl_ui_del_scroller_pos(Evas_Object * obj)
        return 0;
 }
 
+/**
+ *
+ * @param obj
+ * @return
+ */
 int _gl_ui_save_scroller_pos(Evas_Object * obj)
 {
        GL_CHECK_VAL(obj, -1);
@@ -179,6 +239,11 @@ int _gl_ui_save_scroller_pos(Evas_Object * obj)
        return 0;
 }
 
+/**
+ *
+ * @param obj
+ * @return
+ */
 int _gl_ui_restore_scroller_pos(Evas_Object * obj)
 {
        GL_CHECK_VAL(obj, -1);
@@ -198,6 +263,12 @@ int _gl_ui_restore_scroller_pos(Evas_Object * obj)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param view_mode
+ * @return
+ */
 int _gl_ui_rotate_view(void *data, int view_mode)
 {
        GL_CHECK_VAL(data, -1);
@@ -223,6 +294,12 @@ int _gl_ui_rotate_view(void *data, int view_mode)
        return 0;
 }
 
+/**
+ *
+ * @param obj
+ * @param str
+ * @return
+ */
 int _gl_ui_set_translate_str(Evas_Object * obj, const char *str)
 {
        GL_CHECK_VAL(str, -1);
@@ -232,6 +309,12 @@ int _gl_ui_set_translate_str(Evas_Object * obj, const char *str)
        return 0;
 }
 
+/**
+ *
+ * @param nf_it
+ * @param str
+ * @return
+ */
 int _gl_ui_set_translatable_item(Elm_Object_Item * nf_it, const char *str)
 {
        GL_CHECK_VAL(str, -1);
@@ -241,6 +324,13 @@ int _gl_ui_set_translatable_item(Elm_Object_Item * nf_it, const char *str)
        return 0;
 }
 
+/**
+ *
+ * @param obj
+ * @param part
+ * @param str
+ * @return
+ */
 int _gl_ui_set_translate_part_str(Evas_Object * obj, const char *part,
                                                                  const char *str)
 {
@@ -254,6 +344,13 @@ int _gl_ui_set_translate_part_str(Evas_Object * obj, const char *part,
 }
 
 /* Change naviframe item title text */
+/**
+ *
+ * @param nf_it
+ * @param text
+ * @param b_dropdown
+ * @return
+ */
 int _gl_ui_change_navi_title(Elm_Object_Item * nf_it, char *text,
                                                         bool b_dropdown)
 {
@@ -265,6 +362,13 @@ int _gl_ui_change_navi_title(Elm_Object_Item * nf_it, char *text,
 }
 
 /* Update the label text for selected item showed in naviframe title  */
+/**
+ *
+ * @param nf_it
+ * @param sel_cnt
+ * @param b_lang
+ * @return
+ */
 int _gl_ui_update_navi_title_text(Elm_Object_Item * nf_it, int sel_cnt,
                                                                  bool b_lang)
 {
@@ -301,6 +405,15 @@ int _gl_ui_update_navi_title_text(Elm_Object_Item * nf_it, int sel_cnt,
        return 0;
 }
 
+/**
+ *
+ * @param parent
+ * @param part
+ * @param part_btn
+ * @param cb_func
+ * @param data
+ * @return
+ */
 int _gl_ui_add_selall_ck(Evas_Object * parent, char *part, char *part_btn,
                                                 Evas_Smart_Cb cb_func, void *data)
 {
@@ -332,6 +445,12 @@ int _gl_ui_add_selall_ck(Evas_Object * parent, char *part, char *part_btn,
        return 0;
 }
 
+/**
+ *
+ * @param view
+ * @param ck_part
+ * @return
+ */
 int _gl_show_grid_checks(Evas_Object * view, const char *ck_part)
 {
        GL_CHECK_VAL(ck_part, -1);
@@ -361,6 +480,13 @@ int _gl_show_grid_checks(Evas_Object * view, const char *ck_part)
        return 0;
 }
 
+/**
+ *
+ * @param view
+ * @param ck_part
+ * @param ck_part2
+ * @return
+ */
 int _gl_show_grid_checks_dual(Evas_Object * view, const char *ck_part,
                                                          const char *ck_part2)
 {
index a67a300..455ba63 100644 (file)
@@ -46,7 +46,11 @@ static int __internalStorageId = 0;
 
 gl_appdata *app_data = NULL;
 
-/* Use timer to show progressbar totally before write pipe */
+/**
+ * Use timer to show progressbar totally before write pipe
+ * @param data : Application data
+ * @return : ECORE_CALLBACK_CANCEL to cancel the next call
+ */
 static Eina_Bool _gl_start_thread_op_timer_cb(void *data)
 {
        gl_dbg("Emit START signal...");
@@ -59,9 +63,14 @@ static Eina_Bool _gl_start_thread_op_timer_cb(void *data)
 }
 
 /**
-* Use thread to move/copy/delete/add tag to/remove tag from medias
-* for displaying progrssabar UI
-*/
+ * Use thread to move/copy/delete/add tag to/remove tag from medias
+ * for displaying progrssabar UI
+ * @param data
+ * @param pbar_title
+ * @param all_cnt
+ * @param op_type
+ * @return
+ */
 int _gl_use_thread_operate_medias(void *data, char *pbar_title,
                                                                  int all_cnt, int op_type)
 {
@@ -96,6 +105,15 @@ int _gl_use_thread_operate_medias(void *data, char *pbar_title,
        return 0;
 }
 
+/**
+ *
+ * @param storageId
+ * @param type
+ * @param state
+ * @param path
+ * @param data
+ * @return
+ */
 bool __gl_util_get_supported_storages_callback(int storageId,
                                                                                           storage_type_e type,
                                                                                           storage_state_e state,
@@ -113,6 +131,11 @@ bool __gl_util_get_supported_storages_callback(int storageId,
        return true;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static Eina_Bool __gl_db_update_noti_idler_cb(void *data)
 {
        GL_CHECK_FALSE(data);
@@ -171,6 +194,12 @@ static Eina_Bool __gl_db_update_noti_idler_cb(void *data)
        return ECORE_CALLBACK_CANCEL;
 }
 
+/**
+ *
+ * @param storage_id
+ * @param state
+ * @param user_data
+ */
 void _gl_db_update_sdcard_info(int storage_id, storage_state_e state,
                                                           void *user_data)
 {
@@ -183,6 +212,12 @@ void _gl_db_update_sdcard_info(int storage_id, storage_state_e state,
                                                                                         user_data);
 }
 
+/**
+ *
+ * @param data
+ * @param status
+ * @return
+ */
 static inline int __gl_set_sound_status(void *data, int status)
 {
        GL_CHECK_VAL(data, -1);
@@ -191,6 +226,11 @@ static inline int __gl_set_sound_status(void *data, int status)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static int __gl_get_sound_status(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -209,12 +249,22 @@ static int __gl_get_sound_status(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param key
+ * @param data
+ */
 static void __gl_change_sound_status_cb(system_settings_key_e key,
                                                                                void *data)
 {
        __gl_get_sound_status(data);
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static int __gl_reg_svi_noti(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -229,6 +279,10 @@ static int __gl_reg_svi_noti(void *data)
        return 0;
 }
 
+/**
+ *  Un Resgister system setting CB
+ * @return : 0 if un register is success else -1
+ */
 static int __gl_dereg_svi_noti(void)
 {
        int retcode =
@@ -241,7 +295,11 @@ static int __gl_dereg_svi_noti(void)
        return 0;
 }
 
-/* Check if there is any MMC file contained in select_medias_elist */
+/**
+ * Check if there is any MMC file contained in select_medias_elist
+ * @param data
+ * @return
+ */
 static bool _gl_check_mmc_file_selected(void *data)
 {
        gl_dbg("");
@@ -272,7 +330,13 @@ static bool _gl_check_mmc_file_selected(void *data)
        return false;
 }
 
-/* Copy thumbnail and file */
+/**
+ * Copy Thumbnail and file
+ * @param data
+ * @param src
+ * @param dst
+ * @return
+ */
 static Eina_Bool __gl_file_cp(void *data, const char *src, const char *dst)
 {
        GL_CHECK_FALSE(src);
@@ -290,7 +354,15 @@ static Eina_Bool __gl_file_cp(void *data, const char *src, const char *dst)
        return EINA_TRUE;
 }
 
-/* Move thumbnail and file */
+/**
+ * Move thumbnail and file
+ * @param data
+ * @param gitem
+ * @param src
+ * @param dst
+ * @param mc_mode
+ * @return
+ */
 static Eina_Bool __gl_file_mv(void *data, gl_item * gitem, const char *src,
                                                          const char *dst, int mc_mode)
 {
@@ -312,6 +384,13 @@ static Eina_Bool __gl_file_mv(void *data, gl_item * gitem, const char *src,
        return EINA_TRUE;
 }
 
+/**
+ *
+ * @param entry
+ * @param entry_text
+ * @param len_max
+ * @return
+ */
 int gl_get_entry_text(Evas_Object * entry, char *entry_text, int len_max)
 {
        gl_dbg("");
@@ -347,10 +426,14 @@ int gl_get_entry_text(Evas_Object * entry, char *entry_text, int len_max)
 }
 
 /**
-* Change utf8 string to markup, then set it as entry text.
-* To fix special character "&" issue,  to convert "&" to "&amp;". f.e.
-* Myfiles->rename folder to AB&C->Gallery/Rename ->displayed as "AB"
-*/
+ * Change utf8 string to markup, then set it as entry text.
+ * To fix special character "&" issue,  to convert "&" to "&amp;". f.e.
+ * Myfiles->rename folder to AB&C->Gallery/Rename ->displayed as "AB"
+ *
+ * @param entry
+ * @param entry_text
+ * @return
+ */
 int gl_set_entry_text(Evas_Object * entry, char *entry_text)
 {
        GL_CHECK_VAL(entry, -1);
@@ -372,6 +455,12 @@ int gl_set_entry_text(Evas_Object * entry, char *entry_text)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param album_name
+ * @return
+ */
 int _gl_validate_album_name(void *data, char *album_name)
 {
        GL_CHECK_VAL(album_name, -1);
@@ -463,6 +552,11 @@ char *_gl_get_i18n_album_name(gl_album_s * cluster)
        return i18n_name;
 }
 
+/**
+ *
+ * @param name
+ * @return
+ */
 bool gl_make_new_album(const char *name)
 {
        gl_dbg("");
@@ -483,7 +577,16 @@ bool gl_make_new_album(const char *name)
        return isSuccessful;
 }
 
-/* Used for loal medias, thumbnail was moved to new dest first, then rename file */
+/**
+ * Used for loal medias, thumbnail was moved to new dest first, then rename file
+ * @param data
+ * @param gitem
+ * @param new_dir_name
+ * @param is_full_path
+ * @param popup_op
+ * @param mc_mode
+ * @return
+ */
 int _gl_move_media_thumb(void *data, gl_item * gitem, char *new_dir_name,
                                                 bool is_full_path, int *popup_op, int mc_mode)
 {
@@ -562,7 +665,15 @@ int _gl_move_media_thumb(void *data, gl_item * gitem, char *new_dir_name,
        }
 }
 
-/* Used for loal medias, thumbnail was moved to new dest first, then rename file */
+/**
+ * Used for loal medias, thumbnail was moved to new dest first, then rename file
+ * @param data
+ * @param uuid
+ * @param new_dir_name
+ * @param popup_op
+ * @param mc_mode
+ * @return
+ */
 int _gl_move_media_thumb_by_id(void *data, const char *uuid,
                                                           char *new_dir_name, int *popup_op,
                                                           int mc_mode)
@@ -658,10 +769,10 @@ int _gl_move_media_thumb_by_id(void *data, const char *uuid,
 }
 
 /**
-* Check if there is any media in Gallery.
-*
-* False returned if none medias exist, other return True.
-*/
+ * Check if there is any media in Gallery.
+ * @param data
+ * @return : False if none medias exist, else True.
+ */
 bool gl_check_gallery_empty(void *data)
 {
        GL_CHECK_FALSE(data);
@@ -686,9 +797,12 @@ bool gl_check_gallery_empty(void *data)
        return false;
 }
 
-/*
-* Check MMC state(Inserted/Removed) for Move/Delete/Add tag/Remove.
-*/
+/**
+ * Check MMC state(Inserted/Removed) for Move/Delete/Add tag/Remove.
+ * @param data
+ * @param dest_folder
+ * @return
+ */
 int gl_check_mmc_state(void *data, char *dest_folder)
 {
        GL_CHECK_VAL(data, -1);
@@ -746,6 +860,11 @@ int gl_check_mmc_state(void *data, char *dest_folder)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static int __gl_reg_db_noti(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -783,6 +902,11 @@ static int __gl_reg_db_noti(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static int __gl_dereg_db_noti(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -799,9 +923,11 @@ static int __gl_dereg_db_noti(void *data)
        return 0;
 }
 
-/*
-* Get view mode of app
-*/
+/**
+ * Get view mode of app
+ * @param data
+ * @return
+ */
 int gl_get_view_mode(void *data)
 {
        GL_CHECK_VAL(data, GL_VIEW_NONE);
@@ -809,9 +935,12 @@ int gl_get_view_mode(void *data)
        return ad->maininfo.view_mode;
 }
 
-/*
-* Set view mode of app
-*/
+/**
+ * Set view mode of app
+ * @param data
+ * @param mode
+ * @return
+ */
 int gl_set_view_mode(void *data, int mode)
 {
        GL_CHECK_VAL(data, -1);
@@ -820,6 +949,12 @@ int gl_set_view_mode(void *data, int mode)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param invalid_m
+ * @return
+ */
 int gl_del_invalid_widgets(void *data, int invalid_m)
 {
        GL_CHECK_VAL(data, -1);
@@ -857,7 +992,11 @@ int gl_del_invalid_widgets(void *data, int invalid_m)
        return 0;
 }
 
-/* 'Delete medias' is available in tab Albums and Places */
+/**
+ * 'Delete medias' is available in tab Albums and Places
+ * @param data
+ * @return
+ */
 static int __gl_del_medias_op(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -893,6 +1032,12 @@ static int __gl_del_medias_op(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param noti_str
+ * @return
+ */
 int _gl_update_operation_view(void *data, const char *noti_str)
 {
        GL_CHECK_VAL(data, -1);
@@ -936,7 +1081,11 @@ int _gl_update_operation_view(void *data, const char *noti_str)
        return 0;
 }
 
-/* Update view after deleting process done */
+/**
+ * Update view after deleting process done
+ * @param data
+ * @return
+ */
 static int __gl_update_del_medias_view(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -961,6 +1110,11 @@ static int __gl_update_del_medias_view(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param path
+ * @return
+ */
 char *_gl_delete_folder(char *path)
 {
        GL_CHECK_NULL(path);
@@ -985,6 +1139,11 @@ char *_gl_delete_folder(char *path)
        return path;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int gl_del_medias(void *data)
 {
        gl_dbg("");
@@ -1006,7 +1165,12 @@ int gl_del_medias(void *data)
        return 0;
 }
 
-/* 'Delete medias' is available in Dali view */
+/**
+ * Delete media by selected ID
+ * @param data
+ * @param uuid
+ * @return
+ */
 int _gl_del_media_by_id(void *data, const char *uuid)
 {
        GL_CHECK_VAL(uuid, -1);
@@ -1069,6 +1233,13 @@ int _gl_del_media_by_id(void *data, const char *uuid)
        return -1;
 }
 
+/**
+ *
+ * @param data
+ * @param album_item
+ * @param is_hide
+ * @return
+ */
 int gl_remove_album(void *data, gl_cluster * album_item, bool is_hide)
 {
        GL_CHECK_VAL(data, -1);
@@ -1091,6 +1262,11 @@ int gl_remove_album(void *data, gl_cluster * album_item, bool is_hide)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static int __gl_update_del_albums_view(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1101,7 +1277,11 @@ static int __gl_update_del_albums_view(void *data)
        return 0;
 }
 
-/* delete albums */
+/**
+ * Delete Albums
+ * @param data
+ * @return
+ */
 static int __gl_del_albums_op(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1130,6 +1310,11 @@ static int __gl_del_albums_op(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_del_albums(void *data)
 {
        gl_dbg("");
@@ -1151,6 +1336,12 @@ int _gl_del_albums(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param p_elist
+ * @return
+ */
 int _gl_data_update_sel_item_list(void *data, Eina_List * p_elist)
 {
        GL_CHECK_VAL(data, -1);
@@ -1169,8 +1360,12 @@ int _gl_data_update_sel_item_list(void *data, Eina_List * p_elist)
        return 0;
 }
 
-/* b_path == true, Use saved folder path to check cluster uuid
- * b_select == true, Update albums in select view for tag adding
+/**
+ *
+ * @param data
+ * @param b_path : true, Use saved folder path to check cluster uuid
+ * @param b_select  :true, Update albums in select view for tag adding
+ * @return
  */
 int _gl_refresh_albums_list(void *data, bool b_path, bool b_select)
 {
@@ -1271,6 +1466,11 @@ int _gl_refresh_albums_list(void *data, bool b_path, bool b_select)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_update_albums_data(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1298,12 +1498,21 @@ int _gl_update_albums_data(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_update_albums_list(void *data)
 {
        return _gl_refresh_albums_list(data, false, false);
 }
 
-/* 'Move medias' is only available in tab Albums */
+/**
+ *
+ * @param data
+ * @return
+ */
 static int __gl_move_copy_op(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1353,7 +1562,11 @@ static int __gl_move_copy_op(void *data)
        return 0;
 }
 
-/* Update view after moving process done */
+/**
+ * Update view after moving process done
+ * @param data
+ * @return
+ */
 static int __gl_update_move_copy_view(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1404,6 +1617,10 @@ static int __gl_update_move_copy_view(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param path
+ */
 unsigned long long _gl_get_file_storage_space_required(char *path)
 {
        struct stat info;
@@ -1415,6 +1632,11 @@ unsigned long long _gl_get_file_storage_space_required(char *path)
        return size;
 }
 
+/**
+ *
+ * @param data
+ * @param total_space
+ */
 void _gl_get_total_space_required(void *data,
                                                                  unsigned long long *total_space)
 {
@@ -1433,6 +1655,11 @@ void _gl_get_total_space_required(void *data,
 
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int gl_move_copy_to_album(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1532,6 +1759,12 @@ int gl_move_copy_to_album(void *data)
        return -1;
 }
 
+/**
+ *
+ * @param data
+ * @param mode
+ * @return
+ */
 Eina_Bool gl_update_view(void *data, int mode)
 {
        GL_CHECK_FALSE(data);
@@ -1609,11 +1842,13 @@ Eina_Bool gl_update_view(void *data, int mode)
 }
 
 /**
-* It's in thumbnails view, video list view, or selectioinfo view.
-* Destroy invalid widegets or UGs.
-* Pop current invalid view to controlbar layout,
-* to show Albums view/Map/Tags view.
-*/
+ * It's in thumbnails view, video list view, or selectioinfo view.
+ * Destroy invalid widegets or UGs.
+ * Pop current invalid view to controlbar layout,
+ * to show Albums view/Map/Tags view.
+ * @param data
+ * @return
+ */
 int gl_pop_to_ctrlbar_ly(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1643,13 +1878,17 @@ int gl_pop_to_ctrlbar_ly(void *data)
        return 0;
 }
 
-/* Change int to char * of video duration, caller need to free the allocated memory */
+/**
+ * Change int to char * of video duration, caller need to free the allocated memory
+ * @param v_dur
+ * @return
+ */
 char *_gl_get_duration_string(unsigned int v_dur)
 {
        char *dur_str = calloc(1, GL_FILE_PATH_LEN_MAX);
        GL_CHECK_NULL(dur_str);
        if (v_dur > 0) {
-               int duration = (int) floor(v_dur / GL_TIME_MSEC_PER_SEC);
+               int duration = v_dur / GL_TIME_MSEC_PER_SEC;
                int dur_hr = 0;
                int dur_min = 0;
                int dur_sec = 0;
@@ -1657,12 +1896,12 @@ char *_gl_get_duration_string(unsigned int v_dur)
 
                if (duration >= GL_TIME_SEC_PER_HOUR) {
                        dur_sec = duration % GL_TIME_SEC_PER_MIN;
-                       tmp = floor(duration / GL_TIME_SEC_PER_MIN);
+                       tmp = duration / GL_TIME_SEC_PER_MIN;
                        dur_min = tmp % GL_TIME_MIN_PER_HOUR;
-                       dur_hr = floor(tmp / GL_TIME_MIN_PER_HOUR);
+                       dur_hr = tmp / GL_TIME_MIN_PER_HOUR;
                } else if (duration >= GL_TIME_SEC_PER_MIN) {
                        dur_hr = 0;
-                       dur_min = floor(duration / GL_TIME_SEC_PER_MIN);
+                       dur_min = duration / GL_TIME_SEC_PER_MIN;
                        dur_sec = duration % GL_TIME_SEC_PER_MIN;
                } else {
                        dur_hr = 0;
@@ -1679,6 +1918,11 @@ char *_gl_get_duration_string(unsigned int v_dur)
        return dur_str;
 }
 
+/**
+ *
+ * @param str_id
+ * @return
+ */
 char *_gl_str(char *str_id)
 {
        GL_CHECK_NULL(str_id);
@@ -1689,6 +1933,11 @@ char *_gl_str(char *str_id)
        }
 }
 
+/**
+ *
+ * @param str_id
+ * @return
+ */
 bool _gl_is_str_id(const char *str_id)
 {
        GL_CHECK_NULL(str_id);
@@ -1699,6 +1948,13 @@ bool _gl_is_str_id(const char *str_id)
        }
 }
 
+/**
+ *
+ * @param win
+ * @param width
+ * @param height
+ * @return
+ */
 double _gl_get_win_factor(Evas_Object * win, int *width, int *height)
 {
        if (win == NULL) {
@@ -1744,6 +2000,11 @@ double _gl_get_win_factor(Evas_Object * win, int *width, int *height)
        return factor;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_reg_storage_state_change_notify(void *data)
 {
        __gl_reg_db_noti(data);
@@ -1751,6 +2012,11 @@ int _gl_reg_storage_state_change_notify(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_dereg_storage_state_change_notify(void *data)
 {
        __gl_dereg_db_noti(data);
@@ -1758,6 +2024,15 @@ int _gl_dereg_storage_state_change_notify(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param op_cb
+ * @param del_item_cb
+ * @param update_cb
+ * @param total_cnt
+ * @return
+ */
 int _gl_set_file_op_cbs(void *data, void *op_cb, void *del_item_cb,
                                                void *update_cb, int total_cnt)
 {
@@ -1769,6 +2044,12 @@ int _gl_set_file_op_cbs(void *data, void *op_cb, void *del_item_cb,
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param item
+ * @return
+ */
 int _gl_append_album_images_path(void *data, gl_media_s * item)
 {
        GL_CHECK_VAL(item, -1);
@@ -1785,6 +2066,11 @@ int _gl_append_album_images_path(void *data, gl_media_s * item)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_free_selected_list(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -1798,6 +2084,10 @@ int _gl_free_selected_list(void *data)
        return 0;
 }
 
+/**
+ *
+ * @return
+ */
 char *_gl_get_edje_path(void)
 {
        char edj_path[1024] = { 0 };
@@ -1810,6 +2100,12 @@ char *_gl_get_edje_path(void)
        return strdup(edj_path);
 }
 
+/**
+ *
+ * @param storage_id
+ * @param directory
+ * @return
+ */
 static char *__gl_get_folder_path(int storage_id, int directory)
 {
        char *path = NULL;
@@ -1828,25 +2124,41 @@ static char *__gl_get_folder_path(int storage_id, int directory)
        return path;
 }
 
+/**
+ *
+ * @return
+ */
 char *_gl_get_camera_folder_path_internal(void)
 {
        return __gl_get_folder_path(__internalStorageId,
                                                                STORAGE_DIRECTORY_CAMERA);
 }
 
+/**
+ *
+ * @return
+ */
 char *_gl_get_camera_folder_path_external(void)
 {
        return __gl_get_folder_path(__externalStorageId,
                                                                STORAGE_DIRECTORY_CAMERA);
 }
 
+/**
+ *
+ * @return
+ */
 char *_gl_get_downloads_folder_path(void)
 {
        return __gl_get_folder_path(__internalStorageId,
                                                                STORAGE_DIRECTORY_DOWNLOADS);
 }
 
-
+/**
+ *
+ * @param storage_directory_type
+ * @return
+ */
 char *_gl_get_directory_path(int storage_directory_type)
 {
        char *path = NULL;
@@ -1855,6 +2167,11 @@ char *_gl_get_directory_path(int storage_directory_type)
        return path;
 }
 
+/**
+ *
+ * @param storage_type
+ * @return
+ */
 char *_gl_get_root_directory_path(int storage_type)
 {
        char *path = NULL;
@@ -1862,6 +2179,10 @@ char *_gl_get_root_directory_path(int storage_type)
        return path;
 }
 
+/**
+ *
+ * @param data
+ */
 static void _gl_save_state_in_ini_file(char *data)
 {
        char *path_gallery = app_get_shared_data_path();
@@ -1887,6 +2208,10 @@ static void _gl_save_state_in_ini_file(char *data)
 
 }
 
+/**
+ *
+ * @param data
+ */
 void _gl_set_launch_state_preference(void *data)
 {
        int ret;
@@ -1903,6 +2228,10 @@ void _gl_set_launch_state_preference(void *data)
        }
 }
 
+/**
+ *
+ * @return
+ */
 bool _gl_get_launch_state_preference()
 {
        int ret;
@@ -1916,16 +2245,29 @@ bool _gl_get_launch_state_preference()
        return launch_state;
 }
 
+/**
+ *
+ * @param ad
+ */
 void _gl_set_app_data(void *ad)
 {
        app_data = (gl_appdata *)ad;
 }
 
+/**
+ *
+ */
 void *_gl_get_app_data()
 {
        return (void *)app_data;
 }
 
+/**
+ *
+ * @param data
+ * @param current
+ * @return
+ */
 int _gl_albums_set_current(void *data, gl_cluster * current)
 {
        GL_CHECK_VAL(data, -1);
@@ -1934,6 +2276,11 @@ int _gl_albums_set_current(void *data, gl_cluster * current)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 gl_cluster *_gl_albums_get_current(void *data)
 {
        GL_CHECK_NULL(data);
@@ -1941,6 +2288,10 @@ gl_cluster *_gl_albums_get_current(void *data)
        return ad->albuminfo.current;
 }
 
+/**
+ *
+ * @param data
+ */
 void _gl_set_reorder_value(void *data)
 {
        GL_CHECK(data);
@@ -1966,6 +2317,9 @@ void _gl_set_reorder_value(void *data)
        }
 }
 
+/**
+ *
+ */
 void _gl_set_reorder_state_preference()
 {
        int ret;
index 8b37067..12fed93 100644 (file)
@@ -86,6 +86,17 @@ Evas_Object *_gl_but_create_but(Evas_Object * parent, const char *icon,
        return btn;
 }
 
+/**
+ *
+ * @param parent
+ * @param icon
+ * @param text
+ * @param style
+ * @param cb_func
+ * @param data
+ * @param flag_propagate
+ * @return
+ */
 Evas_Object *_gl_but_create_image_but(Evas_Object * parent,
                                                                          const char *icon, const char *text,
                                                                          const char *style,
@@ -121,6 +132,14 @@ Evas_Object *_gl_but_create_image_but(Evas_Object * parent,
        return btn;
 }
 
+/**
+ *
+ * @param parent
+ * @param text
+ * @param cb_func
+ * @param data
+ * @return
+ */
 Evas_Object *_gl_but_create_but_popup(Evas_Object * parent,
                                                                          const char *text,
                                                                          Evas_Smart_Cb cb_func,
index bacad1a..8e4c664 100644 (file)
 #include "gl-timeline.h"
 #include "gl-albums-edit.h"
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static int __gl_ctrl_reset_previous_tab(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -48,6 +53,12 @@ static int __gl_ctrl_reset_previous_tab(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param label
+ * @return
+ */
 int _gl_ctrl_show_view(void *data, const char *label)
 {
        GL_PROFILE_IN;
@@ -81,7 +92,12 @@ int _gl_ctrl_show_view(void *data, const char *label)
        return 0;
 }
 
-/* Enable all buttons except for some special cases */
+/**
+ * Enable all buttons except for some special cases
+ * @param ad
+ * @param nf_it
+ * @return
+ */
 static int __gl_ctrl_enable_btns(gl_appdata * ad, Elm_Object_Item * nf_it)
 {
        gl_dbg("");
@@ -100,6 +116,11 @@ static int __gl_ctrl_enable_btns(gl_appdata * ad, Elm_Object_Item * nf_it)
        return 0;
 }
 
+/**
+ *
+ * @param parent
+ * @return
+ */
 Evas_Object *_gl_ctrl_add_layout(Evas_Object * parent)
 {
        GL_CHECK_NULL(parent);
@@ -118,6 +139,11 @@ Evas_Object *_gl_ctrl_add_layout(Evas_Object * parent)
        return layout;
 }
 
+/**
+ *
+ * @param parent
+ * @return
+ */
 Evas_Object *_gl_ctrl_add_main_layout(Evas_Object * parent)
 {
        GL_PROFILE_IN;
@@ -136,6 +162,12 @@ Evas_Object *_gl_ctrl_add_main_layout(Evas_Object * parent)
        return layout;
 }
 
+/**
+ *
+ * @param data
+ * @param tab_mode
+ * @return
+ */
 int _gl_ctrl_show_title(void *data, int tab_mode)
 {
        GL_PROFILE_IN;
@@ -166,6 +198,12 @@ int _gl_ctrl_show_title(void *data, int tab_mode)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param tab_mode
+ * @return
+ */
 int _gl_ctrl_sel_tab(void *data, int tab_mode)
 {
        gl_dbg("_gl_ctrl_sel_tab");
@@ -193,6 +231,12 @@ int _gl_ctrl_sel_tab(void *data, int tab_mode)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param mode
+ * @return
+ */
 int _gl_ctrl_set_tab_mode(void *data, int mode)
 {
        GL_CHECK_VAL(data, -1);
@@ -202,6 +246,11 @@ int _gl_ctrl_set_tab_mode(void *data, int mode)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_ctrl_get_tab_mode(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -209,11 +258,23 @@ int _gl_ctrl_get_tab_mode(void *data)
        return ad->ctrlinfo.tab_mode;
 }
 
+/**
+ *
+ * @param data
+ * @param nf_it
+ * @return
+ */
 int _gl_ctrl_enable_btns(void *data, Elm_Object_Item * nf_it)
 {
        return __gl_ctrl_enable_btns(data, nf_it);
 }
 
+/**
+ *
+ * @param nf_it
+ * @param b_disabled
+ * @return
+ */
 int _gl_ctrl_disable_items(Elm_Object_Item * nf_it, bool b_disabled)
 {
        GL_CHECK_VAL(nf_it, -1);
@@ -239,6 +300,12 @@ int _gl_ctrl_disable_items(Elm_Object_Item * nf_it, bool b_disabled)
        return 0;
 }
 
+/**
+ *
+ * @param it
+ * @param b_disabled
+ * @return
+ */
 int _gl_ctrl_disable_item(Elm_Object_Item * it, Eina_Bool b_disabled)
 {
        GL_CHECK_VAL(it, -1);
index 7705deb..cb88744 100644 (file)
@@ -29,6 +29,11 @@ struct _gl_ctx_data_t {
        int items_count;
 };
 
+/**
+ *
+ * @param data
+ * @param ctxpopup
+ */
 static void __gl_ctxpopup_move_for_hwkey(void *data,
                                                                                 Evas_Object * ctxpopup)
 {
@@ -64,6 +69,16 @@ static void __gl_ctxpopup_move_for_hwkey(void *data,
        evas_object_move(ctxpopup, move_x, move_y);
 }
 
+/**
+ *
+ * @param data
+ * @param btn
+ * @param x
+ * @param y
+ * @param w
+ * @param h
+ * @return
+ */
 static bool __gl_ctxpopup_check_btn_pos(void *data, Evas_Object * btn,
                                                                                int x, int y, int w, int h)
 {
@@ -83,6 +98,11 @@ static bool __gl_ctxpopup_check_btn_pos(void *data, Evas_Object * btn,
        return false;
 }
 
+/**
+ *
+ * @param label_id
+ * @return
+ */
 static char *__gl_ctxpopup_get_icon(char *label_id)
 {
        GL_CHECK_NULL(label_id);
@@ -114,6 +134,12 @@ static char *__gl_ctxpopup_get_icon(char *label_id)
        return path;
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_ctxpopup_hide_cb(void *data, Evas_Object * obj, void *ei)
 {
        GL_CHECK(obj);
@@ -139,7 +165,13 @@ static void __gl_ctxpopup_hide_cb(void *data, Evas_Object * obj, void *ei)
        }
 }
 
-/* Basic winset: ctxpopup only activated from more button */
+/**
+ *
+ * @param data
+ * @param btn
+ * @param ctxpopup
+ * @return
+ */
 static int __gl_ctxpopup_show(void *data, Evas_Object * btn,
                                                          Evas_Object * ctxpopup)
 {
@@ -175,6 +207,13 @@ static int __gl_ctxpopup_show(void *data, Evas_Object * btn,
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param obj
+ * @param ei
+ */
 static void __gl_ctxpopup_parent_resize_cb(void *data, Evas * e,
                                                                                   Evas_Object * obj, void *ei)
 {
@@ -184,6 +223,12 @@ static void __gl_ctxpopup_parent_resize_cb(void *data, Evas * e,
                                                 (void *) true);
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_ctxpopup_items_update_cb(void *data, Evas_Object * obj,
                                                                                  void *ei)
 {
@@ -198,7 +243,12 @@ static void __gl_ctxpopup_items_update_cb(void *data, Evas_Object * obj,
        }
 }
 
-
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_ctxpopup_rotate_cb(void *data, Evas_Object * obj,
                                                                        void *ei)
 {
@@ -213,6 +263,13 @@ static void __gl_ctxpopup_rotate_cb(void *data, Evas_Object * obj,
        __gl_ctxpopup_show(data, more_btn, ad->maininfo.ctxpopup);
 }
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param obj
+ * @param ei
+ */
 static void __gl_ctxpopup_del_cb(void *data, Evas * e, Evas_Object * obj,
                                                                 void *ei)
 {
@@ -243,6 +300,12 @@ static void __gl_ctxpopup_del_cb(void *data, Evas * e, Evas_Object * obj,
        gl_dbg("done");
 }
 
+/**
+ *
+ * @param data
+ * @param ctxpopup
+ * @return
+ */
 static int __gl_ctxpopup_add_callbacks(void *data, Evas_Object * ctxpopup)
 {
        GL_CHECK_VAL(data, -1);
@@ -270,6 +333,14 @@ static int __gl_ctxpopup_add_callbacks(void *data, Evas_Object * ctxpopup)
        return 0;
 }
 
+/**
+ *
+ * @param obj
+ * @param label_id
+ * @param func
+ * @param data
+ * @return
+ */
 Elm_Object_Item *_gl_ctxpopup_append(Evas_Object * obj, char *label_id,
                                                                         Evas_Smart_Cb func, const void *data)
 {
@@ -292,6 +363,13 @@ Elm_Object_Item *_gl_ctxpopup_append(Evas_Object * obj, char *label_id,
                                                                        data);
 }
 
+/**
+ *
+ * @param data
+ * @param but
+ * @param append_cb
+ * @return
+ */
 int _gl_ctxpopup_create(void *data, Evas_Object * but,
                                                ctx_append_cb append_cb)
 {
@@ -337,6 +415,11 @@ int _gl_ctxpopup_create(void *data, Evas_Object * but,
        return __gl_ctxpopup_show(data, but, ctxpopup);
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_ctxpopup_del(void *data)
 {
        GL_CHECK_VAL(data, -1);
index e6ed497..5c31eb1 100644 (file)
 /* Maximum number of entry string, 50 Chars of album name (UI) */
 #define GL_ENTRY_STR_CHAR_MAX 50
 
-/* The maximun length reached callback */
+/**
+ * The maximun length reached callback
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_editfield_maxlen_reached_cb(void *data, Evas_Object * obj,
                                                                                         void *ei)
 {
@@ -32,11 +37,14 @@ static void __gl_editfield_maxlen_reached_cb(void *data, Evas_Object * obj,
        _gl_notify_create_notiinfo(_gl_str(GL_STR_ID_MAX_NO_CHARS_REACHED));
 }
 
-/*
-* Callback registered to signal 'changed' of entry.
-* It would get the entry string and check whether it's different
-* with original string or not, if so, enable 'Done' button, other disable it.
-*/
+/**
+ * Callback registered to signal 'changed' of entry.
+ * It would get the entry string and check whether it's different
+ * with original string or not, if so, enable 'Done' button, other disable it.
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_editfield_space_check_cb(void *data, Evas_Object * obj,
                                                                                  void *ei)
 {
@@ -94,9 +102,12 @@ static void __gl_editfield_space_check_cb(void *data, Evas_Object * obj,
        GL_FREEIF(entry_utf8);
 }
 
-/*
-*   make a new album
-*/
+/**
+ * make a new album
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_editfield_enter_cb(void *data, Evas_Object * obj,
                                                                        void *ei)
 {
@@ -115,6 +126,14 @@ static void __gl_editfield_enter_cb(void *data, Evas_Object * obj,
        }
 }
 
+/**
+ *
+ * @param data
+ * @param layout
+ * @param entry
+ * @param default_label
+ * @return
+ */
 int __gl_editfield_set_entry(void *data, Evas_Object * layout,
                                                         Evas_Object * entry, char *default_label)
 {
@@ -156,7 +175,11 @@ int __gl_editfield_set_entry(void *data, Evas_Object * layout,
        return 0;
 }
 
-/* Hide input panel and entry cursor */
+/**
+ * Hide input panel and entry cursor
+ * @param data
+ * @return
+ */
 int _gl_editfield_hide_imf(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -171,7 +194,11 @@ int _gl_editfield_hide_imf(void *data)
        return 0;
 }
 
-/* Show input panel and entry cursor */
+/**
+ * Show input panel and entry cursor
+ * @param data
+ * @return
+ */
 int _gl_editfield_show_imf(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -186,6 +213,11 @@ int _gl_editfield_show_imf(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int _gl_editfield_destroy_imf(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -221,6 +253,11 @@ int _gl_editfield_destroy_imf(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 Evas_Object *_gl_editfield_get_entry(void *data)
 {
        GL_CHECK_NULL(data);
index ac764f5..e9b7ca9 100644 (file)
@@ -72,6 +72,13 @@ enum _gl_pinch_plan_t {
        GL_PINCH_PLAN_MAX
 };
 
+/**
+ *
+ * @param data
+ * @param object
+ * @param device
+ * @return
+ */
 static gl_pinch_event_s *__gl_gesture_create_event_obj(void *data,
                                                                                                           Evas_Object *
                                                                                                           object, int device)
@@ -95,6 +102,12 @@ static gl_pinch_event_s *__gl_gesture_create_event_obj(void *data,
        return ev;
 }
 
+/**
+ *
+ * @param data
+ * @param ev
+ * @return
+ */
 static int __gl_gesture_destroy_event_obj(void *data,
                                                                                  gl_pinch_event_s * ev)
 {
@@ -113,6 +126,12 @@ static int __gl_gesture_destroy_event_obj(void *data,
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param device
+ * @return
+ */
 static gl_pinch_event_s *__gl_gesture_get_event_obj(void *data, int device)
 {
        GL_CHECK_NULL(data);
@@ -130,6 +149,14 @@ static gl_pinch_event_s *__gl_gesture_get_event_obj(void *data, int device)
        return ev;
 }
 
+/**
+ *
+ * @param x1
+ * @param y1
+ * @param x2
+ * @param y2
+ * @return
+ */
 static int __gl_gesture_get_distance(Evas_Coord x1, Evas_Coord y1,
                                                                         Evas_Coord x2, Evas_Coord y2)
 {
@@ -142,6 +169,11 @@ static int __gl_gesture_get_distance(Evas_Coord x1, Evas_Coord y1,
        return dis;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static Eina_Bool __gl_gesture_hold_timer_cb(void *data)
 {
        gl_pinch_event_s *ev0 = (gl_pinch_event_s *) data;
@@ -149,6 +181,11 @@ static Eina_Bool __gl_gesture_hold_timer_cb(void *data)
        return ECORE_CALLBACK_CANCEL;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static int __gl_gesture_get_multi_device(void *data)
 {
        GL_CHECK_VAL(data, -1);
@@ -164,6 +201,13 @@ static int __gl_gesture_get_multi_device(void *data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param evas_obj
+ * @param ei
+ */
 static void __gl_gesture_mouse_down_event(void *data, Evas * e,
                                                                                  Evas_Object * evas_obj, void *ei)
 {
@@ -188,6 +232,13 @@ static void __gl_gesture_mouse_down_event(void *data, Evas * e,
        ev0->prev.y = ev->output.y;
 }
 
+/**
+ *
+ * @param data
+ * @param evas
+ * @param obj
+ * @param ei
+ */
 static void __gl_gesture_multi_down_event(void *data, Evas * evas,
                                                                                  Evas_Object * obj, void *ei)
 {
@@ -212,6 +263,13 @@ static void __gl_gesture_multi_down_event(void *data, Evas * evas,
        ev->prev.y = down->output.y;
 }
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param obj
+ * @param ei
+ */
 static void __gl_gesture_mouse_up_event(void *data, Evas * e,
                                                                                Evas_Object * obj, void *ei)
 {
@@ -252,6 +310,13 @@ static void __gl_gesture_mouse_up_event(void *data, Evas * e,
        __gl_gesture_destroy_event_obj(data, ev0);
 }
 
+/**
+ *
+ * @param data
+ * @param evas
+ * @param obj
+ * @param ei
+ */
 static void __gl_gesture_multi_up_event(void *data, Evas * evas,
                                                                                Evas_Object * obj, void *ei)
 {
@@ -285,6 +350,13 @@ static void __gl_gesture_multi_up_event(void *data, Evas * evas,
        __gl_gesture_destroy_event_obj(data, ev);
 }
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param obj
+ * @param ei
+ */
 static void __gl_gesture_mouse_move_event(void *data, Evas * e,
                                                                                  Evas_Object * obj, void *ei)
 {
@@ -300,6 +372,10 @@ static void __gl_gesture_mouse_move_event(void *data, Evas * e,
        __gl_gesture_get_multi_device(data);
 }
 
+/**
+ *
+ * @param data
+ */
 static void __gl_gesture_zoom_out_job_cb(void *data)
 {
        GL_CHECK(data);
@@ -318,6 +394,10 @@ static void __gl_gesture_zoom_out_job_cb(void *data)
        GL_IF_DEL_JOB(gesture_d->pinch_job);
 }
 
+/**
+ *
+ * @param data
+ */
 static void __gl_gesture_zoom_in_job_cb(void *data)
 {
        GL_CHECK(data);
@@ -335,6 +415,13 @@ static void __gl_gesture_zoom_in_job_cb(void *data)
        GL_IF_DEL_JOB(gesture_d->pinch_job);
 }
 
+/**
+ *
+ * @param data
+ * @param evas
+ * @param obj
+ * @param ei
+ */
 static void __gl_gesture_multi_move_event(void *data, Evas * evas,
                                                                                  Evas_Object * obj, void *ei)
 {
@@ -440,6 +527,13 @@ static void __gl_gesture_multi_move_event(void *data, Evas * evas,
        gesture_d->dis_old = dis_new;
 }
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param obj
+ * @param ei
+ */
 static void __gl_gesture_del_cb(void *data, Evas * e, Evas_Object * obj,
                                                                void *ei)
 {
@@ -453,6 +547,12 @@ static void __gl_gesture_del_cb(void *data, Evas * e, Evas_Object * obj,
        gl_dbg("Delete gesture +++");
 }
 
+/**
+ *
+ * @param data
+ * @param parent
+ * @return
+ */
 Evas_Object *_gl_gesture_add(void *data, Evas_Object * parent)
 {
        GL_CHECK_NULL(parent);
@@ -498,6 +598,13 @@ Evas_Object *_gl_gesture_add(void *data, Evas_Object * parent)
        return gesture;
 }
 
+/**
+ *
+ * @param gesture
+ * @param cb
+ * @param data
+ * @return
+ */
 int _gl_gesture_set_zoom_in_cb(Evas_Object * gesture, gl_gesture_cb cb,
                                                           void *data)
 {
@@ -513,6 +620,13 @@ int _gl_gesture_set_zoom_in_cb(Evas_Object * gesture, gl_gesture_cb cb,
        return 0;
 }
 
+/**
+ *
+ * @param gesture
+ * @param cb
+ * @param data
+ * @return
+ */
 int _gl_gesture_set_zoom_out_cb(Evas_Object * gesture, gl_gesture_cb cb,
                                                                void *data)
 {
@@ -528,6 +642,11 @@ int _gl_gesture_set_zoom_out_cb(Evas_Object * gesture, gl_gesture_cb cb,
        return 0;
 }
 
+/**
+ *
+ * @param gesture
+ * @return
+ */
 int _gl_gesture_reset_flags(Evas_Object * gesture)
 {
        GL_CHECK_VAL(gesture, -1);
@@ -541,6 +660,11 @@ int _gl_gesture_reset_flags(Evas_Object * gesture)
        return 0;
 }
 
+/**
+ *
+ * @param gesture
+ * @return
+ */
 Evas_Object *_gl_gesture_get_parent(Evas_Object * gesture)
 {
        GL_CHECK_NULL(gesture);
index cdc03b7..b607612 100644 (file)
@@ -22,6 +22,8 @@
 
 /**
  * Create Nocontents.
+ * @param parent
+ * @return
  */
 Evas_Object *_gl_nocontents_create(Evas_Object * parent)
 {
@@ -46,6 +48,9 @@ Evas_Object *_gl_nocontents_create(Evas_Object * parent)
 
 /**
  * Update label of Nocontents.
+ * @param noc
+ * @param new_label
+ * @return
  */
 bool _gl_nocontents_update_label(Evas_Object * noc, const char *new_label)
 {
index f051c80..187fb80 100644 (file)
@@ -27,6 +27,11 @@ struct _gl_noti_t {
        int priv_id;
 };
 
+/**
+ *
+ * @param text
+ * @return
+ */
 int _gl_notify_create_notiinfo(const char *text)
 {
        GL_CHECK_VAL(text, -1);
@@ -38,8 +43,13 @@ int _gl_notify_create_notiinfo(const char *text)
 }
 
 /**
-* Check select-all widget state.
-*/
+ * Check select-all checkbox state.
+ * @param data
+ * @param nf_it
+ * @param all_cnt
+ * @param selected_cnt
+ * @return
+ */
 int _gl_notify_check_selall(void *data, Elm_Object_Item * nf_it,
                                                        int all_cnt, int selected_cnt)
 {
index b5189ad..39792c8 100644 (file)
@@ -76,6 +76,12 @@ struct _gl_popup_resize_t {
 
 static void __gl_popup_resp(void *data, const char *text);
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_popup_genlist_lang_changed(void *data, Evas_Object * obj,
                                                                                        void *ei)
 {
@@ -83,7 +89,11 @@ static void __gl_popup_genlist_lang_changed(void *data, Evas_Object * obj,
        elm_genlist_realized_items_update(obj);
 }
 
-/* Delete popup contents */
+/**
+ * Delete popup contents
+ * @param popup
+ * @return
+ */
 static int __gl_popup_clear_content(Evas_Object * popup)
 {
        GL_CHECK_VAL(popup, -1);
@@ -100,6 +110,11 @@ static int __gl_popup_clear_content(Evas_Object * popup)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static Eina_Bool __gl_popup_timeout_cb(void *data)
 {
        GL_CHECK_FALSE(data);
@@ -109,6 +124,12 @@ static Eina_Bool __gl_popup_timeout_cb(void *data)
        return ECORE_CALLBACK_CANCEL;
 }
 
+/**
+ *
+ * @param data
+ * @param to_inc
+ * @return
+ */
 static int __gl_popup_add_timer(void *data, double to_inc)
 {
        GL_CHECK_VAL(data, -1);
@@ -119,6 +140,12 @@ static int __gl_popup_add_timer(void *data, double to_inc)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param event_info
+ */
 static void __gl_popup_del_resp_cb(void *data, Evas_Object * obj,
                                                                   void *event_info)
 {
@@ -149,6 +176,11 @@ static void __gl_popup_del_resp_cb(void *data, Evas_Object * obj,
        }
 }
 
+/**
+ *
+ * @param data
+ * @param text
+ */
 static void __gl_popup_resp(void *data, const char *text)
 {
        GL_CHECK(data);
@@ -235,6 +267,12 @@ static void __gl_popup_resp(void *data, const char *text)
        GL_IF_DEL_OBJ(ad->popupinfo.popup);
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_popup_resp_cb(void *data, Evas_Object * obj, void *ei)
 {
        GL_CHECK(data);
@@ -248,6 +286,13 @@ static void __gl_popup_resp_cb(void *data, Evas_Object * obj, void *ei)
        __gl_popup_resp(data, text);
 }
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param obj
+ * @param ei
+ */
 static void __gl_popup_genlist_delete_cb(void *data, Evas * e,
                                                                                 Evas_Object * obj, void *ei)
 {
@@ -268,6 +313,13 @@ static void __gl_popup_genlist_delete_cb(void *data, Evas * e,
        gl_dbg("Delete genlist +++");
 }
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param obj
+ * @param event_info
+ */
 static void __gl_popup_mouseup_cb(void *data, Evas * e, Evas_Object * obj,
                                                                  void *event_info)
 {
@@ -281,7 +333,12 @@ static void __gl_popup_mouseup_cb(void *data, Evas * e, Evas_Object * obj,
        }
 }
 
-/* We need to perform cancellation, not just delete popup */
+/**
+ * We need to perform cancellation, not just delete popup
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static inline void __gl_popup_ea_back_cb(void *data, Evas_Object * obj,
                                                                                 void *ei)
 {
@@ -289,12 +346,25 @@ static inline void __gl_popup_ea_back_cb(void *data, Evas_Object * obj,
        __gl_popup_resp(data, _gl_str(GL_STR_ID_CANCEL));
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_popup_local_resp_cb(void *data, Evas_Object * obj,
                                                                         void *ei)
 {
        evas_object_del((Evas_Object *) data);
 }
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param obj
+ * @param ei
+ */
 static void __gl_popup_local_mouseup_cb(void *data, Evas * e,
                                                                                Evas_Object * obj, void *ei)
 {
@@ -308,6 +378,13 @@ static void __gl_popup_local_mouseup_cb(void *data, Evas * e,
        }
 }
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param obj
+ * @param ei
+ */
 static void __gl_popup_local_delete_cb(void *data, Evas * e,
                                                                           Evas_Object * obj, void *ei)
 {
@@ -324,12 +401,23 @@ static void __gl_popup_local_delete_cb(void *data, Evas * e,
        gl_dbg("Delete popup +++");
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_popup_local_block_clicked_cb(void *data,
                                                                                          Evas_Object * obj, void *ei)
 {
        GL_IF_DEL_OBJ(obj);
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static Eina_Bool __gl_popup_local_timeout_cb(void *data)
 {
        GL_CHECK_CANCEL(data);
@@ -343,6 +431,15 @@ static Eina_Bool __gl_popup_local_timeout_cb(void *data)
        return ECORE_CALLBACK_CANCEL;
 }
 
+/**
+ *
+ * @param parent
+ * @param style
+ * @param title
+ * @param text
+ * @param data
+ * @return
+ */
 static Evas_Object *__gl_popup_add(Evas_Object * parent, const char *style,
                                                                   const char *title, const char *text,
                                                                   void *data)
@@ -371,6 +468,15 @@ static Evas_Object *__gl_popup_add(Evas_Object * parent, const char *style,
        return popup;
 }
 
+/**
+ *
+ * @param parent
+ * @param style
+ * @param title
+ * @param text
+ * @param data
+ * @return
+ */
 static Evas_Object *__gl_popup_add_local(Evas_Object * parent,
                                                                                 const char *style,
                                                                                 const char *title,
@@ -400,6 +506,12 @@ static Evas_Object *__gl_popup_add_local(Evas_Object * parent,
        return popup;
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_popup_genlist_realized(void *data, Evas_Object * obj,
                                                                                void *ei)
 {
@@ -410,6 +522,16 @@ static void __gl_popup_genlist_realized(void *data, Evas_Object * obj,
        }
 }
 
+/**
+ *
+ * @param data
+ * @param parent
+ * @param style
+ * @param text_get
+ * @param content_get
+ * @param append_func
+ * @return
+ */
 static Evas_Object *__gl_popup_add_genlist(void *data,
                                                                                   Evas_Object * parent,
                                                                                   const char *style,
@@ -461,6 +583,13 @@ static Evas_Object *__gl_popup_add_genlist(void *data,
        return genlist;
 }
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param obj
+ * @param ei
+ */
 static void __gl_popup_delete_cb(void *data, Evas * e, Evas_Object * obj,
                                                                 void *ei)
 {
@@ -471,6 +600,22 @@ static void __gl_popup_delete_cb(void *data, Evas * e, Evas_Object * obj,
        gl_dbg("Delete popup +++");
 }
 
+/**
+ *
+ * @param data
+ * @param title
+ * @param text
+ * @param str1
+ * @param cb1
+ * @param data1
+ * @param str2
+ * @param cb2
+ * @param data2
+ * @param str3
+ * @param cb3
+ * @param data3
+ * @return
+ */
 int _gl_popup_create(void *data, const char *title, const char *text,
                                         const char *str1, Evas_Smart_Cb cb1,
                                         const void *data1, const char *str2,
@@ -530,6 +675,12 @@ int _gl_popup_create(void *data, const char *title, const char *text,
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_popup_del_lang_changed(void *data, Evas_Object * obj,
                                                                                void *ei)
 {
@@ -548,8 +699,18 @@ static void __gl_popup_del_lang_changed(void *data, Evas_Object * obj,
                popup_str = g_strdup_printf(GL_STR_DELETE_PD_ALBUMS, sel_cnt);
        }
        elm_object_text_set(obj, popup_str);
+       g_free(popup_str);
 }
 
+/**
+ *
+ * @param data
+ * @param mode
+ * @param sel_cb
+ * @param del_cb
+ * @param cb_data
+ * @return
+ */
 int _gl_popup_create_del(void *data, int mode, void *sel_cb, void *del_cb,
                                                 void *cb_data)
 {
@@ -601,7 +762,10 @@ int _gl_popup_create_del(void *data, int mode, void *sel_cb, void *del_cb,
        Evas_Object *popup = __gl_popup_add(ad->maininfo.win, NULL,
                                                                                GL_STR_ID_DELETE,
                                                                                popup_str, data);
-       GL_CHECK_VAL(popup, -1);
+       if (!popup) {
+               GL_GFREEIF(popup_str);
+               return -1;
+       }
        evas_object_event_callback_add(popup, EVAS_CALLBACK_DEL,
                                                                   __gl_popup_delete_cb, NULL);
 
@@ -636,10 +800,17 @@ int _gl_popup_create_del(void *data, int mode, void *sel_cb, void *del_cb,
        ad->popupinfo.popup = popup;
        ad->popupinfo.mode = GL_POPUP_MEDIA_DELETE;
 
-       GL_FREE(popup_str);
+       GL_GFREEIF(popup_str);
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param mode
+ * @param desc
+ * @return
+ */
 int gl_popup_create_popup(void *data, gl_popup_mode mode, char *desc)
 {
        GL_CHECK_VAL(data, -1);
@@ -724,6 +895,13 @@ int gl_popup_create_popup(void *data, gl_popup_mode mode, char *desc)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param mode
+ * @param desc
+ * @return
+ */
 Evas_Object *_gl_popup_create_local(void *data, gl_popup_mode mode,
                                                                        char *desc)
 {
@@ -768,6 +946,12 @@ Evas_Object *_gl_popup_create_local(void *data, gl_popup_mode mode,
        return popup;
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param event_info
+ */
 void _gl_time_view_selected_cb(void *data, Evas_Object * obj,
                                                           void *event_info)
 {
@@ -787,6 +971,12 @@ void _gl_time_view_selected_cb(void *data, Evas_Object * obj,
        gl_dbg("EXIT");
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param event_info
+ */
 void _gl_album_view_selected_cb(void *data, Evas_Object * obj,
                                                                void *event_info)
 {
@@ -806,6 +996,12 @@ void _gl_album_view_selected_cb(void *data, Evas_Object * obj,
        gl_dbg("EXIT");
 }
 
+/**
+ *
+ * @param btn
+ * @param btn1
+ * @param ad
+ */
 void _gl_list_viewas_popup_cb_add(Evas_Object * btn, Evas_Object * btn1,
                                                                  void *ad)
 {
@@ -815,6 +1011,16 @@ void _gl_list_viewas_popup_cb_add(Evas_Object * btn, Evas_Object * btn1,
                                                                   _gl_album_view_selected_cb, ad);
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ * @param title
+ * @param first_text
+ * @param second_text
+ * @param state_index
+ */
 void _gl_list_pop_create(void *data, Evas_Object * obj, void *ei,
                                                 char *title, char *first_text, char *second_text,
                                                 int state_index)
@@ -905,6 +1111,12 @@ void _gl_list_pop_create(void *data, Evas_Object * obj, void *ei,
        gl_dbg("EXIT");
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_thumbs_edit_cancel_cb(void *data, Evas_Object * obj,
                                                                           void *ei)
 {
@@ -917,6 +1129,12 @@ static void __gl_thumbs_edit_cancel_cb(void *data, Evas_Object * obj,
        ad->popupinfo.popup = NULL;
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_thumbs_edit_move_cb(void *data, Evas_Object * obj,
                                                                         void *ei)
 {
@@ -948,6 +1166,12 @@ static void __gl_thumbs_edit_move_cb(void *data, Evas_Object * obj,
        }
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_thumbs_edit_create_album_cb(void *data, Evas_Object * obj,
                                                                                         void *ei)
 {
@@ -975,6 +1199,12 @@ static void __gl_thumbs_edit_create_album_cb(void *data, Evas_Object * obj,
        return;
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_thumbs_edit_copy_cb(void *data, Evas_Object * obj,
                                                                         void *ei)
 {
@@ -992,6 +1222,12 @@ static void __gl_thumbs_edit_copy_cb(void *data, Evas_Object * obj,
        }
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_popup_move_copy_sel_cb(void *data, Evas_Object * obj,
                                                                                void *ei)
 {
@@ -1046,6 +1282,13 @@ static void __gl_popup_move_copy_sel_cb(void *data, Evas_Object * obj,
        }
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param part
+ * @return
+ */
 static char *__gl_popup_menu_get_genlist_text(void *data,
                                                                                          Evas_Object * obj,
                                                                                          const char *part)
@@ -1066,6 +1309,13 @@ static char *__gl_popup_menu_get_genlist_text(void *data,
        return NULL;
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param part
+ * @return
+ */
 Evas_Object *__gl_popup_menu_get_genlist_content(void *data,
                                                                                                 Evas_Object * obj,
                                                                                                 const char *part)
@@ -1089,6 +1339,12 @@ Evas_Object *__gl_popup_menu_get_genlist_content(void *data,
        return ic;
 }
 
+/**
+ *
+ * @param data
+ * @param gl
+ * @param gic
+ */
 void _gl_genlist_item_apend(void *data, Evas_Object * gl,
                                                        Elm_Genlist_Item_Class * gic)
 {
@@ -1130,6 +1386,10 @@ void _gl_genlist_item_apend(void *data, Evas_Object * gl,
        }
 }
 
+/**
+ *
+ * @param data
+ */
 void _gl_update_copy_move_popup(void *data)
 {
        GL_CHECK(data);
@@ -1155,6 +1415,13 @@ void _gl_update_copy_move_popup(void *data)
        }
 }
 
+/**
+ *
+ * @param data
+ * @param sel_cb
+ * @param cb_data
+ * @return
+ */
 int _gl_popup_create_copy_move(void *data, void *sel_cb, void *cb_data)
 {
        GL_CHECK_VAL(cb_data, -1);
@@ -1251,6 +1518,10 @@ int _gl_popup_create_copy_move(void *data, void *sel_cb, void *cb_data)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ */
 void _gl_del_popup(void *data)
 {
        GL_CHECK(data);
index fa4f310..b60fd6e 100644 (file)
 #define GL_PROGRESSBAR_STYLE_WHEEL "wheel"
 /* Font style for show text of downloading web album */
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static void __gl_pb_cancel_thread_pbar_cb(void *data, Evas_Object * obj,
                                                                                  void *ei)
 {
@@ -38,7 +44,12 @@ static void __gl_pb_cancel_thread_pbar_cb(void *data, Evas_Object * obj,
        gl_pb_del_pbar(data);
 }
 
-/* We need to perform cancellation, not just delete popup */
+/**
+ * We need to perform cancellation, not just delete popup
+ * @param data
+ * @param obj
+ * @param ei
+ */
 static inline void __gl_pb_ea_back_cb(void *data, Evas_Object * obj,
                                                                          void *ei)
 {
@@ -49,6 +60,13 @@ static inline void __gl_pb_ea_back_cb(void *data, Evas_Object * obj,
        evas_object_smart_callback_call(btn_cancel, "clicked", NULL);
 }
 
+/**
+ *
+ * @param data
+ * @param parent
+ * @param title
+ * @return
+ */
 int gl_pb_make_thread_pbar_wheel(void *data, Evas_Object * parent,
                                                                 char *title)
 {
@@ -104,6 +122,13 @@ int gl_pb_make_thread_pbar_wheel(void *data, Evas_Object * parent,
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param parent
+ * @param title
+ * @return
+ */
 int gl_pb_make_thread_pbar(void *data, Evas_Object * parent, char *title)
 {
        GL_CHECK_VAL(data, -1);
@@ -166,7 +191,13 @@ int gl_pb_make_thread_pbar(void *data, Evas_Object * parent, char *title)
        return 0;
 }
 
-
+/**
+ *
+ * @param data
+ * @param cur_cnt
+ * @param total_cnt
+ * @return
+ */
 int gl_pb_refresh_thread_pbar(void *data, int cur_cnt, int total_cnt)
 {
        GL_CHECK_VAL(data, -1);
@@ -195,6 +226,11 @@ int gl_pb_refresh_thread_pbar(void *data, int cur_cnt, int total_cnt)
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 int gl_pb_del_pbar(void *data)
 {
        GL_CHECK_VAL(data, -1);
index 32490f5..1b96f8e 100644 (file)
@@ -29,6 +29,13 @@ typedef struct _gl_bg {
        void *user_data;
 } gl_bg;
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param obj
+ * @param event_info
+ */
 static void __gl_rotate_bg_delete_cb(void *data, Evas * e,
                                                                         Evas_Object * obj, void *event_info)
 {
@@ -39,6 +46,13 @@ static void __gl_rotate_bg_delete_cb(void *data, Evas * e,
        }
 }
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param obj
+ * @param event_info
+ */
 static void __gl_rotate_bg_custom_resize(void *data, Evas * e,
                                                                                 Evas_Object * obj,
                                                                                 void *event_info)
@@ -95,6 +109,13 @@ static void __gl_rotate_bg_custom_resize(void *data, Evas * e,
        evas_object_image_fill_set(bg_data->img, fx, fy, fw, fh);
 }
 
+/**
+ *
+ * @param parent
+ * @param file
+ * @param group
+ * @return
+ */
 Evas_Object *_gl_rotate_bg_add_layout(Evas_Object * parent,
                                                                          const char *file, const char *group)
 {
@@ -118,6 +139,12 @@ Evas_Object *_gl_rotate_bg_add_layout(Evas_Object * parent,
        return eo;
 }
 
+/**
+ *
+ * @param parent
+ * @param b_preload
+ * @return
+ */
 Evas_Object *_gl_rotate_bg_add(Evas_Object * parent, bool b_preload)
 {
        GL_CHECK_NULL(parent);
@@ -148,6 +175,14 @@ Evas_Object *_gl_rotate_bg_add(Evas_Object * parent, bool b_preload)
        return base;
 }
 
+/**
+ *
+ * @param bg
+ * @param file
+ * @param w
+ * @param h
+ * @return
+ */
 int _gl_rotate_bg_set_file(Evas_Object * bg, const char *file, int w,
                                                   int h)
 {
@@ -181,6 +216,12 @@ int _gl_rotate_bg_set_file(Evas_Object * bg, const char *file, int w,
        return 0;
 }
 
+/**
+ *
+ * @param bg
+ * @param orient
+ * @return
+ */
 int _gl_rotate_bg_rotate_image(Evas_Object * bg, unsigned int orient)
 {
        GL_CHECK_VAL(bg, -1);
@@ -193,6 +234,13 @@ int _gl_rotate_bg_rotate_image(Evas_Object * bg, unsigned int orient)
        return 0;
 }
 
+/**
+ *
+ * @param bg
+ * @param w
+ * @param h
+ * @return
+ */
 int _gl_rotate_bg_add_image(Evas_Object * bg, int w, int h)
 {
        GL_CHECK_VAL(bg, -1);
@@ -216,6 +264,12 @@ int _gl_rotate_bg_add_image(Evas_Object * bg, int w, int h)
        return 0;
 }
 
+/**
+ *
+ * @param bg
+ * @param file
+ * @return
+ */
 int _gl_rotate_bg_set_image_file(Evas_Object * bg, const char *file)
 {
        GL_CHECK_VAL(bg, -1);
index 6510a2f..8875df7 100644 (file)
 #define GL_PHOTOFRAME_BURSTSHOT1 "burstshot1"
 #define GL_PHOTOFRAME_BURSTSHOT2 "burstshot2"
 
+/**
+ *
+ * @param parent
+ * @param path
+ * @param orient
+ * @param w
+ * @param h
+ * @return
+ */
 static Evas_Object *__gl_thumb_add_image(Evas_Object * parent, char *path,
                                                                                 unsigned int orient, int w, int h)
 {
@@ -72,6 +81,16 @@ static Evas_Object *__gl_thumb_add_image(Evas_Object * parent, char *path,
        return bg;
 }
 
+/**
+ *
+ * @param obj
+ * @param path
+ * @param orient
+ * @param w
+ * @param h
+ * @param zoom_level
+ * @return
+ */
 Evas_Object *_gl_thumb_show_image(Evas_Object * obj, char *path,
                                                                  int orient, int w, int h, int zoom_level)
 {
@@ -101,6 +120,16 @@ Evas_Object *_gl_thumb_show_image(Evas_Object * obj, char *path,
        return layout;
 }
 
+/**
+ *
+ * @param obj
+ * @param path
+ * @param v_dur
+ * @param w
+ * @param h
+ * @param zoom_level
+ * @return
+ */
 Evas_Object *_gl_thumb_show_video(Evas_Object * obj, char *path,
                                                                  unsigned int v_dur, int w, int h,
                                                                  int zoom_level)
@@ -138,6 +167,14 @@ Evas_Object *_gl_thumb_show_video(Evas_Object * obj, char *path,
        return layout;
 }
 
+/**
+ *
+ * @param obj
+ * @param checked
+ * @param func
+ * @param data
+ * @return
+ */
 Evas_Object *_gl_thumb_show_checkbox(Evas_Object * obj, bool checked,
                                                                         Evas_Smart_Cb func, const void *data)
 {
@@ -159,6 +196,11 @@ Evas_Object *_gl_thumb_show_checkbox(Evas_Object * obj, bool checked,
        return ck;
 }
 
+/**
+ *
+ * @param parent
+ * @return
+ */
 Evas_Object *_gl_thumb_add_gengrid(Evas_Object * parent)
 {
        GL_CHECK_NULL(parent);
@@ -176,7 +218,11 @@ Evas_Object *_gl_thumb_add_gengrid(Evas_Object * parent)
        return grid;
 }
 
-/* Update all gengrid item, class callback would be called again */
+/**
+ * Update all gengrid item, class callback would be called again
+ * @param view
+ * @return
+ */
 int _gl_thumb_update_gengrid(Evas_Object * view)
 {
        GL_CHECK_VAL(view, -1);
@@ -192,7 +238,14 @@ int _gl_thumb_update_gengrid(Evas_Object * view)
        return 0;
 }
 
-/* Change icon size and gengrid alignment */
+/**
+ * Change icon size and gengrid alignment
+ * @param data
+ * @param view
+ * @param size_w
+ * @param size_h
+ * @return
+ */
 int _gl_thumb_set_size(void *data, Evas_Object * view, int *size_w,
                                           int *size_h)
 {
@@ -257,6 +310,12 @@ int _gl_thumb_set_size(void *data, Evas_Object * view, int *size_w,
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param view
+ * @return
+ */
 int _gl_thumb_split_set_size(void *data, Evas_Object * view)
 {
        GL_CHECK_VAL(view, -1);
index 92e453f..f96a38f 100644 (file)
 //#define GL_CHECKBOX_STYLE_ALBUM "gallery/album"
 #define GL_CHECKBOX_STYLE_ALBUM_GRID "gallery/album/grid"
 
+/**
+ *
+ * @param obj
+ * @param func
+ * @param data
+ * @return
+ */
 static Evas_Object *__gl_tile_add_icon_bg(Evas_Object * obj,
                                                                                  bg_file_set_cb func, void *data)
 {
@@ -71,6 +78,12 @@ static Evas_Object *__gl_tile_add_icon_bg(Evas_Object * obj,
        return bg;
 }
 
+/**
+ *
+ * @param gesture
+ * @param data
+ * @return
+ */
 static Eina_Bool __gl_tile_zoom_out_cb(Evas_Object * gesture, void *data)
 {
        GL_CHECK_FALSE(data);
@@ -119,6 +132,12 @@ static Eina_Bool __gl_tile_zoom_out_cb(Evas_Object * gesture, void *data)
        return false;
 }
 
+/**
+ *
+ * @param gesture
+ * @param data
+ * @return
+ */
 static Eina_Bool __gl_tile_zoom_in_cb(Evas_Object * gesture, void *data)
 {
        GL_CHECK_FALSE(data);
@@ -168,6 +187,13 @@ static Eina_Bool __gl_tile_zoom_in_cb(Evas_Object * gesture, void *data)
        return false;
 }
 
+/**
+ *
+ * @param data
+ * @param e
+ * @param obj
+ * @param ei
+ */
 static void __gl_title_grid_del_cb(void *data, Evas * e, Evas_Object * obj,
                                                                   void *ei)
 {
@@ -178,6 +204,14 @@ static void __gl_title_grid_del_cb(void *data, Evas * e, Evas_Object * obj,
        gl_dbg("Delete grid +++");
 }
 
+/**
+ *
+ * @param obj
+ * @param part
+ * @param func
+ * @param data
+ * @return
+ */
 Evas_Object *_gl_tile_show_part_icon(Evas_Object * obj, const char *part,
                                                                         bg_file_set_cb func, void *data)
 {
@@ -193,6 +227,11 @@ Evas_Object *_gl_tile_show_part_icon(Evas_Object * obj, const char *part,
        return NULL;
 }
 
+/**
+ *
+ * @param obj
+ * @return
+ */
 Evas_Object *_gl_tile_show_part_dim(Evas_Object * obj)
 {
        GL_CHECK_NULL(obj);
@@ -211,6 +250,14 @@ Evas_Object *_gl_tile_show_part_dim(Evas_Object * obj)
        return bg;
 }
 
+/**
+ *
+ * @param obj
+ * @param checked
+ * @param func
+ * @param data
+ * @return
+ */
 Evas_Object *_gl_tile_show_part_checkbox_grid(Evas_Object * obj,
                                                                                          bool checked,
                                                                                          Evas_Smart_Cb func,
@@ -230,6 +277,14 @@ Evas_Object *_gl_tile_show_part_checkbox_grid(Evas_Object * obj,
        return ck;
 }
 
+/**
+ *
+ * @param obj
+ * @param checked
+ * @param func
+ * @param data
+ * @return
+ */
 Evas_Object *_gl_tile_show_part_checkbox(Evas_Object * obj, bool checked,
                                                                                 Evas_Smart_Cb func,
                                                                                 const void *data)
@@ -247,6 +302,12 @@ Evas_Object *_gl_tile_show_part_checkbox(Evas_Object * obj, bool checked,
        return ck;
 }
 
+/**
+ *
+ * @param obj
+ * @param sns_type
+ * @return
+ */
 Evas_Object *_gl_tile_show_part_type_icon(Evas_Object * obj, int sns_type)
 {
        GL_CHECK_NULL(obj);
@@ -274,6 +335,11 @@ Evas_Object *_gl_tile_show_part_type_icon(Evas_Object * obj, int sns_type)
        return icon;
 }
 
+/**
+ *
+ * @param parent
+ * @return
+ */
 Evas_Object *_gl_tile_add_gengrid(Evas_Object * parent)
 {
        GL_CHECK_NULL(parent);
@@ -297,7 +363,13 @@ Evas_Object *_gl_tile_add_gengrid(Evas_Object * parent)
        return grid;
 }
 
-/* Change icon size and gengrid alignment */
+/**
+ * Change icon size and gengrid alignment
+ * @param data
+ * @param grid
+ * @param b_update
+ * @return
+ */
 int _gl_tile_update_item_size(void *data, Evas_Object * grid,
                                                          bool b_update)
 {
@@ -368,6 +440,12 @@ int _gl_tile_update_item_size(void *data, Evas_Object * grid,
        return 0;
 }
 
+/**
+ *
+ * @param data
+ * @param parent
+ * @return
+ */
 Evas_Object *_gl_tile_add_gesture(void *data, Evas_Object * parent)
 {
        GL_CHECK_NULL(parent);
index fa5b334..9c973bd 100644 (file)
@@ -61,6 +61,12 @@ static void gl_widget_on_no_image_cb(void *data, Evas_Object * obj,
                                                                         const char *source);
 void _gl_widget_create_edit_btn(_widget_data * widget_data);
 
+/**
+ *
+ * @param storage_id
+ * @param directory
+ * @return
+ */
 static char *gl_get_folder_path(int storage_id, int directory)
 {
        char *path = NULL;
@@ -79,36 +85,68 @@ static char *gl_get_folder_path(int storage_id, int directory)
        return path;
 }
 
+/**
+ *
+ * @param widget_data
+ * @return
+ */
 char *_gl_get_camera_folder_path_internal(_widget_data * widget_data)
 {
        return gl_get_folder_path(widget_data->device_id,
                                                          STORAGE_DIRECTORY_CAMERA);
 }
 
+/**
+ *
+ * @param widget_data
+ * @return
+ */
 char *_gl_get_images_folder_path(_widget_data * widget_data)
 {
        return gl_get_folder_path(widget_data->device_id,
                                                          STORAGE_DIRECTORY_IMAGES);
 }
 
+/**
+ *
+ * @param widget_data
+ * @return
+ */
 char *_gl_get_camera_folder_path_external(_widget_data * widget_data)
 {
        return gl_get_folder_path(widget_data->mmc_id,
                                                          STORAGE_DIRECTORY_CAMERA);
 }
 
+/**
+ *
+ * @param widget_data
+ * @return
+ */
 char *_gl_get_downloads_folder_path(_widget_data * widget_data)
 {
        return gl_get_folder_path(widget_data->device_id,
                                                          STORAGE_DIRECTORY_DOWNLOADS);
 }
 
+/**
+ *
+ * @param data
+ * @param evas
+ * @param obj
+ * @param event_info
+ */
 void gl_widget_key_down_cb(void *data, Evas * evas, Evas_Object * obj,
                                                   void *event_info)
 {
        elm_exit();
 }
 
+/**
+ *
+ * @param path
+ * @return
+ */
 int gl_widget_file_exists(const char *path)
 {
        struct stat info = { 0, };
@@ -120,6 +158,12 @@ int gl_widget_file_exists(const char *path)
        }
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param event_info
+ */
 void _gl_launch_iv(void *data, Evas_Object * obj, void *event_info)
 {
        if (!obj) {
@@ -164,6 +208,10 @@ void _gl_launch_iv(void *data, Evas_Object * obj, void *event_info)
        }
 }
 
+/**
+ *
+ * @param widget_data
+ */
 void gl_widget_update_image_selection_data(_widget_data * widget_data)
 {
        DbgPrint("images count : %d and selected images count : %d",
@@ -187,6 +235,11 @@ void gl_widget_update_image_selection_data(_widget_data * widget_data)
                         widget_data->images_count, widget_data->selected_count);
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static Eina_Bool gl_widget_animator_cb(void *data)
 {
        dlog_print(DLOG_ERROR, LOG_TAG, "ENTRY gl_widget_animator_cb");
@@ -258,6 +311,9 @@ static Eina_Bool gl_widget_animator_cb(void *data)
        return EINA_TRUE;
 }
 
+/**
+ *
+ */
 void gl_widget_remove_sel_info()
 {
        char *data_path = app_get_data_path();
@@ -269,6 +325,11 @@ void gl_widget_remove_sel_info()
        }
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static Eina_Bool gl_widget_animator_for_one(void *data)
 {
        _widget_data *widget_data = (_widget_data *) data;
@@ -321,6 +382,11 @@ static Eina_Bool gl_widget_animator_for_one(void *data)
        return EINA_TRUE;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 static Eina_Bool gl_widget_animator_cb_for_less_than_five_images(void
                                                                                                                                 *data)
 {
@@ -374,6 +440,11 @@ static Eina_Bool gl_widget_animator_cb_for_less_than_five_images(void
        return EINA_TRUE;
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 Eina_Bool gl_widget_timer_cb(void *data)
 {
        if (!data) {
@@ -398,6 +469,12 @@ Eina_Bool gl_widget_timer_cb(void *data)
        return EINA_TRUE;
 }
 
+/**
+ *
+ * @param patharray
+ * @param count
+ * @return
+ */
 static Eina_Bool gl_widget_check_albumInfo(char **patharray, int count)
 {
        int refcount = 0;
@@ -431,6 +508,11 @@ static Eina_Bool gl_widget_check_albumInfo(char **patharray, int count)
        return EINA_TRUE;
 }
 
+/**
+ *
+ * @param filename
+ * @return
+ */
 char *_gl_widget_get_file_date(const char *filename)
 {
        struct stat statbuf = { 0 };
@@ -468,6 +550,12 @@ char *_gl_widget_get_file_date(const char *filename)
        return str;
 }
 
+/**
+ *
+ * @param patharray
+ * @param count
+ * @return
+ */
 static Eina_Bool gl_widget_check_dateInfo(char **patharray, int count)
 {
        int refcount = 0;
@@ -504,6 +592,11 @@ static Eina_Bool gl_widget_check_dateInfo(char **patharray, int count)
        return EINA_TRUE;
 }
 
+/**
+ *
+ * @param pathInfo
+ * @return
+ */
 static char *gl_widget_extract_album_path(char *pathInfo)
 {
        if (!pathInfo) {
@@ -537,6 +630,12 @@ static char *gl_widget_extract_album_path(char *pathInfo)
        return albumpath;
 }
 
+/**
+ *
+ * @param pathInfo
+ * @param widget_data
+ * @return
+ */
 static Eina_Bool gl_widget_check_default_album(char *pathInfo,
                                                                                           _widget_data * widget_data)
 {
@@ -576,6 +675,11 @@ static Eina_Bool gl_widget_check_default_album(char *pathInfo,
        return EINA_FALSE;
 }
 
+/**
+ *
+ * @param pathInfo
+ * @return
+ */
 static char *gl_widget_extract_album_info(char *pathInfo)
 {
        if (!pathInfo) {
@@ -623,6 +727,12 @@ static char *gl_widget_extract_album_info(char *pathInfo)
        return albumname;
 }
 
+/**
+ *
+ * @param patharray
+ * @param count
+ * @return
+ */
 static char *gl_widget_extract_date_info(char **patharray, int count)
 {
        if (!patharray || count <= 0) {
@@ -633,6 +743,13 @@ static char *gl_widget_extract_date_info(char **patharray, int count)
        return date;
 }
 
+/**
+ *
+ * @param arrayLength
+ * @param pathArray
+ * @param widget_data
+ * @param layout
+ */
 void _gl_widget_show_album_date_info(int arrayLength, char **pathArray,
                                                                         _widget_data * widget_data,
                                                                         Evas_Object * layout)
@@ -673,6 +790,13 @@ void _gl_widget_show_album_date_info(int arrayLength, char **pathArray,
        }
 }
 
+/**
+ *
+ * @param request
+ * @param reply
+ * @param result
+ * @param data
+ */
 static void gl_widget_result_cb(app_control_h request, app_control_h reply,
                                                                app_control_result_e result, void *data)
 {
@@ -775,6 +899,12 @@ static void gl_widget_result_cb(app_control_h request, app_control_h reply,
        }
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param event_info
+ */
 static void gl_widget_on_edit_cb(void *data, Evas_Object * obj,
                                                                 void *event_info)
 {
@@ -819,6 +949,10 @@ static void gl_widget_on_edit_cb(void *data, Evas_Object * obj,
        }
 }
 
+/**
+ *
+ * @param widget_data
+ */
 void _gl_widget_create_edit_btn(_widget_data * widget_data)
 {
 
@@ -862,6 +996,11 @@ void _gl_widget_create_edit_btn(_widget_data * widget_data)
        }
 }
 
+/**
+ *
+ * @param widget_data
+ * @return
+ */
 static int gl_widget_launch_gallery_ug(_widget_data * widget_data)
 {
        app_control_h service = NULL;
@@ -900,6 +1039,13 @@ static int gl_widget_launch_gallery_ug(_widget_data * widget_data)
        return ret;
 }
 
+/**
+ *
+ * @param data
+ * @param obj
+ * @param emission
+ * @param source
+ */
 static void gl_widget_on_no_image_cb(void *data, Evas_Object * obj,
                                                                         const char *emission,
                                                                         const char *source)
@@ -920,6 +1066,11 @@ static void gl_widget_on_no_image_cb(void *data, Evas_Object * obj,
        gl_widget_launch_gallery_ug(widget_data);
 }
 
+/**
+ *
+ * @param widget_data
+ * @return
+ */
 Eina_Bool gl_widget_load_preselected_images(_widget_data * widget_data)
 {
        if (!widget_data) {
@@ -978,6 +1129,13 @@ Eina_Bool gl_widget_load_preselected_images(_widget_data * widget_data)
        return EINA_FALSE;
 }
 
+/**
+ *
+ * @param widget_data
+ * @param w
+ * @param h
+ * @return
+ */
 int gl_widget_create(_widget_data * widget_data, int w, int h)
 {
        if (!widget_data) {
@@ -1045,6 +1203,10 @@ int gl_widget_create(_widget_data * widget_data, int w, int h)
        return 0;
 }
 
+/**
+ *
+ * @param widget_data
+ */
 void gl_widget_add_timer(_widget_data * widget_data)
 {
        DbgPrint("Adding timer -> selected image count: %d",
index 50a6bdf..d0428d4 100644 (file)
 #include "gl_widget_debug.h"
 #include "gl_widget.h"
 
+/**
+ *
+ * @param context
+ */
 void *getWidgetData(widget_context_h context)
 {
        void *data = NULL;
@@ -35,6 +39,10 @@ void *getWidgetData(widget_context_h context)
        return data;
 }
 
+/**
+ *
+ * @param str
+ */
 void gl_util_to_lower(char *str)
 {
        int i = 0;
@@ -46,6 +54,18 @@ void gl_util_to_lower(char *str)
        }
 }
 
+/**
+ *
+ * @param storage_id
+ * @param dev
+ * @param state
+ * @param fstype
+ * @param fsuuid
+ * @param mountpath
+ * @param primary
+ * @param flags
+ * @param user_data
+ */
 static void gl_callback_storage_changed_cb(int storage_id,
                                                                                   storage_dev_e dev,
                                                                                   storage_state_e state,
@@ -72,6 +92,15 @@ static void gl_callback_storage_changed_cb(int storage_id,
        }
 }
 
+/**
+ *
+ * @param storage_id
+ * @param type
+ * @param state
+ * @param path
+ * @param userData
+ * @return
+ */
 bool gl_get_supported_device_cb(int storage_id, storage_type_e type,
                                                                storage_state_e state, const char *path,
                                                                void *userData)
@@ -89,6 +118,9 @@ bool gl_get_supported_device_cb(int storage_id, storage_type_e type,
        return true;
 }
 
+/**
+ *
+ */
 void gl_unregister_update_cb()
 {
        int error_code = -1;
@@ -100,6 +132,10 @@ void gl_unregister_update_cb()
        }
 }
 
+/**
+ *
+ * @param widget_data
+ */
 void gl_register_update_cb(_widget_data * widget_data)
 {
        int error_code = -1;
@@ -117,6 +153,15 @@ void gl_register_update_cb(_widget_data * widget_data)
        }
 }
 
+/**
+ *
+ * @param context
+ * @param content
+ * @param w
+ * @param h
+ * @param data
+ * @return
+ */
 int widget_Create(widget_context_h context, bundle * content, int w, int h,
                                  void *data)
 {
@@ -169,6 +214,14 @@ int widget_Create(widget_context_h context, bundle * content, int w, int h,
        return WIDGET_ERROR_NONE;
 }
 
+/**
+ *
+ * @param context
+ * @param reason
+ * @param content
+ * @param data
+ * @return
+ */
 int widget_Destroy(widget_context_h context,
                                   widget_app_destroy_type_e reason, bundle * content,
                                   void *data)
@@ -211,6 +264,12 @@ int widget_Destroy(widget_context_h context,
        return WIDGET_ERROR_NONE;
 }
 
+/**
+ *
+ * @param context
+ * @param data
+ * @return
+ */
 int widget_Pause(widget_context_h context, void *data)
 {
        DbgPrint("widget paused");
@@ -225,7 +284,12 @@ int widget_Pause(widget_context_h context, void *data)
        }
        return WIDGET_ERROR_NONE;
 }
-
+/**
+ *
+ * @param context
+ * @param data
+ * @return
+ */
 int widget_Resume(widget_context_h context, void *data)
 {
        DbgPrint("widget resumed");
@@ -249,6 +313,14 @@ int widget_Resume(widget_context_h context, void *data)
        return WIDGET_ERROR_NONE;
 }
 
+/**
+ *
+ * @param context
+ * @param w
+ * @param h
+ * @param data
+ * @return
+ */
 int widget_Resize(widget_context_h context, int w, int h, void *data)
 {
        struct widget_data *widget_data = NULL;
@@ -266,12 +338,25 @@ int widget_Resize(widget_context_h context, int w, int h, void *data)
        return WIDGET_ERROR_NONE;
 }
 
+/**
+ *
+ * @param context
+ * @param content
+ * @param force
+ * @param data
+ * @return
+ */
 int widget_Update(widget_context_h context, bundle * content, int force,
                                  void *data)
 {
        return WIDGET_ERROR_NONE;
 }
 
+/**
+ *
+ * @param event_info
+ * @param data
+ */
 static void app_language_changed(app_event_info_h event_info, void *data)
 {
        DbgPrint("language change triggered");
@@ -283,11 +368,21 @@ static void app_language_changed(app_event_info_h event_info, void *data)
        }
 }
 
+/**
+ *
+ * @param event_info
+ * @param data
+ */
 static void app_region_changed(app_event_info_h event_info, void *data)
 {
        DbgPrint("region change triggered");
 }
 
+/**
+ *
+ * @param data
+ * @return
+ */
 widget_class_h app_create(void *data)
 {
        app_event_handler_h lang_changed_handler;
@@ -311,6 +406,10 @@ widget_class_h app_create(void *data)
        return widget_app_class_create(ops, data);
 }
 
+/**
+ *
+ * @param data
+ */
 void app_terminate(void *data)
 {
        /**
@@ -318,6 +417,12 @@ void app_terminate(void *data)
         */
 }
 
+/**
+ *
+ * @param argc
+ * @param argv
+ * @return
+ */
 int main(int argc, char *argv[])
 {
        int result = WIDGET_ERROR_NONE;