[W-INDICATOR] Comments added for each function 17/109517/1 submit/tizen_3.0/20170111.135850
author“vijay.tiwari” <vijay.tiwari@samsung.com>
Tue, 10 Jan 2017 08:44:10 +0000 (14:14 +0530)
committer“vijay.tiwari” <vijay.tiwari@samsung.com>
Tue, 10 Jan 2017 08:45:25 +0000 (14:15 +0530)
Change-Id: Ife9d8ce3956a94373857f5c80e90b7cb4e9e352f

28 files changed:
include/windicator.h
include/windicator_battery.h
include/windicator_brightness.h
include/windicator_call_fwd_btn.h
include/windicator_connection.h
include/windicator_dnd_btn.h
include/windicator_dynamic.h
include/windicator_flight_mode.h
include/windicator_moment_bar.h
include/windicator_moment_view.h
include/windicator_music_btn.h
include/windicator_scs.h
include/windicator_util.h
include/windicator_volume.h
src/windicator.c
src/windicator_battery.c
src/windicator_brightness.c
src/windicator_call_fwd_btn.c
src/windicator_connection.c
src/windicator_dnd_btn.c
src/windicator_dynamic.c
src/windicator_flight_mode.c
src/windicator_moment_bar.c
src/windicator_moment_view.c
src/windicator_music_btn.c
src/windicator_scs.c
src/windicator_util.c
src/windicator_volume.c

index ca70088e9b2679cba1fff5390a3020e7e39ff64b..55c3dd4da8821c9c90b295313e927d3f525ee1d9 100755 (executable)
@@ -231,8 +231,30 @@ struct appdata {
        bundle* content;
        widget_context_h context;
 };
+
+/*
+* @brief:Returns appdata
+*/
 struct appdata *windicator_appdata_get(void);
+
+/*
+* @brief: Sets first layout as default
+* @param[in] data: User data
+*/
 void windicator_lo_update(void* data);
+
+/*
+* @brief:  Locks the given lock state (Dim display here) for a specified time.
+*/
 void windicator_util_display_lock(void);
+
+/*
+ * @brief: Register watchface visibility
+ * @param[in] data: User data
+ */
 windicator_error_e windicator_watchface_register(void *data);
+
+/*
+ * @brief: Unregister watchface visibility
+ */
 void windicator_watchface_unregister();
index da1a33450b2b39f159bea0be765499c2a85f709e..b7a42fb84052056a160af76abcd4da63b57f0f27 100644 (file)
 #ifndef __WINDICATOR_BATTERY_H__
 #define __WINDICATOR_BATTERY_H__
 
-Evas_Object *windicator_battery_layout_create(Evas_Object *parent, void *data);
-void windicator_battery_layout_destroy(void *data);
+//Evas_Object *windicator_battery_layout_create(Evas_Object *parent, void *data);
+//void windicator_battery_layout_destroy(void *data);
 
+/*
+* @brief: Creates the battery icon layout
+* @param[in] parent: Parent of the battrey icon layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_battery_icon_create(Evas_Object *parent, void *data);
+
+/*
+* @brief: Destroy battery icon layout
+* @param[in] data: User data
+*/
 void windicator_battery_icon_destroy(void *data);
 
+/*
+* @brief: Updates battery icon based on charging/Not charging/Fully Charged
+* @param[in] layout: The battrey icon layout
+* @param[in] data: User data
+*/
 windicator_error_e windicator_battery_icon_update(Evas_Object *layout, void *data);
+
+/*
+* @brief: Updates battery icon based on charging/Not charging/Fully Charged
+* @param[in] data: User data
+*/
 extern void _battery_update(void* data);
+
+/*
+* @brief: utility function to convert into string from int
+* @param[in] level: input integer to be converted into string
+*/
 extern char *windicator_util_str_from_icu_get(int level);
+
+/*
+* @brief: Initiates the battery charging after event registration
+* @param[in] data: User data
+*/
 extern windicator_error_e windicator_battery_init(void *data);
+
+/*
+* @brief: Ends the battery charging after event finish
+* @param[in] data: User data
+*/
 extern void windicator_battery_finish(void);
 #endif /*  __WINDICATOR_BATTERY_H__ */
index f2ee26ed5f83f21536850ff1b85b27f8e8765ef9..136b670e5aff64c172358e3e14f4b6448d235e97 100644 (file)
 #ifndef __WINDICATOR_BRIGHTNESS_H__
 #define __WINDICATOR_BRIGHTNESS_H__
 
+/*
+* @brief: Creates brightness small layout
+* @param[in] parent: parent of brightness small layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_brightness_small_layout_create(Evas_Object *parent, void *data);
+
+/*
+* @brief: delet the brightness small layout
+* @param[in] data: User data
+*/
 void windicator_brightness_small_layout_destroy(void *data);
 
-void windicator_brightness_icon_set_by_level(Evas_Object *icon, void *data);
+/*
+* @brief: Brightness icon is set based on level
+* @param[in] layout: brightness small layout
+* @param[in] data: User data
+*/
+void windicator_brightness_icon_set_by_level(Evas_Object *layout, void *data);
+
+/*
+* @brief: Update the brightness index
+* @param[in] data: User data
+*/
 windicator_error_e windicator_brightness_update(void *data);
 
+/*
+* @brief: Callback function executes after mouse click event on brightness icon
+* @param[in] data: User data
+* @param[in] obj: Brightness icon layout
+* @param[in] emission: emitted signal
+* @param[in] source: Source of the signal
+*/
 void on_clicked_small_brightness_icon(void *data, Evas_Object *obj, const char *emission, const char *source);
 
+/*
+* @brief: Register vconf for brightness
+* @param[in] data: User data
+*/
 windicator_error_e windicator_brightness_register(void *data);
+
+/*
+* @brief: Unregister the brightnes in vconf
+*/
 void windicator_brightness_unregister();
 
 #endif /*  __WINDICATOR_BRIGHTNESS_H__ */
index a68202cd590bf32f78d44423a2df06b22fb11dcb..990ad2b360e7e517b64c0e8a3b448fb24dadff29 100644 (file)
 #ifndef __WINDICATOR_CALL_FWD_BTN_H__
 #define __WINDICATOR_CALL_FWD_BTN_H__
 
+/*
+* @brief:callforward button layout create
+* @param[in] parent: Parent of callforward button layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_callfwd_btn_layout_create(Evas_Object *parent, void *data);
+
+/*
+* @brief: Deletes callforward button layout
+* @param[in] data: User data
+*/
 void windicator_callfwd_btn_layout_destroy(void *data);
+
+/*
+* @brief: Update (Enable/Disable ) callforward button layout
+* @param[in] data: User data
+*/
 windicator_error_e windicator_call_fwd_btn_update(void *data);
 
-void _call_fwd_btn_clicked_cb(void *data, Evas_Object *obj, const char *emission, const char *source);
+//void _call_fwd_btn_clicked_cb(void *data, Evas_Object *obj, const char *emission, const char *source);
 
 #endif /* __WINDICATOR_CALL_FWD_BTN_H__ */
index 336f4be696079adb12a4881de9529a76b3d946c1..b600003258444f7dda5f51aac2d81db1648ffc0a 100644 (file)
 #ifndef __WINDICATOR_CONNECTION_H__
 #define __WINDICATOR_CONNECTION_H__
 
+/*
+* @brief: Updates the connection after momentbar initiates
+* @param[in] rssi_icon: rssi icon
+* @param[in] connect_icon: Connection icon
+*/
 void windi_connection_update(Evas_Object *rssi_icon, Evas_Object *connect_icon);
+
+/*
+* @brief: Called if connection resumes
+* @param[in] rssi_icon: rssi icon
+* @param[in] connect_icon: connection icon
+*/
 void windi_connection_resume(Evas_Object *rssi_icon, Evas_Object *connect_icon);
+
+/*
+* @brief: Called if connection pauses
+*/
 void windi_connection_pause(void);
 
 #endif
index 8fb3b5131cc7872f14295dd107a898987c5eaa8c..729f2c7d36b6da7cb0d7c589ef1c7c3eb9e1f701 100644 (file)
 #ifndef __WINDICATOR_DND_BTN_H__
 #define __WINDICATOR_DND_BTN_H__
 
+/*
+* @brief: Creates the dnd button layout
+* @param[in] parent: Parent of the dnd button layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_dnd_btn_layout_create(Evas_Object *parent, void *data);
+
+/*
+* @brief: Deletes dnd button
+* @param[in] data: User data
+*/
 void windicator_dnd_btn_layout_destroy(void *data);
 
+/*
+* @brief: Updates(Enables/Disables) the dnd button
+* @param[in] data: User data
+*/
 windicator_error_e windicator_dnd_btn_update(void *data);
 
+/*
+* @brief: Callback function if dnd touch area is clicked
+* @param[in] data: User data
+* @param[in] obj: moment bar main layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void _dnd_btn_clicked_cb(void *data, Evas_Object *obj, const char *emission, const char *source);
 
+
+/*
+* @brief: Destroys the dnd popup after widget instance gets destroyed
+* @param[in] data: User data
+*/
 void windicator_dnd_popup_destroy(void *data);
 
 #endif /* __WINDICATOR_DND_BTN_H__ */
index 944d044c9a548ee92de6d8c44df7366d5c6525be..fb131eab95307afe68fb3e59ac65588d3dfef8fa 100644 (file)
 #ifndef __WINDICATOR_DYNAMIC_H__
 #define __WINDICATOR_DYNAMIC_H__
 
+/*
+* @brief: Creats dynamic layout
+* @param[in] parent: Parent of dynamic layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_dynamic_layout_create(Evas_Object *parent, void *data);
+
+/*
+* @brief: Destroys Dynamic (the connection icon) layout
+* @param[in] data: User data
+*/
 void windicator_dynamic_layout_destroy(void *data);
 
+/*
+* @brief: Updates the dynamic icons (Bluetooth/Headset)
+* @param[in] data: User data
+*/
 windicator_error_e windicator_dynamic_update(void *data);
 
+/*
+* @brief: Create dynamic layout
+* @param[in] parent: Parent of the dynamic layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_dynamic_layout_for_moment_view_create(Evas_Object *parent, void *data);
+
+/*
+* @brief: Creats rssi icon layout
+* @param[in] parent: Parent of rssi icon layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_rssi_icon_create(Evas_Object *parent, void *data);
+
+/*
+* @brief: Creats connection icon layout
+* @param[in] parent: Parent of connection icon layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_connection_icon_create(Evas_Object *parent, void *data);
 
+/*
+* @brief: Sets dynamic layout
+* @param[in] data: User data
+* @param[in] isBTConnected: Boolean tells if bluetooth is connected
+*/
 void windicator_set_dynamic_icon_layout(void* data, int isBTConnected);
+
+/*
+* @brief: Refresh position of icons in dynamic layout
+* @param[in] layout: dynamic layout
+* @param[in] isForMomentView: 1 for moment view, 0 for moment bar
+*/
 void dynamic_event_icon_refresh_position_for_3g(Evas_Object *layout, int isForMomentView);
 
+/*
+* @brief: Vconf register for dynamic icons (Bluetooth/Headset)
+* @param[in] data: User data
+*/
 windicator_error_e windicator_dynamic_vconfkey_register(void *data);
+
+/*
+* @brief: Vconf unregister for dynamic icons (Bluetooth/Headset)
+*/
 extern void windicator_dynamic_vconfkey_unregister(void);
 
 #endif /* __WINDICATOR_DYNAMIC_H__ */
index 93de317d227c3653b96a47cb4edfed70eb165f75..a490e58d112fad47715ac2f1aa3c05d6d2529e2c 100644 (file)
 #ifndef __WINDICATOR_FLIGHT_MODE_H__
 #define __WINDICATOR_FLIGHT_MODE_H__
 
+/*
+* @brief: Creates the flight mode icon layout
+* @param[in] parent: Parent of the flight mode icon layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_flight_mode_layout_create(Evas_Object *parent, void *data);
+
+/*
+* @brief: Destroys the flight mode icon
+* @param[in] data: User data
+*/
 void windicator_flight_mode_layout_destroy(void *data);
 
+/*
+* @brief: Updates(Enables/Disables) the flight mode icon
+* @param[in] data: User data
+*/
 windicator_error_e windicator_flight_mode_update(void *data);
 
+/*
+* @brief: Callback function on mouse click event on flight mode icon layout
+* @param[in] data: User data
+* @param[in] obj: flight mode icon layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void _flight_mode_clicked_cb(void *data, Evas_Object *obj, const char *emission, const char *source);
 
 #endif /* __WINDICATOR_FLIGHT_MODE_H__ */
index a3b725535ca76404e49f1cf20d93deb269ca781d..e60dfc2467603da12a17580d2f546d5c75c66484 100755 (executable)
 #ifndef __WINDICATOR_MOMENT_BAR_H__
 #define __WINDICATOR_MOMENT_BAR_H__
 
+/*
+* @brief: Creates moment bar first page
+* @param[in] data: User data
+*/
 Evas_Object *windicator_moment_bar_first_page_layout_create(void *data);
-Evas_Object *windicator_moment_bar_first_page_layout_create_for_3g(void *data);
+//Evas_Object *windicator_moment_bar_first_page_layout_create_for_3g(void *data);
+
+/*
+* @brief: Moment bar initializes
+* @param[in] data: User data
+*/
 windicator_error_e windicator_moment_bar_init(void *data);
+
+/*
+* @brief: Show the moment bar if connection resumes. register back/Down key handlers
+* @param[in] data: User data
+*/
 windicator_error_e windicator_moment_bar_show(void *data);
-windicator_error_e windicator_moment_bar_hide(void *data);
+//windicator_error_e windicator_moment_bar_hide(void *data);
 //Eina_Bool windicator_moment_bar_timer_cb(void *data);
-void windicator_moment_bar_refresh_main_view(void *data);
+//void windicator_moment_bar_refresh_main_view(void *data);
 //void windicator_handle_fade_in_animation(void* data);
+
+/*
+* @brief: Updates moment bar main view
+* @param[in] data: User data
+*/
 windicator_error_e windicator_moment_bar_update_main_view(void *data);
 
+/*
+* @brief: Show moment bar directly (Registers back key handler)
+* @param[in] data: User data
+*/
 windicator_error_e windicator_show_moment_bar_directly(void* data);
+
+/*
+* @brief: Hides moment bar directly (Deletes back key handler)
+* @param[in] data: User data
+*/
 windicator_error_e windicator_hide_moment_bar_directly(void* data);
 //void windicator_handle_clicked_animation(void* data,int index);
 //void change_theme_callback(void *data);
+
+/*
+* @brief: Deletes back key handler
+* @param[in] data: User data
+*/
 void windicator_util_back_key_ungrab(void *data);
+
+/*
+* @brief: Deletes down key handler
+* @param[in] data: User data
+*/
 void windicator_util_down_key_ungrab(void *data);
 
 #endif /* __WINDICATOR_MOMENT_BAR_H__ */
index a41aad3e0482e0d982ec7c5839d4da7f0c57517a..1360015fec92e4ccd91d8c92a9d84fce1a4e0ae5 100644 (file)
 #ifndef __WINDICATOR_MOMENT_VIEW_H__
 #define __WINDICATOR_MOMENT_VIEW_H__
 
-Eina_Bool windicator_moment_view_timer_cb(void *data);
+//Eina_Bool windicator_moment_view_timer_cb(void *data);
+
+/*
+* @brief: Initializes moment view
+* @param[in] data: User data
+*/
 windicator_error_e windicator_moment_view_init(void *data);
-windicator_error_e windicator_moment_view_show(void *data, int type);
-windicator_error_e windicator_moment_view_hide(void *data);
+//windicator_error_e windicator_moment_view_show(void *data, int type);
+//windicator_error_e windicator_moment_view_hide(void *data);
 
 typedef enum {
        WINDICATOR_MOMENT_VIEW_TYPE_INDICATOR,
index d905c53e0d27416cee43dfab80546db4d7db1894..b85555517968a7efb31e8b1978caf374188df25c 100644 (file)
 #ifndef __WINDICATOR_MUSIC_BTN_H__
 #define __WINDICATOR_MUSIC_BTN_H__
 
+
+/*
+* @brief: Creates music button layout
+* @param[in] parent: Parent of music button layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_music_btn_layout_create(Evas_Object *parent, void *data);
+
+/*
+* @brief: Deletes music button layout
+* @param[in] data: User data
+*/
 void windicator_music_btn_layout_destroy(void *data);
+
+
+/*
+* @brief: Updates (Enables/Disables) music button layout
+* @param[in] data: User data
+*/
 windicator_error_e _music_icon_update(void *data);
 
+/*
+* @brief: Updates (Enables/Disables) music button
+* @param[in] data: User data
+*/
 windicator_error_e windicator_music_btn_update(void *data);
 
+/*
+* @brief: Callback function on mouse click event on music button layout
+* @param[in] data: User data
+* @param[in] obj: music button layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void _music_btn_clicked_cb(void *data, Evas_Object *obj, const char *emission, const char *source);
 
 #endif /* __WINDICATOR_DND_BTN_H__ */
index 7334a085e0b69a4f44f3951da9a52e8b295a0b89..3c46b147affd1ff966758e4cf34b38e8def83d7a 100644 (file)
 #ifndef __WINDICATOR_SCS_H__
 #define __WINDICATOR_SCS_H__
 
+/*
+* @brief: Updates scs text (Connected via bluetooth/ Standalone)
+* @param[in] data: User data
+*/
 windicator_error_e windicator_scs_update(void *data);
+
+/*
+* @brief: Creates scs layout
+* @param[in] parent: parent of scs layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_scs_layout_create(Evas_Object *parent, void *data);
+
+/*
+* @brief: Delets scs layout
+* @param[in] data: User data
+*/
 void windicator_scs_layout_destroy(void *data);
 
+/*
+* @brief: Register scs vconf keys
+* @param[in] data: User data
+*/
 void windicator_scs_vconfkey_register(void *data);
+
+/*
+* @brief: unregister scs vconf keys
+* @param[in] data: User data
+*/
 void windicator_scs_vconfkey_unregister(void);
 
 #endif /* __WINDICATOR_SCS_H__ */
index cc55e0c24fd4ff982abbb063af611103d1ccc941..07874f72ae0f5ebcfddc7c0babbe5284c77098d1 100644 (file)
 #ifndef __WINDICATOR_UTIL_H__
 #define __WINDICATOR_UTIL_H__
 
+/*
+* @brief:  Creates moment bar/ Moment view window based on type
+* @param[in]name: Title of the window
+* @param[in]is_alpha: Boolean directs whether the window's alpha is Set/Unset
+* @param[in]type: type of window (moment bar/ Moment view)
+*/
 Evas_Object* windicator_util_win_create(const char *name, Eina_Bool is_alpha, windicator_type type);
-void windicator_util_win_status_change(Evas_Object *win);
+//void windicator_util_win_status_change(Evas_Object *win);
+
+/*
+* @brief:   Utility function to Create bg
+* @param[in]parent: parent of bg
+*/
 Evas_Object *windicator_util_bg_create(Evas_Object *parent);
+
+/*
+* @brief:   Utility function to Create conformant
+* @param[in]parent: parent of conformant
+*/
 Evas_Object *windicator_util_conformant_create(Evas_Object *parent);
+
+/*
+* @brief:  Utility function to Create layout
+* @param[in]parent: parent of layout
+*/
 Evas_Object *windicator_util_layout_create(Evas_Object *parent);
+
+/*
+* @brief:  Utility function to Create Naviframe
+* @param[in]parent: parent of Naviframe
+*/
 Evas_Object *windicator_util_naviframe_create(Evas_Object *parent);
+
+/*
+* @brief:  Utility function to set notification property on window
+* @param[in]win: window
+*/
 windicator_error_e windicator_util_win_notification_property_set(Evas_Object *win);
 
+/*
+* @brief:  Utility function to launche the app
+* @param[in]data: User data
+*/
 void windicator_util_launch_app(void *data);
 
+/*
+* @brief:  Registers the events with vconf
+* @param[in]data: User data
+*/
 void windicator_util_event_register(void *data);
+
+/*
+* @brief:  Unregisters the events with vconf
+*/
 void windicator_util_event_unregister();
 
+/*
+* @brief:  Finds the application path
+* @param[in]file_in: Path of the file (edje, images etc.)
+* @param[out]file_path_out: To store the result path
+* @param[in]file_path_max: Size of the file_path_out
+*/
 extern void _get_resource(const char *file_in, char *file_path_out, int file_path_max);
 
 #endif /*  __WINDICATOR_UTIL_H_ */
index 73231aa45d1860c67d5fec815a8c7e734a368aed..0736ed371963efe41f03dacddc9792385926e370 100644 (file)
 #ifndef __WINDICATOR_VOLUME_H__
 #define __WINDICATOR_VOLUME_H__
 
+/*
+* @brief: Creates volume small icon layout
+* @param[in] parent: Parent of volume small icon layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_volume_small_icon_create(Evas_Object *parent, void *data);
+
+/*
+* @brief: Delets volume small icon layout
+* @param[in] data: User data
+*/
 void windicator_volume_small_icon_destroy(void *data);
 
+/*
+* @brief: Delets volume small icon layout
+* @param[in] data: User data
+*/
 void windicator_volume_icon_set_by_level(void *data);
+
+/*
+* @brief: Updates volume level
+* @param[in] data: User data
+*/
 windicator_error_e windicator_volume_update(void *data);
 
+/*
+* @brief: Callback function on mouse click event on moment bar first page layout
+* @param[in] data: User data
+* @param[in] obj: moment bar first page layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void on_clicked_small_volume_icon(void *data, Evas_Object *obj, const char *emission, const char *source);
 
+
+/*
+* @brief: Registers the volume change callback.
+*/
 windicator_error_e windicator_volume_register(void *data);
+
+/*
+* @brief: Unregisters the volume change callback.
+*/
 void windicator_volume_unregister();
 
 typedef enum {
index 2137ef4b598f0d0cfcec4ce5f5da4bd8d9ee0a8e..e207e4264331e223db768635862397db5f4127d6 100755 (executable)
 
 struct appdata *g_ad = NULL;
 
+/*
+* @brief:Returns appdata
+*/
 struct appdata *windicator_appdata_get(void)
 {
        return g_ad;
 }
 
+/*
+* @brief: Initializes variables
+* @param[in] data: User data
+*/
 static void _init_variables(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -152,6 +159,10 @@ static void _init_variables(void *data)
        ad->moment_view_battery_icon = NULL;
 }
 
+/*
+* @brief: Sets first layout as default
+* @param[in] data: User data
+*/
 void windicator_lo_update(void* data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -161,6 +172,10 @@ void windicator_lo_update(void* data)
        elm_object_signal_emit(ad->moment_bar_first_page_layout, "set_default_layout", "sw.all");
 }
 
+/*
+* @brief: Creates moment bar window
+* @param[in] user_data: User data
+*/
 void create_moments_bar_win(void *user_data)
 {
        struct appdata *ad = (struct appdata *)user_data;
@@ -256,9 +271,10 @@ static bool app_create(void *data)
 #endif
 }
 
-/**
- * @brief This callback function is called when another application.
- * sends the launch request to the application
+/*
+ * @brief: This callback function is called when another application sends the launch request to the application
+ * @param[in] app_control: App control handle
+ * @param[in] user_data: User data
  */
 
 #ifndef __W_HOME_WIDGET__
@@ -275,9 +291,9 @@ static void app_control(app_control_h app_control, void *user_data)
 
 
 /**
- * @brief This callback function is called each time.
- * the application is completely obscured by another application
- * and becomes invisible to the user
+ * @brief: This callback function is called each time the application is completely obscured by another application and becomes invisible to the user
+ * @param[in] context: Widget context
+ * @param[in] user_data: User data
  */
 #ifdef __W_HOME_WIDGET__
 static int widget_instance_pause(widget_context_h context, void *user_data)
@@ -294,8 +310,9 @@ static void app_pause(void *user_data)
 
 
 /**
- * @brief This callback function is called each time.
- * the application becomes visible to the user
+ * @brief: This callback function is called each time the application becomes visible to the user
+ * @param[in] context: Widget context
+ * @param[in] user_data: User data
  */
 #ifdef __W_HOME_WIDGET__
 static int widget_instance_resume(widget_context_h context, void *user_data)
@@ -327,7 +344,11 @@ static void app_resume(void *user_data)
 
 
 /**
- * @brief This callback function is called once after the main loop of the application exits.
+ * @brief: This callback function is called once after the main loop of the application exits.
+ * @param[in] context: Widget context
+ * @param[in] reason: Reason of distroying Widget
+ * @param[in] content_info: content of the widget bundle
+ * @param[in] user_data: User data
  */
 #ifdef __W_HOME_WIDGET__
 static int widget_instance_destroy(widget_context_h context, widget_app_destroy_type_e reason, bundle *content_info, void *user_data)
@@ -369,11 +390,11 @@ static void app_terminate(void *user_data)
 
 
 /**
- * @brief The callback function called when the update event is occurred.
- * @param[in] context The context of widget instance
- * @param[in] content The data set for updating this widget
- * @param[in] force Although the widget is paused, if it is TRUE, the widget can be updated
- * @param[in] user_data The user data passed from widget_app_class_create function
+ * @brief: The callback function called when the update event is occurred.
+ * @param[in] context: The context of widget instance
+ * @param[in] content: The data set for updating this widget
+ * @param[in] force: Although the widget is paused, if it is TRUE, the widget can be updated
+ * @param[in] user_data: The user data passed from widget_app_class_create function
  */
 static int widget_instance_update(widget_context_h context, bundle *content, int force, void *user_data)
 {
@@ -383,11 +404,11 @@ static int widget_instance_update(widget_context_h context, bundle *content, int
 }
 
 /**
- * @brief The callback function called when the size of the widget is changed.
- * @param[in] context The context of widget instance
- * @param[in] w The pixel value for widget width
- * @param[in] h The pixel value for widget height
- * @param[in] user_data The user data passed from widget_app_class_create function
+ * @brief: The callback function called when the size of the widget is changed.
+ * @param[in] context: The context of widget instance
+ * @param[in] w: The pixel value for widget width
+ * @param[in] h: The pixel value for widget height
+ * @param[in] user_data: The user data passed from widget_app_class_create function
  */
 static int widget_instance_resize(widget_context_h context, int w, int h, void *user_data)
 {
@@ -397,9 +418,9 @@ static int widget_instance_resize(widget_context_h context, int w, int h, void *
 }
 
 /**
- * @brief The callback function called when the language is changed.
- * @param[in] event_info Event_info is a pointer to a data structure about event
- * @param[in] user_data Data passed to the function
+ * @brief: The callback function called when the language is changed.
+ * @param[in] event_info: Event_info is a pointer to a data structure about event
+ * @param[in] user_data: Data passed to the function
  */
 static void widget_app_lang_changed(app_event_info_h event_info, void *user_data)
 {
@@ -412,9 +433,9 @@ static void widget_app_lang_changed(app_event_info_h event_info, void *user_data
 }
 
 /**
- * @brief The callback function called when the region is changed.
- * @param[in] event_info Event_info is a pointer to a data structure about event
- * @param[in] user_data Data passed to the function
+ * @brief: The callback function called when the region is changed.
+ * @param[in] event_info: Event_info is a pointer to a data structure about event
+ * @param[in] user_data: Data passed to the function
  */
 static void widget_app_region_changed(app_event_info_h event_info, void *user_data)
 {
@@ -424,8 +445,8 @@ static void widget_app_region_changed(app_event_info_h event_info, void *user_da
 
 
 /**
- * @brief This function handle the widget create event.
- * @param[in] user_data Data passed to the function
+ * @brief: This function handle the widget create event.
+ * @param[in] user_data: Data passed to the function
  */
 static widget_class_h widget_app_create(void *user_data)
 {
@@ -451,8 +472,8 @@ static widget_class_h widget_app_create(void *user_data)
 }
 
 /**
- * @brief This function handle the widget terminate event.
- * @param[in] user_data Data passed to the function
+ * @brief: This function handle the widget terminate event.
+ * @param[in]user_data: Data passed to the function
  */
 static void widget_app_terminate(void *user_data)
 {
@@ -460,9 +481,11 @@ static void widget_app_terminate(void *user_data)
        _D("");
 }
 
-/**
- * @brief Main function of the application.
- */
+/*
+* @brief: Main Function, Execution starts from here
+* @param[in]argc: Non-negative value representing the number of arguments passed to the program from the environment in which the program is run.
+* @param[in]argv: Pointer to the first element of an array of pointers to null-terminated multibyte strings that represent the arguments passed to the program from the execution environment
+*/
 int main(int argc, char *argv[])
 {
 
@@ -506,6 +529,11 @@ int main(int argc, char *argv[])
 
 }
 
+/**
+ * @brief: Callback function called when watchface status changes
+ * @param[in] node: Keynode variable
+ * @param[in] data: User data
+ */
 static void _watchface_status_changed_cb(keynode_t *node, void *data)
 {
        _D("");
@@ -526,12 +554,19 @@ static void _watchface_status_changed_cb(keynode_t *node, void *data)
 #endif
 }
 
+/*
+ * @brief: Unregister watchface visibility
+ */
+
 void windicator_watchface_unregister()
 {
        _D("");
        vconf_ignore_key_changed(VCONFKEY_HOMESCREEN_WATCH_FACE_VISIBILITY, (vconf_callback_fn)_watchface_status_changed_cb);
 }
-
+/*
+ * @brief: Register watchface visibility
+ * @param[in] data: User data
+ */
 windicator_error_e windicator_watchface_register(void *data)
 {
        _D("");
index 573ab2dbec6636e9529803aa7de3481345a8977a..e677ce5ff2e7d59eb52d6519cf07ec7251512328 100755 (executable)
 #include "windicator_util.h"
 #include "windicator_moment_view.h"
 
+/*
+* @brief: Returns the charging status of the battery 1: if charging, 0: if not charging
+*/
+
 int windicator_battery_charge_now_get(void)
 {
        int ret = 0;
@@ -38,7 +42,10 @@ int windicator_battery_charge_now_get(void)
 
        return is_charged;
 }
-
+/*
+* @brief: Updates the user interface according to charging status
+* @param[in] data: User data
+*/
 void _charging_ui_update(void* data)
 {
 
@@ -70,6 +77,11 @@ void _charging_ui_update(void* data)
        }
 }
 
+/*
+* @brief: Callback function after battery status changes
+* @param[in] node: keynote variable
+* @param[in] data: User data
+*/
 static void _battery_status_changed_cb(keynode_t *node, void *data)
 {
        _W("");
@@ -92,6 +104,10 @@ static void _battery_status_changed_cb(keynode_t *node, void *data)
        }*/
 }
 
+/*
+* @brief: Updates battery icon based on charging/Not charging/Fully Charged
+* @param[in] data: User data
+*/
 
 void _battery_update(void* data)
 {
@@ -113,6 +129,11 @@ void _battery_update(void* data)
        }*/
 }
 
+/*
+* @brief: Callback function, executes if battery charging status changes
+* @param[in] node: keynote variable
+* @param[in] data: User data
+*/
 static void _battery_charging_changed_cb(keynode_t *node, void *data)
 {
 
@@ -154,6 +175,11 @@ static void _battery_charging_changed_cb(keynode_t *node, void *data)
        }*/
 }
 
+/*
+* @brief: Callback function, executes if battery charger status changes
+* @param[in] node: keynote variable
+* @param[in] data: User data
+*/
 static void _battery_charger_status_changed_cb(keynode_t *node, void *data)
 {
 
@@ -174,7 +200,11 @@ static void _battery_charger_status_changed_cb(keynode_t *node, void *data)
        _charging_ui_update(ad);
 
 }
-
+/*
+* @brief: Creates the battery icon layout
+* @param[in] parent: Parent of the battrey icon layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_battery_icon_create(Evas_Object *parent, void *data)
 {
        retv_if(parent == NULL, NULL);
@@ -207,6 +237,12 @@ Evas_Object *windicator_battery_icon_create(Evas_Object *parent, void *data)
 
        return icon;
 }
+
+/*
+* @brief: Updates battery icon based on charging/Not charging/Fully Charged
+* @param[in] layout: The battrey icon layout
+* @param[in] data: User data
+*/
 windicator_error_e windicator_battery_icon_update(Evas_Object *layout, void *data)
 {
 
@@ -318,6 +354,10 @@ windicator_error_e windicator_battery_icon_update(Evas_Object *layout, void *dat
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: Destroy battery icon layout
+* @param[in] data: User data
+*/
 void windicator_battery_icon_destroy(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -328,7 +368,10 @@ void windicator_battery_icon_destroy(void *data)
                ad->moment_bar_battery_icon = NULL;
        }
 }
-
+/*
+* @brief: Initiates the battery charging after event registration
+* @param[in] data: User data
+*/
 windicator_error_e windicator_battery_init(void *data)
 {
 
@@ -352,6 +395,11 @@ windicator_error_e windicator_battery_init(void *data)
 
        return WINDICATOR_ERROR_OK;
 }
+
+/*
+* @brief: Ends the battery charging after event finish
+* @param[in] data: User data
+*/
 void windicator_battery_finish(void)
 {
        /* battery charge connected/disconnected */
index 81e97be49a688b98be5540eace8e13e0ea5d2d71..409719feb2af36a8ad086211cadf48f289f7c5e9 100755 (executable)
 
 #define BRIGHTNESS_LEVEL_MAX 10
 
+/*
+* @brief: Callback function executes after mouse click event on brightness icon
+* @param[in] data: User data
+* @param[in] obj: Brightness icon layout
+* @param[in] emission: emitted signal
+* @param[in] source: Source of the signal
+*/
 void on_clicked_small_brightness_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("on_clicked_small_brightness_icon");
@@ -37,7 +44,13 @@ void on_clicked_small_brightness_icon(void *data, Evas_Object *obj, const char *
        ad->launch_setting_trigger = 1;
        windicator_util_launch_app(ad);
 }
-
+/*
+* @brief: Callback function executes after mouse down event on brightness small layout
+* @param[in] data: User data
+* @param[in] obj: brightness small layout
+* @param[in] emission: emitted signal
+* @param[in] source: Source of the signal
+*/
 void on_pressed_small_brightness_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("");
@@ -47,6 +60,13 @@ void on_pressed_small_brightness_icon(void *data, Evas_Object *obj, const char *
        elm_object_signal_emit(ad->brightness_small_layout, "brightness.pressed", "img.brightness.bg");
 }
 
+/*
+* @brief: Callback function executes after mouse up event on brightness small layout
+* @param[in] data: User data
+* @param[in] obj: brightness small layout
+* @param[in] emission: emitted signal
+* @param[in] source: Source of the signal
+*/
 void on_released_small_brightness_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("");
@@ -56,6 +76,11 @@ void on_released_small_brightness_icon(void *data, Evas_Object *obj, const char
        elm_object_signal_emit(ad->brightness_small_layout, "brightness.released", "img.brightness.bg");
 }
 
+/*
+* @brief: Creates brightness small layout
+* @param[in] parent: parent of brightness small layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_brightness_small_layout_create(Evas_Object *parent, void *data)
 {
        retv_if(parent == NULL, NULL);
@@ -124,6 +149,11 @@ static int _brightness_level_to_index(int level, int max)
        return index;
 }
 */
+
+/*
+* @brief: utility function to convert into string from int
+* @param[in] level: input integer to be converted into string
+*/
 char *windicator_util_str_from_icu_get(int level)
 {
         char *ret_str = NULL;
@@ -138,6 +168,11 @@ char *windicator_util_str_from_icu_get(int level)
        return ret_str;
 }
 
+/*
+* @brief: Brightness icon is set based on level
+* @param[in] layout: brightness small layout
+* @param[in] data: User data
+*/
 void windicator_brightness_icon_set_by_level(Evas_Object *layout, void *data)
 {
        ret_if(layout == NULL);
@@ -153,7 +188,10 @@ void windicator_brightness_icon_set_by_level(Evas_Object *layout, void *data)
        elm_object_part_text_set(layout, "txt.brightness", value);
 }
 
-
+/*
+* @brief: Change brightness level to index from 1 to 10
+* @param[in] level: brightness level
+*/
 static int _change_bright_level_to_index(int level)
 {
        int index = 0;
@@ -165,7 +203,9 @@ static int _change_bright_level_to_index(int level)
        return index;
 }
 
-
+/*
+* @brief: Change brightness level to index from 1 to 10 after getting current brightness level
+*/
 static int _current_device_brightness_level_get(void)
 {
        int level = 0;
@@ -179,7 +219,10 @@ static int _current_device_brightness_level_get(void)
        _I("Brightness level index : %d", index);
        return index;
 }
-
+/*
+* @brief: Update the brightness index
+* @param[in] data: User data
+*/
 windicator_error_e windicator_brightness_update(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -192,6 +235,10 @@ windicator_error_e windicator_brightness_update(void *data)
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: delet the brightness small layout
+* @param[in] data: User data
+*/
 void windicator_brightness_small_layout_destroy(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -203,18 +250,28 @@ void windicator_brightness_small_layout_destroy(void *data)
                ad->brightness_small_layout = NULL;
        }
 }
-
+/*
+* @brief: Callback function called if brightness changes
+* @param[in] node: Keynode variable
+* @param[in] data: User data
+*/
 static void _brightness_status_changed_cb(keynode_t *node, void *data)
 {
        _D("");
        windicator_brightness_update(data);
 }
 
+/*
+* @brief: Unregister the brightnes in vconf
+*/
 void windicator_brightness_unregister()
 {
        vconf_ignore_key_changed(VCONFKEY_SETAPPL_LCD_BRIGHTNESS, (vconf_callback_fn)_brightness_status_changed_cb);
 }
-
+/*
+* @brief: Register vconf for brightness
+* @param[in] data: User data
+*/
 windicator_error_e windicator_brightness_register(void *data)
 {
        _D("");
index d14a02d07d53001c2d7baf5f88dbeb3203df6977..63226c92c0c4c0dd7912f6572558e9cfc620d92c 100755 (executable)
@@ -23,6 +23,9 @@
 #include "windicator_util.h"
 #include "windicator_moment_bar.h"
 
+/*
+* @brief: Returns call forward status. detects the sim is present or not
+*/
 static int windicator_call_fwd_state_get(void)
 {
        int ret = 0;
@@ -38,7 +41,13 @@ static int windicator_call_fwd_state_get(void)
 
        return 0;
 }
-
+/*
+* @brief: Callback function executes after mouse down event on callforward button layout
+* @param[in] data: User data
+* @param[in] obj: Brightness icon layout
+* @param[in] emission: emitted signal
+* @param[in] source: Source of the signal
+*/
 void on_pressed_call_fwd_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("");
@@ -47,7 +56,13 @@ void on_pressed_call_fwd_icon(void *data, Evas_Object *obj, const char *emission
 
        elm_object_signal_emit(ad->callfwd_btn_layout, "callfwd.pressed", "img.callfwd.bg");
 }
-
+/*
+* @brief: Callback function executes after mouse up event on callforward button layout
+* @param[in] data: User data
+* @param[in] obj: Brightness icon layout
+* @param[in] emission: emitted signal
+* @param[in] source: Source of the signal
+*/
 void on_released_call_fwd_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("");
@@ -56,7 +71,11 @@ void on_released_call_fwd_icon(void *data, Evas_Object *obj, const char *emissio
 
        elm_object_signal_emit(ad->callfwd_btn_layout, "callfwd.released", "img.callfwd.bg");
 }
-
+/*
+* @brief:callforward button layout create
+* @param[in] parent: Parent of callforward button layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_callfwd_btn_layout_create(Evas_Object *parent, void *data)
 {
        retv_if(parent == NULL, NULL);
@@ -96,6 +115,10 @@ Evas_Object *windicator_callfwd_btn_layout_create(Evas_Object *parent, void *dat
        return layout;
 }
 
+/*
+* @brief: Update (Enable/Disable ) callforward button layout
+* @param[in] data: User data
+*/
 windicator_error_e windicator_call_fwd_btn_update(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -115,6 +138,10 @@ windicator_error_e windicator_call_fwd_btn_update(void *data)
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: Deletes callforward button layout
+* @param[in] data: User data
+*/
 void windicator_callfwd_btn_layout_destroy(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
index 18fa38a1aa27134849db355d1eac8801078f907c..1f66dfed13356b61c2da31b9ea767d1c1d715ab0 100755 (executable)
@@ -144,6 +144,11 @@ static struct info {
 
 static void _connection_type_changed_cb(keynode_t *node, void *data);
 
+/*
+* @brief: Sets rssi icon based on rssi level
+* @param[in] icon: rssi icon
+*/
+
 static void _rssi_icon_set(Evas_Object *icon)
 {
        struct appdata *ad = (struct appdata *)windicator_appdata_get();
@@ -174,6 +179,11 @@ static void _rssi_icon_set(Evas_Object *icon)
        elm_object_signal_emit(icon, rssi_name[s_info.rssi_level][s_info.is_roaming], "img.rssi");
 }
 
+/*
+* @brief: Callback function if rssi changes
+* @param[in] node: Keynode variable
+* @param[in] data: user data
+*/
 static void _rssi_changed_cb(keynode_t *node, void *data)
 {
        int status = 0;
@@ -211,7 +221,11 @@ static void _rssi_changed_cb(keynode_t *node, void *data)
        _rssi_icon_set(rssi_icon);
 }
 
-
+/*
+* @brief: Sets the packet icon based on connection type
+* @param[in] packet: packet type
+* @param[in] data: user data
+*/
 static void _packet_icon_set(packet_type_e packet, void *data)
 {
        Evas_Object *connect_icon = (Evas_Object *)data;
@@ -231,6 +245,11 @@ static void _packet_icon_set(packet_type_e packet, void *data)
        elm_object_signal_emit(connect_icon, packet_name[packet], "img.connection_packet");
 }
 
+/*
+* @brief: Callback function if connection type changes
+* @param[in] node: keynode variable
+* @param[in] data: user data
+*/
 static void _packet_type_changed_cb(keynode_t *node, void *data)
 {
        _D("_packet_type_changed_cb");
@@ -275,6 +294,11 @@ static void _packet_type_changed_cb(keynode_t *node, void *data)
        _packet_icon_set(type, connect_icon);
 }
 
+/*
+* @brief: Sets connection icon
+* @param[in] type: connection type
+* @param[in] data: user data
+*/
 static void _connection_icon_set(connection_type_e type, void *data)
 {
        struct appdata *ad = (struct appdata *)windicator_appdata_get();
@@ -311,6 +335,11 @@ static void _connection_icon_set(connection_type_e type, void *data)
        _packet_type_changed_cb(NULL, connect_icon);
 }
 
+/*
+* @brief: Callback function after WIFI state changes
+* @param[in] node: Keynode variable
+* @param[in] data: user data
+*/
 static void _wifi_state_changed_cb(keynode_t *node, void *data)
 {
        Evas_Object *connect_icon = (Evas_Object *)data;
@@ -393,6 +422,11 @@ static void _wifi_state_changed_cb(keynode_t *node, void *data)
        _packet_icon_set(packet_type, connect_icon);
 }
 
+/*
+* @brief: Updates the connection after momentbar initiates
+* @param[in] rssi_icon: rssi icon
+* @param[in] connect_icon: Connection icon
+*/
 void windi_connection_update(Evas_Object *rssi_icon, Evas_Object *connect_icon)
 {
        _D("windi_connection_update");
@@ -404,6 +438,11 @@ void windi_connection_update(Evas_Object *rssi_icon, Evas_Object *connect_icon)
        _wifi_state_changed_cb(NULL, connect_icon);
 }
 
+/*
+* @brief: Callback function if connection type changes
+* @param[in] node: Keynode variable
+* @param[in] data: User data
+*/
 static void _connection_type_changed_cb(keynode_t *node, void *data)
 {
        Evas_Object *connect_icon = (Evas_Object *)data;
@@ -520,6 +559,11 @@ static void _connection_type_changed_cb(keynode_t *node, void *data)
        _wifi_state_changed_cb(NULL, connect_icon);
 }
 
+/*
+* @brief: Called if connection resumes
+* @param[in] rssi_icon: rssi icon
+* @param[in] connect_icon: connection icon
+*/
 void windi_connection_resume(Evas_Object *rssi_icon, Evas_Object *connect_icon)
 {
        _D("");
@@ -560,6 +604,9 @@ void windi_connection_resume(Evas_Object *rssi_icon, Evas_Object *connect_icon)
        vconf_notify_key_changed(VCONFKEY_TELEPHONY_RSSI, _rssi_changed_cb, rssi_icon);
 }
 
+/*
+* @brief: Called if connection pauses
+*/
 void windi_connection_pause(void)
 {
        _D("");
index 0b7a7068d1d240c149810d3302be4c4bb3a17486..0b3b57f514dc9f46a460f3c8aa0cf8f51ae2616e 100755 (executable)
@@ -40,6 +40,10 @@ static struct _s_info {
        .dnd_btn_status = DND_BTN_ENABLED,
 };
 
+/*
+* @brief: Creates do not disturb window
+* @param[in] name: Title of the window
+*/
 static Evas_Object* __dnd_create_win(const char *name)
 {
        _W("API() entered.");
@@ -66,12 +70,24 @@ static Evas_Object* __dnd_create_win(const char *name)
        return pObj;
 }
 
+/*
+* @brief: Callback function, Dismisses the popup with a hide effect
+* @param[in] data: User data
+* @param[in] obj: Popup which needs to be dismissed
+* @param[in] event_info: Event info associated with popup
+*/
 static void _popup_hide_cb(void *data, Evas_Object *obj, void *event_info)
 {
        if (!obj) return;
        elm_popup_dismiss(obj);
 }
 
+/*
+* @brief: Callback function registered with button
+* @param[in] data: User data
+* @param[in] obj: Popup
+* @param[in] event_info: Event info associated with popup
+*/
 static void _popup_response_cb(void *data, Evas_Object *obj, void *event_info)
 {
        if (!obj) return;
@@ -96,6 +112,12 @@ static void _popup_response_cb(void *data, Evas_Object *obj, void *event_info)
        windicator_show_moment_bar_directly(ad);
 }
 
+/*
+* @brief: Callback function if popup has been dismissed
+* @param[in] data: User data
+* @param[in] obj: Popup
+* @param[in] event_info: Event info associated with popup
+*/
 static void _popup_hide_finished_cb(void *data, Evas_Object *obj, void *event_info)
 {
        _D("_popup_hide_finished_cb");
@@ -112,6 +134,10 @@ static void _popup_hide_finished_cb(void *data, Evas_Object *obj, void *event_in
        windicator_show_moment_bar_directly(ad);
 }
 
+/*
+* @brief: Launches the dnd popup
+* @param[in] data: User data
+*/
 static void _dnd_popup_launch(void* data)
 {
 
@@ -197,7 +223,13 @@ static void _dnd_popup_launch(void* data)
        evas_object_show(ad->dnd_win);
        evas_object_show(popup);
 }
-
+/*
+* @brief: Callback function if dnd touch area is clicked
+* @param[in] data: User data
+* @param[in] obj: moment bar main layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void _dnd_btn_clicked_cb(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _I("(%d)", s_info.dnd_btn_status);
@@ -214,7 +246,13 @@ void _dnd_btn_clicked_cb(void *data, Evas_Object *obj, const char *emission, con
                _dnd_popup_launch(ad);
        }
 }
-
+/*
+* @brief: Callback function on mouse down event on dnd button layout
+* @param[in] data: User data
+* @param[in] obj: dnd button layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void on_pressed_dnd_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("");
@@ -223,7 +261,13 @@ void on_pressed_dnd_icon(void *data, Evas_Object *obj, const char *emission, con
 
        elm_object_signal_emit(ad->dnd_btn_layout, "dnd.pressed", "img.disturb.bg");
 }
-
+/*
+* @brief: Callback function on mouse up event on dnd button layout
+* @param[in] data: User data
+* @param[in] obj: dnd button layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void on_released_dnd_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("");
@@ -233,6 +277,11 @@ void on_released_dnd_icon(void *data, Evas_Object *obj, const char *emission, co
        elm_object_signal_emit(ad->dnd_btn_layout, "dnd.released", "img.disturb.bg");
 }
 
+/*
+* @brief: Creates the dnd button layout
+* @param[in] parent: Parent of the dnd button layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_dnd_btn_layout_create(Evas_Object *parent, void *data)
 {
        retv_if(parent == NULL, NULL);
@@ -264,6 +313,10 @@ Evas_Object *windicator_dnd_btn_layout_create(Evas_Object *parent, void *data)
        return layout;
 }
 
+/*
+* @brief: Deletes dnd button
+* @param[in] data: User data
+*/
 void windicator_dnd_btn_layout_destroy(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -276,6 +329,10 @@ void windicator_dnd_btn_layout_destroy(void *data)
        }
 }
 
+/*
+* @brief: Updates(Enables/Disables) the dnd button
+* @param[in] data: User data
+*/
 windicator_error_e windicator_dnd_btn_update(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -302,6 +359,10 @@ windicator_error_e windicator_dnd_btn_update(void *data)
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: Destroys the dnd popup after widget instance gets destroyed
+* @param[in] data: User data
+*/
 void windicator_dnd_popup_destroy(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
index 3d0f99ce23fb91a820c4dd0855460811d0a2236c..9df275e8cfa999221ea24f8c08641bd6618cbd2e 100755 (executable)
@@ -50,6 +50,11 @@ Evas_Object* view_gps_icon = NULL;
 Evas_Object* view_sound_icon = NULL;
 Evas_Object* view_alarm_icon = NULL;
 
+/*
+* @brief: Creats rssi icon layout
+* @param[in] parent: Parent of rssi icon layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_rssi_icon_create(Evas_Object *parent, void *data)
 {
        retv_if(parent == NULL, NULL);
@@ -80,6 +85,11 @@ Evas_Object *windicator_rssi_icon_create(Evas_Object *parent, void *data)
        return icon;
 }
 
+/*
+* @brief: Creats connection icon layout
+* @param[in] parent: Parent of connection icon layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_connection_icon_create(Evas_Object *parent, void *data)
 {
        retv_if(parent == NULL, NULL);
@@ -109,6 +119,10 @@ Evas_Object *windicator_connection_icon_create(Evas_Object *parent, void *data)
        return icon;
 }
 
+/*
+* @brief: Deletes rssi icon
+* @param[in] data: User data
+*/
 void windicator_rssi_icon_destroy(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -120,6 +134,11 @@ void windicator_rssi_icon_destroy(void *data)
        }
 }
 
+/*
+* @brief: Creats dynamic layout
+* @param[in] parent: Parent of dynamic layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_dynamic_layout_create(Evas_Object *parent, void *data)
 {
        retv_if(parent == NULL, NULL);
@@ -174,6 +193,12 @@ Evas_Object *windicator_dynamic_layout_create(Evas_Object *parent, void *data)
        return layout;
 }
 
+/*
+* @brief: Creates bluetooth/Headset icon layout based on event_type
+* @param[in] layout: Parent of icon
+* @param[in] event_type: Event type e.g Bluetooth or Headset
+* @param[in] isForMomentView: 1 for moment view, 0 for moment bar
+*/
 static Evas_Object *_dynamic_event_icon_create(Evas_Object *layout, int event_type, int isForMomentView)
 {
        Evas_Object *icon = NULL;
@@ -245,6 +270,11 @@ static Evas_Object *_dynamic_event_icon_create(Evas_Object *layout, int event_ty
        return icon;
 }
 
+/*
+* @brief: Refresh position of icons in dynamic layout
+* @param[in] layout: dynamic layout
+* @param[in] isForMomentView: 1 for moment view, 0 for moment bar
+*/
 void dynamic_event_icon_refresh_position_for_3g(Evas_Object *layout, int isForMomentView)
 {
        struct appdata *ad = (struct appdata *)windicator_appdata_get();
@@ -445,6 +475,13 @@ void dynamic_event_icon_refresh_position_for_3g(Evas_Object *layout, int isForMo
        }
        _D("Refresh DONE");
 }
+
+/*
+* @brief: Creates bluetooth/Headset icon layout based on event_type
+* @param[in] event_type: Event type e.g Bluetooth or Headset
+* @param[in] isForMomentView: 1 for moment view, 0 for moment bar
+* @param[in] data: User data
+*/
 static void _dynamic_event_item_pack(int event_type, int isForMomentView, void *data)
 {
        Evas_Object *layout = (Evas_Object *)data;
@@ -492,6 +529,11 @@ static void _dynamic_event_item_pack(int event_type, int isForMomentView, void *
 #endif
 }
 
+/*
+* @brief: Deletes the item (bluetooth/Headset icon)
+* @param[in] item: Item to be deleted
+* @param[in] event_type: Event type e.g Bluetooth or Headset
+*/
 static void _dynamic_event_icon_del(Evas_Object *item, int event_type)
 {
        ret_if(item == NULL);
@@ -502,6 +544,12 @@ static void _dynamic_event_icon_del(Evas_Object *item, int event_type)
        item = NULL;
 }
 
+/*
+* @brief: Unpacks the dynamic event item (bluetooth/Headset icon)
+* @param[in] event_type: Event type e.g Bluetooth or Headset
+* @param[in] isForMomentView: 1 for moment view, 0 for moment bar
+* @param[in] data: User data
+*/
 static void _dynamic_event_item_unpack(int event_type, int isForMomentView, void *data)
 {
        Evas_Object *layout = (Evas_Object *)data;
@@ -576,6 +624,11 @@ static void _dynamic_event_item_unpack(int event_type, int isForMomentView, void
 #endif
 }
 
+/*
+* @brief: Unpacks/Packs bluetooth item if bluetooth state changes
+* @param[in] node: Keynode variable=
+* @param[in] data: User data
+*/
 static void _dynamic_bluetooth_state_changed_cb(void *node, void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -647,7 +700,11 @@ static void _dynamic_bluetooth_state_changed_cb(void *node, void *data)
 
 
 }
-
+/*
+* @brief: Unpacks/Packs Headset item if headset state changes
+* @param[in] node: Keynode variable=
+* @param[in] data: User data
+*/
 static void _dynamic_headset_state_changed_cb(keynode_t *node, void *data)
 {
        _D("");
@@ -699,6 +756,10 @@ static void _dynamic_headset_state_changed_cb(keynode_t *node, void *data)
        }
 }
 
+/*
+* @brief: Updates the dynamic icons (Bluetooth/Headset)
+* @param[in] data: User data
+*/
 windicator_error_e windicator_dynamic_update(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -710,7 +771,10 @@ windicator_error_e windicator_dynamic_update(void *data)
 
        return WINDICATOR_ERROR_OK;
 }
-
+/*
+* @brief: Destroys the connection icon layout
+* @param[in] data: User data
+*/
 void windicator_connection_icon_destroy(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -722,6 +786,10 @@ void windicator_connection_icon_destroy(void *data)
        }
 }
 
+/*
+* @brief: Destroys Dynamic (the connection icon) layout
+* @param[in] data: User data
+*/
 void windicator_dynamic_layout_destroy(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -737,6 +805,10 @@ void windicator_dynamic_layout_destroy(void *data)
 }
 
 
+/*
+* @brief: Vconf register for dynamic icons (Bluetooth/Headset)
+* @param[in] data: User data
+*/
 windicator_error_e windicator_dynamic_vconfkey_register(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -757,6 +829,9 @@ windicator_error_e windicator_dynamic_vconfkey_register(void *data)
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: Vconf unregister for dynamic icons (Bluetooth/Headset)
+*/
 void windicator_dynamic_vconfkey_unregister(void)
 {
        /* ignore BT for Bluetooth icon */
@@ -770,6 +845,11 @@ void windicator_dynamic_vconfkey_unregister(void)
        vconf_ignore_key_changed(VCONFKEY_BT_DEVICE, (vconf_callback_fn)_dynamic_headset_state_changed_cb);
 }
 
+/*
+* @brief: Sets dynamic layout
+* @param[in] data: User data
+* @param[in] isBTConnected: Boolean tells if bluetooth is connected
+*/
 void windicator_set_dynamic_icon_layout(void* data, int isBTConnected)
 {
        _D("Only for 3G model");
index b2344504bdaadbe5210a9e737207e63b302ca2c2..e68dedcd9a3777fcd04048c651e723993265615a 100755 (executable)
@@ -35,6 +35,10 @@ static struct _s_info {
        .flight_mode_status = FLIGHT_MODE_ENABLED,
 };
 
+/*
+* @brief: Creates Flight mode window
+* @param[in] data: Title of the flight mode window
+*/
 static Evas_Object* __flignt_mode_create_win(const char *name)
 {
        _W("API() entered.");
@@ -62,12 +66,24 @@ static Evas_Object* __flignt_mode_create_win(const char *name)
        return pObj;
 }
 
+/*
+* @brief: Callback function, Dismisses the popup with a hide effect
+* @param[in] data: User data
+* @param[in] obj: Popup which needs to be dismissed
+* @param[in] event_info: Event info associated with popup
+*/
 static void _popup_hide_cb(void *data, Evas_Object *obj, void *event_info)
 {
        if (!obj) return;
        elm_popup_dismiss(obj);
 }
 
+/*
+* @brief: Callback function registered with button
+* @param[in] data: User data
+* @param[in] obj: Popup
+* @param[in] event_info: Event info associated with popup
+*/
 static void _popup_response_cb(void *data, Evas_Object *obj, void *event_info)
 {
        if (!obj) return;
@@ -97,6 +113,12 @@ static void _popup_response_cb(void *data, Evas_Object *obj, void *event_info)
        ad->flight_mode_win = NULL;
 }
 
+/*
+* @brief: Callback function if popup has been dismissed
+* @param[in] data: User data
+* @param[in] obj: Popup
+* @param[in] event_info: Event info associated with popup
+*/
 static void _popup_hide_finished_cb(void *data, Evas_Object *obj, void *event_info)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -109,6 +131,10 @@ static void _popup_hide_finished_cb(void *data, Evas_Object *obj, void *event_in
        ad->flight_mode_win = NULL;
 }
 
+/*
+* @brief: Launches the flight mode popup
+* @param[in] data: User data
+*/
 static void _flight_mode_popup_launch(void* data)
 {
 
@@ -187,6 +213,14 @@ static void _flight_mode_popup_launch(void* data)
        evas_object_show(popup);
 }
 
+/*
+* @brief: Callback function on mouse click event on flight mode icon layout
+* @param[in] data: User data
+* @param[in] obj: flight mode icon layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
+
 void _flight_mode_clicked_cb(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _I("(%d)", s_info.flight_mode_status);
@@ -209,6 +243,14 @@ void _flight_mode_clicked_cb(void *data, Evas_Object *obj, const char *emission,
         }
 }
 
+
+/*
+* @brief: Callback function on mouse down event on flight mode icon layout
+* @param[in] data: User data
+* @param[in] obj: flight mode icon layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void on_pressed_flight_mode_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("");
@@ -218,6 +260,13 @@ void on_pressed_flight_mode_icon(void *data, Evas_Object *obj, const char *emiss
        elm_object_signal_emit(ad->flight_mode_layout, "flight.pressed", "img.flight.bg");
 }
 
+/*
+* @brief: Callback function on mouse up event on flight mode icon layout
+* @param[in] data: User data
+* @param[in] obj: flight mode icon layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void on_released_flight_mode_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("");
@@ -227,6 +276,11 @@ void on_released_flight_mode_icon(void *data, Evas_Object *obj, const char *emis
        elm_object_signal_emit(ad->flight_mode_layout, "flight.released", "img.flight.bg");
 }
 
+/*
+* @brief: Creates the flight mode icon layout
+* @param[in] parent: Parent of the flight mode icon layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_flight_mode_layout_create(Evas_Object *parent, void *data)
 {
        retv_if(parent == NULL, NULL);
@@ -259,7 +313,10 @@ Evas_Object *windicator_flight_mode_layout_create(Evas_Object *parent, void *dat
 
        return layout;
 }
-
+/*
+* @brief: Destroys the flight mode icon
+* @param[in] data: User data
+*/
 void windicator_flight_mode_layout_destroy(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -271,7 +328,10 @@ void windicator_flight_mode_layout_destroy(void *data)
                ad->flight_mode_layout = NULL;
        }
 }
-
+/*
+* @brief: Updates(Enables/Disables) the flight mode icon
+* @param[in] data: User data
+*/
 windicator_error_e windicator_flight_mode_update(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
index aafe4243d18a6de8f3fff1cdbb4dd5bceae7e37f..22287a3f5c1e7c760a8c1c012361b41e795a06c5 100755 (executable)
 #define KEY_BACK "XF86Back"
 #define KEY_DOWN "XF86PowerOff"
 
+/*
+* @brief: Creates moment bar first page
+* @param[in] data: User data
+*/
 Evas_Object *windicator_moment_bar_first_page_layout_create(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -139,6 +143,10 @@ Evas_Object *windicator_moment_bar_first_page_layout_create(void *data)
        return layout;
 }
 
+/*
+* @brief: Updates moment bar main view
+* @param[in] data: User data
+*/
 windicator_error_e windicator_moment_bar_update_main_view(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -164,6 +172,12 @@ windicator_error_e windicator_moment_bar_update_main_view(void *data)
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: Callback function registered with back key (ECORE_EVENT_KEY_UP)
+* @param[in] data: User data
+* @param[in] type: type of key event
+* @param[in] event: Back key press event
+*/
 static Eina_Bool _key_release_event_cb(void *data, int type, void *event)
 {
         struct appdata *ad = (struct appdata *)data;
@@ -182,6 +196,12 @@ static Eina_Bool _key_release_event_cb(void *data, int type, void *event)
        return EINA_FALSE;
 }
 
+/*
+* @brief: Callback function registered with back key (ECORE_EVENT_KEY_DOWN)
+* @param[in] data: User data
+* @param[in] type: type of key event
+* @param[in] event: Back key press event
+*/
 static Eina_Bool _down_release_event_cb(void *data, int type, void *event)
 {
         struct appdata *ad = (struct appdata *)data;
@@ -199,7 +219,10 @@ static Eina_Bool _down_release_event_cb(void *data, int type, void *event)
 #endif
        return EINA_FALSE;
 }
-
+/*
+* @brief: Register back key handler
+* @param[in] data: User data
+*/
 windicator_error_e windicator_util_back_key_grab(void *data)
 {
        _D("");
@@ -218,6 +241,10 @@ windicator_error_e windicator_util_back_key_grab(void *data)
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: Register down key handler
+* @param[in] data: User data
+*/
 windicator_error_e windicator_util_down_key_grab(void *data)
 {
        _D("");
@@ -236,6 +263,10 @@ windicator_error_e windicator_util_down_key_grab(void *data)
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: Deletes back key handler
+* @param[in] data: User data
+*/
 void windicator_util_back_key_ungrab(void *data)
 {
        _D("");
@@ -248,6 +279,10 @@ void windicator_util_back_key_ungrab(void *data)
        }
 }
 
+/*
+* @brief: Deletes down key handler
+* @param[in] data: User data
+*/
 void windicator_util_down_key_ungrab(void *data)
 {
        _D("");
@@ -260,6 +295,10 @@ void windicator_util_down_key_ungrab(void *data)
        }
 }
 
+/*
+* @brief: Show the moment bar if connection resumes. register back/Down key handlers
+* @param[in] data: User data
+*/
 windicator_error_e windicator_moment_bar_show(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -285,6 +324,10 @@ windicator_error_e windicator_moment_bar_show(void *data)
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: Show moment bar directly (Registers back key handler)
+* @param[in] data: User data
+*/
 windicator_error_e windicator_show_moment_bar_directly(void* data)
 {
 
@@ -300,6 +343,10 @@ windicator_error_e windicator_show_moment_bar_directly(void* data)
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: Hides moment bar directly (Deletes back key handler)
+* @param[in] data: User data
+*/
 windicator_error_e windicator_hide_moment_bar_directly(void* data)
 {
        _D("windicator_hide_moment_bar_directly");
@@ -313,6 +360,10 @@ windicator_error_e windicator_hide_moment_bar_directly(void* data)
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: Moment bar initializes
+* @param[in] data: User data
+*/
 windicator_error_e windicator_moment_bar_init(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
index daafa2c33c88d2f26add38808a6d29f4241a515b..5d99fd28e2b51b69e4d157de8280dd1eefcf21ee 100755 (executable)
        return layout;
 }*/
 
+/*
+* @brief: Create moment bar battery layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_moment_view_battery_layout_create(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -82,6 +86,11 @@ Evas_Object *windicator_moment_view_battery_layout_create(void *data)
        return layout;
 }
 
+/*
+* @brief: Create dynamic layout
+* @param[in] parent: Parent of the dynamic layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_dynamic_layout_for_moment_view_create(Evas_Object *parent, void *data)
 {
        retv_if(parent == NULL, NULL);
@@ -119,6 +128,10 @@ Evas_Object *windicator_dynamic_layout_for_moment_view_create(Evas_Object *paren
        return layout;
 }
 
+/*
+* @brief: Create moment view layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_moment_view_layout_create(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -169,6 +182,10 @@ Evas_Object *windicator_moment_view_layout_create(void *data)
 
 }
 
+/*
+* @brief: Initializes moment view
+* @param[in] data: User data
+*/
 windicator_error_e windicator_moment_view_init(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
index f0a0dcb1a2c6f6d939f2e0811a4d07bdf4fa923c..64c32b4acb5aa6afe23c4770bb7bd1ab7153352a 100755 (executable)
 #include "windicator_moment_bar.h"
 #include "windicator_volume.h"
 
+/*
+* @brief: Callback function on mouse click event on music button layout
+* @param[in] data: User data
+* @param[in] obj: music button layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void _music_btn_clicked_cb(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("_music_btn_clicked_cb");
@@ -40,6 +47,13 @@ void _music_btn_clicked_cb(void *data, Evas_Object *obj, const char *emission, c
        }
 }
 
+/*
+* @brief: Callback function on mouse down event on music button layout
+* @param[in] data: User data
+* @param[in] obj: music button layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void on_pressed_music_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("");
@@ -50,6 +64,13 @@ void on_pressed_music_icon(void *data, Evas_Object *obj, const char *emission, c
                elm_object_signal_emit(ad->music_btn_layout, "music.pressed", "img.music.bg");
 }
 
+/*
+* @brief: Callback function on mouse up event on music button layout
+* @param[in] data: User data
+* @param[in] obj: music button layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void on_released_music_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("");
@@ -60,6 +81,11 @@ void on_released_music_icon(void *data, Evas_Object *obj, const char *emission,
                elm_object_signal_emit(ad->music_btn_layout, "music.released", "img.music.bg");
 }
 
+/*
+* @brief: Creates music button layout
+* @param[in] parent: Parent of music button layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_music_btn_layout_create(Evas_Object *parent, void *data)
 {
        retv_if(parent == NULL, NULL);
@@ -105,6 +131,10 @@ Evas_Object *windicator_music_btn_layout_create(Evas_Object *parent, void *data)
        return layout;
 }
 
+/*
+* @brief: Deletes music button layout
+* @param[in] data: User data
+*/
 void windicator_music_btn_layout_destroy(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -117,6 +147,10 @@ void windicator_music_btn_layout_destroy(void *data)
        }
 }
 
+/*
+* @brief: Updates (Enables/Disables) music button layout
+* @param[in] data: User data
+*/
 windicator_error_e _music_icon_update(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -138,6 +172,10 @@ windicator_error_e _music_icon_update(void *data)
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: Updates (Enables/Disables) music button
+* @param[in] data: User data
+*/
 windicator_error_e windicator_music_btn_update(void *data)
 {
        _D("");
index 1ed4eaf8888378596380cc9ea6d2059beda329f2..e30658957c3b1ce7a2bb790f5533fa9f4d72dafc 100755 (executable)
 #include "windicator_dynamic.h"
 #include "windicator_string.h"
 
+/*
+* @brief: Updates scs text (Connected via bluetooth/ Standalone)
+* @param[in] data: User data
+*/
 windicator_error_e windicator_scs_update(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -66,6 +70,11 @@ done:
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: Creates scs layout
+* @param[in] parent: parent of scs layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_scs_layout_create(Evas_Object *parent, void *data)
 {
        retv_if(parent == NULL, NULL);
@@ -102,6 +111,10 @@ Evas_Object *windicator_scs_layout_create(Evas_Object *parent, void *data)
        return layout;
 }
 
+/*
+* @brief: Delets scs layout
+* @param[in] data: User data
+*/
 void windicator_scs_layout_destroy(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -113,12 +126,21 @@ void windicator_scs_layout_destroy(void *data)
        }
 }
 
+/*
+* @brief: Callback function called when scs status changes
+* @param[in] node : keynode variable
+* @param[in] data: User data
+*/
 static void _scs_event_changed_cb(keynode_t *node, void *data)
 {
        _D("scs event changed : update");
         windicator_scs_update(data);
 }
 
+/*
+* @brief: Register scs vconf keys
+* @param[in] data: User data
+*/
 void windicator_scs_vconfkey_register(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -129,6 +151,10 @@ void windicator_scs_vconfkey_register(void *data)
        vconf_notify_key_changed(VCONFKEY_BT_DEVICE, (vconf_callback_fn)_scs_event_changed_cb, ad);
 }
 
+/*
+* @brief: unregister scs vconf keys
+* @param[in] data: User data
+*/
 void windicator_scs_vconfkey_unregister(void)
 {
        vconf_ignore_key_changed(VCONFKEY_BT_STATUS, (vconf_callback_fn)_scs_event_changed_cb);
index 62b693e73085c584f1246ee86ee2d34bd956fcdb..278557dc356f6d60552b854d11cdbab4b346c3fc 100755 (executable)
 
 #define CLOCK_SETTING_PKG_NAME  "org.tizen.watch-setting"
 
+/*
+* @brief:  Finds the application path
+* @param[in]file_in: Path of the file (edje, images etc.)
+* @param[out]file_path_out: To store the result path
+* @param[in]file_path_max: Size of the file_path_out
+*/
 void _get_resource(const char *file_in, char *file_path_out, int file_path_max)
 {
        char *res_path = app_get_resource_path();
@@ -39,6 +45,10 @@ void _get_resource(const char *file_in, char *file_path_out, int file_path_max)
        }
 }
 
+/*
+* @brief:   Utility function to Create bg
+* @param[in]parent: parent of bg
+*/
 Evas_Object *windicator_util_bg_create(Evas_Object *parent)
 {
        retv_if(parent == NULL, NULL);
@@ -54,6 +64,10 @@ Evas_Object *windicator_util_bg_create(Evas_Object *parent)
        return bg;
 }
 
+/*
+* @brief:   Utility function to Create conformant
+* @param[in]parent: parent of conformant
+*/
 Evas_Object *windicator_util_conformant_create(Evas_Object *parent)
 {
        retv_if(parent == NULL, NULL);
@@ -70,6 +84,10 @@ Evas_Object *windicator_util_conformant_create(Evas_Object *parent)
 
 }
 
+/*
+* @brief:  Utility function to Create layout
+* @param[in]parent: parent of layout
+*/
 Evas_Object *windicator_util_layout_create(Evas_Object *parent)
 {
        Evas_Object *layout;
@@ -92,6 +110,10 @@ Evas_Object *windicator_util_layout_create(Evas_Object *parent)
        return layout;
 }
 
+/*
+* @brief:  Utility function to Create Naviframe
+* @param[in]parent: parent of Naviframe
+*/
 Evas_Object *windicator_util_naviframe_create(Evas_Object *parent)
 {
        Evas_Object *nf = NULL;
@@ -108,6 +130,10 @@ Evas_Object *windicator_util_naviframe_create(Evas_Object *parent)
        return nf;
 }
 
+/*
+* @brief:  Utility function to set notification property on window
+* @param[in]win: window
+*/
 windicator_error_e windicator_util_win_notification_property_set(Evas_Object *win)
 {
        retv_if(win == NULL, WINDICATOR_ERROR_FAIL);
@@ -118,11 +144,23 @@ windicator_error_e windicator_util_win_notification_property_set(Evas_Object *wi
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief:  Callback function to exit the app registered with window
+* @param[in]data: User data
+* @param[in]obj: window on which this callback is registered
+* @param[in]ei: Event info associated
+*/
 static void _quit_cb(void *data, Evas_Object *obj, void *ei)
 {
        elm_exit();
 }
 
+/*
+* @brief:  Creates moment bar/ Moment view window based on type
+* @param[in]name: Title of the window
+* @param[in]is_alpha: Boolean directs whether the window's alpha is Set/Unset
+* @param[in]type: type of window (moment bar/ Moment view)
+*/
 Evas_Object* windicator_util_win_create(const char *name, Eina_Bool is_alpha, windicator_type type)
 {
        retv_if(name == NULL, NULL);
@@ -160,6 +198,10 @@ Evas_Object* windicator_util_win_create(const char *name, Eina_Bool is_alpha, wi
        }
 }
 
+/*
+* @brief:  Utility function to launche the app
+* @param[in]data: User data
+*/
 void windicator_util_launch_app(void *data)
 {
        _I("");
@@ -190,6 +232,10 @@ void windicator_util_launch_app(void *data)
 
 }
 
+/*
+* @brief:  Registers the events with vconf
+* @param[in]data: User data
+*/
 void windicator_util_event_register(void *data)
 {
         struct appdata *ad = (struct appdata *)data;
@@ -213,7 +259,9 @@ void windicator_util_event_register(void *data)
                _E("Failed to register dynamic vconfkey event");
 }
 
-
+/*
+* @brief:  Unregisters the events with vconf
+*/
 void windicator_util_event_unregister()
 {
        windicator_dynamic_vconfkey_unregister();
@@ -223,6 +271,9 @@ void windicator_util_event_unregister()
        windicator_watchface_unregister();
 }
 
+/*
+* @brief:  Locks the given lock state (Dim display here) for a specified time.
+*/
 void windicator_util_display_lock(void)
 {
         device_power_request_lock(POWER_LOCK_DISPLAY_DIM, 0);
index 4c9345ef07157fcf8c9ea399ab762dfd0a82f674..757a5ae005e9e4e85d58f82c95cf8874012e6d27 100755 (executable)
 #include "windicator_music_btn.h"
 #include "windicator_util.h"
 
+/*
+* @brief: Callback function on mouse down event on volume small icon layout
+* @param[in] data: User data
+* @param[in] obj: volume small icon layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void on_pressed_volume_small_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("");
@@ -38,6 +45,13 @@ void on_pressed_volume_small_icon(void *data, Evas_Object *obj, const char *emis
        elm_object_signal_emit(ad->volume_small_icon, "volume.pressed", "img.volume.bg");
 }
 
+/*
+* @brief: Callback function on mouse up event on volume small icon layout
+* @param[in] data: User data
+* @param[in] obj: volume small icon layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void on_released_volume_small_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("");
@@ -47,6 +61,13 @@ void on_released_volume_small_icon(void *data, Evas_Object *obj, const char *emi
        elm_object_signal_emit(ad->volume_small_icon, "volume.released", "img.volume.bg");
 }
 
+/*
+* @brief: Callback function on mouse click event on moment bar first page layout
+* @param[in] data: User data
+* @param[in] obj: moment bar first page layout
+* @param[in] emission: Emitted signal
+* @param[in] source: Source of the signal emitted
+*/
 void on_clicked_small_volume_icon(void *data, Evas_Object *obj, const char *emission, const char *source)
 {
        _D("on_clicked_small_volume_icon");
@@ -58,7 +79,11 @@ void on_clicked_small_volume_icon(void *data, Evas_Object *obj, const char *emis
        ad->launch_setting_trigger = 3;
        windicator_util_launch_app(ad);
 }
-
+/*
+* @brief: Creates volume small icon layout
+* @param[in] parent: Parent of volume small icon layout
+* @param[in] data: User data
+*/
 Evas_Object *windicator_volume_small_icon_create(Evas_Object *parent, void *data)
 {
        retv_if(parent == NULL, NULL);
@@ -92,6 +117,10 @@ Evas_Object *windicator_volume_small_icon_create(Evas_Object *parent, void *data
        return layout;
 }
 
+/*
+* @brief: Delets volume small icon layout
+* @param[in] data: User data
+*/
 void windicator_volume_small_icon_destroy(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -104,6 +133,10 @@ void windicator_volume_small_icon_destroy(void *data)
        }
 }
 
+/*
+* @brief: Sets the volume by level on volume small icon layout
+* @param[in] data: User data
+*/
 void windicator_volume_icon_set_by_level(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -125,7 +158,10 @@ void windicator_volume_icon_set_by_level(void *data)
                elm_object_signal_emit(ad->volume_small_icon, "volume.icon.mute", "img.volume.icon");
 }
 
-
+/*
+* @brief: Checks whether telephony is Enabled/Disabled
+* @param[in] path: path to be checked
+*/
 static int is_supported(const char *path)
 {
        bool res;
@@ -138,6 +174,9 @@ static int is_supported(const char *path)
        return res;
 }
 
+/*
+* @brief: Checks whether a particular feature is Enabled/Disabled
+*/
 int is_telephony_enable(void)
 {
        int ret = is_supported(SETTING_TELEPHONY_PATH);
@@ -151,7 +190,10 @@ int is_telephony_enable(void)
        return ret;
 }
 
-
+/*
+* @brief: returns current volume level
+* @param[in] data: User data
+*/
 static int _current_device_volume_level_get(void* data)
 {
        int level = 1;
@@ -171,6 +213,10 @@ static int _current_device_volume_level_get(void* data)
        return level;
 }
 
+/*
+* @brief: Updates volume level
+* @param[in] data: User data
+*/
 windicator_error_e windicator_volume_update(void *data)
 {
        struct appdata *ad = (struct appdata *)data;
@@ -187,18 +233,29 @@ windicator_error_e windicator_volume_update(void *data)
        return WINDICATOR_ERROR_OK;
 }
 
+/*
+* @brief: Callback function, called when volume status changes
+* @param[in] type: sound type
+* @param[in] volume: volume level
+* @param[in] data: User data
+*/
 static void _volume_status_changed_cb(sound_type_e type, unsigned int volume, void *data)
 {
        _D("");
        windicator_volume_update(data);
 }
-
+/*
+* @brief: Unregisters the volume change callback.
+*/
 void windicator_volume_unregister()
 {
        _D("");
         sound_manager_unset_volume_changed_cb();
 }
 
+/*
+* @brief: Registers the volume change callback.
+*/
 windicator_error_e windicator_volume_register(void *data)
 {
        _D("");