[grilo] core: deprecate mb-album-id metadata-key and related API

[Victor Toso <victortoso src gnome org>]

commit 608eba24fdbd652ef7369381d9ca5816fe6b87c6
Author: Victor Toso <me victortoso com>
Date:   Mon Jul 15 10:53:46 2019 +0200

    core: deprecate mb-album-id metadata-key and related API
    
    Follow up for previous commit, d6fad80 "grl-metadata-key: Add metadata
    keys for MB Release ID and MB Release Group ID" in 2019-06-14 by
    Sumaid Syed <sumaidsyed gmail com>

 src/data/grl-media.c   | 6 ++++++
 src/data/grl-media.h   | 2 ++
 src/grl-metadata-key.h | 3 ++-
 3 files changed, 10 insertions(+), 1 deletion(-)
---
diff --git a/src/data/grl-media.c b/src/data/grl-media.c
index 5b1cb6a..2ea0d6a 100644
--- a/src/data/grl-media.c
+++ b/src/data/grl-media.c
@@ -1676,6 +1676,9 @@ grl_media_set_mb_artist_id (GrlMedia *media, const gchar *mb_artist_id)
  * Set the MusicBrainz album identifier of the media
  *
  * Since: 0.3.0
+ *
+ * Deprecated: 0.3.8 in favor of more specific metadata-keys
+ * GRL_METADATA_KEY_MB_RELEASE_ID and GRL_METADATA_KEY_MB_RELEASE_GROUP_ID
  */
 void
 grl_media_set_mb_album_id (GrlMedia *media, const gchar *mb_album_id)
@@ -3017,6 +3020,9 @@ grl_media_get_bitrate (GrlMedia *media)
  * Returns: the MusicBrainz album identifier
  *
  * Since: 0.3.0
+ *
+ * Deprecated: 0.3.8 in favor of more specific metadata-keys
+ * GRL_METADATA_KEY_MB_RELEASE_ID and GRL_METADATA_KEY_MB_RELEASE_GROUP_ID
  */
 const gchar *
 grl_media_get_mb_album_id (GrlMedia *media)
diff --git a/src/data/grl-media.h b/src/data/grl-media.h
index 53a06a7..9b22bef 100644
--- a/src/data/grl-media.h
+++ b/src/data/grl-media.h
@@ -185,6 +185,7 @@ void grl_media_set_mb_recording_id (GrlMedia *media, const gchar *mb_recording_i
 
 void grl_media_set_mb_artist_id (GrlMedia *media, const gchar *mb_artist_id);
 
+G_DEPRECATED
 void grl_media_set_mb_album_id (GrlMedia *media, const gchar *mb_album_id);
 
 void grl_media_set_mb_release_id (GrlMedia *media, const gchar *mb_release_id);
@@ -352,6 +353,7 @@ gint grl_media_get_track_number (GrlMedia *media);
 
 gint grl_media_get_bitrate (GrlMedia *media);
 
+G_DEPRECATED
 const gchar *grl_media_get_mb_album_id (GrlMedia *media);
 
 const gchar *grl_media_get_mb_artist_id (GrlMedia *media);
diff --git a/src/grl-metadata-key.h b/src/grl-metadata-key.h
index 81429aa..6ee7eaf 100644
--- a/src/grl-metadata-key.h
+++ b/src/grl-metadata-key.h
@@ -116,7 +116,8 @@ typedef enum {
 #define GRL_METADATA_KEY_ORIGINAL_TITLE       49
 #define GRL_METADATA_KEY_SIZE                 50
 #define GRL_METADATA_KEY_TITLE_FROM_FILENAME  51
-#define GRL_METADATA_KEY_MB_ALBUM_ID          52
+#define GRL_METADATA_KEY_MB_ALBUM_ID          52 /* Deprecated: use GRL_METADATA_KEY_MB_RELEASE_ID
+                                                    or GRL_METADATA_KEY_MB_RELEASE_GROUP_ID */
 #define GRL_METADATA_KEY_MB_TRACK_ID          53
 #define GRL_METADATA_KEY_MB_ARTIST_ID         54
 #define GRL_METADATA_KEY_MB_RECORDING_ID      55