gst/gstpad.c: Enhance debug and improve docs

Original commit message from CVS:
* gst/gstpad.c: (gst_pad_event_default_dispatch),
(gst_pad_push_event):
Enhance debug and improve docs
* gst/gsturi.c:
Fix docs

diff --git a/ChangeLog b/ChangeLog
index a9b0cfc..dd32fe4 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,14 @@
 2006-11-06  Stefan Kost  <ensonic@users.sf.net>
 
+       * gst/gstpad.c: (gst_pad_event_default_dispatch),
+       (gst_pad_push_event):
+         Enhance debug and improve docs
+       
+       * gst/gsturi.c:
+         Fix docs
+
+2006-11-06  Stefan Kost  <ensonic@users.sf.net>
+
        * docs/random/ensonic/distributed.txt:
        * docs/random/ensonic/profiling.txt:
          more ideas

diff --git a/gst/gstpad.c b/gst/gstpad.c
index 6eb2cfb..37a3ddc 100644 (file)
--- a/gst/gstpad.c
+++ b/gst/gstpad.c
@@ -2874,8 +2874,8 @@ gst_pad_event_default_dispatch (GstPad * pad, GstEvent * event)
   GList *orig, *pads;
   gboolean result;
 
-  GST_INFO_OBJECT (pad, "Sending event %p to all internally linked pads",
-      event);
+  GST_INFO_OBJECT (pad, "Sending event %p (%s) to all internally linked pads",
+      event, GST_EVENT_TYPE_NAME (event));
 
   result = (GST_PAD_DIRECTION (pad) == GST_PAD_SINK);
 
@@ -3929,13 +3929,15 @@ gst_pad_push_event (GstPad * pad, GstEvent * event)
   if (peerpad == NULL)
     goto not_linked;
 
-  GST_LOG_OBJECT (pad, "sending event to peerpad %" GST_PTR_FORMAT, peerpad);
+  GST_LOG_OBJECT (pad, "sending event %s to peerpad %" GST_PTR_FORMAT,
+      GST_EVENT_TYPE_NAME (event), peerpad);
   gst_object_ref (peerpad);
   GST_OBJECT_UNLOCK (pad);
 
   result = gst_pad_send_event (peerpad, event);
 
-  GST_LOG_OBJECT (pad, "sent event to peerpad %" GST_PTR_FORMAT, peerpad);
+  GST_LOG_OBJECT (pad, "sent event %s to peerpad %" GST_PTR_FORMAT,
+      GST_EVENT_TYPE_NAME (event), peerpad);
   gst_object_unref (peerpad);
 
   return result;
@@ -4162,10 +4164,10 @@ gst_pad_get_element_private (GstPad * pad)
  *
  * Starts a task that repeadedly calls @func with @data. This function
  * is nostly used in the pad activation function to start the
- * dataflow. This function will automatically acquire the STREAM_LOCK of
- * the pad before calling @func.
+ * dataflow. This function will automatically acquire the #GST_PAD_STREAM_LOCK
+ * of the pad before calling @func.
  *
- * Returns: a TRUE if the task could be started.
+ * Returns: a %TRUE if the task could be started.
  */
 gboolean
 gst_pad_start_task (GstPad * pad, GstTaskFunction func, gpointer data)

diff --git a/gst/gsturi.c b/gst/gsturi.c
index ae2ca7a..0f3dd58 100644 (file)
--- a/gst/gsturi.c
+++ b/gst/gsturi.c
@@ -377,7 +377,9 @@ gst_uri_get_protocol (const gchar * uri)
  * @uri: an URI string
  * @protocol: a protocol string (e.g. "http")
  *
- * Returns TRUE if the protocol of a given valid URI matches @protocol.
+ * Checks if the protocol of a given valid URI matches @protocol.
+ *
+ * Returns: %TRUE if the protocol matches.
  *
  * Since: 0.10.4
  */