Split libgsttag docs into multiple sections.

Original commit message from CVS:
* docs/libs/gst-plugins-base-libs-docs.sgml:
* docs/libs/gst-plugins-base-libs-sections.txt:
* gst-libs/gst/tag/gstid3tag.c:
* gst-libs/gst/tag/gstvorbistag.c:
* gst-libs/gst/tag/tags.c:
Split libgsttag docs into multiple sections.

diff --git a/ChangeLog b/ChangeLog
index 259e984..8113f93 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,14 @@
 2006-02-05  Tim-Philipp Müller  <tim at centricular dot net>
 
+       * docs/libs/gst-plugins-base-libs-docs.sgml:
+       * docs/libs/gst-plugins-base-libs-sections.txt:
+       * gst-libs/gst/tag/gstid3tag.c:
+       * gst-libs/gst/tag/gstvorbistag.c:
+       * gst-libs/gst/tag/tags.c:
+         Split libgsttag docs into multiple sections.
+
+2006-02-05  Tim-Philipp Müller  <tim at centricular dot net>
+
        * docs/libs/Makefile.am:
        * docs/libs/gst-plugins-base-libs-docs.sgml:
        * docs/libs/gst-plugins-base-libs-sections.txt:

diff --git a/docs/libs/gst-plugins-base-libs-docs.sgml b/docs/libs/gst-plugins-base-libs-docs.sgml
index c967827..95587c1 100644 (file)
--- a/docs/libs/gst-plugins-base-libs-docs.sgml
+++ b/docs/libs/gst-plugins-base-libs-docs.sgml
@@ -14,6 +14,8 @@
 <!ENTITY GstMixer SYSTEM "xml/gstmixer.xml">
 <!ENTITY GstRingBuffer SYSTEM "xml/gstringbuffer.xml">
 <!ENTITY GstTag SYSTEM "xml/gsttag.xml">
+<!ENTITY GstTagVorbis SYSTEM "xml/gsttagvorbis.xml">
+<!ENTITY GstTagID3 SYSTEM "xml/gsttagid3.xml">
 <!ENTITY GstTuner SYSTEM "xml/gsttuner.xml">
 <!ENTITY GstXOverlay SYSTEM "xml/gstxoverlay.xml">
 
@@ -76,6 +78,8 @@ This library should be linked to by getting cflags and libs from
 <filename>-lgsttag-&GST_MAJORMINOR;</filename> to the library flags.
     </para>
     &GstTag;
+    &GstTagVorbis;
+    &GstTagID3;
   </chapter>
 
   <chapter id="gstreamer-cdda">

diff --git a/docs/libs/gst-plugins-base-libs-sections.txt b/docs/libs/gst-plugins-base-libs-sections.txt
index 71fc6e8..6cb3cce 100644 (file)
--- a/docs/libs/gst-plugins-base-libs-sections.txt
+++ b/docs/libs/gst-plugins-base-libs-sections.txt
@@ -94,6 +94,18 @@ gst_ring_buffer_advance
 <SECTION>
 <FILE>gsttag</FILE>
 <INCLUDE>gst/tag/tag.h</INCLUDE>
+GST_TAG_MUSICBRAINZ_TRACKID
+GST_TAG_MUSICBRAINZ_ARTISTID
+GST_TAG_MUSICBRAINZ_ALBUMID
+GST_TAG_MUSICBRAINZ_ALBUMARTISTID
+GST_TAG_MUSICBRAINZ_TRMID
+GST_TAG_MUSICBRAINZ_SORTNAME
+gst_tag_register_musicbrainz_tags
+</SECTION>
+
+<SECTION>
+<FILE>gsttagvorbis</FILE>
+<INCLUDE>gst/tag/tag.h</INCLUDE>
 <SUBSECTION>
 gst_tag_from_vorbis_tag
 gst_tag_to_vorbis_tag
@@ -102,20 +114,17 @@ gst_tag_to_vorbis_comments
 <SUBSECTION>
 gst_tag_list_from_vorbiscomment_buffer
 gst_tag_list_to_vorbiscomment_buffer
+</SECTION>
+
+<SECTION>
+<FILE>gsttagid3</FILE>
+<INCLUDE>gst/tag/tag.h</INCLUDE>
 <SUBSECTION>
 gst_tag_id3_genre_count
 gst_tag_id3_genre_get
 gst_tag_list_new_from_id3v1
 gst_tag_from_id3_tag
 gst_tag_to_id3_tag
-<SUBSECTION>
-GST_TAG_MUSICBRAINZ_TRACKID
-GST_TAG_MUSICBRAINZ_ARTISTID
-GST_TAG_MUSICBRAINZ_ALBUMID
-GST_TAG_MUSICBRAINZ_ALBUMARTISTID
-GST_TAG_MUSICBRAINZ_TRMID
-GST_TAG_MUSICBRAINZ_SORTNAME
-gst_tag_register_musicbrainz_tags
 </SECTION>
 
 <SECTION>

diff --git a/gst-libs/gst/tag/gstid3tag.c b/gst-libs/gst/tag/gstid3tag.c
index 6ee79b0..6b72ca9 100644 (file)
--- a/gst-libs/gst/tag/gstid3tag.c
+++ b/gst-libs/gst/tag/gstid3tag.c
@@ -19,6 +19,20 @@
  * Boston, MA 02111-1307, USA.
  */
 
+/**
+ * SECTION:gsttagid3
+ * @short_description: tag mappings and support functions for plugins
+ *                     dealing with ID3v1 and ID3v2 tags
+ * @see_also: #GstTagList
+ * 
+ * <refsect2>
+ * <para>
+ * Contains various utility functions for plugins to parse or create
+ * ID3 tags and map ID3v2 identifiers to and from GStreamer identifiers.
+ * </para>
+ * </refsect2>
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/gst-libs/gst/tag/gstvorbistag.c b/gst-libs/gst/tag/gstvorbistag.c
index 3866b5a..d4847e2 100644 (file)
--- a/gst-libs/gst/tag/gstvorbistag.c
+++ b/gst-libs/gst/tag/gstvorbistag.c
@@ -19,6 +19,20 @@
  * Boston, MA 02111-1307, USA.
  */
 
+/**
+ * SECTION:gsttagvorbis
+ * @short_description: tag mappings and support functions for plugins
+ *                     dealing with vorbiscomments
+ * @see_also: #GstTagList
+ * 
+ * <refsect2>
+ * <para>
+ * Contains various utility functions for plugins to parse or create
+ * vorbiscomments and map them to and from #GstTagList<!-- -->s.
+ * </para>
+ * </refsect2>
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/gst-libs/gst/tag/tags.c b/gst-libs/gst/tag/tags.c
index c8b32d8..c624764 100644 (file)
--- a/gst-libs/gst/tag/tags.c
+++ b/gst-libs/gst/tag/tags.c
@@ -29,15 +29,14 @@
 
 /**
  * SECTION:gsttag
- * @short_description: Tag Support Library
+ * @short_description: additional tag definitions for plugins and applications
  * @see_also: #GstTagList
  * 
  * <refsect2>
  * <para>
- * Contains additional standardized GStreamer tag definitions and
- * various utility functions for plugins to parse or create different
- * types of tags. Also provides mappings from and to other tag identifiers
- * to the GStreamer tag identifier.
+ * Contains additional standardized GStreamer tag definitions for plugins
+ * and applications, and functions to register them with the GStreamer
+ * tag system.
  * </para>
  * </refsect2>
  */