gst/gsttaglist.h: Clarify some tag item docs after discussion on irc.

Original commit message from CVS:
* gst/gsttaglist.h:
Clarify some tag item docs after discussion on irc.

diff --git a/ChangeLog b/ChangeLog
index 9943e6d..e047c48 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2008-04-16  Stefan Kost  <ensonic@users.sf.net>
+
+       * gst/gsttaglist.h:
+         Clarify some tag item docs after discussion on irc.
+
 2008-04-15  Stefan Kost  <ensonic@users.sf.net>
 
        * docs/gst/gstreamer-docs.sgml:

diff --git a/common b/common
index f88ff85..3bb6edf 160000 (submodule)
--- a/common
+++ b/common
@@ -1 +1 @@
-Subproject commit f88ff852da7631ad2d0be835763da6d551a63883
+Subproject commit 3bb6edfe927d6d3020d2f2a4604f54caa61cd104

diff --git a/gst/gsttaglist.h b/gst/gsttaglist.h
index dd0c967..4957130 100644 (file)
--- a/gst/gsttaglist.h
+++ b/gst/gsttaglist.h
@@ -632,13 +632,14 @@ gboolean     gst_tag_list_get_date_index    (const GstTagList * list,
 /**
  * GST_TAG_LANGUAGE_CODE:
  *
- * Language code (ISO-639-1) (string)
+ * Language code (ISO-639-1) (string) of the content
  */
 #define GST_TAG_LANGUAGE_CODE          "language-code"
 /**
  * GST_TAG_IMAGE:
  *
- * image (buffer) (buffer caps should specify the content type)
+ * image (buffer) (buffer caps should specify the content type and preferably
+ * also set "image-type" field as #GstTagImageType)
  *
  * Since: 0.10.6
  */
@@ -646,8 +647,8 @@ gboolean     gst_tag_list_get_date_index    (const GstTagList * list,
 /**
  * GST_TAG_PREVIEW_IMAGE:
  *
- * image that is meant for preview purposes (buffer)
- * (buffer caps should specify the content type)
+ * image that is meant for preview purposes, e.g. small icon-sized version
+ * (buffer) (buffer caps should specify the content type)
  *
  * Since: 0.10.7
  */