From aa3fa6a5421b71d92a49dba9004b9eab73ccd4b4 Mon Sep 17 00:00:00 2001
From: David Schleef <ds@schleef.org>
Date: Mon, 6 Sep 2010 03:04:13 -0700
Subject: [PATCH] interlace: Add documentation

---
 gst/interlace/gstinterlace.c | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/gst/interlace/gstinterlace.c b/gst/interlace/gstinterlace.c
index 15497f7..772f601 100644
--- a/gst/interlace/gstinterlace.c
+++ b/gst/interlace/gstinterlace.c
@@ -16,6 +16,31 @@
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
+/**
+ * SECTION:element-interlace
+ *
+ * The interlace element takes a non-interlaced raw video stream as input,
+ * creates fields out of each frame, then combines fields into interlaced
+ * frames to output as an interlaced video stream.
+ *
+ * <refsect2>
+ * <title>Example launch line</title>
+ * |[
+ * gst-launch -v videotestsrc pattern=ball ! interlace ! xvimagesink
+ * ]|
+ * This pipeline illustrates the combing effects caused by displaying
+ * two interlaced fields as one progressive frame.
+ * |[
+ * gst-launch -v filesrc location=/path/to/file ! decodebin ! videorate !
+ *   videoscale ! video/x-raw-yuv,format=\(fourcc\)I420,width=720,height=480,
+ *   framerate=60000/1001,pixel-aspect-ratio=11/10 ! 
+ *   interlace top-field-first=false ! ...
+ * ]|
+ * This pipeline converts a progressive video stream into an interlaced
+ * stream suitable for standard definition NTSC.
+ * </refsect2>
+ */
+
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"
-- 
2.7.4