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).

diff --git a/ChangeLog b/ChangeLog
index 84a7736..b9394d6 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,15 @@
 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:
          Also allow white space for names so we don't break
          backwards compatibility.

diff --git a/docs/gst/gstreamer-sections.txt b/docs/gst/gstreamer-sections.txt
index ee67957..9df1ce3 100644 (file)
--- 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 ddbd9af..eec088f 100644 (file)
--- 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 675ee79..c0586fe 100644 (file)
--- a/gst/gsttaglist.h
+++ b/gst/gsttaglist.h
@@ -345,21 +345,60 @@ 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:
  *
  * person(s) who composed the recording (string)