diff --git a/language/variables.xml b/language/variables.xml
index 41891fee5d..7d0548f7e0 100644
--- a/language/variables.xml
+++ b/language/variables.xml
@@ -414,6 +414,12 @@ function test_global()
      </programlisting>
     </example>
    </para>
+   <note>
+    <para>
+     Using <literal>global</literal> keyword outside a function is not an
+     error. It can be used if the file is included from inside a function.
+    </para>
+   </note>
   </sect2>
  
   <sect2 xml:id="language.variables.scope.static">
@@ -537,6 +543,12 @@ function foo(){
      Static declarations are resolved in compile-time.
     </para>
    </note>
+   <note>
+    <para>
+     Using <literal>global</literal> keyword outside a function is not an
+     error. It can be used if the file is included from inside a function.
+    </para>
+   </note>
   </sect2>
 
   <sect2 xml:id="language.variables.scope.references">