From e22517567a4d61800104b94c90c715de3747bd22 Mon Sep 17 00:00:00 2001
From: Thiago Santos <thiagoss@osg.samsung.com>
Date: Tue, 10 Nov 2015 14:37:27 -0300
Subject: [PATCH] context: add some more documentation

Add a short paragraph on what means for a context to be persistent
---
 gst/gstcontext.c | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/gst/gstcontext.c b/gst/gstcontext.c
index b535574ec7..717d8d2640 100644
--- a/gst/gstcontext.c
+++ b/gst/gstcontext.c
@@ -49,6 +49,12 @@
  * known context on the element that asks for it if possible. Otherwise the
  * application should provide one if it can.
  *
+ * #GstContext<!-- -->s can be persistent.
+ * A persistent #GstContext is kept in elements when they reach
+ * %GST_STATE_NULL, non-persistent ones will be removed.
+ * Also, a non-persistent context won't override a previous persistent
+ * context set to an element.
+ *
  * Since: 1.2
  */