updates by Peter Morgan:

more cross-linking
  better distinction between {assign} and assign() and {fetch} and fetch()

docs/en/programmers/api-variables/variable-caching.xml

@@ -11,9 +11,13 @@
 	   Smarty to use the current
 	   <link linkend="variable.cache.lifetime">$cache_lifetime</link>
 	   variable to determine if the
-	   cache has expired. A value of 2 tells Smarty to use the cache_lifetime
+   cache has expired. A value of 2 tells Smarty to use the
+   <link linkend="variable.cache.lifetime">$cache_lifetime</link>
 	   value at the time the cache was generated. This way you can set the
-	   cache_lifetime just before fetching the template to have granular
+   <link linkend="variable.cache.lifetime">$cache_lifetime</link>
+   just before
+   <link linkend="api.fetch">fetching</link>
+   the template to have granular
 	   control over when that particular cache expires.
 	   See also <link linkend="api.is.cached">is_cached()</link>.
       </para>

docs/en/programmers/api-variables/variable-compile-dir.xml

@@ -6,7 +6,8 @@
      This is the name of the directory where compiled templates are
      located. By default this is "./templates_c", meaning that it
      will look for the compile directory in the same directory as
-     the executing php script.
+     the executing php script. <emphasis role="bold">This directory must
+     be writeable by the web server.</emphasis>
     </para>
     <note>
      <title>Technical Note</title>
@@ -22,6 +23,9 @@
        the web server document root.
       </para>
      </note>
+     <para>
+     See also <link linkend="variable.compile.id">$compile_id</link>.
+     </para>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:

docs/en/programmers/api-variables/variable-debugging.xml

@@ -13,7 +13,7 @@
       See also
       <link linkend="language.function.debug">{debug}</link>,
       <link linkend="variable.debug.tpl">$debug_tpl</link>,
-      and <link linkend="variable.debugging.ctrl">$debuging_ctrl</link>
+      and <link linkend="variable.debugging.ctrl">$debugging_ctrl</link>
       </para>
 </sect1>
 <!-- Keep this comment at the end of the file

docs/en/programmers/api-variables/variable-error-reporting.xml

@@ -10,6 +10,13 @@
    linkend="chapter.debugging.console">debugging</link> is enabled this value
   is ignored and the error-level is left untouched.
  </para>
+ <para>
+  See also
+  <link linkend="api.trigger.error">trigger_error()</link>,
+  <link linkend="chapter.debugging.console">debugging</link>
+  and
+  <link linkend="troubleshooting">Troubleshooting</link>.
+ </para>
 </sect1>
 
 <!-- Keep this comment at the end of the file

docs/en/programmers/api-variables/variable-left-delimiter.xml

@@ -7,7 +7,10 @@
   Default is "{".			
  </para>
  <para>
-  See also <link linkend="variable.right.delimiter">$right_delimiter</link>.
+  See also <link linkend="variable.right.delimiter">$right_delimiter</link>
+  and
+  <link linkend="language.escaping">escaping smarty parsing</link>
+  .
  </para>
 </sect1>
 

docs/en/programmers/api-variables/variable-right-delimiter.xml

@@ -7,7 +7,9 @@
   Default is "}".			
  </para>
  <para>
-  See also <link linkend="variable.left.delimiter">$left_delimiter</link>.
+  See also <link linkend="variable.left.delimiter">$left_delimiter</link>
+    and
+  <link linkend="language.escaping">escaping smarty parsing</link>.
  </para>
 </sect1>
 

docs/en/programmers/api-variables/variable-use-sub-dirs.xml

@@ -10,9 +10,17 @@
       <note>
       <title>Technical Note</title>
       <para>
-          Since Smarty-2.6.2 <varname>use_sub_dirs</varname> defaults to false.
+          Since Smarty-2.6.2 <varname>$use_sub_dirs</varname> defaults to false.
       </para>
       </note>
+ <para>
+  See also <link linkend="variable.template.dir">$template_dir</link>,
+  <link linkend="variable.compile.dir">$compile_dir</link>,
+  <link linkend="variable.config.dir">$config_dir</link>,
+  <link linkend="variable.plugins.dir">$plugins_dir</link>
+  and
+  <link linkend="variable.cache.dir">$cache_dir</link>.
+ </para>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables: