From 9286debe9dbd6880b3fbcc17b2d7c4db26ebe32a Mon Sep 17 00:00:00 2001
From: Thomas Vander Stichele <thomas@apestaart.org>
Date: Wed, 14 Sep 2005 21:36:02 +0000
Subject: [PATCH] add theoraenc

Original commit message from CVS:
* docs/plugins/gst-plugins-base-plugins-docs.sgml:
* docs/plugins/gst-plugins-base-plugins-sections.txt:
* ext/theora/theoraenc.c:
add theoraenc
---
 ChangeLog                                     |  9 ++++-
 common                                        |  2 +-
 .../gst-plugins-base-plugins-docs.sgml        |  9 ++---
 .../gst-plugins-base-plugins-sections.txt     | 33 ++++++++++---------
 ext/theora/theoraenc.c                        | 18 ++++++++++
 5 files changed, 49 insertions(+), 22 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 95adc2ec42..0d04a1ad82 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,10 +1,17 @@
+2005-09-14  Thomas Vander Stichele  <thomas at apestaart dot org>
+
+	* docs/plugins/gst-plugins-base-plugins-docs.sgml:
+	* docs/plugins/gst-plugins-base-plugins-sections.txt:
+	* ext/theora/theoraenc.c:
+	  add theoraenc
+
 2005-09-13  Tim-Philipp Müller  <tim at centricular dot net>
 
 	* gst/audioconvert/Makefile.am:
 	  Audioconvert derives from GstBaseTransform and should
 	  link to the library with our base elements to avoid
 	  unresolved symbols. Makes things work with MinGW (#316160)
- 
+
 	* gst/playback/test4.c: (main):
 	  Fix MinGW build problem and use g_usleep() instead of 
 	  sleep() (#316162)
diff --git a/common b/common
index 30a1fc4dc2..22ed117658 160000
--- a/common
+++ b/common
@@ -1 +1 @@
-Subproject commit 30a1fc4dc24133cc411e0232af87790ae2f845b2
+Subproject commit 22ed11765884ef97b7346f0723ffc0e7fe540640
diff --git a/docs/plugins/gst-plugins-base-plugins-docs.sgml b/docs/plugins/gst-plugins-base-plugins-docs.sgml
index 0495a9fa5b..091febe24f 100644
--- a/docs/plugins/gst-plugins-base-plugins-docs.sgml
+++ b/docs/plugins/gst-plugins-base-plugins-docs.sgml
@@ -13,13 +13,14 @@
   <chapter>
     <title>gst-plugins-base Elements</title>
     <xi:include href="xml/element-ffmpegcolorspace.xml" />
-    <xi:include href="xml/element-multifdsink.xml" />
-    <xi:include href="xml/element-tcpserversink.xml" />
-    <xi:include href="xml/element-videotestsrc.xml" />
-    <xi:include href="xml/element-volume.xml" />
 <!--
     <xi:include href="xml/element-gnomevfssink.xml" />
 -->
+    <xi:include href="xml/element-multifdsink.xml" />
+    <xi:include href="xml/element-tcpserversink.xml" />
+    <xi:include href="xml/element-theoraenc.xml" />
+    <xi:include href="xml/element-videotestsrc.xml" />
+    <xi:include href="xml/element-volume.xml" />
     <xi:include href="xml/element-vorbisenc.xml" />
   </chapter>
 
diff --git a/docs/plugins/gst-plugins-base-plugins-sections.txt b/docs/plugins/gst-plugins-base-plugins-sections.txt
index a76f4ecd4e..f28c4343a9 100644
--- a/docs/plugins/gst-plugins-base-plugins-sections.txt
+++ b/docs/plugins/gst-plugins-base-plugins-sections.txt
@@ -18,22 +18,6 @@ GstClientStatus
 GstMultiFdSinkClass
 </SECTION>
 
-<SECTION>
-<FILE>element-tcpserversink</FILE>
-GstTCPServerSink
-<TITLE>tcpserversink</TITLE>
-<SUBSECTION Standard>
-GstTCPServerSinkClass
-</SECTION>
-
-<SECTION>
-<FILE>element-tcpserversink</FILE>
-GstTCPServerSink
-<TITLE>tcpserversink</TITLE>
-<SUBSECTION Standard>
-GstTCPServerSinkClass
-</SECTION>
-
 <SECTION>
 <FILE>element-gnomevfssink</FILE>
 GstGnomeVFSSink
@@ -42,6 +26,23 @@ GstGnomeVFSSink
 GstGnomeVFSSinkClass
 </SECTION>
 
+<SECTION>
+<FILE>element-tcpserversink</FILE>
+GstTCPServerSink
+<TITLE>tcpserversink</TITLE>
+<SUBSECTION Standard>
+GstTCPServerSinkClass
+</SECTION>
+
+<SECTION>
+<FILE>element-theoraenc</FILE>
+GstTheoraEnc
+<TITLE>theoraenc</TITLE>
+<SUBSECTION Standard>
+GstTheoraEncClass
+</SECTION>
+
+
 <SECTION>
 <FILE>element-videotestsrc</FILE>
 <TITLE>videotestsrc</TITLE>
diff --git a/ext/theora/theoraenc.c b/ext/theora/theoraenc.c
index 85f002d6e7..4f8d157b75 100644
--- a/ext/theora/theoraenc.c
+++ b/ext/theora/theoraenc.c
@@ -17,6 +17,24 @@
  * Boston, MA 02111-1307, USA.
  */
 
+/**
+ * SECTION:theoraenc
+ * @see_also: theoradec, oggmux
+ *
+ * <refsect2>
+ * <para>
+ * This element encodes raw video into a Theora stream.
+ * <ulink url="http://www.theora.org/">Theora</ulink> is a royalty-free
+ * video codec maintained by the <ulink url="http://www.xiph.org/">Xiph.org
+ * Foundation</ulink>, based on the VP3 codec.
+ * </para>
+ * <title>Example pipeline</title>
+ * <programlisting>
+ * gst-launch -v videotestsrc num-buffers=1000 ! theoraenc ! oggmux ! filesink location=videotestsrc.ogg
+ * </programlisting>
+ * </refsect2>
+ */
+
 #ifdef HAVE_CONFIG_H
 #  include "config.h"
 #endif