From 9063ed1df444a8de95e1c70ca4be7e4ce34b6e79 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim-Philipp=20M=C3=BCller?= <tim@centricular.net>
Date: Wed, 24 Oct 2007 13:13:56 +0000
Subject: [PATCH] API: add GST_TAG_ARTIST_SORTNAME

Original commit message from CVS:
* docs/gst/gstreamer-sections.txt:
* gst/gsttaglist.c:
* gst/gsttaglist.h:
API: add GST_TAG_ARTIST_SORTNAME
API: add GST_TAG_ALBUM_SORTNAME
API: add GST_TAG_TITLE_SORTNAME
Add tag variants for sorting (#414539).
---
 ChangeLog                       | 10 +++++++++
 docs/gst/gstreamer-sections.txt |  3 +++
 gst/gsttaglist.c                | 11 ++++++++++
 gst/gsttaglist.h                | 39 +++++++++++++++++++++++++++++++++
 4 files changed, 63 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index 84a7736f5b..b9394d6a4f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2007-10-24  Tim-Philipp Müller  <tim at centricular dot net>
+
+	* docs/gst/gstreamer-sections.txt:
+	* gst/gsttaglist.c:
+	* gst/gsttaglist.h:
+	  API: add GST_TAG_ARTIST_SORTNAME
+	  API: add GST_TAG_ALBUM_SORTNAME
+	  API: add GST_TAG_TITLE_SORTNAME
+	  Add tag variants for sorting (#414539).
+
 2007-10-24  Tim-Philipp Müller  <tim at centricular dot net>
 
 	* gst/gststructure.c:
diff --git a/docs/gst/gstreamer-sections.txt b/docs/gst/gstreamer-sections.txt
index ee67957340..9df1ce319a 100644
--- a/docs/gst/gstreamer-sections.txt
+++ b/docs/gst/gstreamer-sections.txt
@@ -1831,8 +1831,11 @@ GstTagForeachFunc
 GstTagMergeFunc
 
 GST_TAG_TITLE
+GST_TAG_TITLE_SORTNAME
 GST_TAG_ARTIST
+GST_TAG_ARTIST_SORTNAME
 GST_TAG_ALBUM
+GST_TAG_ALBUM_SORTNAME
 GST_TAG_DATE
 GST_TAG_GENRE
 GST_TAG_COMMENT
diff --git a/gst/gsttaglist.c b/gst/gsttaglist.c
index ddbd9afa04..eec088f232 100644
--- a/gst/gsttaglist.c
+++ b/gst/gsttaglist.c
@@ -95,15 +95,26 @@ _gst_tag_initialize (void)
   gst_tag_register (GST_TAG_TITLE, GST_TAG_FLAG_META,
       G_TYPE_STRING,
       _("title"), _("commonly used title"), gst_tag_merge_strings_with_comma);
+  gst_tag_register (GST_TAG_TITLE_SORTNAME, GST_TAG_FLAG_META,
+      G_TYPE_STRING,
+      _("title sortname"), _("commonly used title for sorting purposes"), NULL);
   gst_tag_register (GST_TAG_ARTIST, GST_TAG_FLAG_META,
       G_TYPE_STRING,
       _("artist"),
       _("person(s) responsible for the recording"),
       gst_tag_merge_strings_with_comma);
+  gst_tag_register (GST_TAG_ARTIST_SORTNAME, GST_TAG_FLAG_META,
+      G_TYPE_STRING,
+      _("artist sortname"),
+      _("person(s) responsible for the recording for sorting purposes"), NULL);
   gst_tag_register (GST_TAG_ALBUM, GST_TAG_FLAG_META,
       G_TYPE_STRING,
       _("album"),
       _("album containing this data"), gst_tag_merge_strings_with_comma);
+  gst_tag_register (GST_TAG_ALBUM_SORTNAME, GST_TAG_FLAG_META,
+      G_TYPE_STRING,
+      _("album sortname"),
+      _("album containing this data for sorting purposes"), NULL);
   gst_tag_register (GST_TAG_DATE, GST_TAG_FLAG_META, GST_TYPE_DATE,
       _("date"), _("date the data was created (as a GDate structure)"), NULL);
   gst_tag_register (GST_TAG_GENRE, GST_TAG_FLAG_META,
diff --git a/gst/gsttaglist.h b/gst/gsttaglist.h
index 675ee79423..c0586fea59 100644
--- a/gst/gsttaglist.h
+++ b/gst/gsttaglist.h
@@ -345,20 +345,59 @@ gboolean     gst_tag_list_get_date_index    (const GstTagList * list,
  * GST_TAG_TITLE:
  *
  * commonly used title (string)
+ *
+ * The title as it should be displayed, e.g. 'The Doll House'
  */
 #define GST_TAG_TITLE                  "title"
+/**
+ * GST_TAG_TITLE_SORTNAME:
+ *
+ * commonly used title, as used for sorting (string)
+ *
+ * The title as it should be sorted, e.g. 'Doll House, The'
+ *
+ * Since: 0.10.15
+ */
+#define GST_TAG_TITLE_SORTNAME         "title-sortname"
 /**
  * GST_TAG_ARTIST:
  *
  * person(s) responsible for the recording (string)
+ *
+ * The artist name as it should be displayed, e.g. 'Jimi Hendrix' or
+ * 'The Guitar Heroes'
  */
 #define GST_TAG_ARTIST                 "artist"
+/**
+ * GST_TAG_ARTIST_SORTNAME:
+ *
+ * person(s) responsible for the recording, as used for sorting (string)
+ *
+ * The artist name as it should be sorted, e.g. 'Hendrix, Jimi' or
+ * 'Guitar Heroes, The'
+ *
+ * Since: 0.10.15
+ */
+/* FIXME 0.11: change to "artist-sortname" */
+#define GST_TAG_ARTIST_SORTNAME        "musicbrainz-sortname"
 /**
  * GST_TAG_ALBUM:
  *
  * album containing this data (string)
+ *
+ * The album name as it should be displayed, e.g. 'The Jazz Guitar'
  */
 #define GST_TAG_ALBUM                  "album"
+/**
+ * GST_TAG_ALBUM_SORTNAME:
+ *
+ * album containing this data, as used for sorting (string)
+ *
+ * The album name as it should be sorted, e.g. 'Jazz Guitar, The'
+ *
+ * Since: 0.10.15
+ */
+#define GST_TAG_ALBUM_SORTNAME         "album-sortname"
 /**
  * GST_TAG_COMPOSER:
  *