Some minor docs fixes and additions; also add missing 'Since' bits.

Original commit message from CVS:
* docs/libs/gst-plugins-base-libs.types:
* gst-libs/gst/rtp/gstbasertpaudiopayload.c:
(gst_base_rtp_audio_payload_class_init):
* gst-libs/gst/rtp/gstbasertpdepayload.c:
* gst-libs/gst/rtp/gstbasertppayload.c:
Some minor docs fixes and additions; also add missing 'Since' bits.

diff --git a/ChangeLog b/ChangeLog
index d238178ff738be5084fd6088879da0b6ffd320dd..6b9d3dbe8f182cbfc7f72998f0c3b4136165b566 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2007-04-21  Tim-Philipp Müller  <tim at centricular dot net>
+
+       * docs/libs/gst-plugins-base-libs.types:
+       * gst-libs/gst/rtp/gstbasertpaudiopayload.c:
+       (gst_base_rtp_audio_payload_class_init):
+       * gst-libs/gst/rtp/gstbasertpdepayload.c:
+       * gst-libs/gst/rtp/gstbasertppayload.c:
+         Some minor docs fixes and additions; also add missing 'Since' bits.
+
 2007-04-21  Tim-Philipp Müller  <tim at centricular dot net>
 
        Patch by: Zeeshan Ali  <zeenix gmail com>

diff --git a/docs/libs/gst-plugins-base-libs.types b/docs/libs/gst-plugins-base-libs.types
index 3e670fced7f22ad72b367f86602cef1d1b874eca..a2e5205a38708ae5a2c074a6167dd3b35bf389cc 100644 (file)
--- a/docs/libs/gst-plugins-base-libs.types
+++ b/docs/libs/gst-plugins-base-libs.types
@@ -46,6 +46,8 @@ gst_x_overlay_get_type
 gst_base_rtp_depayload_get_type
 #include <gst/rtp/gstbasertppayload.h>
 gst_basertppayload_get_type
+#include <gst/rtp/gstbasertpaudiopayload.h>
+gst_base_rtp_audio_payload_get_type
 
 
 #include <gst/video/gstvideofilter.h>

diff --git a/gst-libs/gst/rtp/gstbasertpaudiopayload.c b/gst-libs/gst/rtp/gstbasertpaudiopayload.c
index f2605021553cd1774d0662c3872f72f8d8a12f99..b2d002a4a75e799bda54cc20250e74fea204bb9e 100644 (file)
--- a/gst-libs/gst/rtp/gstbasertpaudiopayload.c
+++ b/gst-libs/gst/rtp/gstbasertpaudiopayload.c
@@ -161,6 +161,13 @@ gst_base_rtp_audio_payload_class_init (GstBaseRTPAudioPayloadClass * klass)
   gstelement_class->change_state =
       GST_DEBUG_FUNCPTR (gst_base_rtp_payload_audio_change_state);
 
+  /**
+   * GstBaseRTPAudioPayload:min-ptime:
+   *
+   * Minimum duration of the packet data in ns (can't go above MTU)
+   *
+   * Since: 0.10.13
+   **/
   g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_MIN_PTIME,
       g_param_spec_int64 ("min-ptime", "Min packet time",
           "Minimum duration of the packet data in ns (can't go above MTU)",
@@ -612,6 +619,8 @@ gst_base_rtp_audio_payload_handle_sample_based_buffer (GstBaseRTPPayload *
  * the buffer downstream.
  *
  * Returns: a #GstFlowReturn
+ *
+ * Since: 0.10.13
  */
 GstFlowReturn
 gst_base_rtp_audio_payload_push (GstBaseRTPAudioPayload * baseaudiopayload,
@@ -737,6 +746,8 @@ gst_base_rtp_payload_audio_handle_event (GstPad * pad, GstEvent * event,
  * Gets the internal adapter used by the depayloader.
  *
  * Returns: a #GstAdapter.
+ *
+ * Since: 0.10.13
  */
 GstAdapter *
 gst_base_rtp_audio_payload_get_adapter (GstBaseRTPAudioPayload

diff --git a/gst-libs/gst/rtp/gstbasertpdepayload.c b/gst-libs/gst/rtp/gstbasertpdepayload.c
index 871eb7ae18b034cbd5b517126aa155e59fa0b5ff..66b72e34ad30570b946ac9f86f44f46f4b52b1eb 100644 (file)
--- a/gst-libs/gst/rtp/gstbasertpdepayload.c
+++ b/gst-libs/gst/rtp/gstbasertpdepayload.c
@@ -18,6 +18,17 @@
  * Boston, MA 02111-1307, USA.
  */
 
+/**
+ * SECTION:gstbasertpdepayload
+ * @short_description: Base class for RTP depayloader
+ *
+ * <refsect2>
+ * <para>
+ * Provides a base class for RTP depayloaders
+ * </para>
+ * </refsect2>
+ */
+
 #include "gstbasertpdepayload.h"
 
 GST_DEBUG_CATEGORY_STATIC (basertpdepayload_debug);

diff --git a/gst-libs/gst/rtp/gstbasertppayload.c b/gst-libs/gst/rtp/gstbasertppayload.c
index 7a53d919bd9bc224190fdfa8edd6427dbdfde48e..237daaf431f067537c2fc8e5ca323e1369ca0890 100644 (file)
--- a/gst-libs/gst/rtp/gstbasertppayload.c
+++ b/gst-libs/gst/rtp/gstbasertppayload.c
@@ -12,6 +12,17 @@
  * Library General Public License for more 
  */
 
+/**
+ * SECTION:gstbasertppayload
+ * @short_description: Base class for RTP payloader
+ *
+ * <refsect2>
+ * <para>
+ * Provides a base class for RTP payloaders
+ * </para>
+ * </refsect2>
+ */
+
 #ifdef HAVE_CONFIG_H
 #  include "config.h"
 #endif
@@ -79,6 +90,8 @@ static GstStateChangeReturn gst_basertppayload_change_state (GstElement *
 
 static GstElementClass *parent_class = NULL;
 
+/* FIXME 0.11: API should be changed to gst_base_typ_payload_xyz */
+
 GType
 gst_basertppayload_get_type (void)
 {