ext/flac/: Port flactag to 0.10, add documentation for it and clean it up a bit.

Original commit message from CVS:
Based on a patch by: Jonathan Matthew <notverysmart at gmail dot com>
* ext/flac/Makefile.am:
* ext/flac/gstflac.c: (plugin_init):
* ext/flac/gstflactag.c: (gst_flac_tag_setup_interfaces),
(gst_flac_tag_base_init), (gst_flac_tag_class_init),
(gst_flac_tag_dispose), (gst_flac_tag_init),
(gst_flac_tag_sink_setcaps), (gst_flac_tag_chain),
(gst_flac_tag_change_state):
* ext/flac/gstflactag.h:
Port flactag to 0.10, add documentation for it and clean it up a bit.
Fixes bug #413841.
* docs/plugins/Makefile.am:
* docs/plugins/gst-plugins-good-plugins-docs.sgml:
* docs/plugins/gst-plugins-good-plugins-sections.txt:
* docs/plugins/gst-plugins-good-plugins.hierarchy:
* docs/plugins/gst-plugins-good-plugins.interfaces:
* docs/plugins/gst-plugins-good-plugins.prerequisites:
* docs/plugins/inspect/plugin-flac.xml:
* ext/flac/gstflacdec.c: (gst_flac_dec_base_init):
* ext/flac/gstflacdec.h:
* ext/flac/gstflacenc.c: (gst_flac_enc_base_init):
* ext/flac/gstflacenc.h:
Add flactag and flacenc to the documentation and mark
the private parts of the flacdec instance structure as private.
Also use gst_element_class_set_details_simple() in flacdec and
flacenc.

7 files changed, 204 insertions, 151 deletions

diff --git a/docs/plugins/Makefile.am b/docs/plugins/Makefile.am
index 2eebe763..b5cb41af 100644
--- a/docs/plugins/Makefile.am
+++ b/docs/plugins/Makefile.am
@@ -84,6 +84,8 @@ EXTRA_HFILES = \
 	$(top_srcdir)/ext/dv/gstdvdemux.h \
 	$(top_srcdir)/ext/esd/esdsink.h \
 	$(top_srcdir)/ext/flac/gstflacdec.h \
+	$(top_srcdir)/ext/flac/gstflacenc.h \
+	$(top_srcdir)/ext/flac/gstflactag.h \
 	$(top_srcdir)/ext/gdk_pixbuf/gstgdkpixbufsink.h \
 	$(top_srcdir)/ext/hal/gsthalaudiosink.h \
 	$(top_srcdir)/ext/hal/gsthalaudiosrc.h \
diff --git a/docs/plugins/gst-plugins-good-plugins-docs.sgml b/docs/plugins/gst-plugins-good-plugins-docs.sgml
index f54d1330..72b54c5b 100644
--- a/docs/plugins/gst-plugins-good-plugins-docs.sgml
+++ b/docs/plugins/gst-plugins-good-plugins-docs.sgml
@@ -46,6 +46,8 @@
     <xi:include href="xml/element-equalizer-nbands.xml" />
     <xi:include href="xml/element-esdsink.xml" />
     <xi:include href="xml/element-flacdec.xml" />
+    <xi:include href="xml/element-flacenc.xml" />
+    <xi:include href="xml/element-flactag.xml" />
     <xi:include href="xml/element-gamma.xml" />
     <xi:include href="xml/element-gdkpixbufsink.xml" />
     <xi:include href="xml/element-goom.xml" />
diff --git a/docs/plugins/gst-plugins-good-plugins-sections.txt b/docs/plugins/gst-plugins-good-plugins-sections.txt
index 60b3ba40..712c0c8d 100644
--- a/docs/plugins/gst-plugins-good-plugins-sections.txt
+++ b/docs/plugins/gst-plugins-good-plugins-sections.txt
@@ -539,6 +539,34 @@ LEGACY_FLAC
 </SECTION>
 
 <SECTION>
+<FILE>element-flacenc</FILE>
+<TITLE>flacenc</TITLE>
+GstFlacEnc
+<SUBSECTION Standard>
+GstFlacEncClass
+GST_TYPE_FLAC_ENC
+GST_FLAC_ENC
+GST_FLAC_ENC_CLASS
+GST_IS_FLAC_ENC
+GST_IS_FLAC_ENC_CLASS
+gst_flac_enc_get_type
+</SECTION>
+
+<SECTION>
+<FILE>element-flactag</FILE>
+<TITLE>flactag</TITLE>
+GstFlacTag
+<SUBSECTION Standard>
+GstFlacTagClass
+GST_TYPE_FLAC_TAG
+GST_FLAC_TAG
+GST_FLAC_TAG_CLASS
+GST_IS_FLAC_TAG
+GST_IS_FLAC_TAG_CLASS
+gst_flac_tag_get_type
+</SECTION>
+
+<SECTION>
 <FILE>element-gamma</FILE>
 <TITLE>gamma</TITLE>
 GstGamma
diff --git a/docs/plugins/gst-plugins-good-plugins.hierarchy b/docs/plugins/gst-plugins-good-plugins.hierarchy
index ef19bd52..78d644e3 100644
--- a/docs/plugins/gst-plugins-good-plugins.hierarchy
+++ b/docs/plugins/gst-plugins-good-plugins.hierarchy
@@ -11,34 +11,89 @@ GObject
     GstElement
       GstBin
         GstPipeline
-        GstRTSPSrc
-        GstRgVolume
-        GstAutoVideoSink
-        GstAutoAudioSink
+        GstHalAudioSink
+        GstHalAudioSrc
         GstGConfVideoSink
         GstGConfVideoSrc
         GstSwitchSink
           GstGConfAudioSink
         GstGConfAudioSrc
-        GstHalAudioSink
-        GstHalAudioSrc
-      GstAviDemux
-      GstAviMux
-      GstAviSubtitle
-      GstGoom2k1
-      GstEbmlRead
-        GstMatroskaDemux
-      GstMatroskaMux
-      GstFlxDec
+        GstAutoVideoSink
+        GstAutoAudioSink
+        GstRgVolume
+        GstRTSPSrc
+      GstPngDec
+      GstPngEnc
+      GstJpegEnc
+      GstJpegDec
+      GstSmokeEnc
+      GstSmokeDec
+      GstBaseSink
+        GstBaseAudioSink
+          GstAudioSink
+            GstEsdSink
+            GstPulseSink
+            GstOssSink
+        GstAASink
+        GstCACASink
+        GstVideoSink
+          GstGdkPixbufSink
+        GstShout2send
+        GstTest
+        GstMultiUDPSink
+          GstUDPSink
+        GstDynUDPSink
+        GstMultiFileSink
+      GstCmmlEnc
+      GstCmmlDec
+      GstWavpackParse
+      GstWavpackDec
+      GstWavpackEnc
+      GstBaseSrc
+        GstPushSrc
+          GstDV1394Src
+          GstSoupHTTPSrc
+          GstBaseAudioSrc
+            GstAudioSrc
+              GstPulseSrc
+              GstOssSrc
+          GstCddaBaseSrc
+            GstCdioCddaSrc
+          GstV4l2Src
+          GstXImageSrc
+          GstUDPSrc
+          GstMultiFileSrc
+      GstPulseMixer
+      GstFlacEnc
+      GstFlacDec
+      GstFlacTag
+      GstCairoTextOverlay
       GstBaseTransform
+        GstCairoTimeOverlay
+        GstPixbufScale
         GstVideoCrop
+        GstAudioFilter
+          GstSpectrum
+          GstIirEqualizer
+            GstIirEqualizerNBands
+            GstIirEqualizer3Bands
+            GstIirEqualizer10Bands
+          GstAudioInvert
+          GstAudioKaraoke
+          GstAudioAmplify
+          GstAudioDynamic
+          GstAudioChebLimit
+          GstAudioChebBand
+          GstAudioWSincLimit
+          GstAudioWSincBand
         GstVideoBox
+        GstLevel
         GstVideoFilter
-          GstSMPTEAlpha
           GstNavigationtest
           GstGamma
-          GstVideoFlip
           GstVideoBalance
+          GstVideoFlip
+          GstSMPTEAlpha
           GstEdgeTV
           GstAgingTV
           GstDiceTV
@@ -52,77 +107,46 @@ GObject
         GstProgressReport
         GstTagInject
         GstAudioPanorama
-        GstAudioFilter
-          GstAudioInvert
-          GstAudioKaraoke
-          GstAudioAmplify
-          GstAudioDynamic
-          GstAudioChebLimit
-          GstAudioChebBand
-          GstAudioWSincLimit
-          GstAudioWSincBand
-          GstIirEqualizer
-            GstIirEqualizerNBands
-            GstIirEqualizer3Bands
-            GstIirEqualizer10Bands
-          GstSpectrum
-        GstAlphaColor
-        GstAlpha
         GstRgAnalysis
         GstRgLimiter
-        GstLevel
-        GstPixbufScale
-        GstCairoTimeOverlay
-      GstMonoscope
-      GstAuParse
+        GstAlphaColor
+        GstAlpha
+      GstDVDemux
+      GstDVDec
+      GstGdkPixbuf
+      GstSpeexEnc
+      GstSpeexDec
+      GstTagLibMux
+        GstId3v2Mux
+        GstApev2Mux
+      GstOssMixerElement
+      GstCutter
+      GstAviDemux
+      GstAviMux
+      GstAviSubtitle
+      GstGoom2k1
+      GstALawEnc
+      GstALawDec
+      GstMuLawEnc
+      GstMuLawDec
+      GstWavEnc
+      GstWavParse
+      GstICYDemux
       GstVideoMixer
-      GstBaseSrc
-        GstPushSrc
-          GstMultiFileSrc
-          GstUDPSrc
-          GstXImageSrc
-          GstV4l2Src
-          GstBaseAudioSrc
-            GstAudioSrc
-              GstOssSrc
-              GstPulseSrc
-          GstDV1394Src
-          GstSoupHTTPSrc
-          GstCddaBaseSrc
-            GstCdioCddaSrc
-      GstBaseSink
-        GstMultiFileSink
-        GstMultiUDPSink
-          GstUDPSink
-        GstDynUDPSink
-        GstTest
-        GstBaseAudioSink
-          GstAudioSink
-            GstOssSink
-            GstPulseSink
-            GstEsdSink
-        GstAASink
-        GstVideoSink
-          GstGdkPixbufSink
-        GstCACASink
-        GstShout2send
-      GstInterleave
-      GstDeinterleave
-      GstRTPDec
-      GstSMPTE
       GstRndBufferSize
       GstEFence
+      GstFlxDec
       GstTagDemux
         GstApeDemux
         GstID3Demux
-      GstGoom
+      GstAuParse
+      GstSMPTE
       GstMultipartDemux
       GstMultipartMux
-      GstCutter
-      GstWavParse
-      GstQTDemux
+      GstInterleave
+      GstDeinterleave
+      GstRTPDepay
       GstBaseRTPDepayload
-        GstRtpXQTDepay
         GstRtpAC3Depay
         GstRTPDVDepay
         GstRTPiLBCDepay
@@ -147,12 +171,7 @@ GObject
         GstRtpTheoraDepay
         GstRtpVorbisDepay
         GstRtpVRawDepay
-      GstMuLawEnc
-      GstMuLawDec
-      GstALawEnc
-      GstALawDec
-      GstICYDemux
-      GstRTPDepay
+        GstRtpXQTDepay
       GstBaseRTPPayload
         GstRTPDVPay
         GstBaseRTPAudioPayload
@@ -177,31 +196,13 @@ GObject
         GstRtpVorbisPay
         GstRtpVRawPay
       GstAsteriskh263
-      GstWavEnc
-      GstOssMixerElement
-      GstDVDemux
-      GstDVDec
-      GstSpeexEnc
-      GstSpeexDec
-      GstCmmlEnc
-      GstCmmlDec
-      GstGdkPixbuf
-      GstWavpackParse
-      GstWavpackDec
-      GstWavpackEnc
-      GstPngDec
-      GstPngEnc
-      GstCairoTextOverlay
-      GstTagLibMux
-        GstId3v2Mux
-        GstApev2Mux
-      GstFlacEnc
-      GstFlacDec
-      GstPulseMixer
-      GstJpegEnc
-      GstJpegDec
-      GstSmokeEnc
-      GstSmokeDec
+      GstRTPDec
+      GstEbmlRead
+        GstMatroskaDemux
+      GstMatroskaMux
+      GstMonoscope
+      GstGoom
+      GstQTDemux
     GstBus
     GstTask
     GstClock
@@ -211,23 +212,21 @@ GObject
     GstRegistry
     GstRingBuffer
   GstSignalObject
-  GstColorBalanceChannel
-  GstTunerNorm
-  GstTunerChannel
-  GstMixerTrack
-    GstMixerOptions
   GstCmmlTagStream
   GstCmmlTagHead
   GstCmmlTagClip
   GdkPixbuf
+  GstTunerNorm
+  GstTunerChannel
+  GstColorBalanceChannel
 GInterface
   GTypePlugin
   GstChildProxy
   GstURIHandler
-  GstTagSetter
+  GstPropertyProbe
   GstImplementsInterface
-  GstColorBalance
+  GstMixer
+  GstTagSetter
   GstTuner
+  GstColorBalance
   GstVideoOrientation
-  GstPropertyProbe
-  GstMixer
diff --git a/docs/plugins/gst-plugins-good-plugins.interfaces b/docs/plugins/gst-plugins-good-plugins.interfaces
index 252a2a39..c431d34f 100644
--- a/docs/plugins/gst-plugins-good-plugins.interfaces
+++ b/docs/plugins/gst-plugins-good-plugins.interfaces
@@ -1,38 +1,39 @@
 GstBin GstChildProxy
 GstPipeline GstChildProxy
-GstRTSPSrc GstChildProxy GstURIHandler
-GstRgVolume GstChildProxy
-GstAutoVideoSink GstChildProxy
-GstAutoAudioSink GstChildProxy
+GstHalAudioSink GstChildProxy
+GstHalAudioSrc GstChildProxy
 GstGConfVideoSink GstChildProxy
 GstGConfVideoSrc GstChildProxy
 GstSwitchSink GstChildProxy
 GstGConfAudioSink GstChildProxy
 GstGConfAudioSrc GstChildProxy
-GstHalAudioSink GstChildProxy
-GstHalAudioSrc GstChildProxy
-GstAviMux GstTagSetter
-GstMatroskaMux GstTagSetter
-GstVideoBalance GstImplementsInterface GstColorBalance
-GstIirEqualizer GstChildProxy
-GstIirEqualizerNBands GstChildProxy
-GstIirEqualizer3Bands GstChildProxy
-GstIirEqualizer10Bands GstChildProxy
-GstVideoMixer GstChildProxy
-GstUDPSrc GstURIHandler
-GstV4l2Src GstImplementsInterface GstColorBalance GstTuner GstVideoOrientation GstPropertyProbe
-GstOssSrc GstImplementsInterface GstMixer
-GstPulseSrc GstImplementsInterface GstMixer
+GstAutoVideoSink GstChildProxy
+GstAutoAudioSink GstChildProxy
+GstRgVolume GstChildProxy
+GstRTSPSrc GstChildProxy GstURIHandler
+GstShout2send GstTagSetter
+GstUDPSink GstURIHandler
 GstDV1394Src GstURIHandler GstPropertyProbe
 GstSoupHTTPSrc GstURIHandler
+GstPulseSrc GstImplementsInterface GstMixer
+GstOssSrc GstImplementsInterface GstMixer
 GstCddaBaseSrc GstURIHandler
 GstCdioCddaSrc GstURIHandler
-GstUDPSink GstURIHandler
-GstShout2send GstTagSetter
-GstOssMixerElement GstImplementsInterface GstMixer
+GstV4l2Src GstPropertyProbe GstImplementsInterface GstTuner GstColorBalance GstVideoOrientation
+GstUDPSrc GstURIHandler
+GstPulseMixer GstPropertyProbe GstImplementsInterface GstMixer
+GstFlacEnc GstTagSetter
+GstFlacTag GstTagSetter
+GstIirEqualizer GstChildProxy
+GstIirEqualizerNBands GstChildProxy
+GstIirEqualizer3Bands GstChildProxy
+GstIirEqualizer10Bands GstChildProxy
+GstVideoBalance GstImplementsInterface GstColorBalance
 GstSpeexEnc GstTagSetter
 GstTagLibMux GstTagSetter
 GstId3v2Mux GstTagSetter
 GstApev2Mux GstTagSetter
-GstFlacEnc GstTagSetter
-GstPulseMixer GstImplementsInterface GstMixer GstPropertyProbe
+GstOssMixerElement GstImplementsInterface GstMixer
+GstAviMux GstTagSetter
+GstVideoMixer GstChildProxy
+GstMatroskaMux GstTagSetter
diff --git a/docs/plugins/gst-plugins-good-plugins.prerequisites b/docs/plugins/gst-plugins-good-plugins.prerequisites
index a33abde0..eb1fa169 100644
--- a/docs/plugins/gst-plugins-good-plugins.prerequisites
+++ b/docs/plugins/gst-plugins-good-plugins.prerequisites
@@ -1,7 +1,7 @@
 GstChildProxy GstObject
-GstTagSetter GstObject GstElement
 GstImplementsInterface GstObject GstElement
-GstColorBalance GstObject GstImplementsInterface GstElement
+GstMixer GstObject GstImplementsInterface GstElement
+GstTagSetter GstObject GstElement
 GstTuner GstObject GstImplementsInterface GstElement
+GstColorBalance GstObject GstImplementsInterface GstElement
 GstVideoOrientation GstObject GstImplementsInterface GstElement
-GstMixer GstObject GstImplementsInterface GstElement
diff --git a/docs/plugins/inspect/plugin-flac.xml b/docs/plugins/inspect/plugin-flac.xml
index 616fbb57..ab534c1e 100644
--- a/docs/plugins/inspect/plugin-flac.xml
+++ b/docs/plugins/inspect/plugin-flac.xml
@@ -3,10 +3,10 @@
   <description>The FLAC Lossless compressor Codec</description>
   <filename>../../ext/flac/.libs/libgstflac.so</filename>
   <basename>libgstflac.so</basename>
-  <version>0.10.9</version>
+  <version>0.10.9.1</version>
   <license>LGPL</license>
   <source>gst-plugins-good</source>
-  <package>GStreamer Good Plug-ins source release</package>
+  <package>GStreamer Good Plug-ins CVS/prerelease</package>
   <origin>Unknown package origin</origin>
   <elements>
     <element>
@@ -17,16 +17,16 @@
       <author>Wim Taymans &lt;wim@fluendo.com&gt;</author>
       <pads>
         <caps>
-          <name>sink</name>
-          <direction>sink</direction>
+          <name>src</name>
+          <direction>source</direction>
           <presence>always</presence>
-          <details>audio/x-flac</details>
+          <details>audio/x-raw-int, endianness=(int)1234, signed=(boolean)true, width=(int){ 8, 16, 32 }, depth=(int)[ 4, 32 ], rate=(int)[ 1, 655350 ], channels=(int)[ 1, 8 ]</details>
         </caps>
         <caps>
-          <name>src</name>
-          <direction>source</direction>
+          <name>sink</name>
+          <direction>sink</direction>
           <presence>always</presence>
-          <details>audio/x-raw-int, endianness=(int)1234, signed=(boolean)true, width=(int){ 8, 16, 32 }, depth=(int){ 8, 12, 16, 20, 24, 32 }, rate=(int)[ 8000, 96000 ], channels=(int)[ 1, 8 ]</details>
+          <details>audio/x-flac</details>
         </caps>
       </pads>
     </element>
@@ -38,6 +38,27 @@
       <author>Wim Taymans &lt;wim.taymans@chello.be&gt;</author>
       <pads>
         <caps>
+          <name>sink</name>
+          <direction>sink</direction>
+          <presence>always</presence>
+          <details>audio/x-raw-int, endianness=(int)1234, signed=(boolean)true, width=(int)8, depth=(int)8, rate=(int)[ 1, 655350 ], channels=(int)[ 1, 8 ]; audio/x-raw-int, endianness=(int)1234, signed=(boolean)true, width=(int)16, depth=(int){ 12, 16 }, rate=(int)[ 1, 655350 ], channels=(int)[ 1, 8 ]; audio/x-raw-int, endianness=(int)1234, signed=(boolean)true, width=(int)32, depth=(int){ 20, 24 }, rate=(int)[ 1, 655350 ], channels=(int)[ 1, 8 ]</details>
+        </caps>
+        <caps>
+          <name>src</name>
+          <direction>source</direction>
+          <presence>always</presence>
+          <details>audio/x-flac</details>
+        </caps>
+      </pads>
+    </element>
+    <element>
+      <name>flactag</name>
+      <longname>FLAC tagger</longname>
+      <class>Formatter/Metadata</class>
+      <description>Rewrite tags in a FLAC file</description>
+      <author>Christophe Fergeau &lt;teuf@gnome.org&gt;</author>
+      <pads>
+        <caps>
           <name>src</name>
           <direction>source</direction>
           <presence>always</presence>
@@ -47,7 +68,7 @@
           <name>sink</name>
           <direction>sink</direction>
           <presence>always</presence>
-          <details>audio/x-raw-int, endianness=(int)1234, signed=(boolean)true, width=(int)16, depth=(int)16, rate=(int)[ 8000, 96000 ], channels=(int)[ 1, 2 ]</details>
+          <details>audio/x-flac</details>
         </caps>
       </pads>
     </element>