* @since_tizen 5.5
*
* @remarks This function is invoked by the internal thread of the sound manager.
- * Therefore it is recommended not to call functions which update the UI from this callback.
- * @remarks @a stream_ducking is the same handle for which the callback was set in the sound_manager_create_stream_ducking() call,
- * so it should not be released in this callback.
+ * Therefore it is recommended not to call functions which update UI in this callback.
+ * @remarks @a stream_ducking is the same handle as the parameter in sound_manager_create_stream_ducking() that registers this callback,
+ * so the handle should not be released in this callback.
*
* @param[in] stream_ducking The stream ducking handle
* @param[in] is_ducked The flag whether it's ducked or not
* @remarks @a stream_ducking should be released using sound_manager_destroy_stream_ducking().
*
* @param[in] target_stream The type of target stream
- * @param[in] callback The ducking state changed callback function (optional, this can be NULL)
+ * @param[in] callback The callback function called when ducking state is changed (optional, this can be NULL)
* @param[in] user_data The user data to be passed to the callback function (optional, this can be NULL)
* @param[out] stream_ducking The handle of stream ducking
* @return @c 0 on success,
* @since_tizen 5.5
*
* @param[in] stream_ducking The handle of stream ducking
- * @param[out] is_ducked Whether the stream is ducked or not: (@c true = ducked, @c false = unducked)
+ * @param[out] is_ducked Whether the stream is ducked or not. @c true if ducked, @c false otherwise.
* @return @c 0 on success,
* otherwise a negative error value
* @retval #SOUND_MANAGER_ERROR_NONE Success
* @privlevel public
* @privilege %http://tizen.org/privilege/volume.set
* @remarks If ducking is activated successfully, the volume of all sound streams
- * matched with target_stream (set in sound_manager_create_stream_ducking())
- * is decreased by @a ratio for @a duration. The change is system-wide.
+ * matched with the target_stream that set in sound_manager_create_stream_ducking()
+ * is decreased by @a ratio for @a duration.
+ * The change applies system-wide.
* @param[in] stream_ducking The handle of stream ducking
* @param[in] duration The duration for ducking (msec, 0 <= duration <= 3000)
* @param[in] ratio The volume ratio when ducked (0.0 <= ratio < 1.0)