Update doxygen

Change-Id: I8fff017bdbf8a23cec6173fd9c5247a79dcc8ba1
Signed-off-by: mk5004.lee <mk5004.lee@samsung.com>

diff --git a/include/package_archive_info.h b/include/package_archive_info.h
index 44dd114..21b9547 100644 (file)
--- a/include/package_archive_info.h
+++ b/include/package_archive_info.h
@@ -213,7 +213,7 @@ int package_archive_info_get_icon(package_archive_info_h archive_info,
  *
  * If package_archive_info_foreach_direct_dependency(A) is called, the callback will be called once with the following argument values: @e from = A, @e to = B.
  * @since_tizen 5.5
- * @remarks The function provides the results synchronously. If there are no dependencies, this function will return PACKAGE_MANAGER_ERROR_NONE immediately and the callback will not be invoked.
+ * @remarks The function provides the results synchronously. If there are no dependencies, this function will return #PACKAGE_MANAGER_ERROR_NONE immediately and the callback will not be invoked.
  * @param[in] archive_info The package archive information
  * @param[in] callback     The iteration callback function
  * @param[in] user_data    The user data to be passed to the callback function

diff --git a/include/package_info.h b/include/package_info.h
index 140fe1b..3a615f5 100644 (file)
--- a/include/package_info.h
+++ b/include/package_info.h
@@ -63,15 +63,15 @@ typedef enum {
  */
 typedef enum {
        PACKAGE_INFO_ALLAPP = 0,                                /**< All applications
-          (Deprecated since 5.5, use PACKAGE_INFO_APP_COMPONENT_TYPE_ALL instead) */
+          (Deprecated since 5.5, use #PACKAGE_INFO_APP_COMPONENT_TYPE_ALL instead) */
        PACKAGE_INFO_UIAPP = 1,                                 /**< UI application
-          (Deprecated since 5.5, use PACKAGE_INFO_APP_COMPONENT_TYPE_UI instead) */
+          (Deprecated since 5.5, use #PACKAGE_INFO_APP_COMPONENT_TYPE_UI instead) */
        PACKAGE_INFO_SERVICEAPP = 2,                            /**< Service application
-          (Deprecated since 5.5, use PACKAGE_INFO_APP_COMPONENT_TYPE_SERVICE instead) */
+          (Deprecated since 5.5, use #PACKAGE_INFO_APP_COMPONENT_TYPE_SERVICE instead) */
        PACKAGE_INFO_WIDGETAPP = 3,                             /**< Widget application (Since 4.0)
-          (Deprecated since 5.5, use PACKAGE_INFO_APP_COMPONENT_TYPE_WIDGET instead) */
+          (Deprecated since 5.5, use #PACKAGE_INFO_APP_COMPONENT_TYPE_WIDGET instead) */
        PACKAGE_INFO_WATCHAPP = 4,                              /**< Watch application (Since 4.0)
-          (Deprecated since 5.5, use PACKAGE_INFO_APP_COMPONENT_TYPE_WATCH instead) */
+          (Deprecated since 5.5, use #PACKAGE_INFO_APP_COMPONENT_TYPE_WATCH instead) */
 
        PACKAGE_INFO_APP_COMPONENT_TYPE_ALL = 0,                /**< All applications (Since 5.5) */
        PACKAGE_INFO_APP_COMPONENT_TYPE_UI = 1,                 /**< UI application (Since 5.5) */
@@ -351,10 +351,10 @@ int package_info_get_root_path(package_info_h package_info, char **path);
  * @return 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #PACKAGE_MANAGER_ERROR_SYSTEM_ERROR          Severe system error
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_SYSTEM_ERROR Severe system error
  */
 int package_info_get_tep_name(package_info_h package_info, char **name);
 
@@ -453,6 +453,7 @@ int package_info_get_installed_time(package_info_h package_info, int *installed_
 /**
  * @brief Clones the package information handle.
  * @since_tizen 2.3
+ * @remarks The @a clone should be released using package_info_destroy().
  * @param[out] clone          The newly created package information handle
  * @param[in]  package_info   The package information
  * @return @c 0 on success,
@@ -513,7 +514,7 @@ int package_info_foreach_privilege_info(package_info_h package_info, package_inf
 
 /**
  * @brief Retrieves dependencies between packages.
- * @details @a package_info_dependency_info_cb is called whenever there is package dependency. The callback includes packages that are only directly required by the given package.
+ * @details @a callback is called whenever there is package dependency. The callback includes packages that are only directly required by the given package.
  *          For example, if there are packages having the following relationship:
  *
  *                B --> E
@@ -537,7 +538,7 @@ int package_info_foreach_dependency_info(package_info_h package_info, package_in
 
 /**
  * @brief Retrieves which packages depend on the given package.
- * @details @a package_info_dependency_info_cb is called whenever there is package dependency. The callback includes packages that are both directly and indirectly depend on the given package.
+ * @details @a callback is called whenever there is package dependency. The callback includes packages that are both directly and indirectly depend on the given package.
  *          For example, if there are packages having the following relationship:
  *
  *                B --> E

diff --git a/include/package_manager.h b/include/package_manager.h
index cf99da4..b2b5e73 100644 (file)
--- a/include/package_manager.h
+++ b/include/package_manager.h
@@ -208,10 +208,10 @@ typedef void (*package_manager_event_cb) (const char *type, const char *package,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #PACKAGE_MANAGER_ERROR_IO_ERROR          Internal I/O error
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @see package_manager_destroy()
  */
 int package_manager_create(package_manager_h *manager);
@@ -234,8 +234,8 @@ int package_manager_destroy(package_manager_h manager);
  * @brief Sets the event status of the package when the package is installed, uninstalled, or updated.
  * @details You can combine multiple status using OR operation which you want to listen.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param [in] manager     The package manager handle
- * @param [in] status_type The status of the package
+ * @param[in] manager     The package manager handle
+ * @param[in] status_type The status of the package
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
@@ -258,8 +258,8 @@ int package_manager_set_event_status(package_manager_h manager, int status_type)
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @post package_manager_event_cb() will be invoked.
  * @see package_manager_set_event_status()
  * @see package_manager_event_cb()
@@ -304,8 +304,8 @@ typedef bool (*package_manager_package_info_cb) (package_info_h package_info, vo
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @post This function invokes package_manager_package_info_cb() repeatedly for each package information.
  * @see package_manager_package_info_cb()
  */
@@ -317,14 +317,15 @@ int package_manager_foreach_package_info(package_manager_package_info_cb callbac
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/packagemanager.info
+ * @remarks The @a package_id should be released using free().
  * @param[in]  app_id     The ID of the application
  * @param[out] package_id The ID of the package
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  */
 int package_manager_get_package_id_by_app_id(const char *app_id, char **package_id);
 
@@ -340,10 +341,10 @@ int package_manager_get_package_id_by_app_id(const char *app_id, char **package_
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #PACKAGE_MANAGER_ERROR_IO_ERROR Database error occurred
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  */
 int package_manager_get_package_info(const char *package_id, package_info_h *package_info);
 
@@ -392,10 +393,10 @@ int package_manager_compare_app_cert_info(const char *lhs_app_id, const char *rh
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #PACKAGE_MANAGER_ERROR_IO_ERROR          I/O error
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  */
 int package_manager_is_preload_package_by_app_id(const char *app_id, bool *preload);
 
@@ -410,10 +411,10 @@ int package_manager_is_preload_package_by_app_id(const char *app_id, bool *prelo
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #PACKAGE_MANAGER_ERROR_IO_ERROR          I/O error
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  */
 int package_manager_get_permission_type(const char *app_id, package_manager_permission_type_e *permission_type);
 
@@ -428,9 +429,9 @@ int package_manager_get_permission_type(const char *app_id, package_manager_perm
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_NO_SUCH_PACKAGE   No such package
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #PACKAGE_MANAGER_ERROR_IO_ERROR          I/O error
  * @retval #PACKAGE_MANAGER_ERROR_SYSTEM_ERROR      Severe system error
@@ -447,8 +448,8 @@ int package_manager_clear_cache_dir(const char *package_id);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_NO_SUCH_PACKAGE   No such package
  * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_NO_SUCH_PACKAGE   No such package
  * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #PACKAGE_MANAGER_ERROR_IO_ERROR          I/O error
  * @retval #PACKAGE_MANAGER_ERROR_SYSTEM_ERROR      Severe system error
@@ -466,9 +467,9 @@ int package_manager_clear_all_cache_dir(void);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_NO_SUCH_PACKAGE   No such package
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #PACKAGE_MANAGER_ERROR_IO_ERROR          I/O error
  * @retval #PACKAGE_MANAGER_ERROR_SYSTEM_ERROR      Severe system error
@@ -515,9 +516,9 @@ typedef void (*package_manager_total_size_info_receive_cb)(const package_size_in
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_NO_SUCH_PACKAGE   No such package
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #PACKAGE_MANAGER_ERROR_IO_ERROR          I/O error
  * @retval #PACKAGE_MANAGER_ERROR_SYSTEM_ERROR      Severe system error
@@ -532,13 +533,13 @@ int package_manager_get_package_size_info(const char *package_id, package_manage
  * @privlevel public
  * @privilege %http://tizen.org/privilege/packagemanager.info
  * @param[in] callback  The asynchronous callback function to get the total package size information
- * @param[in] user_data        The user data to be passed to the callback function
+ * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_NO_SUCH_PACKAGE   No such package
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #PACKAGE_MANAGER_ERROR_IO_ERROR          I/O error
  * @retval #PACKAGE_MANAGER_ERROR_SYSTEM_ERROR      Severe system error
@@ -552,6 +553,7 @@ int package_manager_get_total_package_size_info(package_manager_total_size_info_
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/packagemanager.info
+ * @remarks The @a handle should be released using package_manager_filter_destroy().
  * @param[out] handle Pointer to the package info filter handle
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -566,7 +568,7 @@ int package_manager_filter_create(package_manager_filter_h *handle);
 
 
 /**
- * @brief This API destroys the package information filter handle freeing up all the resources
+ * @brief Destroys the package information filter handle freeing up all the resources.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] handle Pointer to the package info filter handle
  * @return @c 0 on success,
@@ -582,7 +584,7 @@ int package_manager_filter_destroy(package_manager_filter_h handle);
 
 
 /**
- * @brief This API adds a boolean filter property to the filter handle
+ * @brief Adds a boolean filter property to the filter handle.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] handle Pointer to the package info filter handle
  * @param[in] property boolean property name
@@ -601,7 +603,7 @@ int package_manager_filter_add_bool(package_manager_filter_h handle, const char
 
 
 /**
- * @brief This API counts the package that satisfy the filter conditions
+ * @brief Counts the package that satisfy the filter conditions.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/packagemanager.info
@@ -620,7 +622,7 @@ int package_manager_filter_count(package_manager_filter_h handle, int *count);
 
 
 /**
- * @brief This API executes the user supplied callback function for each package that satisfy the filter conditions
+ * @brief Executes the user supplied callback function for each package that satisfy the filter conditions.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/packagemanager.info
@@ -654,11 +656,11 @@ int package_manager_filter_foreach_package_info(package_manager_filter_h handle,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
  * @retval #PACKAGE_MANAGER_ERROR_IO_ERROR Internal I/O error
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
- * @post package_manager_drm_register_license
+ * @post package_manager_drm_register_license()
  */
 int package_manager_drm_generate_license_request(const char *resp_data, char **req_data, char **license_url);
 
@@ -673,10 +675,10 @@ int package_manager_drm_generate_license_request(const char *resp_data, char **r
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_IO_ERROR Internal I/O error
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
- * @pre package_manager_drm_generate_license_request
+ * @pre package_manager_drm_generate_license_request()
  */
 int package_manager_drm_register_license(const char *resp_data);
 
@@ -691,15 +693,15 @@ int package_manager_drm_register_license(const char *resp_data);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_IO_ERROR Internal I/O error
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  */
 int package_manager_drm_decrypt_package(const char *drm_file_path, const char *decrypted_file_path);
 
 
 /**
- * @brief Retrieves data size from given handle
+ * @brief Retrieves data size from given handle.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @param[in] handle Package size info handle
  * @param[out] data_size Data size will be returned
@@ -712,7 +714,7 @@ int package_size_info_get_data_size(package_size_info_h handle, long long *data_
 
 
 /**
- * @brief Retrieves cache size from given handle
+ * @brief Retrieves cache size from given handle.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @param[in] handle  Package size info handle
  * @param[out] cache_size Cache size will be returned
@@ -725,7 +727,7 @@ int package_size_info_get_cache_size(package_size_info_h handle, long long *cach
 
 
 /**
- * @brief Retrieves application size from given handle
+ * @brief Retrieves application size from given handle.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @param[in] handle Package size info handle
  * @param[out] app_size App size will be returned
@@ -738,7 +740,7 @@ int package_size_info_get_app_size(package_size_info_h handle, long long *app_si
 
 
 /**
- * @brief Retrieves external data size from given handle
+ * @brief Retrieves external data size from given handle.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @param[in] handle  Package size info handle
  * @param[out] ext_data_size External data size will be returned
@@ -751,7 +753,7 @@ int package_size_info_get_external_data_size(package_size_info_h handle, long lo
 
 
 /**
- * @brief Retrieves external cache size from given handle
+ * @brief Retrieves external cache size from given handle.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @param[in] handle Package size info handle
  * @param[out] ext_cache_size External cache size will be returned
@@ -764,7 +766,7 @@ int package_size_info_get_external_cache_size(package_size_info_h handle, long l
 
 
 /**
- * @brief Retrieves external application size from given handle
+ * @brief Retrieves external application size from given handle.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @param[in] handle Package size info handle
  * @param[out] ext_app_size External app size will be returned
@@ -867,8 +869,8 @@ int package_manager_request_destroy(package_manager_request_h request);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @post package_manager_request_event_cb() will be invoked.
  * @see package_manager_request_event_cb()
  * @see package_manager_request_unset_event_cb()
@@ -930,8 +932,8 @@ int package_manager_request_set_mode(package_manager_request_h request, package_
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE Successful
- * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_SYSTEM_ERROR          Severe system error
  */
 int package_manager_request_set_tep(package_manager_request_h request, const char *tep_path);
@@ -949,8 +951,8 @@ int package_manager_request_set_tep(package_manager_request_h request, const cha
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @see package_manager_request_uninstall()
  */
 int package_manager_request_install(package_manager_request_h request, const char *path, int *id);
@@ -974,8 +976,8 @@ int package_manager_request_install(package_manager_request_h request, const cha
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  */
 int package_manager_request_install_with_cb(package_manager_request_h request,
                                                const char *path,
@@ -996,8 +998,8 @@ int package_manager_request_install_with_cb(package_manager_request_h request,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  */
 int package_manager_request_uninstall(package_manager_request_h request, const char *name, int *id);
 
@@ -1020,8 +1022,8 @@ int package_manager_request_uninstall(package_manager_request_h request, const c
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  */
 int package_manager_request_uninstall_with_cb(package_manager_request_h request,
                                                const char *name,
@@ -1038,12 +1040,12 @@ int package_manager_request_uninstall_with_cb(package_manager_request_h request,
  * @privilege %http://tizen.org/privilege/packagemanager.admin
  * @param[in] request   The request handle
  * @param[in] name      The name of the package to be moved
- * @param[in] move_type The move type [enum package_manager_move_type_e], [external to internal/internal to external]
+ * @param[in] move_type The move type [#enum package_manager_move_type_e], [external to internal/internal to external]
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  */
 int package_manager_request_move(package_manager_request_h request, const char *name, package_manager_move_type_e move_type);
 
@@ -1060,15 +1062,15 @@ int package_manager_request_move(package_manager_request_h request, const char *
  * @privilege %http://tizen.org/privilege/packagemanager.admin
  * @param[in]  request   The request handle
  * @param[in]  name      The name of the package to be moved
- * @param[in]  move_type The move type [enum package_manager_move_type_e], [external to internal/internal to external]
+ * @param[in]  move_type The move type [#enum package_manager_move_type_e], [external to internal/internal to external]
  * @param[in]  callback  The callback function to be invoked
  * @param[in]  user_data The user data to be passed to the callback function
  * @param[out] id        The ID of the request to the package manager
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  */
 int package_manager_request_move_with_cb(package_manager_request_h request,
                                                const char *name,
@@ -1088,9 +1090,9 @@ int package_manager_request_move_with_cb(package_manager_request_h request,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
+ * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
- * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
  * @see package_manager_updateinfo_request_destroy()
  */
 int package_manager_updateinfo_request_create(package_updateinfo_request_h *pkg_updateinfo_req);
@@ -1103,8 +1105,8 @@ int package_manager_updateinfo_request_create(package_updateinfo_request_h *pkg_
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
  * @see package_manager_updateinfo_request_create()
  */
 int package_manager_updateinfo_set_pkgid(package_updateinfo_request_h pkg_updateinfo_req, const char *pkgid);
@@ -1117,8 +1119,8 @@ int package_manager_updateinfo_set_pkgid(package_updateinfo_request_h pkg_update
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #PACKAGE_MANAGER_ERROR_OUT_OF_MEMORY     Out of memory
  * @see package_manager_updateinfo_request_create()
  */
 int package_manager_updateinfo_set_version(package_updateinfo_request_h pkg_updateinfo_req, const char *version);
@@ -1138,7 +1140,7 @@ int package_manager_updateinfo_set_version(package_updateinfo_request_h pkg_upda
 int package_manager_updateinfo_set_type(package_updateinfo_request_h pkg_updateinfo_req, package_updateinfo_type_e type);
 
 /**
- * @brief Request to register package update info in platform.
+ * @brief Requests to register package update info in platform.
  * @since_tizen 4.0
  * @param[in] pkg_updateinfo_req    The update info request handle
  * @return @c 0 on success,
@@ -1165,7 +1167,7 @@ int package_manager_updateinfo_request_register(package_updateinfo_request_h pkg
 int package_manager_updateinfo_request_destroy(package_updateinfo_request_h pkg_updateinfo_req);
 
 /**
- * @brief Request to unregister update info in platform for given package id.
+ * @brief Requests to unregister update info in platform for given package id.
  * @since_tizen 4.0
  * @param[in] pkg_updateinfo_req   The update info request handle
  * @param[in] pkgid                The package id to request unregister update info

diff --git a/include/package_manager_extension.h b/include/package_manager_extension.h
index fe610fe..d003b08 100644 (file)
--- a/include/package_manager_extension.h
+++ b/include/package_manager_extension.h
@@ -44,8 +44,8 @@ extern "C" {
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @see package_manager_request_uninstall()
  */
 int package_manager_request_mount_install(package_manager_request_h request, const char *path, int *id);
@@ -69,8 +69,8 @@ int package_manager_request_mount_install(package_manager_request_h request, con
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PACKAGE_MANAGER_ERROR_NONE              Successful
- * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PACKAGE_MANAGER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PACKAGE_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
  */
 int package_manager_request_mount_install_with_cb(package_manager_request_h request,
                                                const char *path,