Update and add documentation for plugins with no deps (gst).

Link to properties. Correct titles for examples. Document a few trivial cases. Keep lists in section file and docs/plugins/Makefile.am alphabetically ordered.

docs/plugins/Makefile.am

@@ -103,6 +103,9 @@ EXTRA_HFILES = \
 	$(top_srcdir)/ext/pulse/pulsesink.h \
 	$(top_srcdir)/ext/pulse/pulsesrc.h \
 	$(top_srcdir)/ext/pulse/pulsemixer.h \
+	$(top_srcdir)/ext/wavpack/gstwavpackdec.h \
+	$(top_srcdir)/ext/wavpack/gstwavpackenc.h \
+	$(top_srcdir)/ext/wavpack/gstwavpackparse.h \
 	$(top_srcdir)/gst/alpha/gstalphacolor.h \
 	$(top_srcdir)/gst/apetag/gstapedemux.h \
 	$(top_srcdir)/gst/audiofx/audioamplify.h \
@@ -124,6 +127,7 @@ EXTRA_HFILES = \
 	$(top_srcdir)/gst/avi/gstavidemux.h \
 	$(top_srcdir)/gst/avi/gstavimux.h \
 	$(top_srcdir)/gst/avi/gstavisubtitle.h \
+	$(top_srcdir)/gst/cutter/gstcutter.h \
 	$(top_srcdir)/gst/debug/gsttaginject.h \
 	$(top_srcdir)/gst/debug/progressreport.h \
 	$(top_srcdir)/gst/equalizer/gstiirequalizer.h \
@@ -131,6 +135,11 @@ EXTRA_HFILES = \
 	$(top_srcdir)/gst/equalizer/gstiirequalizer10bands.h \
 	$(top_srcdir)/gst/equalizer/gstiirequalizernbands.h \
 	$(top_srcdir)/gst/goom/gstgoom.h \
+	$(top_srcdir)/gst/goom2k1/gstgoom.h \
+	$(top_srcdir)/gst/law/alaw-decode.h \
+	$(top_srcdir)/gst/law/alaw-encode.h \
+	$(top_srcdir)/gst/law/mulaw-decode.h \
+	$(top_srcdir)/gst/law/mulaw-encode.h \
 	$(top_srcdir)/gst/icydemux/gsticydemux.h \
 	$(top_srcdir)/gst/id3demux/gstid3demux.h \
 	$(top_srcdir)/gst/interleave/deinterleave.h \
@@ -147,13 +156,16 @@ EXTRA_HFILES = \
 	$(top_srcdir)/gst/replaygain/gstrganalysis.h \
 	$(top_srcdir)/gst/replaygain/gstrglimiter.h \
 	$(top_srcdir)/gst/replaygain/gstrgvolume.h \
+	$(top_srcdir)/gst/rtp/gstrtpjpegpay.h \
 	$(top_srcdir)/gst/rtsp/gstrtpdec.h \
 	$(top_srcdir)/gst/rtsp/gstrtspsrc.h \
 	$(top_srcdir)/gst/smpte/gstsmpte.h \
 	$(top_srcdir)/gst/smpte/gstsmptealpha.h \
 	$(top_srcdir)/gst/spectrum/gstspectrum.h \
+	$(top_srcdir)/gst/udp/gstdynudpsink.h \
 	$(top_srcdir)/gst/udp/gstmultiudpsink.h \
 	$(top_srcdir)/gst/udp/gstudpsrc.h \
+	$(top_srcdir)/gst/udp/gstudpsink.h \
 	$(top_srcdir)/gst/videocrop/gstvideocrop.h \
 	$(top_srcdir)/gst/videocrop/gstaspectratiocrop.h \
 	$(top_srcdir)/gst/videofilter/gstgamma.h \
@@ -161,10 +173,7 @@ EXTRA_HFILES = \
 	$(top_srcdir)/gst/videofilter/gstvideoflip.h \
 	$(top_srcdir)/gst/videomixer/videomixer.h \
 	$(top_srcdir)/gst/videomixer/videomixerpad.h \
-	$(top_srcdir)/sys/waveform/gstwaveformsink.h \
+	$(top_srcdir)/gst/wavenc/gstwavenc.h \
-	$(top_srcdir)/ext/wavpack/gstwavpackdec.h \
-	$(top_srcdir)/ext/wavpack/gstwavpackenc.h \
-	$(top_srcdir)/ext/wavpack/gstwavpackparse.h \
 	$(top_srcdir)/gst/wavparse/gstwavparse.h \
 	$(top_srcdir)/sys/directdraw/gstdirectdrawsink.h \
 	$(top_srcdir)/sys/directsound/gstdirectsoundsink.h \
@@ -175,6 +184,7 @@ EXTRA_HFILES = \
 	$(top_srcdir)/sys/osxaudio/gstosxaudiosink.h \
 	$(top_srcdir)/sys/osxvideo/osxvideosink.h \
 	$(top_srcdir)/sys/v4l2/gstv4l2src.h \
+	$(top_srcdir)/sys/waveform/gstwaveformsink.h \
 	$(top_srcdir)/sys/ximage/gstximagesrc.h
 
 

docs/plugins/gst-plugins-good-plugins-docs.sgml

@@ -1,6 +1,7 @@
 <?xml version="1.0"?>
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
                "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
 <!ENTITY % version-entities SYSTEM "version.entities">
 %version-entities;
 ]>
@@ -14,6 +15,8 @@
     <title>gst-plugins-good Elements</title>
     <xi:include href="xml/element-aasink.xml" />
     <xi:include href="xml/element-alphacolor.xml" />
+    <xi:include href="xml/element-alawdec.xml" />
+    <xi:include href="xml/element-alawenc.xml" />
     <xi:include href="xml/element-apedemux.xml" />
     <xi:include href="xml/element-apev2mux.xml" />
     <xi:include href="xml/element-aspectratiocrop.xml" />
@@ -40,6 +43,7 @@
     <xi:include href="xml/element-cairotimeoverlay.xml" />
     <xi:include href="xml/element-cmmldec.xml" />
     <xi:include href="xml/element-cmmlenc.xml" />
+    <xi:include href="xml/element-cutter.xml" />
     <xi:include href="xml/element-deinterleave.xml" />
     <xi:include href="xml/element-directdrawsink.xml" />
     <xi:include href="xml/element-directsoundsink.xml" />
@@ -70,6 +74,8 @@
     <xi:include href="xml/element-matroskamux.xml" />
     <xi:include href="xml/element-matroskademux.xml" />
     <xi:include href="xml/element-monoscope.xml" />
+    <xi:include href="xml/element-mulawdec.xml" />
+    <xi:include href="xml/element-mulawenc.xml" />
     <xi:include href="xml/element-multifilesink.xml" />
     <xi:include href="xml/element-multifilesrc.xml" />
     <xi:include href="xml/element-multipartdemux.xml" />
@@ -92,6 +98,7 @@
     <xi:include href="xml/element-rglimiter.xml" />
     <xi:include href="xml/element-rgvolume.xml" />
     <xi:include href="xml/element-rtpdec.xml" />
+    <xi:include href="xml/element-rtpjpegpay.xml" />
     <xi:include href="xml/element-rtspsrc.xml" />
     <xi:include href="xml/element-smokedec.xml" />
     <xi:include href="xml/element-smokeenc.xml" />
@@ -101,11 +108,14 @@
     <xi:include href="xml/element-spectrum.xml" />
     <xi:include href="xml/element-taginject.xml" />
     <xi:include href="xml/element-udpsrc.xml" />
+    <xi:include href="xml/element-udpsink.xml" />
     <xi:include href="xml/element-v4l2src.xml" />
     <xi:include href="xml/element-videobalance.xml" />
+    <xi:include href="xml/element-videobox.xml" />
     <xi:include href="xml/element-videocrop.xml" />
     <xi:include href="xml/element-videoflip.xml" />
     <xi:include href="xml/element-videomixer.xml" />
+    <xi:include href="xml/element-wavenc.xml" />
     <xi:include href="xml/element-waveformsink.xml" />
     <xi:include href="xml/element-wavpackdec.xml" />
     <xi:include href="xml/element-wavpackenc.xml" />

docs/plugins/gst-plugins-good-plugins-sections.txt

@@ -12,6 +12,33 @@ GST_IS_AASINK_CLASS
 gst_aasink_get_type
 </SECTION>
 
+<SECTION>
+<FILE>element-alawdec</FILE>
+<TITLE>alawdec</TITLE>
+GstALawDec
+<SUBSECTION Standard>
+GstALawDecClass
+GST_ALAW_DEC
+GST_IS_ALAW_DEC
+GST_TYPE_ALAW_DEC
+GST_ALAW_DEC_CLASS
+GST_IS_ALAW_DEC_CLASS
+gst_alaw_dec_get_type
+</SECTION>
+
+<FILE>element-alawenc</FILE>
+<TITLE>alawenc</TITLE>
+GstALawEnc
+<SUBSECTION Standard>
+GstALawEncClass
+GST_ALAW_ENC
+GST_IS_ALAW_ENC
+GST_TYPE_ALAW_ENC
+GST_ALAW_ENC_CLASS
+GST_IS_ALAW_ENC_CLASS
+gst_alaw_enc_get_type
+</SECTION>
+
 <SECTION>
 <FILE>element-alphacolor</FILE>
 <TITLE>alphacolor</TITLE>
@@ -103,17 +130,19 @@ gst_audio_cheb_limit_get_type
 </SECTION>
 
 <SECTION>
-<FILE>element-audioiirfilter</FILE>
+<FILE>element-audiodynamic</FILE>
-<TITLE>audioiirfilter</TITLE>
+<TITLE>audiodynamic</TITLE>
-GstAudioIIRFilter
+GstAudioDynamic
 <SUBSECTION Standard>
-GstAudioIIRFilterClass
+GstAudioDynamicClass
-GST_AUDIO_IIR_FILTER
+GstAudioDynamicProcessFunc
-GST_AUDIO_IIR_FILTER_CLASS
+GST_AUDIO_DYNAMIC
-GST_IS_AUDIO_IIR_FILTER_BAND
+GST_AUDIO_DYNAMIC_CLASS
-GST_IS_AUDIO_IIR_FILTER_CLASS
+GST_AUDIO_DYNAMIC_GET_CLASS
-GST_TYPE_AUDIO_IIR_FILTER
+GST_IS_AUDIO_DYNAMIC
-gst_audio_iir_filter_get_type
+GST_IS_AUDIO_DYNAMIC_CLASS
+GST_TYPE_AUDIO_DYNAMIC
+gst_audio_dynamic_get_type
 </SECTION>
 
 <SECTION>
@@ -133,19 +162,31 @@ gst_audio_echo_get_type
 </SECTION>
 
 <SECTION>
-<FILE>element-audiodynamic</FILE>
+<FILE>element-audiofirfilter</FILE>
-<TITLE>audiodynamic</TITLE>
+<TITLE>audiofirfilter</TITLE>
-GstAudioDynamic
+GstAudioFIRFilter
 <SUBSECTION Standard>
-GstAudioDynamicClass
+GstAudioFIRFilterClass
-GstAudioDynamicProcessFunc
+GST_AUDIO_FIR_FILTER
-GST_AUDIO_DYNAMIC
+GST_AUDIO_FIR_FILTER_CLASS
-GST_AUDIO_DYNAMIC_CLASS
+GST_IS_AUDIO_FIR_FILTER
-GST_AUDIO_DYNAMIC_GET_CLASS
+GST_IS_AUDIO_FIR_FILTER_CLASS
-GST_IS_AUDIO_DYNAMIC
+GST_TYPE_AUDIO_FIR_FILTER
-GST_IS_AUDIO_DYNAMIC_CLASS
+gst_audio_fir_filter_get_type
-GST_TYPE_AUDIO_DYNAMIC
+</SECTION>
-gst_audio_dynamic_get_type
+
+<SECTION>
+<FILE>element-audioiirfilter</FILE>
+<TITLE>audioiirfilter</TITLE>
+GstAudioIIRFilter
+<SUBSECTION Standard>
+GstAudioIIRFilterClass
+GST_AUDIO_IIR_FILTER
+GST_AUDIO_IIR_FILTER_CLASS
+GST_IS_AUDIO_IIR_FILTER
+GST_IS_AUDIO_IIR_FILTER_CLASS
+GST_TYPE_AUDIO_IIR_FILTER
+gst_audio_iir_filter_get_type
 </SECTION>
 
 <SECTION>
@@ -226,20 +267,6 @@ GST_TYPE_AUDIO_WSINC_LIMIT
 gst_audio_wsinclimit_get_type
 </SECTION>
 
-<SECTION>
-<FILE>element-audiofirfilter</FILE>
-<TITLE>audiofirfilter</TITLE>
-GstAudioFIRFilter
-<SUBSECTION Standard>
-GstAudioFIRFilterClass
-GST_AUDIO_FIR_FILTER
-GST_AUDIO_FIR_FILTER_CLASS
-GST_IS_AUDIO_FIR_FILTER_BAND
-GST_IS_AUDIO_FIR_FILTER_CLASS
-GST_TYPE_AUDIO_FIR_FILTER
-gst_audio_fir_filter_get_type
-</SECTION>
-
 <SECTION>
 <FILE>element-autoaudiosink</FILE>
 <TITLE>autoaudiosink</TITLE>
@@ -316,12 +343,8 @@ GST_IS_AVI_DEMUX_CLASS
 GST_AVI_DEMUX_MAX_STREAMS
 gst_avi_demux_get_type
 GST_AVI_INDEX_ENTRY_FLAG_KEYFRAME
-GST_AVI_INDEX_OF_CHUNKS
-GST_AVI_INDEX_OF_INDEXES
-GST_AVI_SUPERINDEX_COUNT
 avi_stream_context
 gst_avi_index_entry
-gst_avi_superindex_entry
 CHUNKID_TO_STREAMNR
 </SECTION>
 
@@ -337,6 +360,11 @@ GST_AVI_MUX_CLASS
 GST_IS_AVI_MUX
 GST_IS_AVI_MUX_CLASS
 gst_avi_mux_get_type
+GST_AVI_INDEX_OF_CHUNKS
+GST_AVI_INDEX_OF_INDEXES
+GST_AVI_SUPERINDEX_COUNT
+gst_avi_superindex_entry
+gst_riff_strh_full
 </SECTION>
 
 <SECTION>
@@ -348,6 +376,7 @@ GstAviSubtitleClass
 GST_TYPE_AVI_SUBTITLE
 GST_AVI_SUBTITLE
 GST_AVI_SUBTITLE_CLASS
+GST_AVI_SUBTITLE_GET_CLASS
 GST_IS_AVI_SUBTITLE
 GST_IS_AVI_SUBTITLE_CLASS
 gst_avi_subtitle_get_type
@@ -411,6 +440,21 @@ GST_IS_CMML_ENC_CLASS
 gst_cmml_enc_plugin_init
 </SECTION>
 
+<SECTION>
+<FILE>element-cutter</FILE>
+<TITLE>cutter</TITLE>
+GstCutter
+<SUBSECTION Standard>
+GST_CUTTER
+GST_CUTTER_CLASS
+GST_CUTTER_GET_CLASS
+GST_IS_CUTTER
+GST_IS_CUTTER_CLASS
+GST_TYPE_CUTTER
+GstCutterClass
+gst_cutter_get_type
+</SECTION>
+
 <SECTION>
 <FILE>element-deinterleave</FILE>
 <TITLE>deinterleave</TITLE>
@@ -616,6 +660,7 @@ LEGACY_FLAC
 GstFlacEnc
 <SUBSECTION Standard>
 GstFlacEncClass
+GstFlacTagState
 GST_TYPE_FLAC_ENC
 GST_FLAC_ENC
 GST_FLAC_ENC_CLASS
@@ -830,12 +875,14 @@ gst_level_get_type
 GstMatroskaMux
 <SUBSECTION Standard>
 GstMatroskaMuxClass
+GstMatroskaMuxState
 GST_TYPE_MATROSKA_MUX
 GST_MATROSKA_MUX
 GST_MATROSKA_MUX_CLASS
 GST_IS_MATROSKA_MUX
 GST_IS_MATROSKA_MUX_CLASS
 gst_matroska_mux_get_type
+gst_matroska_mux_plugin_init
 </SECTION>
 
 <SECTION>
@@ -844,12 +891,14 @@ gst_matroska_mux_get_type
 GstMatroskaDemux
 <SUBSECTION Standard>
 GstMatroskaDemuxClass
+GstMatroskaDemuxState
 GST_TYPE_MATROSKA_DEMUX
 GST_MATROSKA_DEMUX
 GST_MATROSKA_DEMUX_CLASS
 GST_IS_MATROSKA_DEMUX
 GST_IS_MATROSKA_DEMUX_CLASS
 gst_matroska_demux_get_type
+gst_matroska_demux_plugin_init
 </SECTION>
 
 <SECTION>
@@ -865,6 +914,33 @@ GST_MONOSCOPE_CLASS
 GST_IS_MONOSCOPE_CLASS
 </SECTION>
 
+<SECTION>
+<FILE>element-mulawdec</FILE>
+<TITLE>mulawdec</TITLE>
+GstMuLawDec
+<SUBSECTION Standard>
+GstMuLawDecClass
+GST_MULAWDEC
+GST_IS_MULAWDEC
+GST_TYPE_MULAWDEC
+GST_MULAWDEC_CLASS
+GST_IS_MULAWDEC_CLASS
+gst_mulawdec_get_type
+</SECTION>
+
+<FILE>element-mulawenc</FILE>
+<TITLE>mulawenc</TITLE>
+GstMuLawEnc
+<SUBSECTION Standard>
+GstMuLawEncClass
+GST_MULAWENC
+GST_IS_MULAWENC
+GST_TYPE_MULAWENC
+GST_MULAWENC_CLASS
+GST_IS_MULAWENC_CLASS
+gst_mulawenc_get_type
+</SECTION>
+
 <SECTION>
 <FILE>element-multifilesrc</FILE>
 <TITLE>multifilesrc</TITLE>
@@ -918,6 +994,7 @@ GST_MULTIPART_DEMUX
 GST_MULTIPART_DEMUX_CLASS
 GST_IS_MULTIPART_DEMUX
 GST_IS_MULTIPART_DEMUX_CLASS
+GST_MULTIPART_DEMUX_GET_CLASS
 MULTIPART_DATA_EOS
 MULTIPART_DATA_ERROR
 MULTIPART_NEED_MORE_DATA
@@ -1106,6 +1183,7 @@ GST_PROGRESS_REPORT
 GST_PROGRESS_REPORT_CLASS
 GST_IS_PROGRESS_REPORT
 GST_IS_PROGRESS_REPORT_CLASS
+gst_progress_report_get_type
 </SECTION>
 
 <SECTION>
@@ -1167,6 +1245,35 @@ GST_IS_RG_VOLUME_CLASS
 gst_rg_volume_get_type
 </SECTION>
 
+<SECTION>
+<FILE>element-rtpdec</FILE>
+<TITLE>rtpdec</TITLE>
+GstRTPDec
+<SUBSECTION Standard>
+GstRTPDecClass
+GstRTPDecSession
+GST_RTP_DEC
+GST_IS_RTP_DEC
+GST_TYPE_RTP_DEC
+GST_RTP_DEC_CLASS
+GST_IS_RTP_DEC_CLASS
+gst_rtp_dec_get_type
+</SECTION>
+
+<SECTION>
+<FILE>element-rtpjpegpay</FILE>
+<TITLE>rtpjpegpay</TITLE>
+GstRtpJPEGPay
+<SUBSECTION Standard>
+GstRtpJPEGPayClass
+GST_RTP_JPEG_PAY
+GST_IS_RTP_JPEG_PAY
+GST_TYPE_RTP_JPEG_PAY
+GST_RTP_JPEG_PAY_CLASS
+GST_IS_RTP_JPEG_PAY_CLASS
+gst_rtp_jpeg_pay_get_type
+</SECTION>
+
 <SECTION>
 <FILE>element-rtspsrc</FILE>
 <TITLE>rtspsrc</TITLE>
@@ -1177,7 +1284,6 @@ GstRTSPSrcClass
 GST_RTSPSRC
 GST_IS_RTSPSRC
 GST_TYPE_RTSPSRC
-gst_rtspsrc_get_type
 GST_RTSPSRC_CLASS
 GST_IS_RTSPSRC_CLASS
 GST_RTSPSRC_CAST
@@ -1190,21 +1296,7 @@ GST_RTSP_STATE_UNLOCK
 GST_RTSP_STREAM_GET_LOCK
 GST_RTSP_STREAM_LOCK
 GST_RTSP_STREAM_UNLOCK
-</SECTION>
+gst_rtspsrc_get_type
-
-<SECTION>
-<FILE>element-rtpdec</FILE>
-<TITLE>rtpdec</TITLE>
-GstRTPDec
-<SUBSECTION Standard>
-GstRTPDecClass
-GstRTPDecSession
-GST_RTP_DEC
-GST_IS_RTP_DEC
-GST_TYPE_RTP_DEC
-gst_rtp_dec_get_type
-GST_RTP_DEC_CLASS
-GST_IS_RTP_DEC_CLASS
 </SECTION>
 
 <SECTION>
@@ -1218,6 +1310,7 @@ GST_IS_SMPTE
 GST_TYPE_SMPTE
 GST_SMPTE_CLASS
 GST_IS_SMPTE_CLASS
+gst_smpte_plugin_init
 </SECTION>
 
 <SECTION>
@@ -1231,6 +1324,7 @@ GST_IS_SMPTE_ALPHA
 GST_TYPE_SMPTE_ALPHA
 GST_SMPTE_ALPHA_CLASS
 GST_IS_SMPTE_ALPHA_CLASS
+gst_smpte_alpha_plugin_init
 </SECTION>
 
 <SECTION>
@@ -1328,9 +1422,36 @@ GstUDPSrcClass
 GST_UDPSRC
 GST_IS_UDPSRC
 GST_TYPE_UDPSRC
-gst_udpsrc_get_type
 GST_UDPSRC_CLASS
 GST_IS_UDPSRC_CLASS
+gst_udpsrc_get_type
+</SECTION>
+
+<SECTION>
+<FILE>element-udpsink</FILE>
+<TITLE>udpsink</TITLE>
+GstUDPSink
+<SUBSECTION Standard>
+GstUDPSinkClass
+GST_UDPSINK
+GST_IS_UDPSINK
+GST_TYPE_UDPSINK
+GST_UDPSINK_CLASS
+GST_IS_UDPSINK_CLASS
+gst_udpsink_get_type
+</SECTION>
+
+<SECTION>
+<FILE>element-videobox</FILE>
+<TITLE>videobox</TITLE>
+GstVideoBox
+<SUBSECTION Standard>
+GstVideoBoxClass
+GST_IS_VIDEO_BOX
+GST_IS_VIDEO_BOX_CLASS
+GST_VIDEO_BOX
+GST_VIDEO_BOX_CLASS
+GST_TYPE_VIDEO_BOX
 </SECTION>
 
 <SECTION>
@@ -1361,6 +1482,7 @@ GST_IS_ASPECT_RATIO_CROP_CLASS
 GST_ASPECT_RATIO_CROP
 GST_ASPECT_RATIO_CROP_CLASS
 GST_TYPE_ASPECT_RATIO_CROP
+gst_aspect_ratio_crop_get_type
 </SECTION>
 
 <SECTION>
@@ -1435,9 +1557,9 @@ GstV4l2SrcClass
 GST_V4L2SRC
 GST_IS_V4L2SRC
 GST_TYPE_V4L2SRC
-gst_v4l2src_get_type
 GST_V4L2SRC_CLASS
 GST_IS_V4L2SRC_CLASS
+gst_v4l2src_get_type
 </SECTION>
 
 <SECTION>
@@ -1461,6 +1583,20 @@ BUFFER_SIZE
 ERROR_LENGTH
 </SECTION>
 
+<SECTION>
+<FILE>element-wavenc</FILE>
+<TITLE>wavenc</TITLE>
+GstWavEnc
+<SUBSECTION Standard>
+GstWavEncClass
+GST_WAVENC
+GST_IS_WAVENC
+GST_TYPE_WAVENC
+GST_WAVENC_CLASS
+GST_IS_WAVENC_CLASS
+gst_wavenc_get_type
+</SECTION>
+
 <SECTION>
 <FILE>element-wavpackdec</FILE>
 <TITLE>wavpackdec</TITLE>
@@ -1517,9 +1653,9 @@ GstWavParseState
 GST_WAVPARSE
 GST_IS_WAVPARSE
 GST_TYPE_WAVPARSE
-gst_wavparse_get_type
 GST_WAVPARSE_CLASS
 GST_IS_WAVPARSE_CLASS
+gst_wavparse_get_type
 </SECTION>
 
 <SECTION>
@@ -1531,7 +1667,7 @@ GstXImageSrcClass
 GST_XIMAGE_SRC
 GST_IS_XIMAGE_SRC
 GST_TYPE_XIMAGE_SRC
-gst_ximage_src_get_type
 GST_XIMAGE_SRC_CLASS
 GST_IS_XIMAGE_SRC_CLASS
+gst_ximage_src_get_type
 </SECTION>

docs/plugins/gst-plugins-good-plugins.args

@@ -411,7 +411,7 @@
 <ARG>
 <NAME>GstUDPSrc::sockfd</NAME>
 <TYPE>gint</TYPE>
-<RANGE>>= G_MAXULONG</RANGE>
+<RANGE>>= -1</RANGE>
 <FLAGS>rw</FLAGS>
 <NICK>Socket Handle</NICK>
 <BLURB>Socket to use for UDP reception. (-1 == allocate).</BLURB>
@@ -461,7 +461,7 @@
 <ARG>
 <NAME>GstUDPSrc::sock</NAME>
 <TYPE>gint</TYPE>
-<RANGE>>= G_MAXULONG</RANGE>
+<RANGE>>= -1</RANGE>
 <FLAGS>r</FLAGS>
 <NICK>Socket Handle</NICK>
 <BLURB>Socket currently in use for UDP reception. (-1 = no socket).</BLURB>
@@ -1671,7 +1671,7 @@
 <ARG>
 <NAME>GstTest::allowed-timestamp-deviation</NAME>
 <TYPE>gint64</TYPE>
-<RANGE>>= G_MAXULONG</RANGE>
+<RANGE>>= -1</RANGE>
 <FLAGS>rwx</FLAGS>
 <NICK>allowed timestamp deviation</NICK>
 <BLURB>allowed average difference in usec between timestamp of next buffer and expected timestamp from analyzing last buffer.</BLURB>
@@ -1681,7 +1681,7 @@
 <ARG>
 <NAME>GstTest::buffer-count</NAME>
 <TYPE>gint64</TYPE>
-<RANGE>>= G_MAXULONG</RANGE>
+<RANGE>>= -1</RANGE>
 <FLAGS>r</FLAGS>
 <NICK>buffer count</NICK>
 <BLURB>number of buffers in stream.</BLURB>
@@ -1691,7 +1691,7 @@
 <ARG>
 <NAME>GstTest::expected-buffer-count</NAME>
 <TYPE>gint64</TYPE>
-<RANGE>>= G_MAXULONG</RANGE>
+<RANGE>>= -1</RANGE>
 <FLAGS>rwx</FLAGS>
 <NICK>expected buffer count</NICK>
 <BLURB>expected number of buffers in stream.</BLURB>
@@ -1701,7 +1701,7 @@
 <ARG>
 <NAME>GstTest::expected-length</NAME>
 <TYPE>gint64</TYPE>
-<RANGE>>= G_MAXULONG</RANGE>
+<RANGE>>= -1</RANGE>
 <FLAGS>rwx</FLAGS>
 <NICK>expected length</NICK>
 <BLURB>expected length of stream.</BLURB>
@@ -1721,7 +1721,7 @@
 <ARG>
 <NAME>GstTest::length</NAME>
 <TYPE>gint64</TYPE>
-<RANGE>>= G_MAXULONG</RANGE>
+<RANGE>>= -1</RANGE>
 <FLAGS>r</FLAGS>
 <NICK>length</NICK>
 <BLURB>length of stream.</BLURB>
@@ -1741,7 +1741,7 @@
 <ARG>
 <NAME>GstTest::timestamp-deviation</NAME>
 <TYPE>gint64</TYPE>
-<RANGE>>= G_MAXULONG</RANGE>
+<RANGE>>= -1</RANGE>
 <FLAGS>r</FLAGS>
 <NICK>timestamp deviation</NICK>
 <BLURB>average difference in usec between timestamp of next buffer and expected timestamp from analyzing last buffer.</BLURB>
@@ -1811,7 +1811,7 @@
 <ARG>
 <NAME>GstBreakMyData::set-to</NAME>
 <TYPE>gint</TYPE>
-<RANGE>[G_MAXULONG,255]</RANGE>
+<RANGE>[-1,255]</RANGE>
 <FLAGS>rwx</FLAGS>
 <NICK>set-to</NICK>
 <BLURB>set changed bytes to this value (-1 means random value.</BLURB>
@@ -2131,7 +2131,7 @@
 <ARG>
 <NAME>GstDynUDPSink::sockfd</NAME>
 <TYPE>gint</TYPE>
-<RANGE>[G_MAXULONG,32767]</RANGE>
+<RANGE>[-1,32767]</RANGE>
 <FLAGS>rw</FLAGS>
 <NICK>socket handle</NICK>
 <BLURB>Socket to use for UDP sending. (-1 == allocate).</BLURB>
@@ -2201,7 +2201,7 @@
 <ARG>
 <NAME>GstMultiUDPSink::sock</NAME>
 <TYPE>gint</TYPE>
-<RANGE>>= G_MAXULONG</RANGE>
+<RANGE>>= -1</RANGE>
 <FLAGS>r</FLAGS>
 <NICK>Socket Handle</NICK>
 <BLURB>Socket currently in use for UDP sending. (-1 == no socket).</BLURB>
@@ -2211,7 +2211,7 @@
 <ARG>
 <NAME>GstMultiUDPSink::sockfd</NAME>
 <TYPE>gint</TYPE>
-<RANGE>>= G_MAXULONG</RANGE>
+<RANGE>>= -1</RANGE>
 <FLAGS>rw</FLAGS>
 <NICK>Socket Handle</NICK>
 <BLURB>Socket to use for UDP sending. (-1 == allocate).</BLURB>
@@ -2241,7 +2241,7 @@
 <ARG>
 <NAME>GstMultiUDPSink::qos-dscp</NAME>
 <TYPE>gint</TYPE>
-<RANGE>[G_MAXULONG,63]</RANGE>
+<RANGE>[-1,63]</RANGE>
 <FLAGS>rw</FLAGS>
 <NICK>QoS diff srv code point</NICK>
 <BLURB>Quality of Service, differentiated services code point (-1 default).</BLURB>
@@ -2811,7 +2811,7 @@
 <ARG>
 <NAME>GstV4l2Src::device-fd</NAME>
 <TYPE>gint</TYPE>
-<RANGE>>= G_MAXULONG</RANGE>
+<RANGE>>= -1</RANGE>
 <FLAGS>r</FLAGS>
 <NICK>File descriptor</NICK>
 <BLURB>File descriptor of the device.</BLURB>
@@ -3031,7 +3031,7 @@
 <ARG>
 <NAME>GstRndBufferSize::max</NAME>
 <TYPE>glong</TYPE>
-<RANGE>[1,G_MAXINT]</RANGE>
+<RANGE>>= 1</RANGE>
 <FLAGS>rwx</FLAGS>
 <NICK>maximum</NICK>
 <BLURB>maximum buffer size.</BLURB>
@@ -3041,7 +3041,7 @@
 <ARG>
 <NAME>GstRndBufferSize::min</NAME>
 <TYPE>glong</TYPE>
-<RANGE>[0,G_MAXINT]</RANGE>
+<RANGE>>= 0</RANGE>
 <FLAGS>rwx</FLAGS>
 <NICK>mininum</NICK>
 <BLURB>mininum buffer size.</BLURB>
@@ -3051,7 +3051,7 @@
 <ARG>
 <NAME>GstRndBufferSize::seed</NAME>
 <TYPE>gulong</TYPE>
-<RANGE><= G_MAXUINT</RANGE>
+<RANGE></RANGE>
 <FLAGS>rwx</FLAGS>
 <NICK>random number seed</NICK>
 <BLURB>seed for randomness (initialized when going from READY to PAUSED).</BLURB>

docs/plugins/gst-plugins-good-plugins.hierarchy

@@ -11,25 +11,28 @@ GObject
     GstElement
       GstBin
         GstPipeline
+        GstHalAudioSink
+        GstHalAudioSrc
         GstGConfVideoSink
         GstGConfVideoSrc
         GstSwitchSink
           GstGConfAudioSink
         GstGConfAudioSrc
-        GstHalAudioSink
-        GstHalAudioSrc
         GstAspectRatioCrop
+        GstRTSPSrc
         GstRgVolume
         GstAutoVideoSink
         GstAutoVideoSrc
         GstAutoAudioSink
         GstAutoAudioSrc
-        GstRTSPSrc
+      GstWavpackParse
+      GstWavpackDec
+      GstWavpackEnc
       GstTagLibMux
         GstId3v2Mux
         GstApev2Mux
-      GstPngDec
+      GstSpeexEnc
-      GstPngEnc
+      GstSpeexDec
       GstBaseSrc
         GstPushSrc
           GstSoupHTTPSrc
@@ -37,53 +40,42 @@ GObject
             GstAudioSrc
               GstPulseSrc
               GstOssSrc
-          GstDV1394Src
-          GstHDV1394Src
-          GstV4l2Src
           GstXImageSrc
-          GstMultiFileSrc
+          GstV4l2Src
           GstUDPSrc
+          GstMultiFileSrc
       GstBaseSink
+        GstShout2send
         GstBaseAudioSink
           GstAudioSink
-            GstEsdSink
             GstPulseSink
+            GstEsdSink
             GstOssSink
-        GstAASink
+        GstCACASink
         GstVideoSink
           GstGdkPixbufSink
-        GstCACASink
+        GstAASink
-        GstShout2send
-        GstTest
-        GstMultiFileSink
         GstMultiUDPSink
           GstUDPSink
         GstDynUDPSink
+        GstMultiFileSink
+        GstTest
       GstPulseMixer
+      GstPngDec
+      GstPngEnc
       GstJpegEnc
       GstJpegDec
       GstSmokeEnc
       GstSmokeDec
-      GstWavpackParse
-      GstWavpackDec
-      GstWavpackEnc
-      GstFlacEnc
-      GstFlacDec
-      GstFlacTag
-      GstDVDemux
-      GstDVDec
-      GstSpeexEnc
-      GstSpeexDec
       GstGdkPixbuf
       GstBaseTransform
         GstPixbufScale
         GstCairoTimeOverlay
-        GstVideoBox
         GstVideoFilter
-          GstVideoFlip
-          GstVideoBalance
           GstGamma
-          GstNavigationtest
+          GstVideoBalance
+          GstVideoFlip
+          GstSMPTEAlpha
           GstEdgeTV
           GstAgingTV
           GstDiceTV
@@ -92,10 +84,15 @@ GObject
           GstVertigoTV
           GstRevTV
           GstQuarkTV
-          GstSMPTEAlpha
+          GstNavigationtest
         GstVideoCrop
-        GstAudioPanorama
+        GstVideoBox
         GstAudioFilter
+          GstSpectrum
+          GstIirEqualizer
+            GstIirEqualizerNBands
+            GstIirEqualizer3Bands
+            GstIirEqualizer10Bands
           GstAudioInvert
           GstAudioKaraoke
           GstAudioAmplify
@@ -109,40 +106,30 @@ GObject
             GstAudioWSincBand
             GstAudioFIRFilter
           GstAudioEcho
-          GstIirEqualizer
-            GstIirEqualizerNBands
-            GstIirEqualizer3Bands
-            GstIirEqualizer10Bands
-          GstSpectrum
         GstRgAnalysis
         GstRgLimiter
+        GstLevel
         GstBreakMyData
         GstNavSeek
         GstProgressReport
         GstTagInject
+        GstAudioPanorama
         GstAlphaColor
         GstAlpha
-        GstLevel
+      GstFlacEnc
+      GstFlacDec
+      GstFlacTag
+      GstDVDemux
+      GstDVDec
+      GstCairoTextOverlay
       GstCmmlEnc
       GstCmmlDec
-      GstCairoTextOverlay
       GstOssMixerElement
-      GstMultipartDemux
+      GstWavParse
-      GstMultipartMux
-      GstFlxDec
-      GstAuParse
-      GstALawEnc
-      GstALawDec
-      GstMuLawEnc
-      GstMuLawDec
-      GstVideoMixer
-      GstRndBufferSize
-      GstEFence
-      GstTagDemux
-        GstID3Demux
-        GstApeDemux
-      GstGoom2k1
       GstWavEnc
+      GstVideoMixer
+      GstSMPTE
+      GstRTPDec
       GstRTPDepay
       GstBaseRTPDepayload
         GstRtpAC3Depay
@@ -198,21 +185,33 @@ GObject
         GstRtpVorbisPay
         GstRtpVRawPay
       GstAsteriskh263
+      GstQTDemux
+      GstMultipartDemux
+      GstMultipartMux
+      GstMonoscope
       GstEbmlRead
         GstMatroskaDemux
       GstMatroskaMux
-      GstCutter
+      GstMuLawEnc
+      GstMuLawDec
+      GstALawEnc
+      GstALawDec
+      GstInterleave
+      GstDeinterleave
+      GstTagDemux
+        GstID3Demux
+        GstApeDemux
       GstICYDemux
+      GstGoom2k1
+      GstGoom
+      GstFlxDec
+      GstRndBufferSize
+      GstEFence
+      GstCutter
       GstAviDemux
       GstAviMux
       GstAviSubtitle
-      GstRTPDec
+      GstAuParse
-      GstWavParse
-      GstQTDemux
-      GstSMPTE
-      GstInterleave
-      GstDeinterleave
-      GstGoom
     GstBus
     GstTask
     GstClock

docs/plugins/gst-plugins-good-plugins.interfaces

@@ -1,42 +1,40 @@
 GstBin GstChildProxy
 GstPipeline GstChildProxy
+GstHalAudioSink GstChildProxy
+GstHalAudioSrc GstChildProxy
 GstGConfVideoSink GstChildProxy
 GstGConfVideoSrc GstChildProxy
 GstSwitchSink GstChildProxy
 GstGConfAudioSink GstChildProxy
 GstGConfAudioSrc GstChildProxy
-GstHalAudioSink GstChildProxy
-GstHalAudioSrc GstChildProxy
 GstAspectRatioCrop GstChildProxy
+GstRTSPSrc GstChildProxy GstURIHandler
 GstRgVolume GstChildProxy
 GstAutoVideoSink GstChildProxy
 GstAutoVideoSrc GstChildProxy
 GstAutoAudioSink GstChildProxy
 GstAutoAudioSrc GstChildProxy
-GstRTSPSrc GstChildProxy GstURIHandler
 GstTagLibMux GstTagSetter
 GstId3v2Mux GstTagSetter
 GstApev2Mux GstTagSetter
+GstSpeexEnc GstTagSetter
 GstSoupHTTPSrc GstURIHandler
-GstPulseSrc GstImplementsInterface GstPropertyProbe GstMixer
+GstPulseSrc GstMixer GstImplementsInterface GstPropertyProbe
-GstOssSrc GstImplementsInterface GstMixer
+GstOssSrc GstMixer GstImplementsInterface
-GstDV1394Src GstURIHandler GstPropertyProbe
-GstHDV1394Src GstURIHandler GstPropertyProbe
 GstV4l2Src GstImplementsInterface GstPropertyProbe GstTuner GstColorBalance GstVideoOrientation
 GstUDPSrc GstURIHandler
-GstPulseSink GstImplementsInterface GstPropertyProbe
 GstShout2send GstTagSetter
+GstPulseSink GstImplementsInterface GstPropertyProbe
 GstUDPSink GstURIHandler
-GstPulseMixer GstImplementsInterface GstPropertyProbe GstMixer
+GstPulseMixer GstMixer GstImplementsInterface GstPropertyProbe
-GstFlacEnc GstTagSetter
-GstFlacTag GstTagSetter
-GstSpeexEnc GstTagSetter
 GstVideoBalance GstImplementsInterface GstColorBalance
 GstIirEqualizer GstChildProxy
 GstIirEqualizerNBands GstChildProxy
 GstIirEqualizer3Bands GstChildProxy GstPreset
 GstIirEqualizer10Bands GstChildProxy GstPreset
-GstOssMixerElement GstImplementsInterface GstMixer
+GstFlacEnc GstTagSetter
+GstFlacTag GstTagSetter
+GstOssMixerElement GstMixer GstImplementsInterface
 GstVideoMixer GstChildProxy
 GstMatroskaMux GstTagSetter
 GstAviMux GstTagSetter

docs/plugins/inspect/plugin-aasink.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>aasink</name>

docs/plugins/inspect/plugin-alaw.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>alawdec</name>

docs/plugins/inspect/plugin-alpha.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>alpha</name>

docs/plugins/inspect/plugin-alphacolor.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>alphacolor</name>

docs/plugins/inspect/plugin-annodex.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>cmmldec</name>

docs/plugins/inspect/plugin-apetag.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>apedemux</name>

docs/plugins/inspect/plugin-audiofx.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>audioamplify</name>

docs/plugins/inspect/plugin-auparse.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>auparse</name>

docs/plugins/inspect/plugin-autodetect.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>autoaudiosink</name>

docs/plugins/inspect/plugin-avi.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>avidemux</name>

docs/plugins/inspect/plugin-cacasink.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>cacasink</name>

docs/plugins/inspect/plugin-cairo.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>cairotextoverlay</name>

docs/plugins/inspect/plugin-cutter.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>cutter</name>

docs/plugins/inspect/plugin-debug.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>breakmydata</name>

docs/plugins/inspect/plugin-dv.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>dvdec</name>

docs/plugins/inspect/plugin-efence.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>efence</name>

docs/plugins/inspect/plugin-effectv.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>agingtv</name>

docs/plugins/inspect/plugin-equalizer.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>equalizer-10bands</name>

docs/plugins/inspect/plugin-esdsink.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>esdsink</name>

docs/plugins/inspect/plugin-flac.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>flacdec</name>

docs/plugins/inspect/plugin-flxdec.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>flxdec</name>

docs/plugins/inspect/plugin-gamma.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>gamma</name>

docs/plugins/inspect/plugin-gconfelements.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>gconfaudiosink</name>

docs/plugins/inspect/plugin-gdkpixbuf.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>gdkpixbufdec</name>

docs/plugins/inspect/plugin-goom.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>goom</name>

docs/plugins/inspect/plugin-goom2k1.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>goom2k1</name>

docs/plugins/inspect/plugin-halelements.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>halaudiosink</name>

docs/plugins/inspect/plugin-icydemux.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>icydemux</name>

docs/plugins/inspect/plugin-id3demux.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>id3demux</name>

docs/plugins/inspect/plugin-interleave.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>deinterleave</name>

docs/plugins/inspect/plugin-jpeg.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>jpegdec</name>

docs/plugins/inspect/plugin-level.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>level</name>

docs/plugins/inspect/plugin-matroska.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>matroskademux</name>

docs/plugins/inspect/plugin-monoscope.xml

@@ -3,11 +3,11 @@
   <description>Monoscope visualization</description>
   <filename>../../gst/monoscope/.libs/libgstmonoscope.so</filename>
   <basename>libgstmonoscope.so</basename>
-  <version>0.10.11.1</version>
+  <version>0.10.13.1</version>
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>monoscope</name>

docs/plugins/inspect/plugin-mulaw.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>mulawdec</name>

docs/plugins/inspect/plugin-multifile.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>multifilesink</name>

docs/plugins/inspect/plugin-multipart.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>multipartdemux</name>

docs/plugins/inspect/plugin-navigationtest.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>navigationtest</name>

docs/plugins/inspect/plugin-ossaudio.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>ossmixer</name>

docs/plugins/inspect/plugin-png.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>pngdec</name>

docs/plugins/inspect/plugin-pulseaudio.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>pulsemixer</name>

docs/plugins/inspect/plugin-quicktime.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>qtdemux</name>

docs/plugins/inspect/plugin-replaygain.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>rganalysis</name>

docs/plugins/inspect/plugin-rtp.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>asteriskh263</name>

docs/plugins/inspect/plugin-rtsp.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>rtpdec</name>

docs/plugins/inspect/plugin-smpte.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>smpte</name>

docs/plugins/inspect/plugin-soup.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>souphttpsrc</name>

docs/plugins/inspect/plugin-spectrum.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>spectrum</name>

docs/plugins/inspect/plugin-speex.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>speexdec</name>

docs/plugins/inspect/plugin-taglib.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>apev2mux</name>

docs/plugins/inspect/plugin-udp.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>dynudpsink</name>

docs/plugins/inspect/plugin-video4linux2.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>v4l2src</name>

docs/plugins/inspect/plugin-videobalance.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>videobalance</name>

docs/plugins/inspect/plugin-videobox.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>videobox</name>

docs/plugins/inspect/plugin-videocrop.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>aspectratiocrop</name>

docs/plugins/inspect/plugin-videoflip.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>videoflip</name>

docs/plugins/inspect/plugin-videomixer.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>videomixer</name>

docs/plugins/inspect/plugin-wavenc.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>wavenc</name>

docs/plugins/inspect/plugin-wavpack.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>wavpackdec</name>

docs/plugins/inspect/plugin-wavparse.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>wavparse</name>

docs/plugins/inspect/plugin-ximagesrc.xml

@@ -7,7 +7,7 @@
   <license>LGPL</license>
   <source>gst-plugins-good</source>
   <package>GStreamer Good Plug-ins CVS/prerelease</package>
-  <origin>Unknown package origin</origin>
+  <origin>http://gstreamer.freedesktop.org</origin>
   <elements>
     <element>
       <name>ximagesrc</name>

gst/alpha/gstalphacolor.c

@@ -20,12 +20,8 @@
 /**
  * SECTION:element-alphacolor
  *
- * <refsect2>
- * <para>
  * The alphacolor element does memory-efficient (in-place) colourspace
  * conversion from RGBA to AYUV, preserving the alpha channel.
- * </para>
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

gst/apetag/gstapedemux.c

@@ -20,33 +20,26 @@
 
 /**
  * SECTION:element-apedemux
- * @short_description: reads tag information from APE tag data blocks and
- * outputs them as GStreamer tag messages and events.
  *
- * <refsect2>
- * <para>
  * apedemux accepts data streams with APE tags at the start or at the end
  * (or both). The mime type of the data between the tag blocks is detected
  * using typefind functions, and the appropriate output mime type set on
- * outgoing buffers. 
+ * outgoing buffers.
- * </para>
+ *
- * <para>
  * The element is only able to read APE tags at the end of a stream from
  * a seekable stream, ie. when get_range mode is supported by the upstream
  * elements. If get_range operation is available, apedemux makes it available
  * downstream. This means that elements which require get_range mode, such as
  * wavparse or musepackdec, can operate on files containing APE tag
  * information.
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch -t filesrc location=file.mpc ! apedemux ! fakesink
- * </programlisting>
+ * ]| This pipeline should read any available APE tag information and output it.
- * This pipeline should read any available APE tag information and output it.
  * The contents of the file inside the APE tag regions should be detected, and
  * the appropriate mime type set on buffers produced from apedemux.
- * </para>
  * </refsect2>
  */
 #ifdef HAVE_CONFIG_H

gst/audiofx/audioamplify.c

@@ -21,19 +21,16 @@
 
 /**
  * SECTION:element-audioamplify
- * @short_description: Amplifies an audio stream with selectable clipping mode
  *
- * <refsect2>
  * Amplifies an audio stream by a given factor and allows the selection of different clipping modes.
  * The difference between the clipping modes is best evaluated by testing.
  * <title>Example launch line</title>
- * <para>
+ * <refsect2>
- * <programlisting>
+ * |[
  * gst-launch audiotestsrc wave=saw ! audioamplify amplification=1.5 ! alsasink
  * gst-launch filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audioamplify amplification=1.5 method=wrap-negative ! alsasink
  * gst-launch audiotestsrc wave=saw ! audioconvert ! audioamplify amplification=1.5 method=wrap-positive ! audioconvert ! alsasink
- * </programlisting>
+ * ]|
- * </para>
  * </refsect2>
  */
 

gst/audiofx/audiochebband.c

@@ -34,42 +34,35 @@
 
 /**
  * SECTION:element-audiochebband
- * @short_description: Chebyshev band pass and band reject filter
  *
- * <refsect2>
- * <para>
  * Attenuates all frequencies outside (bandpass) or inside (bandreject) of a frequency
  * band. The number of poles and the ripple parameter control the rolloff.
- * </para>
+ *
- * <para>
  * This element has the advantage over the windowed sinc bandpass and bandreject filter that it is
  * much faster and produces almost as good results. It's only disadvantages are the highly
  * non-linear phase and the slower rolloff compared to a windowed sinc filter with a large kernel.
- * </para>
+ *
- * <para>
  * For type 1 the ripple parameter specifies how much ripple in dB is allowed in the passband, i.e.
  * some frequencies in the passband will be amplified by that value. A higher ripple value will allow
  * a faster rolloff.
- * </para>
+ *
- * <para>
  * For type 2 the ripple parameter specifies the stopband attenuation. In the stopband the gain will
  * be at most this value. A lower ripple value will allow a faster rolloff.
- * </para>
+ *
- * <para>
  * As a special case, a Chebyshev type 1 filter with no ripple is a Butterworth filter.
- * </para>
+ *
- * <para><note>
+ * <note>
  * Be warned that a too large number of poles can produce noise. The most poles are possible with
  * a cutoff frequency at a quarter of the sampling rate.
- * </note></para>
+ * </note>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch audiotestsrc freq=1500 ! audioconvert ! audiochebband mode=band-pass lower-frequency=1000 upper-frequenc=6000 poles=4 ! audioconvert ! alsasink
  * gst-launch filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audiochebband mode=band-reject lower-frequency=1000 upper-frequency=4000 ripple=0.2 ! audioconvert ! alsasink
  * gst-launch audiotestsrc wave=white-noise ! audioconvert ! audiochebband mode=band-pass lower-frequency=1000 upper-frequency=4000 type=2 ! audioconvert ! alsasink
- * </programlisting>
+ * ]|
- * </para>
  * </refsect2>
  */
 

gst/audiofx/audiocheblimit.c

@@ -30,42 +30,35 @@
 
 /**
  * SECTION:element-audiocheblimit
- * @short_description: Chebyshev low pass and high pass filter
  *
- * <refsect2>
- * <para>
  * Attenuates all frequencies above the cutoff frequency (low-pass) or all frequencies below the
  * cutoff frequency (high-pass). The number of poles and the ripple parameter control the rolloff.
- * </para>
+ *
- * <para>
  * This element has the advantage over the windowed sinc lowpass and highpass filter that it is
  * much faster and produces almost as good results. It's only disadvantages are the highly
  * non-linear phase and the slower rolloff compared to a windowed sinc filter with a large kernel.
- * </para>
+ *
- * <para>
  * For type 1 the ripple parameter specifies how much ripple in dB is allowed in the passband, i.e.
  * some frequencies in the passband will be amplified by that value. A higher ripple value will allow
  * a faster rolloff.
- * </para>
+ *
- * <para>
  * For type 2 the ripple parameter specifies the stopband attenuation. In the stopband the gain will
  * be at most this value. A lower ripple value will allow a faster rolloff.
- * </para>
+ *
- * <para>
  * As a special case, a Chebyshev type 1 filter with no ripple is a Butterworth filter.
  * </para>
- * <para><note>
+ * <note><para>
  * Be warned that a too large number of poles can produce noise. The most poles are possible with
  * a cutoff frequency at a quarter of the sampling rate.
- * </note></para>
+ * </para></note>
- * <title>Example launch line</title>
  * <para>
- * <programlisting>
+ * <refsect2>
+ * <title>Example launch line</title>
+ * |[
  * gst-launch audiotestsrc freq=1500 ! audioconvert ! audiocheblimit mode=low-pass cutoff=1000 poles=4 ! audioconvert ! alsasink
  * gst-launch filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audiocheblimit mode=high-pass cutoff=400 ripple=0.2 ! audioconvert ! alsasink
  * gst-launch audiotestsrc wave=white-noise ! audioconvert ! audiocheblimit mode=low-pass cutoff=800 type=2 ! audioconvert ! alsasink
- * </programlisting>
+ * ]|
- * </para>
  * </refsect2>
  */
 

gst/audiofx/audiodynamic.c

@@ -20,21 +20,19 @@
 
 /**
  * SECTION:element-audiodynamic
- * @short_description: Compressor and Expander
  *
- * <refsect2>
  * This element can act as a compressor or expander. A compressor changes the
  * amplitude of all samples above a specific threshold with a specific ratio,
  * a expander does the same for all samples below a specific threshold. If
  * soft-knee mode is selected the ratio is applied smoothly.
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch audiotestsrc wave=saw ! audiodynamic characteristics=soft-knee mode=compressor threshold=0.5 rate=0.5 ! alsasink
  * gst-launch filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audiodynamic characteristics=hard-knee mode=expander threshold=0.2 rate=4.0 ! alsasink
  * gst-launch audiotestsrc wave=saw ! audioconvert ! audiodynamic ! audioconvert ! alsasink
- * </programlisting>
+ * ]|
- * </para>
  * </refsect2>
  */
 

gst/audiofx/audioecho.c

@@ -20,24 +20,22 @@
 
 /**
  * SECTION:element-audioecho
+ * @Since: 0.10.12
  *
- * <refsect2>
  * audioecho adds an echo or (simple) reverb effect to an audio stream. The echo
  * delay, intensity and the percentage of feedback can be configured.
- * <para>
+ *
  * For getting an echo effect you have to set the delay to a larger value,
  * for example 200ms and more. Everything below will result in a simple
  * reverb effect, which results in a slightly metallic sounding.
- * </para>
+ *
- * <para>
+ * <refsect2>
- * <programlisting>
+ * <title>Example launch line</title>
+ * |[
  * gst-launch filesrc location="melo1.ogg" ! audioconvert ! audioecho delay=500000000 intensity=0.6 feedback=0.4 ! audioconvert ! autoaudiosink
  * gst-launch filesrc location="melo1.ogg" ! decodebin ! audioconvert ! audioecho delay=50000000 intensity=0.6 feedback=0.4 ! audioconvert ! autoaudiosink
- * </programlisting>
+ * ]|
- * </para>
  * </refsect2>
- *
- * Since: 0.10.12
  */
 
 #ifdef HAVE_CONFIG_H

gst/audiofx/audiofirfilter.c

@@ -21,31 +21,27 @@
 
 /**
  * SECTION:element-audiofirfilter
- * @short_description: Generic audio FIR filter
  *
- * <refsect2>
- * <para>
  * audiofirfilter implements a generic audio <ulink url="http://en.wikipedia.org/wiki/Finite_impulse_response">FIR filter</ulink>. Before usage the
  * "kernel" property has to be set to the filter kernel that should be
  * used and the "latency" property has to be set to the latency (in samples)
  * that is introduced by the filter kernel. Setting a latency of n samples
  * will lead to the first n samples being dropped from the output and
  * n samples added to the end.
- * </para>
+ *
- * <para>
  * The filter kernel describes the impulse response of the filter. To
  * calculate the frequency response of the filter you have to calculate
  * the Fourier Transform of the impulse response.
- * </para>
+ *
- * <para>
  * To change the filter kernel whenever the sampling rate changes the
  * "rate-changed" signal can be used. This should be done for most
  * FIR filters as they're depending on the sampling rate.
- * </para>
+ *
+ * <refsect2>
  * <title>Example application</title>
- * <para>
+ * |[
- * <include xmlns="http://www.w3.org/2003/XInclude" href="element-firfilter-example.xml" />
+ * <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" parse="text" href="../../../../tests/examples/audiofx/firfilter-example.c" />
- * </para>
+ * ]|
  * </refsect2>
  */
 

gst/audiofx/audioiirfilter.c

@@ -21,27 +21,23 @@
 
 /**
  * SECTION:element-audioiirfilter
- * @short_description: Generic audio IIR filter
  *
- * <refsect2>
- * <para>
  * audioiirfilter implements a generic audio <ulink url="http://en.wikipedia.org/wiki/Infinite_impulse_response">IIR filter</ulink>. Before usage the
  * "a" and "b" properties have to be set to the filter coefficients that
  * should be used.
- * </para>
+ *
- * <para>
  * The filter coefficients describe the numerator and denominator of the
  * transfer function.
- * </para>
+ *
- * <para>
  * To change the filter coefficients whenever the sampling rate changes the
  * "rate-changed" signal can be used. This should be done for most
  * IIR filters as they're depending on the sampling rate.
- * </para>
+ *
+ * <refsect2>
  * <title>Example application</title>
- * <para>
+ * |[
- * <include xmlns="http://www.w3.org/2003/XInclude" href="element-iirfilter-example.xml" />
+ * <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" parse="text" href="../../../../tests/examples/audiofx/iirfilter-example.c" />
- * </para>
+ * ]|
  * </refsect2>
  */
 

gst/audiofx/audioinvert.c

@@ -21,20 +21,18 @@
 
 /**
  * SECTION:element-audioinvert
- * @short_description: Swaps upper and lower half of audio samples
  *
- * <refsect2>
  * Swaps upper and lower half of audio samples. Mixing an inverted sample on top of
  * the original with a slight delay can produce effects that sound like resonance.
  * Creating a stereo sample from a mono source, with one channel inverted produces wide-stereo sounds.
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch audiotestsrc wave=saw ! audioinvert invert=0.4 ! alsasink
  * gst-launch filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audioinvert invert=0.4 ! alsasink
  * gst-launch audiotestsrc wave=saw ! audioconvert ! audioinvert invert=0.4 ! audioconvert ! alsasink
- * </programlisting>
+ * ]|
- * </para>
  * </refsect2>
  */
 

gst/audiofx/audiokaraoke.c

@@ -20,17 +20,15 @@
 
 /**
  * SECTION:element-audiokaraoke
- * @short_description: Voice removal element
  *
- * <refsect2>
  * Remove the voice from audio by filtering the center channel.
  * This plugin is useful for karaoke applications.
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch filesrc location=song.ogg ! oggdemux ! vorbisdec ! audiokaraoke ! audioconvert ! alsasink
- * </programlisting>
+ * ]|
- * </para>
  * </refsect2>
  */
 

gst/audiofx/audiopanorama.c

@@ -21,20 +21,18 @@
 
 /**
  * SECTION:element-audiopanorama
- * @short_description: audio stereo pan effect
  *
- * <refsect2>
  * Stereo panorama effect with controllable pan position. One can choose between the default psychoacoustic panning method,
  * which keeps the same perceived loudness, and a simple panning method that just controls the volume on one channel.
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch audiotestsrc wave=saw ! audiopanorama panorama=-1.00 ! alsasink
  * gst-launch filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audiopanorama panorama=-1.00 ! alsasink
  * gst-launch audiotestsrc wave=saw ! audioconvert ! audiopanorama panorama=-1.00 ! audioconvert ! alsasink
  * gst-launch audiotestsrc wave=saw ! audioconvert ! audiopanorama method=simple panorama=-0.50 ! audioconvert ! alsasink
- * </programlisting>
+ * ]|
- * </para>
  * </refsect2>
  */
 

gst/audiofx/audiowsincband.c

@@ -30,28 +30,23 @@
 
 /**
  * SECTION:element-audiowsincband
- * @short_description: Windowed Sinc band pass and band reject filter
  *
- * <refsect2>
- * <para>
  * Attenuates all frequencies outside (bandpass) or inside (bandreject) of a frequency
  * band. The length parameter controls the rolloff, the window parameter
  * controls rolloff and stopband attenuation. The Hamming window provides a faster rolloff but a bit
  * worse stopband attenuation, the other way around for the Blackman window.
- * </para>
+ *
- * <para>
  * This element has the advantage over the Chebyshev bandpass and bandreject filter that it has
  * a much better rolloff when using a larger kernel size and almost linear phase. The only
  * disadvantage is the much slower execution time with larger kernels.
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch audiotestsrc freq=1500 ! audioconvert ! audiosincband mode=band-pass lower-frequency=3000 upper-frequency=10000 length=501 window=blackman ! audioconvert ! alsasink
  * gst-launch filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audiowsincband mode=band-reject lower-frequency=59 upper-frequency=61 length=10001 window=hamming ! audioconvert ! alsasink
  * gst-launch audiotestsrc wave=white-noise ! audioconvert ! audiowsincband mode=band-pass lower-frequency=1000 upper-frequency=2000 length=31 ! audioconvert ! alsasink
- * </programlisting>
+ * ]|
- * </para>
  * </refsect2>
  */
 

gst/audiofx/audiowsinclimit.c

@@ -30,28 +30,23 @@
 
 /**
  * SECTION:element-audiowsinclimit
- * @short_description: Windowed Sinc low pass and high pass filter
  *
- * <refsect2>
- * <para>
  * Attenuates all frequencies above the cutoff frequency (low-pass) or all frequencies below the
  * cutoff frequency (high-pass). The length parameter controls the rolloff, the window parameter
  * controls rolloff and stopband attenuation. The Hamming window provides a faster rolloff but a bit
  * worse stopband attenuation, the other way around for the Blackman window.
- * </para>
+ *
- * <para>
  * This element has the advantage over the Chebyshev lowpass and highpass filter that it has
  * a much better rolloff when using a larger kernel size and almost linear phase. The only
  * disadvantage is the much slower execution time with larger kernels.
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch audiotestsrc freq=1500 ! audioconvert ! audiowsinclimit mode=low-pass frequency=1000 length=501 ! audioconvert ! alsasink
  * gst-launch filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audiowsinclimit mode=high-pass frequency=15000 length=501 ! audioconvert ! alsasink
  * gst-launch audiotestsrc wave=white-noise ! audioconvert ! audiowsinclimit mode=low-pass frequency=1000 length=10001 window=blackman ! audioconvert ! alsasink
- * </programlisting>
+ * ]|
- * </para>
  * </refsect2>
  */
 

gst/auparse/gstauparse.c

@@ -20,13 +20,8 @@
 
 /**
  * SECTION:element-auparse
- * @short_description: .au file parser
  *
- * <refsect2>
+ * Parses .au files mostly originating from sun os based computers.
- * <para>
- * Parses .au files.
- * </para>
- * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

gst/avi/gstavidemux.c

@@ -22,24 +22,19 @@
 /**
  * SECTION:element-avidemux
  *
- * <refsect2>
- * <para>
  * Demuxes an .avi file into raw or compressed audio and/or video streams.
- * </para>
+ *
- * <para>
  * This element supports both push and pull-based scheduling, depending on the
  * capabilities of the upstream elements.
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch filesrc location=test.avi ! avidemux name=demux  demux.audio_00 ! decodebin ! audioconvert ! audioresample ! autoaudiosink   demux.video_00 ! queue ! decodebin ! ffmpegcolorspace ! videoscale ! autovideosink
- * </programlisting>
+ * ]| Play (parse and decode) an .avi file and try to output it to
- * Play (parse and decode) an .avi file and try to output it to
  * an automatically detected soundcard and videosink. If the AVI file contains
  * compressed audio or video data, this will only work if you have the
  * right decoder elements/plugins installed.
- * </para>
  * </refsect2>
  *
  * Last reviewed on 2006-12-29 (0.10.6)

gst/avi/gstavimux.c

@@ -28,42 +28,32 @@
 /**
  * SECTION:element-avimux
  *
- * <refsect2>
- * <para>
  * Muxes raw or compressed audio and/or video streams into an AVI file.
- * </para>
+ *
- * <title>Example launch line</title>
+ * <refsect2>
- * <para>
+ * <title>Example launch lines</title>
- * (write everything in one line, without the backslash characters)
+ * <para>(write everything in one line, without the backslash characters)</para>
- * <programlisting>
+ * |[
  * gst-launch-0.10 videotestsrc num-buffers=250 \
  * ! 'video/x-raw-yuv,format=(fourcc)I420,width=320,height=240,framerate=(fraction)25/1' \
  * ! queue ! mux. \
  * audiotestsrc num-buffers=440 ! audioconvert \
  * ! 'audio/x-raw-int,rate=44100,channels=2' ! queue ! mux. \
  * avimux name=mux ! filesink location=test.avi
- * </programlisting>
+ * ]| This will create an .AVI file containing an uncompressed video stream
- * This will create an .AVI file containing an uncompressed video stream
  * with a test picture and an uncompressed audio stream containing a 
  * test sound.
- * </para>
+ * |[
- * <title>Another example launch line</title>
- * <para>
- * (write everything in one line, without the backslash characters)
- * <programlisting>
  * gst-launch-0.10 videotestsrc num-buffers=250 \
  * ! 'video/x-raw-yuv,format=(fourcc)I420,width=320,height=240,framerate=(fraction)25/1' \
  * ! xvidenc ! queue ! mux. \
  * audiotestsrc num-buffers=440 ! audioconvert ! 'audio/x-raw-int,rate=44100,channels=2' \
  * ! lame ! queue ! mux. \
  * avimux name=mux ! filesink location=test.avi
- * </programlisting>
+ * ]| This will create an .AVI file containing the same test video and sound
- * This will create an .AVI file containing the same test video and sound
  * as above, only that both streams will be compressed this time. This will
  * only work if you have the necessary encoder elements installed of course.
- * </para>
  * </refsect2>
- *
  */
 
 #ifdef HAVE_CONFIG_H

gst/cutter/gstcutter.c

@@ -18,6 +18,37 @@
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
+/**
+ * SECTION:element-cutter
+ *
+ * Analyses the audio signal for periods of silence. The start and end of
+ * silence is signalled by bus messages named
+ * <classname>&quot;cutter&quot;</classname>.
+ * The message's structure contains two fields:
+ * <itemizedlist>
+ * <listitem>
+ *   <para>
+ *   #GstClockTime
+ *   <classname>&quot;timestamp&quot;</classname>:
+ *   the timestamp of the buffer that triggered the message.
+ *   </para>
+ * </listitem>
+ * <listitem>
+ *   <para>
+ *   gboolean
+ *   <classname>&quot;above&quot;</classname>:
+ *   %TRUE for begin of silence and %FALSE for end of silence.
+ *   </para>
+ * </listitem>
+ * </itemizedlist>
+ *
+ * <refsect2>
+ * <title>Example launch line</title>
+ * |[
+ * gst-launch -m filesrc location=foo.ogg ! decodebin ! audioconvert ! cutter ! autoaudiosink
+ * ]| Show cut messages.
+ * </refsect2>
+ */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"
@@ -82,7 +113,7 @@ static void gst_cutter_get_property (GObject * object, guint prop_id,
 
 static GstFlowReturn gst_cutter_chain (GstPad * pad, GstBuffer * buffer);
 
-void gst_cutter_get_caps (GstPad * pad, GstCutter * filter);
+static gboolean gst_cutter_get_caps (GstPad * pad, GstCutter * filter);
 
 static void
 gst_cutter_base_init (gpointer g_class)
@@ -224,8 +255,10 @@ gst_cutter_chain (GstPad * pad, GstBuffer * buf)
   g_return_val_if_fail (filter != NULL, GST_FLOW_ERROR);
   g_return_val_if_fail (GST_IS_CUTTER (filter), GST_FLOW_ERROR);
 
-  if (!filter->have_caps)
+  if (!filter->have_caps) {
-    gst_cutter_get_caps (pad, filter);
+    if (!(gst_cutter_get_caps (pad, filter)))
+      return GST_FLOW_NOT_NEGOTIATED;
+  }
 
   in_data = (gint16 *) GST_BUFFER_DATA (buf);
   GST_LOG_OBJECT (filter, "length of prerec buffer: %" GST_TIME_FORMAT,
@@ -257,12 +290,12 @@ gst_cutter_chain (GstPad * pad, GstBuffer * buf)
    */
   GST_LOG_OBJECT (filter, "buffer stats: NMS %f, RMS %f, audio length %f", NMS,
       RMS,
-      gst_guint64_to_gdouble (gst_audio_duration_from_pad_buffer (filter->
+      gst_guint64_to_gdouble (gst_audio_duration_from_pad_buffer
-              sinkpad, buf)));
+          (filter->sinkpad, buf)));
   if (RMS < filter->threshold_level)
     filter->silent_run_length +=
-        gst_guint64_to_gdouble (gst_audio_duration_from_pad_buffer (filter->
+        gst_guint64_to_gdouble (gst_audio_duration_from_pad_buffer
-            sinkpad, buf));
+        (filter->sinkpad, buf));
   else {
     filter->silent_run_length = 0 * GST_SECOND;
     filter->silent = FALSE;
@@ -306,15 +339,15 @@ gst_cutter_chain (GstPad * pad, GstBuffer * buf)
   if (filter->silent) {
     filter->pre_buffer = g_list_append (filter->pre_buffer, buf);
     filter->pre_run_length +=
-        gst_guint64_to_gdouble (gst_audio_duration_from_pad_buffer (filter->
+        gst_guint64_to_gdouble (gst_audio_duration_from_pad_buffer
-            sinkpad, buf));
+        (filter->sinkpad, buf));
     while (filter->pre_run_length > filter->pre_length) {
       prebuf = (g_list_first (filter->pre_buffer))->data;
       g_assert (GST_IS_BUFFER (prebuf));
       filter->pre_buffer = g_list_remove (filter->pre_buffer, prebuf);
       filter->pre_run_length -=
-          gst_guint64_to_gdouble (gst_audio_duration_from_pad_buffer (filter->
+          gst_guint64_to_gdouble (gst_audio_duration_from_pad_buffer
-              sinkpad, prebuf));
+          (filter->sinkpad, prebuf));
       /* only pass buffers if we don't leak */
       if (!filter->leaky)
         gst_pad_push (filter->srcpad, prebuf);
@@ -327,6 +360,28 @@ gst_cutter_chain (GstPad * pad, GstBuffer * buf)
   return GST_FLOW_OK;
 }
 
+
+static gboolean
+gst_cutter_get_caps (GstPad * pad, GstCutter * filter)
+{
+  GstCaps *caps;
+  GstStructure *structure;
+
+  caps = gst_pad_get_caps (pad);
+  if (!caps) {
+    GST_INFO ("no caps on pad %s:%s", GST_DEBUG_PAD_NAME (pad));
+    return FALSE;
+  }
+  structure = gst_caps_get_structure (caps, 0);
+  gst_structure_get_int (structure, "width", &filter->width);
+  filter->max_sample = 1 << (filter->width - 1);        /* signed */
+  filter->have_caps = TRUE;
+
+  gst_caps_unref (caps);
+  return TRUE;
+}
+
+
 static void
 gst_cutter_set_property (GObject * object, guint prop_id,
     const GValue * value, GParamSpec * pspec)
@@ -414,21 +469,3 @@ GST_PLUGIN_DEFINE (GST_VERSION_MAJOR,
     "cutter",
     "Audio Cutter to split audio into non-silent bits",
     plugin_init, VERSION, "LGPL", GST_PACKAGE_NAME, GST_PACKAGE_ORIGIN);
-
-
-void
-gst_cutter_get_caps (GstPad * pad, GstCutter * filter)
-{
-  GstCaps *caps;
-  GstStructure *structure;
-
-  caps = gst_pad_get_caps (pad);
-  /* FIXME : Please change this to a better warning method ! */
-  g_assert (caps != NULL);
-  structure = gst_caps_get_structure (caps, 0);
-  gst_structure_get_int (structure, "width", &filter->width);
-  filter->max_sample = 1 << (filter->width - 1);        /* signed */
-  filter->have_caps = TRUE;
-
-  gst_caps_unref (caps);
-}

gst/debug/gstpushfilesrc.c

@@ -19,26 +19,21 @@
 
 /**
  * SECTION:element-pushfilesrc
- * @short_description: Works like a filesrc, but only push-based (for debugging)
  * @see_also: filesrc
  *
- * <refsect2>
- * <para>
  * This element is only useful for debugging purposes. It implements an URI
  * protocol handler for the 'pushfile' protocol and behaves like a file source
  * element that cannot be activated in pull-mode. This makes it very easy to
  * debug demuxers or decoders that can operate both pull and push-based in
  * connection with the playbin element (which creates a source based on the
  * URI passed).
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch -m playbin uri=pushfile:///home/you/some/file.ogg
- * </programlisting>
+ * ]| This plays back the given file using playbin, with the demuxer operating
- * This plays back the given file using playbin, with the demuxer operating
  * push-based.
- * </para>
  * </refsect2>
  */
 
@@ -156,6 +151,7 @@ gst_push_file_src_uri_get_type (void)
 {
   return GST_URI_SRC;
 }
+
 static gchar **
 gst_push_file_src_uri_get_protocols (void)
 {
@@ -163,6 +159,7 @@ gst_push_file_src_uri_get_protocols (void)
 
   return protocols;
 }
+
 static const gchar *
 gst_push_file_src_uri_get_uri (GstURIHandler * handler)
 {

gst/debug/gsttaginject.c

@@ -23,12 +23,16 @@
  *
  * Element that injects new metadata tags, but passes incomming data through
  * unmodified.
+ *
+ * <refsect2>
+ * <title>Example launch lines</title>
  * |[
  * gst-launch audiotestsrc num-buffers=100 ! taginject tags="title=testsrc,artist=gstreamer" ! vorbisenc ! oggmux ! filesink location=test.ogg
  * ]| set title and artist
  * |[
  * gst-launch audiotestsrc num-buffers=100 ! taginject tags="keywords=\"testone,audio\",title=\"audio testtone\"" ! vorbisenc ! oggmux ! filesink location=test.ogg
  * ]| set keywords and title demonstrating quoting of special chars
+ * </refsect2>
  */
 
 #ifdef HAVE_CONFIG_H

gst/debug/progressreport.c

@@ -22,32 +22,26 @@
 
 /**
  * SECTION:element-progressreport
- * @short_description: Reports progress
- * @see_also:
  *
- * <refsect2>
- * <para>
  * The progressreport element can be put into a pipeline to report progress,
  * which is done by doing upstream duration and position queries in regular
  * (real-time) intervals. Both the interval and the prefered query format
- * can be specified via the "update-freq" and the "format" property.
+ * can be specified via the #GstProgressReport:update-freq and the
- * </para>
+ * #GstProgressReport:format property.
- * <para>
+ *
  * Element messages containing a "progress" structure are posted on the bus
  * whenever progress has been queried (since gst-plugins-good 0.10.6 only).
- * </para>
+ *
- * <para>
  * Since the element was originally designed for debugging purposes, it will
  * by default also print information about the current progress to the
- * terminal. This can be prevented by setting the "silent" property to TRUE.
+ * terminal. This can be prevented by setting the #GstProgressReport:silent
- * </para>
+ * property to %TRUE.
- * <para>
+ *
  * This element is most useful in transcoding pipelines or other situations
  * where just querying the pipeline might not lead to the wanted result. For
  * progress in TIME format, the element is best placed in a 'raw stream'
  * section of the pipeline (or after any demuxers/decoders/parsers).
- * </para>
+ *
- * <para>
  * Three more things should be pointed out: firstly, the element will only
  * query progress when data flow happens. If data flow is stalled for some
  * reason, no progress messages will be posted. Secondly, there are other
@@ -58,20 +52,15 @@
  * take action when they receive an EOS message (since the progress reported
  * is in reference to an internal point of a pipeline and not the pipeline as
  * a whole).
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch -m filesrc location=foo.ogg ! decodebin ! progressreport update-freq=1 ! audioconvert ! audioresample ! autoaudiosink
- * </programlisting>
+ * ]| This shows a progress query where a duration is available.
- * This shows a progress query where a duration is available.
+ * |[
- * </para>
- * <para>
- * <programlisting>
  * gst-launch -m audiotestsrc ! progressreport update-freq=1 ! audioconvert ! autoaudiosink
- * </programlisting>
+ * ]| This shows a progress query where no duration is available.
- * This shows a progress query where no duration is available.
- * </para>
  * </refsect2>
  */
 

gst/equalizer/gstiirequalizer10bands.c

@@ -19,20 +19,15 @@
 
 /**
  * SECTION:element-equalizer-10bands
- * @short_description: 10-band equalizer
  *
- * <refsect2>
- * <para>
  * The 10 band equalizer element allows to change the gain of 10 equally distributed
  * frequency bands between 30 Hz and 15 kHz.
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch filesrc location=song.ogg ! oggdemux ! vorbisdec ! audioconvert ! equalizer-10bands band2=3.0 ! alsasink
- * </programlisting>
+ * ]| This raises the volume of the 3rd band which is at 119 Hz by 3 db.
- * This raises the volume of the 3rd band which is at 119 Hz by 3 db.
- * </para>
  * </refsect2>
  */
 

gst/equalizer/gstiirequalizer3bands.c

@@ -19,20 +19,15 @@
 
 /**
  * SECTION:element-equalizer-3bands
- * @short_description: 3-band equalizer
  *
- * <refsect2>
- * <para>
  * The 3-band equalizer element allows to change the gain of a low frequency,
  * medium frequency and high frequency band.
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch filesrc location=song.ogg ! oggdemux ! vorbisdec ! audioconvert ! equalizer-3bands band1=6.0 ! alsasink
- * </programlisting>
+ * ]| This raises the volume of the 2nd band, which is at 1110 Hz, by 6 db.
- * This raises the volume of the 2nd band, which is at 1110 Hz, by 6 db.
- * </para>
  * </refsect2>
  */
 

gst/equalizer/gstiirequalizernbands.c

@@ -20,67 +20,59 @@
 
 /**
  * SECTION:element-equalizer-nbands
- * @short_description: Fully parametric N-band equalizer
  *
- * <refsect2>
- * <para>
  * The n-band equalizer element is a fully parametric equalizer. It allows to
  * select between 1 and 64 bands and has properties on each band to change
  * the center frequency, band width and gain.
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch filesrc location=song.ogg ! oggdemux ! vorbisdec ! audioconvert ! equalizer-nbands num-bands=15 band5::gain=6.0 ! alsasink
- * </programlisting>
+ * ]| This make the equalizer use 15 bands and raises the volume of the 5th band by 6 db.
- * This make the equalizer use 15 bands and raises the volume of the 5th band by 6 db.
+ * </refsect2>
- * </para>
+ * <refsect2>
  * <title>Example code</title>
- * <para>
+ * |[
- * <programlisting>
+ * #include &lt;gst/gst.h&gt;
-
+ * 
-#include &lt;gst/gst.h&gt;
+ * ...
-
+ * typedef struct {
-...
+ *   gfloat freq;
-typedef struct {
+ *   gfloat width;
-  gfloat freq;
+ *   gfloat gain;
-  gfloat width;
+ * } GstEqualizerBandState;
-  gfloat gain;
+ * 
-} GstEqualizerBandState;
+ * ...
-
+ * 
-...
+ *   GstElement *equalizer;
-
+ *   GstObject *band;
-  GstElement *equalizer;
+ *   gint i;
-  GstObject *band;
+ *   GstEqualizerBandState state[] = {
-  gint i;
+ *     { 120.0,   50.0, - 3.0},
-  GstEqualizerBandState state[] = {
+ *     { 500.0,   20.0,  12.0},
-    { 120.0,   50.0, - 3.0},
+ *     {1503.0,    2.0, -20.0},
-    { 500.0,   20.0,  12.0},
+ *     {6000.0, 1000.0,   6.0},
-    {1503.0,    2.0, -20.0},
+ *     {3000.0,  120.0,   2.0}
-    {6000.0, 1000.0,   6.0},
+ *   };
-    {3000.0,  120.0,   2.0}
+ * 
-  };
+ * ...
-
+ * 
-...
+ *   equalizer = gst_element_factory_make ("equalizer-nbands", "equalizer");
-
+ *   g_object_set (G_OBJECT (equalizer), "num-bands", 5, NULL);
-
+ * 
-  equalizer = gst_element_factory_make ("equalizer-nbands", "equalizer");
+ * ...
-  g_object_set (G_OBJECT (equalizer), "num-bands", 5, NULL);
+ * 
-
+ *   for (i = 0; i &lt; 5; i++) {
-...
+ *     band = gst_child_proxy_get_child_by_index (GST_CHILD_PROXY (equalizer), i);
-
+ *     g_object_set (G_OBJECT (band), "freq", state[i].freq,
-  for (i = 0; i &lt; 5; i++) {
+ *         "bandwidth", state[i].width,
-    band = gst_child_proxy_get_child_by_index (GST_CHILD_PROXY (equalizer), i);
+ * 	"gain", state[i].gain);
-    g_object_set (G_OBJECT (band), "freq", state[i].freq,
+ *     g_object_unref (G_OBJECT (band));
-        "bandwidth", state[i].width,
+ *   }
-	"gain", state[i].gain);
+ * 
-    g_object_unref (G_OBJECT (band));
+ * ...
-  }
+ * ]|
-
-...
-
- * </programlisting>
- * </para>
  * </refsect2>
  */
 

gst/flx/gstflxdec.c

@@ -19,10 +19,7 @@
 /**
  * SECTION:element-flxdec
  *
- * <refsect2>
- * <para>
  * This element decodes fli/flc/flx-video into raw video
- * </refsect2>
  */
 /*
  * http://www.coolutils.com/Formats/FLI

gst/goom/gstgoom.c

@@ -22,17 +22,14 @@
  * SECTION:element-goom
  * @see_also: synaesthesia
  *
- * <refsect2>
- * <para>
  * Goom is an audio visualisation element. It creates warping structures
  * based on the incoming audio signal.
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch -v audiotestsrc ! goom ! ffmpegcolorspace ! xvimagesink
- * </programlisting>
+ * ]|
- * </para>
  * </refsect2>
  */
 

gst/goom2k1/gstgoom.c

@@ -22,18 +22,15 @@
  * SECTION:element-goom2k1
  * @see_also: goom, synaesthesia
  *
- * <refsect2>
- * <para>
  * Goom2k1 is an audio visualisation element. It creates warping structures
  * based on the incomming audio signal. Goom2k1 is the older version of the
  * visualisation. Also available is goom2k4, with a different look.
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch -v audiotestsrc ! goom2k1 ! ffmpegcolorspace ! xvimagesink
- * </programlisting>
+ * ]|
- * </para>
  * </refsect2>
  */
 

gst/icydemux/gsticydemux.c

@@ -21,27 +21,21 @@
 
 /**
  * SECTION:element-icydemux
- * @short_description: reads tag information from an Icy (Icecast/Shoutcast) 
- * stream, outputting them as tag messages, and forwarding the enclosed data.
  *
- * <refsect2>
- * <para>
  * icydemux accepts data streams with ICY metadata at known intervals, as
  * transmitted from an upstream element (usually read as response headers from
  * an HTTP stream). The mime type of the data between the tag blocks is
  * detected using typefind functions, and the appropriate output mime type set
  * on outgoing buffers. 
- * </para>
+ *
+ * <refsect2>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch souphttpsrc location=http://some.server/ iradio-mode=true ! icydemux ! fakesink -t
- * </programlisting>
+ * ]| This pipeline should read any available ICY tag information and output it.
- * This pipeline should read any available ICY tag information and output it.
  * The contents of the stream should be detected, and the appropriate mime
  * type set on buffers produced from icydemux. (Using gnomevfssrc, neonhttpsrc
  * or giosrc instead of souphttpsrc should also work.)
- * </para>
  * </refsect2>
  */
 #ifdef HAVE_CONFIG_H

gst/id3demux/gstid3demux.c

@@ -21,23 +21,28 @@
 
 /**
  * SECTION:element-id3demux
- * @short_description: reads tag information from ID3v1 and ID3v2 (<= 2.4.0) data blocks and outputs them as GStreamer tag messages and events.
+ *
+ * id3demux accepts data streams with either (or both) ID3v2 regions at the
+ * start, or ID3v1 at the end. The mime type of the data between the tag blocks
+ * is detected using typefind functions, and the appropriate output mime type
+ * set on outgoing buffers. 
+ *
+ * The element is only able to read ID3v1 tags from a seekable stream, because
+ * they are at the end of the stream. That is, when get_range mode is supported
+ * by the upstream elements. If get_range operation is available, id3demux makes
+ * it available downstream. This means that elements which require get_range
+ * mode, such as wavparse, can operate on files containing ID3 tag information.
+ *
+ * This id3demux element replaced an older element with the same name which
+ * relied on libid3tag from the MAD project.
  *
  * <refsect2>
- * <para>
- * id3demux accepts data streams with either (or both) ID3v2 regions at the start, or ID3v1 at the end. The mime type of the data between the tag blocks is detected using typefind functions, and the appropriate output mime type set on outgoing buffers. 
- * </para><para>
- * The element is only able to read ID3v1 tags from a seekable stream, because they are at the end of the stream. That is, when get_range mode is supported by the upstream elements. If get_range operation is available, id3demux makes it available downstream. This means that elements which require get_range mode, such as wavparse, can operate on files containing ID3 tag information.
- * </para>
  * <title>Example launch line</title>
- * <para>
+ * |[
- * <programlisting>
  * gst-launch filesrc location=file.mp3 ! id3demux ! fakesink -t
- * </programlisting>
+ * ]| This pipeline should read any available ID3 tag information and output it.
- * This pipeline should read any available ID3 tag information and output it. The contents of the file inside the ID3 tag regions should be detected, and the appropriate mime type set on buffers produced from id3demux.
+ * The contents of the file inside the ID3 tag regions should be detected, and
- * </para><para>
+ * the appropriate mime type set on buffers produced from id3demux.
- * This id3demux element replaced an older element with the same name which relied on libid3tag from the MAD project.
- * </para>
  * </refsect2>
  */
 #ifdef HAVE_CONFIG_H

gst/law/alaw-decode.c

@@ -16,6 +16,11 @@
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
+/**
+ * SECTION:element-alawdec
+ *
+ * This element decodes alaw audio. Alaw coding is also known as G.711.
+ */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"

gst/law/alaw-encode.c

@@ -16,6 +16,11 @@
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
+/**
+ * SECTION:element-alawenc
+ *
+ * This element encode alaw audio. Alaw coding is also known as G.711.
+ */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"

gst/law/mulaw-decode.c

@@ -16,6 +16,11 @@
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
+/**
+ * SECTION:element-mulawdec
+ *
+ * This element decodes mulaw audio. Mulaw coding is also known as G.711.
+ */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"

gst/law/mulaw-encode.c

@@ -16,6 +16,11 @@
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
+/**
+ * SECTION:element-mulawenc
+ *
+ * This element encode mulaw audio. Mulaw coding is also known as G.711.
+ */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"