Fix description of voice control APIs

[platform/core/uifw/voice-control.git] / include / voice_control.h

diff --git a/include/voice_control.h b/include/voice_control.h
index c37d991..df8843d 100644 (file)
--- a/include/voice_control.h
+++ b/include/voice_control.h
@@ -90,10 +90,10 @@ extern "C"
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_OUT_OF_MEMORY Out of memory
  * @retval #VC_ERROR_OPERATION_FAILED Operation failure
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @post If this function is called, the state will be #VC_STATE_INITIALIZED.
  * @see vc_deinitialize()
  */
@@ -108,10 +108,10 @@ int vc_initialize(void);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_STATE Invalid state
  * @retval #VC_ERROR_OPERATION_FAILED Operation failure
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @see vc_initialize()
  */
 int vc_deinitialize(void);
@@ -125,10 +125,10 @@ int vc_deinitialize(void);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_STATE Invalid state
  * @retval #VC_ERROR_OPERATION_FAILED Operation failure
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The state should be #VC_STATE_INITIALIZED.
  * @post If this function is called, the state will be #VC_STATE_READY.
  * @see vc_unprepare()
@@ -144,9 +144,9 @@ int vc_prepare(void);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
  * @pre The state should be #VC_STATE_READY.
  * @post If this function is called, the state will be #VC_STATE_INITIALIZED.
  * @see vc_prepare()
@@ -164,11 +164,11 @@ int vc_unprepare(void);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_OPERATION_FAILED Operation failure
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The state should be #VC_STATE_INITIALIZED or #VC_STATE_READY.
  * @post This function invokes vc_supported_language_cb() repeatedly for getting languages.
  * @see vc_supported_language_cb()
@@ -189,12 +189,12 @@ int vc_foreach_supported_languages(vc_supported_language_cb callback, void* user
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_OUT_OF_MEMORY Out of memory
  * @retval #VC_ERROR_OPERATION_FAILED Operation failure
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The state should be #VC_STATE_INITIALIZED or #VC_STATE_READY.
  * @see vc_foreach_supported_languages()
  */
@@ -210,9 +210,9 @@ int vc_get_current_language(char** language);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @see vc_state_changed_cb()
  * @see vc_set_state_changed_cb()
  */
@@ -228,13 +228,10 @@ int vc_get_state(vc_state_e* state);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @pre The state should be #VC_STATE_READY.
- * @see vc_request_start()
- * @see vc_request_stop()
- * @see vc_request_cancel()
  * @see vc_set_service_state_changed_cb()
  * @see vc_unset_service_state_changed_cb()
  */
@@ -248,40 +245,40 @@ int vc_get_service_state(vc_service_state_e* state);
  * @privilege %http://tizen.org/privilege/recorder
  * @remarks In the system command list, there are system commands predefined by product manufacturers. Those commands have the highest priority.
  *          Therefore, the user can not set any commands same with the system commands.
- *          The @a vc_sys_cmd_list must be released using free() when it is no longer required.
+ *          The @a vc_sys_cmd_list must be released using vc_cmd_list_destroy() when it is no longer required.
  * @param[out] vc_sys_cmd_list System command list handle
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The service state should be #VC_SERVICE_STATE_READY.
- * @see vc_unset_command_list()
+ * @see vc_cmd_list_destroy()
  */
 int vc_get_system_command_list(vc_cmd_list_h* vc_sys_cmd_list);
 
 
 /**
  * @brief Sets the invocation name.
- * @since_tizen 3.0
- * @privlevel public
- * @privilege %http://tizen.org/privilege/recorder
- * @remarks Invocation name is used to activate background commands. The invocation name can be the same as the application name or any other phrase.
+ * @details Invocation name is used to activate background commands. The invocation name can be the same as the application name or any other phrase.
  *          For example, an application "Tizen Sample" has a background command, "Play music", and the invocation name of the application is set to "Tizen Sample".
  *          In order to activate the background command, users can say "Tizen Sample, Play music".
  *          The invocation name is dependent on the current language. For example, if the current language is "en_US"(English), the invocation name is also "en_US".
  *          If the current language is "ja_JP"(Japanese) and the invocation name is "en_US", the invocation name will not be recognized.
  *          This function should be called before vc_set_command_list().
+ * @since_tizen 3.0
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/recorder
+ * @remarks If @a name is @c NULL, the invocation name will be unset.
  * @param[in] name Invocation name that an application wants to be invoked by
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
  * @pre The state should be #VC_STATE_READY.
  * @see vc_set_command_list()
  */
@@ -296,15 +293,17 @@ int vc_set_invocation_name(const char* name);
  * @since_tizen 5.0
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
+ * @remarks If @a app_id is @c NULL, the API tries to get app ID using app manager framework.
+ *          However, getting app ID may be failed.
  * @param[in] app_id App id which is to want to ask server dialog.
  * @param[in] credential Credential key.
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The service state should be #VC_SERVICE_STATE_READY.
  * @see vc_unset_server_dialog()
  */
@@ -317,14 +316,16 @@ int vc_set_server_dialog(const char* app_id, const char* credential);
  * @since_tizen 5.0
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
+ * @remarks If @a app_id is @c NULL, the API tries to get app ID using app manager framework.
+ *          However, getting app ID may be failed.
  * @param[in] app_id App id which is to not want to ask server dialog.
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The service state should be #VC_SERVICE_STATE_READY.
  * @see vc_set_server_dialog()
  */
@@ -343,16 +344,17 @@ int vc_unset_server_dialog(const char* app_id);
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
  * @remarks If @a auto_start is @c true, the recognition will start again. In this case, it can be restarted up to 4 times.
+ *          @a disp_text and @a utt_text allow @c NULL. However, it is not allowed to set both @a disp_text and @a utt_text as @c NULL.
  * @param[in] disp_text Text to be displayed on the screen
  * @param[in] utt_text Text to be spoken
  * @param[in] auto_start A variable for setting whether the dialog session will be restarted automatically or not
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The service state should be #VC_SERVICE_STATE_READY.
  */
 int vc_request_dialog(const char* disp_text, const char* utt_text, bool auto_start);
@@ -370,10 +372,10 @@ int vc_request_dialog(const char* disp_text, const char* utt_text, bool auto_sta
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The state should be #VC_STATE_READY.
  * @see vc_unset_command_list()
  */
@@ -389,10 +391,10 @@ int vc_set_command_list(vc_cmd_list_h vc_cmd_list, int type);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The state should be #VC_STATE_READY.
  * @see vc_set_command_list()
  */
@@ -409,9 +411,10 @@ int vc_unset_command_list(int type);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The state should be #VC_STATE_READY.
  * @see vc_result_cb()
  */
@@ -419,7 +422,7 @@ int vc_get_result(vc_result_cb callback, void* user_data);
 
 
 /**
- * @brief Registers a callback function for getting recognition result.
+ * @brief Sets a callback function for getting recognition result.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
@@ -428,10 +431,10 @@ int vc_get_result(vc_result_cb callback, void* user_data);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The state should be #VC_STATE_INITIALIZED.
  * @see vc_result_cb()
  * @see vc_unset_result_cb()
@@ -440,15 +443,16 @@ int vc_set_result_cb(vc_result_cb callback, void* user_data);
 
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the callback function.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_STATE Invalid state
  * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
  * @pre The state should be #VC_STATE_INITIALIZED.
  * @see vc_set_result_cb()
  */
@@ -456,7 +460,7 @@ int vc_unset_result_cb(void);
 
 
 /**
- * @brief Registers a callback function to be called when state is changed.
+ * @brief Sets a callback function to be called when service state is changed.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
@@ -465,10 +469,10 @@ int vc_unset_result_cb(void);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The state should be #VC_STATE_INITIALIZED.
  * @see vc_service_state_changed_cb()
  * @see vc_unset_service_state_changed_cb()
@@ -477,16 +481,16 @@ int vc_set_service_state_changed_cb(vc_service_state_changed_cb callback, void*
 
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the callback function.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
  * @pre The state should be #VC_STATE_INITIALIZED.
  * @see vc_set_service_state_changed_cb()
  */
@@ -494,7 +498,7 @@ int vc_unset_service_state_changed_cb(void);
 
 
 /**
- * @brief Registers a callback function to be called when state is changed.
+ * @brief Sets a callback function to be called when state is changed.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
@@ -503,10 +507,10 @@ int vc_unset_service_state_changed_cb(void);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The state should be #VC_STATE_INITIALIZED.
  * @see vc_state_changed_cb()
  * @see vc_unset_state_changed_cb()
@@ -515,16 +519,16 @@ int vc_set_state_changed_cb(vc_state_changed_cb callback, void* user_data);
 
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the callback function.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
  * @pre The state should be #VC_STATE_INITIALIZED.
  * @see vc_set_state_changed_cb()
  */
@@ -532,7 +536,7 @@ int vc_unset_state_changed_cb(void);
 
 
 /**
- * @brief Registers a callback function to be called when current language is changed.
+ * @brief Sets a callback function to be called when current language is changed.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
@@ -541,10 +545,10 @@ int vc_unset_state_changed_cb(void);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The state should be #VC_STATE_INITIALIZED.
  * @see vc_current_language_changed_cb()
  * @see vc_unset_current_language_changed_cb()
@@ -553,16 +557,16 @@ int vc_set_current_language_changed_cb(vc_current_language_changed_cb callback,
 
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the callback function.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
  * @pre The state should be #VC_STATE_INITIALIZED.
  * @see vc_set_current_language_changed_cb()
  */
@@ -570,7 +574,7 @@ int vc_unset_current_language_changed_cb(void);
 
 
 /**
- * @brief Registers a callback function to be called when an error occurred.
+ * @brief Sets a callback function to be called when an error occurred.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
@@ -579,10 +583,10 @@ int vc_unset_current_language_changed_cb(void);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
  * @pre The state should be #VC_STATE_INITIALIZED.
  * @see vc_error_cb()
  * @see vc_unset_error_cb()
@@ -591,16 +595,16 @@ int vc_set_error_cb(vc_error_cb callback, void* user_data);
 
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the callback function.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
  * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
  * @pre The state should be #VC_STATE_INITIALIZED.
  * @see vc_set_error_cb()
  */
@@ -608,6 +612,7 @@ int vc_unset_error_cb(void);
 
 
 /**
+ * @partner
  * @brief Requests to send TTS streaming data, asynchronously.
  * @details Using this function, the developer can request text to speech to the framework.
  *          When the developer requests the TTS with @a language, VC engine will send PCM data which is synthesized using VC engine's own persona.
@@ -616,7 +621,7 @@ int vc_unset_error_cb(void);
  *          and then it will be spoken in VC manager. If @a to_vc_manager is false, you will receive PCM data through the vc_tts_streaming_cb() callback function if it was set using vc_tts_set_streaming_cb().
  *          This function is executed asynchronously, so if there is an error while synthesizing, vc_error_cb() will be called.
  * @since_tizen 5.5
- * @privlevel @partner
+ * @privlevel partner
  * @privilege %http://tizen.org/privilege/voicecontrol.tts
  * @param[in] text The text to be requested for TTS
  * @param[in] language The language is specified as an ISO 3166 alpha-2 two-letter country code
@@ -640,9 +645,10 @@ int vc_tts_request(const char* text, const char* language, bool to_vc_manager, i
 
 
 /**
+ * @partner
  * @brief Requests to cancel TTS streaming data.
  * @since_tizen 5.5
- * @privlevel @partner
+ * @privlevel partner
  * @privilege %http://tizen.org/privilege/voicecontrol.tts
  * @param[in] utt_id The utterance id
  * @return @c 0 on success,
@@ -659,10 +665,11 @@ int vc_tts_cancel(int utt_id);
 
 
 /**
+ * @partner
  * @brief Gets the TTS audio details.
  * @details Using this function, the developer can get details of synthesized audio data which is requested by vc_tts_request() function.
  * @since_tizen 5.5
- * @privlevel @partner
+ * @privlevel partner
  * @privilege %http://tizen.org/privilege/voicecontrol.tts
  * @param[out] rate The audio sampling rate
  * @param[out] channel The audio channel
@@ -680,9 +687,10 @@ int vc_tts_get_synthesized_audio_details(int* rate, vc_audio_channel_e* channel,
 
 
 /**
+ * @partner
  * @brief Sets the TTS streaming callback function.
  * @since_tizen 5.5
- * @privlevel @partner
+ * @privlevel partner
  * @privilege %http://tizen.org/privilege/voicecontrol.tts
  * @param[in] callback The callback function
  * @param[in] user_data The user data to be passed to the callback function
@@ -699,9 +707,10 @@ int vc_tts_set_streaming_cb(vc_tts_streaming_cb callback, void* user_data);
 
 
 /**
+ * @partner
  * @brief Unsets the TTS streaming callback function.
  * @since_tizen 5.5
- * @privlevel @partner
+ * @privlevel partner
  * @privilege %http://tizen.org/privilege/voicecontrol.tts
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -715,12 +724,13 @@ int vc_tts_unset_streaming_cb(void);
 
 
 /**
+ * @partner
  * @brief Sets the TTS utterance status callback function.
  * @details Using this function, the developer can set the utterance status callback to be called
  *          when the VC manager client starts or stops playing TTS PCM data which was requested to be synthesized with the vc_tts_request() function.
- *          This function is called when @a to_vc_manager in the vc_tts_request() function call is true.
+ *          This function is called when to_vc_manager in the vc_tts_request() function call is @c true.
  * @since_tizen 5.5
- * @privlevel @partner
+ * @privlevel partner
  * @privilege %http://tizen.org/privilege/voicecontrol.tts
  * @param[in] callback The callback function
  * @param[in] user_data The user data to be passed to the callback function
@@ -738,9 +748,10 @@ int vc_tts_set_utterance_status_cb(vc_tts_utterance_status_cb callback, void* us
 
 
 /**
+ * @partner
  * @brief Unsets the TTS utterance status callback function.
  * @since_tizen 5.5
- * @privlevel @partner
+ * @privlevel partner
  * @privilege %http://tizen.org/privilege/voicecontrol.tts
  * @return @c 0 on success,
  *         otherwise a negative error value