Update the documentation

docs/001_basic_vars.php

@@ -1,5 +1,10 @@
 <?php
 
+///////////////////////////////////////////////////////////////////////////////
+// Basic syntax for assigning variables to the templating system. You can    //
+// assign scalars, arrays, and hashes.                                       //
+///////////////////////////////////////////////////////////////////////////////
+
 include("../sluz.class.php");
 $s = new sluz();
 

docs/010_basic_if.php

@@ -1,5 +1,10 @@
 <?php
 
+///////////////////////////////////////////////////////////////////////////////
+// Sluz has if/then logic as well. If an if statement references a variable  //
+// that is not assigned it will be treated as if it were false.              //
+///////////////////////////////////////////////////////////////////////////////
+
 include("../sluz.class.php");
 $s = new sluz();
 

docs/030_basic_foreach.php

@@ -1,5 +1,10 @@
 <?php
 
+///////////////////////////////////////////////////////////////////////////////
+// Foreach works on either arrays or hashes. You can use regular PHP foreach //
+// syntax with foreach ($foo as $bar) or foreach ($foo as $key => $val).     //
+///////////////////////////////////////////////////////////////////////////////
+
 include("../sluz.class.php");
 $s = new sluz();
 

docs/040_literal_blocks.php

@@ -1,5 +1,12 @@
 <?php
 
+///////////////////////////////////////////////////////////////////////////////
+// You may need a literal '{' or '}' in your HTML. These characters are      //
+// common in both CSS and Javascript. To prevent Sluz from interpretting     //
+// them as code block just use {literal}.                                    //
+// Note: Brackets with whitespace on both sides do NOT require {literal}     //
+///////////////////////////////////////////////////////////////////////////////
+
 include("../sluz.class.php");
 $s = new sluz();