* limitations under the License.
*/
+
/**
- *
* @ingroup CAPI_APPLICATION_FRAMEWORK
* @defgroup CAPI_WATCH_APP_MODULE Watch Application
- * @brief Watch application API
- *
+ * @brief Watch application API.
* @section CAPI_WATCH_APP_MODULE_HEADER Required Header
- * \#include <watch_app.h>
- * \#include <watch_app_efl.h>
+ * \#include <watch_app.h>
+ * \#include <watch_app_efl.h>
+ *
* @section CAPI_WATCH_APP_MODULE_OVERVIEW Overview
* The @ref CAPI_WATCH_APP_MODULE API provides functions for handling Tizen watch application state changes or system events. Tizen watch application can be shown in the idle screen of the wearable device.
- * This API also provides time utility functions for developting Tizen watch applications. You can develop a watch application that shows exact time using these time utility functions.
+ * This API also provides time utility functions for developing Tizen watch applications. You can develop a watch application that shows exact time using these time utility functions.
* For low powered wearable device, Tizen watch application supports a special mode that is named 'ambient'. When the device enters ambient mode, Tizen watch application that is shown in the idle screen can show limited UI and receives only ambient tick event at each minute to reduce power consumption. The limitation of UI that can be drawn in the ambient mode depends on the device. Usually, you should draw black and white UI only, and you should use below 20% of the pixels of the screen. If you don't want to draw your own ambient mode UI, you can set the 'ambient-support' attribute of the application as 'false' in the tizen-manifest.xml. Then, the platform will show proper default ambient mode UI.
- *
* This API provides interfaces for the following categories:
- * - Starting or exiting the main event loop
- * - Registering callbacks for application state change events including timetick events
- * - Registering callbacks for basic system events
- * - Time related utility APIs for watch applications
+ * - Starting or exiting the main event loop.
+ * - Registering callbacks for application state change events including timetick events.
+ * - Registering callbacks for basic system events.
+ * - Time related utility APIs for watch applications.
*
* @subsection CAPI_WATCH_APP_MODULE_STATE_CHANGE_EVENT Registering Callbacks for Application State Change Events
* The state change events for Tizen watch application is similar to the Tizen UI applications. See the @ref CAPI_APPLICATION_MODULE.
* In Tizen watch application, an ambient changed event is added to support ambient mode. Time tick related events are also added to provide an exact time tick for the watch application.
- *
* <p>
* <table>
* <tr>
* <th> Description </th>
* </tr>
* <tr>
- * <td>watch_app_create_cb()</td>
- * <td>Hook to take necessary actions before the main event loop starts.
+ * <td> watch_app_create_cb()</td>
+ * <td> Hook to take necessary actions before the main event loop starts.
* Your UI generation code should be placed here so that you do not miss any events from your application UI.
- * </td>
+ * </td>
* </tr>
* <tr>
- * <td>watch_app_control_cb()</td>
+ * <td> watch_app_control_cb() </td>
* <td> Hook to take necessary actions when your application called by another application.
* When the application gets launch request, this callback function is called.
* The application can get information about what is to be performed by using App Control API from app_control handle.
* </tr>
* <tr>
* <td> watch_app_ambient_changed_cb() </td>
- * <td> Hook to take necessary actions when the device enters ambient mode. Your application needs to adopt its UI to be compatibile with the ambient mode. Note that, you only can use very limited colors and pixels of the screen when the device is in the ambient mode. Usually, you should use only black and white to draw the ambient mode UI and use below 20% of the pixels of the screen. If you don't want to draw your own ambient mode UI, you can set the 'ambient-support' attribute of the application as 'false' in the tizen-manifest.xml. Then, the platform will show proper default ambient mode UI.
+ * <td> Hook to take necessary actions when the device enters ambient mode. Your application needs to adopt its UI to be compatibile with the ambient mode. Note that, you only can use very limited colors and pixels of the screen when the device is in the ambient mode. Usually, you should use only black and white to draw the ambient mode UI and use below 20% of the pixels of the screen. If you don't want to draw your own ambient mode UI, you can set the 'ambient-support' attribute of the application as 'false' in the tizen-manifest.xml. Then, the platform will show proper default ambient mode UI. </td>
* </tr>
* <tr>
* <td> watch_app_time_tick_cb() </td>
- * <td> This callback is called at each second when your application is visible. This callback is not called when your application is not visible or the device is in ambient mode. You can use this tick to update the time that is being displayed by your watch application.</td>
+ * <td> This callback is called at each second when your application is visible. This callback is not called when your application is not visible or the device is in ambient mode. You can use this tick to update the time that is being displayed by your watch application. </td>
* </tr>
* <tr>
* <td> watch_app_ambient_tick_cb() </td>
- * <td> This callback is called at each minute when the device is ambient mode. You can use this tick to update the time that is being displayed by your watch application while the device is in ambient mode. You should not do a job that takes long time in this callback. You should update the UI as fast as possible in this callback. The platform might make the device to sleep in short time after the ambient tick expires.</td>
+ * <td> This callback is called at each minute when the device is ambient mode. You can use this tick to update the time that is being displayed by your watch application while the device is in ambient mode. You should not do a job that takes long time in this callback. You should update the UI as fast as possible in this callback. The platform might make the device to sleep in short time after the ambient tick expires. </td>
* </tr>
* </table>
* </p>
- *
* Refer to the following state diagram to see the possible transitions and callbacks that are called while transition.
- * @image html watch_app_lifecycle.png "Watch Application States"
*
+ * @image html watch_app_lifecycle.png "Watch Application States"
* It is almost same as the Tizen UI application.
* Here are some remarks:
* - When your application is in running state, if the device enters the ambient mode, watch_app_pause_cb() will be called before the watch_app_ambient_changed_cb() is called. It is because you need to draw new UI for the ambient mode and release unnecessary resources in the ambient mode.
* - watch_app_ambient_tick() is only called while the device is in the ambient mode.
*
* @subsection CAPI_WATCH_APP_MODULE_SYSTEM_EVENT Registering Callbacks for System Events
- * Tizen watch applications can receive system events with watch_app_add_event_handler() api. The type of system events that can be received are same as Tizen UI applications. See @ref CAPI_APPLICATION_MODULE.
- *
- *
+ * Tizen watch applications can receive system events with watch_app_add_event_handler() API. The type of system events that can be received are same as Tizen UI applications. See @ref CAPI_APPLICATION_MODULE.
*/
*/
typedef struct _watch_time_s *watch_time_h;
+
/**
* @brief Called when the application starts.
- * @since_tizen 2.3.1
- *
* @details The callback function is called before the main loop of the application starts.
* In this callback, you can initialize application resources like window creation, data structure, and so on.
* After this callback function returns @c true, the main loop starts up and watch_app_control_cb() is subsequently called.
* If this callback function returns @c false, the main loop doesn't start and watch_app_terminate_cb() is subsequently called.
- *
+ * @since_tizen 2.3.1
* @param[in] width The width of the window of idle screen that will show the watch UI
* @param[in] height The height of the window of idle screen that will show the watch UI
* @param[in] user_data The user data passed from the callback registration function
*/
typedef bool (*watch_app_create_cb) (int width, int height, void *user_data);
+
/**
* @brief Called when another application sends a launch request to the application.
- * @since_tizen 2.3.1
- *
* @details When the application is launched, this callback function is called after the main loop of the application starts up.
* The passed app_control handle describes the launch request and contains the information about why the application is launched.
- * If the launch request is sent to the application in the running or pause state,
- * this callback function can be called again to notify that the application has been asked to launch.
- *
+ * If the launch request is sent to the application in the running or pause state, this callback function can be called again to notify that the application has been asked to launch.
* The application is responsible for handling each launch request and responding appropriately.
* Using the App Control API, the application can get information about what is to be performed.
* The app_control handle may include only the default operation (#APP_CONTROL_OPERATION_DEFAULT) without any data.
* For more information, see The @ref CAPI_APP_CONTROL_MODULE API description.
- *
+ * @since_tizen 2.3.1
* @param[in] app_control The handle to the app_control
* @param[in] user_data The user data passed from the callback registration function
* @see watch_app_main()
*/
typedef void (*watch_app_control_cb) (app_control_h app_control, void *user_data);
+
/**
* @brief Called when the application is completely obscured by another application and becomes invisible.
- * @since_tizen 2.3.1
- *
* @details The application is not terminated and still running in the paused state.
- *
+ * @since_tizen 2.3.1
* @param[in] user_data The user data passed from the callback registration function
* @see watch_app_main()
* @see #watch_app_lifecycle_callback_s
*/
typedef void (*watch_app_pause_cb) (void *user_data);
+
/**
* @brief Called when the application becomes visible.
* @since_tizen 2.3.1
- *
* @remarks This callback function is not called when the application moves from the created state to the running state.
- *
* @param[in] user_data The user data passed from the callback registration function
* @see watch_app_main()
* @see #watch_app_lifecycle_callback_s
*/
typedef void (*watch_app_resume_cb) (void *user_data);
+
/**
* @brief Called when the application's main loop exits.
* @details You should release the application's resources in this function.
* @since_tizen 2.3.1
- *
* @param[in] user_data The user data passed from the callback registration function
* @see watch_app_main()
* @see #watch_app_lifecycle_callback_s
*/
typedef void (*watch_app_terminate_cb) (void *user_data);
+
/**
* @brief Called with the frequency set with watch_app_set_time_tick_frequency().
* @details This callback is not called while the app is paused or the device is in ambient mode.
* @since_tizen 2.3.1
- *
* @param[in] watch_time The watch time handle. watch_time will not be available after returning this callback. It will be freed by the framework.
* @param[in] user_data The user data to be passed to the callback functions
*/
typedef void (*watch_app_time_tick_cb) (watch_time_h watch_time, void *user_data);
+
/**
- * @brief Called with the frequency set with watch_app_set_ambient_tick_type(), if the device is in the ambient mode.
+ * @brief Called with the frequency set with watch_app_set_ambient_tick_type() if the device is in the ambient mode.
* @since_tizen 2.3.1
- *
- * @remarks You should not do a job that takes long time in this callback. You should update the UI as fast as possible in this callback. The platform might make the device to sleep in short time after the ambient tick expires. Since 2.3.2, you can control when this callback is called by watch_app_set_ambient_tick_type()
- *
+ * @remarks You should not do a job that takes long time in this callback. You should update the UI as fast as possible in this callback.
+ * The platform might make the device to sleep in short time after the ambient tick expires.
+ * Since 2.3.2, you can control when this callback is called by watch_app_set_ambient_tick_type()
* @param[in] watch_time The watch time handle. watch_time will not be available after returning this callback. It will be freed by the framework.
* @param[in] user_data The user data to be passed to the callback functions
- *
* @see watch_app_set_ambient_tick_type()
*/
typedef void (*watch_app_ambient_tick_cb) (watch_time_h watch_time, void *user_data);
+
/**
* @brief Called when the device enters or exits the ambient mode.
* @since_tizen 2.3.1
- *
- * @remarks For low powered wearable device, Tizen watch application supports a special mode that is named 'ambient'. When the device enters ambient mode, Tizen watch application that is shown in the idle screen can show limited UI and receives only ambient tick event at each minute to reduce power consumption. The limitation of UI that can be drawn in the ambient mode depends on the device. Usually, you should draw black and white UI only, and you should use below 20% of the pixels of the screen. If you don't want to draw your own ambient mode UI, you can set the 'ambient-support' attribute of the application as 'false' in the tizen-manifest.xml. Then, the platform will show proper default ambient mode UI.
- *
+ * @remarks For low powered wearable device, Tizen watch application supports a special mode that is named 'ambient'.
+ * When the device enters ambient mode, Tizen watch application that is shown in the idle screen can show limited UI and receives only ambient tick event at each minute to reduce power consumption.
+ * The limitation of UI that can be drawn in the ambient mode depends on the device.
+ * Usually, you should draw black and white UI only, and you should use below 20% of the pixels of the screen.
+ * If you don't want to draw your own ambient mode UI, you can set the 'ambient-support' attribute of the application as 'false' in the tizen-manifest.xml. Then, the platform will show proper default ambient mode UI.
* @param[in] ambient_mode If @c true the device enters the ambient mode,
- * otherwise @c false
+ * otherwise @c false
* @param[in] user_data The user data to be passed to the callback functions
*/
typedef void (*watch_app_ambient_changed_cb) (bool ambient_mode, void *user_data);
/**
- * @brief The structure type containing the set of callback functions for handling application events.
+ * @brief The structure type containing the set of callback functions for application events handle.
* @details It is one of the input parameters of the watch_app_main() function.
* @since_tizen 2.3.1
- *
* @see watch_app_main()
* @see watch_app_create_cb()
* @see watch_app_control_cb()
/**
* @brief Adds the system event handler
* @since_tizen 2.3.1
- *
* @param[out] handler The event handler
* @param[in] event_type The system event type
* @param[in] callback The callback function
* @param[in] user_data The user data to be passed to the callback function
- *
- * @return 0 on success, otherwise a negative error value
- * @retval #APP_ERROR_NONE Successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ * @retval #APP_ERROR_NONE Successfull
* @retval #APP_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #APP_ERROR_OUT_OF_MEMORY Out of memory
- *
* @see app_event_type_e
* @see app_event_cb
* @see watch_app_remove_event_handler
/**
* @brief Removes registered event handler
* @since_tizen 2.3.1
- *
* @param[in] event_handler The event handler
- *
- * @return 0 on success, otherwise a negative error value
- * @retval #APP_ERROR_NONE Successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ * @retval #APP_ERROR_NONE Successfull
* @retval #APP_ERROR_INVALID_PARAMETER Invalid parameter
- *
* @see watch_app_add_event_handler
*/
int watch_app_remove_event_handler(app_event_handler_h event_handler);
/**
* @brief Runs the main loop of the application until watch_app_exit() is called.
* @since_tizen 2.3.1
- *
* @remarks http://tizen.org/privilege/alarm.set privilege is needed to receive ambient ticks at each minute. The watch_app_ambient_tick_cb() will be ignored if your app doesn't have the privilege.
- *
* @param[in] argc The argument count
* @param[in] argv The argument vector
* @param[in] callback The set of callback functions to handle application events
* @param[in] user_data The user data to be passed to the callback functions
- *
* @return @c 0 on success,
* otherwise a negative error value.
* @retval #APP_ERROR_NONE Successful
* @retval #APP_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #APP_ERROR_INVALID_CONTEXT The application is illegally launched, not launched by the launch system.
* @retval #APP_ERROR_ALREADY_RUNNING The main loop has already started
- *
* @see watch_app_main()
* @see watch_app_create_cb()
* @see watch_app_control_cb()
* @brief Exits the main loop of the application.
* @details The main loop of the application stops and watch_app_terminate_cb() is invoked.
* @since_tizen 2.3.1
- *
* @see watch_app_main()
* @see watch_app_terminate_cb()
*/
* @brief Enumeration for tick resolution type.
* @details It is one of the input parameters of the watch_app_set_time_tick_frequency() and watch_app_get_time_tick_frequency() functions.
* @since_tizen 3.0
- *
* @see watch_app_set_time_tick_frequency()
* @see watch_app_get_time_tick_frequency()
*/
* @brief Sets the frequency of watch_app_time_tick_cb() calls.
* @details If watch_app_set_time_tick_frequency() is not called, watch_app_time_tick_cb() will be called every second.
* @since_tizen 3.0
- *
* @param[in] ticks The number of ticks per given resolution type
* @param[in] type The resolution type
- *
- * @return 0 on success, otherwise a negative error value
+ * @return 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
- *
* @see watch_app_time_tick_resolution_e
* @see watch_app_get_time_tick_frequency()
*/
/**
* @brief Gets the frequency of watch_app_time_tick_cb() calls.
* @since_tizen 3.0
- *
* @param[out] ticks The number of ticks per given resolution type
* @param[out] type The resolution type
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
- *
* @see watch_app_time_tick_resolution_e
* @see watch_app_set_time_tick_frequency()
*/
/**
* @brief Sets the type of periodic ambient tick.
* @since_tizen 2.3.2
- *
* @remarks If you do not set specific tick type with this function, the watch_app_ambient_tick_cb() will be called every minute by default.
- *
* @param[in] type The type of periodic ambient tick
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
- *
* @see watch_app_ambient_tick_cb()
*/
int watch_app_set_ambient_tick_type(watch_app_ambient_tick_type_e type);
/**
* @brief Gets the type of periodic ambient tick.
* @since_tizen 2.3.2
- *
- * @remarks If you do not set specific tick type with watch_app_set_ambient_tick_type(), this function will set @a type to #WATCH_APP_AMBIENT_TICK_EVERY_MINUTE.
- *
- * @param[out] type The type of periodic ambient tick
- *
- * @return 0 on success, otherwise a negative error value
+ * @remarks If you do not set specific tick type with watch_app_set_ambient_tick_type(), this function will set @a type to #WATCH_APP_AMBIENT_TICK_EVERY_MINUTE. * @param[out] type The type of periodic ambient tick
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
- *
* @see watch_app_ambient_tick_cb()
* @see watch_app_set_ambient_tick_type()
*/
/**
* @brief Gets the current time.
* @since_tizen 2.3.1
- *
* @remarks You must release @a watch_time using watch_time_delete() after using it.
- *
* @param[out] watch_time The watch_time handle to be newly created on successl
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_OUT_OF_MEMORY Out of Memory
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_get_current_time(watch_time_h *watch_time);
+
/**
* @brief Deletes the watch time handle and releases all its resources.
* @since_tizen 2.3.1
- *
* @param[in] watch_time The watch_time handle
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_delete(watch_time_h watch_time);
+
/**
* @brief Gets the year info.
* @since_tizen 2.3.1
- *
* @param[in] watch_time The watch_time handle
* @param[out] year The year info
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_get_year(watch_time_h watch_time, int *year);
+
/**
* @brief Gets the month info.
* @since_tizen 2.3.1
- *
* @param[in] watch_time The watch_time handle
* @param[out] month The month info
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_get_month(watch_time_h watch_time, int *month);
+
/**
* @brief Gets the day info.
* @since_tizen 2.3.1
- *
* @param[in] watch_time The watch_time handle
* @param[out] day The day info
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_get_day(watch_time_h watch_time, int *day);
+
/**
* @brief Gets the day of week info.
* @since_tizen 2.3.1
- *
* @param[in] watch_time The watch_time handle
* @param[out] day_of_week The day of week info. The value returns from 1 (Sunday) to 7 (Saturday).
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_get_day_of_week(watch_time_h watch_time, int *day_of_week);
+
/**
* @brief Gets the hour info.
* @since_tizen 2.3.1
- *
* @param[in] watch_time The watch_time handle
* @param[out] hour The hour info
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_get_hour(watch_time_h watch_time, int *hour);
+
/**
* @brief Gets the hour info in 24-hour presentation.
* @since_tizen 2.3.1
- *
* @param[in] watch_time The watch_time handle
* @param[out] hour24 The hour info
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_get_hour24(watch_time_h watch_time, int *hour24);
+
/**
* @brief Gets the minute info.
* @since_tizen 2.3.1
- *
* @param[in] watch_time The watch_time handle
* @param[out] minute The minute info
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_get_minute(watch_time_h watch_time, int *minute);
+
/**
* @brief Gets the second info.
* @since_tizen 2.3.1
- *
* @param[in] watch_time The watch_time handle
* @param[out] second The second info
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_get_second(watch_time_h watch_time, int *second);
+
/**
* @brief Gets the millisecond info.
* @since_tizen 2.3.1
- *
* @param[in] watch_time The watch_time handle
* @param[out] millisecond The millisecond info
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_get_millisecond(watch_time_h watch_time, int *millisecond);
+
/**
* @brief Gets the UTC time.
* @since_tizen 2.3.1
- *
* @param[in] watch_time The watch_time handle
* @param[out] utc_time The UTC time
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_get_utc_time(watch_time_h watch_time, struct tm *utc_time);
+
/**
* @brief Gets the UTC timestamp.
* @since_tizen 2.3.1
- *
* @param[in] watch_time The watch_time handle
* @param[out] utc_timestamp The UTC timestamp
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_get_utc_timestamp(watch_time_h watch_time, time_t *utc_timestamp);
+
/**
* @brief Gets the ID of timezone for the @a watch_time handle.
* @since_tizen 2.3.1
- *
* @remarks You must release @a time_zone_id using free() after using it.
- *
* @param[in] watch_time The watch_time handle
* @param[out] time_zone_id The Timezone ID, such as "America/Los_Angeles"
- *
- * @return 0 on success, otherwise a negative error value
+ * @return @c 0 on success,
+ * otherwise a negative error value
* @retval #APP_ERROR_INVALID_PARAMETER Invalid Parameter
* @retval #APP_ERROR_NONE Successful
*/
int watch_time_get_time_zone(watch_time_h watch_time, char **time_zone_id);
+
/**
* @}
*/
projects / platform / core / appfw / appcore-watch.git / commitdiff