[0.11] gst-plugins-bad: docs: add new curl plugin and curlsink element to docs

[Wim Taymans]

Module: gst-plugins-bad
Branch: 0.11
Commit: c6d7071d938d2acb5481f5e8ea9cf0e671a5c2b4
URL:    http://cgit.freedesktop.org/gstreamer/gst-plugins-bad/commit/?id=c6d7071d938d2acb5481f5e8ea9cf0e671a5c2b4

Author: Tim-Philipp Müller <tim.muller at collabora.co.uk>
Date:   Tue Mar  1 11:16:56 2011 +0000

docs: add new curl plugin and curlsink element to docs

---

 docs/plugins/Makefile.am                          |    1 +
 docs/plugins/gst-plugins-bad-plugins-docs.sgml    |    2 +
 docs/plugins/gst-plugins-bad-plugins-sections.txt |   14 ++++++++++
 docs/plugins/inspect/plugin-curl.xml              |   28 +++++++++++++++++++++
 ext/curl/gstcurlsink.c                            |   28 ++++++++++++++++++--
 5 files changed, 70 insertions(+), 3 deletions(-)

diff --git a/docs/plugins/Makefile.am b/docs/plugins/Makefile.am
index c9820cf..0d124a7 100644
--- a/docs/plugins/Makefile.am
+++ b/docs/plugins/Makefile.am
@@ -94,6 +94,7 @@ EXTRA_HFILES = \
 	$(top_srcdir)/ext/amrwbenc/gstamrwbenc.h \
 	$(top_srcdir)/ext/celt/gstceltdec.h \
 	$(top_srcdir)/ext/celt/gstceltenc.h \
+	$(top_srcdir)/ext/curl/gstcurlsink.h \
 	$(top_srcdir)/ext/dc1394/gstdc1394.h \
 	$(top_srcdir)/ext/directfb/dfbvideosink.h \
 	$(top_srcdir)/ext/dts/gstdtsdec.h \
diff --git a/docs/plugins/gst-plugins-bad-plugins-docs.sgml b/docs/plugins/gst-plugins-bad-plugins-docs.sgml
index 5551d5c..8cbad1e 100644
--- a/docs/plugins/gst-plugins-bad-plugins-docs.sgml
+++ b/docs/plugins/gst-plugins-bad-plugins-docs.sgml
@@ -33,6 +33,7 @@
     <xi:include href="xml/element-chromium.xml" />
     <xi:include href="xml/element-circle.xml" />
     <xi:include href="xml/element-coloreffects.xml" />
+    <xi:include href="xml/element-curlsink.xml" />
     <xi:include href="xml/element-cvdilate.xml" />
     <xi:include href="xml/element-cverode.xml" />
     <xi:include href="xml/element-cvequalizehist.xml" />
@@ -147,6 +148,7 @@
     <xi:include href="xml/plugin-cdxaparse.xml" />
     <xi:include href="xml/plugin-celt.xml" />
     <xi:include href="xml/plugin-coloreffects.xml" />
+    <xi:include href="xml/plugin-curl.xml" />
     <xi:include href="xml/plugin-dataurisrc.xml" />
     <xi:include href="xml/plugin-dccp.xml" />
     <xi:include href="xml/plugin-debugutilsbad.xml" />
diff --git a/docs/plugins/gst-plugins-bad-plugins-sections.txt b/docs/plugins/gst-plugins-bad-plugins-sections.txt
index f85d075..98e3264 100644
--- a/docs/plugins/gst-plugins-bad-plugins-sections.txt
+++ b/docs/plugins/gst-plugins-bad-plugins-sections.txt
@@ -245,6 +245,20 @@ gst_color_effects_get_type
 </SECTION>
 
 <SECTION>
+<FILE>element-curlsink</FILE>
+<TITLE>curlsink</TITLE>
+GstCurlSink
+<SUBSECTION Standard>
+GstCurlSinkClass
+GST_CURL_SINK
+GST_CURL_SINK_CLASS
+GST_IS_CURL_SINK
+GST_IS_CURL_SINK_CLASS
+GST_TYPE_CURL_SINK
+gst_curl_sink_get_type
+</SECTION>
+
+<SECTION>
 <FILE>element-cvdilate</FILE>
 <TITLE>cvdilate</TITLE>
 GstCvDilate
diff --git a/docs/plugins/inspect/plugin-curl.xml b/docs/plugins/inspect/plugin-curl.xml
new file mode 100644
index 0000000..64e82c9
--- /dev/null
+++ b/docs/plugins/inspect/plugin-curl.xml
@@ -0,0 +1,28 @@
+<plugin>
+  <name>curl</name>
+  <description>libcurl-based elements</description>
+  <filename>../../ext/curl/.libs/libgstcurl.so</filename>
+  <basename>libgstcurl.so</basename>
+  <version>0.10.21.1</version>
+  <license>LGPL</license>
+  <source>gst-plugins-bad</source>
+  <package>GStreamer Bad Plug-ins git</package>
+  <origin>Unknown package origin</origin>
+  <elements>
+    <element>
+      <name>curlsink</name>
+      <longname>Curl sink</longname>
+      <class>Sink/Network</class>
+      <description>Upload data over the network to a server using libcurl</description>
+      <author>Patricia Muscalu &lt;patricia at axis.com&gt;</author>
+      <pads>
+        <caps>
+          <name>sink</name>
+          <direction>sink</direction>
+          <presence>always</presence>
+          <details>ANY</details>
+        </caps>
+      </pads>
+    </element>
+  </elements>
+</plugin>
\ No newline at end of file
diff --git a/ext/curl/gstcurlsink.c b/ext/curl/gstcurlsink.c
index 77fa1c4..f234e37 100644
--- a/ext/curl/gstcurlsink.c
+++ b/ext/curl/gstcurlsink.c
@@ -17,6 +17,31 @@
  * Boston, MA 02111-1307, USA.
  */
 
+/**
+ * SECTION:element-curlsink
+ * @short_description: sink that uploads data to a server using libcurl
+ * @see_also:
+ *
+ * This is a network sink that uses libcurl as a client to upload data to
+ * a server (e.g. a HTTP/FTP server).
+ *
+ * <refsect2>
+ * <title>Example launch line (upload a JPEG file to an HTTP server)</title>
+ * |[
+ * gst-launch filesrc filesrc location=image.jpg ! jpegparse ! curlsink  \
+ *     file-name=image.jpg  \
+ *     location=http://192.168.0.1:8080/cgi-bin/patupload.cgi/  \
+ *     user=test passwd=test  \
+ *     content-type=image/jpeg  \
+ *     use-content-length=false
+ * ]|
+ * </refsect2>
+ */
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
 #include <curl/curl.h>
 #include <string.h>
 #include <stdio.h>
@@ -30,9 +55,6 @@
 #include <sys/stat.h>
 #include <fcntl.h>
 
-#ifdef HAVE_CONFIG_H
-#include "config.h"
-#endif
 #include "gstcurlsink.h"
 
 /* Default values */