huge sync with english by the translator (Mario Ramirez)

thanks

docs/es/programmers/api-variables/variable-cache-dir.xml

@@ -4,16 +4,24 @@
       <title>$cache_dir</title>
       <para>
        Este es el nombre del directorio donde los caches del template 
-       son almacenados. Por default es "./cache", esto significa que 
+       son almacenados. Por default es 
+       <filename class="directory">"./cache"</filename>, esto significa que 
        buscara el directorio de cache en el mismo directorio que ejecuta 
-       el scripts PHP. Usted puede usar tambi<62>n su propia funci<63>n habitual 
-       de mantenimiento de cache para manipular los archivos de cache, que 
+       el scripts PHP. 
+       <emphasis role="bold">Este directorio debe ser regrabable por el
+        servidor web</emphasis>
+       (<link linkend="installing.smarty.basic">ver intalaci<63>n</link>).
+       Usted puede usar tambi<62>n su propia  
+       <link linkend="section.template.cache.handler.func">funci<EFBFBD>n habitual 
+        de mantenimiento</link> de cache para manipular los archivos de cache, que 
        ignorar<61> est<73> configuraci<63>n.
+       Ver tambien <link linkend="variable.use.sub.dirs">$use_sub_dirs</link>.
       </para>
+
       <note>
        <title>Nota T<>cnica</title>
        <para>
-       Esta configuraci<63>n debe ser cualquiera de las dos, un path
+       Esta configuraci<63>n debe ser cualquiera de estas dos, un path
        relativo o absoluto. include_path no es usado para escribir archivos.
        </para>
       </note>
@@ -21,9 +29,18 @@
        <title>Nota T<>cnica</title>
        <para>
         No es recomendado colocar este directorio bajo el directorio 
-        document root de su servidor web.
+        document root del servidor web.
        </para>
       </note>
+  <para>
+  Ver tambi<62>n 
+  <link linkend="variable.caching">$caching</link>,
+  <link linkend="variable.use.sub.dirs">$use_sub_dirs</link>,
+  <link linkend="variable.cache.lifetime">$cache_lifetime</link>,
+  <link linkend="variable.cache.handler.func">$cache_handler_func</link>,
+  <link linkend="variable.cache.modified.check">$cache_modified_check</link>
+  y <link linkend="caching">Caching section</link>.
+  </para>
      </sect1>
 
 <!-- Keep this comment at the end of the file