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

@@ -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:

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

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,

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:
  *