gst/gstcaps.c: Docs about how to print caps for debug purposes.

Original commit message from CVS:
* gst/gstcaps.c:
Docs about how to print caps for debug purposes.
* gst/gstpadtemplate.c: (gst_static_pad_template_get):
use gst_caps_make_writable instead of gst_caps_copy, Fixes #340608

ChangeLog

@@ -1,3 +1,11 @@
+2006-05-07  Stefan Kost  <ensonic@users.sf.net>
+
+	* gst/gstcaps.c:
+          Docs about how to print caps for debug purposes.
+        
+	* gst/gstpadtemplate.c: (gst_static_pad_template_get):
+          use gst_caps_make_writable instead of gst_caps_copy, Fixes #340608
+
 2006-05-07  Stefan Kost  <ensonic@users.sf.net>
 
 	* gst/gstelement.c:

gst/gstcaps.c

@@ -1589,6 +1589,12 @@ gst_caps_replace (GstCaps ** caps, GstCaps * newcaps)
  * Converts @caps to a string representation.  This string representation
  * can be converted back to a #GstCaps by gst_caps_from_string().
  *
+ * For debugging purposes its easier to do something like this:
+ * <programlisting>
+ *  GST_LOG ("caps are %" GST_PTR_FORMAT, caps);
+ * </programlisting>
+ * This prints the caps in human readble form.
+ *
  * Returns: a newly allocated string representing @caps.
  */
 gchar *

gst/gstpadtemplate.c

@@ -277,7 +277,7 @@ gst_static_pad_template_get (GstStaticPadTemplate * pad_template)
   GST_PAD_TEMPLATE_PRESENCE (new) = pad_template->presence;
 
   GST_PAD_TEMPLATE_CAPS (new) =
-      gst_caps_copy (gst_static_caps_get (&pad_template->static_caps));
+      gst_caps_make_writable (gst_static_caps_get (&pad_template->static_caps));
 
   return new;
 }