huge sync with english by the translator (Mario Ramirez)

thanks

docs/es/programmers/api-functions/api-append-by-ref.xml

@@ -3,10 +3,10 @@
 <refentry id="api.append.by.ref">
  <refnamediv>
   <refname>append_by_ref</refname>
-  <refpurpose></refpurpose>
+  <refpurpose>pasando valores por referencia</refpurpose>
  </refnamediv>
  <refsect1>
-  <title />
+  <title>Descipci<EFBFBD>n</title>
   <methodsynopsis>
    <type>void</type><methodname>append_by_ref</methodname>
    <methodparam><type>string</type><parameter>varname</parameter></methodparam>
@@ -14,9 +14,10 @@
    <methodparam choice="opt"><type>bool</type><parameter>merge</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Este es usado para adicionar valores al templete por referencia.
-   Si usted adiciona una variable por referencia entonces cambiara su valor,
-   el valor asignado sufrira el cambio tambi<62>n. Para objetos, append_by_ref() 
+   Este es usado para <link linkend="api.append">pasar</link> valores al 
+   templete por referencia. Si usted pasa una variable por referencia entonces 
+   cambiara su valor, el valor asignado sufrira el cambio tambi<62>n. Para 
+   <link linkend="advanced.features.objects">objetos</link>, append_by_ref() 
    tambi<62>n envia una copia en memoria del objeto adicionado. Vea el manual de 
    PHP en referenciando variables para una mejor explicaci<63>n del asunto.
    Si usted pasa el tercer par<61>metro en true, el valor ser<65> mezclado con el 
@@ -35,6 +36,11 @@ $smarty->append_by_ref("Address", $address);
 ]]>
    </programlisting>
   </example>
+  <para>
+   Ver tambi<62>n <link linkend="api.append">append()</link> 
+   y <link linkend="api.assign">assign()</link>.
+  </para>
+
  </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file