From: Shubham Kumar Date: Thu, 21 Sep 2017 08:58:47 +0000 (+0530) Subject: Added comment for data files and added comment skeleton for util and widget files X-Git-Tag: submit/tizen_4.0/20170926.130622^0 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=628a238306cb09b1e14d923a521dce7d5ce676b4;p=profile%2Fmobile%2Fapps%2Fnative%2Fgallery.git Added comment for data files and added comment skeleton for util and widget files Change-Id: I86b271106d2a89fd74d1cad5e175aaf516aac3ce Signed-off-by: Shubham Kumar --- diff --git a/src/data/gl-data-type.c b/src/data/gl-data-type.c index e852d33..2053ca7 100644 --- a/src/data/gl-data-type.c +++ b/src/data/gl-data-type.c @@ -17,6 +17,11 @@ #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); diff --git a/src/data/gl-data-util.c b/src/data/gl-data-util.c index baa48f5..fcc223d 100644 --- a/src/data/gl-data-util.c +++ b/src/data/gl-data-util.c @@ -20,6 +20,14 @@ #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); diff --git a/src/data/gl-data.c b/src/data/gl-data.c index 8d7ddb8..2e84730 100644 --- a/src/data/gl-data.c +++ b/src/data/gl-data.c @@ -23,6 +23,14 @@ #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); diff --git a/src/data/gl-local-data.c b/src/data/gl-local-data.c index 9bf8630..9110f46 100644 --- a/src/data/gl-local-data.c +++ b/src/data/gl-local-data.c @@ -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); diff --git a/src/features/gl-entry.c b/src/features/gl-entry.c index bdd861a..a17f57c 100644 --- a/src/features/gl-entry.c +++ b/src/features/gl-entry.c @@ -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); diff --git a/src/features/gl-main.c b/src/features/gl-main.c index af9ed16..31fdfbb 100644 --- a/src/features/gl-main.c +++ b/src/features/gl-main.c @@ -27,6 +27,12 @@ #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); diff --git a/src/features/gl-pinchzoom.c b/src/features/gl-pinchzoom.c index 66c6f6c..2aa7be2 100644 --- a/src/features/gl-pinchzoom.c +++ b/src/features/gl-pinchzoom.c @@ -19,6 +19,12 @@ #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); diff --git a/src/gallery.c b/src/gallery.c index 2efe71a..e91d40f 100644 --- a/src/gallery.c +++ b/src/gallery.c @@ -29,6 +29,11 @@ */ 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=="); diff --git a/src/util/gl-db-update.c b/src/util/gl-db-update.c index b32898d..9711ac1 100644 --- a/src/util/gl-db-update.c +++ b/src/util/gl-db-update.c @@ -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; diff --git a/src/util/gl-ext-ug-load.c b/src/util/gl-ext-ug-load.c index 722d4a5..bccd4c0 100644 --- a/src/util/gl-ext-ug-load.c +++ b/src/util/gl-ext-ug-load.c @@ -50,6 +50,13 @@ #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) { diff --git a/src/util/gl-file-util.c b/src/util/gl-file-util.c index 45041ce..b272d9a 100644 --- a/src/util/gl-file-util.c +++ b/src/util/gl-file-util.c @@ -22,6 +22,11 @@ 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, }; diff --git a/src/util/gl-fs.c b/src/util/gl-fs.c index ebcffd7..a827d96 100644 --- a/src/util/gl-fs.c +++ b/src/util/gl-fs.c @@ -21,6 +21,11 @@ #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); diff --git a/src/util/gl-lang.c b/src/util/gl-lang.c index 5f07192..549e35e 100644 --- a/src/util/gl-lang.c +++ b/src/util/gl-lang.c @@ -28,6 +28,11 @@ #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; diff --git a/src/util/gl-thread-util.c b/src/util/gl-thread-util.c index 32e83ba..46d6d95 100644 --- a/src/util/gl-thread-util.c +++ b/src/util/gl-thread-util.c @@ -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); diff --git a/src/util/gl-ui-util.c b/src/util/gl-ui-util.c index 1ef3307..870cc5c 100644 --- a/src/util/gl-ui-util.c +++ b/src/util/gl-ui-util.c @@ -21,6 +21,11 @@ #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) { diff --git a/src/util/gl-util.c b/src/util/gl-util.c index a67a300..455ba63 100644 --- a/src/util/gl-util.c +++ b/src/util/gl-util.c @@ -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 "&". 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 "&". 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; diff --git a/src/widget/gl-button.c b/src/widget/gl-button.c index 8b37067..12fed93 100644 --- a/src/widget/gl-button.c +++ b/src/widget/gl-button.c @@ -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, diff --git a/src/widget/gl-controlbar.c b/src/widget/gl-controlbar.c index bacad1a..8e4c664 100644 --- a/src/widget/gl-controlbar.c +++ b/src/widget/gl-controlbar.c @@ -23,6 +23,11 @@ #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); diff --git a/src/widget/gl-ctxpopup.c b/src/widget/gl-ctxpopup.c index 7705deb..cb88744 100644 --- a/src/widget/gl-ctxpopup.c +++ b/src/widget/gl-ctxpopup.c @@ -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); diff --git a/src/widget/gl-editfield.c b/src/widget/gl-editfield.c index e6ed497..5c31eb1 100644 --- a/src/widget/gl-editfield.c +++ b/src/widget/gl-editfield.c @@ -22,7 +22,12 @@ /* 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); diff --git a/src/widget/gl-gesture.c b/src/widget/gl-gesture.c index ac764f5..e9b7ca9 100644 --- a/src/widget/gl-gesture.c +++ b/src/widget/gl-gesture.c @@ -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); diff --git a/src/widget/gl-nocontents.c b/src/widget/gl-nocontents.c index cdc03b7..b607612 100644 --- a/src/widget/gl-nocontents.c +++ b/src/widget/gl-nocontents.c @@ -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) { diff --git a/src/widget/gl-notify.c b/src/widget/gl-notify.c index f051c80..187fb80 100644 --- a/src/widget/gl-notify.c +++ b/src/widget/gl-notify.c @@ -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) { diff --git a/src/widget/gl-popup.c b/src/widget/gl-popup.c index b5189ad..39792c8 100644 --- a/src/widget/gl-popup.c +++ b/src/widget/gl-popup.c @@ -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); diff --git a/src/widget/gl-progressbar.c b/src/widget/gl-progressbar.c index fa4f310..b60fd6e 100644 --- a/src/widget/gl-progressbar.c +++ b/src/widget/gl-progressbar.c @@ -25,6 +25,12 @@ #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); diff --git a/src/widget/gl-rotate-bg.c b/src/widget/gl-rotate-bg.c index 32490f5..1b96f8e 100644 --- a/src/widget/gl-rotate-bg.c +++ b/src/widget/gl-rotate-bg.c @@ -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); diff --git a/src/widget/gl-thumb.c b/src/widget/gl-thumb.c index 6510a2f..8875df7 100644 --- a/src/widget/gl-thumb.c +++ b/src/widget/gl-thumb.c @@ -57,6 +57,15 @@ #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); diff --git a/src/widget/gl-tile.c b/src/widget/gl-tile.c index 92e453f..f96a38f 100644 --- a/src/widget/gl-tile.c +++ b/src/widget/gl-tile.c @@ -42,6 +42,13 @@ //#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); diff --git a/widget/src/gl_widget_create.c b/widget/src/gl_widget_create.c index fa5b334..9c973bd 100644 --- a/widget/src/gl_widget_create.c +++ b/widget/src/gl_widget_create.c @@ -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", diff --git a/widget/src/gl_widget_main.c b/widget/src/gl_widget_main.c index 50a6bdf..d0428d4 100644 --- a/widget/src/gl_widget_main.c +++ b/widget/src/gl_widget_main.c @@ -28,6 +28,10 @@ #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;