Move internal API set to internal header file.

Change-Id: Id94c88aedec1f7add24363d8cffc26fc72d39936
Signed-off-by: Kyuho Jo <kyuho.jo@samsung.com>

1 files changed, 31 insertions, 158 deletions

diff --git a/include/notification.h b/include/notification.h
index 02a4fb0..db5897a 100644
--- a/include/notification.h
+++ b/include/notification.h
@@ -1007,41 +1007,6 @@ int notification_get_layout(notification_h noti,
  */
 int notification_get_type(notification_h noti,
 					   notification_type_e * type);
-
-/**
- * @internal
- * @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
- * @privlevel public
- * @privilege %http://tizen.org/privilege/notification
- * @param[in]  noti    The notification handle
- * @param[out] priv_id The private ID
- * @return #NOTIFICATION_ERROR_NONE on success,
- *         otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE         Success
- * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @pre Notification handle should be created by notification_create().
- * @post notification_free().
- * @par Sample code:
- * @code
-#include <notification.h>
-...
- {
-	int noti_err = NOTIFICATION_ERROR_NONE;
-
-	noti_err  = notification_insert(noti, NULL);
-	if(noti_err != NOTIFICATION_ERROR_NONE) {
-		return;
-	}
-}
- * @endcode
- */
-int notification_insert(notification_h noti,
-					 int *priv_id);
-
 /**
  * @brief Updates notification data.
  * @details The updated notification will appear in the notification area.
@@ -1072,40 +1037,6 @@ int notification_insert(notification_h noti,
 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
- * @privlevel public
- * @privilege %http://tizen.org/privilege/notification
- * @remarks This function updates the notification asynchronously.
- * @param[in] noti      The notification handle that is created by notification_create()
- * @param[in] result_cb The callback called when an update completed
- * @param[in] user_data The user data which you want to use in callback
- * @return #NOTIFICATION_ERROR_NONE on success,
- *         otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE         Success
- * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
- * @retval #NOTIFICATION_ERROR_NOT_EXIST_ID Priv ID does not exist
- * @retval #NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @par Sample code:
- * @code
-#include <notification.h>
-...
- {
-	int noti_err = NOTIFICATION_ERROR_NONE;
-
-	noti_err  = notification_update_async(NULL, result_cb, data);
-	if(noti_err != NOTIFICATION_ERROR_NONE) {
-		return;
-	}
-}
- * @endcode
- */
-int notification_update_async(notification_h noti,
-		void (*result_cb)(int priv_id, int result, void *data), void *user_data);
-
-/**
  * @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
@@ -1240,66 +1171,6 @@ int notification_free(notification_h noti);
  */
 
 /**
- * @internal
- * @brief Registers a callback for all notification events.
- * @details The registered callback could be called for all notification events.
- * @since_tizen 2.3
- * @privlevel public
- * @privilege %http://tizen.org/privilege/notification
- * @param[in] changed_cb The callback function
- * @param[in] user_data  The user data
- * @return #NOTIFICATION_ERROR_NONE on success,
- *         otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE         Success
- * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @see notification_unregister_detailed_changed_cb()
- * @par Sample code:
- * @code
-#include <notification.h>
-...
-{
-	noti_err = notification_register_detailed_changed_cb(app_changed_cb, user_data);
-	if(noti_err != NOTIFICATION_ERROR_NONE) {
-		return;
-	}
-}
- * @endcode
- */
-int notification_register_detailed_changed_cb(
-		void (*detailed_changed_cb)(void *data, notification_type_e type, notification_op *op_list, int num_op),
-		void *user_data);
-
-/**
- * @internal
- * @brief Unregisters a callback for all notification events.
- * @since_tizen 2.3
- * @privlevel public
- * @privilege %http://tizen.org/privilege/notification
- * @param[in] changed_cb The callback function
- * @return #NOTIFICATION_ERROR_NONE on success,
- *         otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE         Success
- * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @see notification_register_detailed_changed_cb()
- * @par Sample code:
- * @code
-#include <notification.h>
-...
-{
-	noti_err = notification_register_detailed_changed_cb(app_changed_cb, user_data);
-	if(noti_err != NOTIFICATION_ERROR_NONE) {
-		return;
-	}
-}
- * @endcode
- */
-int notification_unregister_detailed_changed_cb(
-		void (*detailed_changed_cb)(void *data, notification_type_e type, notification_op *op_list, int num_op),
-		void *user_data);
-
-/**
  * @brief Sets the tag of the notification handle.
  * @since_tizen 2.3
  * @param[in] noti Notification handle
@@ -1362,35 +1233,6 @@ int notification_set_tag(notification_h noti, const char *tag);
 int notification_get_tag(notification_h noti, const char **tag);
 
 /**
- * @internal
- * @brief Gets the package name of the notification
- * @remarks The pkgname must be released using free()
- * @since_tizen 2.4
- * @privlevel NP
- * @param[in] noti Notification handle
- * @param[out] pkgname package name of the notification
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
- * @par Sample code:
- * @code
-#include <notification.h>
-...
-{
-	notification_h noti = NULL;
-	int noti_err = NOTIFICATION_ERROR_NONE;
-	char *pkgname = NULL;
-
-	noti_err  = notification_get_pkgname(noti, &pkgname);
-	if(noti_err != NOTIFICATION_ERROR_NONE) {
-		return;
-	}
-}
- * @endcode
- */
-int notification_get_pkgname(notification_h noti, char **pkgname);
-
-/**
  * @brief Loads a notification from the notification's database with the tag.
  * @since_tizen 2.3
  * @privlevel public
@@ -1550,6 +1392,37 @@ int notification_set_permission(notification_h handle, notification_permission_t
  */
 int notification_get_permission(notification_h handle, notification_permission_type_e *permission_type, const char **app_id);
 
+/**
+ * @brief Gets the package name of the notification
+ * @remarks The pkgname must be released using free()
+ * @since_tizen 2.4
+ * @param[in] noti Notification handle
+ * @param[out] pkgname The package name of the notification
+ * @return #NOTIFICATION_ERROR_NONE on success, otherwise a negative error value
+ * @retval NOTIFICATION_ERROR_NONE Success
+ * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
+ * @par Sample code:
+ * @code
+#include <notification.h>
+...
+{
+	notification_h noti = NULL;
+	int noti_err = NOTIFICATION_ERROR_NONE;
+	char *pkgname = NULL;
+
+	...
+
+	noti_err  = notification_get_pkgname(noti, &pkgname);
+
+	if(noti_err != NOTIFICATION_ERROR_NONE) {
+		notification_free(noti);
+		free(pkgname);
+		return;
+	}
+}
+ * @endcode
+ */
+int notification_get_pkgname(notification_h noti, char **pkgname);
 
 /**
  * @}