Modify 'since tag' for wearable profile
authorKyuho Jo <kyuho.jo@samsung.com>
Mon, 23 Mar 2015 03:55:22 +0000 (12:55 +0900)
committerKyuho Jo <kyuho.jo@samsung.com>
Mon, 23 Mar 2015 03:55:22 +0000 (12:55 +0900)
Change-Id: Iae940aee7a8cb15db59180f51ddc935f315b6b27
Signed-off-by: Kyuho Jo <kyuho.jo@samsung.com>
doc/mobile/notification_doc.h [moved from doc/notification_doc.h with 100% similarity]
doc/wearable/notification_doc.h [new file with mode: 0755]
include/notification.h
include/notification_error.h
include/notification_internal.h
include/notification_list.h
include/notification_status.h
include/notification_type.h

diff --git a/doc/wearable/notification_doc.h b/doc/wearable/notification_doc.h
new file mode 100755 (executable)
index 0000000..2dac2af
--- /dev/null
@@ -0,0 +1,61 @@
+/*
+ *  libnotification
+ *
+ * Copyright (c) 2000 - 2011 Samsung Electronics Co., Ltd. All rights reserved.
+ *
+ * Contact: Seungtaek Chung <seungtaek.chung@samsung.com>, Mi-Ju Lee <miju52.lee@samsung.com>, Xi Zhichan <zhichan.xi@samsung.com>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+/**
+ *
+ * @defgroup NOTIFICATION_MODULE Notification
+ * @ingroup CAPI_APPLICATION_FRAMEWORK
+ * @brief Notification APIs
+ *
+ * @section NOTIFICATION_MODULE_HEADER Required Header
+ *   \#include <notification.h>
+ * @section NOTIFICATION_MODULE_OVERVIEW Overview
+ * A notification is a message that is displayed on the notification area or the on-going area.
+ * It is created to notify information to the user through the application.
+ * This API provides functions for creating and inserting and updating notification.
+ *
+ */
+/** 
+ * @internal
+ * @defgroup NOTIFICATION_LIST Notification List
+ * @ingroup NOTIFICATION_MODULE
+ * @brief linked list of notification data
+ *
+ * @section NOTIFICATION_LIST_MODULE_HEADER Required Header
+ *   \#include <notification.h>
+ * @section NOTIFICATION_LIST_MODULE_OVERVIEW Overview
+ * It provides functions for handling notification list.
+ *
+ */
+  
+/** 
+ * @defgroup NOTIFICATION_STATUS Notification Status
+ * @ingroup NOTIFICATION_MODULE
+ * @brief APIs displaying plain text message on the indicator area
+ *
+ * @section NOTIFICATION_STATUS_MODULE_HEADER Required Header
+ *   \#include <notification.h>
+ * @section NOTIFICATION_STATUS_MODULE_OVERVIEW Overview
+ * Notification status APIs
+ *
+ */
index 97627e0..a22b6e6 100755 (executable)
@@ -46,7 +46,7 @@ extern "C" {
 
 /**
  * @brief Sets an absolute path for an image file to display on the notification view.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti       The notification handle
  * @param[in] type       The notification image type
  * @param[in] image_path The image file full path
@@ -84,7 +84,7 @@ int notification_set_image(notification_h noti,
 
 /**
  * @brief Gets the absolute path of an image file.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @remarks Do not free @a image_path. It will be freed when notification_free() is called.
  * @param[in] noti Notification handle
  * @param[in] type Notification image type
@@ -117,7 +117,7 @@ int notification_get_image(notification_h noti,
 /**
  * @brief Sets a timestamp.
  * @details If input_time is @c 0, time information is taken from the current time.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti       The notification handle
  * @param[in] input_time The input time
  * @return #NOTIFICATION_ERROR_NONE on success,
@@ -153,7 +153,7 @@ int notification_set_time(notification_h noti,
 /**
  * @brief Gets a timestamp.
  * @details If ret_time is @c 0, time information is not set before.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in]  noti     The notification handle
  * @param[out] ret_time The return time value
  * @return #NOTIFICATION_ERROR_NONE on success,
@@ -183,7 +183,7 @@ int notification_get_time(notification_h noti,
 /**
  * @brief Gets an insertion timestamp of the notification.
  * @details If ret_time is @c 0, this notification data is not inserted before.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in]  noti      The notification handle
  * @param[out] ret_time  The return time value
  * @return #NOTIFICATION_ERROR_NONE on success,
@@ -219,7 +219,7 @@ int notification_get_insert_time(notification_h noti,
  * If the value is #NOTIFICATION_COUNT_POS_IN, count is displayed in the text when text has %d format.
  * If the value is #NOTIFICATION_COUNT_POS_RIGHT, count is displayed at the right of the text.
  * Variable parameters should be terminated #NOTIFICATION_VARIABLE_TYPE_NONE.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti      The notification handle
  * @param[in] type      The notification text type
  * @param[in] text      The basic text
@@ -259,7 +259,7 @@ int notification_set_text(notification_h noti,
 
 /**
  * @brief Gets the text from the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in]  noti The notification handle
  * @param[in]  type The notification text type
  * @param[out] text The notification text
@@ -290,7 +290,7 @@ int notification_get_text(notification_h noti,
 /**
  * @brief Sets the timestamp to display on the notification view.
  * @details The timestamp will be converted to a formatted string and it will be displayed on the set text area.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti The notification handle
  * @param[in] type The notification text type
  * @param[in] time The timestamp
@@ -305,7 +305,7 @@ int notification_set_time_to_text(notification_h noti, notification_text_type_e
 
 /**
  * @brief Gets the timestamp from the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti The notification handle
  * @param[in] type The notification text type
  * @param[in] time The pointer of time stamp
@@ -321,7 +321,7 @@ int notification_get_time_from_text(notification_h noti, notification_text_type_
 /**
  * @internal
  * @brief Sets the text domain to localize the notification.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti   The notification handle
  * @param[in] domain The text domain
  * @param[in] dir    The text dir
@@ -357,7 +357,7 @@ int notification_set_text_domain(notification_h noti,
 /**
  * @internal
  * @brief Gets the text domain from the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @remarks Do not free returned domain and dir. They are freed when notification_free() or notification_free_list() is called.
  * @param[in]  noti   The notification handle
  * @param[out] domain The domain
@@ -389,7 +389,7 @@ int notification_get_text_domain(notification_h noti,
 
 /**
  * @brief Sets the sound type for the notification.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti The notification handle
  * @param[in] type The notification sound type
  * @param[in] path The user sound file path
@@ -418,7 +418,7 @@ int notification_set_sound(notification_h noti,
 
 /**
  * @brief Gets the sound type from the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in]  noti  The notification handle
  * @param[out] type  The notification sound type
  * @param[out] path  The user sound file path
@@ -448,7 +448,7 @@ int notification_get_sound(notification_h noti,
 
 /**
  * @brief Sets the vibration type for the notification.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti The notification handle
  * @param[in] type The notification vibration type
  * @param[in] path The user vibration file path
@@ -477,7 +477,7 @@ int notification_set_vibration(notification_h noti,
 
 /**
  * @brief Gets the vibrate type from the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in]  noti The notification handle
  * @param[out] type The notification sound type
  * @param[out] path The user vibration file path
@@ -507,7 +507,7 @@ int notification_get_vibration(notification_h noti,
 
 /**
  * @brief Sets the LED displaying option.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti      The notification handle
  * @param[in] operation The LED notification operation
  * @param[in] led_argb  The notification led color
@@ -536,7 +536,7 @@ int notification_set_led(notification_h noti,
 
 /**
  * @brief Gets the LED displaying option from the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in]  noti      The notification handle
  * @param[out] operation The LED notification operation
  * @param[out] led_argb  The notification LED color
@@ -566,7 +566,7 @@ int notification_get_led(notification_h noti,
 
 /**
  * @brief Sets the time period of flashing the LED.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti   The notification handle
  * @param[in] on_ms  The time for turning on the LED
  * @param[in] off_ms The time for turning off the LED
@@ -594,7 +594,7 @@ int notification_set_led_time_period(notification_h noti,
 
 /**
  * @brief Gets the time period of flashing the LED from the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in]  noti   The notification handle
  * @param[out] on_ms  The time for turning on the LED
  * @param[out] off_ms The time for turning on the LED
@@ -625,7 +625,7 @@ int notification_get_led_time_period(notification_h noti,
 /**
  * @brief Sets the launch option for a notification.
  * @details When notification data selected in display application, application launched by app_control_send_launch_request with app_control handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti The notification handle
  * @param[in] type Launching option type
  * @param[in] option App Control handler
@@ -664,7 +664,7 @@ int notification_set_launch_option(notification_h noti,
 
 /**
  * @brief Gets the launch option from the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @remarks You must release @a app_control using app_control_destroy().
  * @param[in]  noti        The notification handle
  * @param[in] type Launching option type
@@ -696,7 +696,7 @@ int notification_get_launch_option(notification_h noti,
 
 /**
  * @brief Sets the property of the notification.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti  The notification handle
  * @param[in] flags The property with | operation
  * @return #NOTIFICATION_ERROR_NONE on success,
@@ -730,7 +730,7 @@ int notification_set_property(notification_h noti,
 
 /**
  * @brief Gets the property of the notification from the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in]  noti  The notification handle
  * @param[out] flags The notification property
  * @return #NOTIFICATION_ERROR_NONE on success,
@@ -759,7 +759,7 @@ int notification_get_property(notification_h noti,
 /**
  * @brief Sets applications to display the notification.
  * @details All display application is enable(NOTIFICATION_DISPLAY_APP_ALL) if you are not call this API.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti    The notification handle
  * @param[in] applist The with | operation
  * @return #NOTIFICATION_ERROR_NONE on success,
@@ -794,7 +794,7 @@ int notification_set_display_applist(notification_h noti,
 
 /**
  * @brief Gets the application list displaying the notification from the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in]  noti    The notification handle
  * @param[out] applist The display application list
  * @return #NOTIFICATION_ERROR_NONE on success,
@@ -823,7 +823,7 @@ int notification_get_display_applist(notification_h noti,
 /**
  * @brief Sets the initial size for the ongoing type.
  * @details After notification_post() call, the size is not updated.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti The notification handle
  * @param[in] size The double type size
  * @return #NOTIFICATION_ERROR_NONE on success,
@@ -856,7 +856,7 @@ int notification_set_size(notification_h noti,
 
 /**
  * @brief Gets the progress size.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in]  noti The notification handle
  * @param[out] size The progress size
  * @return #NOTIFICATION_ERROR_NONE on success,
@@ -885,7 +885,7 @@ int notification_get_size(notification_h noti,
 /**
  * @brief Sets the initial progress for the ongoing type.
  * @details After the notification_post() call, the progress is not updated.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti       The notification handle
  * @param[in] percentage The progress percentage
  * @return #NOTIFICATION_ERROR_NONE on success,
@@ -918,7 +918,7 @@ int notification_set_progress(notification_h noti,
 
 /**
  * @brief Gets the progress from the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @remarks At the end of the operation, the progress should be @c 1.0.
  * @param[in]  noti       The notification handle
  * @param[out] percentage The progress percentage
@@ -948,7 +948,7 @@ int notification_get_progress(notification_h noti,
 /**
  * @brief Sets the layout of the notification view.
  * @details Caller can set displaying layout of notification.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti The notification handle
  * @param[in] layout The type of layout
  * @return #NOTIFICATION_ERROR_NONE on success,
@@ -962,7 +962,7 @@ int notification_set_layout(notification_h noti,
 
 /**
  * @brief Gets the layout of the notification view from the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in]  noti The notification handle
  * @param[out] layout The type of layout
  * @return #NOTIFICATION_ERROR_NONE on success,
@@ -976,7 +976,7 @@ int notification_get_layout(notification_h noti,
 
 /**
  * @brief Gets the type of a notification.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in]  noti The notification handle
  * @param[out] type The notification type
  * @return #NOTIFICATION_ERROR_NONE on success,
@@ -1006,7 +1006,7 @@ int notification_get_type(notification_h noti,
  * @brief Inserts a notification.
  * @details The notification will be inserted to the database and then it will appear in the notification area.
  *          When notification_create() is called, if priv_id is #NOTIFICATION_PRIV_ID_NONE, priv_id returns the internally set priv_id.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/notification
  * @param[in]  noti    The notification handle
@@ -1038,7 +1038,7 @@ int notification_insert(notification_h noti,
 /**
  * @brief Updates notification data.
  * @details The updated notification will appear in the notification area.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/notification
  * @param[in] noti The notification handle that is created by notification_create()
@@ -1068,7 +1068,7 @@ int notification_update(notification_h noti);
  * @internal
  * @brief Updates a notification, asynchronously.
  * @details The updated notification will appear in the notification area.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/notification
  * @remarks This function updates the notification asynchronously.
@@ -1101,7 +1101,7 @@ int notification_update_async(notification_h noti,
 /**
  * @brief Deletes a notification with the given handle.
  * @details notification_delete() removes notification data from database and notification_free() releases memory of notification data.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/notification
  * @param[in] noti The notification handle
@@ -1135,7 +1135,7 @@ int notification_delete(notification_h noti);
  * @details Available type is #NOTIFICATION_TYPE_NOTI and #NOTIFICATION_TYPE_ONGOING.
  * #NOTIFICATION_TYPE_NOTI is remaining notification data even if device is restarted.
  * #NOTIFICATION_TYPE_ONGOING can display progressive feather, but notification data is removed after device is restarted.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
  * @param[in] type The notification type
  * @return Notification handle(notification_h) on success,
@@ -1166,7 +1166,7 @@ notification_h notification_create(notification_type_e type);
 /**
  * @brief Creates a notification clone.
  * @details Newly created notification handle is returned.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @remarks This cloned notification handle should be freed using notification_free().
  * @param[in]  noti  The notification handle
  * @param[out] clone The newly created notification handle that has same with input @a noti
@@ -1193,7 +1193,7 @@ int notification_clone(notification_h noti, notification_h *clone);
 /**
  * @brief Frees the internal structure data of a notification handle.
  * @details Internal data of a notification handle is released. Data of the inserted notification is not deleted.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti The notification handle
  * @return #NOTIFICATION_ERROR_NONE on success,
  *         otherwise any other value on failure
@@ -1237,7 +1237,7 @@ int notification_free(notification_h noti);
  * @internal
  * @brief Returns the notification list handle.
  * @details If count is equal to @c -1, all notifications are returned.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/notification
  * @param[in]  type  The notification type
@@ -1272,7 +1272,7 @@ int notification_get_list(notification_type_e type,
  * @internal
  * @brief Returns the notification detail list handle of grouping data.
  * @details If count is equal to c -1, all notifications are returned.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/notification
  * @param[in]  pkgname  The caller application package name
@@ -1310,7 +1310,7 @@ int notification_get_detail_list(const char *pkgname,
 /**
  * @internal
  * @brief Frees a notification list.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/notification
  * @param[in] list The notification list handle
@@ -1353,7 +1353,7 @@ int notification_free_list(notification_list_h list);
  * @internal
  * @brief Registers a callback for all notification events.
  * @details The registered callback could be called for all notification events.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/notification
  * @param[in] changed_cb The callback function
@@ -1383,7 +1383,7 @@ int notification_register_detailed_changed_cb(
 /**
  * @internal
  * @brief Unregisters a callback for all notification events.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/notification
  * @param[in] changed_cb The callback function
@@ -1411,7 +1411,7 @@ int notification_unregister_detailed_changed_cb(
 
 /**
  * @brief Sets the tag of the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti Notification handle
  * @param[in] tag tag for loading notification handle
  * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
@@ -1444,7 +1444,7 @@ int notification_set_tag(notification_h noti, const char *tag);
 
 /**
  * @brief Gets the tag of the notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] noti Notification handle
  * @param[out] tag tag for loading notification handle
  * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
@@ -1473,7 +1473,7 @@ int notification_get_tag(notification_h noti, const char **tag);
 
 /**
  * @brief Loads a notification from the notification's database with the tag.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/notification
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
@@ -1505,7 +1505,7 @@ notification_h notification_load_by_tag(const char *tag);
 
 /**
  * @brief Deletes all notifications of the given type.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/notification
  * @param[in] type Notification type
@@ -1531,7 +1531,7 @@ int notification_delete_all(notification_type_e type);
 
 /**
  * @brief Posts a notification.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/notification
  * @param[in] noti Notification handle
index 1179838..0616cc8 100755 (executable)
@@ -35,7 +35,7 @@
 
 /**
  * @brief Enumeration for notification errors.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notification_error {
        NOTIFICATION_ERROR_NONE = TIZEN_ERROR_NONE,     /**< Success */
index 77030c5..341e763 100755 (executable)
@@ -607,7 +607,7 @@ NOTIFICATION_DEPRECATED_API int notification_get_execute_option(notification_h n
 /**
  * @internal
  * @brief This function sets notification property for designated package.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege http://tizen.org/privilege/core/notification
  * @param[in] pkgname The name of designated package
@@ -621,7 +621,7 @@ int notification_setting_property_set(const char *pkgname, const char *property,
 /**
  * @internal
  * @brief This function gets notification property for designated package.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege http://tizen.org/privilege/core/notification
  * @param[in] pkgname The name of designated package
index 2985af8..e174d6a 100755 (executable)
@@ -41,14 +41,14 @@ extern "C" {
 
 /**
  * @brief Notification list handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef struct _notification_list *notification_list_h;
 
 /**
  * @internal
  * @brief Gets the head pointer of the notification list.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
  * @param[in] list Notification list handle
  * @return Notification list handle on success, NULL on failure
@@ -79,7 +79,7 @@ notification_list_h notification_list_get_head(notification_list_h list);
 /**
  * @internal
  * @brief Gets the tail pointer to the notification list.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
  * @param[in] list Notification list handle
  * @return Notification list handle on success, NULL on failure
@@ -110,7 +110,7 @@ notification_list_h notification_list_get_tail(notification_list_h list);
 /**
  * @internal
  * @brief Gets the previous pointer of the current notification list.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
  * @param[in] list Notification list handle
  * @return Notification list handle on success, NULL on failure
@@ -141,7 +141,7 @@ notification_list_h notification_list_get_prev(notification_list_h list);
 /**
  * @internal
  * @brief Gets the next pointer of the current notification list.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
  * @param[in] list Notification list handle
  * @return Notification list handle on success, NULL on failure
@@ -172,7 +172,7 @@ notification_list_h notification_list_get_next(notification_list_h list);
 /**
  * @internal
  * @brief Gets the notification handle that the list has.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
  * @param[in] list Notification list handle
  * @return Notification handle on success, NULL on failure
@@ -205,7 +205,7 @@ notification_h notification_list_get_data(notification_list_h list);
 /**
  * @internal
  * @brief Appends notification data to the notification list.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
  * @param[in] list Notification list handle
  * @param[in] noti Notification handle
@@ -241,7 +241,7 @@ notification_list_h notification_list_append(notification_list_h list,
 /**
  * @internal
  * @brief Removes notification data from the notification list.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
  * @param[in] list The notification list handle
  * @param[in] noti The notification handle
index 2d1a8a4..35b8e5b 100755 (executable)
@@ -38,7 +38,7 @@ extern "C" {
 /**
  * @internal
  * @brief Called when a new message is posted.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] message The message posted
  * @param[in] data    The user data
  * @pre notification_status_monitor_message_cb_set() used to register this callback.
@@ -49,7 +49,7 @@ typedef void (*notification_status_message_cb)(const char *message, void *data);
 /**
  * @internal
  * @brief Registers a callback to receive a message.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] callback The callback function
  * @param[in] data     The user_data
  * @return #NOTIFICATION_ERROR_NONE if success, other value if failure
@@ -62,7 +62,7 @@ int notification_status_monitor_message_cb_set(notification_status_message_cb ca
 /**
  * @internal
  * @brief Unregisters a callback to receive a message.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @param[in] callback The callback function
  * @param[in] data     The user_data
  * @return #NOTIFICATION_ERROR_NONE if success, other value if failure
@@ -72,7 +72,7 @@ int notification_status_monitor_message_cb_unset(void);
 
 /**
  * @brief Sends a string (message) to the notification status monitor.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/notification
  * @param[in] message The messages to be posted
index 1fcd343..9e3cba5 100755 (executable)
@@ -46,7 +46,7 @@ extern "C" {
 
 /**
  * @brief Enumeration for notification layout type.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notification_ly_type {
        NOTIFICATION_LY_NONE = 0,
@@ -67,7 +67,7 @@ typedef enum _notification_ly_type {
 
 /**
  * @brief Enumeration for notification lauch option type.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum  _notification_launch_option_type {
        NOTIFICATION_LAUNCH_OPTION_APP_CONTROL = 1,
@@ -76,7 +76,7 @@ typedef enum  _notification_launch_option_type {
 
 /**
  * @brief Enumeration for notification sound type.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notification_sound_type {
        NOTIFICATION_SOUND_TYPE_NONE = -1,
@@ -91,7 +91,7 @@ typedef enum _notification_sound_type {
 
 /**
  * @brief Enumeration for notification vibration type.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notification_vibration_type {
        NOTIFICATION_VIBRATION_TYPE_NONE = -1,
@@ -104,7 +104,7 @@ typedef enum _notification_vibration_type {
 
 /**
  * @brief Enumeration for notification LED operation.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notification_led_op {
        NOTIFICATION_LED_OP_OFF = -1,
@@ -117,7 +117,7 @@ typedef enum _notification_led_op {
 
 /**
  * @brief This will be deprecated.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notification_count_display_type {
        NOTIFICATION_COUNT_DISPLAY_TYPE_NONE = -1,      /**< None */
@@ -129,7 +129,7 @@ typedef enum _notification_count_display_type {
 
 /**
  * @brief Enumeration for notification text type.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notification_text_type {
        NOTIFICATION_TEXT_TYPE_NONE = -1,
@@ -166,7 +166,7 @@ typedef enum _notification_text_type {
 
 /**
  * @brief Enumeration for image type.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notification_image_type {
        NOTIFICATION_IMAGE_TYPE_NONE = -1,
@@ -209,7 +209,7 @@ typedef enum _notification_image_type {
 
 /**
  * @brief Enumeration for application execution type.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notification_execute_type {
        NOTIFICATION_EXECUTE_TYPE_NONE = -1,
@@ -225,7 +225,7 @@ typedef enum _notification_execute_type {
 
 /**
  * @brief Enumeration for notification type.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notification_type {
        NOTIFICATION_TYPE_NONE = -1,
@@ -240,7 +240,7 @@ typedef enum _notification_type {
 
 /**
  * @brief Enumeration for Group ID.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 enum _notification_group_id {
        NOTIFICATION_GROUP_ID_NONE = -1,/**< Not Grouping */
@@ -250,7 +250,7 @@ enum _notification_group_id {
 
 /**
  * @brief Enumeration for Private ID.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 enum _notification_priv_id {
        NOTIFICATION_PRIV_ID_NONE = -1,
@@ -259,7 +259,7 @@ enum _notification_priv_id {
 
 /**
  * @brief Enumeration for notification property.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 enum _notification_property {
        NOTIFICATION_PROP_DISPLAY_ONLY_SIMMODE = 0x00000001,
@@ -281,7 +281,7 @@ enum _notification_property {
 
 /**
  * @brief Enumeration for display application list.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 enum _notificaton_display_applist {
        NOTIFICATION_DISPLAY_APP_NOTIFICATION_TRAY = 0x00000001,/**< Notification Tray(Quickpanel) */
@@ -296,7 +296,7 @@ enum _notificaton_display_applist {
 
 /**
  * @brief Enumeration for notification operation code.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notification_op_type {
        NOTIFICATION_OP_NONE = 0,       /**< Default */
@@ -310,7 +310,7 @@ typedef enum _notification_op_type {
 
 /**
  * @brief Enumeration for notification operation data code
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notification_op_data_type {
        NOTIFICATION_OP_DATA_MIN = 0,   /**< Default */
@@ -324,7 +324,7 @@ typedef enum _notification_op_data_type {
 
 /**
  * @brief Enumeration for notification count position in the text.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notifcation_count_pos_type {
        NOTIFICATION_COUNT_POS_NONE = -1,
@@ -340,7 +340,7 @@ typedef enum _notifcation_count_pos_type {
 
 /**
  * @brief Enumeration for notification variable parameter type.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef enum _notification_variable_type {
        NOTIFICATION_VARIABLE_TYPE_NONE = -1,
@@ -359,13 +359,13 @@ typedef enum _notification_variable_type {
 
 /**
  * @brief Notification handle.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef struct _notification *notification_h;
 
 /**
  * @brief The structure for notification operation.
- * @since_tizen 2.3
+ * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
  */
 typedef struct _notification_op {
        notification_op_type_e type;    /**< Notification operation type */