[ACR-1249] Deprecate APIs related with storage id and type

Change-Id: I3ece6ca87206a7a3a05e252db707d4c1a28a1074
Signed-off-by: Minje Ahn <minje.ahn@samsung.com>

diff --git a/include/media_content_type.h b/include/media_content_type.h
index 6df515a..36cd9b3 100755 (executable)
--- a/include/media_content_type.h
+++ b/include/media_content_type.h
@@ -44,7 +44,7 @@ extern "C" {
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks Since 4.0, #MEDIA_CONTENT_TYPE_OTHERS is related to the following feature:\n
  *              %http://tizen.org/feature/content.scanning.others\n
- *              If this feature is not supported on the device, MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
+ *              If this feature is not supported on the device, #MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
  */
 typedef enum {
        MEDIA_CONTENT_TYPE_IMAGE                = 0,    /**<The type of an image */
@@ -56,6 +56,7 @@ typedef enum {
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_CONTENT_MODULE
+ * @deprecated Deprecated since 5.0.
  * @brief Enumeration for the storage type.
  * @details This information is used to establish where the folder is.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -265,6 +266,7 @@ typedef struct filter_s *filter_h;
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
+ * @deprecated Deprecated since 5.0.
  * @brief The structure type for the Media storage handle.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  */
@@ -633,6 +635,7 @@ typedef bool (*media_group_cb)(const char *group_name, void *user_data);
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
+ * @deprecated Deprecated since 5.0.
  * @brief Called for every storage in the obtained list of storages.
  * @details Iterates over a media storage list.
  *
@@ -1084,6 +1087,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_IS_DRM "MEDIA_IS_DRM"
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Media storage.
  * @details There are 2 types:\n
  *               0-internal storage, 1-external storage\n
@@ -1346,6 +1350,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define FOLDER_MODIFIED_TIME "FOLDER_MODIFIED_TIME"
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Folder storage.
  * @details There are 2 types:\n
  *               0-internal storage, 1-external storage\n
@@ -1451,6 +1456,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define BOOKMARK_NAME "BOOKMARK_NAME"
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Storage ID.
  * @details You can use above define to set the condition of storage filter and order keyword.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
@@ -1458,6 +1464,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_STORAGE_ID                                       "STORAGE_ID"
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Storage path.
  * @details You can use above define to set the condition of storage filter and order keyword.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif

diff --git a/include/media_filter.h b/include/media_filter.h
index c0cef94..fb36316 100755 (executable)
--- a/include/media_filter.h
+++ b/include/media_filter.h
@@ -144,6 +144,9 @@ int media_filter_set_condition(filter_h filter, const char *condition, media_con
 int media_filter_set_order(filter_h filter, media_content_order_e order_type, const char *order_keyword, media_content_collation_e collate_type);
 
 /**
+ * @deprecated Deprecated since 5.0. Use media_filter_set_condition() with MEDIA_PATH keyword instead. \n
+ *             See @ref CAPI_SYSTEM_STORAGE_MODULE for information about file system paths.
+ *
  * @brief Sets the @a storage_id for the given @a filter.
  * @details You can use this function when you want to search items only in the specific storage
  *
@@ -162,7 +165,7 @@ int media_filter_set_order(filter_h filter, media_content_order_e order_type, co
  * @see media_filter_create()
  * @see media_filter_destroy()
  */
-int media_filter_set_storage(filter_h filter, const char *storage_id);
+int media_filter_set_storage(filter_h filter, const char *storage_id) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Gets the @a offset and @a count for the given @a filter used to limit the number of items returned.
@@ -228,6 +231,7 @@ int media_filter_get_condition(filter_h filter, char **condition, media_content_
 int media_filter_get_order(filter_h filter, media_content_order_e* order_type, char **order_keyword, media_content_collation_e *collate_type);
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Gets the @a storage_id for given @a filter.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -245,7 +249,7 @@ int media_filter_get_order(filter_h filter, media_content_order_e* order_type, c
  * @see media_filter_create()
  * @see media_filter_destroy()
  */
-int media_filter_get_storage(filter_h filter, char **storage_id);
+int media_filter_get_storage(filter_h filter, char **storage_id) TIZEN_DEPRECATED_API;
 
 /**
  * @}

diff --git a/include/media_folder.h b/include/media_folder.h
index 598db8e..8622309 100755 (executable)
--- a/include/media_folder.h
+++ b/include/media_folder.h
@@ -291,6 +291,7 @@ int media_folder_get_name(media_folder_h folder, char **folder_name);
 int media_folder_get_modified_time(media_folder_h folder, time_t *date) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0. Use storage_get_type_dev() instead.
  * @brief Gets the folder storage type.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -303,9 +304,10 @@ int media_folder_get_modified_time(media_folder_h folder, time_t *date) TIZEN_DE
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_folder_get_storage_type(media_folder_h folder, media_content_storage_e *storage_type);
+int media_folder_get_storage_type(media_folder_h folder, media_content_storage_e *storage_type) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Gets the storage id of the folder.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -321,7 +323,7 @@ int media_folder_get_storage_type(media_folder_h folder, media_content_storage_e
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int media_folder_get_storage_id(media_folder_h folder, char **storage_id);
+int media_folder_get_storage_id(media_folder_h folder, char **storage_id) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since 4.0. \n

diff --git a/include/media_info.h b/include/media_info.h
index 8918fa3..ec2c0de 100755 (executable)
--- a/include/media_info.h
+++ b/include/media_info.h
@@ -715,7 +715,7 @@ int media_info_get_modified_time(media_info_h media, time_t *time);
 
 /**
  * @brief Gets the timeline of content file.
- * @details If the content file has the creation time information (like Content recored date or Image creation date), that value is timeline. \n
+ * @details If the content file has the creation time information (like Content recorded date or Image creation date), that value is timeline. \n
  *               Otherwise, timeline value is the same as modified time.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -1028,6 +1028,7 @@ int media_info_get_age_rating(media_info_h media, char **age_rating) TIZEN_DEPRE
 int media_info_get_keyword(media_info_h media, char **keyword) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Gets the storage id of content file.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -1043,7 +1044,7 @@ int media_info_get_keyword(media_info_h media, char **keyword) TIZEN_DEPRECATED_
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_info_get_storage_id(media_info_h media, char **storage_id);
+int media_info_get_storage_id(media_info_h media, char **storage_id) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Checks whether the media is protected via DRM.
@@ -1078,6 +1079,7 @@ int media_info_is_drm(media_info_h media, bool *is_drm);
 int media_info_is_360_content(media_info_h media, bool *is_360);
 
 /**
+ * @deprecated Deprecated since 5.0. Use storage_get_type_dev() instead.
  * @brief Gets the storage type of content file.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -1090,7 +1092,7 @@ int media_info_is_360_content(media_info_h media, bool *is_360);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_info_get_storage_type(media_info_h media, media_content_storage_e *storage_type);
+int media_info_get_storage_type(media_info_h media, media_content_storage_e *storage_type) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since 4.0. \n

diff --git a/include/media_storage.h b/include/media_storage.h
index 7821363..3a2a52f 100755 (executable)
--- a/include/media_storage.h
+++ b/include/media_storage.h
@@ -38,6 +38,7 @@ extern "C" {
  */
 
 /**
+* @deprecated Deprecated since 5.0.
 * @brief Gets media storage from database.
 * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 *
@@ -59,9 +60,10 @@ extern "C" {
 *
 * @see media_content_connect()
 */
-int media_storage_get_storage_info_from_db(const char *storage_id, media_storage_h *storage);
+int media_storage_get_storage_info_from_db(const char *storage_id, media_storage_h *storage) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 5.0. Use @ref CAPI_SYSTEM_STORAGE_MODULE instead.
 * @brief Gets the count of media storage for the passed @a filter from the media database.
 * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 *
@@ -81,9 +83,10 @@ int media_storage_get_storage_info_from_db(const char *storage_id, media_storage
 *
 * @see media_content_connect()
 */
-int media_storage_get_storage_count_from_db(filter_h filter, int *storage_count);
+int media_storage_get_storage_count_from_db(filter_h filter, int *storage_count) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0. Use @ref CAPI_SYSTEM_STORAGE_MODULE instead.
  * @brief Iterates through media storage from the media database.
  * @details This function gets all media storage handles meeting the given @a filter.
  *          The @a callback function will be invoked for every retrieved media storage.
@@ -110,9 +113,10 @@ int media_storage_get_storage_count_from_db(filter_h filter, int *storage_count)
  * @see media_content_connect()
  * @see media_storage_destroy()
  */
-int media_storage_foreach_storage_from_db(filter_h filter, media_storage_cb callback, void *user_data);
+int media_storage_foreach_storage_from_db(filter_h filter, media_storage_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0. Use media_info_get_media_count_from_db() instead.
  * @brief Gets the count of media files for the passed @a filter in the given @a storage_id from the media database.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -134,9 +138,10 @@ int media_storage_foreach_storage_from_db(filter_h filter, media_storage_cb call
  *
  * @see media_content_connect()
  */
-int media_storage_get_media_count_from_db(const char *storage_id, filter_h filter, int *media_count);
+int media_storage_get_media_count_from_db(const char *storage_id, filter_h filter, int *media_count) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0. Use media_info_foreach_media_from_db() instead.
  * @brief Iterates through the media files with an optional @a filter in the given @a storage_id from the media database.
  * @details This function gets all media files associated with the given storage and
  *          meeting desired filter option and calls @a callback for
@@ -171,9 +176,10 @@ int media_storage_get_media_count_from_db(const char *storage_id, filter_h filte
  * @see media_content_connect()
  * @see media_filter_create()
  */
-int media_storage_foreach_media_from_db(const char *storage_id, filter_h filter, media_info_cb callback, void *user_data);
+int media_storage_foreach_media_from_db(const char *storage_id, filter_h filter, media_info_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Destroys media storage handle.
  * @details The function frees all resources related to the media storage handle. This handle
  *          can no longer be used to perform any operations. New media storage handle has to
@@ -193,9 +199,10 @@ int media_storage_foreach_media_from_db(const char *storage_id, filter_h filter,
  *
  * @see media_storage_clone()
  */
-int media_storage_destroy(media_storage_h storage);
+int media_storage_destroy(media_storage_h storage) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Clones the media storage handle.
  *
  * @details This function copies the media storage handle from a source to the destination.
@@ -221,9 +228,10 @@ int media_storage_destroy(media_storage_h storage);
  * @see media_storage_foreach_storage_from_db()
  * @see media_storage_get_storage_info_from_db()
  */
-int media_storage_clone(media_storage_h *dst, media_storage_h src);
+int media_storage_clone(media_storage_h *dst, media_storage_h src) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Gets the storage id of media storage.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -239,7 +247,7 @@ int media_storage_clone(media_storage_h *dst, media_storage_h src);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int media_storage_get_id(media_storage_h storage, char **storage_id);
+int media_storage_get_id(media_storage_h storage, char **storage_id) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since 4.0.
@@ -262,6 +270,7 @@ int media_storage_get_id(media_storage_h storage, char **storage_id);
 int media_storage_get_name(media_storage_h storage, char **storage_name) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0. Use @ref CAPI_SYSTEM_STORAGE_MODULE instead.
  * @brief Gets the storage path of media storage.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -277,9 +286,10 @@ int media_storage_get_name(media_storage_h storage, char **storage_name) TIZEN_D
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int media_storage_get_path(media_storage_h storage, char **storage_path);
+int media_storage_get_path(media_storage_h storage, char **storage_path) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0. Use storage_get_type_dev() instead.
  * @brief Gets the storage type of media storage.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -292,7 +302,7 @@ int media_storage_get_path(media_storage_h storage, char **storage_path);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_storage_get_type(media_storage_h storage, media_content_storage_e *storage_type);
+int media_storage_get_type(media_storage_h storage, media_content_storage_e *storage_type) TIZEN_DEPRECATED_API;
 
 /**
  * @}

diff --git a/include_product/media_content_type.h b/include_product/media_content_type.h
index 4f8a83f..13c0ce4 100755 (executable)
--- a/include_product/media_content_type.h
+++ b/include_product/media_content_type.h
@@ -50,7 +50,7 @@ extern "C" {
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks Since 4.0, #MEDIA_CONTENT_TYPE_OTHERS is related to the following feature:\n
  *              %http://tizen.org/feature/content.scanning.others\n
- *              If this feature is not supported on the device, MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
+ *              If this feature is not supported on the device, #MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
  */
 typedef enum {
        MEDIA_CONTENT_TYPE_IMAGE                = 0,    /**<The type of an image */
@@ -65,6 +65,7 @@ typedef enum {
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_CONTENT_MODULE
+ * @deprecated Deprecated since 5.0.
  * @brief Enumeration for the storage type.
  * @details This information is used to establish where the folder is.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -331,6 +332,7 @@ typedef struct filter_s *filter_h;
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
+ * @deprecated Deprecated since 5.0.
  * @brief The structure type for the Media storage handle.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  */
@@ -699,6 +701,7 @@ typedef bool (*media_group_cb)(const char *group_name, void *user_data);
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
+ * @deprecated Deprecated since 5.0.
  * @brief Called for every storage in the obtained list of storages.
  * @details Iterates over a media storage list.
  *
@@ -1150,6 +1153,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_IS_DRM "MEDIA_IS_DRM"
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Media storage.
  * @details There are 2 types:\n
  *               0-internal storage, 1-external storage\n
@@ -1412,6 +1416,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define FOLDER_MODIFIED_TIME "FOLDER_MODIFIED_TIME"
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Folder storage.
  * @details There are 2 types:\n
  *               0-internal storage, 1-external storage\n
@@ -1517,6 +1522,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define BOOKMARK_NAME "BOOKMARK_NAME"
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Storage ID.
  * @details You can use above define to set the condition of storage filter and order keyword.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
@@ -1524,6 +1530,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_STORAGE_ID                                       "STORAGE_ID"
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Storage path.
  * @details You can use above define to set the condition of storage filter and order keyword.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif

diff --git a/include_product/media_filter.h b/include_product/media_filter.h
index c0cef94..fb36316 100755 (executable)
--- a/include_product/media_filter.h
+++ b/include_product/media_filter.h
@@ -144,6 +144,9 @@ int media_filter_set_condition(filter_h filter, const char *condition, media_con
 int media_filter_set_order(filter_h filter, media_content_order_e order_type, const char *order_keyword, media_content_collation_e collate_type);
 
 /**
+ * @deprecated Deprecated since 5.0. Use media_filter_set_condition() with MEDIA_PATH keyword instead. \n
+ *             See @ref CAPI_SYSTEM_STORAGE_MODULE for information about file system paths.
+ *
  * @brief Sets the @a storage_id for the given @a filter.
  * @details You can use this function when you want to search items only in the specific storage
  *
@@ -162,7 +165,7 @@ int media_filter_set_order(filter_h filter, media_content_order_e order_type, co
  * @see media_filter_create()
  * @see media_filter_destroy()
  */
-int media_filter_set_storage(filter_h filter, const char *storage_id);
+int media_filter_set_storage(filter_h filter, const char *storage_id) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Gets the @a offset and @a count for the given @a filter used to limit the number of items returned.
@@ -228,6 +231,7 @@ int media_filter_get_condition(filter_h filter, char **condition, media_content_
 int media_filter_get_order(filter_h filter, media_content_order_e* order_type, char **order_keyword, media_content_collation_e *collate_type);
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Gets the @a storage_id for given @a filter.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -245,7 +249,7 @@ int media_filter_get_order(filter_h filter, media_content_order_e* order_type, c
  * @see media_filter_create()
  * @see media_filter_destroy()
  */
-int media_filter_get_storage(filter_h filter, char **storage_id);
+int media_filter_get_storage(filter_h filter, char **storage_id) TIZEN_DEPRECATED_API;
 
 /**
  * @}

diff --git a/include_product/media_folder.h b/include_product/media_folder.h
index 598db8e..8622309 100755 (executable)
--- a/include_product/media_folder.h
+++ b/include_product/media_folder.h
@@ -291,6 +291,7 @@ int media_folder_get_name(media_folder_h folder, char **folder_name);
 int media_folder_get_modified_time(media_folder_h folder, time_t *date) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0. Use storage_get_type_dev() instead.
  * @brief Gets the folder storage type.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -303,9 +304,10 @@ int media_folder_get_modified_time(media_folder_h folder, time_t *date) TIZEN_DE
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_folder_get_storage_type(media_folder_h folder, media_content_storage_e *storage_type);
+int media_folder_get_storage_type(media_folder_h folder, media_content_storage_e *storage_type) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Gets the storage id of the folder.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -321,7 +323,7 @@ int media_folder_get_storage_type(media_folder_h folder, media_content_storage_e
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int media_folder_get_storage_id(media_folder_h folder, char **storage_id);
+int media_folder_get_storage_id(media_folder_h folder, char **storage_id) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since 4.0. \n

diff --git a/include_product/media_info.h b/include_product/media_info.h
index 8918fa3..ec2c0de 100755 (executable)
--- a/include_product/media_info.h
+++ b/include_product/media_info.h
@@ -715,7 +715,7 @@ int media_info_get_modified_time(media_info_h media, time_t *time);
 
 /**
  * @brief Gets the timeline of content file.
- * @details If the content file has the creation time information (like Content recored date or Image creation date), that value is timeline. \n
+ * @details If the content file has the creation time information (like Content recorded date or Image creation date), that value is timeline. \n
  *               Otherwise, timeline value is the same as modified time.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -1028,6 +1028,7 @@ int media_info_get_age_rating(media_info_h media, char **age_rating) TIZEN_DEPRE
 int media_info_get_keyword(media_info_h media, char **keyword) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Gets the storage id of content file.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -1043,7 +1044,7 @@ int media_info_get_keyword(media_info_h media, char **keyword) TIZEN_DEPRECATED_
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_info_get_storage_id(media_info_h media, char **storage_id);
+int media_info_get_storage_id(media_info_h media, char **storage_id) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Checks whether the media is protected via DRM.
@@ -1078,6 +1079,7 @@ int media_info_is_drm(media_info_h media, bool *is_drm);
 int media_info_is_360_content(media_info_h media, bool *is_360);
 
 /**
+ * @deprecated Deprecated since 5.0. Use storage_get_type_dev() instead.
  * @brief Gets the storage type of content file.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -1090,7 +1092,7 @@ int media_info_is_360_content(media_info_h media, bool *is_360);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_info_get_storage_type(media_info_h media, media_content_storage_e *storage_type);
+int media_info_get_storage_type(media_info_h media, media_content_storage_e *storage_type) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since 4.0. \n

diff --git a/include_product/media_storage.h b/include_product/media_storage.h
index 7821363..3a2a52f 100755 (executable)
--- a/include_product/media_storage.h
+++ b/include_product/media_storage.h
@@ -38,6 +38,7 @@ extern "C" {
  */
 
 /**
+* @deprecated Deprecated since 5.0.
 * @brief Gets media storage from database.
 * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 *
@@ -59,9 +60,10 @@ extern "C" {
 *
 * @see media_content_connect()
 */
-int media_storage_get_storage_info_from_db(const char *storage_id, media_storage_h *storage);
+int media_storage_get_storage_info_from_db(const char *storage_id, media_storage_h *storage) TIZEN_DEPRECATED_API;
 
 /**
+* @deprecated Deprecated since 5.0. Use @ref CAPI_SYSTEM_STORAGE_MODULE instead.
 * @brief Gets the count of media storage for the passed @a filter from the media database.
 * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 *
@@ -81,9 +83,10 @@ int media_storage_get_storage_info_from_db(const char *storage_id, media_storage
 *
 * @see media_content_connect()
 */
-int media_storage_get_storage_count_from_db(filter_h filter, int *storage_count);
+int media_storage_get_storage_count_from_db(filter_h filter, int *storage_count) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0. Use @ref CAPI_SYSTEM_STORAGE_MODULE instead.
  * @brief Iterates through media storage from the media database.
  * @details This function gets all media storage handles meeting the given @a filter.
  *          The @a callback function will be invoked for every retrieved media storage.
@@ -110,9 +113,10 @@ int media_storage_get_storage_count_from_db(filter_h filter, int *storage_count)
  * @see media_content_connect()
  * @see media_storage_destroy()
  */
-int media_storage_foreach_storage_from_db(filter_h filter, media_storage_cb callback, void *user_data);
+int media_storage_foreach_storage_from_db(filter_h filter, media_storage_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0. Use media_info_get_media_count_from_db() instead.
  * @brief Gets the count of media files for the passed @a filter in the given @a storage_id from the media database.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -134,9 +138,10 @@ int media_storage_foreach_storage_from_db(filter_h filter, media_storage_cb call
  *
  * @see media_content_connect()
  */
-int media_storage_get_media_count_from_db(const char *storage_id, filter_h filter, int *media_count);
+int media_storage_get_media_count_from_db(const char *storage_id, filter_h filter, int *media_count) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0. Use media_info_foreach_media_from_db() instead.
  * @brief Iterates through the media files with an optional @a filter in the given @a storage_id from the media database.
  * @details This function gets all media files associated with the given storage and
  *          meeting desired filter option and calls @a callback for
@@ -171,9 +176,10 @@ int media_storage_get_media_count_from_db(const char *storage_id, filter_h filte
  * @see media_content_connect()
  * @see media_filter_create()
  */
-int media_storage_foreach_media_from_db(const char *storage_id, filter_h filter, media_info_cb callback, void *user_data);
+int media_storage_foreach_media_from_db(const char *storage_id, filter_h filter, media_info_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Destroys media storage handle.
  * @details The function frees all resources related to the media storage handle. This handle
  *          can no longer be used to perform any operations. New media storage handle has to
@@ -193,9 +199,10 @@ int media_storage_foreach_media_from_db(const char *storage_id, filter_h filter,
  *
  * @see media_storage_clone()
  */
-int media_storage_destroy(media_storage_h storage);
+int media_storage_destroy(media_storage_h storage) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Clones the media storage handle.
  *
  * @details This function copies the media storage handle from a source to the destination.
@@ -221,9 +228,10 @@ int media_storage_destroy(media_storage_h storage);
  * @see media_storage_foreach_storage_from_db()
  * @see media_storage_get_storage_info_from_db()
  */
-int media_storage_clone(media_storage_h *dst, media_storage_h src);
+int media_storage_clone(media_storage_h *dst, media_storage_h src) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0.
  * @brief Gets the storage id of media storage.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -239,7 +247,7 @@ int media_storage_clone(media_storage_h *dst, media_storage_h src);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int media_storage_get_id(media_storage_h storage, char **storage_id);
+int media_storage_get_id(media_storage_h storage, char **storage_id) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since 4.0.
@@ -262,6 +270,7 @@ int media_storage_get_id(media_storage_h storage, char **storage_id);
 int media_storage_get_name(media_storage_h storage, char **storage_name) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0. Use @ref CAPI_SYSTEM_STORAGE_MODULE instead.
  * @brief Gets the storage path of media storage.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -277,9 +286,10 @@ int media_storage_get_name(media_storage_h storage, char **storage_name) TIZEN_D
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int media_storage_get_path(media_storage_h storage, char **storage_path);
+int media_storage_get_path(media_storage_h storage, char **storage_path) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 5.0. Use storage_get_type_dev() instead.
  * @brief Gets the storage type of media storage.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -292,7 +302,7 @@ int media_storage_get_path(media_storage_h storage, char **storage_path);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_storage_get_type(media_storage_h storage, media_content_storage_e *storage_type);
+int media_storage_get_type(media_storage_h storage, media_content_storage_e *storage_type) TIZEN_DEPRECATED_API;
 
 /**
  * @}

diff --git a/src/media_filter.c b/src/media_filter.c
index 8972c10..29e023a 100755 (executable)
--- a/src/media_filter.c
+++ b/src/media_filter.c
@@ -1068,6 +1068,7 @@ int media_filter_set_order(filter_h filter, media_content_order_e order_type, co
 int media_filter_set_storage(filter_h filter, const char *storage_id)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_filter_set_storage() is deprecated and will be removed from next release. Use media_filter_set_condition() with MEDIA_PATH keyword instead.");
        filter_s *_filter = (filter_s*)filter;
 
        if ((_filter != NULL) && STRING_VALID(storage_id)) {
@@ -1155,6 +1156,7 @@ int media_filter_get_order(filter_h filter, media_content_order_e* order_type, c
 int media_filter_get_storage(filter_h filter, char **storage_id)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_filter_get_storage() is deprecated and will be removed from next release.");
        filter_s *_filter = (filter_s*)filter;
 
        if (_filter) {

diff --git a/src/media_folder.c b/src/media_folder.c
index 7f30650..9aecb68 100755 (executable)
--- a/src/media_folder.c
+++ b/src/media_folder.c
@@ -330,6 +330,7 @@ int media_folder_get_modified_time(media_folder_h folder, time_t* time)
 int media_folder_get_storage_type(media_folder_h folder, media_content_storage_e* storage_type)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_folder_get_storage_type() is deprecated and will be removed from next release. Use storage_get_type_dev() instead.");
        media_folder_s *_folder = (media_folder_s*)folder;
 
        if (_folder) {
@@ -346,6 +347,7 @@ int media_folder_get_storage_type(media_folder_h folder, media_content_storage_e
 int media_folder_get_storage_id(media_folder_h folder, char **storage_id)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_folder_get_storage_id() is deprecated and will be removed from next release.");
        media_folder_s *_folder = (media_folder_s*)folder;
 
        if (_folder) {

diff --git a/src/media_info.c b/src/media_info.c
index c7d298a..1a282be 100755 (executable)
--- a/src/media_info.c
+++ b/src/media_info.c
@@ -2164,6 +2164,7 @@ int media_info_get_keyword(media_info_h media, char **keyword)
 int media_info_get_storage_id(media_info_h media, char **storage_id)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_info_get_storage_id() is deprecated and will be removed from next release.");
        media_info_s *_media = (media_info_s*)media;
 
        if (_media && storage_id) {
@@ -2251,6 +2252,7 @@ int media_info_get_stitched_engine(media_info_h media, int *stitched_info)
 int media_info_get_storage_type(media_info_h media, media_content_storage_e *storage_type)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_info_get_storage_type() is deprecated and will be removed from next release. Use storage_get_type_dev() instead.");
        media_info_s *_media = (media_info_s*)media;
 
        if (_media && storage_type) {

diff --git a/src/media_storage.c b/src/media_storage.c
index 2bd57b2..edf6d2e 100755 (executable)
--- a/src/media_storage.c
+++ b/src/media_storage.c
@@ -20,6 +20,7 @@
 int media_storage_get_storage_info_from_db(const char *storage_id, media_storage_h *storage)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_storage_get_storage_info_from_db() is deprecated and will be removed from next release.");
        char select_query[DEFAULT_QUERY_SIZE] = {0, };
        sqlite3_stmt *stmt = NULL;
 
@@ -58,6 +59,7 @@ int media_storage_get_storage_info_from_db(const char *storage_id, media_storage
 int media_storage_get_storage_count_from_db(filter_h filter, int *storage_count)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_storage_get_storage_count_from_db() is deprecated and will be removed from next release.");
 
        if (storage_count) {
                ret = _media_db_get_group_count(filter, MEDIA_GROUP_STORAGE, storage_count);
@@ -72,6 +74,7 @@ int media_storage_get_storage_count_from_db(filter_h filter, int *storage_count)
 int media_storage_foreach_storage_from_db(filter_h filter, media_storage_cb callback, void *user_data)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_storage_foreach_storage_from_db() is deprecated and will be removed from next release.");
 
        if (callback != NULL) {
 #ifdef _USE_TVPD_MODE
@@ -94,6 +97,7 @@ int media_storage_foreach_storage_from_db(filter_h filter, media_storage_cb call
 int media_storage_get_media_count_from_db(const char *storage_id, filter_h filter, int *media_count)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_storage_get_media_count_from_db() is deprecated and will be removed from next release.");
 
        if (STRING_VALID(storage_id) && media_count) {
                ret = _media_db_get_group_item_count(storage_id, filter, MEDIA_GROUP_STORAGE, media_count);
@@ -108,6 +112,7 @@ int media_storage_get_media_count_from_db(const char *storage_id, filter_h filte
 int media_storage_foreach_media_from_db(const char *storage_id, filter_h filter, media_info_cb callback, void *user_data)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_storage_foreach_media_from_db() is deprecated and will be removed from next release.");
 
        if ((callback != NULL) && STRING_VALID(storage_id)) {
                ret = _media_db_get_group_item(storage_id, filter, callback, user_data, MEDIA_GROUP_STORAGE);
@@ -122,6 +127,7 @@ int media_storage_foreach_media_from_db(const char *storage_id, filter_h filter,
 int media_storage_destroy(media_storage_h storage)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_storage_destroy() is deprecated and will be removed from next release.");
        media_storage_s *_storage = (media_storage_s*)storage;
        if (_storage) {
                SAFE_FREE(_storage->storage_id);
@@ -140,6 +146,7 @@ int media_storage_destroy(media_storage_h storage)
 int media_storage_clone(media_storage_h *dst, media_storage_h src)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_storage_clone() is deprecated and will be removed from next release.");
        media_storage_s *_src = (media_storage_s*)src;
 
        if (_src != NULL) {
@@ -180,6 +187,7 @@ int media_storage_clone(media_storage_h *dst, media_storage_h src)
 int media_storage_get_id(media_storage_h storage, char **storage_id)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_storage_get_id() is deprecated and will be removed from next release.");
        media_storage_s *_storage = (media_storage_s*)storage;
 
        if (_storage && storage_id) {
@@ -218,6 +226,7 @@ int media_storage_get_name(media_storage_h storage, char **storage_name)
 int media_storage_get_path(media_storage_h storage, char **storage_path)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_storage_get_path() is deprecated and will be removed from next release.");
        media_storage_s *_storage = (media_storage_s*)storage;
 
        if (_storage && storage_path) {
@@ -240,6 +249,7 @@ int media_storage_get_path(media_storage_h storage, char **storage_path)
 int media_storage_get_type(media_storage_h storage, media_content_storage_e *storage_type)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: media_storage_get_type() is deprecated and will be removed from next release. Use storage_get_type_dev() instead.");
        media_storage_s *_storage = (media_storage_s*)storage;
 
        if (_storage && storage_type) {