Fix incorrect description

[platform/core/api/media-content.git] / include_product / media_audio.h

diff --git a/include_product/media_audio.h b/include_product/media_audio.h
index 3f30c6b..9ab5009 100755 (executable)
--- a/include_product/media_audio.h
+++ b/include_product/media_audio.h
@@ -27,7 +27,7 @@ extern "C" {
 /**
  * @file media_audio.h
  * @brief This file contains the audio metadata API and related functions to proceed with audio metadata. \n
- *        Description of the audio content involves: album, artist, album_artist, author, genre and description tags. \n
+ *        Description of the audio content involves: album, artist, album_artist, genre and description tags. \n
  *        Parameters of the recording are also supported such as format, bitrate, duration, size etc.
  */
 
@@ -101,7 +101,7 @@ int audio_meta_get_media_id(audio_meta_h audio, char **media_id);
 /**
  * @brief Gets the album of the given audio metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
- *                Since 3.0, if the media content has no album info, the method returns empty string.
+ *          Since 3.0, if the media content has no album info, the method returns empty string.
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -122,7 +122,7 @@ int audio_meta_get_album(audio_meta_h audio, char **album);
 /**
  * @brief Gets the artist of the given audio metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
- *                Since 3.0, if the media content has no artist info, the method returns empty string.
+ *          Since 3.0, if the media content has no artist info, the method returns empty string.
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -143,7 +143,7 @@ int audio_meta_get_artist(audio_meta_h audio, char **artist);
 /**
  * @brief Gets the album artist of the given audio metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
- *                Since 3.0, if the media content has no album artist info, the method returns empty string.
+ *          Since 3.0, if the media content has no album artist info, the method returns empty string.
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -164,7 +164,7 @@ int audio_meta_get_album_artist(audio_meta_h audio, char **album_artist);
 /**
  * @brief Gets the genre of the given audio metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
- *                Since 3.0, if the media content has no genre info, the method returns empty string.
+ *          Since 3.0, if the media content has no genre info, the method returns empty string.
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -185,7 +185,7 @@ int audio_meta_get_genre(audio_meta_h audio, char **genre);
 /**
  * @brief Gets the composer of the given audio metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
- *                Since 3.0, if the media content has no composer info, the method returns empty string.
+ *          Since 3.0, if the media content has no composer info, the method returns empty string.
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -206,7 +206,7 @@ int audio_meta_get_composer(audio_meta_h audio, char **composer);
 /**
  * @brief Gets the year of the given audio metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
- *                Since 3.0, if the media content has no year info, the method returns empty string.
+ *          Since 3.0, if the media content has no year info, the method returns empty string.
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -226,8 +226,8 @@ int audio_meta_get_year(audio_meta_h audio, char **year);
 
 /**
  * @brief Gets the recorded date of the given audio metadata.
- * @details The recorded date is got from audio file's metadata. Some formats like mp4 use UTC and the rest can be different. \n
- *              So, please refer to the format specification if needed.
+ * @details The format of the recorded date may vary depending on the file format. \n
+ *          For more details on the recorded date format, refer to the file format specification.
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -268,7 +268,7 @@ int audio_meta_get_copyright(audio_meta_h audio, char **copyright);
 /**
  * @brief Gets the track number of the given audio metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
- *                Since 3.0, if the media content has no track info, the method returns empty string.
+ *          Since 3.0, if the media content has no track info, the method returns empty string.
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -362,39 +362,6 @@ int audio_meta_get_channel(audio_meta_h audio, int *channel);
 int audio_meta_get_duration(audio_meta_h audio, int *duration);
 
 /**
- * @deprecated Deprecated since 4.0. Related setter functions are deprecated, therefore this function is not needed anymore.
- * @brief Updates an audio metadata with modified attributes in the media database.
- * @details The function updates the given audio meta in the media database. The function should be called after any change in audio attributes, to be updated to the media
- *          database.
- *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @privlevel public
- * @privilege %http://tizen.org/privilege/content.write
- *
- * @remarks Do not call this function in callback function of foreach function like media_info_foreach_media_from_db().
- *
- * @param[in] audio The handle to the audio metadata
- *
- * @return @c 0 on success,
- *         otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_OPERATION Invalid operation
- * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
- * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
- * @retval #MEDIA_CONTENT_ERROR_NETWORK           Network fail
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
- *
- * @pre This function requires opened connection to content service by media_content_connect().
- *
- * @see media_content_connect()
- */
-int audio_meta_update_to_db(audio_meta_h audio) TIZEN_DEPRECATED_API;
-
-/**
  *@}
  */