Просмотр исходного кода

UPDATE FILES DOC-ES

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@19605 44c647ce-9c0f-0410-b52a-842ac1e357ba
benjamin-gonzales 16 лет назад
Родитель
Сommit
c01f930190

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

@@ -12,37 +12,37 @@
                 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.
+                (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
+            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
+                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
+            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
+            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>
 
@@ -53,13 +53,13 @@
                     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
+                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
+                Para deshabilitar el <emphasis>ErrorHandler</emphasis>, ejecutar lo 
+                siguiente en cualquier momento antes de llamar a 
                 <methodname>dispatch()</methodname>:
             </para>
 
@@ -69,7 +69,7 @@ $front->setParam('noErrorHandler', true);
 ]]></programlisting>
 
             <para>
-                Para deshabilitar el <emphasis>ViewRenderer</emphasis>, haga lo
+                Para deshabilitar el <emphasis>ViewRenderer</emphasis>, haga lo 
                 siguiente antes de llamar a <methodname>dispatch()</methodname>:
             </para>
 
@@ -84,8 +84,8 @@ $front->setParam('noViewRenderer', true);
         <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
+            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>
 
@@ -93,9 +93,9 @@ $front->setParam('noViewRenderer', true);
             <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
+                <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>
 
@@ -112,7 +112,7 @@ $front = Zend_Controller_Front::getInstance();
                     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
+                Acepta bien un único path o un array asociativo de pares 
                 módulo/path.
             </para>
 
@@ -137,16 +137,16 @@ $front->addControllerDirectory('../modules/foo/controllers', 'foo');
 
             <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 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>;
+                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>
@@ -156,30 +156,30 @@ $front->addControllerDirectory('../modules/foo/controllers', 'foo');
 
             <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
+                    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>
+                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>
-                <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.
+                <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
+                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>
@@ -190,28 +190,28 @@ $front->addControllerDirectory('../modules/foo/controllers', 'foo');
             <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
+                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
+                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á
+                <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>
+                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
+                , instanciando las versiones por defecto de cada uno si ninguno 
                 de ellos se encuentra.
             </para>
 
@@ -226,12 +226,12 @@ $front->addControllerDirectory('../modules/foo/controllers', 'foo');
             </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 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 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>
         </sect3>
@@ -240,10 +240,10 @@ $front->addControllerDirectory('../modules/foo/controllers', 'foo');
             <title>run()</title>
 
             <para>
-                <classname>Zend_Controller_Front::run($path)</classname>
-                es un método estático que toma simplemente un path a un
-                directorio que contiene controladores. Obtiene una instancia
-                del front controller (via
+                <classname>Zend_Controller_Front::run($path)</classname> 
+                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
@@ -253,13 +253,13 @@ $front->addControllerDirectory('../modules/foo/controllers', 'foo');
             </para>
 
             <para>
-                Básicamente, <methodname>run()</methodname> es un método conveniente que
-                pueden utilizarse para setups de sitios que no requieran la
+                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,
+// Instanciar el front controller, establecer el directorio de controladores, 
 // y hacer el dispatch fácilmente en en un solo paso:
 Zend_Controller_Front::run('../application/controllers');
 ]]></programlisting>
@@ -270,27 +270,27 @@ Zend_Controller_Front::run('../application/controllers');
         <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
+            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
+                    <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
+                    <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>.
@@ -300,9 +300,9 @@ Zend_Controller_Front::run('../application/controllers');
             <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
+                    <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>.
@@ -311,13 +311,13 @@ Zend_Controller_Front::run('../application/controllers');
 
             <listitem>
                 <para>
-                    <methodname>setRequest()</methodname> y
-                    <methodname>getRequest()</methodname> le permite especificar la
+                    <<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
+                    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>
@@ -325,18 +325,18 @@ Zend_Controller_Front::run('../application/controllers');
             <listitem>
                 <para>
                      <methodname>setRouter()</methodname>
-                    <methodname>getRouter()</methodname> le permite especificar la
+                    <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
+                    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
+                    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>
@@ -346,8 +346,8 @@ Zend_Controller_Front::run('../application/controllers');
                     <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
+                        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>
@@ -355,19 +355,19 @@ Zend_Controller_Front::run('../application/controllers');
             <listitem>
                 <para>
                      <methodname>setDispatcher()</methodname> y
-                    <methodname>getDispatcher()</methodname> le permite especificar la
+                    <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
+                        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
+                    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>
@@ -375,12 +375,12 @@ Zend_Controller_Front::run('../application/controllers');
             <listitem>
                 <para>
                     <methodname>setResponse()</methodname> y
-                    <methodname>getResponse()</methodname> le permite especificar la
+                    <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
+                    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>
@@ -390,7 +390,7 @@ Zend_Controller_Front::run('../application/controllers');
                     <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
+                    Opcionalmente, setting <varname>$stackIndex</varname>, puede 
                     controlar el orden en que se ejecutarán los plugins.
                 </para>
             </listitem>
@@ -400,16 +400,16 @@ Zend_Controller_Front::run('../application/controllers');
                     <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
+                    <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
+                    <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>
@@ -424,21 +424,21 @@ Zend_Controller_Front::run('../application/controllers');
 
             <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
+                    <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
+                    Por defecto, la respuesta es automáticamente emitida 
+                    (llamando a                  
                     <classname>Zend_Controller_Response_Abstract::sendResponse()</classname>);
-                    activando <methodname>returnResponse()</methodname>) se anulará este
+                    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
+                    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>
@@ -449,58 +449,58 @@ Zend_Controller_Front::run('../application/controllers');
         <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,
+            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 <methodname>$name</methodname> con el valor
+                    <methodname>setParam($name, $value)</methodname> permite establecer un 
+                    único parámetro de <methodname>$name</methodname> con el valor 
                     <varname>$value</varname>.
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>setParams(array $params)</methodname> permite configurar
+                    <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
+                    <methodname>getParam($name)</methodname> permite recuperar un único 
+                    parámetro a la vez, utilizando como identificador a 
                     <methodname>$name</methodname>.
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>getParams()</methodname> permite recuperar toda la lista de
+                    <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),
+                    <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
+            Hay varios parámetros pre-definidos que puede ser seteados para 
             tener usos específicos en la cadena de dispatch:
         </para>
 
@@ -509,14 +509,14 @@ Zend_Controller_Front::run('../application/controllers');
                 <para>
                     <methodname>useDefaultControllerAlways</methodname> 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
+                        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" />
+                    Ver <link linkend="zend.controller.exceptions.internal">
                     para información más detallada sobre el uso de este setting.
                 </para>
             </listitem>
@@ -525,10 +525,10 @@ Zend_Controller_Front::run('../application/controllers');
                 <para>
                     <methodname>disableOutputBuffering</methodname> 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
+                        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>
@@ -545,7 +545,7 @@ Zend_Controller_Front::run('../application/controllers');
                 <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,
+                        Handler plugin</link>. Poniendo este parámetro a true, 
                         lo deshabilita.
                 </para>
             </listitem>
@@ -556,7 +556,7 @@ Zend_Controller_Front::run('../application/controllers');
         <title>Extendiendo el Front Controller</title>
 
         <para>
-            Para extender el Front Controller, como mínimo que necesitará
+            Para extender el Front Controller, como mínimo que necesitará 
             anular el método <methodname>getInstance()</methodname>:
         </para>
 
@@ -575,23 +575,23 @@ class My_Controller_Front extends Zend_Controller_Front
 ]]></programlisting>
 
         <para>
-            Anulando el método <methodname>getInstance()</methodname> asegura que las
+            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
+            <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
+            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>

+ 4 - 4
documentation/manual/es/module_specs/Zend_Db_Statement.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15103 -->
+<!-- EN-Revision: 17987 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.db.statement">
 
@@ -86,7 +86,7 @@ $stmt = new Zend_Db_Statement_Mysqli($db, $sql);
 
         <para>
             Si usa <emphasis>parámetros posicionales</emphasis>, o los que
-            están marcados por un signo de interrogación (<methodname>?</methodname>), pase
+            están marcados por un signo de interrogación (<emphasis>?</emphasis>), pase
             los valores de vinculación en un array plano.
         </para>
 
@@ -104,7 +104,7 @@ $stmt->execute(array('goofy', 'FIXED'));
         <para>
             Si usa <emphasis>parámetros nombrados</emphasis>, o los que son
             indicados por un string identificador precedido por un caracter de
-            dos puntos (<methodname>:</methodname>), pase el valor en un array asociativo.
+            dos puntos (<emphasis>:</emphasis>), pase el valor en un array asociativo.
             Las claves de este array deben coincidir con el nombre de los
             parámetros.
         </para>
@@ -122,7 +122,7 @@ $stmt->execute(array(':reporter' => 'goofy', ':status' => 'FIXED'));
         </example>
 
         <para>
-            Las declaraciones PDO soportan tanto parámetros posicionales como
+            Las declaraciones <acronym>PDO</acronym> soportan tanto parámetros posicionales como
             parámetros nombrados, pero no ambos tipos en la misma declaración
             <acronym>SQL</acronym>. Algunas clases <classname>Zend_Db_Statement</classname> para extensiones no-PDO
             soportan solo un tipo de parámetro o el otro.

+ 199 - 190
documentation/manual/es/module_specs/Zend_Db_Table-Relationships.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15103 -->
+<!-- EN-Revision: 17598 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.db.table.relationships">
 
@@ -16,7 +16,8 @@
         </para>
 
         <para>
-            The <classname>Zend_Db_Table_Row</classname> class has methods for querying related rows in other tables.
+            The <classname>Zend_Db_Table_Row</classname> class has methods for querying related rows
+            in other tables.
         </para>
 
     </sect2>
@@ -27,7 +28,8 @@
 
         <para>
             Define classes for each of your tables, extending the abstract class
-            <classname>Zend_Db_Table_Abstract</classname>, as described in <xref linkend="zend.db.table.defining" />. Also
+            <classname>Zend_Db_Table_Abstract</classname>, as described in
+            <xref linkend="zend.db.table.defining" />. Also
             see <xref linkend="zend.db.adapter.example-database" /> for a description of the
             example database for which the following example code is designed.
         </para>
@@ -36,7 +38,7 @@
             Below are the <acronym>PHP</acronym> class definitions for these tables:
         </para>
 
-         <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 class Accounts extends Zend_Db_Table_Abstract
 {
     protected $_name            = 'accounts';
@@ -95,44 +97,45 @@ class BugsProducts extends Zend_Db_Table_Abstract
 ]]></programlisting>
 
         <para>
-            If you use <classname>Zend_Db_Table</classname> to emulate cascading UPDATE and DELETE operations, declare the
-            <methodname>$_dependentTables</methodname> array in the class for the parent table. List the class
-            name for each dependent table. Use the class name, not the physical name of the SQL
-            table.
+            If you use <classname>Zend_Db_Table</classname> to emulate cascading UPDATE and DELETE
+            operations, declare the <varname>$_dependentTables</varname> array in the class for the
+            parent table. List the class name for each dependent table. Use the class name, not the
+            physical name of the <acronym>SQL</acronym> table.
         </para>
 
         <note>
 
             <para>
-                Skip declaration of <methodname>$_dependentTables</methodname> if you use referential integrity
-                constraints in the  <acronym>RDBMS</acronym> server to implement cascading operations. See
-                <xref linkend="zend.db.table.relationships.cascading" /> for more information.
+                Skip declaration of <varname>$_dependentTables</varname> if you use referential
+                integrity constraints in the <acronym>RDBMS</acronym> server to implement cascading
+                operations. See <xref linkend="zend.db.table.relationships.cascading" /> for more
+                information.
             </para>
 
         </note>
 
         <para>
-            Declare the <methodname>$_referenceMap</methodname> array in the class for each dependent table.
-            This is an associative array of reference "rules". A reference rule identifies which
-            table is the parent table in the relationship, and also lists which columns in the
+            Declare the <varname>$_referenceMap</varname> array in the class for each dependent
+            table. This is an associative array of reference "rules". A reference rule identifies
+            which table is the parent table in the relationship, and also lists which columns in the
             dependent table reference which columns in the parent table.
         </para>
 
         <para>
-            The rule key is a string used as an index to the <methodname>$_referenceMap</methodname> array.
-            This rule key is used to identify each reference relationship. Choose a descriptive
-            name for this rule key. It's best to use a string that can be part of a <acronym>PHP</acronym> method
-            name, as you will see later.
+            The rule key is a string used as an index to the <varname>$_referenceMap</varname>
+            array. This rule key is used to identify each reference relationship. Choose a
+            descriptive name for this rule key. It's best to use a string that can be part of a
+            <acronym>PHP</acronym> method name, as you will see later.
         </para>
 
         <para>
-            In the example <acronym>PHP</acronym> code above, the rule keys in the Bugs table class are:
-            <methodname>'Reporter'</methodname>, <methodname>'Engineer'</methodname>, <methodname>'Verifier'</methodname>, and
-            <methodname>'Product'</methodname>.
+            In the example <acronym>PHP</acronym> code above, the rule keys in the Bugs table class
+            are: <code>'Reporter'</code>, <code>'Engineer'</code>, <code>'Verifier'</code>, and
+            <code>'Product'</code>.
         </para>
 
         <para>
-            The value of each rule entry in the <methodname>$_referenceMap</methodname> array is also an
+            The value of each rule entry in the <varname>$_referenceMap</varname> array is also an
             associative array. The elements of this rule entry are described below:
         </para>
 
@@ -151,17 +154,17 @@ class BugsProducts extends Zend_Db_Table_Abstract
 
             <listitem>
                 <para>
-                    <emphasis>refTableClass</emphasis> => The class name of the
-                    parent table. Use the class name, not the physical name of the <acronym>SQL</acronym> table.
+                    <emphasis>refTableClass</emphasis> => The class name of the parent table. Use
+                    the class name, not the physical name of the <acronym>SQL</acronym> table.
                 </para>
 
                 <para>
                     It's common for a dependent table to have only one reference to its parent
                     table, but some tables have multiple references to the same parent table. In
-                    the example database, there is one reference from the <methodname>bugs</methodname> table
-                    to the <methodname>products</methodname> table, but three references from the
-                    <methodname>bugs</methodname> table to the <methodname>accounts</methodname> table. Put each reference
-                    in a separate entry in the <methodname>$_referenceMap</methodname> array.
+                    the example database, there is one reference from the <code>bugs</code> table
+                    to the <code>products</code> table, but three references from the
+                    <code>bugs</code> table to the <code>accounts</code> table. Put each reference
+                    in a separate entry in the <varname>$_referenceMap</varname> array.
                 </para>
             </listitem>
 
@@ -174,13 +177,13 @@ class BugsProducts extends Zend_Db_Table_Abstract
                 <para>
                     It's common for this to be a single column, but some tables have multi-column
                     keys. If the reference uses a multi-column key, the order of columns in the
-                    <methodname>'columns'</methodname> entry must match the order of columns in the
-                    <methodname>'refColumns'</methodname> entry.
+                    <code>'columns'</code> entry must match the order of columns in the
+                    <code>'refColumns'</code> entry.
                 </para>
 
                 <para>
                     It is optional to specify this element. If you don't specify the
-                    <methodname>refColumns</methodname>, the column(s) reported as the primary key columns of
+                    <code>refColumns</code>, the column(s) reported as the primary key columns of
                     the parent table are used by default.
                 </para>
             </listitem>
@@ -213,20 +216,20 @@ class BugsProducts extends Zend_Db_Table_Abstract
             from dependent tables that reference the current row. Use the method:
         </para>
 
-         <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $row->findDependentRowset($table, [$rule]);
 ]]></programlisting>
 
         <para>
-            This method returns a <classname>Zend_Db_Table_Rowset_Abstract</classname> object, containing a set of rows
-            from the dependent table <methodname>$table</methodname> that refer to the row identified by the
-            <methodname>$row</methodname> object.
+            This method returns a <classname>Zend_Db_Table_Rowset_Abstract</classname> object,
+            containing a set of rows from the dependent table <varname>$table</varname> that refer
+            to the row identified by the <varname>$row</varname> object.
         </para>
 
         <para>
-            The first argument <methodname>$table</methodname> can be a string that specifies the dependent
-            table by its class name. You can also specify the dependent table by using an object of
-            that table class.
+            The first argument <varname>$table</varname> can be a string that specifies the
+            dependent table by its class name. You can also specify the dependent table by using an
+            object of that table class.
         </para>
 
         <example id="zend.db.table.relationships.fetching.dependent.example">
@@ -234,11 +237,11 @@ $row->findDependentRowset($table, [$rule]);
             <title>Fetching a Dependent Rowset</title>
 
             <para>
-                This example shows getting a Row object from the table <methodname>Accounts</methodname>, and
-                finding the <methodname>Bugs</methodname> reported by that account.
+                This example shows getting a Row object from the table <code>Accounts</code>, and
+                finding the <code>Bugs</code> reported by that account.
             </para>
 
-             <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $accountsTable = new Accounts();
 $accountsRowset = $accountsTable->find(1234);
 $user1234 = $accountsRowset->current();
@@ -249,16 +252,16 @@ $bugsReportedByUser = $user1234->findDependentRowset('Bugs');
         </example>
 
         <para>
-            The second argument <methodname>$rule</methodname> is optional. It is a string that names the rule
-            key in the <methodname>$_referenceMap</methodname> array of the dependent table class. If you don't
-            specify a rule, the first rule in the array that references the parent table is used.
-            If you need to use a rule other than the first, you need to specify the key.
+            The second argument <varname>$rule</varname> is optional. It is a string that names the
+            rule key in the <varname>$_referenceMap</varname> array of the dependent table class. If
+            you don't specify a rule, the first rule in the array that references the parent table
+            is used. If you need to use a rule other than the first, you need to specify the key.
         </para>
 
         <para>
             In the example code above, the rule key is not specified, so the rule used by default
             is the first one that matches the parent table. This is the rule
-            <methodname>'Reporter'</methodname>.
+            <code>'Reporter'</code>.
         </para>
 
         <example id="zend.db.table.relationships.fetching.dependent.example-by">
@@ -266,13 +269,13 @@ $bugsReportedByUser = $user1234->findDependentRowset('Bugs');
             <title>Fetching a Dependent Rowset By a Specific Rule</title>
 
             <para>
-                This example shows getting a Row object from the table <methodname>Accounts</methodname>, and
-                finding the <methodname>Bugs</methodname> assigned to be fixed by the user of that account. The
+                This example shows getting a Row object from the table <code>Accounts</code>, and
+                finding the <code>Bugs</code> assigned to be fixed by the user of that account. The
                 rule key string that corresponds to this reference relationship in this example is
-                <methodname>'Engineer'</methodname>.
+                <code>'Engineer'</code>.
             </para>
 
-             <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $accountsTable = new Accounts();
 $accountsRowset = $accountsTable->find(1234);
 $user1234 = $accountsRowset->current();
@@ -294,12 +297,12 @@ $bugsAssignedToUser = $user1234->findDependentRowset('Bugs', 'Engineer');
                 <title>Fetching a Dependent Rowset using a Zend_Db_Table_Select</title>
 
                 <para>
-                    This example shows getting a Row object from the table <methodname>Accounts</methodname>,
-                    and finding the <methodname>Bugs</methodname> assigned to be fixed by the user of that
+                    This example shows getting a Row object from the table <code>Accounts</code>,
+                    and finding the <code>Bugs</code> assigned to be fixed by the user of that
                     account, limited only to 3 rows and ordered by name.
                 </para>
 
-                 <programlisting language="php"><![CDATA[
+                <programlisting language="php"><![CDATA[
 $accountsTable = new Accounts();
 $accountsRowset = $accountsTable->find(1234);
 $user1234 = $accountsRowset->current();
@@ -314,29 +317,30 @@ $bugsAssignedToUser = $user1234->findDependentRowset('Bugs',
             </example>
 
             Alternatively, you can query rows from a dependent table using a special mechanism
-            called a "magic method". <classname>Zend_Db_Table_Row_Abstract</classname> invokes the method:
-            <methodname>findDependentRowset('&lt;TableClass&gt;', '&lt;Rule&gt;')</methodname> if you invoke a method on
-            the Row object matching either of the following patterns:
+            called a "magic method". <classname>Zend_Db_Table_Row_Abstract</classname> invokes the
+            method: <methodname>findDependentRowset('&lt;TableClass&gt;',
+                '&lt;Rule&gt;')</methodname> if you invoke a method on the Row object matching
+            either of the following patterns:
         </para>
 
         <itemizedlist>
             <listitem>
                 <para>
-                    <methodname>$row->find&lt;TableClass&gt;()</methodname>
+                    <code>$row->find&lt;TableClass&gt;()</code>
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>$row->find&lt;TableClass&gt;By&lt;Rule&gt;()</methodname>
+                    <code>$row->find&lt;TableClass&gt;By&lt;Rule&gt;()</code>
                 </para>
             </listitem>
         </itemizedlist>
 
         <para>
-            In the patterns above, <methodname>&lt;TableClass&gt;</methodname> and <methodname>&lt;Rule&gt;</methodname> are strings
-            that correspond to the class name of the dependent table, and the dependent table's
-            rule key that references the parent table.
+            In the patterns above, <code>&lt;TableClass&gt;</code> and <code>&lt;Rule&gt;</code> are
+            strings that correspond to the class name of the dependent table, and the dependent
+            table's rule key that references the parent table.
         </para>
 
         <note>
@@ -344,9 +348,9 @@ $bugsAssignedToUser = $user1234->findDependentRowset('Bugs',
             <para>
                 Some application frameworks, such as Ruby on Rails, use a mechanism called
                 "inflection" to allow the spelling of identifiers to change depending on usage. For
-                simplicity, <classname>Zend_Db_Table_Row</classname> does not provide any inflection mechanism. The table
-                identity and the rule key named in the method call must match the spelling of the
-                class and rule key exactly.
+                simplicity, <classname>Zend_Db_Table_Row</classname> does not provide any inflection
+                mechanism. The table identity and the rule key named in the method call must match
+                the spelling of the class and rule key exactly.
             </para>
 
         </note>
@@ -361,7 +365,7 @@ $bugsAssignedToUser = $user1234->findDependentRowset('Bugs',
                 specifying the table and rule as strings.
             </para>
 
-             <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $accountsTable = new Accounts();
 $accountsRowset = $accountsTable->find(1234);
 $user1234 = $accountsRowset->current();
@@ -386,7 +390,7 @@ $bugsAssignedTo = $user1234->findBugsByEngineer();
             the row in the parent to which the dependent row refers. Use the method:
         </para>
 
-         <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $row->findParentRow($table, [$rule]);
 ]]></programlisting>
 
@@ -396,9 +400,9 @@ $row->findParentRow($table, [$rule]);
         </para>
 
         <para>
-            The first argument <methodname>$table</methodname> can be a string that specifies the parent table
-            by its class name. You can also specify the parent table by using an object of that
-            table class.
+            The first argument <varname>$table</varname> can be a string that specifies the parent
+            table by its class name. You can also specify the parent table by using an object of
+            that table class.
         </para>
 
         <example id="zend.db.table.relationships.fetching.parent.example">
@@ -406,12 +410,12 @@ $row->findParentRow($table, [$rule]);
             <title>Fetching the Parent Row</title>
 
             <para>
-                This example shows getting a Row object from the table <methodname>Bugs</methodname> (for
+                This example shows getting a Row object from the table <code>Bugs</code> (for
                 example one of those bugs with status 'NEW'), and finding the row in the
-                <methodname>Accounts</methodname> table for the user who reported the bug.
+                <code>Accounts</code> table for the user who reported the bug.
             </para>
 
-             <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $bugsTable = new Bugs();
 $bugsRowset = $bugsTable->fetchAll(array('bug_status = ?' => 'NEW'));
 $bug1 = $bugsRowset->current();
@@ -422,15 +426,15 @@ $reporter = $bug1->findParentRow('Accounts');
         </example>
 
         <para>
-            The second argument <methodname>$rule</methodname> is optional. It is a string that names the rule
-            key in the <methodname>$_referenceMap</methodname> array of the dependent table class. If you don't
-            specify a rule, the first rule in the array that references the parent table is used.
-            If you need to use a rule other than the first, you need to specify the key.
+            The second argument <varname>$rule</varname> is optional. It is a string that names the
+            rule key in the <varname>$_referenceMap</varname> array of the dependent table class. If
+            you don't specify a rule, the first rule in the array that references the parent table
+            is used. If you need to use a rule other than the first, you need to specify the key.
         </para>
 
         <para>
             In the example above, the rule key is not specified, so the rule used by default is the
-            first one that matches the parent table. This is the rule <methodname>'Reporter'</methodname>.
+            first one that matches the parent table. This is the rule <code>'Reporter'</code>.
         </para>
 
         <example id="zend.db.table.relationships.fetching.parent.example-by">
@@ -438,13 +442,13 @@ $reporter = $bug1->findParentRow('Accounts');
             <title>Fetching a Parent Row By a Specific Rule</title>
 
             <para>
-                This example shows getting a Row object from the table <methodname>Bugs</methodname>, and
+                This example shows getting a Row object from the table <code>Bugs</code>, and
                 finding the account for the engineer assigned to fix that bug. The rule key string
                 that corresponds to this reference relationship in this example is
-                <methodname>'Engineer'</methodname>.
+                <code>'Engineer'</code>.
             </para>
 
-             <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $bugsTable = new Bugs();
 $bugsRowset = $bugsTable->fetchAll(array('bug_status = ?', 'NEW'));
 $bug1 = $bugsRowset->current();
@@ -457,27 +461,27 @@ $engineer = $bug1->findParentRow('Accounts', 'Engineer');
         <para>
             Alternatively, you can query rows from a parent table using a "magic method".
             <classname>Zend_Db_Table_Row_Abstract</classname> invokes the method:
-            <methodname>findParentRow('&lt;TableClass&gt;', '&lt;Rule&gt;')</methodname> if you invoke a method
-            on the Row object matching either of the following patterns:
+            <methodname>findParentRow('&lt;TableClass&gt;', '&lt;Rule&gt;')</methodname> if you
+            invoke a method on the Row object matching either of the following patterns:
         </para>
 
         <itemizedlist>
             <listitem>
                 <para>
-                    <methodname>$row->findParent&lt;TableClass&gt;([Zend_Db_Table_Select $select])</methodname>
+                    <code>$row->findParent&lt;TableClass&gt;([Zend_Db_Table_Select $select])</code>
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>$row->findParent&lt;TableClass&gt;By&lt;Rule&gt;([Zend_Db_Table_Select
-                    $select])</methodname>
+                    <code>$row->findParent&lt;TableClass&gt;By&lt;Rule&gt;([Zend_Db_Table_Select
+                    $select])</code>
                 </para>
             </listitem>
         </itemizedlist>
 
         <para>
-            In the patterns above, <methodname>&lt;TableClass&gt;</methodname> and <methodname>&lt;Rule&gt;</methodname>
+            In the patterns above, <code>&lt;TableClass&gt;</code> and <code>&lt;Rule&gt;</code>
             are strings that correspond to the class name of the parent table, and the dependent
             table's rule key that references the parent table.
         </para>
@@ -501,7 +505,7 @@ $engineer = $bug1->findParentRow('Accounts', 'Engineer');
                 specifying the table and rule as strings.
             </para>
 
-             <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $bugsTable = new Bugs();
 $bugsRowset = $bugsTable->fetchAll(array('bug_status = ?', 'NEW'));
 $bug1 = $bugsRowset->current();
@@ -528,7 +532,7 @@ $engineer = $bug1->findParentAccountsByEngineer();
             intersection table. Use the method:
         </para>
 
-         <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $row->findManyToManyRowset($table,
                            $intersectionTable,
                            [$rule1,
@@ -539,22 +543,22 @@ $row->findManyToManyRowset($table,
 ]]></programlisting>
 
         <para>
-            This method returns a <classname>Zend_Db_Table_Rowset_Abstract</classname> containing rows from the table
-            <methodname>$table</methodname>, satisfying the many-to-many relationship. The current Row object
-            <methodname>$row</methodname> from the origin table is used to find rows in the intersection table,
-            and that is joined to the destination table.
+            This method returns a <classname>Zend_Db_Table_Rowset_Abstract</classname> containing
+            rows from the table <varname>$table</varname>, satisfying the many-to-many relationship.
+            The current Row object <varname>$row</varname> from the origin table is used to find
+            rows in the intersection table, and that is joined to the destination table.
         </para>
 
         <para>
-            The first argument <methodname>$table</methodname> can be a string that specifies the destination
-            table in the many-to-many relationship by its class name. You can also specify the
-            destination table by using an object of that table class.
+            The first argument <varname>$table</varname> can be a string that specifies the
+            destination table in the many-to-many relationship by its class name. You can also
+            specify the destination table by using an object of that table class.
         </para>
 
         <para>
-            The second argument <methodname>$intersectionTable</methodname> can be a string that specifies the
-            intersection table between the two tables in the the many-to-many relationship by its
-            class name. You can also specify the intersection table by using an object of that
+            The second argument <varname>$intersectionTable</varname> can be a string that specifies
+            the intersection table between the two tables in the many-to-many relationship by
+            its class name. You can also specify the intersection table by using an object of that
             table class.
         </para>
 
@@ -563,12 +567,12 @@ $row->findManyToManyRowset($table,
             <title>Fetching a Rowset with the Many-to-many Method</title>
 
             <para>
-                This example shows getting a Row object from from the origin table
-                <methodname>Bugs</methodname>, and finding rows from the destination table
-                <methodname>Products</methodname>, representing products related to that bug.
+                This example shows getting a Row object from the origin table
+                <code>Bugs</code>, and finding rows from the destination table
+                <code>Products</code>, representing products related to that bug.
             </para>
 
-             <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $bugsTable = new Bugs();
 $bugsRowset = $bugsTable->find(1234);
 $bug1234 = $bugsRowset->current();
@@ -580,34 +584,34 @@ $productsRowset = $bug1234->findManyToManyRowset('Products',
         </example>
 
         <para>
-            The third and fourth arguments <methodname>$rule1</methodname> and <methodname>$rule2</methodname> are
-            optional. These are strings that name the rule keys in the <methodname>$_referenceMap</methodname>
-            array of the intersection table.
+            The third and fourth arguments <varname>$rule1</varname> and <varname>$rule2</varname>
+            are optional. These are strings that name the rule keys in the
+            <varname>$_referenceMap</varname> array of the intersection table.
         </para>
 
         <para>
-            The <methodname>$rule1</methodname> key names the rule for the relationship from the intersection
-            table to the origin table. In this example, this is the relationship from
-            <methodname>BugsProducts</methodname> to <methodname>Bugs</methodname>.
+            The <varname>$rule1</varname> key names the rule for the relationship from the
+            intersection table to the origin table. In this example, this is the relationship from
+            <code>BugsProducts</code> to <code>Bugs</code>.
         </para>
 
         <para>
-            The <methodname>$rule2</methodname> key names the rule for the relationship from the intersection
-            table to the destination table. In this example, this is the relationship from
-            <methodname>Bugs</methodname> to <methodname>Products</methodname>.
+            The <varname>$rule2</varname> key names the rule for the relationship from the
+            intersection table to the destination table. In this example, this is the relationship
+            from <code>Bugs</code> to <code>Products</code>.
         </para>
 
         <para>
             Similarly to the methods for finding parent and dependent rows, if you don't specify a
-            rule, the method uses the first rule in the <methodname>$_referenceMap</methodname> array that
+            rule, the method uses the first rule in the <varname>$_referenceMap</varname> array that
             matches the tables in the relationship. If you need to use a rule other than the first,
             you need to specify the key.
         </para>
 
         <para>
             In the example code above, the rule key is not specified, so the rules used by default
-            are the first ones that match. In this case, <methodname>$rule1</methodname> is
-            <methodname>'Reporter'</methodname> and <methodname>$rule2</methodname> is <methodname>'Product'</methodname>.
+            are the first ones that match. In this case, <varname>$rule1</varname> is
+            <code>'Reporter'</code> and <varname>$rule2</varname> is <code>'Product'</code>.
         </para>
 
         <example id="zend.db.table.relationships.fetching.many-to-many.example-by">
@@ -615,12 +619,12 @@ $productsRowset = $bug1234->findManyToManyRowset('Products',
             <title>Fetching a Rowset with the Many-to-many Method By a Specific Rule</title>
 
             <para>
-                This example shows geting a Row object from from the origin table
-                <methodname>Bugs</methodname>, and finding rows from the destination table
-                <methodname>Products</methodname>, representing products related to that bug.
+                This example shows geting a Row object from the origin table
+                <code>Bugs</code>, and finding rows from the destination table
+                <code>Products</code>, representing products related to that bug.
             </para>
 
-             <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $bugsTable = new Bugs();
 $bugsRowset = $bugsTable->find(1234);
 $bug1234 = $bugsRowset->current();
@@ -634,40 +638,40 @@ $productsRowset = $bug1234->findManyToManyRowset('Products',
 
         <para>
             Alternatively, you can query rows from the destination table in a many-to-many
-            relationship using a "magic method." <classname>Zend_Db_Table_Row_Abstract</classname> invokes the method:
-            <methodname>findManyToManyRowset('&lt;TableClass&gt;', '&lt;IntersectionTableClass&gt;',
-            '&lt;Rule1&gt;', '&lt;Rule2&gt;')</methodname> if you invoke a method matching any of the
-            following patterns:
+            relationship using a "magic method." <classname>Zend_Db_Table_Row_Abstract</classname>
+            invokes the method: <code>findManyToManyRowset('&lt;TableClass&gt;',
+            '&lt;IntersectionTableClass&gt;', '&lt;Rule1&gt;', '&lt;Rule2&gt;')</code> if you invoke
+            a method matching any of the following patterns:
         </para>
 
         <itemizedlist>
             <listitem>
                 <para>
-                    <methodname>$row->find&lt;TableClass&gt;Via&lt;IntersectionTableClass&gt;
-                    ([Zend_Db_Table_Select $select])</methodname>
+                    <code>$row->find&lt;TableClass&gt;Via&lt;IntersectionTableClass&gt;
+                    ([Zend_Db_Table_Select $select])</code>
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>$row->find&lt;TableClass&gt;Via&lt;IntersectionTableClass&gt;By&lt;Rule1&gt;
-                    ([Zend_Db_Table_Select $select])</methodname>
+                    <code>$row->find&lt;TableClass&gt;Via&lt;IntersectionTableClass&gt;By&lt;Rule1&gt;
+                        ([Zend_Db_Table_Select $select])</code>
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <methodname>$row->find&lt;TableClass&gt;Via&lt;IntersectionTableClass&gt;By&lt;Rule1&gt;And&lt;Rule2&gt;
-                    ([Zend_Db_Table_Select $select])</methodname>
+                    <code>$row->find&lt;TableClass&gt;Via&lt;IntersectionTableClass&gt;By&lt;Rule1&gt;And&lt;Rule2&gt;
+                        ([Zend_Db_Table_Select $select])</code>
                 </para>
             </listitem>
         </itemizedlist>
 
         <para>
-            In the patterns above, <methodname>&lt;TableClass&gt;</methodname> and
-            <methodname>&lt;IntersectionTableClass&gt;</methodname> are strings that correspond to the class
+            In the patterns above, <code>&lt;TableClass&gt;</code> and
+            <code>&lt;IntersectionTableClass&gt;</code> are strings that correspond to the class
             names of the destination table and the intersection table, respectively.
-            <methodname>&lt;Rule1&gt;</methodname> and <methodname>&lt;Rule2&gt;</methodname> are strings that correspond
+            <code>&lt;Rule1&gt;</code> and <code>&lt;Rule2&gt;</code> are strings that correspond
             to the rule keys in the intersection table that reference the origin table and the
             destination table, respectively.
         </para>
@@ -690,7 +694,7 @@ $productsRowset = $bug1234->findManyToManyRowset('Products',
                 relationship representing products related to a given bug.
             </para>
 
-             <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $bugsTable = new Bugs();
 $bugsRowset = $bugsTable->find(1234);
 $bug1234 = $bugsRowset->current();
@@ -716,7 +720,7 @@ $products = $bug1234->findProductsViaBugsProductsByBug();
 
             <para>
                 Declaring cascading operations in <classname>Zend_Db_Table</classname> is intended
-                <emphasis>only</emphasis> for  <acronym>RDBMS</acronym> brands that do not support
+                <emphasis>only</emphasis> for <acronym>RDBMS</acronym> brands that do not support
                 declarative referential integrity (DRI).
             </para>
 
@@ -727,23 +731,25 @@ $products = $bug1234->findProductsViaBugsProductsByBug();
             </para>
 
             <para>
-                If your <acronym>RDBMS</acronym> implements DRI and the <methodname>ON DELETE</methodname> and
-                <methodname>ON UPDATE</methodname> clauses, you should declare these clauses in your database
-                schema, instead of using the cascading feature in <classname>Zend_Db_Table</classname>. Declaring
-                cascading DRI rules in the  <acronym>RDBMS</acronym> is better for database performance, consistency,
-                and integrity.
+                If your <acronym>RDBMS</acronym> implements DRI and the <code>ON DELETE</code> and
+                <code>ON UPDATE</code> clauses, you should declare these clauses in your database
+                schema, instead of using the cascading feature in
+                <classname>Zend_Db_Table</classname>. Declaring cascading DRI rules in the
+                <acronym>RDBMS</acronym> is better for database performance, consistency, and
+                integrity.
             </para>
 
             <para>
-                Most importantly, do not declare cascading operations both in the  <acronym>RDBMS</acronym> and in your
-                <classname>Zend_Db_Table</classname> class.
+                Most importantly, do not declare cascading operations both in the
+                <acronym>RDBMS</acronym> and in your <classname>Zend_Db_Table</classname> class.
             </para>
 
         </note>
 
         <para>
             You can declare cascading operations to execute against a dependent table when you
-            apply an <methodname>UPDATE</methodname> or a <methodname>DELETE</methodname> to a row in a parent table.
+            apply an <constant>UPDATE</constant> or a <constant>DELETE</constant> to a row in a
+            parent table.
         </para>
 
         <example id="zend.db.table.relationships.cascading.example-delete">
@@ -751,11 +757,11 @@ $products = $bug1234->findProductsViaBugsProductsByBug();
             <title>Example of a Cascading Delete</title>
 
             <para>
-                This example shows deleting a row in the <methodname>Products</methodname> table, which is
-                configured to automatically delete dependent rows in the <methodname>Bugs</methodname> table.
+                This example shows deleting a row in the <code>Products</code> table, which is
+                configured to automatically delete dependent rows in the <code>Bugs</code> table.
             </para>
 
-             <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $productsTable = new Products();
 $productsRowset = $productsTable->find(1234);
 $product1234 = $productsRowset->current();
@@ -768,9 +774,10 @@ $product1234->delete();
         </example>
 
         <para>
-            Similarly, if you use <methodname>UPDATE</methodname> to change the value of a primary key in a
-            parent table, you may want the value in foreign keys of dependent tables to be updated
-            automatically to match the new value, so that such references are kept up to date.
+            Similarly, if you use <constant>UPDATE</constant> to change the value of a primary key
+            in a parent table, you may want the value in foreign keys of dependent tables to be
+            updated automatically to match the new value, so that such references are kept up to
+            date.
         </para>
 
         <para>
@@ -781,12 +788,12 @@ $product1234->delete();
         </para>
 
         <para>
-            To declare a cascading relationship in the <classname>Zend_Db_Table</classname>, edit the rules in the
-            <methodname>$_referenceMap</methodname>. Set the associative array keys <methodname>'onDelete'</methodname> and
-            <methodname>'onUpdate'</methodname> to the string 'cascade' (or the constant
-            <methodname>self::CASCADE</methodname>). Before a row is deleted from the parent table, or its
-            primary key values updated, any rows in the dependent table that refer to the parent's
-            row are deleted or updated first.
+            To declare a cascading relationship in the <classname>Zend_Db_Table</classname>, edit
+            the rules in the <varname>$_referenceMap</varname>. Set the associative array keys
+            <code>'onDelete'</code> and <code>'onUpdate'</code> to the string 'cascade' (or the
+            constant <constant>self::CASCADE</constant>). Before a row is deleted from the parent
+            table, or its primary key values updated, any rows in the dependent table that refer to
+            the parent's row are deleted or updated first.
         </para>
 
         <example id="zend.db.table.relationships.cascading.example-declaration">
@@ -794,20 +801,20 @@ $product1234->delete();
             <title>Example Declaration of Cascading Operations</title>
 
             <para>
-                In the example below, rows in the <methodname>Bugs</methodname> table are automatically deleted
-                if the row in the <methodname>Products</methodname> table to which they refer is deleted. The
-                <methodname>'onDelete'</methodname> element of the reference map entry is set to
-                <methodname>self::CASCADE</methodname>.
+                In the example below, rows in the <code>Bugs</code> table are automatically deleted
+                if the row in the <code>Products</code> table to which they refer is deleted. The
+                <code>'onDelete'</code> element of the reference map entry is set to
+                <constant>self::CASCADE</constant>.
             </para>
 
             <para>
                 No cascading update is done in the example below if the primary key value in the
-                parent class is changed. The <methodname>'onUpdate'</methodname> element of the reference map
-                entry is <methodname>self::RESTRICT</methodname>. You can get the same result by omitting
-                the <methodname>'onUpdate'</methodname> entry.
+                parent class is changed. The <code>'onUpdate'</code> element of the reference map
+                entry is <constant>self::RESTRICT</constant>. You can get the same result by
+                omitting the <code>'onUpdate'</code> entry.
             </para>
 
-             <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 class BugsProducts extends Zend_Db_Table_Abstract
 {
     ...
@@ -831,65 +838,67 @@ class BugsProducts extends Zend_Db_Table_Abstract
             <title>Notes Regarding Cascading Operations</title>
 
             <para>
-                <emphasis>Cascading operations invoked by <classname>Zend_Db_Table</classname> are not
-                atomic.</emphasis>
+                <emphasis>Cascading operations invoked by <classname>Zend_Db_Table</classname> are
+                not atomic.</emphasis>
             </para>
 
             <para>
                 This means that if your database implements and enforces referential integrity
-                constraints, a cascading <methodname>UPDATE</methodname> executed by a <classname>Zend_Db_Table</classname> class
-                conflicts with the constraint, and results in a referential integrity violation.
-                You can use cascading <methodname>UPDATE</methodname> in <classname>Zend_Db_Table</classname>
+                constraints, a cascading <constant>UPDATE</constant> executed by a
+                <classname>Zend_Db_Table</classname> class conflicts with the constraint, and
+                results in a referential integrity violation. You can use cascading
+                <constant>UPDATE</constant> in <classname>Zend_Db_Table</classname>
                 <emphasis>only</emphasis> if your database does not enforce that referential
                 integrity constraint.
             </para>
 
             <para>
-                Cascading <methodname>DELETE</methodname> suffers less from the problem of referential
+                Cascading <constant>DELETE</constant> suffers less from the problem of referential
                 integrity violations. You can delete dependent rows as a non-atomic action before
                 deleting the parent row that they reference.
             </para>
 
             <para>
-                However, for both <methodname>UPDATE</methodname> and <methodname>DELETE</methodname>, changing the
-                database in a non-atomic way also creates the risk that another database user can
-                see the data in an inconsistent state. For example, if you delete a row and all its
-                dependent rows, there is a small chance that another database client program can
-                query the database after you have deleted the dependent rows, but before you delete
-                the parent row. That client program may see the parent row with no dependent rows,
-                and assume this is the intended state of the data. There is no way for that client
-                to know that its query read the database in the middle of a change.
+                However, for both <constant>UPDATE</constant> and <constant>DELETE</constant>,
+                changing the database in a non-atomic way also creates the risk that another
+                database user can see the data in an inconsistent state. For example, if you delete
+                a row and all its dependent rows, there is a small chance that another database
+                client program can query the database after you have deleted the dependent rows, but
+                before you delete the parent row. That client program may see the parent row with no
+                dependent rows, and assume this is the intended state of the data. There is no way
+                for that client to know that its query read the database in the middle of a change.
             </para>
 
             <para>
                 The issue of non-atomic change can be mitigated by using transactions to isolate
-                your change. But some RDBMS brands don't support transactions, or allow clients to
-                read "dirty" changes that have not been committed yet.
+                your change. But some <acronym>RDBMS</acronym> brands don't support transactions, or
+                allow clients to read "dirty" changes that have not been committed yet.
             </para>
 
             <para>
-                <emphasis>Cascading operations in <classname>Zend_Db_Table</classname> are invoked only by
-                <classname>Zend_Db_Table</classname>.</emphasis>
+                <emphasis>Cascading operations in <classname>Zend_Db_Table</classname> are invoked
+                only by <classname>Zend_Db_Table</classname>.</emphasis>
             </para>
 
             <para>
-                Cascading deletes and updates defined in your <classname>Zend_Db_Table</classname> classes are applied if
-                you execute the <methodname>save()</methodname> or <methodname>delete()</methodname> methods on the Row
-                class. However, if you update or delete data using another interface, such as a
-                query tool or another application, the cascading operations are not applied. Even
-                when using <methodname>update()</methodname> and <methodname>delete()</methodname> methods in the
-                <classname>Zend_Db_Adapter</classname> class, cascading operations defined in your <classname>Zend_Db_Table</classname> classes
-                are not executed.
+                Cascading deletes and updates defined in your <classname>Zend_Db_Table</classname>
+                classes are applied if you execute the <methodname>save()</methodname> or
+                <methodname>delete()</methodname> methods on the Row class. However, if you update
+                or delete data using another interface, such as a query tool or another application,
+                the cascading operations are not applied. Even when using
+                <methodname>update()</methodname> and <methodname>delete()</methodname> methods
+                in the <classname>Zend_Db_Adapter</classname> class, cascading operations defined in
+                your <classname>Zend_Db_Table</classname> classes are not executed.
             </para>
 
             <para>
-                <emphasis>No Cascading <methodname>INSERT</methodname>.</emphasis>
+                <emphasis>No Cascading <constant>INSERT</constant>.</emphasis>
             </para>
 
             <para>
-                There is no support for a cascading <methodname>INSERT</methodname>. You must insert a row to a
-                parent table in one operation, and insert row(s) to a dependent table in a separate
-                operation.
+                There is no support for a cascading <constant>INSERT</constant>. You must insert a
+                row to a parent table in one operation, and insert row(s) to a dependent table in a
+                separate operation.
             </para>
 
         </sect3>

+ 2 - 2
documentation/manual/es/module_specs/Zend_Db_Table_Row.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15103 -->
+<!-- EN-Revision: 19484 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.db.table.row">
 
@@ -7,7 +7,7 @@
 
     <sect2 id="zend.db.table.row.introduction">
 
-        <title>Introduction</title>
+        <title>Introducción</title>
 
         <para>
             <classname>Zend_Db_Table_Row</classname> is a class that contains an individual row of a <classname>Zend_Db_Table</classname> object.

+ 1 - 1
documentation/manual/es/module_specs/Zend_Db_Table_Rowset.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15103 -->
+<!-- EN-Revision: 18822 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.db.table.rowset">
 

+ 17 - 10
documentation/manual/es/module_specs/Zend_Debug.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15103 -->
+<!-- EN-Revision: 18834 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.debug.dumping">
 
@@ -21,15 +21,22 @@ Zend_Debug::dump($var, $label=null, $echo=true);
     </example>
 
     <para>
-        El argumento <methodname>$var</methodname> especifica la expresión o variable sobre
+        El argumento <varname>$var</varname> especifica la expresión o variable sobre
         la cual el método <classname>Zend_Debug::dump()</classname> generará información.
     </para>
 
+	     <para>
+        The <varname>$label</varname> argument is a string to be prepended to the
+        output of <methodname>Zend_Debug::dump()</methodname>. It may be useful, for
+         example, to use labels if you are dumping information about multiple
+         variables on a given screen.
+     </para>
+	
     <para>
-        El argumento boleano <methodname>$echo</methodname> especifica si la salida de
+        El argumento boleano <varname>$echo</varname> especifica si la salida de
         <classname>Zend_Debug::dump()</classname> es o no mostrada. Si es
-        <methodname>verdadera</methodname>, la salida es mostrada. A pesar del valor del
-        argumento <methodname>$echo</methodname>, el retorno de este método contiene la
+        <constant>TRUE</constant>, la salida es mostrada. A pesar del valor del
+        argumento <varname>$echo</varname>, el retorno de este método contiene la
         salida.
     </para>
 
@@ -40,7 +47,7 @@ Zend_Debug::dump($var, $label=null, $echo=true);
         Si el flujo de salida es detectado como una presentación de la web, la
         salida de <methodname>var_dump()</methodname> es escapada usando
         <ulink url="http://php.net/htmlspecialchars"><methodname>htmlspecialchars()</methodname></ulink>
-        y envuelta con el tag (X)HTML <methodname>pre</methodname>.
+        y envuelta con el tag (X)HTML <command>&lt;pre&gt;</command>.
     </para>
 
     <tip>
@@ -52,10 +59,10 @@ Zend_Debug::dump($var, $label=null, $echo=true);
         </para>
         <para>
             También considere el componente <link linkend="zend.log.overview">
-            Zend_Log</link> escribiendo el código de depuración más
-            permanente. Por ejemplo, puede utilizar el nivel de log de
-            <methodname>DEPURACIÓN</methodname> y el Stream log writer, para mostrar la
-            cadena de salida de <classname>Zend_Debug::dump()</classname>.
+            Zend_Log</link>  component when writing more permanent debugging code. For example,
+            you can use the <constant>DEBUG</constant> log level and the
+            <link linkend="zend.log.writers.stream">stream log writer</link> to
+            output the string returned by <methodname>Zend_Debug::dump()</methodname>.
         </para>
     </tip>
 

+ 22 - 22
documentation/manual/es/module_specs/Zend_Validate-Set.xml

@@ -23,9 +23,9 @@
 
         <note>
             <para>
-                Los caracteres alfabéticos significan caracteres que componen palabras en cada idioma.
-                 Sin embargo, el alfabeto inglés es tratado como caracteres alfabéticos
-                 en los siguientes idiomas: chino, japonés, coreano.
+            	Los caracteres alfabéticos significan caracteres que componen palabras en cada idioma.
+            	 Sin embargo, el alfabeto inglés es tratado como caracteres alfabéticos 
+            	 en los siguientes idiomas: chino, japonés, coreano. 
                  El lenguaje es especificado por Zend_Locale.
             </para>
         </note>
@@ -34,7 +34,7 @@
     <sect2 id="zend.validate.set.alpha">
         <title>Alpha</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> sólo
+            Devuelve constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> sólo
             contiene caracteres alfabéticos.
             Este validador incluye una opción para considerar también al espacio
             en blanco como caracter válido.
@@ -59,7 +59,7 @@
     <sect2 id="zend.validate.set.between">
         <title>Between</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> está entre
+            Devuelve constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> está entre
             los valores límites mínimo y máximo.
             La comparación es inclusiva por defecto (<methodname>$valor</methodname> puede ser
             igual a una valor límite), aunque esto puede ser anulado a fin de
@@ -71,7 +71,7 @@
     <sect2 id="zend.validate.set.ccnum">
         <title>Ccnum</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> sigue el
+            Devuelve constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> sigue el
             algoritmo Luhn (mod-10 checksum) para tarjetas de crédito.
         </para>
     </sect2>
@@ -79,7 +79,7 @@
     <sect2 id="zend.validate.set.date">
         <title>Date</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> es una
+            Devuelve constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> es una
             fecha válida en el formato <methodname>YYYY-MM-DD</methodname> (AAAA-MM-DD).
             Si se usa la opción <methodname>locale</methodname> entonces la fecha
             será validada de acuerdo a lo establecido para ese locale.
@@ -95,7 +95,7 @@
     <sect2 id="zend.validate.set.digits">
         <title>Digits</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> contiene
+            Devuelve constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> contiene
             solamente dígitos.
         </para>
     </sect2>
@@ -106,9 +106,9 @@
     <sect2 id="zend.validate.set.float">
         <title>Float</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si <methodname>$value</methodname> es un valor de punto flotante.
-            Desde Zend Framework 1.8 toma en cuenta la localizacion actual del navegador, las variables o el uso.
-            Puede usar get/setLocale para cambiar la configuracion regional o crear una instancia para este validador
+            Devuelve constant>TRUE</constant> si y sólo si <methodname>$value</methodname> es un valor de punto flotante.
+            Desde Zend Framework 1.8 toma en cuenta la localizacion actual del navegador, las variables o el uso. 
+            Puede usar get/setLocale para cambiar la configuracion regional o crear una instancia para este validador             
         </para>
     </sect2>
 
@@ -116,7 +116,7 @@
     <sect2 id="zend.validate.set.greater_than">
         <title>GreaterThan</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> es mayor
+            Devuelve constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> es mayor
             al límite mínimo.
         </para>
     </sect2>
@@ -124,7 +124,7 @@
     <sect2 id="zend.validate.set.hex">
         <title>Hex</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> contiene
+            Devuelve constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> contiene
             caracteres hexadecimales (0-9 y A-F).
         </para>
     </sect2>
@@ -135,7 +135,7 @@
     <sect2 id="zend.validate.set.iban">
         <title>Iban</title>
         <para>
-            Returns <constant>TRUE</constant> if and only if <methodname>$value</methodname> contains a valid IBAN
+            Returns constant>TRUE</constant> if and only if <methodname>$value</methodname> contains a valid IBAN
             (International Bank Account Number). IBAN numbers are validated against the country where they are
             used and by a checksum.
         </para>
@@ -181,7 +181,7 @@ if ($validator->isValid($iban)) {
     <sect2 id="zend.validate.set.in_array">
         <title>InArray</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> se encuentra
+            Devuelve constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> se encuentra
             en un array, y si la opción es estricta entonces también verificará
             el tipo de dato de <methodname>$valor</methodname>.
         </para>
@@ -191,24 +191,24 @@ if ($validator->isValid($iban)) {
     <sect2 id="zend.validate.set.int">
         <title>Int</title>
         <para>
-            Returns <constant>TRUE</constant> if and only if <methodname>$value</methodname> is a valid integer.
+            Returns constant>TRUE</constant> if and only if <methodname>$value</methodname> is a valid integer.
             Since Zend Framework 1.8 this validator takes into account the actual locale from browser,
             environment or application wide set locale. You can of course use the get/setLocale accessors
             to change the used locale or give it while creating a instance of this validator.
         </para>
     </sect2>
-
+    
        <sect2 id="zend.validate.set.ip">
         <title>Ip</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> es una dirección IP válida.
+            Devuelve constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> es una dirección IP válida.
         </para>
     </sect2>
 
     <sect2 id="zend.validate.set.less_than">
         <title>LessThan</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> es menor
+            Devuelve constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> es menor
             al límite máximo.
         </para>
     </sect2>
@@ -216,14 +216,14 @@ if ($validator->isValid($iban)) {
     <sect2 id="zend.validate.set.not_empty">
         <title>NotEmpty</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> no es vacío.
+            Devuelve constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> no es vacío.
         </para>
     </sect2>
 
     <sect2 id="zend.validate.set.regex">
         <title>Regex</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> coincide
+            Devuelve constant>TRUE</constant> si y sólo si <methodname>$valor</methodname> coincide
             con el patrón de una expresión regular.
         </para>
     </sect2>
@@ -235,7 +235,7 @@ if ($validator->isValid($iban)) {
     <sect2 id="zend.validate.set.string_length">
         <title>StringLength</title>
         <para>
-            Devuelve <constant>TRUE</constant> si y sólo si la longitud del string <methodname>$valor</methodname>
+            Devuelve constant>TRUE</constant> si y sólo si la longitud del string <methodname>$valor</methodname>
             es por lo menos un mínimo y no mayor a un máximo
             (cuando la opción max no es <constant>NULL</constant>).
             Desde la versión 1.5.0, el método <methodname>setMin()</methodname> lanza una