API: add GST_TAG_EXTENDED_COMMENT (#350935).

Original commit message from CVS:
* docs/gst/gstreamer-sections.txt:
* gst/gsttaglist.c: (_gst_tag_initialize):
* gst/gsttaglist.h:
API: add GST_TAG_EXTENDED_COMMENT (#350935).

diff --git a/ChangeLog b/ChangeLog
index 5b367bf..d07b97b 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,12 @@
 2006-08-14  Tim-Philipp Müller  <tim at centricular dot net>
 
+       * docs/gst/gstreamer-sections.txt:
+       * gst/gsttaglist.c: (_gst_tag_initialize):
+       * gst/gsttaglist.h:
+         API: add GST_TAG_EXTENDED_COMMENT (#350935).
+
+2006-08-14  Tim-Philipp Müller  <tim at centricular dot net>
+
        * gst/gstinfo.c: (gst_debug_print_object):
          Make GST_PTR_FORMAT print messages as well.
 

diff --git a/docs/gst/gstreamer-sections.txt b/docs/gst/gstreamer-sections.txt
index ff60a00..7cd2f04 100644 (file)
--- a/docs/gst/gstreamer-sections.txt
+++ b/docs/gst/gstreamer-sections.txt
@@ -1774,6 +1774,7 @@ GST_TAG_ALBUM
 GST_TAG_DATE
 GST_TAG_GENRE
 GST_TAG_COMMENT
+GST_TAG_EXTENDED_COMMENT
 GST_TAG_TRACK_NUMBER
 GST_TAG_TRACK_COUNT
 GST_TAG_ALBUM_VOLUME_NUMBER

diff --git a/gst/gsttaglist.c b/gst/gsttaglist.c
index bcd9313..47b20f4 100644 (file)
--- a/gst/gsttaglist.c
+++ b/gst/gsttaglist.c
@@ -113,7 +113,12 @@ _gst_tag_initialize (void)
   gst_tag_register (GST_TAG_COMMENT, GST_TAG_FLAG_META,
       G_TYPE_STRING,
       _("comment"),
-      _("free text commenting the data"), gst_tag_merge_strings_with_comma);
+      _("free text commenting the data"), gst_tag_merge_use_first);
+  gst_tag_register (GST_TAG_EXTENDED_COMMENT, GST_TAG_FLAG_META,
+      G_TYPE_STRING,
+      _("extended comment"),
+      _("free text commenting the data in key=value or key[en]=comment form"),
+      gst_tag_merge_use_first);
   gst_tag_register (GST_TAG_TRACK_NUMBER, GST_TAG_FLAG_META,
       G_TYPE_UINT,
       _("track number"),

diff --git a/gst/gsttaglist.h b/gst/gsttaglist.h
index 44a6afd..a3b3d0d 100644 (file)
--- a/gst/gsttaglist.h
+++ b/gst/gsttaglist.h
@@ -315,6 +315,21 @@ gboolean        gst_tag_list_get_date_index     (const GstTagList     * list,
  */
 #define GST_TAG_COMMENT                        "comment"
 /**
+ * GST_TAG_EXTENDED_COMMENT:
+ *
+ * key/value text commenting the data (string)
+ *
+ * Must be in the form of 'key=comment' or
+ * 'key[lc]=comment' where 'lc' is an ISO-639
+ * language code.
+ *
+ * This tag is used for unknown Vorbis comment tags,
+ * unknown APE tags and certain ID3v2 comment fields.
+ *
+ * Since: 0.10.10
+ */
+#define GST_TAG_EXTENDED_COMMENT       "extended-comment"
+/**
  * GST_TAG_TRACK_NUMBER:
  *
  * track number inside a collection (unsigned integer)