diff --git a/docs/es/designers/language-basic-syntax/language-syntax-comments.xml b/docs/es/designers/language-basic-syntax/language-syntax-comments.xml
index 5d646167..ddd810be 100644
--- a/docs/es/designers/language-basic-syntax/language-syntax-comments.xml
+++ b/docs/es/designers/language-basic-syntax/language-syntax-comments.xml
@@ -4,7 +4,7 @@
  <title>Comentarios</title>
  <para>
   Los comentarios en los templates son cercados por asteriscos, y por 
-  los delimitadores, así:<br> {* este es un comentario *}.
+  los delimitadores, así: {* este es un comentario *}.
   Los comentarios en Smarty no son mostrados en la salida final del
   template. 
   Estos son usados para hacer notas internas dentro del template.
diff --git a/docs/es/getting-started.xml b/docs/es/getting-started.xml
index 0f995cc4..e743d8f1 100644
--- a/docs/es/getting-started.xml
+++ b/docs/es/getting-started.xml
@@ -165,7 +165,7 @@ debug.tpl
    </example>
    <para>
     Smarty utiliza una constante de PHP llamada <link
-    linkend="constant.smarty.dir">SMARTY_DIR</A> que es la ruta para 
+    linkend="constant.smarty.dir">SMARTY_DIR</link> que es la ruta para 
     el directorio de la biblioteca de Smarty. Basicamente, si su 
     aplicación puede encontrar el archivo <emphasis>Smarty.class.php
     </emphasis>, usted no necesita definir SMARTY_DIR, Smarty lo 
diff --git a/docs/es/language-defs.ent b/docs/es/language-defs.ent
new file mode 100644
index 00000000..4ce1da18
--- /dev/null
+++ b/docs/es/language-defs.ent
@@ -0,0 +1,6 @@
+<!-- $Revision$ -->
+
+<!ENTITY SMARTYManual      "Smarty Manual">
+<!ENTITY SMARTYDesigners   "Smarty For Template Designers">
+<!ENTITY SMARTYProgrammers "Smarty For Programmers">
+<!ENTITY Appendixes        "Appendixes">
diff --git a/docs/es/language-snippets.ent b/docs/es/language-snippets.ent
new file mode 100644
index 00000000..92c0b3ca
--- /dev/null
+++ b/docs/es/language-snippets.ent
@@ -0,0 +1,24 @@
+<!-- $Revision$ -->
+
+<!ENTITY note.parameter.merge '<note>
+ <title>Technical Note</title>
+ <para>
+  The <parameter>merge</parameter> parameter respects array keys, so if
+  you merge two numerically indexed arrays, they may overwrite each other
+  or result in non-sequential keys. This is unlike the array_merge() function
+  of PHP which wipes out numerical keys and renumbers them.
+ </para>
+</note>'>
+
+<!ENTITY parameter.compileid '<para>
+ As an optional third parameter, you can pass a <parameter>compile_id</parameter>. 
+ This is in the event that you want to compile different versions of
+ the same template, such as having separate templates compiled
+ for different languages. Another use for compile_id is when you
+ use more than one $template_dir but only one $compile_dir. Set
+ a separate <parameter>compile_id</parameter> for each $template_dir, otherwise
+ templates of the same name will overwrite each other. You can
+ also set the <link
+ linkend="variable.compile.id">$compile_id</link> variable once
+ instead of passing this to each call to this function.
+</para>'>
diff --git a/docs/es/programmers/plugins/plugins-block-functions.xml b/docs/es/programmers/plugins/plugins-block-functions.xml
index 3ac66d6a..aaae18cb 100644
--- a/docs/es/programmers/plugins/plugins-block-functions.xml
+++ b/docs/es/programmers/plugins/plugins-block-functions.xml
@@ -46,7 +46,7 @@
 
     <para>
      El parámetro <parameter>&amp;$repeat</parameter> es pasado por
-     referencia para la funci&oacuten de implementación y proporciona
+     referencia para la funci&oacute;n de implementación y proporciona
      la posibilidad de controlar cuantas veces será mostrado el bloque.
      Por default <parameter>$repeat</parameter> es <literal>true</literal>
      en la primera llamada de la block-function (etiqueta de apertura del