cvs: smarty /docs/en/designers/language-builtin-functions language-function-include.xml

messju		Fri Dec  9 10:30:13 2005 EDT

  Modified files:              
    /smarty/docs/en/designers/language-builtin-functions	
                                                        	language-function-include.xml 
  Log:
  added explanation of variables' scope within {include}
  
  
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-builtin-functions/language-function-include.xml?r1=1.9&r2=1.10&ty=u
Index: smarty/docs/en/designers/language-builtin-functions/language-function-include.xml
diff -u smarty/docs/en/designers/language-builtin-functions/language-function-include.xml:1.9 smarty/docs/en/designers/language-builtin-functions/language-function-include.xml:1.10
--- smarty/docs/en/designers/language-builtin-functions/language-function-include.xml:1.9	Tue Sep 13 14:41:44 2005
+++ smarty/docs/en/designers/language-builtin-functions/language-function-include.xml	Fri Dec  9 10:30:13 2005
@@ -1,20 +1,26 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <sect1 id="language.function.include">
  <title>{include}</title>
-  <para>
-   {include} tags are used for including other templates in the current
-   template. Any variables available in the current template are also
-   available within the included template. The {include} tag must have
-   the attribute "file", which contains the template resource path.
-  </para>
-  <para>
-   You can optionally pass the <emphasis>'assign'</emphasis> attribute,
-   which will specify a template variable name that the output of
-   {include} will be assigned to instead of
-   displayed.
+ <para>
+  {include} tags are used for including other templates in the current
+  template. Any variables available in the current template are also
+  available within the included template. The {include} tag must have
+  the attribute "file", which contains the template resource path.
+ </para>
+ <para>
+  You can optionally pass the <emphasis>'assign'</emphasis> attribute,
+  which will specify a template variable name that the output of
+  {include} will be assigned to instead of
+  displayed.
+ </para>
+ <para>
+  All assigned variables' values are restored after the scope of the
+  included template is left. This means you can use all variables from
+  the including template inside the included template. But changes to
+  variables inside the included template are not visible inside the
+  including template after the {include} statement.
  </para>
- 
  <informaltable frame="all">
   <tgroup cols="5">
    <colspec colname="param" align="center" />