From 13664331ea306ba59e65d77ba8588f4a198c4a75 Mon Sep 17 00:00:00 2001
From: Thiago Santos <thiago.sousa.santos@collabora.co.uk>
Date: Sat, 27 Nov 2010 11:02:48 -0300
Subject: [PATCH] manual: Improve states documentation

Be more explicit about being on NULL before unrefs
---
 docs/manual/basics-elements.xml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/manual/basics-elements.xml b/docs/manual/basics-elements.xml
index 33085ceebc..201cb25d38 100644
--- a/docs/manual/basics-elements.xml
+++ b/docs/manual/basics-elements.xml
@@ -489,7 +489,9 @@ main (int   argc,
       <listitem>
         <para>
           <classname>GST_STATE_NULL</classname>: this is the default state.
-          This state will deallocate all resources held by the element.
+          No resources are allocated in this state, so, transitioning to it
+          will free all resources. The element must be in this state when
+          its refcount reaches 0 and it is freed.
         </para>
       </listitem>
       <listitem>