Modifiy description

It is the revert commit of
e0b2bff97347db2af56426c1727020dde0c3e41d(Revise error description).
And added more comments for tizen 4.0.

[Version] 0.4.9
[Issue Type] Description

Change-Id: I0beb6ca1d74fceb6b1bc967867e2f36cc8e522f0
Signed-off-by: Sangchul Lee <sc11.lee@samsung.com>

diff --git a/include/sound_manager.h b/include/sound_manager.h
index 28ad7738b73f2b44432a46b881b67eabc76893cd..01c4699411aeb6d9d5ff7b210defb800fdbfaf3d 100644 (file)
--- a/include/sound_manager.h
+++ b/include/sound_manager.h
@@ -785,6 +785,9 @@ int sound_manager_apply_stream_routing(sound_stream_info_h stream_info);
  * @brief Acquires the stream focus.
  * @since_tizen 3.0
  *
+ * @remarks    Do not call this function within sound_stream_focus_state_changed_cb() or sound_stream_focus_state_watch_cb(),\n
+ *     otherwise #SOUND_MANAGER_ERROR_INVALID_OPERATION will be returned. Since 4.0, it is allowed and does not return the error.
+ *
  * @param[in]  stream_info     The handle of stream information
  * @param[in]  focus_mask      The focus mask that user wants to acquire
  * @param[in]  sound_behavior  The requesting sound behavior, values of #sound_behavior_e combined with bitwise 'or'
@@ -793,6 +796,7 @@ int sound_manager_apply_stream_routing(sound_stream_info_h stream_info);
  *         otherwise a negative error value
  * @retval #SOUND_MANAGER_ERROR_NONE Success
  * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #SOUND_MANAGER_ERROR_INVALID_OPERATION Invalid operation
  * @retval #SOUND_MANAGER_ERROR_INVALID_STATE Invalid state
  * @retval #SOUND_MANAGER_ERROR_POLICY Noncompliance with the sound system policy
  * @retval #SOUND_MANAGER_ERROR_INTERNAL Internal error inside the sound system
@@ -811,6 +815,9 @@ int sound_manager_acquire_focus(sound_stream_info_h stream_info, sound_stream_fo
  * @brief Releases the acquired stream focus.
  * @since_tizen 3.0
  *
+ * @remarks    Do not call this function within sound_stream_focus_state_changed_cb() or sound_stream_focus_state_watch_cb(),\n
+ *     otherwise #SOUND_MANAGER_ERROR_INVALID_OPERATION will be returned. Since 4.0, it is allowed and does not return the error.
+ *
  * @param[in]  stream_info     The handle of stream information
  * @param[in]  focus_mask      The focus mask that user wants to release
  * @param[in]  sound_behavior  The requesting sound behavior, values of #sound_behavior_e combined with bitwise 'or'
@@ -819,6 +826,7 @@ int sound_manager_acquire_focus(sound_stream_info_h stream_info, sound_stream_fo
  *         otherwise a negative error value
  * @retval #SOUND_MANAGER_ERROR_NONE Success
  * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #SOUND_MANAGER_ERROR_INVALID_OPERATION Invalid operation
  * @retval #SOUND_MANAGER_ERROR_INVALID_STATE Invalid state
  * @retval #SOUND_MANAGER_ERROR_INTERNAL Internal error inside the sound system
  * @pre Call sound_manager_create_stream_information() and sound_manager_acquire_focus() before calling this function.

diff --git a/packaging/capi-media-sound-manager.spec b/packaging/capi-media-sound-manager.spec
index 85d471dabfd1b117b4d469cb0b836dd39db5bf0d..3a501a7d35247b6e4c76aaa4625822c32b7fce73 100644 (file)
--- a/packaging/capi-media-sound-manager.spec
+++ b/packaging/capi-media-sound-manager.spec
@@ -1,6 +1,6 @@
 Name:       capi-media-sound-manager
 Summary:    Sound Manager library
-Version:    0.4.8
+Version:    0.4.9
 Release:    0
 Group:      Multimedia/API
 License:    Apache-2.0