docs: add new taglicense docs and clean them up

Avoid ugly docbook tags unless needed.

diff --git a/docs/libs/gst-plugins-base-libs-sections.txt b/docs/libs/gst-plugins-base-libs-sections.txt
index 42f5d78..653b3ed 100644 (file)
--- a/docs/libs/gst-plugins-base-libs-sections.txt
+++ b/docs/libs/gst-plugins-base-libs-sections.txt
@@ -1756,6 +1756,13 @@ GstTagEntryMatch
 </SECTION>
 
 <SECTION>
+<FILE>gsttaglicenses</FILE>
+<SUBSECTION Standard>
+gst_tag_license_flags_get_type
+</SECTION>
+
+
+<SECTION>
 <FILE>gsttagvorbis</FILE>
 <INCLUDE>gst/tag/tag.h</INCLUDE>
 <SUBSECTION>

diff --git a/gst-libs/gst/tag/licenses.c b/gst-libs/gst/tag/licenses.c
index 4d2c476..f765cfd 100644 (file)
--- a/gst-libs/gst/tag/licenses.c
+++ b/gst-libs/gst/tag/licenses.c
@@ -22,14 +22,10 @@
  * @short_description: utility functions for Creative Commons licenses
  * @see_also: #GstTagList
  *
- * <refsect2>
- * <para>
  * Provides information about Creative Commons media licenses, which are
  * often expressed in media files as a license URI in tags. Also useful
  * for applications creating media files, in case the user wants to license
  * the content under a Creative Commons license.
- * </para>
- * </refsect2>
  */
 
 /* FIXME: add API to check obsolete-ness / replace-by */