Browse Source

Update DOC-ES

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@20179 44c647ce-9c0f-0410-b52a-842ac1e357ba
benjamin-gonzales 16 years ago
parent
commit
330d515f06

File diff suppressed because it is too large
+ 255 - 543
documentation/manual/es/module_specs/Zend_Db_Adapter.xml


+ 119 - 276
documentation/manual/es/module_specs/Zend_Db_Profiler.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 19484 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.db.profiler" xmlns:xi="http://www.w3.org/2001/XInclude">
 <sect1 id="zend.db.profiler" xmlns:xi="http://www.w3.org/2001/XInclude">
 
 
@@ -10,23 +10,16 @@
         <title>Introducción</title>
         <title>Introducción</title>
 
 
         <para>
         <para>
-            <classname>Zend_Db_Profiler</classname>
-            puede ser habilitado para
-            Perfilar las consultas. Los Perfiles incluyen la consulta
-            procesada
+            <classname>Zend_Db_Profiler</classname> puede ser habilitado para
+            Perfilar las consultas. Los Perfiles incluyen la consulta procesada
             por el adaptador como el tiempo as transcurrido en la ejecución de
             por el adaptador como el tiempo as transcurrido en la ejecución de
-            las
-            consultas, permitiendo inspeccionar las consultas realizadas win
-            necesidad de agregar
-            información de depuración extra en el código de
-            las clases. El uso avanzado también
-            permite que el desarrollador
-            filtre las consultas que desea perfilar.
-        </para>
-
-        <para>Habilite el perfilador pasando una directiva al al constructor
-            del adaptador, o
-            pidiendole al adaptador permitirlo más adelante.</para>
+            las consultas, permitiendo inspeccionar las consultas realizadas win
+            necesidad de agregar información de depuración extra en el código de
+            las clases. El uso avanzado también permite que el desarrollador
+            filtre las consultas que desea perfilar. </para>
+
+        <para>Habilite el perfilador pasando una directiva al al constructor del
+            adaptador, o pidiendole al adaptador permitirlo más adelante.</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $params = array(
 $params = array(
@@ -47,43 +40,26 @@ $db->getProfiler()->setEnabled(false);
 $db->getProfiler()->setEnabled(true);
 $db->getProfiler()->setEnabled(true);
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            El valor de la opción '
-            <property>profiler</property>
-            ' es
+        <para> El valor de la opción ' <property>profiler</property> ' es
             flexible. Es interpretada de distintas formas dependiendo del tipo.
             flexible. Es interpretada de distintas formas dependiendo del tipo.
-            Normalmente,
-            debería usar un valor booleano simple, pero otros tipos
-            le permiten personalizar el
-            comportamiento del perfilador.
-        </para>
+            Normalmente, debería usar un valor booleano simple, pero otros tipos
+            le permiten personalizar el comportamiento del perfilador. </para>
 
 
-        <para>
-            Un argumento booleano establece el perfilador como habilitado si
-            el valor es
-            <constant>TRUE</constant>
-            , o deshabilitado si es
-            <constant>FALSE</constant>
-            . La clase del perfilador es el la
+        <para> Un argumento booleano establece el perfilador como habilitado si
+            el valor es <constant>TRUE</constant> , o deshabilitado si es
+                <constant>FALSE</constant> . La clase del perfilador es el la
             clase de perfilador por defecto del adaptador,
             clase de perfilador por defecto del adaptador,
-            <classname>Zend_Db_Profiler</classname>
-            .
-
-        </para>
+                <classname>Zend_Db_Profiler</classname> . </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $params['profiler'] = true;
 $params['profiler'] = true;
 $db = Zend_Db::factory('PDO_MYSQL', $params);
 $db = Zend_Db::factory('PDO_MYSQL', $params);
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Una instancia del objeto perfilador hace que el adaptador use ese
-            objeto. El tipo del
-            objeto debe ser
-            <classname>Zend_Db_Profiler</classname>
-            o una subclase de este.
-            Habilitar el perfilador se hace por separado.
-        </para>
+        <para> Una instancia del objeto perfilador hace que el adaptador use ese
+            objeto. El tipo del objeto debe ser
+                <classname>Zend_Db_Profiler</classname> o una subclase de este.
+            Habilitar el perfilador se hace por separado. </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $profiler = MyProject_Db_Profiler();
 $profiler = MyProject_Db_Profiler();
@@ -92,38 +68,18 @@ $params['profiler'] = $profiler;
 $db = Zend_Db::factory('PDO_MYSQL', $params);
 $db = Zend_Db::factory('PDO_MYSQL', $params);
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            El argumento puede ser un array asociativo conteniendo algunas o
-            todas las claves '
-            <property>enabled</property>
-            ',
-            '
-            <property>instance</property>
-            ', y
-            '
-            <property>class</property>
-            '. Las claves
-            '
-            <property>enabled</property>
-            ' e
-            '
-            <property>instance</property>
-            ' corresponden a los tipos
-            booleano y la instancia documentada previamente. La clave
-            '
-            <property>class</property>
-            ' es usada para nombrar la clase
-            que usará el perfilador personalizado. La clase debe ser
-            <classname>Zend_Db_Profiler</classname>
-            o una subclase. La clase
-            es instanciada sin argumentos de constructor. La opción
-            '
-            <property>class</property>
-            ' es ignorada cuando la opción
-            '
-            <property>instance</property>
-            ' está dada.
-        </para>
+        <para> El argumento puede ser un array asociativo conteniendo algunas o
+            todas las claves ' <property>enabled</property> ', '
+                <property>instance</property> ', y ' <property>class</property>
+            '. Las claves ' <property>enabled</property> ' e '
+                <property>instance</property> ' corresponden a los tipos
+            booleano y la instancia documentada previamente. La clave '
+                <property>class</property> ' es usada para nombrar la clase que
+            usará el perfilador personalizado. La clase debe ser
+                <classname>Zend_Db_Profiler</classname> o una subclase. La clase
+            es instanciada sin argumentos de constructor. La opción '
+                <property>class</property> ' es ignorada cuando la opción '
+                <property>instance</property> ' está dada. </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $params['profiler'] = array(
 $params['profiler'] = array(
@@ -133,18 +89,11 @@ $params['profiler'] = array(
 $db = Zend_Db::factory('PDO_MYSQL', $params);
 $db = Zend_Db::factory('PDO_MYSQL', $params);
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Finalmente, el argumento puede ser un objeto de tipo
-            <classname>Zend_Config</classname>
-            conteniendo las
-            propiedades, que son tratadas como las claves de array descritas
-            recién.
-            Por ejemplo, un archivo "
-            <filename>config.ini</filename>
-            " puede contener los
-            siguientes datos:
-
-        </para>
+        <para> Finalmente, el argumento puede ser un objeto de tipo
+                <classname>Zend_Config</classname> conteniendo las propiedades,
+            que son tratadas como las claves de array descritas recién. Por
+            ejemplo, un archivo " <filename>config.ini</filename> " puede
+            contener los siguientes datos: </para>
 
 
         <programlisting language="ini"><![CDATA[
         <programlisting language="ini"><![CDATA[
 [main]
 [main]
@@ -152,23 +101,15 @@ db.profiler.class   = "MyProject_Db_Profiler"
 db.profiler.enabled = true
 db.profiler.enabled = true
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Esta configuración puede ser aplicada con el siguiente
-            código
-            <acronym>PHP</acronym>
-            :
-        </para>
+        <para> Esta configuración puede ser aplicada con el siguiente código
+                <acronym>PHP</acronym> : </para>
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $config = new Zend_Config_Ini('config.ini', 'main');
 $config = new Zend_Config_Ini('config.ini', 'main');
 $params['profiler'] = $config->db->profiler;
 $params['profiler'] = $config->db->profiler;
 $db = Zend_Db::factory('PDO_MYSQL', $params);
 $db = Zend_Db::factory('PDO_MYSQL', $params);
 ]]></programlisting>
 ]]></programlisting>
-        <para>
-            La propiedad '
-            <methodname>instance</methodname>
-            ' debe ser
-            usada como el siguiente ejemplo:
-        </para>
+        <para> La propiedad ' <methodname>instance</methodname> ' debe ser usada
+            como el siguiente ejemplo: </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $profiler = new MyProject_Db_Profiler();
 $profiler = new MyProject_Db_Profiler();
@@ -187,131 +128,87 @@ $db = Zend_Db::factory('PDO_MYSQL', $params);
 
 
         <title>Usando el Perfilador</title>
         <title>Usando el Perfilador</title>
 
 
-        <para>
-            En este punto, obtenemos el perfilador usando el método
-            <methodname>getProfiler()</methodname>
-            del adaptador:
-        </para>
+        <para> En este punto, obtenemos el perfilador usando el método
+                <methodname>getProfiler()</methodname> del adaptador: </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $profiler = $db->getProfiler();
 $profiler = $db->getProfiler();
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Este retorna una instancia del objeto
-            <classname>Zend_Db_Profiler</classname>
-            . Con esta instancia, el
-            desarrollador puede examinar las consultar usando una variedad
-            de
-            métodos:
-        </para>
+        <para> Este retorna una instancia del objeto
+                <classname>Zend_Db_Profiler</classname> . Con esta instancia, el
+            desarrollador puede examinar las consultar usando una variedad de
+            métodos: </para>
 
 
         <itemizedlist>
         <itemizedlist>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getTotalNumQueries()</methodname>
-                    retorna el
-                    número total de consultas que han sido perfiladas.
-                </para>
+                    <methodname>getTotalNumQueries()</methodname> retorna el
+                    número total de consultas que han sido perfiladas. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getTotalElapsedSecs()</methodname>
-                    retorna el
+                    <methodname>getTotalElapsedSecs()</methodname> retorna el
                     número total de segundos transcurridos en todas las
                     número total de segundos transcurridos en todas las
-                    consultas
-                    perfiladas.
-                </para>
+                    consultas perfiladas. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getQueryProfiles()</methodname>
-                    retorna un array
-                    con todos los perfiles de consultas.
-                </para>
+                    <methodname>getQueryProfiles()</methodname> retorna un array
+                    con todos los perfiles de consultas. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getLastQueryProfile()</methodname>
-                    retorna el
+                    <methodname>getLastQueryProfile()</methodname> retorna el
                     último perfil (más reciente) de consulta, independientemente
                     último perfil (más reciente) de consulta, independientemente
-                    de si la
-                    consulta ha terminado o no (si no lo ha hecho, la
-                    hora de finalización será
-                    nula).
-                </para>
+                    de si la consulta ha terminado o no (si no lo ha hecho, la
+                    hora de finalización será <constant>NULL</constant>). </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>clear()</methodname>
-                    limpia los perfiles de
-                    consulta de la pila.
-                </para>
+                    <methodname>clear()</methodname> limpia los perfiles de
+                    consulta de la pila. </para>
             </listitem>
             </listitem>
         </itemizedlist>
         </itemizedlist>
 
 
-        <para>
-            El valor de retorno de
-            <methodname>getLastQueryProfile()</methodname>
-            y elementos
-            individuales de
-            <methodname>getQueryProfiles()</methodname>
-            son
-            <classname>Zend_Db_Profiler_Query</classname>
-            objetos, que
+        <para> El valor de retorno de
+                <methodname>getLastQueryProfile()</methodname> y elementos
+            individuales de <methodname>getQueryProfiles()</methodname> son
+                <classname>Zend_Db_Profiler_Query</classname> objetos, que
             proporcionan la capacidad para inspeccionar cada una de las
             proporcionan la capacidad para inspeccionar cada una de las
-            consultas:
-        </para>
+            consultas: </para>
 
 
         <itemizedlist>
         <itemizedlist>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getQuery()</methodname>
-                    retorna el texto SQL de
-                    la consulta. El texto
-                    <acronym>SQL</acronym>
-                    de una declaración preparada con
-                    parámetros es el texto al tiempo en que la
-                    consulta fué
-                    preparada, por lo que contiene marcadores de posición, no
-                    los valores
-                    utilizados cuando la declaración se ejecuta.
-                </para>
+                    <methodname>getQuery()</methodname> retorna el texto SQL de
+                    la consulta. El texto <acronym>SQL</acronym> de una
+                    declaración preparada con parámetros es el texto al tiempo
+                    en que la consulta fué preparada, por lo que contiene
+                    marcadores de posición, no los valores utilizados cuando la
+                    declaración se ejecuta. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getQueryParams()</methodname>
-                    retorna un array
+                    <methodname>getQueryParams()</methodname> retorna un array
                     de los valores de los parámetros usados cuando se ejecuta
                     de los valores de los parámetros usados cuando se ejecuta
-                    una
-                    consulta preparada. Este incluye ambos parámetros y
-                    argumentos vinculados al
-                    método
-                    <methodname>execute()</methodname>
-                    de la declaración.
+                    una consulta preparada. Este incluye ambos parámetros y
+                    argumentos vinculados al método
+                        <methodname>execute()</methodname> de la declaración.
                     Las claves del array son las posiciones (basado en 1) o
                     Las claves del array son las posiciones (basado en 1) o
-                    indices de parámetros nombrados (string).
-                </para>
+                    indices de parámetros nombrados (string). </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getElapsedSecs()</methodname>
-                    returna el número
-                    de segundos que tuvo la consulta al correr.
-                </para>
+                    <methodname>getElapsedSecs()</methodname> returna el número
+                    de segundos que tuvo la consulta al correr. </para>
             </listitem>
             </listitem>
         </itemizedlist>
         </itemizedlist>
 
 
-        <para>
-            La información que
-            <classname>Zend_Db_Profiler</classname>
-            provee
+        <para> La información que <classname>Zend_Db_Profiler</classname> provee
             es útil para perfilar cuellos de botella en aplicaciones, y para
             es útil para perfilar cuellos de botella en aplicaciones, y para
-            depurar consultas
-            que han sido ejecutadas. Por instancia, para ver
-            la consulta exacta que tuvo la última
-            ejecución:
-        </para>
+            depurar consultas que han sido ejecutadas. Por instancia, para ver
+            la consulta exacta que tuvo la última ejecución: </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $query = $profiler->getLastQueryProfile();
 $query = $profiler->getLastQueryProfile();
@@ -320,10 +217,8 @@ echo $query->getQuery();
 ]]></programlisting>
 ]]></programlisting>
 
 
         <para>Tal vez una página se genera lentamente; use el perfilador para
         <para>Tal vez una página se genera lentamente; use el perfilador para
-            determinar primero el
-            número total de segundos de todas las
-            consultas, y luego recorrer paso a paso a través de
-            las consultas
+            determinar primero el número total de segundos de todas las
+            consultas, y luego recorrer paso a paso a través de las consultas
             para encontrar la más lenta:</para>
             para encontrar la más lenta:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
@@ -354,27 +249,19 @@ echo "Consulta más lenta: \n" . $longestQuery . "\n";
 
 
         <title>Uso avanzado del Perfilador</title>
         <title>Uso avanzado del Perfilador</title>
 
 
-        <para>
-            Además de la inspección de consultas, el perfilador también le
-            permite al desarrollador
-            filtrar que consultas serán perfiladas. El
+        <para> Además de la inspección de consultas, el perfilador también le
+            permite al desarrollador filtrar que consultas serán perfiladas. El
             siguiente método opera en una instancia de
             siguiente método opera en una instancia de
-            <classname>Zend_Db_Profiler</classname>
-            :
-        </para>
+                <classname>Zend_Db_Profiler</classname> : </para>
 
 
         <sect3 id="zend.db.profiler.advanced.filtertime">
         <sect3 id="zend.db.profiler.advanced.filtertime">
             <title>Filtrar por tiempo transcurrido en consulta</title>
             <title>Filtrar por tiempo transcurrido en consulta</title>
 
 
             <para>
             <para>
-                <methodname>setFilterElapsedSecs()</methodname>
-                le permite al
+                <methodname>setFilterElapsedSecs()</methodname> le permite al
                 desarrolador establecer un tiempo mínimo antes de que una
                 desarrolador establecer un tiempo mínimo antes de que una
-                consulta se
-                perfile. Para remover el filtro, pase un valor
-                <constant>NULL</constant>
-                al método.
-            </para>
+                consulta se perfile. Para remover el filtro, pase un valor
+                    <constant>NULL</constant> al método. </para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 // Solo perfilar consultas que tardan más de 5 segundos:
 // Solo perfilar consultas que tardan más de 5 segundos:
@@ -389,92 +276,60 @@ $profiler->setFilterElapsedSecs(null);
             <title>Filtrar por tipo de consulta</title>
             <title>Filtrar por tipo de consulta</title>
 
 
             <para>
             <para>
-                <methodname>setFilterQueryType()</methodname>
-                le permite al
+                <methodname>setFilterQueryType()</methodname> le permite al
                 desarrollador establecer que tipo de consulta serán perfiladas;
                 desarrollador establecer que tipo de consulta serán perfiladas;
-                para
-                perfilar multiples tipos, use un "OR" lógico. Los tipos de
-                consulta se definen como
-                las siguientes constantes de
-                <classname>Zend_Db_Profiler</classname>
-                :
-            </para>
+                para perfilar multiples tipos, use un "OR" lógico. Los tipos de
+                consulta se definen como las siguientes constantes de
+                    <classname>Zend_Db_Profiler</classname> : </para>
 
 
             <itemizedlist>
             <itemizedlist>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <constant>Zend_Db_Profiler::CONNECT</constant>
-                        :
+                        <constant>Zend_Db_Profiler::CONNECT</constant> :
                         operaciones de conexión o selección de base de datos.
                         operaciones de conexión o selección de base de datos.
                     </para>
                     </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <constant>Zend_Db_Profiler::QUERY</constant>
-                        :
-                        consultas generales a la base de datos que no calzan con
-                        otros tipos.
-                    </para>
+                        <constant>Zend_Db_Profiler::QUERY</constant> : consultas
+                        generales a la base de datos que no calzan con otros
+                        tipos. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <constant>Zend_Db_Profiler::INSERT</constant>
-                        :
+                        <constant>Zend_Db_Profiler::INSERT</constant> :
                         cualquier consulta que agrega filas a la base de datos,
                         cualquier consulta que agrega filas a la base de datos,
-                        generalmente un
-                        <acronym>SQL</acronym>
-                        INSERT.
-                    </para>
+                        generalmente un <acronym>SQL</acronym> INSERT. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <constant>Zend_Db_Profiler::UPDATE</constant>
-                        :
+                        <constant>Zend_Db_Profiler::UPDATE</constant> :
                         cualquier consulta que actualice registros existentes,
                         cualquier consulta que actualice registros existentes,
-                        usualmente un
-                        <acronym>SQL</acronym>
-                        UPDATE.
-                    </para>
+                        usualmente un <acronym>SQL</acronym> UPDATE. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <constant>Zend_Db_Profiler::DELETE</constant>
-                        :
+                        <constant>Zend_Db_Profiler::DELETE</constant> :
                         cualquier consulta que elimine datos existentes,
                         cualquier consulta que elimine datos existentes,
-                        usualmente un
-                        <acronym>SQL</acronym>
-                        DELETE.
-                    </para>
+                        usualmente un <acronym>SQL</acronym> DELETE. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <constant>Zend_Db_Profiler::SELECT</constant>
-                        :
+                        <constant>Zend_Db_Profiler::SELECT</constant> :
                         cualquier consulta que retorne datos existentes,
                         cualquier consulta que retorne datos existentes,
-                        usualmente un
-                        <acronym>SQL</acronym>
-                        SELECT.
-                    </para>
+                        usualmente un <acronym>SQL</acronym> SELECT. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <constant>Zend_Db_Profiler::TRANSACTION</constant>
-                        :
+                        <constant>Zend_Db_Profiler::TRANSACTION</constant> :
                         cualquier operación transaccional, tal como iniciar una
                         cualquier operación transaccional, tal como iniciar una
-                        transacción,
-                        confirmar, o revertir.
-                    </para>
+                        transacción, confirmar, o revertir. </para>
                 </listitem>
                 </listitem>
             </itemizedlist>
             </itemizedlist>
 
 
-            <para>
-                Asi como con
-                <methodname>setFilterElapsedSecs()</methodname>
-                ,
-                puedes remover cualquier filtro existente pasando un
-                <constant>NULL</constant>
-                como único argumento.
-            </para>
+            <para> Asi como con <methodname>setFilterElapsedSecs()</methodname>
+                , puedes remover cualquier filtro existente pasando un
+                    <constant>NULL</constant> como único argumento. </para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 // Perfilar solo consultas SELECT
 // Perfilar solo consultas SELECT
@@ -497,24 +352,15 @@ $profiler->setFilterQueryType(null);
         <sect3 id="zend.db.profiler.advanced.getbytype">
         <sect3 id="zend.db.profiler.advanced.getbytype">
             <title>Obtener perfiles por tipo de consulta</title>
             <title>Obtener perfiles por tipo de consulta</title>
 
 
-            <para>
-                Usando
-                <methodname>setFilterQueryType()</methodname>
-                puedes
+            <para> Usando <methodname>setFilterQueryType()</methodname> puedes
                 reducir los perfiles generados. Sin embargo, a veces puede ser
                 reducir los perfiles generados. Sin embargo, a veces puede ser
-                más útil
-                mantener todos los perfiles, pero ver sólo los que
-                necesita en un determinado
-                momento. Otra característica de
-                <methodname>getQueryProfiles()</methodname>
-                es que puede
+                más útil mantener todos los perfiles, pero ver sólo los que
+                necesita en un determinado momento. Otra característica de
+                    <methodname>getQueryProfiles()</methodname> es que puede
                 este filtrado al-vuelo, pasando un tipo de consulta(o una
                 este filtrado al-vuelo, pasando un tipo de consulta(o una
-                combinación
-                lógica de tipos de consulta) en el primer; vea
-                <xref linkend="zend.db.profiler.advanced.filtertype"/>
-                para una
-                lista las constantes de tipo de consulta.
-            </para>
+                combinación lógica de tipos de consulta) en el primer; vea <xref
+                    linkend="zend.db.profiler.advanced.filtertype"/> para una
+                lista las constantes de tipo de consulta. </para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 // Obtiene solo perfiles de consultas SELECT
 // Obtiene solo perfiles de consultas SELECT
@@ -536,13 +382,10 @@ $profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::DELETE);
     <sect2 id="zend.db.profiler.profilers">
     <sect2 id="zend.db.profiler.profilers">
         <title>Perfiladores Especializados</title>
         <title>Perfiladores Especializados</title>
 
 
-        <para>
-            Un Perfilador Especializado es un objeto que hereda de
-            <classname>Zend_Db_Profiler</classname>
-            . Los Perfiladores
+        <para> Un Perfilador Especializado es un objeto que hereda de
+                <classname>Zend_Db_Profiler</classname> . Los Perfiladores
             Especializados tratan la información de perfilado de maneras más
             Especializados tratan la información de perfilado de maneras más
-            especificas.
-        </para>
+            especificas. </para>
 
 
         <xi:include href="Zend_Db_Profiler-Firebug.xml"/>
         <xi:include href="Zend_Db_Profiler-Firebug.xml"/>
 
 

+ 6 - 7
documentation/manual/es/module_specs/Zend_Db_Select.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 19726 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.db.select">
 <sect1 id="zend.db.select">
 
 
@@ -440,7 +440,7 @@ $select = $db->select()
             <example id="zend.db.select.building.columns-atomic.example">
             <example id="zend.db.select.building.columns-atomic.example">
 
 
                 <title> Ejemplos agregando columnas con el método
                 <title> Ejemplos agregando columnas con el método
-                        columns()</title>
+                    columns()</title>
 
 
                 <programlisting language="php"><![CDATA[
                 <programlisting language="php"><![CDATA[
 // Construir la consulta:
 // Construir la consulta:
@@ -583,7 +583,7 @@ $select = $db->select()
                     <para>Todas las filas de tabla a la izquierda del operando
                     <para>Todas las filas de tabla a la izquierda del operando
                         son incluidas, pareando las filas de la tabla a la
                         son incluidas, pareando las filas de la tabla a la
                         derecha del operando, y las columnas de la tabla a la
                         derecha del operando, y las columnas de la tabla a la
-                        derecha del operando son rellenadas con NULLs si no
+                        derecha del operando son rellenadas con <constant>NULL</constant>s si no
                         existen filas que coincidan con la tabla a la
                         existen filas que coincidan con la tabla a la
                         izquierda.</para>
                         izquierda.</para>
 
 
@@ -602,7 +602,7 @@ $select = $db->select()
                         la tabla a la derecha del operando son incluidas,
                         la tabla a la derecha del operando son incluidas,
                         pareando las filas de la tabla a la izquierda del
                         pareando las filas de la tabla a la izquierda del
                         operando incluidas, y las columnas de la tabla a la
                         operando incluidas, y las columnas de la tabla a la
-                        izquierda del operando son rellenadas con NULLs si no
+                        izquierda del operando son rellenadas con <constant>NULL</constant>s si no
                         existen filas que coincidan con la tabla de la
                         existen filas que coincidan con la tabla de la
                         derecha.</para>
                         derecha.</para>
 
 
@@ -623,7 +623,7 @@ $select = $db->select()
                         la derecha. Todas las filas de ambas tablas son
                         la derecha. Todas las filas de ambas tablas son
                         incluidas, vinculadas entre sí en la misma fila si
                         incluidas, vinculadas entre sí en la misma fila si
                         satisfacen la condición de unión, y en otro caso, se
                         satisfacen la condición de unión, y en otro caso, se
-                        vinculan con valores nulos en lugar de columnas de la
+                        vinculan con valores <constant>NULL</constant>'s en lugar de columnas de la
                         otra tabla.</para>
                         otra tabla.</para>
 
 
                     <para> Algunos <acronym>RDBMS</acronym> no soportan este
                     <para> Algunos <acronym>RDBMS</acronym> no soportan este
@@ -1335,8 +1335,7 @@ $result = $stmt->fetchAll();
 
 
         <sect3 id="zend.db.select.execute.tostring">
         <sect3 id="zend.db.select.execute.tostring">
 
 
-            <title> Convertiendo un Objeto Select a un String
-                    SQL</title>
+            <title> Convertiendo un Objeto Select a un String SQL</title>
 
 
             <para> Si necesita acceder a una represantación en un string de la
             <para> Si necesita acceder a una represantación en un string de la
                 consulta <acronym>SQL</acronym> correspondiente al objeto
                 consulta <acronym>SQL</acronym> correspondiente al objeto

+ 113 - 202
documentation/manual/es/module_specs/Zend_Db_Table_Rowset.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 18822 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.db.table.rowset">
 <sect1 id="zend.db.table.rowset">
 
 
@@ -9,20 +9,15 @@
 
 
         <title>Introduction</title>
         <title>Introduction</title>
 
 
-        <para>
-            When you run a query against a Table class using the
-            <methodname>find()</methodname>
-            or
-            <methodname>fetchAll()</methodname>
-            methods, the result is returned in an object of type
-            <classname>Zend_Db_Table_Rowset_Abstract</classname>
-            . A Rowset
+        <para> When you run a query against a Table class using the
+                <methodname>find()</methodname> or
+                <methodname>fetchAll()</methodname> methods, the result is
+            returned in an object of type
+                <classname>Zend_Db_Table_Rowset_Abstract</classname> . A Rowset
             contains a collection of objects descending from
             contains a collection of objects descending from
-            <classname>Zend_Db_Table_Row_Abstract</classname>
-            . You can iterate
-            through the Rowset and access individual Row objects, reading or
-            modifying data in the Rows.
-        </para>
+                <classname>Zend_Db_Table_Row_Abstract</classname> . You can
+            iterate through the Rowset and access individual Row objects,
+            reading or modifying data in the Rows. </para>
 
 
     </sect2>
     </sect2>
 
 
@@ -31,16 +26,11 @@
         <title>Fetching a Rowset</title>
         <title>Fetching a Rowset</title>
 
 
         <para>
         <para>
-            <classname>Zend_Db_Table_Abstract</classname>
-            provides methods
-            <methodname>find()</methodname>
-            and
-            <methodname>fetchAll()</methodname>
-            , each
-            of which returns an object of type
-            <classname>Zend_Db_Table_Rowset_Abstract</classname>
-            .
-        </para>
+            <classname>Zend_Db_Table_Abstract</classname> provides methods
+                <methodname>find()</methodname> and
+                <methodname>fetchAll()</methodname> , each of which returns an
+            object of type <classname>Zend_Db_Table_Rowset_Abstract</classname>
+            . </para>
 
 
         <example id="zend.db.table.rowset.fetch.example">
         <example id="zend.db.table.rowset.fetch.example">
 
 
@@ -59,25 +49,17 @@ $rowset = $bugs->fetchAll("bug_status = 'NEW'");
 
 
         <title>Retrieving Rows from a Rowset</title>
         <title>Retrieving Rows from a Rowset</title>
 
 
-        <para>
-            The Rowset itself is usually less interesting than the Rows that it contains. This
-            section illustrates how
-            to get the Rows that comprise the Rowset.
-       </para>
+        <para> The Rowset itself is usually less interesting than the Rows that
+            it contains. This section illustrates how to get the Rows that
+            comprise the Rowset. </para>
 
 
-        <para>
-            A legitimate query returns zero rows when no rows in the database match the query
-            conditions. Therefore, a
-            Rowset object might contain zero Row objects. Since
-            <classname>Zend_Db_Table_Rowset_Abstract</classname>
-            implements
-            the
-            <methodname>Countable</methodname>
-            interface, you can use
-            <methodname>count()</methodname>
-            to determine the number of Rows in
-            the Rowset.
-        </para>
+        <para> A legitimate query returns zero rows when no rows in the database
+            match the query conditions. Therefore, a Rowset object might contain
+            zero Row objects. Since
+                <classname>Zend_Db_Table_Rowset_Abstract</classname> implements
+            the <methodname>Countable</methodname> interface, you can use
+                <methodname>count()</methodname> to determine the number of Rows
+            in the Rowset. </para>
 
 
         <example id="zend.db.table.rowset.rows.counting.example">
         <example id="zend.db.table.rowset.rows.counting.example">
 
 
@@ -101,12 +83,10 @@ if ($rowCount > 0) {
 
 
             <title>Reading a Single Row from a Rowset</title>
             <title>Reading a Single Row from a Rowset</title>
 
 
-            <para>
-                The simplest way to access a Row from a Rowset is to use the
-                <methodname>current()</methodname>
-                method. This is
-                particularly appropriate when the Rowset contains exactly one Row.
-            </para>
+            <para> The simplest way to access a Row from a Rowset is to use the
+                    <methodname>current()</methodname> method. This is
+                particularly appropriate when the Rowset contains exactly one
+                Row. </para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 $bugs   = new Bugs();
 $bugs   = new Bugs();
@@ -116,32 +96,22 @@ $row    = $rowset->current();
 
 
         </example>
         </example>
 
 
-        <para>
-            If the Rowset contains zero rows,
-            <methodname>current()</methodname>
-            returns
-            PHP's
-            <constant>NULL</constant>
-            value.
-        </para>
+        <para> If the Rowset contains zero rows,
+                <methodname>current()</methodname> returns PHP's
+                <constant>NULL</constant> value. </para>
 
 
         <example id="zend.db.table.rowset.rows.iterate.example">
         <example id="zend.db.table.rowset.rows.iterate.example">
 
 
             <title>Iterating through a Rowset</title>
             <title>Iterating through a Rowset</title>
 
 
-            <para>
-                Objects descending from
-                <classname>Zend_Db_Table_Rowset_Abstract</classname>
-                implement the
-                <methodname>SeekableIterator</methodname>
+            <para> Objects descending from
+                    <classname>Zend_Db_Table_Rowset_Abstract</classname>
+                implement the <methodname>SeekableIterator</methodname>
                 interface, which means you can loop through them using the
                 interface, which means you can loop through them using the
-                <methodname>foreach</methodname>
-                construct. Each value
-                you retrieve this way is a
-                <classname>Zend_Db_Table_Row_Abstract</classname>
-                object that corresponds to one
-                record from the table.
-            </para>
+                    <methodname>foreach</methodname> construct. Each value you
+                retrieve this way is a
+                    <classname>Zend_Db_Table_Row_Abstract</classname> object
+                that corresponds to one record from the table. </para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 $bugs = new Bugs();
 $bugs = new Bugs();
@@ -172,20 +142,14 @@ foreach ($rowset as $row) {
             <title>Seeking to a known position into a Rowset</title>
             <title>Seeking to a known position into a Rowset</title>
 
 
             <para>
             <para>
-                <methodname>SeekableIterator</methodname>
-                allows you to seek to a position that you would like the iterator to jump to.
-                Simply
-                use the
-                <methodname>seek()</methodname>
-                method for that. Pass it an integer representing the number of the Row
-                you would like
-                your Rowset to point to next, don't forget that it starts with index 0. If the index
-                is wrong,
-                ie doesn't exist, an exception will be thrown. You should use
-                <methodname>count()</methodname>
-                to check the number of
-                results before seeking to a position.
-            </para>
+                <methodname>SeekableIterator</methodname> allows you to seek to
+                a position that you would like the iterator to jump to. Simply
+                use the <methodname>seek()</methodname> method for that. Pass it
+                an integer representing the number of the Row you would like
+                your Rowset to point to next, don't forget that it starts with
+                index 0. If the index is wrong, ie doesn't exist, an exception
+                will be thrown. You should use <methodname>count()</methodname>
+                to check the number of results before seeking to a position. </para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 $bugs = new Bugs();
 $bugs = new Bugs();
@@ -207,18 +171,16 @@ $row9->save();
         </example>
         </example>
 
 
         <para>
         <para>
-            <methodname>getRow()</methodname>
-            allows you to get a specific row in the Rowset, knowing its position; don't forget
-            however that positions start with index zero. The first parameter for
-            <methodname>getRow()</methodname>
-            is an integer
-            for the position asked. The second optional parameter is a boolean; it tells the Rowset iterator if
-            it must
-            seek to that position in the same time, or not (default is false). This method returns a
-            <classname>Zend_Db_Table_Row</classname>
-            object by default. If the position requested does not exist, an exception will be
-            thrown. Here is an example :
-        </para>
+            <methodname>getRow()</methodname> allows you to get a specific row
+            in the Rowset, knowing its position; don't forget however that
+            positions start with index zero. The first parameter for
+                <methodname>getRow()</methodname> is an integer for the position
+            asked. The second optional parameter is a boolean; it tells the
+            Rowset iterator if it must seek to that position in the same time,
+            or not (default is  <constant>FALSE</constant>). This method returns a
+                <classname>Zend_Db_Table_Row</classname> object by default. If
+            the position requested does not exist, an exception will be thrown.
+            Here is an example : </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $bugs = new Bugs();
 $bugs = new Bugs();
@@ -234,12 +196,9 @@ $row9->assigned_to = 'mmouse';
 $row9->save();
 $row9->save();
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            After you have access to an individual Row object, you can manipulate the Row using
-            methods described in
-            <xref linkend="zend.db.table.row"/>
-            .
-        </para>
+        <para> After you have access to an individual Row object, you can
+            manipulate the Row using methods described in <xref
+                linkend="zend.db.table.row"/> . </para>
 
 
     </sect2>
     </sect2>
 
 
@@ -247,15 +206,11 @@ $row9->save();
 
 
         <title>Retrieving a Rowset as an Array</title>
         <title>Retrieving a Rowset as an Array</title>
 
 
-        <para>
-            You can access all the data in the Rowset as an array using the
-            <methodname>toArray()</methodname>
-            method of the Rowset
-            object. This returns an array containing one entry per Row. Each
-            entry is an associative array having keys
-            that correspond to column names and elements
-            that correspond to the respective column values.
-        </para>
+        <para> You can access all the data in the Rowset as an array using the
+                <methodname>toArray()</methodname> method of the Rowset object.
+            This returns an array containing one entry per Row. Each entry is an
+            associative array having keys that correspond to column names and
+            elements that correspond to the respective column values. </para>
 
 
         <example id="zend.db.table.rowset.to-array.example">
         <example id="zend.db.table.rowset.to-array.example">
 
 
@@ -279,13 +234,10 @@ foreach ($rowsetArray as $rowArray) {
 ]]></programlisting>
 ]]></programlisting>
         </example>
         </example>
 
 
-        <para>
-            The array returned from
-            <methodname>toArray()</methodname>
-            is not updateable. That is, you can modify values in the
-            array as you can with any array,
-            but changes to the array data are not propagated to the database.
-        </para>
+        <para> The array returned from <methodname>toArray()</methodname> is not
+            updateable. That is, you can modify values in the array as you can
+            with any array, but changes to the array data are not propagated to
+            the database. </para>
 
 
     </sect2>
     </sect2>
 
 
@@ -293,25 +245,18 @@ foreach ($rowsetArray as $rowArray) {
 
 
         <title>Serializing and Unserializing a Rowset</title>
         <title>Serializing and Unserializing a Rowset</title>
 
 
-        <para>
-            Objects of type
-            <classname>Zend_Db_Table_Rowset_Abstract</classname>
-            are serializable. In a similar fashion to
-            serializing an individual Row object, you can
-            serialize a Rowset and unserialize it later.
-        </para>
+        <para> Objects of type
+                <classname>Zend_Db_Table_Rowset_Abstract</classname> are
+            serializable. In a similar fashion to serializing an individual Row
+            object, you can serialize a Rowset and unserialize it later. </para>
 
 
         <example id="zend.db.table.rowset.serialize.example.serialize">
         <example id="zend.db.table.rowset.serialize.example.serialize">
 
 
             <title>Serializing a Rowset</title>
             <title>Serializing a Rowset</title>
 
 
-            <para>
-                Simply use PHP's
-                <methodname>serialize()</methodname>
+            <para> Simply use PHP's <methodname>serialize()</methodname>
                 function to create a string containing a byte-stream
                 function to create a string containing a byte-stream
-                representation of the Rowset
-                object argument.
-            </para>
+                representation of the Rowset object argument. </para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 $bugs   = new Bugs();
 $bugs   = new Bugs();
@@ -329,24 +274,16 @@ $serializedRowset = serialize($rowset);
 
 
             <title>Unserializing a Serialized Rowset</title>
             <title>Unserializing a Serialized Rowset</title>
 
 
-            <para>
-                Use PHP's
-                <methodname>unserialize()</methodname>
-                function to restore a string containing a byte-stream
-                representation of an object.
-                The function returns the original object.
-            </para>
+            <para> Use PHP's <methodname>unserialize()</methodname> function to
+                restore a string containing a byte-stream representation of an
+                object. The function returns the original object. </para>
 
 
-            <para>
-                Note that the Rowset object returned is in a
-                <emphasis>disconnected</emphasis>
-                state. You can iterate
+            <para> Note that the Rowset object returned is in a
+                    <emphasis>disconnected</emphasis> state. You can iterate
                 through the Rowset and read the Row objects and their
                 through the Rowset and read the Row objects and their
-                properties, but you cannot change values in the
-                Rows or execute other methods that
-                require a database connection (for example, queries against related
-                tables).
-            </para>
+                properties, but you cannot change values in the Rows or execute
+                other methods that require a database connection (for example,
+                queries against related tables). </para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 $rowsetDisconnected = unserialize($serializedRowset);
 $rowsetDisconnected = unserialize($serializedRowset);
@@ -360,35 +297,26 @@ echo $row->bug_description;
 
 
         <note>
         <note>
             <title>Why do Rowsets unserialize in a disconnected state?</title>
             <title>Why do Rowsets unserialize in a disconnected state?</title>
-            <para>
-                A serialized object is a string that is readable to anyone who possesses it. It
-                could be a security
-                risk to store parameters such as database account and password in
-                plain, unencrypted text in the
-                serialized string. You would not want to store such
-                data to a text file that is not protected, or send
-                it in an email or other medium
-                that is easily read by potential attackers. The reader of the serialized
-                object
-                should not be able to use it to gain access to your database without knowing valid
-                credentials.
-           </para>
+            <para> A serialized object is a string that is readable to anyone
+                who possesses it. It could be a security risk to store
+                parameters such as database account and password in plain,
+                unencrypted text in the serialized string. You would not want to
+                store such data to a text file that is not protected, or send it
+                in an email or other medium that is easily read by potential
+                attackers. The reader of the serialized object should not be
+                able to use it to gain access to your database without knowing
+                valid credentials. </para>
         </note>
         </note>
 
 
-        <para>
-            You can reactivate a disconnected Rowset using the
-            <methodname>setTable()</methodname>
-            method. The argument to this
+        <para> You can reactivate a disconnected Rowset using the
+                <methodname>setTable()</methodname> method. The argument to this
             method is a valid object of type
             method is a valid object of type
-            <classname>Zend_Db_Table_Abstract</classname>
-            , which you create. Creating a Table
-            object requires a live connection to the database,
-            so by reassociating the Table with the Rowset, the
-            Rowset gains access to the database.
-            Subsequently, you can change values in the Row objects contained in
-            the Rowset and save
-            the changes to the database.
-        </para>
+                <classname>Zend_Db_Table_Abstract</classname> , which you
+            create. Creating a Table object requires a live connection to the
+            database, so by reassociating the Table with the Rowset, the Rowset
+            gains access to the database. Subsequently, you can change values in
+            the Row objects contained in the Rowset and save the changes to the
+            database. </para>
 
 
         <example id="zend.db.table.rowset.serialize.example.set-table">
         <example id="zend.db.table.rowset.serialize.example.set-table">
 
 
@@ -412,12 +340,8 @@ $row->save();
 
 
         </example>
         </example>
 
 
-        <para>
-            Reactivating a Rowset with
-            <methodname>setTable()</methodname>
-            also reactivates all the Row objects contained in that
-            Rowset.
-        </para>
+        <para> Reactivating a Rowset with <methodname>setTable()</methodname>
+            also reactivates all the Row objects contained in that Rowset. </para>
 
 
     </sect2>
     </sect2>
 
 
@@ -425,17 +349,13 @@ $row->save();
 
 
         <title>Extending the Rowset class</title>
         <title>Extending the Rowset class</title>
 
 
-        <para>
-            You can use an alternative concrete class for instances of Rowsets
-            by extending
-            <classname>Zend_Db_Table_Rowset_Abstract</classname>
-            . Specify the custom
-            Rowset class by name either in the
-            <varname>$_rowsetClass</varname>
-            protected member of a Table class, or in the array argument of the
-            constructor of a Table
-            object.
-        </para>
+        <para> You can use an alternative concrete class for instances of
+            Rowsets by extending
+                <classname>Zend_Db_Table_Rowset_Abstract</classname> . Specify
+            the custom Rowset class by name either in the
+                <varname>$_rowsetClass</varname> protected member of a Table
+            class, or in the array argument of the constructor of a Table
+            object. </para>
 
 
         <example id="zend.db.table.rowset.extending.example">
         <example id="zend.db.table.rowset.extending.example">
             <title>Specifying a custom Rowset class</title>
             <title>Specifying a custom Rowset class</title>
@@ -459,17 +379,11 @@ $bugs = new Bugs(array('rowsetClass' => 'MyRowset'));
 ]]></programlisting>
 ]]></programlisting>
         </example>
         </example>
 
 
-        <para>
-            Typically, the standard
-            <classname>Zend_Db_Rowset</classname>
-            concrete class is
-            sufficient for most usage. However, you might find it useful
-            to add new
-            logic to a Rowset, specific to a given Table.
-            For example, a new method could calculate
-            an aggregate
-            over all the Rows in the Rowset.
-        </para>
+        <para> Typically, the standard <classname>Zend_Db_Rowset</classname>
+            concrete class is sufficient for most usage. However, you might find
+            it useful to add new logic to a Rowset, specific to a given Table.
+            For example, a new method could calculate an aggregate over all the
+            Rows in the Rowset. </para>
 
 
         <example id="zend.db.table.rowset.extending.example-aggregate">
         <example id="zend.db.table.rowset.extending.example-aggregate">
             <title>Example of Rowset class with a new method</title>
             <title>Example of Rowset class with a new method</title>
@@ -504,6 +418,3 @@ class Bugs extends Zend_Db_Table_Abstract
     </sect2>
     </sect2>
 
 
 </sect1>
 </sect1>
-    <!--
-vim:se ts=4 sw=4 et:
--->

+ 15 - 18
documentation/manual/es/module_specs/Zend_Dojo-Data.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 17598 -->
+<!-- EN-Revision: 20176 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.dojo.data">
 <sect1 id="zend.dojo.data">
     <title>Zend_Dojo_Data: Envolturas de dojo.data</title>
     <title>Zend_Dojo_Data: Envolturas de dojo.data</title>
@@ -66,8 +66,7 @@ $data->setIdentifier('id')
                 <methodname>addItems()</methodname> . </para>
                 <methodname>addItems()</methodname> . </para>
 
 
         <example id="zend.dojo.data.usage.append">
         <example id="zend.dojo.data.usage.append">
-            <title> Agregando datos a Zend_Dojo_Data
-            </title>
+            <title> Agregando datos a Zend_Dojo_Data </title>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 $data = new Zend_Dojo_Data($identifier, $items);
 $data = new Zend_Dojo_Data($identifier, $items);
@@ -119,9 +118,9 @@ $data->addItems($someMoreItems);
 
 
             <listitem>
             <listitem>
                 <para> Objectos implementando la interfaz
                 <para> Objectos implementando la interfaz
-                        <methodname>Traversable</methodname> , que incluye las
-                    interfaces <methodname>Iterator</methodname> y
-                        <methodname>ArrayAccess</methodname> . </para>
+                    <classname>Traversable</classname> , que incluye las
+                    interfaces <classname>Iterator</classname> y
+                    <classname>ArrayAccess</classname> . </para>
             </listitem>
             </listitem>
         </itemizedlist>
         </itemizedlist>
 
 
@@ -129,9 +128,7 @@ $data->addItems($someMoreItems);
             el item, llame a <methodname>setLabel()</methodname> : </para>
             el item, llame a <methodname>setLabel()</methodname> : </para>
 
 
         <example id="zend.dojo.data.usage.label">
         <example id="zend.dojo.data.usage.label">
-            <title> Especificando la etiqueta de un campo en
-                    Zend_Dojo_Data
-            </title>
+            <title> Especificando la etiqueta de un campo en Zend_Dojo_Data </title>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 $data->setLabel('name');
 $data->setLabel('name');
@@ -157,11 +154,11 @@ $data->fromJson($json);
 
 
         <para> Algunos componentes de Dojo requieren metadatos adicionales junto
         <para> Algunos componentes de Dojo requieren metadatos adicionales junto
             al conjunto de datos de dojo.data. Como ejemplo,
             al conjunto de datos de dojo.data. Como ejemplo,
-                <methodname>dojox.grid.Grid</methodname> puede tirar datos
+            <command>dojox.grid.Grid</command> puede tirar datos
             dinámicamente desde un
             dinámicamente desde un
-                <methodname>dojox.data.QueryReadStore</methodname> . Para que la
+            <command>dojox.data.QueryReadStore</command> . Para que la
             paginación funcione correctamente, cada conjunto de datos de regreso
             paginación funcione correctamente, cada conjunto de datos de regreso
-            debería contener una clave <methodname>numRows</methodname> con el
+            debería contener una clave <property>numRows</property> con el
             número total de filas que podrían ser devueltas por la consulta. Con
             número total de filas que podrían ser devueltas por la consulta. Con
             estos datos, la plantilla sabe cuando seguir haciendo pequeños
             estos datos, la plantilla sabe cuando seguir haciendo pequeños
             pedidos de subconjuntos de datos al servidor y cuando dejar de hacer
             pedidos de subconjuntos de datos al servidor y cuando dejar de hacer
@@ -207,9 +204,9 @@ $data->clearMetadata();
 
 
         <para>
         <para>
             <classname>Zend_Dojo_Data</classname> implementa las interfaces
             <classname>Zend_Dojo_Data</classname> implementa las interfaces
-                <methodname>ArrayAccess</methodname> ,
-                <methodname>Iterator</methodname> , y
-                <methodname>Countable</methodname> . Por lo tanto, puede usar la
+            <classname>ArrayAccess</classname> ,
+            <classname>Iterator</classname> , y
+            <classname>Countable</classname> . Por lo tanto, puede usar la
             recopilación de datos casi como si fuera un array. </para>
             recopilación de datos casi como si fuera un array. </para>
 
 
         <para> Todos los items son referenciados por el identificador de campo.
         <para> Todos los items son referenciados por el identificador de campo.
@@ -281,7 +278,7 @@ $json = (string) $data; // conversión a string == conversión a JSON
                         varios items a la vez, sobrescribiendo cualquier item
                         varios items a la vez, sobrescribiendo cualquier item
                         que figurase anteriormente en el objeto.
                         que figurase anteriormente en el objeto.
                             <varname>$items</varname> debe ser un array o un
                             <varname>$items</varname> debe ser un array o un
-                        objeto <methodname>Traversable</methodname> . </para>
+                        objeto <classname>Traversable</classname> . </para>
                 </listitem>
                 </listitem>
 
 
                 <listitem>
                 <listitem>
@@ -314,7 +311,7 @@ $json = (string) $data; // conversión a string == conversión a JSON
                         los nuevos items tiene un identificador concordante a un
                         los nuevos items tiene un identificador concordante a un
                         identificador ya existente en la colección.
                         identificador ya existente en la colección.
                             <varname>$items</varname> debe ser un array o un
                             <varname>$items</varname> debe ser un array o un
-                        objeto <methodname>Traversable</methodname> . </para>
+                        objeto <classname>Traversable</classname> . </para>
                 </listitem>
                 </listitem>
 
 
                 <listitem>
                 <listitem>
@@ -335,7 +332,7 @@ $json = (string) $data; // conversión a string == conversión a JSON
                         <methodname>getItem($id)</methodname> : recupera un item
                         <methodname>getItem($id)</methodname> : recupera un item
                         con el identificador dado de la colección; el item
                         con el identificador dado de la colección; el item
                         retornado será un array asociativo. Si ningún item
                         retornado será un array asociativo. Si ningún item
-                        coincide, se devolverá un valor null. </para>
+                        coincide, se devolverá un valor <constant>NULL</constant>. </para>
                 </listitem>
                 </listitem>
 
 
                 <listitem>
                 <listitem>

+ 45 - 85
documentation/manual/es/module_specs/Zend_Dojo-Form-Decorators.xml

@@ -1,69 +1,46 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 17134 -->
+<!-- EN-Revision: 20176 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect2 id="zend.dojo.form.decorators">
 <sect2 id="zend.dojo.form.decorators">
     <title>Decoradores de Forms Específicos de Dijit</title>
     <title>Decoradores de Forms Específicos de Dijit</title>
 
 
     <para>La mayoría de los elementos de formularios pueden usar el decorador
     <para>La mayoría de los elementos de formularios pueden usar el decorador
-        DijitElement, que
-        tomará los parámetros dijit de los elementos, y
-        pasarán estos y otros metadatos al ayudante
-        de vista especificado por el
-        elemento. Sin embargo, para decorar los forms, sub forms, y
-        grupos de
+        DijitElement, que tomará los parámetros dijit de los elementos, y
+        pasarán estos y otros metadatos al ayudante de vista especificado por el
+        elemento. Sin embargo, para decorar los forms, sub forms, y grupos de
         visualización, hay un conjunto de decoradores correspondientes a los
         visualización, hay un conjunto de decoradores correspondientes a los
-        diversos
-        esquemas dijit.</para>
-
-    <para>
-        Todos los decoradores dijit buscan la propiedad
-        <methodname>dijitParams</methodname>
-        del elemento que va a ser
-        decorado, y mandarlos como un array
-        <varname>$params</varname>
-        al
+        diversos esquemas dijit.</para>
+
+    <para> Todos los decoradores dijit buscan la propiedad
+        <property>dijitParams</property> del elemento que va a ser
+        decorado, y mandarlos como un array <varname>$params</varname> al
         ayudante de vista dijit que se está usando. Luego, éstos son separados
         ayudante de vista dijit que se está usando. Luego, éstos son separados
-        de cualquiera de las
-        otras propiedades para evitar la duplicación de
-        información.
-    </para>
+        de cualquiera de las otras propiedades para evitar la duplicación de
+        información. </para>
 
 
     <sect3 id="zend.dojo.form.decorators.dijitElement">
     <sect3 id="zend.dojo.form.decorators.dijitElement">
         <title>Decorador DijitElement</title>
         <title>Decorador DijitElement</title>
 
 
-        <para>
-            Al igual que
-            <link linkend="zend.form.standardDecorators.viewHelper"> el decorador
-                ViewHelper</link>
-            , DijitElement espera una propiedad del
-            <methodname>helper</methodname>
-            en el elemento que luego usará
-            como el ayudante de vista cuando lo renderice. Los
-            parámetros Dijit
+        <para> Al igual que <link
+                linkend="zend.form.standardDecorators.viewHelper"> el decorador
+                ViewHelper</link> , DijitElement espera una propiedad del
+            <property>helper</property> en el elemento que luego usará
+            como el ayudante de vista cuando lo renderice. Los parámetros Dijit
             suelen ser arrastrados directamente desde el elemento, pero también
             suelen ser arrastrados directamente desde el elemento, pero también
             pueden ser pasados como opciones vía la clave
             pueden ser pasados como opciones vía la clave
-            <methodname>dijitParams</methodname>
-            (el valor de esa clave debe
-            ser un array asociativo de opciones).
-        </para>
+            <property>dijitParams</property> (el valor de esa clave debe
+            ser un array asociativo de opciones). </para>
 
 
-        <para>
-            Es importante que cada elemento tenga un único ID (como traído
-            desde el método
-            <methodname>getId()</methodname>
-            del elemento). Si
+        <para> Es importante que cada elemento tenga un único ID (como traído
+            desde el método <methodname>getId()</methodname> del elemento). Si
             se detectan duplicados dentro del ayudante de vista
             se detectan duplicados dentro del ayudante de vista
-            <methodname>dojo()</methodname>
-            , el decorador accionará un
-            aviso, pero luego creará un único ID añadiéndole lo que
-            devuelve
-            <methodname>uniqid()</methodname>
-            al identificador.
-        </para>
+                <methodname>dojo()</methodname> , el decorador accionará un
+            aviso, pero luego creará un único ID añadiéndole lo que devuelve
+                <methodname>uniqid()</methodname> al identificador. </para>
 
 
         <para>El uso estándar es simplemente asociar este decorador como el
         <para>El uso estándar es simplemente asociar este decorador como el
-            primero de su cadena de
-            decoradores, sin opciones adicionales.</para>
+            primero de su cadena de decoradores, sin opciones
+            adicionales.</para>
 
 
         <example id="zend.dojo.form.decorators.dijitElement.usage">
         <example id="zend.dojo.form.decorators.dijitElement.usage">
             <title>Uso del Decorador DijitElement</title>
             <title>Uso del Decorador DijitElement</title>
@@ -82,54 +59,37 @@ $element->setDecorators(array(
     <sect3 id="zend.dojo.form.decorators.dijitForm">
     <sect3 id="zend.dojo.form.decorators.dijitForm">
         <title>Decorador DijitForm</title>
         <title>Decorador DijitForm</title>
 
 
-        <para>
-            El decorador DijitForm es muy similar al
-            <link linkend="zend.form.standardDecorators.form">Form
-                decorator</link>
-            ; de hecho, básicamente puede ser utilizado de
-            manera intercambiable con él, ya que
-            utiliza el mismo nombre de
-            ayudante de vista ('form').
-        </para>
+        <para> El decorador DijitForm es muy similar al <link
+                linkend="zend.form.standardDecorators.form">Form
+                decorator</link> ; de hecho, básicamente puede ser utilizado de
+            manera intercambiable con él, ya que utiliza el mismo nombre de
+            ayudante de vista ('form'). </para>
 
 
-        <para>Dado que dijit.form.Form no requiere ningún parámetro dijit para
-            la configuración, la
-            principal diferencia es que el ayudante de
-            vista dijit del form exige que se pase un DOM
-            ID para garantizar que
+        <para>Dado que <command>dijit.form.Form</command> no requiere ningún parámetro dijit para
+            la configuración, la principal diferencia es que el ayudante de
+            vista dijit del form exige que se pase un <acronym>DOM</acronym> ID para garantizar que
             la creación programática del dijit pueda trabajar. El decorador
             la creación programática del dijit pueda trabajar. El decorador
             garantiza esto, pasando el nombre del form como el identificador.
             garantiza esto, pasando el nombre del form como el identificador.
-       </para>
+        </para>
     </sect3>
     </sect3>
 
 
     <sect3 id="zend.dojo.form.decorators.dijitContainer">
     <sect3 id="zend.dojo.form.decorators.dijitContainer">
         <title>Decoradores basados en DijitContainer</title>
         <title>Decoradores basados en DijitContainer</title>
 
 
-        <para>
-            El decorador
-            <methodname>DijitContainer</methodname>
-            es en
+        <para> El decorador <classname>DijitContainer</classname> es en
             realidad una clase abstracta desde la cual derivan una variedad de
             realidad una clase abstracta desde la cual derivan una variedad de
-            otros
-            decoradores. Ofrece la misma funcionalidad de
-            <link linkend="zend.dojo.form.decorators.dijitElement">DijitElement</link>
-            , con el añadido del soporte para títulos.
-            Muchos esquemas de dijits requieren o pueden
-            utilizar un título;
-            DijitContainer utilizará la propiedad del elemento leyenda (legend)
+            otros decoradores. Ofrece la misma funcionalidad de <link
+                linkend="zend.dojo.form.decorators.dijitElement"
+                >DijitElement</link> , con el añadido del soporte para títulos.
+            Muchos esquemas de dijits requieren o pueden utilizar un título;
+            <classname>DijitContainer</classname> utilizará la propiedad del elemento leyenda (legend)
             si está disponible, y también pueden utilizar tanto 'legend' o
             si está disponible, y también pueden utilizar tanto 'legend' o
-            'title' como opción del
-            decorador, si es pasada. El título será
-            traducido si un adaptador de traducción con su
-            correspondiente
-            traducción está presente.
-        </para>
+            'title' como opción del decorador, si es pasada. El título será
+            traducido si un adaptador de traducción con su correspondiente
+            traducción está presente. </para>
 
 
-        <para>
-            La siguiente es una lista de decoradores que heredan de
-            <methodname>DijitContainer</methodname>
-            :
-        </para>
+        <para> La siguiente es una lista de decoradores que heredan de
+            <classname>DijitContainer</classname> : </para>
 
 
         <itemizedlist>
         <itemizedlist>
             <listitem>
             <listitem>

Some files were not shown because too many files changed in this diff