corections errors DOC-ES

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@19956 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/es/module_specs/Zend_Application-AvailableResources-Modules.xml

@@ -4,39 +4,25 @@
 <sect2 id="zend.application.available-resources.modules">
     <title>Zend_Application_Resource_Modules</title>
     <para>
-        <classname>Zend_Application_Resource_Modules</classname>
-        se utiliza
-        para inicializar sus módulos de aplicación. Si su módulo tiene un
-        archivo
-        <filename>Bootstrap.php</filename>
-        en su raíz, y contiene una clase
-        llamada
-        <classname>Module_Bootstrap</classname>
-        (donde "Module" es el nombre del
-        módulo), entonces usará esa clase para arrancar el módulo.
-    </para>
-    <para>
-        Por defecto, se creará una instancia de
-        <classname>Zend_Application_Module_Autoloader</classname>
-        para el
+        <classname>Zend_Application_Resource_Modules</classname> se utiliza para
+        inicializar sus módulos de aplicación. Si su módulo tiene un archivo
+            <filename>Bootstrap.php</filename> en su raíz, y contiene una clase
+        llamada <classname>Module_Bootstrap</classname> (donde "Module" es el
+        nombre del módulo), entonces usará esa clase para arrancar el módulo. </para>
+    <para> Por defecto, se creará una instancia de
+            <classname>Zend_Application_Module_Autoloader</classname> para el
         módulo, utilizando el nombre del módulo y del directorio para
-        inicializarlo.
-    </para>
+        inicializarlo. </para>
 
-    <para>
-        Ya que los módulos no reciben ningún parámetro por defecto, para poder activarlos via
-        configuración,
-        será necesario crearlo como un array vacío. Seguiendo el estilo de
-        configuración
-        <acronim>INI</acronim>
-        será similar a:
-    </para>
-    <programlisting language="ini"><![CDATA[resources.modules[] =]]></programlisting>
-    <para>
-        Siguiendo el estilo de configuración
-        <acronym>XML</acronym>
-        será similar a:
-    </para>
+    <para> Ya que los módulos no reciben ningún parámetro por defecto, para
+        poder activarlos via configuración, será necesario crearlo como un array
+        vacío. Seguiendo el estilo de configuración <acronym>INI</acronym> será
+        similar a: </para>
+    <programlisting language="ini"><![CDATA[
+        resources.modules[] =
+        ]]></programlisting>
+    <para> Siguiendo el estilo de configuración <acronym>XML</acronym> será
+        similar a: </para>
     <programlisting language="xml"><![CDATA[
         <resources>
             <modules>
@@ -45,11 +31,8 @@
             </modules>
         </resources>
 ]]></programlisting>
-    <para>
-        Utilizando un array
-        <acronym>PHP</acronym>
-        estandar, simplemente creelo como un array vacío:
-    </para>
+    <para> Utilizando un array <acronym>PHP</acronym> estandar, simplemente
+        creelo como un array vacío: </para>
     <programlisting language="php"><![CDATA[
 $options = array(
     'resources' => array(
@@ -60,41 +43,25 @@ $options = array(
 
     <note>
         <title>Dependencia de Recursos del Front Controller</title>
-        <para>
-            El recurso Modules tiene una dependencia de
-            <link linkend="zend.application.available-resources.frontcontroller">
-                Front Controller resource</link>
-            . Usted puede, por supuesto,
-            proporcionar su propia sustitución de ese recurso mediante
-            un
+        <para> El recurso Modules tiene una dependencia de <link
+                linkend="zend.application.available-resources.frontcontroller">
+                Front Controller resource</link> . Usted puede, por supuesto,
+            proporcionar su propia sustitución de ese recurso mediante un
             recurso personalizado de la clase Front Controller o un método
-            inicializador de la
-            clase -- tan largo como se quiera siempre que
-            el plugin del recurso de la clase termine
-            en "Frontcontroller"
-            o el método inicializador se llame "_initFrontController"
-            (case
-            insensible).
-        </para>
+            inicializador de la clase -- tan largo como se quiera siempre que el
+            plugin del recurso de la clase termine en "Frontcontroller" o el
+            método inicializador se llame "_initFrontController" (case
+            insensible). </para>
     </note>
     <example id="zend.application.available-resources.modules.configExample">
         <title>Configurando Módulos</title>
-        <para>
-            Usted puede especificar una configuración específica de un módulo
-            utilizando el nombre
-            del módulo como un prefijo/sub-sección en su
-            archivo de configuración.
-       </para>
-        <para>
-            Por ejemplo, supongamos que su aplicación tiene un módulo "noticias".
-            Los siguientes son
-            ejemplos de
-            <acronym>INI</acronym>
-            y
-            <acronym>XML</acronym>
-            que muestran la
-            configuración de recursos en ese módulo.
-        </para>
+        <para> Usted puede especificar una configuración específica de un módulo
+            utilizando el nombre del módulo como un prefijo/sub-sección en su
+            archivo de configuración. </para>
+        <para> Por ejemplo, supongamos que su aplicación tiene un módulo
+            "noticias". Los siguientes son ejemplos de <acronym>INI</acronym> y
+                <acronym>XML</acronym> que muestran la configuración de recursos
+            en ese módulo. </para>
         <programlisting language="ini"><![CDATA[
 [production]
 news.resources.db.adapter = "pdo_mysql"
@@ -126,18 +93,15 @@ news.resources.layout.layout = "news"
 </config>
 ]]></programlisting>
     </example>
-    <example id="zend.application.available-resources.modules.retrieveBootstrapExample">
+    <example
+        id="zend.application.available-resources.modules.retrieveBootstrapExample">
         <title>Recuperando el bootstrap de un módulo específico</title>
-        <para>
-            En ocasiones, puede que necesite para recuperar el objeto bootstrap
-            de un módulo
-            específico -- tal vez para ejecutar discretos
-            métodos bootstrap ,o a recoger el cargador
-            automático con el fin de
+        <para> En ocasiones, puede que necesite para recuperar el objeto
+            bootstrap de un módulo específico -- tal vez para ejecutar discretos
+            métodos bootstrap ,o a recoger el cargador automático con el fin de
             configurarlo. Esto puede hacerse utilizando el método
-            <methodname>getExecutedBootstraps()</methodname>
-            de los recursos de Módulo.
-        </para>
+                <methodname>getExecutedBootstraps()</methodname> de los recursos
+            de Módulo. </para>
         <programlisting language="php"><![CDATA[
 $resource = $bootstrap->getPluginResource('modules');
 $moduleBootstraps = $resource->getExecutedBootstraps();

documentation/manual/es/module_specs/Zend_Auth.xml

@@ -4,117 +4,61 @@
 <sect1 id="zend.auth.introduction">
     <title>Introducción</title>
     <para>
-        <classname>Zend_Auth</classname>
-        provee una
-        <acronym>API</acronym>
-        para
+        <classname>Zend_Auth</classname> provee una <acronym>API</acronym> para
         autenticación e incluye adaptadores concretos de autenticación para
-        escenarios de casos
-        de uso común.
-    </para>
+        escenarios de casos de uso común. </para>
     <para>
-        <classname>Zend_Auth</classname>
-        es concerniente sólo con
-        <emphasis>autenticación</emphasis>
-        y no con
-        <emphasis>autorización</emphasis>
-        . Autenticación es vagamente
-        definido como: determinar si una entidad realmente es lo que
-        pretende
+        <classname>Zend_Auth</classname> es concerniente sólo con
+            <emphasis>autenticación</emphasis> y no con
+            <emphasis>autorización</emphasis> . Autenticación es vagamente
+        definido como: determinar si una entidad realmente es lo que pretende
         ser (o sea, identificación), basandose en un grupo de credenciales.
-        Autorización, el
-        proceso de decidir si se permite a una entidad: acceso
-        a, o el realizar operaciones en, otras
-        entidades esta fuera del alcance
-        de
-        <classname>Zend_Auth</classname>
-        . Para más información sobre
-        autorización y control de acceso con Zend Framework, por favor
-        vea
-        <link linkend="zend.acl">Zend_Acl</link>
-        .
-    </para>
+        Autorización, el proceso de decidir si se permite a una entidad: acceso
+        a, o el realizar operaciones en, otras entidades esta fuera del alcance
+        de <classname>Zend_Auth</classname> . Para más información sobre
+        autorización y control de acceso con Zend Framework, por favor vea <link
+            linkend="zend.acl">Zend_Acl</link> . </para>
     <note>
-        <para>
-            La clase
-            <classname>Zend_Auth</classname>
-            implementa el patrón
+        <para> La clase <classname>Zend_Auth</classname> implementa el patrón
             Singleton - sólo una instancia de la clase está disponible - a
-            través de su método estático
-            <methodname>getInstance()</methodname>
-            . Esto significa que usar el operador
-            <emphasis>new</emphasis>
-            y
-            la keyword
-            <emphasis>clone</emphasis>
-            no va a funcionar con la
-            clase
-            <classname>Zend_Auth</classname>
-            : use
-            <methodname>Zend_Auth::getInstance()</methodname>
-            en su lugar.
+            través de su método estático <methodname>getInstance()</methodname>
+            . Esto significa que usar el operador <emphasis>new</emphasis> y la
+            keyword <emphasis>clone</emphasis> no va a funcionar con la clase
+                <classname>Zend_Auth</classname> : use
+                <methodname>Zend_Auth::getInstance()</methodname> en su lugar.
         </para>
     </note>
     <sect2 id="zend.auth.introduction.adapters">
 
         <title>Adaptadores</title>
 
-        <para>
-            Un adaptador
-            <classname>Zend_Auth</classname>
-            es usado para
+        <para> Un adaptador <classname>Zend_Auth</classname> es usado para
             autenticar en contra de un tipo particular de servicio de
-            autenticación,
-            como
-            <acronym>LDAP</acronym>
-            ,
-            <acronym>RDBMS</acronym>
-            , o almacenamiento basado en
-            ficheros. Diferentes adaptadores pueden tener opciones y
-            compotamientos muy diferentes, pero algunas cosas básicas son
-            comunes entre los
-            adaptadores de autenticación. Por ejemplo, aceptar
-            credenciales de autenticación
-            (incluyendo una identidad supuesta),
-            realizar consultas ante el servicio de
-            autenticación, y regresar
-            resultados, son comunes para los adaptadores
-            <classname>Zend_Auth</classname>
-            .
-        </para>
-
-        <para>
-            Cada clase adaptadora
-            <classname>Zend_Auth</classname>
-            implementa
-            <classname>Zend_Auth_Adapter_Interface</classname>
-            . Esta
-            interface define un metodo,
-            <methodname>authenticate()</methodname>
+            autenticación, como <acronym>LDAP</acronym> ,
+                <acronym>RDBMS</acronym> , o almacenamiento basado en ficheros.
+            Diferentes adaptadores pueden tener opciones y compotamientos muy
+            diferentes, pero algunas cosas básicas son comunes entre los
+            adaptadores de autenticación. Por ejemplo, aceptar credenciales de
+            autenticación (incluyendo una identidad supuesta), realizar
+            consultas ante el servicio de autenticación, y regresar resultados,
+            son comunes para los adaptadores <classname>Zend_Auth</classname> . </para>
+
+        <para> Cada clase adaptadora <classname>Zend_Auth</classname> implementa
+                <classname>Zend_Auth_Adapter_Interface</classname> . Esta
+            interface define un metodo, <methodname>authenticate()</methodname>
             , que la clase adaptadora debe implementar para realizar una
-            peticion de autenticación.
-            Cada clase adaptadora debe ser preparada
-            antes de llamar a
-            <methodname>authenticate()</methodname>
-            . Esta
+            peticion de autenticación. Cada clase adaptadora debe ser preparada
+            antes de llamar a <methodname>authenticate()</methodname> . Esta
             preparación del adaptador incluye la creación de credenciales (p.ej.
-            nombre de
-            usuario y contraseña) y la definición de valores para
-            opciones de configuración
-            especificos del adaptador, como valores de
-            coneccion a base de datos para un adaptador de
-            tabla de base de
-            datos.
-        </para>
+            nombre de usuario y contraseña) y la definición de valores para
+            opciones de configuración especificos del adaptador, como valores de
+            coneccion a base de datos para un adaptador de tabla de base de
+            datos. </para>
 
         <para>El siguente ejemplo es un adaptador de autenticación que requiere
-            que un nombre de
-            usuario y contraseña sean especificados para la
-            autenticación. Otros detalles, como la
-            forma de realizar peticiones
-            al servicio de autenticación, han sido omitídos por
-            brevedad:
-       </para>
+            que un nombre de usuario y contraseña sean especificados para la
+            autenticación. Otros detalles, como la forma de realizar peticiones
+            al servicio de autenticación, han sido omitídos por brevedad: </para>
 
         <programlisting language="php"><![CDATA[
 class MyAuthAdapter implements Zend_Auth_Adapter_Interface
@@ -143,23 +87,14 @@ class MyAuthAdapter implements Zend_Auth_Adapter_Interface
 }
 ]]></programlisting>
 
-        <para>
-            Como se ha indicado en su docblock,
-            <methodname>authenticate()</methodname>
-            debe regresar una
-            instancia de
-            <classname>Zend_Auth_Result</classname>
-            (o de una clase
-            derivada de
-            <classname>Zend_Auth_Result</classname>
-            ). Si por alguna
+        <para> Como se ha indicado en su docblock,
+                <methodname>authenticate()</methodname> debe regresar una
+            instancia de <classname>Zend_Auth_Result</classname> (o de una clase
+            derivada de <classname>Zend_Auth_Result</classname> ). Si por alguna
             razón es imposible realizar una petición de autenticación,
-            <methodname>authenticate()</methodname>
-            debería arrojar una
+                <methodname>authenticate()</methodname> debería arrojar una
             excepción que se derive de
-            <classname>Zend_Auth_Adapter_Exception</classname>
-            .
-        </para>
+                <classname>Zend_Auth_Adapter_Exception</classname> . </para>
 
     </sect2>
 
@@ -167,94 +102,61 @@ class MyAuthAdapter implements Zend_Auth_Adapter_Interface
 
         <title>Resultados</title>
 
-        <para>
-            Los adaptadores
-            <classname>Zend_Auth</classname>
-            regresan una instancia de
-            <classname>Zend_Auth_Result</classname>
-            con
-            <methodname>authenticate()</methodname>
-            para representar el
+        <para> Los adaptadores <classname>Zend_Auth</classname> regresan una
+            instancia de <classname>Zend_Auth_Result</classname> con
+                <methodname>authenticate()</methodname> para representar el
             resultado de un intento de autenticación. Los adaptadores llenan el
-            objeto
-            <classname>Zend_Auth_Result</classname>
-            en cuanto se
+            objeto <classname>Zend_Auth_Result</classname> en cuanto se
             construye, así que los siguientes cuatro métodos proveen un grupo
-            básico de
-            operaciones "frente al usuario" que son comunes a los
-            resultados de adaptadores
-            Zend_Auth:
-        </para>
+            básico de operaciones "frente al usuario" que son comunes a los
+            resultados de adaptadores Zend_Auth: </para>
 
-            <itemizedlist>
-                <listitem>
-                    <para>
-                        <methodname>isValid()</methodname>
-                        - regresa true si y
-                        solo si el resultado representa un intento de
-                        autenticación exitoso
-                    </para>
-                </listitem>
-                <listitem>
-                    <para>
-                        <methodname>getCode()</methodname>
-                        - regresa una
-                        constante identificadora
-                        <classname>Zend_Auth_Result</classname>
-                        para
-                        determinar el tipo de fallo en la autenticación o si ha
-                        sido exitosa.
-                        Este puede ser usado en situaciones cuando
-                        el desarrollador desea distinguir
-                        entre varios tipos de
-                        resultados de autenticación. Esto permite a los
-                        desarrolladores, por ejemplo, mantener estadísticas
-                        detalladas de los
-                        resultados de autenticación. Otro uso
-                        de esta característica es: proporcionar
-                        al usuario
-                        mensajes específicos detallados por razones de
-                        usabilidad, aunque
-                        los desarrolladores son exhortados a
-                        considerar el riesgo de proporcionar
-                        tales detalles a
-                        los usuarios, en vez de un mensaje general de fallo en
-                        la
-                        autenticación. Para más información, vea las
-                        siguientes notas:
-                    </para>
-                </listitem>
-                <listitem>
-                    <para>
-                        <methodname>getIdentity()</methodname>
-                        - regresa la
-                        identidad del intento de autenticación
-                    </para>
-                </listitem>
-                <listitem>
-                    <para>
-                        <methodname>getMessages()</methodname>
-                        - regresa un
-                        arreglo de mensajes pertinentes a un fallido intento de
-                        autenticación
-                    </para>
-                </listitem>
-            </itemizedlist>
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <methodname>isValid()</methodname> - regresa true si y solo
+                    si el resultado representa un intento de autenticación
+                    exitoso </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <methodname>getCode()</methodname> - regresa una constante
+                    identificadora <classname>Zend_Auth_Result</classname> para
+                    determinar el tipo de fallo en la autenticación o si ha sido
+                    exitosa. Este puede ser usado en situaciones cuando el
+                    desarrollador desea distinguir entre varios tipos de
+                    resultados de autenticación. Esto permite a los
+                    desarrolladores, por ejemplo, mantener estadísticas
+                    detalladas de los resultados de autenticación. Otro uso de
+                    esta característica es: proporcionar al usuario mensajes
+                    específicos detallados por razones de usabilidad, aunque los
+                    desarrolladores son exhortados a considerar el riesgo de
+                    proporcionar tales detalles a los usuarios, en vez de un
+                    mensaje general de fallo en la autenticación. Para más
+                    información, vea las siguientes notas: </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <methodname>getIdentity()</methodname> - regresa la
+                    identidad del intento de autenticación </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <methodname>getMessages()</methodname> - regresa un arreglo
+                    de mensajes pertinentes a un fallido intento de
+                    autenticación </para>
+            </listitem>
+        </itemizedlist>
 
 
         <para>El desarrollador podría desear ramificar basado en el tipo de
-            resultado de la
-            autenticación a fin de realizar operaciones mas
-            específicas. Algunas operaciones que los
-            desarrolladores podrían
+            resultado de la autenticación a fin de realizar operaciones mas
+            específicas. Algunas operaciones que los desarrolladores podrían
             encontrar útiles son: bloquear cuentas despues de varios intentos
             fallidos de ingresar una contraseña, marcar una dirección IP despues
-            de que ha intentado
-            muchas identidades no existentes, y porporcionar
-            al usuario mensajes especificos
-            resultados de la autenticación. Los
-            siguientes codigos de resultado están disponibles:
-       </para>
+            de que ha intentado muchas identidades no existentes, y porporcionar
+            al usuario mensajes especificos resultados de la autenticación. Los
+            siguientes codigos de resultado están disponibles: </para>
 
         <programlisting language="php"><![CDATA[
 Zend_Auth_Result::SUCCESS
@@ -266,9 +168,7 @@ Zend_Auth_Result::FAILURE_UNCATEGORIZED
 ]]></programlisting>
 
         <para>El siguiente ejemplo ilustra como un desarrollador podría
-            ramificar basado en el código
-            resultado:
-       </para>
+            ramificar basado en el código resultado: </para>
         <programlisting language="php"><![CDATA[
 // debtri de AuthController / loginAction
 $result = $this->_auth->authenticate($adapter);
@@ -300,66 +200,43 @@ switch ($result->getCode()) {
         <title>Persistencia de Identidad</title>
 
         <para>Autenticar una petición que incluye credenciales de autenticación
-            es util por sí mismo,
-            pero también es importante el soportar
-            mantener la identidad autenticada sin tener que
-            presentar las
+            es util por sí mismo, pero también es importante el soportar
+            mantener la identidad autenticada sin tener que presentar las
             credenciales de autenticación con cada petición.</para>
 
         <para>
-            <acronym>HTTP</acronym>
-            es un protocolo sin estado, sin embargo, se han desarrollado
-            técnicas como las cookies y
-            sesiones a fin de facilitar mantener el
-            estado a través de multiples peticiones en
-            aplicaciones web del lado
-            del servidor.
-        </para>
+            <acronym>HTTP</acronym> es un protocolo sin estado, sin embargo, se
+            han desarrollado técnicas como las cookies y sesiones a fin de
+            facilitar mantener el estado a través de multiples peticiones en
+            aplicaciones web del lado del servidor. </para>
 
         <sect3 id="zend.auth.introduction.persistence.default">
 
             <title>Persistencia por Defecto en la Sesión PHP</title>
 
-            <para>
-                Por defecto,
-                <classname>Zend_Auth</classname>
-                provee
+            <para> Por defecto, <classname>Zend_Auth</classname> provee
                 almacenamiento persistente de la identidad desde un intento de
-                autenticación
-                exitoso usando la sesión
-                <acronym>PHP</acronym>
-                . En un intento de
-                autenticación exitoso,
-                <methodname>end_Auth::authenticate()</methodname>
-                almacena la
-                identidad del resultado de autenticación en almacenamiento
-                persistente. A
-                menos que se configure diferente,
-                <classname>Zend_Auth</classname>
-                usa una clase de
+                autenticación exitoso usando la sesión <acronym>PHP</acronym> .
+                En un intento de autenticación exitoso,
+                    <methodname>end_Auth::authenticate()</methodname> almacena
+                la identidad del resultado de autenticación en almacenamiento
+                persistente. A menos que se configure diferente,
+                    <classname>Zend_Auth</classname> usa una clase de
                 almacenamiento llamada
-                <classname>Zend_Auth_Storage_Session</classname>
-                , la cual,
-                a su vez usa
-                <link linkend="zend.session">
+                    <classname>Zend_Auth_Storage_Session</classname> , la cual,
+                a su vez usa <link linkend="zend.session">
                     <classname>Zend_Session</classname>
-                </link>
-                . Una clase diferente podría ser utilizada mediante
+                </link> . Una clase diferente podría ser utilizada mediante
                 proveer un objeto que implemente
-                <classname>Zend_Auth_Storage_Interface</classname>
-                a
-                <methodname>Zend_Auth::setStorage()</methodname>
+                    <classname>Zend_Auth_Storage_Interface</classname> a
+                    <methodname>Zend_Auth::setStorage()</methodname>
             </para>
 
             <note>
-                <para>
-                    Si el automático almacenamiento persistente de la
-                    identidad no es apropiado para
-                    un caso en particular,
-                    entonces los desarrolladores podrían dejar de usar la
-                    clase
-                    <classname>Zend_Auth</classname>
-                    al mismo tiempo,
+                <para> Si el automático almacenamiento persistente de la
+                    identidad no es apropiado para un caso en particular,
+                    entonces los desarrolladores podrían dejar de usar la clase
+                        <classname>Zend_Auth</classname> al mismo tiempo,
                     utilizando en su lugar una clase adaptadora directamente.
                 </para>
             </note>
@@ -369,23 +246,16 @@ switch ($result->getCode()) {
                 <title>Modifying the Session Namespace</title>
 
                 <para>
-                    <classname>Zend_Auth_Storage_Session</classname>
-                    usa un
+                    <classname>Zend_Auth_Storage_Session</classname> usa un
                     espacionombre (namespace) de sesión 'Zend_Auth'. Este
-                    espacio-nombre podría
-                    ser OVERRIDDEN al pasar un valor
+                    espacio-nombre podría ser OVERRIDDEN al pasar un valor
                     diferente al contructor de
-                    <classname>Zend_Auth_Storage_Session</classname>
-                    , y
+                        <classname>Zend_Auth_Storage_Session</classname> , y
                     este valor es pasado internamente al constructor de
-                    <classname>Zend_Session_Namespace</classname>
-                    . Esto
+                        <classname>Zend_Session_Namespace</classname> . Esto
                     debería ocurrir antes de que se intente la autenticación, ya
-                    que
-                    <methodname>Zend_Auth::authenticate()</methodname>
-                    realiza
-                    el almacenamiento automático de la identidad.
-                </para>
+                    que <methodname>Zend_Auth::authenticate()</methodname>
+                    realiza el almacenamiento automático de la identidad. </para>
 
                 <programlisting language="php"><![CDATA[
 // Almacena una referencia a la instancia Singleton de Zend_Auth
@@ -411,36 +281,25 @@ $result = $auth->authenticate($authAdapter);
 
             <title>Implementando Almacenamiento Personalizado</title>
 
-            <para>
-                En ocaciones los desarrolladores podrían necesitar usar un
-                diferente comportamiento
-                de persistencia de identidad que el
-                provisto por
-                <classname>Zend_Auth_Storage_Session</classname>
-                .
+            <para> En ocaciones los desarrolladores podrían necesitar usar un
+                diferente comportamiento de persistencia de identidad que el
+                provisto por <classname>Zend_Auth_Storage_Session</classname> .
                 Para esos casos los desarrolladores podrían simplemente
-                implementar
-                <classname>Zend_Auth_Storage_Interface</classname>
-                y
+                implementar <classname>Zend_Auth_Storage_Interface</classname> y
                 suplir una instancia de la clase a
-                <methodname>Zend_Auth::setStorage()</methodname>
-                .
-            </para>
+                    <methodname>Zend_Auth::setStorage()</methodname> . </para>
 
             <example id="zend.auth.introduction.persistence.custom.example">
 
                 <title>Usando una Clase de Almacenamiento Personalizada</title>
 
-                <para>
-                    Para poder utilizar una clase de almacenamiento
-                    persistente de identidad
-                    diferente a
-                    <classname>Zend_Auth_Storage_Session</classname>
-                    , el
+                <para> Para poder utilizar una clase de almacenamiento
+                    persistente de identidad diferente a
+                        <classname>Zend_Auth_Storage_Session</classname> , el
                     desarrollador implementa
-                    <classname>Zend_Auth_Storage_Interface</classname>
-                    :
-                    <programlisting language="php"><![CDATA[
+                        <classname>Zend_Auth_Storage_Interface</classname> : 
+                </para> 
+                   <programlisting language="php"><![CDATA[
 class MyStorage implements Zend_Auth_Storage_Interface
 {
     /**
@@ -504,15 +363,12 @@ class MyStorage implements Zend_Auth_Storage_Interface
     }
 }
 ]]></programlisting>
-                </para>
+                
 
-                <para>
-                    A fin de poder usar esta clase de almacenamiento
+                <para> A fin de poder usar esta clase de almacenamiento
                     personalizada,
-                    <methodname>Zend_Auth::setStorage()</methodname>
-                    es
-                    invocada antes de intentar una petición de autenticación:
-                </para>
+                        <methodname>Zend_Auth::setStorage()</methodname> es
+                    invocada antes de intentar una petición de autenticación: </para>
                 <programlisting language="php"><![CDATA[
 // Instruye Zend_Auth para usar la clase de almacenamiento personalizada
 Zend_Auth::getInstance()->setStorage(new MyStorage());
@@ -536,36 +392,25 @@ $result = Zend_Auth::getInstance()->authenticate($authAdapter);
 
         <title>Uso</title>
 
-        <para>
-            Hay dos formas provistas de usar adaptadores
-            <classname>Zend_Auth</classname>
-            :
-
-        </para>
+        <para> Hay dos formas provistas de usar adaptadores
+                <classname>Zend_Auth</classname> : </para>
         <orderedlist>
             <listitem>
-                <para>
-                    indirectamente, a través de
-                    <methodname>Zend_Auth::authenticate()</methodname>
+                <para> indirectamente, a través de
+                        <methodname>Zend_Auth::authenticate()</methodname>
                 </para>
             </listitem>
             <listitem>
-                <para>
-                    directamente, a través del metodo
-                    <methodname>authenticate()</methodname>
-                    del
-                    adaptador
+                <para> directamente, a través del metodo
+                        <methodname>authenticate()</methodname> del adaptador
                 </para>
             </listitem>
         </orderedlist>
 
-        <para>
-            El siguiente ejemplo ilustra como usar el adaptador
-            <classname>:Zend_Auth</classname>
-            : indirectamente, a través del
-            uso de la clase
-            <classname>Zend_Auth</classname>
-            :
+        <para> El siguiente ejemplo ilustra como usar el adaptador
+                <classname>:Zend_Auth</classname> : indirectamente, a través del
+            uso de la clase <classname>Zend_Auth</classname> : 
+        </para>
             <programlisting language="php"><![CDATA[
 // Recibe una referencia a la instancia singleton de Zend_Auth
 $auth = Zend_Auth::getInstance();
@@ -588,13 +433,11 @@ if (!$result->isValid()) {
     // $result->getIdentity() === $username
 }
 ]]></programlisting>
-        </para>
+       
 
         <para>Una vez que la autenticación ha sido intentada en una petición,
-            como en el ejemplo
-            anterior, es fácil verificar si existe una
-            identidad autenticada exitosamente:
-       </para>
+            como en el ejemplo anterior, es fácil verificar si existe una
+            identidad autenticada exitosamente: </para>
         <programlisting language="php"><![CDATA[
 $auth = Zend_Auth::getInstance();
 if ($auth->hasIdentity()) {
@@ -603,36 +446,26 @@ if ($auth->hasIdentity()) {
 }
 ]]></programlisting>
 
-        <para>
-            Para remover una identidad del almacenamiento persistente,
-            simplemente usa el metodo
-            <methodname>clearIdentity()</methodname>
+        <para> Para remover una identidad del almacenamiento persistente,
+            simplemente usa el metodo <methodname>clearIdentity()</methodname>
             method. Comunmente esto sería usado para implementar una operación
-            "cerrar sesión" en la
-            aplicación:
+            "cerrar sesión" en la aplicación: 
+        </para>    
             <programlisting language="php"><![CDATA[
 Zend_Auth::getInstance()->clearIdentity();
 ]]></programlisting>
-        </para>
+        
 
-        <para>
-            Cuando el uso automático de almacenamiento persistente es
-            inapropiado para un caso en
-            particular, el desarrollador podría
+        <para> Cuando el uso automático de almacenamiento persistente es
+            inapropiado para un caso en particular, el desarrollador podría
             simplemente omitir el uso de la clase
-            <classname>Zend_Auth</classname>
-            , usando una clase adaptadora
-            directamente. El uso directo de una clase adaptadora
-            implica
+                <classname>Zend_Auth</classname> , usando una clase adaptadora
+            directamente. El uso directo de una clase adaptadora implica
             configurar y preparar un objeto adaptador y despues llamar a su
-            metodo
-            <methodname>authenticate()</methodname>
-            . Los detalles
+            metodo <methodname>authenticate()</methodname> . Los detalles
             específicos del adaptador son discutidos en la documentación de cada
             adaptador. El siguiente ejemplo utiliza directamente
-            <classname>MyAuthAdapter</classname>
-            :
-        </para>
+                <classname>MyAuthAdapter</classname> : </para>
 
         <programlisting language="php"><![CDATA[
 // Configura el adaptador de autenticación

documentation/manual/es/module_specs/Zend_Cache-Introduction.xml

@@ -4,58 +4,29 @@
 <sect1 id="zend.cache.introduction">
     <title>Introducción</title>
     <para>
-        <classname>Zend_Cache</classname>
-        provee una forma genérica para cualquier caché de datos.
-    </para>
-    <para>
-        El almacenamiento en caché en Zend Framework se opera por
-        interfaces, mientras que los
-        registros de caché son almacenados
-        a través de adapatadores del backend (
-        <emphasis>Archivo</emphasis>
-        ,
-        <emphasis>Sqlite</emphasis>
-        ,
-        <emphasis>Memcache</emphasis>
-        ...) mediante un sistema flexible de documentos de identidad y
-        etiquetas. Utilizando éstas,
-        es fácil en el futuro eliminar
-        determinados tipos de registro.(Ejemplo: "eliminar todos los
-        registros caché de determinada etiqueta").
-    </para>
-    <para>
-        El módulo principal (
-        <classname>Zend_Cache_Core</classname>
-        )
-        es genérico, flexible y configurable. Aun para sus necesidades
-        específicas existen frontends
-        de caché que extienden
-        <classname>Zend_Cache_Core</classname>
-        a conveniencia:
-        <emphasis>Output</emphasis>
-        ,
-        <emphasis>File</emphasis>
-        ,
-        <emphasis>Function</emphasis>
-        y
-        <emphasis>Class</emphasis>
-        .
-
-    </para>
+        <classname>Zend_Cache</classname> provee una forma genérica para
+        cualquier caché de datos. </para>
+    <para> El almacenamiento en caché en Zend Framework se opera por interfaces,
+        mientras que los registros de caché son almacenados a través de
+        adapatadores del backend ( <emphasis>Archivo</emphasis> ,
+            <emphasis>Sqlite</emphasis> , <emphasis>Memcache</emphasis> ...)
+        mediante un sistema flexible de documentos de identidad y etiquetas.
+        Utilizando éstas, es fácil en el futuro eliminar determinados tipos de
+        registro.(Ejemplo: "eliminar todos los registros caché de determinada
+        etiqueta"). </para>
+    <para> El módulo principal ( <classname>Zend_Cache_Core</classname> ) es
+        genérico, flexible y configurable. Aun para sus necesidades específicas
+        existen frontends de caché que extienden
+            <classname>Zend_Cache_Core</classname> a conveniencia:
+            <emphasis>Output</emphasis> , <emphasis>File</emphasis> ,
+            <emphasis>Function</emphasis> y <emphasis>Class</emphasis> . </para>
     <example id="zend.cache.introduction.example-1">
-        <title>
-            Obtener un frontend con
-            Zend_Cache::factory()
-        </title>
+        <title> Obtener un frontend con Zend_Cache::factory() </title>
         <para>
-            <methodname>Zend_Cache::factory()</methodname>
-            ejemplifica objetos correctos y los une. En este primer
-            ejemplo, usaremos el frontend
-            <emphasis>Core</emphasis>
-            junto con el backend
-            <emphasis>File</emphasis>
-            .
-        </para>
+            <methodname>Zend_Cache::factory()</methodname> ejemplifica objetos
+            correctos y los une. En este primer ejemplo, usaremos el frontend
+                <emphasis>Core</emphasis> junto con el backend
+                <emphasis>File</emphasis> . </para>
 
         <programlisting language="php"><![CDATA[
 $frontendOptions = array(
@@ -76,33 +47,23 @@ $cache = Zend_Cache::factory('Core',
     </example>
 
     <note>
-        <title>
-            Frontends y Backends Compuestos de Múltiples Palabras
-        </title>
-        <para>
-            Algunos frontends y backends se nombran usando varias
-            palabras, tal como 'ZenPlatform'.
-            Al fabricarlas las
-            especificamos, las separamos usando un separador de
-            palabras, como un
-            espacio (' '), guión ('-'), o punto ('.').
-       </para>
+        <title> Frontends y Backends Compuestos de Múltiples Palabras </title>
+        <para> Algunos frontends y backends se nombran usando varias palabras,
+            tal como 'ZenPlatform'. Al fabricarlas las especificamos, las
+            separamos usando un separador de palabras, como un espacio (' '),
+            guión ('-'), o punto ('.'). </para>
     </note>
 
     <example id="zend.cache.introduction.example-2">
-        <title>Almacenando en caché un resultado de consulta a una base de datos</title>
+        <title>Almacenando en caché un resultado de consulta a una base de
+            datos</title>
 
-        <para>
-            Ahora que tenemos un frontend, podemos almacenar en caché
-            cualquier tipo de dato (hemos
-            activado la serialización). Por
-            ejemplo, podemos almacenar en caché un resultado de una
-            consulta de base de datos muy costosa. Después de ser
-            almacenada en caché, no es
-            necesario ni conectar la base
-            de datos; los registros se obtienen del caché de forma no
-            serializada.
-       </para>
+        <para> Ahora que tenemos un frontend, podemos almacenar en caché
+            cualquier tipo de dato (hemos activado la serialización). Por
+            ejemplo, podemos almacenar en caché un resultado de una consulta de
+            base de datos muy costosa. Después de ser almacenada en caché, no es
+            necesario ni conectar la base de datos; los registros se obtienen
+            del caché de forma no serializada. </para>
 
         <programlisting language="php"><![CDATA[
 // $cache initializada en el ejemplo anterior
@@ -130,34 +91,19 @@ print_r($result);
     </example>
 
     <example id="zend.cache.introduction.example-3">
-        <title>
-            El almacenamiento en caché de salida con la interfaz de
-            salida
-            Zend_Cache
-        </title>
-        <para>
-            ‘Resaltamos’ las secciones en las que deseamos almacenar en
-            caché la salida, mediante la
-            adición de algunas condiciones lógicas,
+        <title> El almacenamiento en caché de salida con la interfaz de salida
+            Zend_Cache </title>
+        <para> 'Resaltamos' las secciones en las que deseamos almacenar en caché
+            la salida, mediante la adición de algunas condiciones lógicas,
             encapsulamos la sección dentro de los métodos
-            <methodname>start()</methodname>
-            y
-            <methodname>end()</methodname>
-            (esto se parece al primer ejemplo y es la estrategia
-            fundamental para el almacenamiento
-            en caché).
-        </para>
-        <para>
-            Dentro, los datos de salida, como siempre – todas las salidas
-            serán almacenadas en caché
-            cuando se ordene la ejecución del
-            método
-            <methodname>end()</methodname>
-            . En la siguiente ejecución, toda la sección se saltará a
-            favor de la búsqueda de datos
-            del caché (tanto tiempo como
-            el registro del caché sea válido).
-        </para>
+                <methodname>start()</methodname> y
+                <methodname>end()</methodname> (esto se parece al primer ejemplo
+            y es la estrategia fundamental para el almacenamiento en caché). </para>
+        <para> Dentro, los datos de salida, como siempre – todas las salidas
+            serán almacenadas en caché cuando se ordene la ejecución del método
+                <methodname>end()</methodname> . En la siguiente ejecución, toda
+            la sección se saltará a favor de la búsqueda de datos del caché
+            (tanto tiempo como el registro del caché sea válido). </para>
         <programlisting language="php"><![CDATA[
 $frontendOptions = array(
    'lifetime' => 30,                   // tiempo de vida de caché de 30 segundos
@@ -183,45 +129,25 @@ if(!$cache->start('mypage')) {
 
 echo 'Esto no estará en caché nunca ('.time().').';
 ]]></programlisting>
-        <para>
-            Note que delineamos el resultado de
-            <methodname>time()</methodname>
-            dos veces; esto es algo dinámico para los propósitos de la
-            demostración. Trate de
-            ejecutarlo y entonces regenérelo
-            muchas veces; notará que el primer número no cambia
-            mientras
-            que el segundo cambia a medida que pasa el tiempo. Esto
-            es porque el primer
-            número esta delineado en la sección
-            caché y esta guardado en medio de otras salidas.
-            Después de
-            medio minuto (habremos establecido el tiempo de vida de 30
-            segundos) los
-            números deben acoplarse nuevamente porque el
-            registro caché ha expirado -- sólo para ser
-            almacenado en
-            caché nuevamente. Deberá probarlo en su visualizador o
-            consola.
-        </para>
+        <para> Note que delineamos el resultado de
+                <methodname>time()</methodname> dos veces; esto es algo dinámico
+            para los propósitos de la demostración. Trate de ejecutarlo y
+            entonces regenérelo muchas veces; notará que el primer número no
+            cambia mientras que el segundo cambia a medida que pasa el tiempo.
+            Esto es porque el primer número esta delineado en la sección caché y
+            esta guardado en medio de otras salidas. Después de medio minuto
+            (habremos establecido el tiempo de vida de 30 segundos) los números
+            deben acoplarse nuevamente porque el registro caché ha expirado --
+            sólo para ser almacenado en caché nuevamente. Deberá probarlo en su
+            visualizador o consola. </para>
     </example>
     <note>
-        <para>
-            Cuando usamos
-            <classname>Zend_Cache</classname>
-            , ponemos atención a la importación
-            del identificador caché (pasado a
-            <methodname>save()</methodname>
-            y
-            <methodname>start()</methodname>
-            ). Éste deberá ser único para cada recurso que se almacene
-            en caché, de otra manera los
-            registros almacenados en caché
-            que no se vinculan podrían borrarse unos a otros, o peor
-            aún, mostrarse uno en lugar del otro.
-        </para>
+        <para> Cuando usamos <classname>Zend_Cache</classname> , ponemos
+            atención a la importación del identificador caché (pasado a
+                <methodname>save()</methodname> y
+                <methodname>start()</methodname> ). Éste deberá ser único para
+            cada recurso que se almacene en caché, de otra manera los registros
+            almacenados en caché que no se vinculan podrían borrarse unos a
+            otros, o peor aún, mostrarse uno en lugar del otro. </para>
     </note>
 </sect1>
-    <!--
-    vim:se ts=4 sw=4 et:
--->

documentation/manual/es/module_specs/Zend_Config-TheoryOfOperation.xml

@@ -4,165 +4,99 @@
 
 <sect1 id="zend.config.theory_of_operation">
     <title>Aspectos Teóricos</title>
+    <para> Los datos de configuración se hacen accesibles al constructor
+            <classname>Zend_Config</classname> a través de un array asociativo,
+        que puede ser multidimensional, para permitir organizar los datos desde
+        lo general a lo específico. Las clases de adaptador concretas permiten
+        construir una tabla asociativa para el constructor de
+            <classname>Zend_Config</classname> a partir de un sistema de
+        almacenamiento de datos de configuración. Algunos scripts de usuario
+        pueden proveer esos arrays directamente al constructor Zend_Config, sin
+        usar una clase adaptador, lo cual puede ser apropiado en ciertas
+        ocasiones. </para>
+    <para> Cada valor del array de datos de configuración se convierte en una
+        propiedad del objeto <classname>Zend_Config</classname> . La clave es
+        usada como el nombre de la propiedad. Si un valor es un array por sí
+        solo, entonces la propiedad de objeto resultante es creada como un nuevo
+        objeto <classname>Zend_Config</classname> , cargado con los datos del
+        array. Esto ocurre recursivamente, de forma que una jerarquía de datos
+        de configuración puede ser creada con cualquier número de niveles. </para>
     <para>
-        Los datos de configuración se hacen accesibles al constructor
-        <classname>Zend_Config</classname>
-        a través de
-        un array asociativo, que puede ser multidimensional, para permitir organizar los
-        datos desde lo general a lo
-        específico. Las clases de adaptador concretas permiten construir
-        una tabla asociativa para el constructor de
-        <classname>Zend_Config</classname>
-        a partir de un sistema de almacenamiento de datos de configuración.
-        Algunos scripts de
-        usuario pueden proveer esos arrays directamente al constructor Zend_Config, sin usar una
-        clase adaptador, lo cual puede ser apropiado en ciertas ocasiones.
-    </para>
-    <para>
-        Cada valor del array de datos de configuración se convierte en una propiedad del objeto
-        <classname>Zend_Config</classname>
-        . La clave es usada como el nombre de la propiedad. Si un valor es un
-        array por sí solo,
-        entonces la propiedad de objeto resultante es creada como un nuevo objeto
-        <classname>Zend_Config</classname>
-        , cargado con los datos del array. Esto ocurre recursivamente, de forma
-        que una jerarquía de
-        datos de configuración puede ser creada con cualquier número de niveles.
-    </para>
-    <para>
-        <classname>Zend_Config</classname>
-        implementa las interfaces
-        <emphasis>Countable</emphasis>
-        e
-        <emphasis>Iterator</emphasis>
-        para facilitar el aceso sencillo a los datos de configuración. Así, uno
-        puede usar la función
-        <ulink url="http://php.net/count">
+        <classname>Zend_Config</classname> implementa las interfaces
+            <emphasis>Countable</emphasis> e <emphasis>Iterator</emphasis> para
+        facilitar el aceso sencillo a los datos de configuración. Así, uno puede
+        usar la función <ulink url="http://php.net/count">
             <methodname>count()</methodname>
-        </ulink>
-        y constructores
-        <acronym>PHP</acronym>
-        como
-        <ulink url="http://php.net/foreach">
+        </ulink> y constructores <acronym>PHP</acronym> como <ulink
+            url="http://php.net/foreach">
             <emphasis>foreach</emphasis>
-        </ulink>
-        sobre objetos
-        <classname>Zend_Config</classname>
-        .
+        </ulink> sobre objetos <classname>Zend_Config</classname> . </para>
+    <para> Por defecto, los datos de configuración permitidos a través de
+            <classname>Zend_Config</classname> son de sólo lectura, y una
+        asignación (e.g., <methodname>$config-&gt;database-&gt;host =
+            'example.com'</methodname> ) provoca que se lance una excepción.
+        Este comportamiento por defecto puede ser sobrescrito a través del
+        constructor, sin embargo, para permitir la modificación de valores de
+        datos. Además, cuando las modificaciones están permitidas,
+            <classname>Zend_Config</classname> soporta el borrado de elementos
+        (unset) (i.e.
+            <methodname>unset($config-&gt;database-&gt;host);</methodname>
+        ). El método <methodname>readOnly()</methodname> puede ser usado para
+        determinar si las modificaciones a un objeto
+            <classname>Zend_Config</classname> están permitidas y el método
+            <methodname>setReadOnly()</methodname> puede ser usado para evitar
+        cualquier modificación posterior a un objeto
+            <classname>Zend_Config</classname> que fue creado con permiso de
+        modificaciones. 
     </para>
-    <para>
-        Por defecto, los datos de configuración permitidos a través de
-        <classname>Zend_Config</classname>
-        son de sólo
-        lectura, y una asignación (e.g.,
-        <methodname>$config-&gt;database-&gt;host = 'example.com'</methodname>
-        )
-        provoca que se lance una excepción. Este comportamiento por defecto puede ser sobrescrito a
-        través del
-        constructor, sin embargo, para permitir la modificación de valores de datos.
-        Además, cuando las modificaciones
-        están permitidas,
-        <classname>Zend_Config</classname>
-        soporta el borrado de elementos (unset) (i.e.
-        <methodname>unset($config-&gt;database-&gt;host);</methodname>
-        ). El método
-        <methodname>readOnly()</methodname>
-        puede ser usado para determinar si las modificaciones a un objeto
-        <classname>Zend_Config</classname>
-        están permitidas y el método
-        <methodname>setReadOnly()</methodname>
-        puede
-        ser usado para evitar cualquier modificación posterior a un objeto
-        <classname>Zend_Config</classname>
-        que fue
-        creado con permiso de modificaciones.
         <note>
-            <para>
-                Es importante no confundir tales modificaciones en memoria con guardar los datos de
-                configuración a
-                un medio de almacenamiento específico. Las herramientas para crear y
-                modificar datos de configuración
-                para distintos medios de almacenamiento están fuera
-                del alcance de
-                <classname>Zend_Config</classname>
-                .
-                Existen soluciones third-party de código abierto con el propósito de crear y
-                modificar datos de
-                configuración de distintos medios de almacenamiento.
-            </para>
+            <para> Es importante no confundir tales modificaciones en memoria
+                con guardar los datos de configuración a un medio de
+                almacenamiento específico. Las herramientas para crear y
+                modificar datos de configuración para distintos medios de
+                almacenamiento están fuera del alcance de
+                    <classname>Zend_Config</classname> . Existen soluciones
+                third-party de código abierto con el propósito de crear y
+                modificar datos de configuración de distintos medios de
+                almacenamiento. </para>
         </note>
+    
+    <para> Las clases del adaptador heredan de la clase
+            <classname>Zend_Config</classname> debido a que utilizan su
+        funcionalidad. </para>
+    <para> La familia de clases <classname>Zend_Config</classname> permite
+        organizar en secciones los datos de configuración. Los objetos de
+        adaptador <classname>Zend_Config</classname> pueden ser cargados con una
+        sola sección especificada, múltiples secciones especificadas, o todas
+        las secciones (si no se especifica ninguna). </para>
+    <para> Las clases del adaptador <classname>Zend_Config</classname> soportan
+        un modelo de herencia única que permite que los datos de configuración
+        hereden de una sección de datos de configuración a otra. Esto es
+        provisto con el fin de reducir o eliminar la necesidad de duplicar datos
+        de configuración por distintos motivos. Una sección heredada puede
+        también sobrescribir los valores que hereda de su sección padre. Al
+        igual que la herencia de clases <acronym>PHP</acronym> , una sección
+        puede heredar de una sección padre, la cual puede heredar de una sección
+        abuela, etc..., pero la herencia múltiple (i.e., la sección C heredando
+        directamente de las secciones padre A y B) no está permitida. </para>
+    <para> Si tiene dos objetos <classname>Zend_Config</classname> , puede
+        combinarlos en un único objeto usando la función
+            <methodname>merge()</methodname> . Por ejemplo, dados
+            <varname>$config</varname> y <varname>$localConfig</varname> , puede
+        fusionar datos de <varname>$localConfig</varname> a
+            <varname>$config</varname> usando
+            <methodname>$config-&gt;merge($localConfig);</methodname> . Los
+        ítemes en <varname>$localConfig</varname> sobrescribirán cualquier item
+        con el mismo nombre en <varname>$config</varname> . 
     </para>
-    <para>
-        Las clases del adaptador heredan de la clase
-        <classname>Zend_Config</classname>
-        debido a que utilizan su
-        funcionalidad.
-    </para>
-    <para>
-        La familia de clases
-        <classname>Zend_Config</classname>
-        permite organizar en secciones los datos de
-        configuración. Los objetos de adaptador
-        <classname>Zend_Config</classname>
-        pueden ser cargados con una sola
-        sección especificada, múltiples secciones especificadas, o
-        todas las secciones (si no se especifica ninguna).
-    </para>
-    <para>
-        Las clases del adaptador
-        <classname>Zend_Config</classname>
-        soportan un modelo de herencia única que permite
-        que los datos de configuración hereden de
-        una sección de datos de configuración a otra. Esto es provisto con el
-        fin de reducir o
-        eliminar la necesidad de duplicar datos de configuración por distintos motivos. Una sección
-        heredada puede también sobrescribir los valores que hereda de su sección padre. Al igual que
-        la herencia de
-        clases
-        <acronym>PHP</acronym>
-        , una sección puede heredar de una sección padre, la cual puede heredar de una
-        sección
-        abuela, etc..., pero la herencia múltiple (i.e., la sección C heredando directamente de las
-        secciones
-        padre A y B) no está permitida.
-    </para>
-    <para>
-        Si tiene dos objetos
-        <classname>Zend_Config</classname>
-        , puede combinarlos en un único objeto usando la
-        función
-        <methodname>merge()</methodname>
-        . Por ejemplo, dados
-        <varname>$config</varname>
-        y
-        <varname>$localConfig</varname>
-        , puede fusionar datos de
-        <varname>$localConfig</varname>
-        a
-        <varname>$config</varname>
-        usando
-        <methodname>$config-&gt;merge($localConfig);</methodname>
-        . Los
-        ítemes en
-        <varname>$localConfig</varname>
-        sobrescribirán cualquier item con el mismo nombre en
-        <varname>$config</varname>
-        .
         <note>
-            <para>
-                El objeto
-                <classname>Zend_Config</classname>
-                que está ejecutando el merge debe haber sido construido
-                para permitir modificaciones,
-                pasando
-                <constant>TRUE</constant>
-                como el segundo parámetro del
-                constructor. El método
-                <methodname>setReadOnly()</methodname>
-                puede entonces ser usado para evitar
-                cualquier modificación posterior después de que
-                el merge se haya completado.
-            </para>
+            <para> El objeto <classname>Zend_Config</classname> que está
+                ejecutando el merge debe haber sido construido para permitir
+                modificaciones, pasando <constant>TRUE</constant> como el
+                segundo parámetro del constructor. El método
+                    <methodname>setReadOnly()</methodname> puede entonces ser
+                usado para evitar cualquier modificación posterior después de
+                que el merge se haya completado. </para>
         </note>
-    </para>
+   
 </sect1>

documentation/manual/es/module_specs/Zend_Config_Ini.xml

@@ -4,116 +4,62 @@
 <sect1 id="zend.config.adapters.ini">
     <title>Zend_Config_Ini</title>
     <para>
-        <classname>Zend_Config_Ini</classname>
-        permite a los desarrolladores almacenar datos de configuración
-        en un formato de datos
-        <acronym>INI</acronym>
-        familiar, y leer de ellos en la
-        aplicación usando una sintáxis de propiedades de objetos
-        anidados. El formato
-        <acronym>INI</acronym>
-        se especializa en proveer tanto la
-        habilidad de mantener una jerarquía de claves de datos
-        (data
-        keys) de configuración como la de mantener una jerarquía entre
-        secciones de datos de
-        configuración. Las jerarquías de datos de
-        configuración son provistas separando las claves
-        mediante el
-        carácter punto (
-        "
-        <emphasis>.</emphasis>
-        "
-        ). Una sección puede extender o heredar de otra sección
-        indicando el nombre de la sección
-        seguido de dos puntos (
-        "
-        <emphasis>:</emphasis>
-        "
-        ) y el nombre de la sección desde la cual se quieren heredar los
-        datos.
-    </para>
+        <classname>Zend_Config_Ini</classname> permite a los desarrolladores
+        almacenar datos de configuración en un formato de datos
+            <acronym>INI</acronym> familiar, y leer de ellos en la aplicación
+        usando una sintáxis de propiedades de objetos anidados. El formato
+            <acronym>INI</acronym> se especializa en proveer tanto la habilidad
+        de mantener una jerarquía de claves de datos (data keys) de
+        configuración como la de mantener una jerarquía entre secciones de datos
+        de configuración. Las jerarquías de datos de configuración son provistas
+        separando las claves mediante el carácter punto ( "
+            <emphasis>.</emphasis> " ). Una sección puede extender o heredar de
+        otra sección indicando el nombre de la sección seguido de dos puntos ( "
+            <emphasis>:</emphasis> " ) y el nombre de la sección desde la cual
+        se quieren heredar los datos. </para>
     <note>
         <title>parse_ini_file</title>
         <para>
-            <classname>Zend_Config_Ini</classname>
-            utiliza la función
-            <ulink url="http://php.net/parse_ini_file">
+            <classname>Zend_Config_Ini</classname> utiliza la función <ulink
+                url="http://php.net/parse_ini_file">
                 <methodname>parse_ini_file()</methodname>
-            </ulink>
-            de
-            <acronym>PHP</acronym>
-            . Por favor, revise esta documentación para observar
-            sus comportamientos específicos, que
-            se propagan a
-            <classname>Zend_Config_Ini</classname>
-            , tales como la forma en que los valores especiales:
-            "
-            <constant>TRUE</constant>
-            "
-            ,
-            "
-            <constant>FALSE</constant>
-            "
-            ,
-            "yes"
-            ,
-            "no"
-            , y
-            <constant>NULL</constant>
-            son manejados.
-        </para>
+            </ulink> de <acronym>PHP</acronym> . Por favor, revise esta
+            documentación para observar sus comportamientos específicos, que se
+            propagan a <classname>Zend_Config_Ini</classname> , tales como la
+            forma en que los valores especiales: " <constant>TRUE</constant> " ,
+            " <constant>FALSE</constant> " , "yes" , "no" , y
+                <constant>NULL</constant> son manejados. </para>
     </note>
     <note>
         <title>Separador de clave</title>
-        <para>
-            Por defecto, el carácter separador de clave es el punto (
-            "
-            <emphasis>.</emphasis>
-            "
-            ). Puede ser reemplazado, no obstante,cambiando la clave de
-            <varname>$options</varname>
-            llamada
-            <property>nestSeparator</property>
-            al construir el objeto
-            <classname>Zend_Config_Ini</classname>
-            . Por ejemplo:
+        <para> Por defecto, el carácter separador de clave es el punto ( "
+                <emphasis>.</emphasis> " ). Puede ser reemplazado, no
+            obstante,cambiando la clave de <varname>$options</varname> llamada
+                <property>nestSeparator</property> al construir el objeto
+                <classname>Zend_Config_Ini</classname> . Por ejemplo: 
+        </para>
             <programlisting language="php"><![CDATA[
 $options['nestSeparator'] = ':';
 $config = new Zend_Config_Ini('/path/to/config.ini',
                               'pruebas',
                               $options);
 ]]></programlisting>
-        </para>
+        
     </note>
     <example id="zend.config.adapters.ini.example.using">
         <title>Utilizando Zend_Config_Ini</title>
-        <para>
-            Este ejemplo muestra una forma de uso básica de
-            <classname>Zend_Config_Ini</classname>
-            para cargar datos de configuración de un archivo
-            <acronym>INI</acronym>
-            . En
-            este ejemplo hay datos de configuración tanto para un
-            sistema de producción como para
-            un sistema en fase de
-            pruebas. Debido a que los datos de la fase de pruebas son
-            muy
-            parecidos a los de producción, la sección de pruebas
-            hereda de la sección de producción.
-            En este caso, la
-            decisión es arbitraria y podría haberse escrito a la
-            inversa, con la
-            sección de producción heredando de la
-            sección de pruebas, a pesar de que éste no sería el
-            caso
-            para situaciones más complejas. Supongamos, entonces, que
-            los siguientes datos de
-            configuración están contenidos en
-            <filename>/path/to/config.ini</filename>
-            :
-            :
-        </para>
+        <para> Este ejemplo muestra una forma de uso básica de
+                <classname>Zend_Config_Ini</classname> para cargar datos de
+            configuración de un archivo <acronym>INI</acronym> . En este ejemplo
+            hay datos de configuración tanto para un sistema de producción como
+            para un sistema en fase de pruebas. Debido a que los datos de la
+            fase de pruebas son muy parecidos a los de producción, la sección de
+            pruebas hereda de la sección de producción. En este caso, la
+            decisión es arbitraria y podría haberse escrito a la inversa, con la
+            sección de producción heredando de la sección de pruebas, a pesar de
+            que éste no sería el caso para situaciones más complejas.
+            Supongamos, entonces, que los siguientes datos de configuración
+            están contenidos en <filename>/path/to/config.ini</filename> : : </para>
         <programlisting language="ini"><![CDATA[
 ; Datos de configuración de la web de producción
 [produccion]
@@ -131,17 +77,11 @@ database.params.host     = dev.example.com
 database.params.username = devuser
 database.params.password = devsecret
 ]]></programlisting>
-        <para>
-            Ahora, asuma que el desarrollador de aplicaciones necesita
-            los datos de configuración de
-            la etapa de pruebas del
-            archivo
-            <acronym>INI</acronym>
-            . Resulta fácil cargar estos datos especificando
-            el archivo
-            <acronym>INI</acronym>
-            en la sección de la etapa de pruebas:
-        </para>
+        <para> Ahora, asuma que el desarrollador de aplicaciones necesita los
+            datos de configuración de la etapa de pruebas del archivo
+                <acronym>INI</acronym> . Resulta fácil cargar estos datos
+            especificando el archivo <acronym>INI</acronym> en la sección de la
+            etapa de pruebas: </para>
         <programlisting language="php"><![CDATA[
 $config = new Zend_Config_Ini('/path/to/config.ini', 'pruebas');
 
@@ -164,51 +104,35 @@ echo $config->database->params->dbname; // muestra "dbname"
                         <entry>
                             <varname>$filename</varname>
                         </entry>
-                        <entry>
-                            El archivo
-                            <acronym>INI</acronym>
-                            que se va a cargar.
-                        </entry>
+                        <entry> El archivo <acronym>INI</acronym> que se va a
+                            cargar. </entry>
                     </row>
                     <row>
                         <entry>
                             <varname>$section</varname>
                         </entry>
-                        <entry>
-                            La [sección] contenida en el archivo
-                            <acronym>INI</acronym>
-                            que
-                            se va a cargar. Fijar este parámetro a
-                            <constant>NULL</constant>
-                            cargará todas las secciones.
-                            Alternativamente, se puede introducir un
-                            array de nombres de sección para cargar
-                            multiples secciones.
-                        </entry>
+                        <entry> La [sección] contenida en el archivo
+                                <acronym>INI</acronym> que se va a cargar. Fijar
+                            este parámetro a <constant>NULL</constant> cargará
+                            todas las secciones. Alternativamente, se puede
+                            introducir un array de nombres de sección para
+                            cargar multiples secciones. </entry>
                     </row>
                     <row>
 
                         <entry>
-                            <varname>$options</varname>
-                            (default
-                            <constant>FALSE</constant>
-                            )
-                        </entry>
+                            <varname>$options</varname> (default
+                                <constant>FALSE</constant> ) </entry>
 
-                        <entry>
-                            Array de opciones. Las siguientes claves
-                            están aceptadas:
-                            <itemizedlist>
+                        <entry> Array de opciones. Las siguientes claves están
+                            aceptadas: <itemizedlist>
                                 <listitem>
                                     <para>
                                         <emphasis>
-                                            <property>allowModifications</property>
-                                        </emphasis>
-                                        :
-                                        : Fijar a
-                                        <constant>TRUE</constant>
-                                        para permitir modificaciones
-                                        subsiguientes del archivo
+                                        <property>allowModifications</property>
+                                        </emphasis> : : Fijar a
+                                        <constant>TRUE</constant> para permitir
+                                        modificaciones subsiguientes del archivo
                                         cargado. Por defecto es
                                         <constant>NULL</constant>
                                     </para>
@@ -216,12 +140,10 @@ echo $config->database->params->dbname; // muestra "dbname"
                                 <listitem>
                                     <para>
                                         <emphasis>
-                                            <property>nestSeparator</property>
-                                        </emphasis>
-                                        : Carácter que utilizar como
-                                        separador de anidamiento. Por
-                                        defecto es "."
-                                    </para>
+                                        <property>nestSeparator</property>
+                                        </emphasis> : Carácter que utilizar como
+                                        separador de anidamiento. Por defecto es
+                                        "." </para>
                                 </listitem>
                             </itemizedlist>
                         </entry>
@@ -231,6 +153,3 @@ echo $config->database->params->dbname; // muestra "dbname"
         </table>
     </note>
 </sect1>
-    <!--
-    vim:se ts=4 sw=4 et:
--->

documentation/manual/es/module_specs/Zend_Controller-ActionHelpers-Redirector.xml

@@ -7,237 +7,140 @@
     <sect4 id="zend.controller.actionhelper.redirector.introduction">
         <title>Introducción</title>
 
-        <para>
-            El ayudante
-            <emphasis>Redirector</emphasis>
-            le permite
-            utilizar un objeto de redireccionamiento para cumplir con
-            necesidades de su
-            aplicación para redireccionar a una nueva
-            <acronym>URL</acronym>
-            .
+        <para> El ayudante <emphasis>Redirector</emphasis> le permite utilizar
+            un objeto de redireccionamiento para cumplir con necesidades de su
+            aplicación para redireccionar a una nueva <acronym>URL</acronym> .
             Ofrece numerosas ventajas sobre el método
-            <methodname>_redirect()</methodname>
-            , tales como poder
+                <methodname>_redirect()</methodname> , tales como poder
             preconfigurar un comportamiento para todo el sitio en el objeto
-            redirector o usando el construido en
-            <methodname>gotoSimple($action,
-                $controller, $module, $params)</methodname>
-            , interfaz similar a
-            la de
-            <methodname>Zend_Controller_Action::_forward()</methodname>
-            .
-        </para>
-
-        <para>
-            El
-            <emphasis>Redirector</emphasis>
-            tiene un número de métodos
-            que pueden utilizarse para afectar el comportamiento al
-            redireccionar:
-        </para>
+            redirector o usando el construido en <methodname>gotoSimple($action,
+                $controller, $module, $params)</methodname> , interfaz similar a
+            la de <methodname>Zend_Controller_Action::_forward()</methodname> . </para>
+
+        <para> El <emphasis>Redirector</emphasis> tiene un número de métodos que
+            pueden utilizarse para afectar el comportamiento al redireccionar: </para>
 
         <itemizedlist>
             <listitem>
                 <para>
-                    <methodname>setCode()</methodname>
-                    puede ser utilizado para
-                    establecer el código de respuesta
-                    <acronym>HTTP</acronym>
-                    que utilizar durante
-                    la redirección.
-                </para>
+                    <methodname>setCode()</methodname> puede ser utilizado para
+                    establecer el código de respuesta <acronym>HTTP</acronym>
+                    que utilizar durante la redirección. </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>setExit()</methodname>
-                    puede usarse para forzar
-                    un
-                    <methodname>exit()</methodname>
-                    tras una redirección. Por
-                    defecto es verdadero (
-                    <constant>TRUE</constant>
-                    ).
-                </para>
+                    <methodname>setExit()</methodname> puede usarse para forzar
+                    un <methodname>exit()</methodname> tras una redirección. Por
+                    defecto es verdadero ( <constant>TRUE</constant> ). </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>setGotoSimple()</methodname>
-                    puede ser utilizada
-                    para establecer la
-                    <acronym>URL</acronym>
-                    que usar por
+                    <methodname>setGotoSimple()</methodname> puede ser utilizada
+                    para establecer la <acronym>URL</acronym> que usar por
                     defecto si no se ha pasado ninguna a
-                    <methodname>gotoSimple()</methodname>
-                    . Utiliza la
-                    <acronym>API</acronym>
-                    de
-                    <methodname>Zend_Controller_Action::_forward()</methodname>
-                    :
-                    setGotoSimple($action, $controller = null, $module = null,
-                    array $params =
-                    array());
-                </para>
+                        <methodname>gotoSimple()</methodname> . Utiliza la
+                        <acronym>API</acronym> de
+                        <methodname>Zend_Controller_Action::_forward()</methodname>
+                    : setGotoSimple($action, $controller = null, $module = null,
+                    array $params = array()); </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>setGotoRoute()</methodname>
-                    puede ser utilizada
-                    para establecer una
-                    <acronym>URL</acronym>
-                    basada en una
+                    <methodname>setGotoRoute()</methodname> puede ser utilizada
+                    para establecer una <acronym>URL</acronym> basada en una
                     ruta. Pasarla en un array de pares clave/valor y un nombre
-                    de ruta,
-                    y que ensamblarán la
-                    <acronym>URL</acronym>
-                    según
-                    la definición y el tipo de ruta.
-                </para>
+                    de ruta, y que ensamblarán la <acronym>URL</acronym> según
+                    la definición y el tipo de ruta. </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>setGotoUrl()</methodname>
-                    puede ser utilizada
-                    para establecer una
-                    <acronym>URL</acronym>
-                    por defecto si no
-                    se pasa ninguna a
-                    <methodname>gotoUrl()</methodname>
-                    . Acepta
-                    un solo string
-                    <acronym>URL</acronym>
-                    .
-                </para>
+                    <methodname>setGotoUrl()</methodname> puede ser utilizada
+                    para establecer una <acronym>URL</acronym> por defecto si no
+                    se pasa ninguna a <methodname>gotoUrl()</methodname> .
+                    Acepta un solo string <acronym>URL</acronym> . </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>setPrependBase()</methodname>
-                    puede ser
-                    utilizada para anteponer la
-                    <acronym>URL</acronym>
-                    base del
-                    objeto solicitud a una
-                    <acronym>URL</acronym>
-                    especificada
-                    con
-                    <methodname>setGotoUrl()</methodname>
-                    ,
-                    <methodname>gotoUrl()</methodname>
-                    , o
-                    <methodname>gotoUrlAndExit()</methodname>
-                    .
-                </para>
+                    <methodname>setPrependBase()</methodname> puede ser
+                    utilizada para anteponer la <acronym>URL</acronym> base del
+                    objeto solicitud a una <acronym>URL</acronym> especificada
+                    con <methodname>setGotoUrl()</methodname> ,
+                        <methodname>gotoUrl()</methodname> , o
+                        <methodname>gotoUrlAndExit()</methodname> . </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>setUseAbsoluteUri()</methodname>
-                    puede ser
-                    utilizada para forzar al
-                    <emphasis>Redirector</emphasis>
-                    a usar
-                    <acronym>URI</acronym>
-                    s absolutas cuando está redireccionando. Cuando se
-                    establece esta opción, se
-                    utiliza el valor de
-                    <varname>$_SERVER['HTTP_HOST']</varname>
-                    ,
-                    <varname>$_SERVER['SERVER_PORT']</varname>
-                    , y
-                    <varname>$_SERVER['HTTPS']</varname>
-                    para formar
-                    una
-                    <acronym>URI</acronym>
-                    completa a la
-                    <acronym>URL</acronym>
-                    especificada
-                    por uno de los métodos de redirección. Esta opción está
-                    desactivada
-                    por defecto, pero podrá ser activada por defecto
-                    en versiones posteriores.
-                </para>
+                    <methodname>setUseAbsoluteUri()</methodname> puede ser
+                    utilizada para forzar al <emphasis>Redirector</emphasis> a
+                    usar <acronym>URI</acronym> s absolutas cuando está
+                    redireccionando. Cuando se establece esta opción, se utiliza
+                    el valor de <varname>$_SERVER['HTTP_HOST']</varname> ,
+                        <varname>$_SERVER['SERVER_PORT']</varname> , y
+                        <varname>$_SERVER['HTTPS']</varname> para formar una
+                        <acronym>URI</acronym> completa a la
+                        <acronym>URL</acronym> especificada por uno de los
+                    métodos de redirección. Esta opción está desactivada por
+                    defecto, pero podrá ser activada por defecto en versiones
+                    posteriores. </para>
             </listitem>
         </itemizedlist>
 
         <para>Además, hay una variedad de métodos en el redireccionamiento para
-            realizar las
-            redirecciones actuales:</para>
+            realizar las redirecciones actuales:</para>
 
         <itemizedlist>
             <listitem>
                 <para>
-                    <methodname>gotoSimple()</methodname>
-                    usa
-                    <methodname>setGotoSimple()</methodname>
-                    (<methodname>_forward()</methodname>-tipo <acronym>API</acronym>)
-                    para
-                    construir una
-                    <acronym>URL</acronym>
-                    y realizar un
-                    redireccionamiento.
+                    <methodname>gotoSimple()</methodname> usa
+                        <methodname>setGotoSimple()</methodname>
+                        (<methodname>_forward()</methodname>-tipo
+                        <acronym>API</acronym>) para construir una
+                        <acronym>URL</acronym> y realizar un redireccionamiento.
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>gotoRoute()</methodname>
-                    usa
-                    <methodname>setGotoRoute()</methodname>
-                    (
-                    <emphasis>route-assembly</emphasis>
-                    ) para construir
-                    una
-                    <acronym>URL</acronym>
-                    y realizar un redireccionamiento.
+                    <methodname>gotoRoute()</methodname> usa
+                        <methodname>setGotoRoute()</methodname> (
+                        <emphasis>route-assembly</emphasis> ) para construir una
+                        <acronym>URL</acronym> y realizar un redireccionamiento.
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>gotoUrl()</methodname>
-                    usa
-                    <methodname>setGotoUrl()</methodname>
-                    (
-                    <methodname>URL
-                        string</methodname>
-                    ) para construir una
-                    <acronym>URL</acronym>
-                    y realizar un redireccionamiento.
+                    <methodname>gotoUrl()</methodname> usa
+                        <methodname>setGotoUrl()</methodname> ( <methodname>URL
+                        string</methodname> ) para construir una
+                        <acronym>URL</acronym> y realizar un redireccionamiento.
                 </para>
             </listitem>
         </itemizedlist>
 
-        <para>
-            Por último, usted puede determinar la redirección actual de la
-            <acronym>URL</acronym>
-            en cualquier momento usando
-            <methodname>getRedirectUrl()</methodname>
-            .
-        </para>
+        <para> Por último, usted puede determinar la redirección actual de la
+                <acronym>URL</acronym> en cualquier momento usando
+                <methodname>getRedirectUrl()</methodname> . </para>
     </sect4>
 
     <sect4 id="zend.controller.actionhelper.redirector.basicusage">
         <title>Ejemplos Básicos de Uso</title>
 
-        <example id="zend.controller.actionhelper.redirector.basicusage.example-1">
+        <example
+            id="zend.controller.actionhelper.redirector.basicusage.example-1">
             <title>Estableciendo Opciones</title>
 
-            <para>
-                Este ejemplo anula varias opciones, incluido el
-                establecimiento del código de estado
-                <acronym>HTTP</acronym>
+            <para> Este ejemplo anula varias opciones, incluido el
+                establecimiento del código de estado <acronym>HTTP</acronym>
                 para usar en la redirección ('303'), no saliendo por defecto en
-                la redirección, y
-                definir una
-                <acronym>URL</acronym>
-                a usar por
-                defecto cuando se redireccione.
-            </para>
+                la redirección, y definir una <acronym>URL</acronym> a usar por
+                defecto cuando se redireccione. </para>
 
             <programlisting language="php"><![CDATA[
 class SomeController extends Zend_Controller_Action
@@ -276,16 +179,13 @@ class SomeController extends Zend_Controller_Action
 ]]></programlisting>
         </example>
 
-        <example id="zend.controller.actionhelper.redirector.basicusage.example-2">
+        <example
+            id="zend.controller.actionhelper.redirector.basicusage.example-2">
             <title>Usando Defaults</title>
 
-            <para>
-                Este ejemplo asume que se usan los valores predeterminados,
-                lo que significa que
-                cualquier redirección resultará en un
-                <methodname>exit()</methodname>
-                inmediato.
-            </para>
+            <para> Este ejemplo asume que se usan los valores predeterminados,
+                lo que significa que cualquier redirección resultará en un
+                    <methodname>exit()</methodname> inmediato. </para>
 
             <programlisting language="php"><![CDATA[
 // EJEMPLO ALTERNATIVO
@@ -315,26 +215,19 @@ class AlternativeController extends Zend_Controller_Action
 ]]></programlisting>
         </example>
 
-        <example id="zend.controller.actionhelper.redirector.basicusage.example-3">
+        <example
+            id="zend.controller.actionhelper.redirector.basicusage.example-3">
             <title>Usando la API _forward() de goto()</title>
 
-            <para>
-                La
-                <acronym>API</acronym>
-                <methodname>gotoSimple()</methodname>
-                imita a la de
-                <methodname>Zend_Controller_Action::_forward()</methodname>
-                .
-                La diferencia principal es que construye una
-                <acronym>URL</acronym>
-                desde los parámetros pasados, y
+            <para> La <acronym>API</acronym>
+                <methodname>gotoSimple()</methodname> imita a la de
+                    <methodname>Zend_Controller_Action::_forward()</methodname>
+                . La diferencia principal es que construye una
+                    <acronym>URL</acronym> desde los parámetros pasados, y
                 utiliza el formato por defecto
-                <methodname>:module/:controller/:action/*</methodname>
-                del
+                    <methodname>:module/:controller/:action/*</methodname> del
                 enrutador predeterminado. A continuación se redirecciona en
-                lugar de encadenar la
-                acción.
-            </para>
+                lugar de encadenar la acción. </para>
 
             <programlisting language="php"><![CDATA[
 class ForwardController extends Zend_Controller_Action
@@ -369,19 +262,15 @@ class ForwardController extends Zend_Controller_Action
 ]]></programlisting>
         </example>
 
-        <example id="zend.controller.actionhelper.redirector.basicusage.example-4">
+        <example
+            id="zend.controller.actionhelper.redirector.basicusage.example-4">
             <title>Usando Ruta de Ensamblaje con gotoRoute()</title>
 
-            <para>
-                El siguiente ejemplo usa el método
-                <methodname>assemble()</methodname>
-                del
-                <link linkend="zend.controller.router">enrutador</link>
-                para crear
+            <para> El siguiente ejemplo usa el método
+                    <methodname>assemble()</methodname> del <link
+                    linkend="zend.controller.router">enrutador</link> para crear
                 una URL basada en un array asociativo de parámetros pasados. Se
-                supone que
-                la siguiente ruta ha sido registrada:
-            </para>
+                supone que la siguiente ruta ha sido registrada: </para>
 
             <programlisting language="php"><![CDATA[
 $route = new Zend_Controller_Router_Route(
@@ -393,14 +282,9 @@ $route = new Zend_Controller_Router_Route(
 $router->addRoute('blogArchive', $route);
 ]]></programlisting>
 
-            <para>
-                Dado un array con el año fijado a 2006, mes a 4, día a 24, e
-                id a 42, entonces
-                construye la siguiente
-                <acronym>URL</acronym>
-                <filename>/blog/2006/4/24/42</filename>
-                .
-            </para>
+            <para> Dado un array con el año fijado a 2006, mes a 4, día a 24, e
+                id a 42, entonces construye la siguiente <acronym>URL</acronym>
+                <filename>/blog/2006/4/24/42</filename> . </para>
 
             <programlisting language="php"><![CDATA[
 class BlogAdminController extends Zend_Controller_Action

documentation/manual/es/module_specs/Zend_Controller-FrontController.xml

@@ -8,86 +8,61 @@
         <title>Introducción</title>
 
         <para>
-            <classname>Zend_Controller_Front</classname>
-            implementa un
-            <ulink url="http://www.martinfowler.com/eaaCatalog/frontController.html">Front Controller
-                pattern</ulink>
-            usado en aplicaciones
-            <ulink url="http://en.wikipedia.org/wiki/Model-view-controller">Model-View-Controller
-                (MVC)</ulink>
-            . Su propósito es inicializar el entorno de la solicitud, rutear la
-            solicitud entrante, y
-            luego hacer un envío de cualquier de las acciones descubiertas; le
-            agrega las respuestas
-            y las regresa cuando se completa el proceso.
-        </para>
+            <classname>Zend_Controller_Front</classname> implementa un <ulink
+                url="http://www.martinfowler.com/eaaCatalog/frontController.html"
+                >Front Controller pattern</ulink> usado en aplicaciones <ulink
+                url="http://en.wikipedia.org/wiki/Model-view-controller"
+                >Model-View-Controller (MVC)</ulink> . Su propósito es
+            inicializar el entorno de la solicitud, rutear la solicitud
+            entrante, y luego hacer un envío de cualquier de las acciones
+            descubiertas; le agrega las respuestas y las regresa cuando se
+            completa el proceso. </para>
 
         <para>
-            <classname>Zend_Controller_Front</classname>
-            también implementa el
-            <ulink url="http://en.wikipedia.org/wiki/Singleton_pattern">Singleton pattern</ulink>
-            ,
-            significando que solo una única instancia de él puede estar disponible en cualquier
-            momento dado. Esto le permite actuar también como un registro en el que los demás
-            objetos pueden extraer del proceso dispatch.
-        </para>
+            <classname>Zend_Controller_Front</classname> también implementa el
+                <ulink url="http://en.wikipedia.org/wiki/Singleton_pattern"
+                >Singleton pattern</ulink> , significando que solo una única
+            instancia de él puede estar disponible en cualquier momento dado.
+            Esto le permite actuar también como un registro en el que los demás
+            objetos pueden extraer del proceso dispatch. </para>
 
         <para>
-            <classname>Zend_Controller_Front</classname>
-            registra un
-            <link linkend="zend.controller.plugins">plugin broker</link>
-            consigo mismo, permitiendo
-            que diversos eventos que dispara sean observados por plugins.
-            En muchos casos, esto da
-            el desarrollador la oportunidad de adaptar el proceso de
-            dispatch al sitio sin la
-            necesidad de ampliar el Front Controller para añadir
-            funcionalidad.
-        </para>
-
-        <para>
-            Como mínimo, el front controller necesita una o más paths a directorios que contengan
-            <link linkend="zend.controller.action"> action controllers</link>
-            a fin de hacer su
-            trabajo. Una variedad de métodos también pueden ser invocados para
-            seguir adaptando el
-            medio ambiente del front controller y ese a sus helper classes.
-        </para>
+            <classname>Zend_Controller_Front</classname> registra un <link
+                linkend="zend.controller.plugins">plugin broker</link> consigo
+            mismo, permitiendo que diversos eventos que dispara sean observados
+            por plugins. En muchos casos, esto da el desarrollador la
+            oportunidad de adaptar el proceso de dispatch al sitio sin la
+            necesidad de ampliar el Front Controller para añadir funcionalidad. </para>
+
+        <para> Como mínimo, el front controller necesita una o más paths a
+            directorios que contengan <link linkend="zend.controller.action">
+                action controllers</link> a fin de hacer su trabajo. Una
+            variedad de métodos también pueden ser invocados para seguir
+            adaptando el medio ambiente del front controller y ese a sus helper
+            classes. </para>
 
         <note>
             <title>Comportamiento por Defecto</title>
-            <para>
-                Por defecto, el front controller carga el
-                <link linkend="zend.controller.plugins.standard.errorhandler">ErrorHandler</link>
-                plugin, así como al
-                <link linkend="zend.controller.actionhelpers.viewrenderer">ViewRenderer</link>
-                action helper plugin. Estos son para simplificar el manejo
-                de errores y el view
-                renderering en sus controladores, respectivamente.
-            </para>
-
-            <para>
-                Para deshabilitar el
-                <emphasis>ErrorHandler</emphasis>
-                , ejecutar lo siguiente en
-                cualquier momento antes de llamar a
-                <methodname>dispatch()</methodname>
-                :
-            </para>
+            <para> Por defecto, el front controller carga el <link
+                    linkend="zend.controller.plugins.standard.errorhandler"
+                    >ErrorHandler</link> plugin, así como al <link
+                    linkend="zend.controller.actionhelpers.viewrenderer"
+                    >ViewRenderer</link> action helper plugin. Estos son para
+                simplificar el manejo de errores y el view renderering en sus
+                controladores, respectivamente. </para>
+
+            <para> Para deshabilitar el <emphasis>ErrorHandler</emphasis> ,
+                ejecutar lo siguiente en cualquier momento antes de llamar a
+                    <methodname>dispatch()</methodname> : </para>
 
             <programlisting language="php"><![CDATA[
 // Deshabilitar el ErrorHandler plugin:
 $front->setParam('noErrorHandler', true);
 ]]></programlisting>
 
-            <para>
-                Para deshabilitar el
-                <emphasis>ViewRenderer</emphasis>
-                , haga lo siguiente antes
-                de llamar a
-                <methodname>dispatch()</methodname>
-                :
-            </para>
+            <para> Para deshabilitar el <emphasis>ViewRenderer</emphasis> , haga
+                lo siguiente antes de llamar a
+                    <methodname>dispatch()</methodname> : </para>
 
             <programlisting language="php"><![CDATA[
 // Deshabilitar el ViewRenderer helper:
@@ -99,20 +74,18 @@ $front->setParam('noViewRenderer', true);
     <sect2 id="zend.controller.front.methods.primary">
         <title>Métodos Básicos</title>
 
-        <para>El front controller tiene varios accessors para establecer su medio ambiente. Sin
-            embargo, hay tres métodos básicos clave para la funcionalidad del front controller:</para>
+        <para>El front controller tiene varios accessors para establecer su
+            medio ambiente. Sin embargo, hay tres métodos básicos clave para la
+            funcionalidad del front controller:</para>
 
         <sect3 id="zend.controller.front.methods.primary.getinstance">
             <title>getInstance()</title>
 
             <para>
-                <methodname>getInstance()</methodname>
-                se utiliza para recuperar una instancia del
-                front controller. Como el front
-                controller implementa un patrón Singleton, este
-                también es el único medio posible
-                para instanciar un objeto front controller.
-            </para>
+                <methodname>getInstance()</methodname> se utiliza para recuperar
+                una instancia del front controller. Como el front controller
+                implementa un patrón Singleton, este también es el único medio
+                posible para instanciar un objeto front controller. </para>
 
             <programlisting language="php"><![CDATA[
 $front = Zend_Controller_Front::getInstance();
@@ -123,15 +96,12 @@ $front = Zend_Controller_Front::getInstance();
             <title>setControllerDirectory() y addControllerDirectory</title>
 
             <para>
-                <methodname>setControllerDirectory()</methodname>
-                se usa para decirle a
-                <link linkend="zend.controller.dispatcher">el dispatcher</link>
-                dónde buscar para los
-                archivos de clase
-                <link linkend="zend.controller.action">action controller</link>
-                .
-                Acepta bien un único path o un array asociativo de pares módulo/path.
-            </para>
+                <methodname>setControllerDirectory()</methodname> se usa para
+                decirle a <link linkend="zend.controller.dispatcher">el
+                    dispatcher</link> dónde buscar para los archivos de clase
+                    <link linkend="zend.controller.action">action
+                    controller</link> . Acepta bien un único path o un array
+                asociativo de pares módulo/path. </para>
 
             <para>Como algunos ejemplos:</para>
 
@@ -151,107 +121,70 @@ $front->addControllerDirectory('../modules/foo/controllers', 'foo');
 ]]></programlisting>
 
             <note>
-                <para>
-                    Si usa
-                    <methodname>addControllerDirectory()</methodname>
-                    sin un nombre de
-                    módulo, este establecerá el directorio
-                    <emphasis>default</emphasis>
-                    para el
-                    módulo -- sobreescribiéndolo si ya existe.
-                </para>
+                <para> Si usa <methodname>addControllerDirectory()</methodname>
+                    sin un nombre de módulo, este establecerá el directorio
+                        <emphasis>default</emphasis> para el módulo --
+                    sobreescribiéndolo si ya existe. </para>
             </note>
 
-            <para>
-                Puede conseguir la configuración actual para el directorio del controlador
-                utilizando
-                <methodname>getControllerDirectory()</methodname>
-                ; este devolverá un
-                array de pares módulo y directorio.
-            </para>
+            <para> Puede conseguir la configuración actual para el directorio
+                del controlador utilizando
+                    <methodname>getControllerDirectory()</methodname> ; este
+                devolverá un array de pares módulo y directorio. </para>
         </sect3>
 
         <sect3 id="zend.controller.front.methods.primary.addmoduledirectory">
             <title>addModuleDirectory() y getModuleDirectory()</title>
 
-            <para>
-                Uno de los aspectos del front controller es que puede
-                <link linkend="zend.controller.modular"> definir una estructura modular de
-                    directorio</link>
-                para crear componentes standalone; estos son llamados
-                "módulos".
-            </para>
-
-            <para>
-                Cada módulo debe estar en su propio directorio y ser un espejo de la estructura
-                del
-                directorio del módulo por defecto -- es decir, que debería tener como mínimo un
-                subdirectorio de
-                <filename>/controllers/</filename>
-                , y típicamente un subdirectorio
-                de
-                <filename>/views/</filename>
-                y otros subdirectorios de aplicaciones.
-            </para>
+            <para> Uno de los aspectos del front controller es que puede <link
+                    linkend="zend.controller.modular"> definir una estructura
+                    modular de directorio</link> para crear componentes
+                standalone; estos son llamados "módulos". </para>
 
-            <para>
-                <methodname>addModuleDirectory()</methodname>
-                permite pasar el nombre de un
-                directorio que contiene uno o más directorios de
-                módulos. A continuación lo analiza
-                y los añade como directorios de controladores al
-                front controller.
-            </para>
+            <para> Cada módulo debe estar en su propio directorio y ser un
+                espejo de la estructura del directorio del módulo por defecto --
+                es decir, que debería tener como mínimo un subdirectorio de
+                    <filename>/controllers/</filename> , y típicamente un
+                subdirectorio de <filename>/views/</filename> y otros
+                subdirectorios de aplicaciones. </para>
 
             <para>
-                Después, si quiere determinar el path a un determinado módulo o al módulo actual,
-                puede llamar a
-                <methodname>getModuleDirectory()</methodname>
-                , opcionalmente puede
-                pasar un nombre de módulo para conseguir el directorio de ese
-                módulo específico.
-            </para>
+                <methodname>addModuleDirectory()</methodname> permite pasar el
+                nombre de un directorio que contiene uno o más directorios de
+                módulos. A continuación lo analiza y los añade como directorios
+                de controladores al front controller. </para>
+
+            <para> Después, si quiere determinar el path a un determinado módulo
+                o al módulo actual, puede llamar a
+                    <methodname>getModuleDirectory()</methodname> ,
+                opcionalmente puede pasar un nombre de módulo para conseguir el
+                directorio de ese módulo específico. </para>
         </sect3>
 
         <sect3 id="zend.controller.front.methods.primary.dispatch">
             <title>dispatch()</title>
 
             <para>
-                <methodname>dispatch(Zend_Controller_Request_Abstract $request = null,
-                    Zend_Controller_Response_Abstract $response = null)</methodname>
-                hace el trabajo
-                pesado del front controller. Puede opcionalmente tomar un
-                <link linkend="zend.controller.request">request object</link>
-                y/o un
-                <link linkend="zend.controller.response">response object</link>
-                , permitiendo al
-                desarrollador pasar objetos peronalizados para cada uno.
-            </para>
-
-            <para>
-                Si no se pasa ningun objeto solicitud o respuesta,
-                <methodname>dispatch()</methodname>
-                comprobará por objetos previamente
-                registrados y utilizará esos o instanciará
-                versiones por defecto a utilizar en su
-                proceso (en ambos casos, el sabor de
-                <acronym>HTTP</acronym>
-                será utilizado por
-                defecto).
-            </para>
-
-            <para>
-                Similarmente,
-                <methodname>dispatch()</methodname>
-                comprueba los objetos
-                registrados
-                <link linkend="zend.controller.router">router</link>
-                y
-                <link linkend="zend.controller.dispatcher">dispatcher</link>
-                , instanciando las
-                versiones por defecto de cada uno si ninguno de ellos se
-                encuentra.
-            </para>
+                <methodname>dispatch(Zend_Controller_Request_Abstract $request =
+                    null, Zend_Controller_Response_Abstract $response =
+                    null)</methodname> hace el trabajo pesado del front
+                controller. Puede opcionalmente tomar un <link
+                    linkend="zend.controller.request">request object</link> y/o
+                un <link linkend="zend.controller.response">response
+                    object</link> , permitiendo al desarrollador pasar objetos
+                peronalizados para cada uno. </para>
+
+            <para> Si no se pasa ningun objeto solicitud o respuesta,
+                    <methodname>dispatch()</methodname> comprobará por objetos
+                previamente registrados y utilizará esos o instanciará versiones
+                por defecto a utilizar en su proceso (en ambos casos, el sabor
+                de <acronym>HTTP</acronym> será utilizado por defecto). </para>
+
+            <para> Similarmente, <methodname>dispatch()</methodname> comprueba
+                los objetos registrados <link linkend="zend.controller.router"
+                    >router</link> y <link linkend="zend.controller.dispatcher"
+                    >dispatcher</link> , instanciando las versiones por defecto
+                de cada uno si ninguno de ellos se encuentra. </para>
 
             <para>El proceso de dispatch tiene tres eventos distintos:</para>
 
@@ -267,46 +200,35 @@ $front->addControllerDirectory('../modules/foo/controllers', 'foo');
                 </listitem>
             </itemizedlist>
 
-            <para>
-                El routing se lleva a cabo exactamente una vez, utilizando los valores del objeto
-                solicitud cuando se llama a
-                <methodname>dispatch()</methodname>
-                . El dispatching se
+            <para> El routing se lleva a cabo exactamente una vez, utilizando
+                los valores del objeto solicitud cuando se llama a
+                    <methodname>dispatch()</methodname> . El dispatching se
                 lleva a cabo en un bucle; una solicitud puede indicar, bien
-                múltiples acciones de
-                dispatch, o el controlador o un plugin pueden restablecer el
-                objeto solicitud para
-                forzar medidas adicionales para dispatch. Cuando todo está
-                hecho, el front
-                controller devuelve una respuesta.
-            </para>
+                múltiples acciones de dispatch, o el controlador o un plugin
+                pueden restablecer el objeto solicitud para forzar medidas
+                adicionales para dispatch. Cuando todo está hecho, el front
+                controller devuelve una respuesta. </para>
         </sect3>
 
         <sect3 id="zend.controller.front.methods.primary.run">
             <title>run()</title>
 
             <para>
-                <methodname>Zend_Controller_Front::run($path)</methodname>
-                es un método estático que
-                toma simplemente un path a un directorio que contiene
-                controladores. Obtiene una
-                instancia del front controller (via
-                <link linkend="zend.controller.front.methods.primary.getinstance">getInstance()</link>
-                , registra el path provisto via
-                <link linkend="zend.controller.front.methods.primary.setcontrollerdirectory">setControllerDirectory()</link>
-                , y finalmente
-                <link linkend="zend.controller.front.methods.primary.dispatch">dispatches</link>
-                .
-            </para>
-
-            <para>
-                Básicamente,
-                <methodname>run()</methodname>
-                es un método conveniente que pueden
-                utilizarse para setups de sitios que no requieran
-                la personalización del medio
-                ambiente del front controller.
-            </para>
+                <methodname>Zend_Controller_Front::run($path)</methodname> es un
+                método estático que toma simplemente un path a un directorio que
+                contiene controladores. Obtiene una instancia del front
+                controller (via <link
+                    linkend="zend.controller.front.methods.primary.getinstance"
+                    >getInstance()</link> , registra el path provisto via <link
+                    linkend="zend.controller.front.methods.primary.setcontrollerdirectory"
+                    >setControllerDirectory()</link> , y finalmente <link
+                    linkend="zend.controller.front.methods.primary.dispatch"
+                    >dispatches</link> . </para>
+
+            <para> Básicamente, <methodname>run()</methodname> es un método
+                conveniente que pueden utilizarse para setups de sitios que no
+                requieran la personalización del medio ambiente del front
+                controller. </para>
 
             <programlisting language="php"><![CDATA[
 // Instanciar el front controller, establecer el directorio de controladores,
@@ -319,207 +241,161 @@ Zend_Controller_Front::run('../application/controllers');
     <sect2 id="zend.controller.front.methods.environment">
         <title>Métodos Accessor Ambientales</title>
 
-        <para>Además de los métodos enumerados anteriormente, hay una serie de métodos accessor que
-            pueden utilizarse para afectar el entorno del front controller -- y por lo tanto el
-            ambiente de las clases a las cuales delega el front controller.</para>
+        <para>Además de los métodos enumerados anteriormente, hay una serie de
+            métodos accessor que pueden utilizarse para afectar el entorno del
+            front controller -- y por lo tanto el ambiente de las clases a las
+            cuales delega el front controller.</para>
 
         <itemizedlist>
             <listitem>
                 <para>
-                    <methodname>resetInstance()</methodname>
-                    puede ser utilizada para borrar todos
-                    los settings actuales. Su objetivo
-                    principal es para testing, pero también puede
-                    ser utilizada para instancias donde
-                    desee encadenar múltiples front controllers.
-                </para>
+                    <methodname>resetInstance()</methodname> puede ser utilizada
+                    para borrar todos los settings actuales. Su objetivo
+                    principal es para testing, pero también puede ser utilizada
+                    para instancias donde desee encadenar múltiples front
+                    controllers. </para>
             </listitem>
 
             <listitem>
                 <para>
                     <methodname>(set|get)DefaultControllerName()</methodname>
-                    permite especificar un
-                    nombre diferente para usar en el controlador por defecto
-                    (en caso coontrario, se
-                    usa 'index') y recuperar el valor actual. Delegan a
-                    <link linkend="zend.controller.dispatcher">el dispatcher</link>
-                    .
-                </para>
+                    permite especificar un nombre diferente para usar en el
+                    controlador por defecto (en caso coontrario, se usa 'index')
+                    y recuperar el valor actual. Delegan a <link
+                        linkend="zend.controller.dispatcher">el
+                        dispatcher</link> . </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>setDefaultAction()</methodname>
-                    y
-                    <methodname>getDefaultAction()</methodname>
-                    le deja especificar un nombre
-                    diferente a utilizar para la acción predeterminada
-                    (en caso coontrario, se usa
-                    'index') y recuperar el valor actual. Delegan a
-                    <link linkend="zend.controller.dispatcher">el dispatcher</link>
-                    .
-                </para>
+                    <methodname>setDefaultAction()</methodname> y
+                        <methodname>getDefaultAction()</methodname> le deja
+                    especificar un nombre diferente a utilizar para la acción
+                    predeterminada (en caso coontrario, se usa 'index') y
+                    recuperar el valor actual. Delegan a <link
+                        linkend="zend.controller.dispatcher">el
+                        dispatcher</link> . </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>setRequest()</methodname>
-                    y
-                    <methodname>getRequest()</methodname>
-                    le
-                    permite especificar la clase u objeto
-                    <link linkend="zend.controller.request">el
-                        request</link>
-                    a usar durante el proceso de dispatch y recuperar el objeto
-                    actual. Al setear el
-                    objeto solicitud, puede pasarlo en un nombre de clase de
-                    solicitud, en cuyo caso
-                    el método va a cargar el archivo clase y lo instanciará.
-                </para>
+                    <methodname>setRequest()</methodname> y
+                        <methodname>getRequest()</methodname> le permite
+                    especificar la clase u objeto <link
+                        linkend="zend.controller.request">el request</link> a
+                    usar durante el proceso de dispatch y recuperar el objeto
+                    actual. Al setear el objeto solicitud, puede pasarlo en un
+                    nombre de clase de solicitud, en cuyo caso el método va a
+                    cargar el archivo clase y lo instanciará. </para>
             </listitem>
 
             <listitem>
                 <para>
                     <methodname>setRouter()</methodname>
-                    <methodname>getRouter()</methodname>
-                    le permite especificar la clase u objeto
-                    <link linkend="zend.controller.router">el router</link>
-                    a usar durante el
-                    proceso de dispatch y recuperar el objeto actual. Al setear el
-                    objeto router,
-                    puede pasarlo en un nombre de clase de router, en cuyo caso el
-                    método va a
-                    cargar el archivo clase y lo instanciará.
-                </para>
-
-                <para>Al recuperar el objeto router, en primer lugar comprueba para ver si hay
-                    alguno presente, y si no, instancia al router por defecto(reescribe el router).
-               </para>
+                    <methodname>getRouter()</methodname> le permite especificar
+                    la clase u objeto <link linkend="zend.controller.router">el
+                        router</link> a usar durante el proceso de dispatch y
+                    recuperar el objeto actual. Al setear el objeto router,
+                    puede pasarlo en un nombre de clase de router, en cuyo caso
+                    el método va a cargar el archivo clase y lo instanciará. </para>
+
+                <para>Al recuperar el objeto router, en primer lugar comprueba
+                    para ver si hay alguno presente, y si no, instancia al
+                    router por defecto(reescribe el router). </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>setBaseUrl()</methodname>
-                    y
-                    <methodname>getBaseUrl()</methodname>
-                    le
-                    permite especificar
-                    <link linkend="zend.controller.request.http.baseurl">la URL
-                        base</link>
-                    de la cual tirar cuando se rutean peticiones y recuperar el
-                    valor actual. El
-                    valor se provee al objeto solicitud justo antes de rutear.
-                </para>
+                    <methodname>setBaseUrl()</methodname> y
+                        <methodname>getBaseUrl()</methodname> le permite
+                    especificar <link
+                        linkend="zend.controller.request.http.baseurl">la URL
+                        base</link> de la cual tirar cuando se rutean peticiones
+                    y recuperar el valor actual. El valor se provee al objeto
+                    solicitud justo antes de rutear. </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>setDispatcher()</methodname>
-                    y
-                    <methodname>getDispatcher()</methodname>
-                    le permite especificar la clase u
-                    objeto
-                    <link linkend="zend.controller.dispatcher">el dispatcher</link>
-                    a usar
-                    durante el proceso de dispatch y recuperar el objeto actual. Al setear el
-                    objeto
-                    dispatch, puede pasarlo en un nombre de clase de dispatcher, en cuyo caso
-                    el
-                    método va a cargar el archivo clase y lo instanciará.
-                </para>
-
-                <para>Al recuperar el objeto dispatch, en primer lugar comprueba para ver si hay
-                    alguno presente, y si no, instancia al dispatcher por defecto.</para>
+                    <methodname>setDispatcher()</methodname> y
+                        <methodname>getDispatcher()</methodname> le permite
+                    especificar la clase u objeto <link
+                        linkend="zend.controller.dispatcher">el
+                        dispatcher</link> a usar durante el proceso de dispatch
+                    y recuperar el objeto actual. Al setear el objeto dispatch,
+                    puede pasarlo en un nombre de clase de dispatcher, en cuyo
+                    caso el método va a cargar el archivo clase y lo
+                    instanciará. </para>
+
+                <para>Al recuperar el objeto dispatch, en primer lugar comprueba
+                    para ver si hay alguno presente, y si no, instancia al
+                    dispatcher por defecto.</para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>setResponse()</methodname>
-                    y
-                    <methodname>getResponse()</methodname>
-                    le permite especificar la clase u objeto
-                    <link linkend="zend.controller.response">response</link>
-                    a usar durante el proceso
-                    de dispatch y recuperar el objeto actual. Al setear el
-                    objeto response, puede
-                    pasarlo en un nombre de clase de response, en cuyo caso el
-                    método va a cargar el
-                    archivo clase y lo instanciará.
-                </para>
+                    <methodname>setResponse()</methodname> y
+                        <methodname>getResponse()</methodname> le permite
+                    especificar la clase u objeto <link
+                        linkend="zend.controller.response">response</link> a
+                    usar durante el proceso de dispatch y recuperar el objeto
+                    actual. Al setear el objeto response, puede pasarlo en un
+                    nombre de clase de response, en cuyo caso el método va a
+                    cargar el archivo clase y lo instanciará. </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>registerPlugin(Zend_Controller_Plugin_Abstract $plugin, $stackIndex
-                        = null)</methodname>
-                    le permite registrar
-                    <link linkend="zend.controller.plugins">plugin objects</link>
-                    . Opcionalmente,
-                    setting
-                    <varname>$stackIndex</varname>
-                    , puede controlar el orden en que se
-                    ejecutarán los plugins.
-                </para>
+                    <methodname>registerPlugin(Zend_Controller_Plugin_Abstract
+                        $plugin, $stackIndex = null)</methodname> le permite
+                    registrar <link linkend="zend.controller.plugins">plugin
+                        objects</link> . Opcionalmente, setting
+                        <varname>$stackIndex</varname> , puede controlar el
+                    orden en que se ejecutarán los plugins. </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>unregisterPlugin($plugin)</methodname>
-                    le permite desregistrar
-                    <link linkend="zend.controller.plugins">plugin objects</link>
-                    .
-                    <varname>$plugin</varname>
-                    puede ser tanto un objeto plugin o un string que
-                    denota la clase de plugin a
-                    desregistrar.
-                </para>
+                    <methodname>unregisterPlugin($plugin)</methodname> le
+                    permite desregistrar <link linkend="zend.controller.plugins"
+                        >plugin objects</link> . <varname>$plugin</varname>
+                    puede ser tanto un objeto plugin o un string que denota la
+                    clase de plugin a desregistrar. </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>throwExceptions($flag)</methodname>
-                    se utiliza para activar o
-                    desactivar la capacidad de arrojar excepciones durante
-                    el proceso de dispatch.
-                    Por defecto, las excepciones son capturadas y colocadas
-                    en el
-                    <link linkend="zend.controller.response">objeto response </link>
-                    ; activando
-                    <methodname>throwExceptions()</methodname>
-                    se anulará este comportamiento.
-                </para>
-
-                <para>
-                    Para más información, lea
-                    <xref linkend="zend.controller.exceptions"/>
-                    .
-                </para>
+                    <methodname>throwExceptions($flag)</methodname> se utiliza
+                    para activar o desactivar la capacidad de arrojar
+                    excepciones durante el proceso de dispatch. Por defecto, las
+                    excepciones son capturadas y colocadas en el <link
+                        linkend="zend.controller.response">objeto response
+                    </link> ; activando
+                        <methodname>throwExceptions()</methodname> se anulará
+                    este comportamiento. </para>
+
+                <para> Para más información, lea <xref
+                    linkend="zend.controller.exceptions"/> MVC
+                    Exceptions </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>returnResponse($flag)</methodname>
-                    se usa para decirle al front
-                    controller cuando regresar la respuesta (
-                    <constant>TRUE</constant>
-                    ) desde
-                    <methodname>dispatch()</methodname>
-                    , o si la respuesta debe ser emitida
-                    automáticamente (
-                    <constant>FALSE</constant>
-                    ). Por defecto, la respuesta es
-                    automáticamente emitida (llamando a
-                    <methodname>Zend_Controller_Response_Abstract::sendResponse()</methodname>
-                    );
-                    activando
-                    <methodname>returnResponse()</methodname>
-                    ) se anulará este
-                    comportamiento.
-                </para>
-
-                <para>Las razones para regresar la respuesta incluyen un deseo de comprobar las
-                    excepciones antes de emitir la respuesta, necesidad de hacer un log de diversos
-                    aspectos de la respuesta (tales como cabeceras), etc.</para>
+                    <methodname>returnResponse($flag)</methodname> se usa para
+                    decirle al front controller cuando regresar la respuesta (
+                        <constant>TRUE</constant> ) desde
+                        <methodname>dispatch()</methodname> , o si la respuesta
+                    debe ser emitida automáticamente (
+                        <constant>FALSE</constant> ). Por defecto, la respuesta
+                    es automáticamente emitida (llamando a
+                        <methodname>Zend_Controller_Response_Abstract::sendResponse()</methodname>
+                    ); activando <methodname>returnResponse()</methodname> ) se
+                    anulará este comportamiento. </para>
+
+                <para>Las razones para regresar la respuesta incluyen un deseo
+                    de comprobar las excepciones antes de emitir la respuesta,
+                    necesidad de hacer un log de diversos aspectos de la
+                    respuesta (tales como cabeceras), etc.</para>
             </listitem>
         </itemizedlist>
     </sect2>
@@ -527,124 +403,98 @@ Zend_Controller_Front::run('../application/controllers');
     <sect2 id="zend.controller.front.methods.params">
         <title>Parámetros de Front Controller</title>
 
-        <para>En la introducción, se indicó que el front controller también actúa como un registro
-            de los distintos componentes del controlador. Lo hace mediante una familia de métodos
-            "param". Estos métodos le permiten registrar datos arbitrarios -- objetos y variables --
-            con el front controller, a ser devueltos en cualquier momento en la cadena de dispatch.
-            Estos valores se transmiten al router, al dispatcher, y a los action controllers. Los
-            métodos incluyen:</para>
+        <para>En la introducción, se indicó que el front controller también
+            actúa como un registro de los distintos componentes del controlador.
+            Lo hace mediante una familia de métodos "param". Estos métodos le
+            permiten registrar datos arbitrarios -- objetos y variables -- con
+            el front controller, a ser devueltos en cualquier momento en la
+            cadena de dispatch. Estos valores se transmiten al router, al
+            dispatcher, y a los action controllers. Los métodos incluyen:</para>
 
         <itemizedlist>
             <listitem>
                 <para>
-                    <methodname>setParam($name, $value)</methodname>
-                    permite establecer un único
-                    parámetro de
-                    <varname>$name</varname>
-                    con el valor
-                    <varname>$value</varname>
-                    .
-                </para>
+                    <methodname>setParam($name, $value)</methodname> permite
+                    establecer un único parámetro de <varname>$name</varname>
+                    con el valor <varname>$value</varname> . </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>setParams(array $params)</methodname>
-                    permite configurar varios
-                    parámetros a la vez usando un array asociativo.
-                </para>
+                    <methodname>setParams(array $params)</methodname> permite
+                    configurar varios parámetros a la vez usando un array
+                    asociativo. </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>getParam($name)</methodname>
-                    permite recuperar un único parámetro a
-                    la vez, utilizando como identificador a
-                    <varname>$name</varname>
-                    .
-                </para>
+                    <methodname>getParam($name)</methodname> permite recuperar
+                    un único parámetro a la vez, utilizando como identificador a
+                        <varname>$name</varname> . </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>getParams()</methodname>
-                    permite recuperar toda la lista de
-                    parámetros a la vez.
-                </para>
+                    <methodname>getParams()</methodname> permite recuperar toda
+                    la lista de parámetros a la vez. </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>clearParams()</methodname>
-                    permite borrar un único parámetro
-                    (pasando un string identificador), parámetros
-                    con múltiples nombres (pasando un
-                    array de strings identificadores), o el stack
-                    de parámetros completo (pasando
-                    nada).
-                </para>
+                    <methodname>clearParams()</methodname> permite borrar un
+                    único parámetro (pasando un string identificador),
+                    parámetros con múltiples nombres (pasando un array de
+                    strings identificadores), o el stack de parámetros completo
+                    (pasando nada). </para>
             </listitem>
         </itemizedlist>
 
-        <para>Hay varios parámetros pre-definidos que puede ser seteados para tener usos
-            específicos
-            en la cadena de dispatch:</para>
+        <para>Hay varios parámetros pre-definidos que puede ser seteados para
+            tener usos específicos en la cadena de dispatch:</para>
 
         <itemizedlist>
             <listitem>
                 <para>
-                    <emphasis>useDefaultControllerAlways</emphasis>
-                    se usa para indicar a
-                    <link linkend="zend.controller.dispatcher">el dispatcher</link>
-                    que utilice el
-                    controlador por defecto en el módulo por defecto de cualquier
-                    solicitud que no
-                    sea dispatchable (es decir, el módulo, el controlador y/o la
-                    acción no existen).
-                    Por defecto, está en off.
-                </para>
-
-                <para>
-                    Ver
-                    <link linkend="zend.controller.exceptions.internal">MVC Exceptions You
-                        May Encounter</link>
-                    para información más detallada sobre el uso de este
-                    setting.
+                    <emphasis>useDefaultControllerAlways</emphasis> se usa para
+                    indicar a <link linkend="zend.controller.dispatcher">el
+                        dispatcher</link> que utilice el controlador por defecto
+                    en el módulo por defecto de cualquier solicitud que no sea
+                    dispatchable (es decir, el módulo, el controlador y/o la
+                    acción no existen). Por defecto, está en off. </para>
+
+                <para> Ver <link linkend="zend.controller.exceptions.internal"
+                        >MVC Exceptions You May Encounter</link> para
+                    información más detallada sobre el uso de este setting.
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <emphasis>disableOutputBuffering</emphasis>
-                    se usa para indicarle a
-                    <link linkend="zend.controller.dispatcher">el dispatcher</link>
-                    que no debe
-                    utilizar output buffering para capturar la salida generada por los
-                    controladores
-                    de acción. Por defecto, el dispatcher captura cualquier salida y la
-                    añade al
-                    contenido del cuerpo del objeto respuesta.
+                    <emphasis>disableOutputBuffering</emphasis> se usa para
+                    indicarle a <link linkend="zend.controller.dispatcher">el
+                        dispatcher</link> que no debe utilizar output buffering
+                    para capturar la salida generada por los controladores de
+                    acción. Por defecto, el dispatcher captura cualquier salida
+                    y la añade al contenido del cuerpo del objeto respuesta.
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <emphasis>noViewRenderer</emphasis>
-                    se usa para deshabilitar el
-                    <link linkend="zend.controller.actionhelpers.viewrenderer">ViewRenderer</link>
-                    .
-                    Poniendo este parámetro a true, lo deshabilita.
-                </para>
+                    <emphasis>noViewRenderer</emphasis> se usa para deshabilitar
+                    el <link
+                        linkend="zend.controller.actionhelpers.viewrenderer"
+                        >ViewRenderer</link> . Poniendo este parámetro a true,
+                    lo deshabilita. </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <emphasis>noErrorHandler</emphasis>
-                    se usa para deshabilitar el
-                    <link linkend="zend.controller.plugins.standard.errorhandler">Error Handler
-                        plugin</link>
-                    . Poniendo este parámetro a true, lo deshabilita.
-                </para>
+                    <emphasis>noErrorHandler</emphasis> se usa para deshabilitar
+                    el <link
+                        linkend="zend.controller.plugins.standard.errorhandler"
+                        >Error Handler plugin</link> . Poniendo este parámetro a
+                    true, lo deshabilita. </para>
             </listitem>
         </itemizedlist>
     </sect2>
@@ -652,11 +502,8 @@ Zend_Controller_Front::run('../application/controllers');
     <sect2 id="zend.controller.front.subclassing">
         <title>Extendiendo el Front Controller</title>
 
-        <para>
-            Para extender el Front Controller, como mínimo que necesitará anular el método
-            <methodname>getInstance()</methodname>
-            :
-        </para>
+        <para> Para extender el Front Controller, como mínimo que necesitará
+            anular el método <methodname>getInstance()</methodname> : </para>
 
         <programlisting language="php"><![CDATA[
 class My_Controller_Front extends Zend_Controller_Front
@@ -672,22 +519,20 @@ class My_Controller_Front extends Zend_Controller_Front
 }
 ]]></programlisting>
 
-        <para>
-            Anulando el método
-            <methodname>getInstance()</methodname>
-            asegura que las
-            subsiguientes llamadas a
-            <methodname>Zend_Controller_Front::getInstance()</methodname>
-            devolverá una instancia de su nueva subclase en lugar de una instancia
-            <classname>Zend_Controller_Front</classname>
-            -- esto es particularmente útil para
-            algunos de los routers alternativos y view helpers.
-        </para>
-
-        <para>Típicamente, no necesitará una subclase del front controller a menos que necesite
-            añadir nuevas funcionalidades (por ejemplo, un plugin autoloader, o una forma de
-            especificar los paths de los action helpers). Algunos de los puntos donde puede querer
-            modificar el comportamiento puede incluir modificar cómo son almacenados los directorios
-            de controladores , o qué router predeterminado o dispatcher se utiliza.</para>
+        <para> Anulando el método <methodname>getInstance()</methodname> asegura
+            que las subsiguientes llamadas a
+                <methodname>Zend_Controller_Front::getInstance()</methodname>
+            devolverá una instancia de su nueva subclase en lugar de una
+            instancia <classname>Zend_Controller_Front</classname> -- esto es
+            particularmente útil para algunos de los routers alternativos y view
+            helpers. </para>
+
+        <para>Típicamente, no necesitará una subclase del front controller a
+            menos que necesite añadir nuevas funcionalidades (por ejemplo, un
+            plugin autoloader, o una forma de especificar los paths de los
+            action helpers). Algunos de los puntos donde puede querer modificar
+            el comportamiento puede incluir modificar cómo son almacenados los
+            directorios de controladores , o qué router predeterminado o
+            dispatcher se utiliza.</para>
     </sect2>
 </sect1>

documentation/manual/es/module_specs/Zend_Db_Select.xml

@@ -133,7 +133,7 @@ $select->order( ...specify sorting criteria... );
 
         <example id="zend.db.select.building.example-fluent">
 
-            <title>Ejemplo de uso de la interfaz fluida.</title>
+            <title>Ejemplo de uso de la interfaz fluida</title>
 
             <programlisting language="php"><![CDATA[
 $select = $db->select()

documentation/manual/es/module_specs/Zend_Db_Statement.xml

@@ -118,9 +118,7 @@ $stmt->execute(array(':reporter' => 'goofy', ':status' => 'FIXED'));
 
     <sect2 id="zend.db.statement.fetching">
 
-        <title> Extrayendo Resultados de una declaración
-                SELECT
-        </title>
+        <title> Extrayendo Resultados de una declaración SELECT </title>
 
         <para> Puede llamar a métodos del objeto de declaración para obtener
             filas desde declaraciones <acronym>SQL</acronym> que producen
@@ -336,7 +334,9 @@ echo $obj->bug_description;
 
         <title>Binding PHP Variables to Parameters</title> <para> </para> <example
         id="zend.db.statement.binding-param.example"> <title>Binding parameters from PHP
-        variables</title> <programlisting language="php"><![CDATA[ <?php ]]></programlisting>
+        variables</title> <programlisting language="php"><![CDATA[ 
+        <?php 
+        ]]></programlisting>
         </example> <para> See also <ulink
         url="http://www.php.net/PDOStatement-bindParam">PDOStatement::bindParam()</ulink>. </para>
 
@@ -348,7 +348,10 @@ echo $obj->bug_description;
 
         <title>Binding PHP Variables to Query Results</title> <para> </para> <example
         id="zend.db.statement.binding-column.example"> <title>Binding results to PHP
-        variables</title> <programlisting language="php"><![CDATA[ <?php ]]></programlisting>
+        variables</title>
+        <programlisting language="php"><![CDATA[ 
+        <?php 
+        ]]></programlisting>
         </example> <para> See also <ulink
         url="http://www.php.net/PDOStatement-bindColumn">PDOStatement::bindColumn()</ulink>. </para>
 

documentation/manual/es/module_specs/Zend_Pdf-Create.xml

@@ -36,7 +36,7 @@
     </para>
 
     <example id="zend.pdf.create.example-1">
-        <title>Crear un nuevo documento PDF o cargar uno ya esistente.</title>
+        <title>Crear un nuevo documento PDF o cargar uno ya esistente</title>
         <programlisting language="php"><![CDATA[
 ...
 // Crear un nuevo documento PDF

documentation/manual/es/module_specs/Zend_Pdf-Drawing.xml

@@ -429,7 +429,7 @@ $pdfPage->setFont($goodDogCoolFont, 36);
         </para>
         <example id="zend.pdf.drawing.using-fonts.example-3">
             <title>Crear una fuente TrueType, pero no incluirla en el documento
-                PDF.</title>
+                PDF</title>
             <programlisting language="php"><![CDATA[
 ...
 // Crear una nueva fuente
@@ -470,7 +470,7 @@ $pdfPage->setFont($goodDogCoolFont, 36);
             suprimir la excepción:</para>
         <example id="zend.pdf.drawing.using-fonts.example-4">
             <title>No arrojar una excepción para las fuentes que no puedan ser
-                incorporadas.</title>
+                incorporadas</title>
             <programlisting language="php"><![CDATA[
 ...
 $font = Zend_Pdf_Font::fontWithPath(
@@ -499,7 +499,7 @@ $font = Zend_Pdf_Font::fontWithPath(
             puede desactivar con
             una opción:</para>
         <example id="zend.pdf.drawing.using-fonts.example-5">
-            <title>No comprimir una fuente incrustada.</title>
+            <title>No comprimir una fuente incrustada</title>
             <programlisting language="php"><![CDATA[
 ...
 $font = Zend_Pdf_Font::fontWithPath('/path/to/someReallyBigFont.ttf',
@@ -512,7 +512,7 @@ $font = Zend_Pdf_Font::fontWithPath('/path/to/someReallyBigFont.ttf',
             el operador binario OR:</para>
         <example id="zend.pdf.drawing.using-fonts.example-6">
             <title>La combinación de opciones de la incrustación de
-                fuentes.</title>
+                fuentes</title>
             <programlisting language="php"><![CDATA[
 ...
 $font = Zend_Pdf_Font::fontWithPath(
@@ -553,7 +553,7 @@ $font = Zend_Pdf_Font::fontWithPath(
             WinLatin1.</para>
         <example id="zend.pdf.drawing.using-fonts.example-7">
             <title>Combinación de opciones de la incrustación de
-                fuentes.</title>
+                fuentes</title>
             <programlisting language="php"><![CDATA[
 ...
 $font = Zend_Pdf_Font::fontWithName(Zend_Pdf_Font::FONT_COURIER);
@@ -566,7 +566,7 @@ $pdfPage->setFont($font, 36)
     </sect2>
 
     <sect2 id="zend.pdf.drawing.extracting-fonts">
-        <title>Extracción de las fuentes.</title>
+        <title>Extracción de las fuentes</title>
         <para>
             El módulo
             <classname>Zend_Pdf</classname>
@@ -591,7 +591,7 @@ $pdfPage->setFont($font, 36)
             documento o una página:
         </para>
         <example id="zend.pdf.drawing.extracting-fonts.example-1">
-            <title>Extracción de las fuentes de un documento cargado.</title>
+            <title>Extracción de las fuentes de un documento cargado</title>
             <programlisting language="php"><![CDATA[
 ...
 $pdf = Zend_Pdf::load($documentPath);
@@ -620,8 +620,7 @@ $firstPageFonts = $firstPage->extractFonts();
         </example>
         <example id="zend.pdf.drawing.extracting-fonts.example-2">
             <title>Extracción de la fuente de un documento cargado especificando
-                el nombre de la
-                fuente.</title>
+                el nombre de la fuente</title>
             <programlisting language="php"><![CDATA[
 ...
 $pdf = new Zend_Pdf();
@@ -956,7 +955,7 @@ public function setLineDashingPattern($pattern, $phase = 0);
     <sect2 id="zend.pdf.drawing.linear-transformations">
         <title>Transformaciones Lineales</title>
         <sect3 id="zend.pdf.drawing.linear-transformations.rotations">
-            <title>Rotaciones.</title>
+            <title>Rotaciones</title>
             <para>
                 La página
                 <acronym>PDF</acronym>
@@ -980,7 +979,7 @@ public function rotate($x, $y, $angle);
         </sect3>
 
         <sect3 id="zend.pdf.drawing.linear-transformations.scale">
-            <title>A partir de Zend Framework 1.8, el escalado.</title>
+            <title>A partir de Zend Framework 1.8, el escalado</title>
             <para>
                 La escala de transformación es proporcionada por el método:
                 <methodname>Zend_Pdf_Page::scale()</methodname>
@@ -999,7 +998,7 @@ public function scale($xScale, $yScale);
         </sect3>
 
         <sect3 id="zend.pdf.drawing.linear-transformations.translate">
-            <title>A partir de Zend Framework 1.8, traducir.</title>
+            <title>A partir de Zend Framework 1.8, traducir</title>
             <para>
                 El desplazamiento del sistema de coordenadas es realizado por
                 el método
@@ -1019,7 +1018,7 @@ public function translate($xShift, $yShift);
         </sect3>
 
         <sect3 id="zend.pdf.drawing.linear-transformations.skew">
-            <title>A partir de Zend Framework 1.8, el sesgo.</title>
+            <title>A partir de Zend Framework 1.8, el sesgo</title>
             <para>
                 El sesgo de una página se puede hacer utilizando el método
                 <methodname>Zend_Pdf_Page::skew()</methodname>
@@ -1041,7 +1040,7 @@ public function skew($x, $y, $xAngle, $yAngle);
     </sect2>
 
     <sect2 id="zend.pdf.drawing.save-restore">
-        <title>Guardar/Restaurar el estado de los gráficos.</title>
+        <title>Guardar/Restaurar el estado de los gráficos</title>
         <para>En cualquier momento el estado de la página de gráficos (fuente
             actual, tamaño de la
             fuente, color de línea, color de relleno,

documentation/manual/es/module_specs/Zend_Pdf-Pages.xml

@@ -98,7 +98,7 @@
         </para>
 
         <example id="zend.pdf.pages.example-1">
-            <title>Administración de Páginas de un Documento PDF.</title>
+            <title>Administración de Páginas de un Documento PDF</title>
             <programlisting language="php"><![CDATA[
 ...
 // Invertir el orden de las páginas.
@@ -118,7 +118,7 @@ unset($pdf->pages[$id]);
     </sect2>
 
     <sect2 id="zend.pdf.pages.cloning">
-        <title>Clonado de Páfinas.</title>
+        <title>Clonado de Páginas</title>
         <para>
             La página
             <acronym>PDF</acronym>
@@ -129,7 +129,7 @@ unset($pdf->pages[$id]);
         </para>
 
         <example id="zend.pdf.pages.example-2">
-            <title>Clonando una Página Existente.</title>
+            <title>Clonando una Página Existente</title>
             <programlisting language="php"><![CDATA[
 ...
 // Almacenar la página plantilla en una variable

documentation/manual/es/module_specs/Zend_Pdf-Properties.xml

@@ -3,7 +3,7 @@
     <!-- Reviewed: no -->
 <sect1 id="zend.pdf.info">
     <!-- @todo review and revise upon completion of refactoring -->
-    <title>Información del Documento y Metadatos.</title>
+    <title>Información del Documento y Metadatos</title>
     <para>
         Un documento
         <acronym>PDF</acronym>

documentation/manual/es/module_specs/Zend_Tool_Framework-WritingProviders.xml

@@ -3,100 +3,70 @@
     <!-- Reviewed: no -->
 <sect1 id="zend.tool.framework.writing-providers">
     <title>Creando Proveedores para usar con Zend_Tool_Framework</title>
-    <para>
-        In general, a provider, on its own, is nothing more than the shell for a
-        developer to bundle
-        up some capabilities they wish to dispatch with the
-        command line (or other) clients. It is an
-        analogue to what a
-        "controller" is inside of your
-        <acronym>MVC</acronym>
-        application.
-    </para>
+    <para> In general, a provider, on its own, is nothing more than the shell
+        for a developer to bundle up some capabilities they wish to dispatch
+        with the command line (or other) clients. It is an analogue to what a
+        "controller" is inside of your <acronym>MVC</acronym> application. </para>
 
     <sect2 id="zend.tool.framework.writing-providers.loading">
         <title>How Zend Tool finds your Providers</title>
 
-        <para>
-            By default Zend Tool uses the IncludePathLoader to find all
-            the providers that you can
-            run. It recursivly iterates all
-            include path directories and opens all files that end
-            with "Manifest.php" or "Provider.php". All classes in these
-            files are inspected if they
+        <para> By default Zend Tool uses the IncludePathLoader to find all the
+            providers that you can run. It recursivly iterates all include path
+            directories and opens all files that end with "Manifest.php" or
+            "Provider.php". All classes in these files are inspected if they
             implement either
-            <classname>Zend_Tool_Framework_Provider_Interface</classname>
-            or
-            <classname>Zend_Tool_Framework_Manifest_ProviderManifestable</classname>
-            .
-            Instances of the provider interface make up for the real functionality
-            and all their
-            public methods are accessible as provider actions.
-            The ProviderManifestable interface
-            however requires the implementation of a method
-            <methodname>getProviders()</methodname>
-            which returns an array of
-            instantiated provider interface instances.
-        </para>
-
-        <para>
-            The following naming rules apply on how you can access the providers
-            that were found by
-            the IncludePathLoader:
-       </para>
+                <classname>Zend_Tool_Framework_Provider_Interface</classname> or
+                <classname>Zend_Tool_Framework_Manifest_ProviderManifestable</classname>
+            . Instances of the provider interface make up for the real
+            functionality and all their public methods are accessible as
+            provider actions. The ProviderManifestable interface however
+            requires the implementation of a method
+                <methodname>getProviders()</methodname> which returns an array
+            of instantiated provider interface instances. </para>
+
+        <para> The following naming rules apply on how you can access the
+            providers that were found by the IncludePathLoader: </para>
 
         <itemizedlist>
             <listitem>
-                <para>
-                    The last part of your classname split by underscore is used
-                    for the provider
-                    name, e.g. "My_Provider_Hello" leads to your
-                    provider being accessible by the
-                    name "hello".
-               </para>
+                <para> The last part of your classname split by underscore is
+                    used for the provider name, e.g. "My_Provider_Hello" leads
+                    to your provider being accessible by the name "hello".
+                </para>
             </listitem>
             <listitem>
-                <para>
-                    If your provider has a method
-                    <methodname>getName()</methodname>
-                    it will be used instead of the previous method to determine
-                    the name.
+                <para> If your provider has a method
+                        <methodname>getName()</methodname> it will be used
+                    instead of the previous method to determine the name.
                 </para>
             </listitem>
             <listitem>
-                <para>
-                    If your provider has "Provider" as prefix, e.g. it is called
-                    <classname>My_HelloProvider</classname>
-                    it will be stripped
-                    from the name so that the provider will be called "hello".
-                </para>
+                <para> If your provider has "Provider" as prefix, e.g. it is
+                    called <classname>My_HelloProvider</classname> it will be
+                    stripped from the name so that the provider will be called
+                    "hello". </para>
             </listitem>
         </itemizedlist>
 
         <note>
-            <para>The IncludePathLoader does not follow symlinks, that means
-                you cannot link provider functionality into your include paths,
-                they have to be physically present in the include paths.</para>
+            <para>The IncludePathLoader does not follow symlinks, that means you
+                cannot link provider functionality into your include paths, they
+                have to be physically present in the include paths.</para>
         </note>
 
         <example id="zend.tool.framework.writing-providers.loading.example">
             <title>Exposing Your Providers with a Manifest</title>
 
-            <para>
-                You can expose your providers to Zend Tool by offering a manifest
-                with a special
-                filename ending with "Manifest.php".
-                A Provider Manifest is an implementation of the
-                <interface>Zend_Tool_Framework_Manifest_ProviderManifestable</interface>
-                and requires the
-                <methodname>getProviders()</methodname>
-                method to return
-                an array of instantiated providers. In anticipation of our first
-                own
-                provider
-                <classname>My_Component_HelloProvider</classname>
-                we will create the following manifest:
-            </para>
+            <para> You can expose your providers to Zend Tool by offering a
+                manifest with a special filename ending with "Manifest.php". A
+                Provider Manifest is an implementation of the
+                    <interface>Zend_Tool_Framework_Manifest_ProviderManifestable</interface>
+                and requires the <methodname>getProviders()</methodname> method
+                to return an array of instantiated providers. In anticipation of
+                our first own provider
+                    <classname>My_Component_HelloProvider</classname> we will
+                create the following manifest: </para>
 
             <programlisting language="php"><![CDATA[
 class My_Component_Manifest
@@ -117,27 +87,17 @@ class My_Component_Manifest
     <sect2 id="zend.tool.framework.writing-providers.basic">
         <title>Basic Instructions for Creating Providers</title>
 
-        <para>
-            As an example, if a developer wants to add the capability of showing
-            the version of a
-            datafile that his 3rd party component is working
-            from, there is only one class the
-            developer would need to implement.
-            Assuming the component is called
-            <classname>My_Component</classname>
-            , he would
-            create a class named
-            <classname>My_Component_HelloProvider</classname>
-            in a
-            file named
-            <filename>HelloProvider.php</filename>
-            somewhere on the
-            <property>include_path</property>
-            . This class would implement
-            <classname>Zend_Tool_Framework_Provider_Interface</classname>
-            , and the body of
-            this file would only have to look like the following:
-        </para>
+        <para> As an example, if a developer wants to add the capability of
+            showing the version of a datafile that his 3rd party component is
+            working from, there is only one class the developer would need to
+            implement. Assuming the component is called
+                <classname>My_Component</classname> , he would create a class
+            named <classname>My_Component_HelloProvider</classname> in a file
+            named <filename>HelloProvider.php</filename> somewhere on the
+                <property>include_path</property> . This class would implement
+                <classname>Zend_Tool_Framework_Provider_Interface</classname> ,
+            and the body of this file would only have to look like the
+            following: </para>
 
         <programlisting language="php"><![CDATA[
 class My_Component_HelloProvider
@@ -150,12 +110,9 @@ class My_Component_HelloProvider
 }
 ]]></programlisting>
 
-        <para>
-            Given that code above, and assuming the developer wishes to access
-            this functionality
-            through the console client, the call would look
-            like this:
-       </para>
+        <para> Given that code above, and assuming the developer wishes to
+            access this functionality through the console client, the call would
+            look like this: </para>
 
         <programlisting language="sh"><![CDATA[
 % zf say hello
@@ -166,16 +123,12 @@ Hello from my provider!
     <sect2 id="zend.tool.framework.writing-providers.response">
         <title>The response object</title>
 
-        <para>
-            As discussed in the architecture section Zend Tool allows to hook different clients for
-            using your Zend Tool providers. To keep compliant with different clients you should
-            use
-            the response object to return messages from your providers instead of using
-            <methodname>echo()</methodname>
-            or a similiar output mechanism. Rewritting our hello
-            provider with this knowledge it
-            looks like:
-        </para>
+        <para> As discussed in the architecture section Zend Tool allows to hook
+            different clients for using your Zend Tool providers. To keep
+            compliant with different clients you should use the response object
+            to return messages from your providers instead of using
+                <methodname>echo()</methodname> or a similiar output mechanism.
+            Rewritting our hello provider with this knowledge it looks like: </para>
 
         <programlisting language="php"><![CDATA[
 class My_Component_HelloProvider
@@ -189,13 +142,11 @@ class My_Component_HelloProvider
 }
 ]]></programlisting>
 
-        <para>
-            As you can see one has to extend the
-            <classname>Zend_Tool_Framework_Provider_Abstract</classname>
-            to gain access to the Registry which holds the
-            <classname>Zend_Tool_Framework_Client_Response</classname>
-            instance.
-        </para>
+        <para> As you can see one has to extend the
+                <classname>Zend_Tool_Framework_Provider_Abstract</classname> to
+            gain access to the Registry which holds the
+                <classname>Zend_Tool_Framework_Client_Response</classname>
+            instance. </para>
     </sect2>
 
     <sect2 id="zend.tool.framework.writing-providers.advanced">
@@ -204,30 +155,19 @@ class My_Component_HelloProvider
         <sect3 id="zend.tool.framework.writing-providers.advanced.variables">
             <title>Passing Variables to a Provider</title>
 
-            <para>
-                The above "Hello World" example is great for simple commands, but
-                what about
-                something more advanced? As your scripting and tooling
-                needs grow, you might find
-                that you need the ability to accept
-                variables. Much like function signatures have
-                parameters, your
-                tooling requests can also accept parameters.
-           </para>
-
-            <para>
-                Just as each tooling request can be isolated to a method within a
-                class, the
-                parameters of a tooling request can also be isolated in a
-                very well known place.
-                Parameters of the action methods of a
-                provider can include the same parameters you
-                want your client to
-                utilize when calling that provider and action combination. For
-                example, if you wanted to accept a name in the above example, you
-                would probably do
-                this in OO code:
-           </para>
+            <para> The above "Hello World" example is great for simple commands,
+                but what about something more advanced? As your scripting and
+                tooling needs grow, you might find that you need the ability to
+                accept variables. Much like function signatures have parameters,
+                your tooling requests can also accept parameters. </para>
+
+            <para> Just as each tooling request can be isolated to a method
+                within a class, the parameters of a tooling request can also be
+                isolated in a very well known place. Parameters of the action
+                methods of a provider can include the same parameters you want
+                your client to utilize when calling that provider and action
+                combination. For example, if you wanted to accept a name in the
+                above example, you would probably do this in OO code: </para>
 
             <programlisting language="php"><![CDATA[
 class My_Component_HelloProvider
@@ -240,32 +180,22 @@ class My_Component_HelloProvider
 }
 ]]></programlisting>
 
-            <para>
-                The above example can then be called via the command line
-                <command>zf say hello Joe</command>
-                . "Joe" will be supplied to the provider as
-                a parameter of the method call. Also
-                note, as you see that the
-                parameter is optional, that means it is also optional on
-                the command
-                line, so that
-                <command>zf say hello</command>
-                will still work, and default
-                to the name "Ralph".
-            </para>
+            <para> The above example can then be called via the command line
+                    <command>zf say hello Joe</command> . "Joe" will be supplied
+                to the provider as a parameter of the method call. Also note, as
+                you see that the parameter is optional, that means it is also
+                optional on the command line, so that <command>zf say
+                    hello</command> will still work, and default to the name
+                "Ralph". </para>
 
         </sect3>
 
         <sect3 id="zend.tool.framework.writing-providers.advanced.prompt">
             <title>Prompt the User for Input</title>
 
-            <para>
-                There are cases when the workflow of your provider requires
-                to prompt the user for
-                input. This can be done by requesting
-                the client to ask for more the required input
-                by calling:
-           </para>
+            <para> There are cases when the workflow of your provider requires
+                to prompt the user for input. This can be done by requesting the
+                client to ask for more the required input by calling: </para>
 
             <programlisting language="php"><![CDATA[
 class My_Component_HelloProvider
@@ -283,45 +213,29 @@ class My_Component_HelloProvider
 }
 ]]></programlisting>
 
-            <para>
-                This command throws an exception if the current client is not
-                able to handle
-                interactive requests. In case of the default Console Client
-                however you will be asked
-                to enter the name.
-           </para>
+            <para> This command throws an exception if the current client is not
+                able to handle interactive requests. In case of the default
+                Console Client however you will be asked to enter the name.
+            </para>
         </sect3>
 
         <sect3 id="zend.tool.framework.writing-providers.advanced.pretendable">
             <title>Pretending to execute a Provider Action</title>
 
-            <para>
-                Another interesting feature you might wish to implement is
-                <emphasis>pretendability</emphasis>
-                . Pretendabilty is the ability
-                for your provider to "pretend" as if it is doing the
-                requested
-                action and provider combination and give the user as much
-                information about
-                what it
-                <emphasis>would</emphasis>
-                do without
-                actually doing it. This might be an important notion when doing
-                heavy
-                database or filesystem modifications that the user might not
-                otherwise want to do.
-            </para>
-
-            <para>
-                Pretendability is easy to implement. There are two parts to this
-                feature: 1)
-                marking the provider as having the ability to "pretend",
-                and 2) checking the request
-                to ensure the current request was indeed
-                asked to be "pretended". This feature is
-                demonstrated in the code
-                sample below.
-           </para>
+            <para> Another interesting feature you might wish to implement is
+                    <emphasis>pretendability</emphasis> . Pretendabilty is the
+                ability for your provider to "pretend" as if it is doing the
+                requested action and provider combination and give the user as
+                much information about what it <emphasis>would</emphasis> do
+                without actually doing it. This might be an important notion
+                when doing heavy database or filesystem modifications that the
+                user might not otherwise want to do. </para>
+
+            <para> Pretendability is easy to implement. There are two parts to
+                this feature: 1) marking the provider as having the ability to
+                "pretend", and 2) checking the request to ensure the current
+                request was indeed asked to be "pretended". This feature is
+                demonstrated in the code sample below. </para>
 
             <programlisting language="php"><![CDATA[
 class My_Component_HelloProvider
@@ -339,9 +253,7 @@ class My_Component_HelloProvider
 }
 ]]></programlisting>
 
-            <para>
-                To run the provider in pretend mode just call:
-           </para>
+            <para> To run the provider in pretend mode just call: </para>
 
             <programlisting language="sh"><![CDATA[
 % zf --pretend say hello Ralph
@@ -353,14 +265,10 @@ I would say hello Ralph.
         <sect3 id="zend.tool.framework.writing-providers.advanced.verbosedebug">
             <title>Verbose and Debug modes</title>
 
-            <para>
-                You can also run your provider actions in "verbose" or "debug" modes.
-                The semantics
-                in regard to this actions have to be implemented by you
-                in the context of your
-                provider. You can access debug or verbose modes
-                with:
-           </para>
+            <para> You can also run your provider actions in "verbose" or
+                "debug" modes. The semantics in regard to this actions have to
+                be implemented by you in the context of your provider. You can
+                access debug or verbose modes with: </para>
 
             <programlisting language="php"><![CDATA[
 class My_Component_HelloProvider
@@ -382,17 +290,13 @@ class My_Component_HelloProvider
         <sect3 id="zend.tool.framework.writing-providers.advanced.configstorage">
             <title>Accessing User Config and Storage</title>
 
-            <para>
-                Using the Enviroment variable
-                <property>ZF_CONFIG_FILE</property>
-                or the
-                .zf.ini in your home directory you can inject configuration parameters into
-                any Zend Tool provider. Access to this configuration is available via the
-                registry
-                that is passed to your provider if you extend
-                <classname>Zend_Tool_Framework_Provider_Abstract</classname>
-                .
-            </para>
+            <para> Using the Enviroment variable
+                    <property>ZF_CONFIG_FILE</property> or the .zf.ini in your
+                home directory you can inject configuration parameters into any
+                Zend Tool provider. Access to this configuration is available
+                via the registry that is passed to your provider if you extend
+                    <classname>Zend_Tool_Framework_Provider_Abstract</classname>
+                . </para>
 
             <programlisting language="php"><![CDATA[
 class My_Component_HelloProvider
@@ -410,26 +314,17 @@ class My_Component_HelloProvider
 }
 ]]></programlisting>
 
-            <para>
-                The returned configuration is of the type
-                <classname>Zend_Tool_Framework_Client_Config</classname>
-                but internally the
-                <methodname>__get()</methodname>
-                and
-                <methodname>__set()</methodname>
-                magic methods
-                proxy to a
-                <classname>Zend_Config</classname>
-                of the given configuration type.
-            </para>
+            <para> The returned configuration is of the type
+                    <classname>Zend_Tool_Framework_Client_Config</classname> but
+                internally the <methodname>__get()</methodname> and
+                    <methodname>__set()</methodname> magic methods proxy to a
+                    <classname>Zend_Config</classname> of the given
+                configuration type. </para>
 
-            <para>
-                The storage allows to save arbitrary data for later reference. This can be useful
-                for batch
-                processing tasks or for re-runs of your tasks. You can access the storage
-                in a similar way
-                like the configuration:
-           </para>
+            <para> The storage allows to save arbitrary data for later
+                reference. This can be useful for batch processing tasks or for
+                re-runs of your tasks. You can access the storage in a similar
+                way like the configuration: </para>
 
             <programlisting language="php"><![CDATA[
 class My_Component_HelloProvider
@@ -443,9 +338,7 @@ class My_Component_HelloProvider
 }
 ]]></programlisting>
 
-            <para>
-                The API of the storage is very simple:
-           </para>
+            <para> The API of the storage is very simple: </para>
 
             <programlisting language="php"><![CDATA[
 class Zend_Tool_Framework_Client_Storage
@@ -461,14 +354,11 @@ class Zend_Tool_Framework_Client_Storage
 ]]></programlisting>
 
             <important>
-                <para>
-                    When designing your providers that are config or storage aware remember to
-                    check if the required user-config or storage keys really exist for a user.
-                    You
-                    won't run into fatal errors when none of these are provided though,
-                    since empty
-                    ones are created upon request.
-               </para>
+                <para> When designing your providers that are config or storage
+                    aware remember to check if the required user-config or
+                    storage keys really exist for a user. You won't run into
+                    fatal errors when none of these are provided though, since
+                    empty ones are created upon request. </para>
             </important>
         </sect3>
 

documentation/manual/es/ref/installation.xml

@@ -5,137 +5,97 @@
 
     <title> Instalación</title>
 
-    <para>
-        Véase el apéndice
-        <link linkend="requirements">requisitos</link>
-        para una lista detallada de
-        requisitos para Zend Framework.
-    </para>
+    <para> 
+        Véase el apéndice <link linkend="requirements"> 
+        requisitos</link> para
+        una lista detallada de requisitos para Zend Framework. </para>
 
-    <para>
-        La instalación del Zend Framework es muy simple. Una vez que haya descargado y descomprimido
-        el framework, deberá añadir la carpeta
-        <filename>/library</filename>
-        de la distribución al principio de su "include path". También puede mover la carpeta
-        "library" a cualquier otra posición (compartida o no) de su sistema de archivos.
-    </para>
+    <para> La instalación del Zend Framework es muy simple. Una vez que haya
+        descargado y descomprimido el framework, deberá añadir la carpeta
+            <filename>/library</filename> de la distribución al principio de su
+        "include path". También puede mover la carpeta "library" a cualquier
+        otra posición (compartida o no) de su sistema de archivos. </para>
 
     <itemizedlist>
         <listitem>
             <para>
-                <ulink url="http://framework.zend.com/download">Descargar la última versión estable.</ulink>
-                Esta versión esta disponible en formatos
-                <filename>.zip</filename>
-                .
-                <filename>.tar.gz</filename>
-                ,
-                es una buena opción para aquellos que comienzan o son nuevos en Zend Framework.
-            </para>
+                <ulink url="http://framework.zend.com/download">Descargar la
+                    última versión estable.</ulink> Esta versión esta disponible
+                en formatos <filename>.zip</filename> .
+                    <filename>.tar.gz</filename> , es una buena opción para
+                aquellos que comienzan o son nuevos en Zend Framework. </para>
         </listitem>
 
         <listitem>
             <para>
-                <ulink url="http://framework.zend.com/download/snapshot">Download the latest
-                    nightly snapshot.</ulink>
-                For those who would brave the cutting edge, the
-                nightly snapshots represent the
-                latest progress of Zend Framework development.
-                Snapshots are bundled with
-                documentation either in English only or in all
-                available languages. If you anticipate
-                working with the latest Zend Framework
-                developments, consider using a Subversion (
-                <acronym>SVN</acronym>
-                ) client.
-            </para>
+                <ulink url="http://framework.zend.com/download/snapshot"
+                    >Download the latest nightly snapshot.</ulink> For those who
+                would brave the cutting edge, the nightly snapshots represent
+                the latest progress of Zend Framework development. Snapshots are
+                bundled with documentation either in English only or in all
+                available languages. If you anticipate working with the latest
+                Zend Framework developments, consider using a Subversion (
+                    <acronym>SVN</acronym> ) client. </para>
         </listitem>
         <listitem>
+            <para> Using a <ulink url="http://subversion.tigris.org"
+                    >Subversion</ulink> ( <acronym>SVN</acronym> ) client. Zend
+                Framework is open source software, and the Subversion repository
+                used for its development is publicly available. Consider using
+                    <acronym>SVN</acronym> to get Zend Framework if you already
+                use <acronym>SVN</acronym> for your application development,
+                want to contribute back to the framework, or need to upgrade
+                your framework version more often than releases occur. </para>
             <para>
-                Using a
-                <ulink url="http://subversion.tigris.org">Subversion</ulink>
-                (
-                <acronym>SVN</acronym>
-                ) client. Zend Framework is open source software, and the
-                Subversion repository used
-                for its development is publicly available. Consider
-                using
-                <acronym>SVN</acronym>
-                to get Zend Framework if you already use
-                <acronym>SVN</acronym>
-                for your application development, want to
-                contribute back to the framework, or need
-                to upgrade your framework version
-                more often than releases occur.
-            </para>
-            <para>
-                <ulink url="http://svnbook.red-bean.com/nightly/en/svn.ref.svn.c.export.html">
-                    Exporting</ulink>
-                is useful if you want to get a particular framework revision
-                without the
-                <filename>.svn</filename>
-                directories as created in a working copy.
-            </para>
-            <para>
-                <ulink url="http://svnbook.red-bean.com/nightly/en/svn.ref.svn.c.checkout.html">
-                    Check out a working copy</ulink>
-                if you want contribute to Zend Framework, a
-                working copy can be updated any time with
-                <ulink url="http://svnbook.red-bean.com/nightly/en/svn.ref.svn.c.update.html">
-                    svn update</ulink>
-                and changes can be commited to our
-                <acronym>SVN</acronym>
-                repository with the
-                <ulink url="http://svnbook.red-bean.com/nightly/en/svn.ref.svn.c.commit.html">
-                    svn commit</ulink>
-                command.
-            </para>
-            <para>
-                An
-                <ulink url="http://svnbook.red-bean.com/nightly/en/svn.advanced.externals.html">
-                    externals definition</ulink>
-                is quite convenient for developers already using
-                <acronym>SVN</acronym>
-                to manage their application’s working copies.
-            </para>
+                <ulink
+                    url="http://svnbook.red-bean.com/nightly/en/svn.ref.svn.c.export.html"
+                    > Exporting</ulink> is useful if you want to get a
+                particular framework revision without the
+                    <filename>.svn</filename> directories as created in a
+                working copy. </para>
             <para>
-                The
-                <acronym>URL</acronym>
-                for the trunk of Zend Framework’s
-                <acronym>SVN</acronym>
-                repository is:
-                <ulink url="http://framework.zend.com/svn/framework/standard/trunk">
+                <ulink
+                    url="http://svnbook.red-bean.com/nightly/en/svn.ref.svn.c.checkout.html"
+                    > Check out a working copy</ulink> if you want contribute to
+                Zend Framework, a working copy can be updated any time with
+                    <ulink
+                    url="http://svnbook.red-bean.com/nightly/en/svn.ref.svn.c.update.html"
+                    > svn update</ulink> and changes can be commited to our
+                    <acronym>SVN</acronym> repository with the <ulink
+                    url="http://svnbook.red-bean.com/nightly/en/svn.ref.svn.c.commit.html"
+                    > svn commit</ulink> command. </para>
+            <para> An <ulink
+                    url="http://svnbook.red-bean.com/nightly/en/svn.advanced.externals.html"
+                    > externals definition</ulink> is quite convenient for
+                developers already using <acronym>SVN</acronym> to manage their
+                application's working copies. </para>
+            <para> The <acronym>URL</acronym> for the trunk of Zend Framework's
+                    <acronym>SVN</acronym> repository is: <ulink
+                    url="http://framework.zend.com/svn/framework/standard/trunk"
+                    >
                     http://framework.zend.com/svn/framework/standard/trunk</ulink>
             </para>
         </listitem>
     </itemizedlist>
 
-    <para>
-        Una vez que tenga disponible una copia de Zend Framework, su aplicación necesita poder
-        acceder a las clases del framework. Aunque hay
-        <ulink url="http://www.php.net/manual/en/configuration.changes.php">
-            diferentes maneras de lograr esto</ulink>
-        , su
-        <ulink url="http://www.php.net/manual/en/ini.core.php#ini.include-path">
+    <para> Una vez que tenga disponible una copia de Zend Framework, su
+        aplicación necesita poder acceder a las clases del framework. Aunque hay
+            <ulink url="http://www.php.net/manual/en/configuration.changes.php">
+            diferentes maneras de lograr esto</ulink> , su <ulink
+            url="http://www.php.net/manual/en/ini.core.php#ini.include-path">
             <methodname>include_path</methodname>
-        </ulink>
-        de
-        <acronym>PHP</acronym>
-        necesita contener una ruta a la librería de Zend Framework.
-    </para>
+        </ulink> de <acronym>PHP</acronym> necesita contener una ruta a la
+        librería de Zend Framework. </para>
 
-    <para>
-        Zend provides a
-        <ulink url="http://framework.zend.com/docs/quickstart">QuickStart</ulink>
-        to get you up and running
-        as quickly as possible. This is an excellent way to begin learning
-        about the framework with an emphasis
-        on real world examples that you can built upon.
-    </para>
+    <para> Zend provides a <ulink
+            url="http://framework.zend.com/docs/quickstart">QuickStart</ulink>
+        to get you up and running as quickly as possible. This is an excellent
+        way to begin learning about the framework with an emphasis on real world
+        examples that you can built upon. </para>
 
-    <para>
-        Ya que los componentes de Zend Framework están débilmente conectados, tiene la opción de
-        usar cualquier combinación de ellos en sus aplicaciones. Los siguientes capítulos presentan
-        una referencia exhaustiva de Zend Framework, componente a componente.
-    </para>
+    <para> Ya que los componentes de Zend Framework están débilmente conectados,
+        tiene la opción de usar cualquier combinación de ellos en sus
+        aplicaciones. Los siguientes capítulos presentan una referencia
+        exhaustiva de Zend Framework, componente a componente. </para>
 
 </chapter>