Update and add documentation for plugins with no deps (gst).

Link to properties. Correct titles for examples. Document a few trivial cases. Keep lists in section file and docs/plugins/Makefile.am alphabetically ordered.

2 files changed, 25 insertions, 37 deletions

diff --git a/gst/smpte/gstsmpte.c b/gst/smpte/gstsmpte.c
index 91f6c2f8..5a1a0871 100644
--- a/gst/smpte/gstsmpte.c
+++ b/gst/smpte/gstsmpte.c
@@ -19,31 +19,23 @@
 
 /**
  * SECTION:element-smpte
- * @short_description: Takes to video frames and applies an SMPTE transition 
- * effect on them.
  *
- * <refsect2>
- * <para>
  * smpte can accept I420 video streams with the same width, height and
  * framerate. The two incomming buffers are blended together using an effect
  * specific alpha mask. 
- * </para>
- * <para>
- * The depth property defines the presision in bits of the mask. A higher
- * presision will create a mask with smoother gradients in order to avoid
+ *
+ * The #GstSmpte:depth property defines the presision in bits of the mask. A
+ * higher presision will create a mask with smoother gradients in order to avoid
  * banding.
- * </para>
+ *
+ * <refsect2>
  * <title>Sample pipelines</title>
- * <para>
- * Here is a pipeline to demonstrate the smpte transition :
- * <programlisting>
- * gst-launch -v videotestsrc pattern=1 ! smpte name=s border=20000 type=234
- * duration=2000000000 ! ffmpegcolorspace ! ximagesink videotestsrc ! s.
- * </programlisting>
- * This shows a pinwheel transition a from a snow videotestsrc to an smpte
+ * |[
+ * gst-launch -v videotestsrc pattern=1 ! smpte name=s border=20000 type=234 duration=2000000000 ! ffmpegcolorspace ! ximagesink videotestsrc ! s.
+ * ]| A pipeline to demonstrate the smpte transition.
+ * It shows a pinwheel transition a from a snow videotestsrc to an smpte
  * pattern videotestsrc. The transition will take 2 seconds to complete. The
  * edges of the transition are smoothed with a 20000 big border.
- * </para>
  * </refsect2>
  */
 
@@ -491,8 +483,8 @@ gst_smpte_collected (GstCollectPads * pads, GstSMPTE * smpte)
       GstCaps *caps;
 
       caps =
-          gst_caps_copy (gst_static_caps_get (&gst_smpte_src_template.
-              static_caps));
+          gst_caps_copy (gst_static_caps_get
+          (&gst_smpte_src_template.static_caps));
       gst_caps_set_simple (caps, "width", G_TYPE_INT, smpte->width, "height",
           G_TYPE_INT, smpte->height, "framerate", GST_TYPE_FRACTION,
           smpte->fps_num, smpte->fps_denom, NULL);
diff --git a/gst/smpte/gstsmptealpha.c b/gst/smpte/gstsmptealpha.c
index 95c8b245..74f27ba2 100644
--- a/gst/smpte/gstsmptealpha.c
+++ b/gst/smpte/gstsmptealpha.c
@@ -19,26 +19,21 @@
 
 /**
  * SECTION:element-smptealpha
- * @short_description: Takes a video frames and applies an SMPTE transition 
- * effect on it in the alpha channel.
  *
- * <refsect2>
- * <para>
  * smptealpha can accept an I420 or AYUV video stream. An alpha channel is added
- * using an effect specific SMPTE mask in the I420 input case. In the AYUV case, the
- * alpha channel is modified using the effect specific SMPTE mask.
- * </para>
- * <para>
- * The "position" property is a controllabe double between 0.0 and 1.0 that
- * specifies the position in the transition. 0.0 is the start of the transition
- * with the alpha channel to complete opaque where 1.0 has the alpha channel set
- * to completely transparent.
- * </para>
- * <para>
- * The depth property defines the precision in bits of the mask. A higher
- * presision will create a mask with smoother gradients in order to avoid
- * banding.
- * </para>
+ * using an effect specific SMPTE mask in the I420 input case. In the AYUV case,
+ * the alpha channel is modified using the effect specific SMPTE mask.
+ *
+ * The #GstSmpteAlpha:position property is a controllabe double between 0.0 and
+ * 1.0 that specifies the position in the transition. 0.0 is the start of the
+ * transition with the alpha channel to complete opaque where 1.0 has the alpha
+ * channel set to completely transparent.
+ *
+ * The #GstSmpteAlpha:depth property defines the precision in bits of the mask.
+ * A higher presision will create a mask with smoother gradients in order to
+ * avoid banding.
+ *
+ * <refsect2>
  * <title>Sample pipelines</title>
  * <para>
  * Here is a pipeline to demonstrate the smpte transition :
@@ -432,6 +427,7 @@ gst_smpte_alpha_do_ayuv (GstSMPTEAlpha * smpte, guint8 * in, guint8 * out,
     }
   }
 }
+
 static void
 gst_smpte_alpha_do_i420 (GstSMPTEAlpha * smpte, guint8 * in, guint8 * out,
     GstMask * mask, gint width, gint height, gint border, gint pos)