diff --git a/gst/gstcaps.c b/gst/gstcaps.c
index 991cd4729b..b3755f2978 100644
--- a/gst/gstcaps.c
+++ b/gst/gstcaps.c
@@ -1781,9 +1781,9 @@ gst_caps_replace (GstCaps ** caps, GstCaps * newcaps)
  * 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>
+ * |[
+ * GST_LOG ("caps are %" GST_PTR_FORMAT, caps);
+ * ]|
  * This prints the caps in human readble form.
  *
  * Returns: a newly allocated string representing @caps.
diff --git a/gst/gststructure.c b/gst/gststructure.c
index e620dae09a..93d509fbd6 100644
--- a/gst/gststructure.c
+++ b/gst/gststructure.c
@@ -1546,6 +1546,12 @@ priv_gst_structure_append_to_gstring (const GstStructure * structure,
  *
  * Converts @structure to a human-readable string representation.
  *
+ * For debugging purposes its easier to do something like this:
+ * |[
+ * GST_LOG ("structure is %" GST_PTR_FORMAT, structure);
+ * ]|
+ * This prints the structure in human readble form.
+ *
  * Returns: a pointer to string allocated by g_malloc(). g_free() after
  * usage.
  */