add docs

Original commit message from CVS:
add docs

ChangeLog

@@ -1,3 +1,10 @@
+2005-08-25  Thomas Vander Stichele  <thomas at apestaart dot org>
+
+	* gst/base/gstbasetransform.h:
+	  comment
+	* gst/gstpad.c:
+	  add to docs
+
 2005-08-25  Wim Taymans  <wim@fluendo.com>
 
 	* gst/gstbin.c: (bin_bus_handler):

gst/base/gstbasetransform.h

@@ -109,7 +109,9 @@ struct _GstBaseTransformClass {
   gboolean      (*event)        (GstBaseTransform *trans, GstEvent *event);
 
   /* transform one incoming buffer to one outgoing buffer.
-   * Always needs to be implemented. */
+   * Always needs to be implemented.
+   * transform function is allowed to change size/timestamp/duration of
+   * the outgoing buffer. */
   GstFlowReturn (*transform)    (GstBaseTransform *trans, GstBuffer *inbuf,
                                  GstBuffer *outbuf);
 

gst/gstpad.c

@@ -1730,10 +1730,14 @@ done:
  * gst_pad_get_caps:
  * @pad: a  #GstPad to get the capabilities of.
  *
- * Gets the capabilities of this pad.
+ * Gets the capabilities this pad can produce or consume.
+ * Note that this method doesn't necessarily returns the caps set by
+ * #gst_pad_set_caps - use #GST_PAD_CAPS for that instead.
+ * gst_pad_get_caps returns all possible caps a pad can operate with, using
+ * the pad's get_caps function;
+ * this returns the pad template caps if not explicitly set.
  *
- * Returns: the #GstCaps of this pad. This function returns a new caps, so use
+ * Returns: a newly allocated copy of the #GstCaps of this pad.
- * gst_caps_unref to get rid of it.
  *
  * MT safe.
  */

libs/gst/base/gstbasetransform.h

@@ -109,7 +109,9 @@ struct _GstBaseTransformClass {
   gboolean      (*event)        (GstBaseTransform *trans, GstEvent *event);
 
   /* transform one incoming buffer to one outgoing buffer.
-   * Always needs to be implemented. */
+   * Always needs to be implemented.
+   * transform function is allowed to change size/timestamp/duration of
+   * the outgoing buffer. */
   GstFlowReturn (*transform)    (GstBaseTransform *trans, GstBuffer *inbuf,
                                  GstBuffer *outbuf);