docs/plugins/: add more plugins and elements to docs

Original commit message from CVS:
* docs/plugins/Makefile.am:
* docs/plugins/gst-plugins-bad-plugins-docs.sgml:
* docs/plugins/gst-plugins-bad-plugins-sections.txt:
add more plugins and elements to docs
* gst/gdp/gstgdpdepay.c: (gst_gdp_depay_chain):
fix segfaults due to wrong g_free
add example
* gst/gdp/gstgdppay.c:
add example

diff --git a/gst/gdp/gstgdpdepay.c b/gst/gdp/gstgdpdepay.c
index 3f973b8..21d6c73 100644 (file)
--- a/gst/gdp/gstgdpdepay.c
+++ b/gst/gdp/gstgdpdepay.c
@@ -26,6 +26,13 @@
  * This element depayloads GStreamer Data Protocol buffers back to deserialized
  * buffers and events.
  * </para>
+ * <para>
+ * <programlisting>
+ * gst-launch -v -m filesrc location=test.gdp ! gdpdepay ! xvimagesink
+ * </programlisting>
+ * This pipeline plays back a serialized video stream as created in the
+ * example for gdppay.
+ * </para>
  * </refsect2>
  */
 
@@ -231,6 +238,7 @@ gst_gdp_depay_chain (GstPad * pad, GstBuffer * buffer)
         payload = gst_adapter_take (this->adapter, this->payload_length);
         memcpy (GST_BUFFER_DATA (buf), payload, this->payload_length);
         g_free (payload);
+        payload = NULL;
 
         gst_buffer_set_caps (buf, this->caps);
         ret = gst_pad_push (this->srcpad, buf);
@@ -250,6 +258,7 @@ gst_gdp_depay_chain (GstPad * pad, GstBuffer * buffer)
         caps = gst_dp_caps_from_packet (GST_DP_HEADER_LENGTH, this->header,
             payload);
         g_free (payload);
+        payload = NULL;
         if (!caps) {
           GST_ELEMENT_ERROR (this, STREAM, DECODE, (NULL),
               ("could not create caps from GDP packet"));
@@ -273,8 +282,10 @@ gst_gdp_depay_chain (GstPad * pad, GstBuffer * buffer)
           payload = gst_adapter_take (this->adapter, this->payload_length);
         event = gst_dp_event_from_packet (GST_DP_HEADER_LENGTH, this->header,
             payload);
-        if (payload)
+        if (payload) {
           g_free (payload);
+          payload = NULL;
+        }
         if (!event) {
           GST_ELEMENT_ERROR (this, STREAM, DECODE, (NULL),
               ("could not create event from GDP packet"));

diff --git a/gst/gdp/gstgdppay.c b/gst/gdp/gstgdppay.c
index e80476e..36585a0 100644 (file)
--- a/gst/gdp/gstgdppay.c
+++ b/gst/gdp/gstgdppay.c
@@ -26,6 +26,13 @@
  * This element payloads GStreamer buffers and events using the
  * GStreamer Data Protocol.
  * </para>
+ * <para>
+ * <programlisting>
+ * gst-launch -v -m videotestsrc num-buffers=50 ! gdppay ! filesink location=test.gdp
+ * </programlisting>
+ * This pipeline creates a serialized video stream that can be played back
+ * with the example shown in gdpdepay.
+ * </para>
  * </refsect2>
  */