Browse Source

update DOC-ES

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@20181 44c647ce-9c0f-0410-b52a-842ac1e357ba
benjamin-gonzales 16 years ago
parent
commit
5bdb55771d
23 changed files with 2555 additions and 4977 deletions
  1. 1 1
      documentation/manual/es/module_specs/Zend_Application-AvailableResources-Db.xml
  2. 3 3
      documentation/manual/es/module_specs/Zend_Application-AvailableResources.xml
  3. 150 329
      documentation/manual/es/module_specs/Zend_Db_Table_Row.xml
  4. 227 445
      documentation/manual/es/module_specs/Zend_Dojo-Form-Elements.xml
  5. 240 340
      documentation/manual/es/module_specs/Zend_Dojo-View-Dojo.xml
  6. 222 454
      documentation/manual/es/module_specs/Zend_Dojo-View-Helpers.xml
  7. 105 189
      documentation/manual/es/module_specs/Zend_Filter.xml
  8. 103 202
      documentation/manual/es/module_specs/Zend_Form-Advanced.xml
  9. 236 490
      documentation/manual/es/module_specs/Zend_Form-Elements.xml
  10. 221 455
      documentation/manual/es/module_specs/Zend_Form-Forms.xml
  11. 142 294
      documentation/manual/es/module_specs/Zend_Form-QuickStart.xml
  12. 3 3
      documentation/manual/es/module_specs/Zend_Form-StandardDecorators.xml
  13. 5 5
      documentation/manual/es/module_specs/Zend_Form-StandardElements.xml
  14. 333 683
      documentation/manual/es/module_specs/Zend_Json-Server.xml
  15. 111 242
      documentation/manual/es/module_specs/Zend_Loader.xml
  16. 91 168
      documentation/manual/es/module_specs/Zend_Pdf-Properties.xml
  17. 12 26
      documentation/manual/es/module_specs/Zend_Pdf-Save.xml
  18. 183 308
      documentation/manual/es/module_specs/Zend_Validate-EmailAddress.xml
  19. 56 131
      documentation/manual/es/module_specs/Zend_Validate-Hostname.xml
  20. 103 199
      documentation/manual/es/module_specs/Zend_Validate-Set.xml
  21. 4 5
      documentation/manual/es/module_specs/Zend_Validate.xml
  22. 1 1
      documentation/manual/es/module_specs/Zend_Version.xml
  23. 3 4
      documentation/manual/es/ref/coding_standard.xml

+ 1 - 1
documentation/manual/es/module_specs/Zend_Application-AvailableResources-Db.xml

@@ -13,7 +13,7 @@
         defecto para usarlo con
         defecto para usarlo con
         <classname>Zend_Db_Table</classname>
         <classname>Zend_Db_Table</classname>
         .
         .
-		 <classname>Zend_Db_Table</classname>. If you want to use mutliple databases
+         <classname>Zend_Db_Table</classname>. If you want to use mutliple databases
         simultaneously, you can use the <link
         simultaneously, you can use the <link
         linkend="zend.application.available-resources.multidb">Multidb Resource
         linkend="zend.application.available-resources.multidb">Multidb Resource
         Plugin</link>.
         Plugin</link>.

+ 3 - 3
documentation/manual/es/module_specs/Zend_Application-AvailableResources.xml

@@ -11,11 +11,11 @@
     <xi:include href="Zend_Application-AvailableResources-Db.xml"/>
     <xi:include href="Zend_Application-AvailableResources-Db.xml"/>
     <xi:include href="Zend_Application-AvailableResources-Frontcontroller.xml"/>
     <xi:include href="Zend_Application-AvailableResources-Frontcontroller.xml"/>
     <xi:include href="Zend_Application-AvailableResources-Layout.xml"/>
     <xi:include href="Zend_Application-AvailableResources-Layout.xml"/>
-	<xi:include href="Zend_Application-AvailableResources-Locale.xml" />
+    <xi:include href="Zend_Application-AvailableResources-Locale.xml" />
     <xi:include href="Zend_Application-AvailableResources-Log.xml" />
     <xi:include href="Zend_Application-AvailableResources-Log.xml" />
-	 <xi:include href="Zend_Application-AvailableResources-Mail.xml" />
+     <xi:include href="Zend_Application-AvailableResources-Mail.xml" />
     <xi:include href="Zend_Application-AvailableResources-Modules.xml"/>
     <xi:include href="Zend_Application-AvailableResources-Modules.xml"/>
-	 <xi:include href="Zend_Application-AvailableResources-Multidb.xml" />
+     <xi:include href="Zend_Application-AvailableResources-Multidb.xml" />
     <xi:include href="Zend_Application-AvailableResources-Navigation.xml"/>
     <xi:include href="Zend_Application-AvailableResources-Navigation.xml"/>
     <xi:include href="Zend_Application-AvailableResources-Router.xml"/>
     <xi:include href="Zend_Application-AvailableResources-Router.xml"/>
     <xi:include href="Zend_Application-AvailableResources-Session.xml"/>
     <xi:include href="Zend_Application-AvailableResources-Session.xml"/>

+ 150 - 329
documentation/manual/es/module_specs/Zend_Db_Table_Row.xml

@@ -10,27 +10,18 @@
         <title>Introducción</title>
         <title>Introducción</title>
 
 
         <para>
         <para>
-            <classname>Zend_Db_Table_Row</classname>
-            is a class that contains an
-            individual row of a
-            <classname>Zend_Db_Table</classname>
-            object.
+            <classname>Zend_Db_Table_Row</classname> is a class that contains an
+            individual row of a <classname>Zend_Db_Table</classname> object.
             When you run a query against a Table class, the result is returned
             When you run a query against a Table class, the result is returned
-            in a set of
-            <classname>Zend_Db_Table_Row</classname>
-            objects. You
+            in a set of <classname>Zend_Db_Table_Row</classname> objects. You
             can also use this object to create new rows and add them to the
             can also use this object to create new rows and add them to the
-            database
-            table.
-        </para>
+            database table. </para>
 
 
         <para>
         <para>
-            <classname>Zend_Db_Table_Row</classname>
-            is an implementation of the
-            <ulink url="http://www.martinfowler.com/eaaCatalog/rowDataGateway.html">Row Data
-                Gateway</ulink>
-            pattern.
-        </para>
+            <classname>Zend_Db_Table_Row</classname> is an implementation of the
+                <ulink
+                url="http://www.martinfowler.com/eaaCatalog/rowDataGateway.html"
+                >Row Data Gateway</ulink> pattern. </para>
 
 
     </sect2>
     </sect2>
 
 
@@ -39,21 +30,12 @@
         <title>Fetching a Row</title>
         <title>Fetching a Row</title>
 
 
         <para>
         <para>
-            <classname>Zend_Db_Table_Abstract</classname>
-            provides methods
-            <methodname>find()</methodname>
-            and
-            <methodname>fetchAll()</methodname>
-            , which each return an object
-            of type
-            <classname>Zend_Db_Table_Rowset</classname>
-            , and the method
-            <methodname>fetchRow()</methodname>
-            , which returns an object of
-            type
-            <classname>Zend_Db_Table_Row</classname>
-            .
-        </para>
+            <classname>Zend_Db_Table_Abstract</classname> provides methods
+                <methodname>find()</methodname> and
+                <methodname>fetchAll()</methodname> , which each return an
+            object of type <classname>Zend_Db_Table_Rowset</classname> , and the
+            method <methodname>fetchRow()</methodname> , which returns an object
+            of type <classname>Zend_Db_Table_Row</classname> . </para>
 
 
         <example id="zend.db.table.row.read.example">
         <example id="zend.db.table.row.read.example">
 
 
@@ -66,16 +48,9 @@ $row = $bugs->fetchRow($bugs->select()->where('bug_id = ?', 1));
 
 
         </example>
         </example>
 
 
-        <para>
-            A
-            <classname>Zend_Db_Table_Rowset</classname>
-            object contains a
-            collection of
-            <classname>Zend_Db_Table_Row</classname>
-            objects. See
-            <xref linkend="zend.db.table.rowset"/>
-            .
-        </para>
+        <para> A <classname>Zend_Db_Table_Rowset</classname> object contains a
+            collection of <classname>Zend_Db_Table_Row</classname> objects. See
+                <xref linkend="zend.db.table.rowset"/> . </para>
 
 
         <example id="zend.db.table.row.read.example-rowset">
         <example id="zend.db.table.row.read.example-rowset">
 
 
@@ -94,12 +69,9 @@ $row = $rowset->current();
             <title>Reading column values from a row</title>
             <title>Reading column values from a row</title>
 
 
             <para>
             <para>
-                <classname>Zend_Db_Table_Row_Abstract</classname>
-                provides
+                <classname>Zend_Db_Table_Row_Abstract</classname> provides
                 accessor methods so you can reference columns in the row as
                 accessor methods so you can reference columns in the row as
-                object
-                properties.
-            </para>
+                object properties. </para>
 
 
             <example id="zend.db.table.row.read.get.example">
             <example id="zend.db.table.row.read.get.example">
 
 
@@ -117,25 +89,15 @@ echo $row->bug_description;
 
 
             <note>
             <note>
 
 
-                <para>
-                    Earlier versions of
-                    <classname>Zend_Db_Table_Row</classname>
-                    mapped these
+                <para> Earlier versions of
+                        <classname>Zend_Db_Table_Row</classname> mapped these
                     column accessors to the database column names using a string
                     column accessors to the database column names using a string
-                    transformation called
-                    <emphasis>inflection</emphasis>
-                    .
-                </para>
-
-                <para>
-                    Currently,
-                    <classname>Zend_Db_Table_Row</classname>
-                    does
+                    transformation called <emphasis>inflection</emphasis> . </para>
+
+                <para> Currently, <classname>Zend_Db_Table_Row</classname> does
                     not implement inflection. Accessed property names need to
                     not implement inflection. Accessed property names need to
-                    match the spelling
-                    of the column names as they appear in
-                    your database.
-                </para>
+                    match the spelling of the column names as they appear in
+                    your database. </para>
 
 
             </note>
             </note>
 
 
@@ -145,14 +107,10 @@ echo $row->bug_description;
 
 
             <title>Retrieving Row Data as an Array</title>
             <title>Retrieving Row Data as an Array</title>
 
 
-            <para>
-                You can access the row's data as an array using the
-                <methodname>toArray()</methodname>
-                method of the Row object.
-                This returns an associative array of the column names to
-                the
-                column values.
-            </para>
+            <para> You can access the row's data as an array using the
+                    <methodname>toArray()</methodname> method of the Row object.
+                This returns an associative array of the column names to the
+                column values. </para>
 
 
             <example id="zend.db.table.row.read.to-array.example">
             <example id="zend.db.table.row.read.to-array.example">
 
 
@@ -174,15 +132,10 @@ foreach ($rowArray as $column => $value) {
 
 
             </example>
             </example>
 
 
-            <para>
-                The array returned from
-                <methodname>toArray()</methodname>
-                is
+            <para> The array returned from <methodname>toArray()</methodname> is
                 not updateable. You can modify values in the array as you can
                 not updateable. You can modify values in the array as you can
-                with any array, but
-                you cannot save changes to this array to the
-                database directly.
-            </para>
+                with any array, but you cannot save changes to this array to the
+                database directly. </para>
 
 
         </sect3>
         </sect3>
 
 
@@ -190,16 +143,10 @@ foreach ($rowArray as $column => $value) {
 
 
             <title>Fetching data from related tables</title>
             <title>Fetching data from related tables</title>
 
 
-            <para>
-                The
-                <classname>Zend_Db_Table_Row_Abstract</classname>
-                class
+            <para> The <classname>Zend_Db_Table_Row_Abstract</classname> class
                 provides methods for fetching rows and rowsets from related
                 provides methods for fetching rows and rowsets from related
-                tables. See
-                <xref linkend="zend.db.table.relationships"/>
-                for
-                more information on table relationships.
-            </para>
+                tables. See <xref linkend="zend.db.table.relationships"/> for
+                more information on table relationships. </para>
 
 
         </sect3>
         </sect3>
 
 
@@ -214,19 +161,13 @@ foreach ($rowArray as $column => $value) {
             <title>Changing column values in a row</title>
             <title>Changing column values in a row</title>
 
 
             <para>You can set individual column values using column accessors,
             <para>You can set individual column values using column accessors,
-                similar to how the
-                columns are read as object properties in the
+                similar to how the columns are read as object properties in the
                 example above.</para>
                 example above.</para>
 
 
-            <para>
-                Using a column accessor to set a value changes the column
-                value of the row object in
-                your application, but it does not
-                commit the change to the database yet. You can do
-                that with the
-                <methodname>save()</methodname>
-                method.
-            </para>
+            <para> Using a column accessor to set a value changes the column
+                value of the row object in your application, but it does not
+                commit the change to the database yet. You can do that with the
+                    <methodname>save()</methodname> method. </para>
 
 
             <example id="zend.db.table.row.write.set.example">
             <example id="zend.db.table.row.write.set.example">
 
 
@@ -251,17 +192,12 @@ $row->save();
 
 
             <title>Inserting a new row</title>
             <title>Inserting a new row</title>
 
 
-            <para>
-                You can create a new row for a given table with the
-                <methodname>createRow()</methodname>
-                method of the table
+            <para> You can create a new row for a given table with the
+                    <methodname>createRow()</methodname> method of the table
                 class. You can access fields of this row with the
                 class. You can access fields of this row with the
-                object-oriented
-                interface, but the row is not stored in the
-                database until you call the
-                <methodname>save()</methodname>
-                method.
-            </para>
+                object-oriented interface, but the row is not stored in the
+                database until you call the <methodname>save()</methodname>
+                method. </para>
 
 
             <example id="zend.db.table.row.write.insert.example">
             <example id="zend.db.table.row.write.insert.example">
 
 
@@ -282,8 +218,7 @@ $newRow->save();
             </example>
             </example>
 
 
             <para>The optional argument to the createRow() method is an
             <para>The optional argument to the createRow() method is an
-                associative array, with which
-                you can populate fields of the new
+                associative array, with which you can populate fields of the new
                 row.</para>
                 row.</para>
 
 
             <example id="zend.db.table.row.write.insert.example2">
             <example id="zend.db.table.row.write.insert.example2">
@@ -307,21 +242,12 @@ $newRow->save();
 
 
             <note>
             <note>
 
 
-                <para>
-                    The
-                    <methodname>createRow()</methodname>
-                    method was
-                    called
-                    <methodname>fetchNew()</methodname>
-                    in earlier
-                    releases of
-                    <classname>Zend_Db_Table</classname>
-                    . You are
+                <para> The <methodname>createRow()</methodname> method was
+                    called <methodname>fetchNew()</methodname> in earlier
+                    releases of <classname>Zend_Db_Table</classname> . You are
                     encouraged to use the new method name, even though the old
                     encouraged to use the new method name, even though the old
-                    name
-                    continues to work for the sake of backward
-                    compatibility.
-                </para>
+                    name continues to work for the sake of backward
+                    compatibility. </para>
 
 
             </note>
             </note>
 
 
@@ -332,16 +258,12 @@ $newRow->save();
             <title>Changing values in multiple columns</title>
             <title>Changing values in multiple columns</title>
 
 
             <para>
             <para>
-                <classname>Zend_Db_Table_Row_Abstract</classname>
-                provides the
-                <methodname>setFromArray()</methodname>
-                method to enable you
+                <classname>Zend_Db_Table_Row_Abstract</classname> provides the
+                    <methodname>setFromArray()</methodname> method to enable you
                 to set several columns in a single row at once, specified in an
                 to set several columns in a single row at once, specified in an
                 associative array that maps the column names to values. You may
                 associative array that maps the column names to values. You may
-                find this method
-                convenient for setting values both for new rows
-                and for rows you need to update.
-            </para>
+                find this method convenient for setting values both for new rows
+                and for rows you need to update. </para>
 
 
             <example id="zend.db.table.row.write.set-from-array.example">
             <example id="zend.db.table.row.write.set-from-array.example">
 
 
@@ -373,14 +295,9 @@ $newRow->save();
 
 
             <title>Deleting a row</title>
             <title>Deleting a row</title>
 
 
-            <para>
-                You can call the
-                <methodname>delete()</methodname>
-                method on
+            <para> You can call the <methodname>delete()</methodname> method on
                 a Row object. This deletes rows in the database matching the
                 a Row object. This deletes rows in the database matching the
-                primary key in
-                the Row object.
-            </para>
+                primary key in the Row object. </para>
 
 
             <example id="zend.db.table.row.write.delete.example">
             <example id="zend.db.table.row.write.delete.example">
 
 
@@ -396,13 +313,9 @@ $row->delete();
 
 
             </example>
             </example>
 
 
-            <para>
-                You do not have to call
-                <methodname>save()</methodname>
-                to
+            <para> You do not have to call <methodname>save()</methodname> to
                 apply the delete; it is executed against the database
                 apply the delete; it is executed against the database
-                immediately.
-            </para>
+                immediately. </para>
 
 
         </sect3>
         </sect3>
 
 
@@ -412,32 +325,21 @@ $row->delete();
 
 
         <title>Serializing and unserializing rows</title>
         <title>Serializing and unserializing rows</title>
 
 
-        <para>
-            It is often convenient to save the contents of a database row to
-            be used later.
-            <emphasis>Serialization</emphasis>
-            is the name for
+        <para> It is often convenient to save the contents of a database row to
+            be used later. <emphasis>Serialization</emphasis> is the name for
             the operation that converts an object into a form that is easy to
             the operation that converts an object into a form that is easy to
-            save in
-            offline storage (for example, a file). Objects of type
-            <classname>Zend_Db_Table_Row_Abstract</classname>
-            are
-            serializable.
-        </para>
+            save in offline storage (for example, a file). Objects of type
+                <classname>Zend_Db_Table_Row_Abstract</classname> are
+            serializable. </para>
 
 
         <sect3 id="zend.db.table.row.serialize.serializing">
         <sect3 id="zend.db.table.row.serialize.serializing">
 
 
             <title>Serializing a Row</title>
             <title>Serializing a Row</title>
 
 
-            <para>
-                Simply use
-                <acronym>PHP</acronym>
-                's
-                <methodname>serialize()</methodname>
-                function to create a
+            <para> Simply use <acronym>PHP</acronym> 's
+                    <methodname>serialize()</methodname> function to create a
                 string containing a byte-stream representation of the Row object
                 string containing a byte-stream representation of the Row object
-                argument.
-            </para>
+                argument. </para>
 
 
             <example id="zend.db.table.row.serialize.serializing.example">
             <example id="zend.db.table.row.serialize.serializing.example">
 
 
@@ -461,25 +363,15 @@ $serializedRow = serialize($row);
 
 
             <title>Unserializing Row Data</title>
             <title>Unserializing Row Data</title>
 
 
-            <para>
-                Use PHP's
-                <methodname>unserialize()</methodname>
-                function to
+            <para> Use PHP's <methodname>unserialize()</methodname> function to
                 restore a string containing a byte-stream representation of an
                 restore a string containing a byte-stream representation of an
-                object. The
-                function returns the original object.
-            </para>
+                object. The function returns the original object. </para>
 
 
-            <para>
-                Note that the Row object returned is in a
-                <emphasis>disconnected</emphasis>
-                state. You can read the
-                Row object and its properties, but you cannot change values
-                in
+            <para> Note that the Row object returned is in a
+                    <emphasis>disconnected</emphasis> state. You can read the
+                Row object and its properties, but you cannot change values in
                 the Row or execute other methods that require a database
                 the Row or execute other methods that require a database
-                connection (for example,
-                queries against related tables).
-            </para>
+                connection (for example, queries against related tables). </para>
 
 
             <example id="zend.db.table.row.serialize.unserializing.example">
             <example id="zend.db.table.row.serialize.unserializing.example">
 
 
@@ -498,20 +390,16 @@ echo $rowClone->bug_description;
 
 
                 <title>Why do Rows unserialize in a disconnected state?</title>
                 <title>Why do Rows 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
+                <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
                     easily read by potential attackers. The reader of the
                     serialized object should not be able to use it to gain
                     serialized object should not be able to use it to gain
-                    access to your database
-                    without knowing valid credentials.</para>
+                    access to your database without knowing valid
+                    credentials.</para>
 
 
             </note>
             </note>
 
 
@@ -521,21 +409,14 @@ echo $rowClone->bug_description;
 
 
             <title>Reactivating a Row as Live Data</title>
             <title>Reactivating a Row as Live Data</title>
 
 
-            <para>
-                You can reactivate a disconnected Row, using the
-                <methodname>setTable()</methodname>
-                method. The argument to
+            <para> You can reactivate a disconnected Row, using the
+                    <methodname>setTable()</methodname> method. The argument to
                 this method is a valid object of type
                 this method is a valid object of type
-                <classname>Zend_Db_Table_Abstract</classname>
-                , which you
+                    <classname>Zend_Db_Table_Abstract</classname> , which you
                 create. Creating a Table object requires a live connection to
                 create. Creating a Table object requires a live connection to
-                the
-                database, so by reassociating the Table with the Row, the
-                Row gains access to the
-                database. Subsequently, you can change
-                values in the Row object and save the changes
-                to the database.
-            </para>
+                the database, so by reassociating the Table with the Row, the
+                Row gains access to the database. Subsequently, you can change
+                values in the Row object and save the changes to the database. </para>
 
 
             <example id="zend.db.table.row.serialize.set-table.example">
             <example id="zend.db.table.row.serialize.set-table.example">
 
 
@@ -566,22 +447,14 @@ $rowClone->save();
         <title>Extending the Row class</title>
         <title>Extending the Row class</title>
 
 
         <para>
         <para>
-            <classname>Zend_Db_Table_Row</classname>
-            is the default concrete
-            class that extends
-            <classname>Zend_Db_Table_Row_Abstract</classname>
-            . You can define
-            your own concrete class for instances of Row by extending
-            <classname>Zend_Db_Table_Row_Abstract</classname>
-            . To use your
-            new Row class to store results of Table queries, specify the custom
-            Row
-            class by name either in the
-            <varname>$_rowClass</varname>
+            <classname>Zend_Db_Table_Row</classname> is the default concrete
+            class that extends <classname>Zend_Db_Table_Row_Abstract</classname>
+            . You can define your own concrete class for instances of Row by
+            extending <classname>Zend_Db_Table_Row_Abstract</classname> . To use
+            your new Row class to store results of Table queries, specify the
+            custom Row class by name either in the <varname>$_rowClass</varname>
             protected member of a Table class, or in the array argument of the
             protected member of a Table class, or in the array argument of the
-            constructor of a Table
-            object.
-        </para>
+            constructor of a Table object. </para>
 
 
         <example id="zend.db.table.row.extending.example">
         <example id="zend.db.table.row.extending.example">
 
 
@@ -612,19 +485,13 @@ $bugs = new Bugs(array('rowClass' => 'MyRow'));
 
 
             <title>Row initialization</title>
             <title>Row initialization</title>
 
 
-            <para>
-                If application-specific logic needs to be initialized when a
-                row is constructed, you
-                can select to move your tasks to the
-                <methodname>init()</methodname>
-                method, which is called
-                after all row metadata has been processed. This is
-                recommended
-                over the
-                <methodname>__construct</methodname>
-                method if you do
-                not need to alter the metadata in any programmatic way.
-                <example id="zend.db.table.row.init.usage.example">
+            <para> If application-specific logic needs to be initialized when a
+                row is constructed, you can select to move your tasks to the
+                    <methodname>init()</methodname> method, which is called
+                after all row metadata has been processed. This is recommended
+                over the <methodname>__construct</methodname> method if you do
+                not need to alter the metadata in any programmatic way. <example
+                    id="zend.db.table.row.init.usage.example">
 
 
                     <title>Example usage of init() method</title>
                     <title>Example usage of init() method</title>
 
 
@@ -650,44 +517,26 @@ class MyApplicationRow extends Zend_Db_Table_Row_Abstract
             <title>Defining Custom Logic for Insert, Update, and Delete in
             <title>Defining Custom Logic for Insert, Update, and Delete in
                 Zend_Db_Table_Row</title>
                 Zend_Db_Table_Row</title>
 
 
-            <para>
-                The Row class calls protected methods
-                <methodname>_insert()</methodname>
-                ,
-                <methodname>_update()</methodname>
-                , and
-                <methodname>_delete()</methodname>
-                before performing the
-                corresponding operations
-                <methodname>INSERT</methodname>
-                ,
-                <methodname>UPDATE</methodname>
-                , and
-                <methodname>DELETE</methodname>
-                . You can add logic to these
-                methods in your custom Row subclass.
-            </para>
-
-            <para>
-                If you need to do custom logic in a specific table, and the
-                custom logic must occur
-                for every operation on that table, it
-                may make more sense to implement your custom
-                code in the
-                <methodname>insert()</methodname>
-                ,
-                <methodname>update()</methodname>
-                and
-                <methodname>delete()</methodname>
-                methods of your Table
-                class. However, sometimes it may be necessary to do custom
-                logic
-                in the Row class.
-            </para>
+            <para> The Row class calls protected methods
+                    <methodname>_insert()</methodname> ,
+                    <methodname>_update()</methodname> , and
+                    <methodname>_delete()</methodname> before performing the
+                corresponding operations <methodname>INSERT</methodname> ,
+                    <methodname>UPDATE</methodname> , and
+                    <methodname>DELETE</methodname> . You can add logic to these
+                methods in your custom Row subclass. </para>
+
+            <para> If you need to do custom logic in a specific table, and the
+                custom logic must occur for every operation on that table, it
+                may make more sense to implement your custom code in the
+                    <methodname>insert()</methodname> ,
+                    <methodname>update()</methodname> and
+                    <methodname>delete()</methodname> methods of your Table
+                class. However, sometimes it may be necessary to do custom logic
+                in the Row class. </para>
 
 
             <para>Below are some example cases where it might make sense to
             <para>Below are some example cases where it might make sense to
-                implement custom logic in
-                a Row class instead of in the Table
+                implement custom logic in a Row class instead of in the Table
                 class:</para>
                 class:</para>
 
 
             <example id="zend.db.table.row.extending.overriding-example1">
             <example id="zend.db.table.row.extending.overriding-example1">
@@ -695,22 +544,16 @@ class MyApplicationRow extends Zend_Db_Table_Row_Abstract
                 <title>Example of custom logic in a Row class</title>
                 <title>Example of custom logic in a Row class</title>
 
 
                 <para>The custom logic may not apply in all cases of operations
                 <para>The custom logic may not apply in all cases of operations
-                    on the respective
-                    Table. You can provide custom logic on
-                    demand by implementing it in a Row class
-                    and creating an
+                    on the respective Table. You can provide custom logic on
+                    demand by implementing it in a Row class and creating an
                     instance of the Table class with that custom Row class
                     instance of the Table class with that custom Row class
-                    specified.
-                    Otherwise, the Table uses the default Row class.</para>
-
-                <para>
-                    You need data operations on this table to record the
-                    operation to a
-                    <classname>Zend_Log</classname>
-                    object, but
+                    specified. Otherwise, the Table uses the default Row
+                    class.</para>
+
+                <para> You need data operations on this table to record the
+                    operation to a <classname>Zend_Log</classname> object, but
                     only if the application configuration has enabled this
                     only if the application configuration has enabled this
-                    behavior.
-                </para>
+                    behavior. </para>
 
 
                 <programlisting language="php"><![CDATA[
                 <programlisting language="php"><![CDATA[
 class MyLoggingRow extends Zend_Db_Table_Row_Abstract
 class MyLoggingRow extends Zend_Db_Table_Row_Abstract
@@ -741,14 +584,11 @@ if ($loggingEnabled) {
                 <title>Example of a Row class that logs insert data for multiple
                 <title>Example of a Row class that logs insert data for multiple
                     tables</title>
                     tables</title>
 
 
-                <para>The custom logic may be common to multiple tables.
-                    Instead of implementing the
-                    same custom logic in every one
-                    of your Table classes, you can implement the code
-                    for such
-                    actions in the definition of a Row class, and use this Row
-                    in each of
-                    your Table classes.</para>
+                <para>The custom logic may be common to multiple tables. Instead
+                    of implementing the same custom logic in every one of your
+                    Table classes, you can implement the code for such actions
+                    in the definition of a Row class, and use this Row in each
+                    of your Table classes.</para>
 
 
                 <para>In this example, the logging code is identical in all
                 <para>In this example, the logging code is identical in all
                     table classes.</para>
                     table classes.</para>
@@ -787,49 +627,31 @@ class Products extends Zend_Db_Table_Abstract
 
 
             <title>Define Inflection in Zend_Db_Table_Row</title>
             <title>Define Inflection in Zend_Db_Table_Row</title>
 
 
-            <para>
-                Some people prefer that the table class name match a table
-                name in the
-                <acronym>RDBMS</acronym>
-                by using a string
-                transformation called
-                <emphasis>inflection</emphasis>
-                .
-            </para>
-
-            <para>
-                <classname>Zend_Db</classname>
-                classes do not implement
-                inflection by default. See
-                <xref linkend="zend.db.table.extending.inflection"/>
-                for an
-                explanation of this policy.
-            </para>
+            <para> Some people prefer that the table class name match a table
+                name in the <acronym>RDBMS</acronym> by using a string
+                transformation called <emphasis>inflection</emphasis> . </para>
 
 
             <para>
             <para>
-                If you prefer to use inflection, then you must implement the
-                transformation yourself,
-                by overriding the
-                <methodname>_transformColumn()</methodname>
-                method in a
+                <classname>Zend_Db</classname> classes do not implement
+                inflection by default. See <xref
+                    linkend="zend.db.table.extending.inflection"/> for an
+                explanation of this policy. </para>
+
+            <para> If you prefer to use inflection, then you must implement the
+                transformation yourself, by overriding the
+                    <methodname>_transformColumn()</methodname> method in a
                 custom Row class, and using that custom Row class when you
                 custom Row class, and using that custom Row class when you
-                perform queries
-                against your Table class.
-            </para>
+                perform queries against your Table class. </para>
 
 
             <example id="zend.db.table.row.extending.inflection.example">
             <example id="zend.db.table.row.extending.inflection.example">
 
 
                 <title>Example of defining an inflection transformation</title>
                 <title>Example of defining an inflection transformation</title>
 
 
-                <para>
-                    This allows you to use an inflected version of the column
-                    name in the accessors.
-                    The Row class uses the
-                    <methodname>_transformColumn()</methodname>
-                    method to
+                <para> This allows you to use an inflected version of the column
+                    name in the accessors. The Row class uses the
+                        <methodname>_transformColumn()</methodname> method to
                     change the name you use to the native column name in the
                     change the name you use to the native column name in the
-                    database table.
-                </para>
+                    database table. </para>
 
 
                 <programlisting language="php"><![CDATA[
                 <programlisting language="php"><![CDATA[
 class MyInflectedRow extends Zend_Db_Table_Row_Abstract
 class MyInflectedRow extends Zend_Db_Table_Row_Abstract
@@ -859,8 +681,7 @@ $row->bugDescription = 'New description';
             </example>
             </example>
 
 
             <para>You are responsible for writing the functions to perform
             <para>You are responsible for writing the functions to perform
-                inflection transformation.
-                Zend Framework does not provide such
+                inflection transformation. Zend Framework does not provide such
                 a function.</para>
                 a function.</para>
 
 
         </sect3>
         </sect3>

File diff suppressed because it is too large
+ 227 - 445
documentation/manual/es/module_specs/Zend_Dojo-Form-Elements.xml


+ 240 - 340
documentation/manual/es/module_specs/Zend_Dojo-View-Dojo.xml

@@ -1,20 +1,17 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 17987 -->
+<!-- EN-Revision: 20143 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect2 id="zend.dojo.view.dojo">
 <sect2 id="zend.dojo.view.dojo">
     <title>dojo() Ayudante de Vista</title>
     <title>dojo() Ayudante de Vista</title>
 
 
-    <para>
-        El ayudante de vista
-        <methodname>dojo()</methodname>
-        está destinado a simplificar el
-        establecimiento del medio ambiente de Dojo, incluyendo las
-        siguientes responsabilidades:
-    </para>
+    <para> El ayudante de vista <methodname>dojo()</methodname> está destinado a
+        simplificar el establecimiento del medio ambiente de Dojo, incluyendo
+        las siguientes responsabilidades: </para>
 
 
     <itemizedlist>
     <itemizedlist>
         <listitem>
         <listitem>
-            <para>Especificar bien un CDN o un path local para instalar Dojo.</para>
+            <para>Especificar bien un CDN o un path local para instalar
+                Dojo.</para>
         </listitem>
         </listitem>
         <listitem>
         <listitem>
             <para>Especificando paths a módulos Dojo personalizados.</para>
             <para>Especificando paths a módulos Dojo personalizados.</para>
@@ -30,41 +27,39 @@
         </listitem>
         </listitem>
     </itemizedlist>
     </itemizedlist>
 
 
-    <para>
-        La implementación del ayudante de vista
-        <methodname>dojo()</methodname>
-        es un ejemplo de
-        implementación de un marcador de posición. El conjunto de datos en él,
-        persiste entre los
+    <para> La implementación del ayudante de vista
+            <methodname>dojo()</methodname> es un ejemplo de implementación de
+        un marcador de posición. El conjunto de datos en él, persiste entre los
         objetos vista y puede ser directamente activado con en "echo" de
         objetos vista y puede ser directamente activado con en "echo" de
-        <acronym>PHP</acronym>
-        desde su script.
-    </para>
+            <acronym>PHP</acronym> desde su script. </para>
 
 
     <example id="zend.dojo.view.dojo.usage">
     <example id="zend.dojo.view.dojo.usage">
         <title>dojo() Ejemplo de Uso del Ayudante de Vista</title>
         <title>dojo() Ejemplo de Uso del Ayudante de Vista</title>
 
 
-        <para>En este ejemplo, asumamos que el desarrollador estará usando Dojo desde un path
-            local,
-            se necesitarán varios dijits, y se utilizará el tema de dijit Tundra.</para>
+        <para>En este ejemplo, asumamos que el desarrollador estará usando Dojo
+            desde un path local, se necesitarán varios dijits, y se utilizará el
+            tema de dijit Tundra.</para>
 
 
-        <para>En muchas páginas, el desarrollador no podrá utilizar Dojo para nada. Así, vamos a
-            centrarnos primero en un view script donde Dojo es necesario y luego en el layout
-            script, en donde vamos a configurar algo del medio ambiente de Dojo y luego lo
+        <para>En muchas páginas, el desarrollador no podrá utilizar Dojo para
+            nada. Así, vamos a centrarnos primero en un view script donde Dojo
+            es necesario y luego en el layout script, en donde vamos a
+            configurar algo del medio ambiente de Dojo y luego lo
             mostraremos.</para>
             mostraremos.</para>
 
 
-        <para>En primer lugar, tenemos que decir nuestro objeto vista que utilice el path del
-            ayudante de vista de Dojo. Esto puede hacerse en el arranque o en un plugin de ejecución
-            temprana; simplemente apoderarse de su objeto vista y ejecutar lo siguiente:</para>
+        <para>En primer lugar, tenemos que decir nuestro objeto vista que
+            utilice el path del ayudante de vista de Dojo. Esto puede hacerse en
+            el arranque o en un plugin de ejecución temprana; simplemente
+            apoderarse de su objeto vista y ejecutar lo siguiente:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $view->addHelperPath('Zend/Dojo/View/Helper/', 'Zend_Dojo_View_Helper');
 $view->addHelperPath('Zend/Dojo/View/Helper/', 'Zend_Dojo_View_Helper');
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>El paso siguiente, el view script. En este caso, vamos a especificar que vamos a
-            estar
-            utilizando un FilteringSelect -- que consumirá un almacén personalizado basado en
-            QueryReadStore, al que llamamos 'PairedStore' y almacenado en nuestro módulo 'custom'.</para>
+        <para>El paso siguiente, el view script. En este caso, vamos a
+            especificar que vamos a estar utilizando un FilteringSelect -- que
+            consumirá un almacén personalizado basado en QueryReadStore, al que
+            llamamos 'PairedStore' y almacenado en nuestro módulo
+            'custom'.</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 <?php // establecer el data store para FilteringSelect ?>
 <?php // establecer el data store para FilteringSelect ?>
@@ -84,9 +79,9 @@ $this->dojo()->enable()
              ->requireModule('custom.PairedStore'); ?>
              ->requireModule('custom.PairedStore'); ?>
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>En nuestro script de esquema, vamos entonces a comprobar si Dojo está habilitado, y
-            si
-            es así, haremos algunas configuraciones más generales y lo ensamblaremos:</para>
+        <para>En nuestro script de esquema, vamos entonces a comprobar si Dojo
+            está habilitado, y si es así, haremos algunas configuraciones más
+            generales y lo ensamblaremos:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 <?php echo $this->doctype() ?>
 <?php echo $this->doctype() ?>
@@ -111,94 +106,91 @@ $this->dojo()->enable()
 </html>
 </html>
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>En este punto, sólo necesita asegurarse de que sus archivos están en el lugar
-            correcto
-            y que ha creado el punto final de acción para su FilteringSelect!</para>
+        <para>En este punto, sólo necesita asegurarse de que sus archivos están
+            en el lugar correcto y que ha creado el punto final de acción para
+            su FilteringSelect!</para>
     </example>
     </example>
 
 
-    <sect3 id="zend.dojo.view.dojo.declarative">
-        <title>Uso Programático y Declarativo de Dojo</title>
-
+    <note>
+        <title>UTF-8 encoding used by default</title>
+        
         <para>
         <para>
-            Dojo permite usar a ambos
-            <emphasis>declarative</emphasis>
-            y
-            <emphasis>programmatic</emphasis>
-            en muchas de sus características. El uso de
-            <emphasis>Declarative</emphasis>
-            utiliza elementos
-            <acronym>HTML</acronym>
-            con atributos no estándar
-            que se parsean cuando la página se está cargado. Mientras que
-            ésta es una sintaxis
-            poderosa y simple de utilizar, para muchos desarrolladores esto
-            puede causar problemas
-            con la validación de páginas.
+            By default, Zend Framework uses <acronym>UTF-8</acronym> as its default encoding, and,
+            specific to this case, <classname>Zend_View</classname> does as well. Character encoding
+            can be set differently on the view object itself using the
+            <methodname>setEncoding()</methodname> method (or the the <varname>encoding</varname>
+            instantiation parameter). However, since <classname>Zend_View_Interface</classname> does
+            not define accessors for encoding, it's possible that if you are using a custom view
+            implementation with the Dojo view helper, you will not have a
+            <methodname>getEncoding()</methodname> method, which is what the view helper uses
+            internally for determining the character set in which to encode.
         </para>
         </para>
-
-        <para>
-            El uso de
-            <emphasis>Programmatic</emphasis>
-            permite al desarrollador decorar los
-            elementos existentes tirando de ellos por ID o
-            selectores
-            <acronym>CSS</acronym>
-            y
-            pasarlos a los constructores apropiados de objetos en Dojo. Debido a que no se usan
-            atributos
-            <acronym>HTML</acronym>
-            no standard, las páginas continúan con la validación.
-        </para>
-
+        
         <para>
         <para>
-            En la práctica, ambos casos de uso permiten una degradación elegante cuando
-            javascript
-            está desactivado o los diversos recursos de Dojo script están fuera de
-            alcance. Para
-            promover las normas y validación de documentos, Zend Framework hace uso de
-            los usos
-            programáticos por defecto; los diversos ayudantes de vista generarán javascript
-            y lo
-            empujan al ayudante de vista
-            <methodname>dojo()</methodname>
-            para su inclusión
-            cuando sean presentados.
+            If you do not want to utilize <acronym>UTF-8</acronym> in such a situation, you will
+            need to implement a <methodname>getEncoding()</methodname> method in your custom view
+            implementation.
         </para>
         </para>
+    </note>
+    
+    <sect3 id="zend.dojo.view.dojo.declarative">
+        <title>Uso Programático y Declarativo de Dojo</title>
 
 
-        <para>Utilizando esta técnica los desarrolladores pueden también desear explorar la
-            posibilidad de escribir sus propia decoración programática de la página. Uno de los
-            beneficios sería la posibilidad de especificar handlers para eventos dijit.</para>
-
-        <para>Para permitir esto, así como la posibilidad de usar sintaxis declarativa, hay
-            disponibles una serie de métodos estáticos para establecer globamente este
-            comportamiento.</para>
+        <para> Dojo permite usar a ambos <emphasis>declarative</emphasis> y
+                <emphasis>programmatic</emphasis> en muchas de sus
+            características. El uso de <emphasis>Declarative</emphasis> utiliza
+            elementos <acronym>HTML</acronym> con atributos no estándar que se
+            parsean cuando la página se está cargado. Mientras que ésta es una
+            sintaxis poderosa y simple de utilizar, para muchos desarrolladores
+            esto puede causar problemas con la validación de páginas. </para>
+
+        <para> El uso de <emphasis>Programmatic</emphasis> permite al
+            desarrollador decorar los elementos existentes tirando de ellos por
+            ID o selectores <acronym>CSS</acronym> y pasarlos a los
+            constructores apropiados de objetos en Dojo. Debido a que no se usan
+            atributos <acronym>HTML</acronym> no standard, las páginas continúan
+            con la validación. </para>
+
+        <para> En la práctica, ambos casos de uso permiten una degradación
+            elegante cuando javascript está desactivado o los diversos recursos
+            de Dojo script están fuera de alcance. Para promover las normas y
+            validación de documentos, Zend Framework hace uso de los usos
+            programáticos por defecto; los diversos ayudantes de vista generarán
+            javascript y lo empujan al ayudante de vista
+                <methodname>dojo()</methodname> para su inclusión cuando sean
+            presentados. </para>
+
+        <para>Utilizando esta técnica los desarrolladores pueden también desear
+            explorar la posibilidad de escribir sus propia decoración
+            programática de la página. Uno de los beneficios sería la
+            posibilidad de especificar handlers para eventos dijit.</para>
+
+        <para>Para permitir esto, así como la posibilidad de usar sintaxis
+            declarativa, hay disponibles una serie de métodos estáticos para
+            establecer globamente este comportamiento.</para>
 
 
         <example id="zend.dojo.view.dojo.declarative.usage">
         <example id="zend.dojo.view.dojo.declarative.usage">
-            <title>Especificando el Uso Declarativo y Programático de Dojo</title>
+            <title>Especificando el Uso Declarativo y Programático de
+                Dojo</title>
 
 
-            <para>
-                Para especificar el uso declarativo, simplemente llame al método estático
-                <methodname>setUseDeclarative()</methodname>
-                :
-            </para>
+            <para> Para especificar el uso declarativo, simplemente llame al
+                método estático <methodname>setUseDeclarative()</methodname> : </para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 Zend_Dojo_View_Helper_Dojo::setUseDeclarative();
 Zend_Dojo_View_Helper_Dojo::setUseDeclarative();
 ]]></programlisting>
 ]]></programlisting>
 
 
-            <para>
-                Si decide más bien utilizar el uso programático, llame al método estático
-                <methodname>setUseProgrammatic()</methodname>
-                :
-            </para>
+            <para> Si decide más bien utilizar el uso programático, llame al
+                método estático <methodname>setUseProgrammatic()</methodname> : </para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 Zend_Dojo_View_Helper_Dojo::setUseProgrammatic();
 Zend_Dojo_View_Helper_Dojo::setUseProgrammatic();
 ]]></programlisting>
 ]]></programlisting>
 
 
-            <para>Por último, si quiere crear sus propias normas programáticas, debe especificar el
-                uso programático, pero al pasarle el valor '-1'; en esta situación, no se creará
-                ningún javascript para decorar cualquier dijit usado.</para>
+            <para>Por último, si quiere crear sus propias normas programáticas,
+                debe especificar el uso programático, pero al pasarle el valor
+                '-1'; en esta situación, no se creará ningún javascript para
+                decorar cualquier dijit usado.</para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 Zend_Dojo_View_Helper_Dojo::setUseProgrammatic(-1);
 Zend_Dojo_View_Helper_Dojo::setUseProgrammatic(-1);
@@ -209,25 +201,22 @@ Zend_Dojo_View_Helper_Dojo::setUseProgrammatic(-1);
     <sect3 id="zend.dojo.view.dojo.themes">
     <sect3 id="zend.dojo.view.dojo.themes">
         <title>Temas</title>
         <title>Temas</title>
 
 
-        <para>Dojo permite la creación de los temas de su dijits (widgets). Puede seleccionar uno
-            pasándolo en un path de módulo:</para>
+        <para>Dojo permite la creación de los temas de su dijits (widgets).
+            Puede seleccionar uno pasándolo en un path de módulo:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $view->dojo()->addStylesheetModule('dijit.themes.tundra');
 $view->dojo()->addStylesheetModule('dijit.themes.tundra');
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            La ruta del módulo es descubierta por utilizar el carácter '.' como separador de
-            directorio y utilizando el último valor en la lista como el nombre del archivo
-            <acronym>CSS</acronym>
-            en ese directorio del tema a usar; en el ejemplo de arriba,
-            Dojo buscará el tema en
-            'dijit/themes/tundra/tundra.css'.
-        </para>
+        <para> La ruta del módulo es descubierta por utilizar el carácter '.'
+            como separador de directorio y utilizando el último valor en la
+            lista como el nombre del archivo <acronym>CSS</acronym> en ese
+            directorio del tema a usar; en el ejemplo de arriba, Dojo buscará el
+            tema en 'dijit/themes/tundra/tundra.css'. </para>
 
 
-        <para>Cuando se utiliza un tema, es importante recordar pasar la calse del tema a, por lo
-            menos un contenedor rodeando cualquier dijits que se utilice; el caso de uso más común
-            es pasárselo en el body:</para>
+        <para>Cuando se utiliza un tema, es importante recordar pasar la calse
+            del tema a, por lo menos un contenedor rodeando cualquier dijits que
+            se utilice; el caso de uso más común es pasárselo en el body:</para>
 
 
         <programlisting language="html"><![CDATA[
         <programlisting language="html"><![CDATA[
 <body class="tundra">
 <body class="tundra">
@@ -237,378 +226,289 @@ $view->dojo()->addStylesheetModule('dijit.themes.tundra');
     <sect3 id="zend.dojo.view.dojo.layers">
     <sect3 id="zend.dojo.view.dojo.layers">
         <title>Usando Layers (Construcciones Personalizadas)</title>
         <title>Usando Layers (Construcciones Personalizadas)</title>
 
 
-        <para>Por defecto, cuando utilice uns sentencia dojo.require, dojo hará una solicitud de
-            retorno al servidor para agarrar al archivo javascript apropiado. Si hay muchos dijits
-            en el lugar, esto se traduce en muchas peticiones al servidor -- lo que no es óptimo.</para>
+        <para>Por defecto, cuando utilice uns sentencia dojo.require, dojo hará
+            una solicitud de retorno al servidor para agarrar al archivo
+            javascript apropiado. Si hay muchos dijits en el lugar, esto se
+            traduce en muchas peticiones al servidor -- lo que no es
+            óptimo.</para>
 
 
-        <para>
-            La respuesta de Dojo a esto es proporcionar la capacidad de crear
-            <emphasis>custom
-                builds (construcciones personalizadas</emphasis>
-            . Las contrucciones hacen varias
-            cosas:
-        </para>
+        <para> La respuesta de Dojo a esto es proporcionar la capacidad de crear
+                <emphasis>custom builds (construcciones
+                personalizadas</emphasis> . Las contrucciones hacen varias
+            cosas: </para>
 
 
         <itemizedlist>
         <itemizedlist>
             <listitem>
             <listitem>
-                <para>
-                    Grupos de archivos necesarios en
-                    <emphasis>layers</emphasis>
-                    ; una capa
-                    (layer) agrupa a todos archivos necesarios en un único archivo JS. (De
-                    ahí el
-                    nombre de esta sección.)
-                </para>
+                <para> Grupos de archivos necesarios en
+                        <emphasis>layers</emphasis> ; una capa (layer) agrupa a
+                    todos archivos necesarios en un único archivo JS. (De ahí el
+                    nombre de esta sección.) </para>
             </listitem>
             </listitem>
 
 
             <listitem>
             <listitem>
-                <para>"Interns" no son archivos javascript usados por dijits (típicamente, archivos
-                    de plantilla). También están agrupados en el mismo archivo JS como la capa.
-               </para>
+                <para>"Interns" no son archivos javascript usados por dijits
+                    (típicamente, archivos de plantilla). También están
+                    agrupados en el mismo archivo JS como la capa. </para>
             </listitem>
             </listitem>
 
 
             <listitem>
             <listitem>
-                <para>Pasa el archivo a través de ShrinkSafe, que elimina espacios en blanco y
-                    comentarios, así como acorta nombres de variables.</para>
+                <para>Pasa el archivo a través de ShrinkSafe, que elimina
+                    espacios en blanco y comentarios, así como acorta nombres de
+                    variables.</para>
             </listitem>
             </listitem>
         </itemizedlist>
         </itemizedlist>
 
 
-        <para>Algunos archivos pueden no ser superpuestos, pero el proceso creará una versión
-            especial del directorio con la archivo capa y todos los otros archivos. Esto le permite
-            tener una distribución reducida adaptada a su sitio o necesidades de aplicación.</para>
+        <para>Algunos archivos pueden no ser superpuestos, pero el proceso
+            creará una versión especial del directorio con la archivo capa y
+            todos los otros archivos. Esto le permite tener una distribución
+            reducida adaptada a su sitio o necesidades de aplicación.</para>
 
 
-        <para>
-            Para usar una capa, el ayudante de vista
-            <methodname>dojo()</methodname>
-            tiene el
-            método
-            <methodname>addLayer()</methodname>
-            para añadir paths de capas requeridas:
-        </para>
+        <para> Para usar una capa, el ayudante de vista
+                <methodname>dojo()</methodname> tiene el método
+                <methodname>addLayer()</methodname> para añadir paths de capas
+            requeridas: </para>
 
 
         <programlisting language="html"><![CDATA[
         <programlisting language="html"><![CDATA[
 $view->dojo()->addLayer('/js/foo/foo.js');
 $view->dojo()->addLayer('/js/foo/foo.js');
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Para más información sobre la creación de construcciones personalizadas, por favor
-            <ulink
+        <para> Para más información sobre la creación de construcciones
+            personalizadas, por favor <ulink
                 url="http://dojotoolkit.org/book/dojo-book-0-9/part-4-meta-dojo/package-system-and-custom-builds"
                 url="http://dojotoolkit.org/book/dojo-book-0-9/part-4-meta-dojo/package-system-and-custom-builds"
-            > consulte la docuemntación de Build de Dojo</ulink>
-            .
-        </para>
+                > consulte la docuemntación de Build de Dojo</ulink> . </para>
     </sect3>
     </sect3>
 
 
     <sect3 id="zend.dojo.view.dojo.methods">
     <sect3 id="zend.dojo.view.dojo.methods">
         <title>Métodos Disponibles</title>
         <title>Métodos Disponibles</title>
 
 
-        <para>
-            El ayudante de vista
-            <methodname>dojo()</methodname>
-            siempre devuelve una instancia
-            del contenedor del marcador de posición dojo. Ese objeto
-            contenedor dispone de los
-            siguientes métodos:
-        </para>
+        <para> El ayudante de vista <methodname>dojo()</methodname> siempre
+            devuelve una instancia del contenedor del marcador de posición dojo.
+            Ese objeto contenedor dispone de los siguientes métodos: </para>
 
 
         <itemizedlist>
         <itemizedlist>
             <listitem>
             <listitem>
                 <para>
                 <para>
                     <methodname>setView(Zend_View_Interface $view)</methodname>
                     <methodname>setView(Zend_View_Interface $view)</methodname>
-                    : establecer una
-                    instancia de vista en el contenedor.
+                    : establecer una instancia de vista en el contenedor.
                 </para>
                 </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>enable()</methodname>
-                    : habilitar explícitamente la integración de
-                    Dojo.
-                </para>
+                    <methodname>enable()</methodname> : habilitar explícitamente
+                    la integración de Dojo. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>disable()</methodname>
-                    : deshabilitar la integración de
-                    Dojo.
-                </para>
+                    <methodname>disable()</methodname> : deshabilitar la
+                    integración de Dojo. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>isEnabled()</methodname>
-                    : determinar cuándo la integración de Dojo
-                    está habilitada o no.
-                </para>
+                    <methodname>isEnabled()</methodname> : determinar cuándo la
+                    integración de Dojo está habilitada o no. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>requireModule($module)</methodname>
-                    : establecer una sentencia
-                    <methodname>dojo.require</methodname>
+                    <methodname>requireModule($module)</methodname> : establecer
+                    una sentencia <methodname>dojo.require</methodname>
                 </para>
                 </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getModules()</methodname>
-                    : determinar qué módulos han sido
-                    requeridos.
-                </para>
+                    <methodname>getModules()</methodname> : determinar qué
+                    módulos han sido requeridos. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
                     <methodname>registerModulePath($module, $path)</methodname>
                     <methodname>registerModulePath($module, $path)</methodname>
-                    : registrar un path
-                    de un módulo personalizado de Dojo.
+                    : registrar un path de un módulo personalizado de Dojo.
                 </para>
                 </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getModulePaths()</methodname>
-                    : obtener la lista de los paths de
-                    módulos registrados.
-                </para>
+                    <methodname>getModulePaths()</methodname> : obtener la lista
+                    de los paths de módulos registrados. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>addLayer($path)</methodname>
-                    : añadir una capa (construcción
-                    personalizada) del path a utilizar.
-                </para>
+                    <methodname>addLayer($path)</methodname> : añadir una capa
+                    (construcción personalizada) del path a utilizar. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getLayers()</methodname>
-                    : conseguir una lista de todos los paths
-                    de capas registrados (construcción
-                    personalizada).
-                </para>
+                    <methodname>getLayers()</methodname> : conseguir una lista
+                    de todos los paths de capas registrados (construcción
+                    personalizada). </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>removeLayer($path)</methodname>
-                    : eliminar la capa que concuerde
-                    con
-                    <varname>$path</varname>
-                    de la lista de capas registradas
-                    (construcción personalizada).
-                </para>
+                    <methodname>removeLayer($path)</methodname> : eliminar la
+                    capa que concuerde con <varname>$path</varname> de la lista
+                    de capas registradas (construcción personalizada). </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>setCdnBase($url)</methodname>
-                    : establecer la URL base para un CDN;
-                    típicamente, una de las
-                    <constant>Zend_Dojo::CDN_BASE_AOL</constant>
-                    o
-                    <constant>Zend_Dojo::CDN_BASE_GOOGLE</constant>
-                    , pero sólo necesita ser el
-                    string del URL antes del número de versión.
-                </para>
+                    <methodname>setCdnBase($url)</methodname> : establecer la
+                    URL base para un CDN; típicamente, una de las
+                        <constant>Zend_Dojo::CDN_BASE_AOL</constant> o
+                        <constant>Zend_Dojo::CDN_BASE_GOOGLE</constant> , pero
+                    sólo necesita ser el string del URL antes del número de
+                    versión. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getCdnBase()</methodname>
-                    : recuperar el CDN de la url base a
-                    utilizar.
-                </para>
+                    <methodname>getCdnBase()</methodname> : recuperar el CDN de
+                    la url base a utilizar. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>setCdnVersion($version = null)</methodname>
-                    : establecer cuál es la
-                    versión de Dojo a utilizar desde el CDN.
-                </para>
+                    <methodname>setCdnVersion($version = null)</methodname> :
+                    establecer cuál es la versión de Dojo a utilizar desde el
+                    CDN. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getCdnVersion()</methodname>
-                    : recuperar que versión de Dojo será
-                    utilizada desde el CDN.
-                </para>
+                    <methodname>getCdnVersion()</methodname> : recuperar que
+                    versión de Dojo será utilizada desde el CDN. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>setCdnDojoPath($path)</methodname>
-                    : establecer el path relativo a
-                    un archivo dojo.js o dojo.xd.js sobre un CDN;
-                    típicamente, uno de los
-                    <constant>Zend_Dojo::CDN_DOJO_PATH_AOL</constant>
-                    o
-                    <constant>Zend_Dojo::CDN_DOJO_PATH_GOOGLE</constant>
-                    , pero sólo debe ser
-                    el string del path detrás del número de versión.
-                </para>
+                    <methodname>setCdnDojoPath($path)</methodname> : establecer
+                    el path relativo a un archivo dojo.js o dojo.xd.js sobre un
+                    CDN; típicamente, uno de los
+                        <constant>Zend_Dojo::CDN_DOJO_PATH_AOL</constant> o
+                        <constant>Zend_Dojo::CDN_DOJO_PATH_GOOGLE</constant> ,
+                    pero sólo debe ser el string del path detrás del número de
+                    versión. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getCdnDojoPath()</methodname>
-                    : recuperar el último segmento del
-                    path del CDN de la url apuntando al archivo
-                    dojo.js.
-                </para>
+                    <methodname>getCdnDojoPath()</methodname> : recuperar el
+                    último segmento del path del CDN de la url apuntando al
+                    archivo dojo.js. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>useCdn()</methodname>
-                    : decirle al contenedor que utilice el CDN;
-                    implícitamente permite integración.
+                    <methodname>useCdn()</methodname> : decirle al contenedor
+                    que utilice el CDN; implícitamente permite integración.
                 </para>
                 </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>setLocalPath($path)</methodname>
-                    : decirle al contenedor el path a
-                    una instalación local de Dojo (deberá ser una
-                    ruta relativa al servidor, y
-                    contener el propio archivo dojo.js); implícitamente
-                    permite integración.
+                    <methodname>setLocalPath($path)</methodname> : decirle al
+                    contenedor el path a una instalación local de Dojo (deberá
+                    ser una ruta relativa al servidor, y contener el propio
+                    archivo dojo.js); implícitamente permite integración.
                 </para>
                 </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getLocalPath()</methodname>
-                    : determinar qué ruta local a Dojo está
-                    siendo utilizada.
-                </para>
+                    <methodname>getLocalPath()</methodname> : determinar qué
+                    ruta local a Dojo está siendo utilizada. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>useLocalPath()</methodname>
-                    : ¿la integración está utilizando un
-                    path local de Dojo?
-                </para>
+                    <methodname>useLocalPath()</methodname> : ¿la integración
+                    está utilizando un path local de Dojo? </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>setDjConfig(array $config)</methodname>
-                    : conjunto de valores de
-                    configuración dojo/dijit (espera un array asociativo).
-                </para>
+                    <methodname>setDjConfig(array $config)</methodname> :
+                    conjunto de valores de configuración dojo/dijit (espera un
+                    array asociativo). </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
                     <methodname>setDjConfigOption($option, $value)</methodname>
                     <methodname>setDjConfigOption($option, $value)</methodname>
-                    : establecer un
-                    único valor de configuración para dojo/dijit.
-                </para>
+                    : establecer un único valor de configuración para
+                    dojo/dijit. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getDjConfig()</methodname>
-                    : obtener todos los valores de
-                    configuración de dojo/dijit.
-                </para>
+                    <methodname>getDjConfig()</methodname> : obtener todos los
+                    valores de configuración de dojo/dijit. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getDjConfigOption($option, $default = null)</methodname>
-                    :
-                    conseguir un único valor de configuración de dojo/dijit.
-                </para>
+                    <methodname>getDjConfigOption($option, $default =
+                        null)</methodname> : conseguir un único valor de
+                    configuración de dojo/dijit. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>addStylesheetModule($module)</methodname>
-                    : agregar una hoja de
-                    estilo sobre la base del tema de un módulo.
-                </para>
+                    <methodname>addStylesheetModule($module)</methodname> :
+                    agregar una hoja de estilo sobre la base del tema de un
+                    módulo. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getStylesheetModules()</methodname>
-                    : obtener hojas de estilo
-                    registradas como temas de módulos.
-                </para>
+                    <methodname>getStylesheetModules()</methodname> : obtener
+                    hojas de estilo registradas como temas de módulos. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>addStylesheet($path)</methodname>
-                    : agregar una hoja de estilo
-                    local para su uso con Dojo.
-                </para>
+                    <methodname>addStylesheet($path)</methodname> : agregar una
+                    hoja de estilo local para su uso con Dojo. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getStylesheets()</methodname>
-                    : obtener hojas de estilo locales
-                    Dojo.
-                </para>
+                    <methodname>getStylesheets()</methodname> : obtener hojas de
+                    estilo locales Dojo. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
                     <methodname>addOnLoad($spec, $function = null)</methodname>
                     <methodname>addOnLoad($spec, $function = null)</methodname>
-                    : agregar un lambda
-                    para dojo.onLoad para llamadas. Si se pasa un argumento, se
-                    supone que que puede
-                    ser tanto el nombre de una función o dar por terminado
-                    javascript. Si se pasan
-                    dos argumentos, el primero se supone que es el nombre de
-                    la variable de la
-                    instancia de un objeto y el segundo ya sea un nombre de método
-                    en ese objeto o
-                    un cierre a utilizar con ese objeto.
-                </para>
+                    : agregar un lambda para dojo.onLoad para llamadas. Si se
+                    pasa un argumento, se supone que que puede ser tanto el
+                    nombre de una función o dar por terminado javascript. Si se
+                    pasan dos argumentos, el primero se supone que es el nombre
+                    de la variable de la instancia de un objeto y el segundo ya
+                    sea un nombre de método en ese objeto o un cierre a utilizar
+                    con ese objeto. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>prependOnLoad($spec, $function = null)</methodname>
-                    : exactamente
-                    como
-                    <methodname>addOnLoad()</methodname>
-                    , excluyendo agregar al principio el
-                    comienzo de onLoad stack.
-                </para>
+                    <methodname>prependOnLoad($spec, $function =
+                        null)</methodname> : exactamente como
+                        <methodname>addOnLoad()</methodname> , excluyendo
+                    agregar al principio el comienzo de onLoad stack. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>getOnLoadActions()</methodname>
-                    : recuperar todas las acciones
-                    dojo.onLoad registradas con el contenedor. Esto
-                    será un array de arrays.
-                </para>
+                    <methodname>getOnLoadActions()</methodname> : recuperar
+                    todas las acciones dojo.onLoad registradas con el
+                    contenedor. Esto será un array de arrays. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>onLoadCaptureStart($obj = null)</methodname>
-                    : capturar los datos
-                    que se utilizarán como lambda para dojo.onLoad(). Si se
-                    provee $obj, los códigos
-                    JS capturados serán considerados un cierre a utilizar
-                    con ese objeto
-                    Javascript.
-                </para>
+                    <methodname>onLoadCaptureStart($obj = null)</methodname> :
+                    capturar los datos que se utilizarán como lambda para
+                    dojo.onLoad(). Si se provee $obj, los códigos JS capturados
+                    serán considerados un cierre a utilizar con ese objeto
+                    Javascript. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>onLoadCaptureEnd($obj = null)</methodname>
-                    : finalizar la captura
-                    de datos para su uso con dojo.onLoad().
+                    <methodname>onLoadCaptureEnd($obj = null)</methodname> :
+                    finalizar la captura de datos para su uso con dojo.onLoad().
                 </para>
                 </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>javascriptCaptureStart()</methodname>
-                    : captura javascript
-                    arbitrario para ser incluido en Dojo JS (onLoad, require,
-                    etc.
-                    statements).
-                </para>
+                    <methodname>javascriptCaptureStart()</methodname> : captura
+                    javascript arbitrario para ser incluido en Dojo JS (onLoad,
+                    require, etc. statements). </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>javascriptCaptureEnd()</methodname>
-                    : finalizar la captura de
-                    javascript.
-                </para>
+                    <methodname>javascriptCaptureEnd()</methodname> : finalizar
+                    la captura de javascript. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>__toString()</methodname>
-                    : emitir el contenedor a un string;
-                    muestra todo el estilo
-                    <acronym>HTML</acronym>
-                    y elementos del script.
-                </para>
+                    <methodname>__toString()</methodname> : emitir el contenedor
+                    a un string; muestra todo el estilo <acronym>HTML</acronym>
+                    y elementos del script. </para>
             </listitem>
             </listitem>
         </itemizedlist>
         </itemizedlist>
     </sect3>
     </sect3>

File diff suppressed because it is too large
+ 222 - 454
documentation/manual/es/module_specs/Zend_Dojo-View-Helpers.xml


+ 105 - 189
documentation/manual/es/module_specs/Zend_Filter.xml

@@ -1,129 +1,79 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 19419 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.filter.introduction">
 <sect1 id="zend.filter.introduction">
 
 
     <title>Introducción</title>
     <title>Introducción</title>
 
 
-    <para>
-        El componente
-        <classname>Zend_Filter</classname>
-        proporciona un conjunto de filtros de
-        datos comúnmente necesarios. También proporciona un
-        sencillo mecanismo de encadenar varios
-        filtros que se puedan aplicar a un solo dato en un
-        orden definido por el usuario.
-    </para>
+    <para> El componente <classname>Zend_Filter</classname> proporciona un
+        conjunto de filtros de datos comúnmente necesarios. También proporciona
+        un sencillo mecanismo de encadenar varios filtros que se puedan aplicar
+        a un solo dato en un orden definido por el usuario. </para>
 
 
     <sect2 id="zend.filter.introduction.definition">
     <sect2 id="zend.filter.introduction.definition">
         <title>¿Qué es un filtro?</title>
         <title>¿Qué es un filtro?</title>
-        <para>En el mundo físico, un filtro se suele utilizar para eliminar partes no deseadas de
-            lo
-            ingresado, y la vez lo ingresado pasa a través de un filtro de salida (por ejemplo,
-            el
-            café). En este caso, un filtro es un operador que devuelve una parte de los datos de
-            entrada. Este tipo de filtro es útil para aplicaciones web, para la supresión de
-            entradas ilegales y/o que no se ajustan, eliminación de los espacios en blanco
-            innecesarios, etc</para>
-        <para>
-            This basic definition of a filter may be extended to include generalized
-            transformations
-            upon input. A common transformation applied in web applications is the
-            escaping of
-            <acronym>HTML</acronym>
-            entities. For example, if a form field is automatically populated with
-            untrusted input
-            (e.g., from a web browser), this value should either be free of
-            <acronym>HTML</acronym>
-            entities or contain only escaped
-            <acronym>HTML</acronym>
-            entities, in order to prevent undesired behavior
-            and security vulnerabilities. To meet
-            this requirement,
-            <acronym>HTML</acronym>
-            entities that appear in the
-            input must either be removed or escaped. Of course, which
-            approach is more appropriate
-            depends on the situation. A filter that removes the
-            <acronym>HTML</acronym>
-            entities operates within the
-            scope of the first definition of filter - an operator that
-            produces a subset of the
-            input. A filter that escapes the
-            <acronym>HTML</acronym>
-            entities, however, transforms the input (e.g.,
-            "
-            <code>&amp;</code>
-            " is transformed to "
-            <code>&amp;amp;</code>
-            "). Supporting
-            such use cases for web developers is important, and "to filter," in the
-            context of using
-            <classname>Zend_Filter</classname>
-            , means to perform some transformations upon input
-            data.
-        </para>
-        Esta definición básica de un filtro puede ser extendido para incluir
-        transformaciones
-        generalizadas sobre la entrada. Una transformación común requerida en las
-        aplicaciones web es
-        la de escapar las entidades
-        <acronym>HTML</acronym>
-        . Por ejemplo, si un campo del
-        formulario es completado automáticamente y contiene datos no
-        verificados (por ejemplo, datos
-        ingresados desde un navegador web), este valor debe estar
-        libre de las entidades
-        <acronym>HTML</acronym>
-        o sólo
-        contener entidades
-        <acronym>HTML</acronym>
-        de forma escapada, a fin de evitar comportamientos no deseados y
-        vulnerabilidades de
-        seguridad. Para cumplir este requerimiento, las entidades
-        <acronym>HTML</acronym>
-        que
-        aparecen en los datos introducidos deben ser suprimidos o escapados. Por supuesto, el
-        enfoque más adecuado depende del contexto y de la situción. Un filtro que quita las
-        entidades
-        <acronym>HTML</acronym>
-        funciona dentro del ámbito o alcance de la primera definición del filtro - un
-        operador que
-        produce un subconjunto de la entrada. Un filtro que escapa a las entidades
-        <acronym>HTML</acronym>
-        , sin embargo, transforma la entrada (por ejemplo, "
-        <code> &amp;</code>
-        " se
-        transforma en "
-        <code> &amp;amp;</code>
-        "). El Apoyo a los casos de uso como para la web
-        los desarrolladores es importante, y
-        "filtrar", en el contexto de la utilización de
-        <classname> Zend_Filter </classname>
-        , los medios para realizar algunas transformaciones
-        en los datos de entrada.
-    </sect2>
+        <para>En el mundo físico, un filtro se suele utilizar para eliminar
+            partes no deseadas de lo ingresado, y la vez lo ingresado pasa a
+            través de un filtro de salida (por ejemplo, el café). En este caso,
+            un filtro es un operador que devuelve una parte de los datos de
+            entrada. Este tipo de filtro es útil para aplicaciones web, para la
+            supresión de entradas ilegales y/o que no se ajustan, eliminación de
+            los espacios en blanco innecesarios, etc</para>
+        <para> This basic definition of a filter may be extended to include
+            generalized transformations upon input. A common transformation
+            applied in web applications is the escaping of
+                <acronym>HTML</acronym> entities. For example, if a form field
+            is automatically populated with untrusted input (e.g., from a web
+            browser), this value should either be free of
+                <acronym>HTML</acronym> entities or contain only escaped
+                <acronym>HTML</acronym> entities, in order to prevent undesired
+            behavior and security vulnerabilities. To meet this requirement,
+                <acronym>HTML</acronym> entities that appear in the input must
+            either be removed or escaped. Of course, which approach is more
+            appropriate depends on the situation. A filter that removes the
+                <acronym>HTML</acronym> entities operates within the scope of
+            the first definition of filter - an operator that produces a subset
+            of the input. A filter that escapes the <acronym>HTML</acronym>
+            entities, however, transforms the input (e.g., "
+                <code>&amp;</code> " is transformed to "
+                <code>&amp;amp;</code> "). Supporting such use cases for web
+            developers is important, and "to filter," in the context of using
+                <classname>Zend_Filter</classname> , means to perform some
+            transformations upon input data. </para> Esta definición básica de
+        un filtro puede ser extendido para incluir transformaciones
+        generalizadas sobre la entrada. Una transformación común requerida en
+        las aplicaciones web es la de escapar las entidades
+            <acronym>HTML</acronym> . Por ejemplo, si un campo del formulario es
+        completado automáticamente y contiene datos no verificados (por ejemplo,
+        datos ingresados desde un navegador web), este valor debe estar libre de
+        las entidades <acronym>HTML</acronym> o sólo contener entidades
+            <acronym>HTML</acronym> de forma escapada, a fin de evitar
+        comportamientos no deseados y vulnerabilidades de seguridad. Para
+        cumplir este requerimiento, las entidades <acronym>HTML</acronym> que
+        aparecen en los datos introducidos deben ser suprimidos o escapados. Por
+        supuesto, el enfoque más adecuado depende del contexto y de la situción.
+        Un filtro que quita las entidades <acronym>HTML</acronym> funciona
+        dentro del ámbito o alcance de la primera definición del filtro - un
+        operador que produce un subconjunto de la entrada. Un filtro que escapa
+        a las entidades <acronym>HTML</acronym> , sin embargo, transforma la
+        entrada (por ejemplo, " <code> &amp;</code> " se transforma en "
+            <code> &amp;amp;</code> "). El Apoyo a los casos de uso como
+        para la web los desarrolladores es importante, y "filtrar", en el
+        contexto de la utilización de <classname> Zend_Filter </classname> , los
+        medios para realizar algunas transformaciones en los datos de entrada. </sect2>
 
 
     <sect2 id="zend.filter.introduction.using">
     <sect2 id="zend.filter.introduction.using">
 
 
         <title>Uso básico de los filtros</title>
         <title>Uso básico de los filtros</title>
 
 
-        <para>
-            Having this filter definition established provides the foundation for
-            <classname>Zend_Filter_Interface</classname>
-            , which requires a single method named
-            <methodname>filter()</methodname>
-            to be implemented by a filter class.
-        </para>
+        <para> Having this filter definition established provides the foundation
+            for <classname>Zend_Filter_Interface</classname> , which requires a
+            single method named <methodname>filter()</methodname> to be
+            implemented by a filter class. </para>
 
 
-        <para>
-            Following is a basic example of using a filter upon two input data, the ampersand
-            (
-            <code>&amp;</code>
-            ) and double quote (
-            <code>&quot;</code>
-            ) characters:
-            <programlisting language="php"><![CDATA[
+        <para> Following is a basic example of using a filter upon two input
+            data, the ampersand ( <code>&amp;</code> ) and double quote (
+                <code>&quot;</code> ) characters: <programlisting language="php"><![CDATA[
 $htmlEntities = new Zend_Filter_HtmlEntities();
 $htmlEntities = new Zend_Filter_HtmlEntities();
 
 
 echo $htmlEntities->filter('&'); // &amp;
 echo $htmlEntities->filter('&'); // &amp;
@@ -137,69 +87,46 @@ echo $htmlEntities->filter('"'); // &quot;
 
 
         <title> Usando el método estático staticFilter()</title>
         <title> Usando el método estático staticFilter()</title>
 
 
-        <para>
-            If it is inconvenient to load a given filter class and create an instance of the
-            filter,
-            you can use the static method
-            <methodname>Zend_Filter::filterStatic()</methodname>
-            as an alternative invocation
-            style. The first argument of this method is a data input
-            value, that you would pass to
-            the
-            <methodname>filter()</methodname>
-            method. The second argument is a string, which
-            corresponds to the basename of the filter
-            class, relative to the Zend_Filter namespace.
-            The
-            <methodname>staticFilter()</methodname>
-            method automatically loads the class,
-            creates an instance, and applies the
-            <methodname>filter()</methodname>
-            method to the
-            data input.
-            <programlisting language="php"><![CDATA[
+        <para> If it is inconvenient to load a given filter class and create an
+            instance of the filter, you can use the static method
+                <methodname>Zend_Filter::filterStatic()</methodname> as an
+            alternative invocation style. The first argument of this method is a
+            data input value, that you would pass to the
+                <methodname>filter()</methodname> method. The second argument is
+            a string, which corresponds to the basename of the filter class,
+            relative to the Zend_Filter namespace. The
+                <methodname>staticFilter()</methodname> method automatically
+            loads the class, creates an instance, and applies the
+                <methodname>filter()</methodname> method to the data input. <programlisting language="php"><![CDATA[
 echo Zend_Filter::filterStatic('&', 'HtmlEntities');
 echo Zend_Filter::filterStatic('&', 'HtmlEntities');
 ]]></programlisting>
 ]]></programlisting>
         </para>
         </para>
 
 
-        <para>
-            You can also pass an array of constructor arguments, if they are needed for the
-            filter
-            class.
-            <programlisting language="php"><![CDATA[
+        <para> You can also pass an array of constructor arguments, if they are
+            needed for the filter class. <programlisting language="php"><![CDATA[
 echo Zend_Filter::filterStatic('"', 'HtmlEntities', array(ENT_QUOTES));
 echo Zend_Filter::filterStatic('"', 'HtmlEntities', array(ENT_QUOTES));
 ]]></programlisting>
 ]]></programlisting>
         </para>
         </para>
 
 
-        <para>
-            The static usage can be convenient for invoking a filter ad hoc, but if you have the
-            need to run a filter for multiple inputs, it's more efficient to follow the first
-            example above, creating an instance of the filter object and calling its
-            <methodname>filter()</methodname>
-            method.
-        </para>
+        <para> The static usage can be convenient for invoking a filter ad hoc,
+            but if you have the need to run a filter for multiple inputs, it's
+            more efficient to follow the first example above, creating an
+            instance of the filter object and calling its
+                <methodname>filter()</methodname> method. </para>
 
 
-        <para>
-            Also, the
-            <classname>Zend_Filter_Input</classname>
-            class allows you to instantiate
-            and run multiple filter and validator classes on demand
-            to process sets of input data.
-            See
-            <xref linkend="zend.filter.input"/>
-            .
-        </para>
+        <para> Also, the <classname>Zend_Filter_Input</classname> class allows
+            you to instantiate and run multiple filter and validator classes on
+            demand to process sets of input data. See <xref
+                linkend="zend.filter.input"/> . </para>
 
 
         <sect3 id="zend.filter.introduction.static.namespaces">
         <sect3 id="zend.filter.introduction.static.namespaces">
 
 
             <title>Namespaces</title>
             <title>Namespaces</title>
 
 
-            <para>
-                When working with self defined filters you can give a forth parameter to
-                <methodname>Zend_Filter::filterStatic()</methodname>
-                which is the namespace
-                where your filter can be found.
-            </para>
+            <para> When working with self defined filters you can give a forth
+                parameter to
+                    <methodname>Zend_Filter::filterStatic()</methodname> which
+                is the namespace where your filter can be found. </para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 echo Zend_Filter::filterStatic(
 echo Zend_Filter::filterStatic(
@@ -211,15 +138,11 @@ echo Zend_Filter::filterStatic(
 ]]></programlisting>
 ]]></programlisting>
 
 
             <para>
             <para>
-                <classname>Zend_Filter</classname>
-                allows also to set namespaces as default. This
-                means that you can set them once in
-                your bootstrap and have not to give them again
-                for each call of
-                <methodname>Zend_Filter::filterStatic()</methodname>
-                . The following
-                code snippet is identical to the above one.
-            </para>
+                <classname>Zend_Filter</classname> allows also to set namespaces
+                as default. This means that you can set them once in your
+                bootstrap and have not to give them again for each call of
+                    <methodname>Zend_Filter::filterStatic()</methodname> . The
+                following code snippet is identical to the above one. </para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 Zend_Filter::setDefaultNamespaces(array('FirstNamespace', 'SecondNamespace'));
 Zend_Filter::setDefaultNamespaces(array('FirstNamespace', 'SecondNamespace'));
@@ -227,28 +150,25 @@ echo Zend_Filter::filterStatic('"', 'MyFilter', array($parameters));
 echo Zend_Filter::filterStatic('"', 'OtherFilter', array($parameters));
 echo Zend_Filter::filterStatic('"', 'OtherFilter', array($parameters));
 ]]></programlisting>
 ]]></programlisting>
 
 
-            <para>For your convinience there are following methods which allow the handling of
-                namespaces:</para>
+            <para>For your convinience there are following methods which allow
+                the handling of namespaces:</para>
 
 
             <itemizedlist>
             <itemizedlist>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
                         <emphasis>
                         <emphasis>
                             <methodname>Zend_Filter::getDefaultNamespaces()</methodname>
                             <methodname>Zend_Filter::getDefaultNamespaces()</methodname>
-                        </emphasis>
-                        : Returns all set default namespaces as array.
-                    </para>
+                        </emphasis> : Returns all set default namespaces as
+                        array. </para>
                 </listitem>
                 </listitem>
 
 
                 <listitem>
                 <listitem>
                     <para>
                     <para>
                         <emphasis>
                         <emphasis>
                             <methodname>Zend_Filter::setDefaultNamespaces()</methodname>
                             <methodname>Zend_Filter::setDefaultNamespaces()</methodname>
-                        </emphasis>
-                        : Sets new default namespaces and overrides any previous set. It
-                        accepts
-                        eighter a string for a single namespace of an array for multiple
-                        namespaces.
+                        </emphasis> : Sets new default namespaces and overrides
+                        any previous set. It accepts eighter a string for a
+                        single namespace of an array for multiple namespaces.
                     </para>
                     </para>
                 </listitem>
                 </listitem>
 
 
@@ -256,22 +176,18 @@ echo Zend_Filter::filterStatic('"', 'OtherFilter', array($parameters));
                     <para>
                     <para>
                         <emphasis>
                         <emphasis>
                             <methodname>Zend_Filter::addDefaultNamespaces()</methodname>
                             <methodname>Zend_Filter::addDefaultNamespaces()</methodname>
-                        </emphasis>
-                        : Adds additional namespaces to already set ones. It accepts
-                        eighter a string
-                        for a single namespace of an array for multiple namespaces.
-                    </para>
+                        </emphasis> : Adds additional namespaces to already set
+                        ones. It accepts eighter a string for a single namespace
+                        of an array for multiple namespaces. </para>
                 </listitem>
                 </listitem>
 
 
                 <listitem>
                 <listitem>
                     <para>
                     <para>
                         <emphasis>
                         <emphasis>
                             <methodname>Zend_Filter::hasDefaultNamespaces()</methodname>
                             <methodname>Zend_Filter::hasDefaultNamespaces()</methodname>
-                        </emphasis>
-                        : Returns true when one or more default namespaces are set, and
-                        false when no
-                        default namespaces are set.
-                    </para>
+                        </emphasis> : Returns <constant>TRUE</constant> when one or more default
+                        namespaces are set, and <constant>FALSE</constant> when no default namespaces
+                        are set. </para>
                 </listitem>
                 </listitem>
             </itemizedlist>
             </itemizedlist>
         </sect3>
         </sect3>

+ 103 - 202
documentation/manual/es/module_specs/Zend_Form-Advanced.xml

@@ -1,31 +1,23 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 17987 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.form.advanced">
 <sect1 id="zend.form.advanced">
     <title>Uso avanzado de Zend_Form</title>
     <title>Uso avanzado de Zend_Form</title>
 
 
     <para>
     <para>
-        <classname>Zend_Form</classname>
-        tiene una funcional riqueza, muchas de
-        ellas dirigidas a expertos desarroladores. Este
-        capítulo esta dirigido a
-        documentar algunas de las funcionalidades con ejemplos y casos de
-        uso.
-    </para>
+        <classname>Zend_Form</classname> tiene una funcional riqueza, muchas de
+        ellas dirigidas a expertos desarroladores. Este capítulo esta dirigido a
+        documentar algunas de las funcionalidades con ejemplos y casos de uso. </para>
 
 
     <sect2 id="zend.form.advanced.arrayNotation">
     <sect2 id="zend.form.advanced.arrayNotation">
         <title>Notación de array</title>
         <title>Notación de array</title>
 
 
         <para>A muchos desarroladores web experimentados les gusta agrupar
         <para>A muchos desarroladores web experimentados les gusta agrupar
-            elementos relacionados de
-            formulario usando notación de array en los
-            nombres del elemento. Por ejemplo, si se
-            tienen dos direcciones que
-            se desean capturar, un envío y una dirección de facturación,
-            se
+            elementos relacionados de formulario usando notación de array en los
+            nombres del elemento. Por ejemplo, si se tienen dos direcciones que
+            se desean capturar, un envío y una dirección de facturación, se
             pueden tener elementos idénticos; agrupándolos en un array se puede
             pueden tener elementos idénticos; agrupándolos en un array se puede
-            asegurar que son
-            capturados por separado. Nótese el siguiente
+            asegurar que son capturados por separado. Nótese el siguiente
             formulario por ejemplo:</para>
             formulario por ejemplo:</para>
 
 
         <programlisting language="html"><![CDATA[
         <programlisting language="html"><![CDATA[
@@ -81,10 +73,8 @@
 ]]></programlisting>
 ]]></programlisting>
 
 
         <para>En este ejemplo, la facturación y la dirección de envío contienen
         <para>En este ejemplo, la facturación y la dirección de envío contienen
-            algunos campos
-            idénticos, eso significa que uno puede sobrescribir
-            al otro. Nosotros podemos resolver
-            esta solución usando una notación
+            algunos campos idénticos, eso significa que uno puede sobrescribir
+            al otro. Nosotros podemos resolver esta solución usando una notación
             de array:</para>
             de array:</para>
 
 
         <programlisting language="html"><![CDATA[
         <programlisting language="html"><![CDATA[
@@ -150,142 +140,95 @@
 ]]></programlisting>
 ]]></programlisting>
 
 
         <para>En el ejemplo anterior, obtenemos direcciones separadas. En el
         <para>En el ejemplo anterior, obtenemos direcciones separadas. En el
-            formulario sometido,
-            ahora tenemos tres elementos, 'guardar'
-            elemento para someterlo, y dos arrays, 'envio' y
-            'cuenta', cada uno
+            formulario sometido, ahora tenemos tres elementos, 'guardar'
+            elemento para someterlo, y dos arrays, 'envio' y 'cuenta', cada uno
             con llaves para los variados elementos.</para>
             con llaves para los variados elementos.</para>
 
 
         <para>
         <para>
-            <classname>Zend_Form</classname>
-            intenta automatizar este proceso
-            con los
-            <link linkend="zend.form.forms.subforms">subformularios</link>
-            . Por defecto, los subformularios son
-            generados usando la notación de array como se
-            muestra en el anterior
-            formulario
-            <acronym>HTML</acronym>
-            listado completo con identificadores. El nombre del
-            array esta basado en el nombre del
-            subformulario, con las llaves
-            basados en los elementos contenidos en el subformulario.
-            Los
-            subformularios pueder ser anidados arbitrariamente, y esto puede
-            crear arrays anidados
-            que reflejan la estructura. Adicionalmente,
-            las validaciones rutinarias en
-            <classname>Zend_Form</classname>
-            respetan la estructura del array, asegurando que sus formularios
-            sean validados
-            correctamente, no importa cuan arbitrariamente
-            anidados esten los subformularios. No se
-            necesita hacer nada para
-            beneficiarse; éste comportamiento esta activo por defecto.
-        </para>
+            <classname>Zend_Form</classname> intenta automatizar este proceso
+            con los <link linkend="zend.form.forms.subforms"
+                >subformularios</link> . Por defecto, los subformularios son
+            generados usando la notación de array como se muestra en el anterior
+            formulario <acronym>HTML</acronym> listado completo con
+            identificadores. El nombre del array esta basado en el nombre del
+            subformulario, con las llaves basados en los elementos contenidos en
+            el subformulario. Los subformularios pueder ser anidados
+            arbitrariamente, y esto puede crear arrays anidados que reflejan la
+            estructura. Adicionalmente, las validaciones rutinarias en
+                <classname>Zend_Form</classname> respetan la estructura del
+            array, asegurando que sus formularios sean validados correctamente,
+            no importa cuan arbitrariamente anidados esten los subformularios.
+            No se necesita hacer nada para beneficiarse; éste comportamiento
+            esta activo por defecto. </para>
 
 
         <para>Adicionalmente, existen facilidades que le permiten activar
         <para>Adicionalmente, existen facilidades que le permiten activar
-            condicionalmente la
-            notación de un array, así como también
-            especificar el específico array al cual un
-            elemento o coleccion
+            condicionalmente la notación de un array, así como también
+            especificar el específico array al cual un elemento o coleccion
             pertenece:</para>
             pertenece:</para>
 
 
         <itemizedlist>
         <itemizedlist>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <methodname>Zend_Form::setIsArray($flag)</methodname>
-                    :
-                    Definiendo la bandera a verdadero, se puede indicar que un
-                    formulario entero
-                    debería ser tratado como un array. Por
-                    defecto, el nombre del formulario será
-                    usado como el nombre
+                    <methodname>Zend_Form::setIsArray($flag)</methodname> :
+                    Definiendo la bandera a <constant>TRUE</constant>, se puede indicar que un
+                    formulario entero debería ser tratado como un array. Por
+                    defecto, el nombre del formulario será usado como el nombre
                     del array, a no ser que
                     del array, a no ser que
-                    <methodname>setElementsBelongTo()</methodname>
-                    haya sido
+                        <methodname>setElementsBelongTo()</methodname> haya sido
                     llamado. Si el formulario no tiene un nombre específico, o
                     llamado. Si el formulario no tiene un nombre específico, o
-                    si
-                    <methodname>setElementsBelongTo()</methodname>
-                    no ha sido
+                    si <methodname>setElementsBelongTo()</methodname> no ha sido
                     definido, esta bandera será ignorada (como cuando no hay
                     definido, esta bandera será ignorada (como cuando no hay
-                    nombre del
-                    array al cual los elementos puedan pertenecer).
-                </para>
+                    nombre del array al cual los elementos puedan pertenecer). </para>
 
 
-                <para>
-                    Se deberá determinar si un formulario está siendo tratado
-                    como un array usando el
-                    accesor
-                    <methodname>isArray()</methodname>
-                    .
-                </para>
+                <para> Se deberá determinar si un formulario está siendo tratado
+                    como un array usando el accesor
+                        <methodname>isArray()</methodname> . </para>
             </listitem>
             </listitem>
 
 
             <listitem>
             <listitem>
                 <para>
                 <para>
                     <methodname>Zend_Form::setElementsBelongTo($array)</methodname>
                     <methodname>Zend_Form::setElementsBelongTo($array)</methodname>
-                    :
-                    Usando este método, se puede especificar el nombre de un
-                    array al cual todos los
-                    elementos del formulario pertenecen.
-                    Se puede determinar el nombre usando el
-                    accesor
-                    <methodname>getElementsBelongTo()</methodname>
-                    .
-                </para>
+                    : Usando este método, se puede especificar el nombre de un
+                    array al cual todos los elementos del formulario pertenecen.
+                    Se puede determinar el nombre usando el accesor
+                        <methodname>getElementsBelongTo()</methodname> . </para>
             </listitem>
             </listitem>
         </itemizedlist>
         </itemizedlist>
 
 
-        <para>
-            Adicionalmente, a nivel del elemento, se pueden especificar
-            elementos individuales que
-            puedan pertenecer a arrays particulares
+        <para> Adicionalmente, a nivel del elemento, se pueden especificar
+            elementos individuales que puedan pertenecer a arrays particulares
             usando el método
             usando el método
-            <methodname>Zend_Form_Element::setBelongsTo()</methodname>
-            . Para
-            descubrir el valor que tiene -- sea o no sea definido explícitamente
-            o
-            implícitamente a través del formulario -- se puede usar el accesor
-            <methodname>getBelongsTo()</methodname>
-            .
-        </para>
+                <methodname>Zend_Form_Element::setBelongsTo()</methodname> .
+            Para descubrir el valor que tiene -- sea o no sea definido
+            explícitamente o implícitamente a través del formulario -- se puede
+            usar el accesor <methodname>getBelongsTo()</methodname> . </para>
     </sect2>
     </sect2>
 
 
     <sect2 id="zend.form.advanced.multiPage">
     <sect2 id="zend.form.advanced.multiPage">
         <title>Formularios Multi-Página</title>
         <title>Formularios Multi-Página</title>
 
 
-        <para>
-            Actualmente, los formularios multi-página no están oficialmente
-            soportados en
-            <classname>Zend_Form</classname>
-            ; sin embargo, la
+        <para> Actualmente, los formularios multi-página no están oficialmente
+            soportados en <classname>Zend_Form</classname> ; sin embargo, la
             mayoría del soporte para implementarlos está disponible y puede ser
             mayoría del soporte para implementarlos está disponible y puede ser
-            utilizado con algunos retoques.
-        </para>
+            utilizado con algunos retoques. </para>
 
 
         <para>La clave para crear fomrularios multi-página es utilizar
         <para>La clave para crear fomrularios multi-página es utilizar
-            subformularios, pero solo para
-            mostrar un solo subformulario por
-            página. Esto le permite someter un solo subformulario a
-            la vez y
+            subformularios, pero solo para mostrar un solo subformulario por
+            página. Esto le permite someter un solo subformulario a la vez y
             validarlo, pero no procesar el formulario hasta que todos los
             validarlo, pero no procesar el formulario hasta que todos los
-            subformularios
-            esten completos.</para>
+            subformularios esten completos.</para>
 
 
         <example id="zend.form.advanced.multiPage.registration">
         <example id="zend.form.advanced.multiPage.registration">
             <title>Ejemplo de formulario de registro</title>
             <title>Ejemplo de formulario de registro</title>
             <para>Vamos a usar un formulario de registro como ejemplo. Para
             <para>Vamos a usar un formulario de registro como ejemplo. Para
-                nuestros propósitos,
-                queremos capturar el nombre del usuario y
-                la contraseña en la primera página, después
-                la información del
+                nuestros propósitos, queremos capturar el nombre del usuario y
+                la contraseña en la primera página, después la información del
                 usuario -- nombre, apellido, y ubicación -- y finalmente
                 usuario -- nombre, apellido, y ubicación -- y finalmente
-                permitirles decidir qué lista de correo, si desean suscribirse.</para>
+                permitirles decidir qué lista de correo, si desean
+                suscribirse.</para>
 
 
             <para>Primero, vamos a crear nuestro propio formulario, y definir
             <para>Primero, vamos a crear nuestro propio formulario, y definir
-                varios subformularios
-                dentro del mismo:</para>
+                varios subformularios dentro del mismo:</para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 class My_Form_Registration extends Zend_Form
 class My_Form_Registration extends Zend_Form
@@ -389,16 +332,12 @@ class My_Form_Registration extends Zend_Form
 ]]></programlisting>
 ]]></programlisting>
 
 
             <para>Note que no hay botones de enviar, y que ni hemos hecho nada
             <para>Note que no hay botones de enviar, y que ni hemos hecho nada
-                con los decoradores de
-                subformularios -- lo que significa que
-                por defecto serán desplegados como campos.
-                Necesitaremos hacer
+                con los decoradores de subformularios -- lo que significa que
+                por defecto serán desplegados como campos. Necesitaremos hacer
                 algo con ellos mientras desplegamos cada subformulario
                 algo con ellos mientras desplegamos cada subformulario
                 individualmente, y añadir botones de manera que podamos
                 individualmente, y añadir botones de manera que podamos
-                procesarlos realmente -- el
-                cual requerira las propiedades
-                acción y método. Vamos a añadir algunos andamios a
-                nuestras
+                procesarlos realmente -- el cual requerira las propiedades
+                acción y método. Vamos a añadir algunos andamios a nuestras
                 clases para proveer esa información:</para>
                 clases para proveer esa información:</para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
@@ -479,27 +418,19 @@ class My_Form_Registration extends Zend_Form
 }
 }
 ]]></programlisting>
 ]]></programlisting>
 
 
-            <para>
-                Siguiente, necesitamos añadir andamios a nuestro action
-                controller, y tener varias
-                consideraciones. Primero, necesitamos
-                asegurar que persiste la información del
-                formulario entre los
+            <para> Siguiente, necesitamos añadir andamios a nuestro action
+                controller, y tener varias consideraciones. Primero, necesitamos
+                asegurar que persiste la información del formulario entre los
                 requerimientos, de esa manera determinar cuándo terminar.
                 requerimientos, de esa manera determinar cuándo terminar.
                 Segundo, necesitamos alguna lógica para determinar qué segmentos
                 Segundo, necesitamos alguna lógica para determinar qué segmentos
-                del formulario han
-                sido sometidos, y qué subformulario mostrar
+                del formulario han sido sometidos, y qué subformulario mostrar
                 de acuerdo a la información. Usaremos
                 de acuerdo a la información. Usaremos
-                <classname>Zend_Session_Namespace</classname>
-                para persistir
+                    <classname>Zend_Session_Namespace</classname> para persistir
                 la información, el cual nos ayudará a responder la pregunta de
                 la información, el cual nos ayudará a responder la pregunta de
-                qué
-                formulario someter.
-            </para>
+                qué formulario someter. </para>
 
 
             <para>Vamos a crear nuestro controlador, y añadir un método para
             <para>Vamos a crear nuestro controlador, y añadir un método para
-                recuperar un formulario
-                instanciado:</para>
+                recuperar un formulario instanciado:</para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 class RegistrationController extends Zend_Controller_Action
 class RegistrationController extends Zend_Controller_Action
@@ -517,17 +448,12 @@ class RegistrationController extends Zend_Controller_Action
 ]]></programlisting>
 ]]></programlisting>
 
 
             <para>Ahora, vamos a añadir algunas funcionalidades para determinar
             <para>Ahora, vamos a añadir algunas funcionalidades para determinar
-                qué formulario
-                mostrar. Básicamente, hasta que el formulario
-                entero sea considerado válido,
-                necesitamos continuar mostrando
-                segmentos de formulario. Adicionalmente, queremos
-                asegurar que
+                qué formulario mostrar. Básicamente, hasta que el formulario
+                entero sea considerado válido, necesitamos continuar mostrando
+                segmentos de formulario. Adicionalmente, queremos asegurar que
                 están en un orden particular: usuario, demog, y después las
                 están en un orden particular: usuario, demog, y después las
-                listas.
-                Podemos determinar qué información ha sido sometida
-                verificando nuestro session
-                namespace para claves particulares
+                listas. Podemos determinar qué información ha sido sometida
+                verificando nuestro session namespace para claves particulares
                 representando cada subformulario.</para>
                 representando cada subformulario.</para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
@@ -623,47 +549,30 @@ class RegistrationController extends Zend_Controller_Action
 }
 }
 ]]></programlisting>
 ]]></programlisting>
 
 
-            <para>
-                El método de arriba nos permite usar notaciones tal como
-                "
-                <command>$subForm =
-                    $this-&gt;getCurrentSubForm();</command>
-                " recuperar
-                el actual subformulario para la validación, o "
-                <command>$next
-                    = $this-&gt;getNextSubForm();</command>
-                " obtener el
-                siguiente para mostrar.
-            </para>
-
-            <para>
-                Ahora, vamos a encontrar la manera para procesar y mostrar
-                varios subformularios.
-                Podemos usar
-                <methodname>getCurrentSubForm()</methodname>
-                para determinar
+            <para> El método de arriba nos permite usar notaciones tal como "
+                    <command>$subForm =
+                    $this-&gt;getCurrentSubForm();</command> " recuperar el
+                actual subformulario para la validación, o " <command>$next =
+                    $this-&gt;getNextSubForm();</command> " obtener el
+                siguiente para mostrar. </para>
+
+            <para> Ahora, vamos a encontrar la manera para procesar y mostrar
+                varios subformularios. Podemos usar
+                    <methodname>getCurrentSubForm()</methodname> para determinar
                 si algún subformulario ha sido sometido (los valores de retorno
                 si algún subformulario ha sido sometido (los valores de retorno
-                falso
-                indican que ninguno ha sido desplegado o sometido), y
-                <methodname>getNextSubForm()</methodname>
-                recupera el
+                <constant>FALSE</constant> indican que ninguno ha sido desplegado o sometido), y
+                    <methodname>getNextSubForm()</methodname> recupera el
                 formulario que mostrar. Podemos entonces usar el método del
                 formulario que mostrar. Podemos entonces usar el método del
-                formulario
-                <methodname>prepareSubForm()</methodname>
-                para
-                asegurar que el formulario está listo para mostrar.
-            </para>
+                formulario <methodname>prepareSubForm()</methodname> para
+                asegurar que el formulario está listo para mostrar. </para>
 
 
             <para>Cuando tenemos un formulario sometido, podemos validar el
             <para>Cuando tenemos un formulario sometido, podemos validar el
-                subformulario, y luego
-                verificar si el formulario entero es
-                válido ahora. Para hacer esas tareas,
-                necesitamos métodos
+                subformulario, y luego verificar si el formulario entero es
+                válido ahora. Para hacer esas tareas, necesitamos métodos
                 adicionales que aseguren que la información sometida es añadida
                 adicionales que aseguren que la información sometida es añadida
-                a
-                la sesión, y que cuando validamos el formulario entero,
-                nosotros validamos contra
-                todos los segmentos de la sesión:</para>
+                a la sesión, y que cuando validamos el formulario entero,
+                nosotros validamos contra todos los segmentos de la
+                sesión:</para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 class RegistrationController extends Zend_Controller_Action
 class RegistrationController extends Zend_Controller_Action
@@ -707,10 +616,8 @@ class RegistrationController extends Zend_Controller_Action
 ]]></programlisting>
 ]]></programlisting>
 
 
             <para>Ahora que tenemos el trabajo preparado, vamos a construir las
             <para>Ahora que tenemos el trabajo preparado, vamos a construir las
-                acciones para este
-                controlador. Necesitaremos una página de
-                destino para el formulario, y luego una
-                acción 'process' para
+                acciones para este controlador. Necesitaremos una página de
+                destino para el formulario, y luego una acción 'process' para
                 procesar el formulario.</para>
                 procesar el formulario.</para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
@@ -755,16 +662,12 @@ class RegistrationController extends Zend_Controller_Action
 ]]></programlisting>
 ]]></programlisting>
 
 
             <para>Como se ha notado, el código actual para procesar el
             <para>Como se ha notado, el código actual para procesar el
-                formulario es relativamente
-                simple. Verificamos si tenemos un
-                subformulario actual sometido y si no, retornamos a
-                la página de
+                formulario es relativamente simple. Verificamos si tenemos un
+                subformulario actual sometido y si no, retornamos a la página de
                 destino. Si tenemos un subformulario, intentaremos validarlo,
                 destino. Si tenemos un subformulario, intentaremos validarlo,
                 volviéndolo a mostrar si tiene fallos. Si el subformulario es
                 volviéndolo a mostrar si tiene fallos. Si el subformulario es
-                válido, entonces
-                verificaremos si el formulario es válido, lo
-                que debería indicar que hemos terminado;
-                si no, mostraremos el
+                válido, entonces verificaremos si el formulario es válido, lo
+                que debería indicar que hemos terminado; si no, mostraremos el
                 siguiente segmento del formulario. Finalmente, mostraremos una
                 siguiente segmento del formulario. Finalmente, mostraremos una
                 página de verificación con el contenido de la sesión.</para>
                 página de verificación con el contenido de la sesión.</para>
 
 
@@ -804,10 +707,8 @@ endforeach
 ]]></programlisting>
 ]]></programlisting>
 
 
             <para>Próximas novedades de Zend Framework incluirán componentes
             <para>Próximas novedades de Zend Framework incluirán componentes
-                para hacer formularios
-                multi páginas mas simples, abstrayendo la
-                sesión y la lógica de orden. Mientras
-                tanto, el ejemplo de
+                para hacer formularios multi páginas mas simples, abstrayendo la
+                sesión y la lógica de orden. Mientras tanto, el ejemplo de
                 arriba debería servir como guia razonable para alcanzar esta
                 arriba debería servir como guia razonable para alcanzar esta
                 tarea en su web.</para>
                 tarea en su web.</para>
         </example>
         </example>

File diff suppressed because it is too large
+ 236 - 490
documentation/manual/es/module_specs/Zend_Form-Elements.xml


File diff suppressed because it is too large
+ 221 - 455
documentation/manual/es/module_specs/Zend_Form-Forms.xml


+ 142 - 294
documentation/manual/es/module_specs/Zend_Form-QuickStart.xml

@@ -1,71 +1,50 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 19873 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.form.quickstart">
 <sect1 id="zend.form.quickstart">
     <title>Inicio rápido a Zend_Form</title>
     <title>Inicio rápido a Zend_Form</title>
 
 
-    <para>
-        Esta guía rápida pretende cubrir los fundamentos para crear, validar
-        y presentar formularios
-        usando
-        <classname>Zend_Form</classname>
+    <para> Esta guía rápida pretende cubrir los fundamentos para crear, validar
+        y presentar formularios usando <classname>Zend_Form</classname>
     </para>
     </para>
 
 
     <sect2 id="zend.form.quickstart.create">
     <sect2 id="zend.form.quickstart.create">
         <title>Creando un objeto formulario</title>
         <title>Creando un objeto formulario</title>
 
 
-        <para>
-            Crear un objeto de formulario es muy simple: solo instancíe
-            <classname>Zend_Form</classname>
+        <para> Crear un objeto de formulario es muy simple: solo instancíe
+                <classname>Zend_Form</classname>
         </para>
         </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $form = new Zend_Form;
 $form = new Zend_Form;
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Para casos de uso avanzados, es posible desee crear una subclase
-            de
-            <classname>Zend_Form</classname>
-            , pero para formularios simples,
-            puede programar la creación de un formulario usando un
-            objeto
-            <classname>Zend_Form</classname>
+        <para> Para casos de uso avanzados, es posible desee crear una subclase
+            de <classname>Zend_Form</classname> , pero para formularios simples,
+            puede programar la creación de un formulario usando un objeto
+                <classname>Zend_Form</classname>
         </para>
         </para>
 
 
-        <para>
-            Si desea especificar el action y method del formulario (siempre
-            buenas ideas), puede
-            hacer uso de los accesos
-            <methodname>setAction()</methodname>
-            y
-            <methodname>setMethod()</methodname>
-            :
-        </para>
+        <para> Si desea especificar el action y method del formulario (siempre
+            buenas ideas), puede hacer uso de los accesos
+                <methodname>setAction()</methodname> y
+                <methodname>setMethod()</methodname> : </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $form->setAction('/resource/process')
 $form->setAction('/resource/process')
      ->setMethod('post');
      ->setMethod('post');
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            El código de arriba establece el action del formulario a la
-            <acronym>URL</acronym>
-            parcial "/resource/process" y como method
-            <acronym>HTTP</acronym>
-            POST. Esto se
-            mostrará en la presentación final.
-        </para>
+        <para> El código de arriba establece el action del formulario a la
+                <acronym>URL</acronym> parcial "/resource/process" y como method
+                <acronym>HTTP</acronym> POST. Esto se mostrará en la
+            presentación final. </para>
 
 
-        <para>
-            Usted puede establecer atributos
-            <acronym>HTML</acronym>
+        <para> Usted puede establecer atributos <acronym>HTML</acronym>
             adicionales para la etiqueta
             adicionales para la etiqueta
-            <methodname>&lt;form&gt;</methodname>
-            mediante el uso de
+                <methodname>&lt;form&gt;</methodname> mediante el uso de
             los métodos setAttrib() o setAttribs(). Por ejemplo, si desea
             los métodos setAttrib() o setAttribs(). Por ejemplo, si desea
-            especificar el id establezca el atributo "id":
-        </para>
+            especificar el id establezca el atributo "id": </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $form->setAttrib('id', 'login');
 $form->setAttrib('id', 'login');
@@ -75,16 +54,11 @@ $form->setAttrib('id', 'login');
     <sect2 id="zend.form.quickstart.elements">
     <sect2 id="zend.form.quickstart.elements">
         <title>Añadir elementos al formulario</title>
         <title>Añadir elementos al formulario</title>
 
 
-        <para>
-            Un formulario no es nada sin sus elementos.
-            <classname>Zend_Form</classname>
-            contiene de manera
+        <para> Un formulario no es nada sin sus elementos.
+                <classname>Zend_Form</classname> contiene de manera
             predeterminada algunos elementos que generan
             predeterminada algunos elementos que generan
-            <acronym>XHTML</acronym>
-            vía auxiliares
-            <classname>Zend_View</classname>
-            . Son los siguientes:
-        </para>
+                <acronym>XHTML</acronym> vía auxiliares
+                <classname>Zend_View</classname> . Son los siguientes: </para>
 
 
         <itemizedlist>
         <itemizedlist>
             <listitem>
             <listitem>
@@ -93,7 +67,7 @@ $form->setAttrib('id', 'login');
 
 
             <listitem>
             <listitem>
                 <para>checkbox (o varios checkboxes a la vez con multiCheckbox)
                 <para>checkbox (o varios checkboxes a la vez con multiCheckbox)
-               </para>
+                </para>
             </listitem>
             </listitem>
 
 
             <listitem>
             <listitem>
@@ -133,15 +107,11 @@ $form->setAttrib('id', 'login');
             </listitem>
             </listitem>
         </itemizedlist>
         </itemizedlist>
 
 
-        <para>
-            Tiene dos opciones para añadir elementos a un formulario; puede
-            instanciar elementos
-            concretos y pasarlos como objetos, o
+        <para> Tiene dos opciones para añadir elementos a un formulario; puede
+            instanciar elementos concretos y pasarlos como objetos, o
             simplemente puede pasar el tipo de elemento y
             simplemente puede pasar el tipo de elemento y
-            <classname>Zend_Form</classname>
-            instaciará por usted un objeto
-            del tipo correspondiente.
-        </para>
+                <classname>Zend_Form</classname> instaciará por usted un objeto
+            del tipo correspondiente. </para>
 
 
         <para>Algunos ejemplos:</para>
         <para>Algunos ejemplos:</para>
 
 
@@ -153,28 +123,18 @@ $form->addElement(new Zend_Form_Element_Text('username'));
 $form->addElement('text', 'username');
 $form->addElement('text', 'username');
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            De manera predeterminada, éstos no tienen validadores o filtros.
-            Esto significa que
-            tendrá que configurar sus elementos con un mínimo
-            de validadores, y potencialmente
-            filtros. Puede hacer esto (a) antes
-            de pasar el elemento al formulario, (b) vía opciones
-            de
+        <para> De manera predeterminada, éstos no tienen validadores o filtros.
+            Esto significa que tendrá que configurar sus elementos con un mínimo
+            de validadores, y potencialmente filtros. Puede hacer esto (a) antes
+            de pasar el elemento al formulario, (b) vía opciones de
             configuración pasadas cuando crea un elemento a través de
             configuración pasadas cuando crea un elemento a través de
-            <classname>Zend_Form</classname>
-            , o (c) recuperar el elemento
-            del objeto form y configurándolo posteriormente.
-        </para>
+                <classname>Zend_Form</classname> , o (c) recuperar el elemento
+            del objeto form y configurándolo posteriormente. </para>
 
 
-        <para>
-            Veamos primero la creación de validadores para la instancia de un
-            elemento concreto.
-            Puede pasar objetos
-            <classname>Zend_Validate_*</classname>
-            o el nombre de un
-            validador para utilizar:
-        </para>
+        <para> Veamos primero la creación de validadores para la instancia de un
+            elemento concreto. Puede pasar objetos
+                <classname>Zend_Validate_*</classname> o el nombre de un
+            validador para utilizar: </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $username = new Zend_Form_Element_Text('username');
 $username = new Zend_Form_Element_Text('username');
@@ -187,8 +147,7 @@ $username->addValidator('alnum');
 ]]></programlisting>
 ]]></programlisting>
 
 
         <para>Cuando se utiliza esta segunda opción, si el constructor del
         <para>Cuando se utiliza esta segunda opción, si el constructor del
-            validador acepta
-            argumentos, se pueden pasar en un array como tercer
+            validador acepta argumentos, se pueden pasar en un array como tercer
             parámetro:</para>
             parámetro:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
@@ -197,38 +156,33 @@ $username->addValidator('regex', false, array('/^[a-z]/i'));
 ]]></programlisting>
 ]]></programlisting>
 
 
         <para>(El segundo parámetro se utiliza para indicar si el fallo debería
         <para>(El segundo parámetro se utiliza para indicar si el fallo debería
-            prevenir la ejecución
-            de validadores posteriores o no; por defecto,
-            el valor es false.)</para>
+            prevenir la ejecución de validadores posteriores o no; por defecto,
+            el valor es <constant>FALSE</constant>.)</para>
 
 
         <para>Puede también desear especificar un elemento como requerido. Esto
         <para>Puede también desear especificar un elemento como requerido. Esto
-            puede hacerse
-            utilizando un método de acceso o pasando una opción al
-            crear el elemento. En el primer
-            caso:</para>
+            puede hacerse utilizando un método de acceso o pasando una opción al
+            crear el elemento. En el primer caso:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 // Hace este elemento requerido:
 // Hace este elemento requerido:
 $username->setRequired(true);
 $username->setRequired(true);
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>Cuando un elemento es requerido, un validador 'NotEmpty'
-            (NoVacio) es añadido a la
-            parte superior de la cadena de
-            validaciones, asegurando que el elemento tenga algún valor
-            cuando
-            sea requerido.</para>
+        <para>Cuando un elemento es requerido, un validador 'NotEmpty' (NoVacio)
+            es añadido a la parte superior de la cadena de validaciones,
+            asegurando que el elemento tenga algún valor cuando sea
+            requerido.</para>
 
 
-        <para>Los filtros son registrados básicamente de la misma manera que
-            los validadores. Para
-            efectos ilustrativos, vamos a agregar un
-            filtro para poner en minúsculas el valor final:</para>
+        <para>Los filtros son registrados básicamente de la misma manera que los
+            validadores. Para efectos ilustrativos, vamos a agregar un filtro
+            para poner en minúsculas el valor final:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $username->addFilter('StringtoLower');
 $username->addFilter('StringtoLower');
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>Entonces, la configuración final de nuestro elemento queda así:</para>
+        <para>Entonces, la configuración final de nuestro elemento queda
+            así:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $username->addValidator('alnum')
 $username->addValidator('alnum')
@@ -244,21 +198,14 @@ $username->addValidators(array('alnum',
     ->addFilters(array('StringToLower'));
     ->addFilters(array('StringToLower'));
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Tan simple como esto, realizarlo para cada uno de los elementos
-            del formulario puede
-            resultar un poco tedioso. Intentemos la opción
-            (b) arriba mencionada. Cuando creamos un
-            nuevo elemento utilizando
-            <methodname>Zend_Form::addElement()</methodname>
-            como fábrica,
+        <para> Tan simple como esto, realizarlo para cada uno de los elementos
+            del formulario puede resultar un poco tedioso. Intentemos la opción
+            (b) arriba mencionada. Cuando creamos un nuevo elemento utilizando
+                <methodname>Zend_Form::addElement()</methodname> como fábrica,
             opcionalmente podemos pasar las opciones de configuración. Éstas
             opcionalmente podemos pasar las opciones de configuración. Éstas
-            pueden
-            incluir validadores y los filtros que se van a utilizar. Por
-            lo tanto, para hacer todo lo
-            anterior implícitamente, intente lo
-            siguiente:
-        </para>
+            pueden incluir validadores y los filtros que se van a utilizar. Por
+            lo tanto, para hacer todo lo anterior implícitamente, intente lo
+            siguiente: </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $form->addElement('text', 'username', array(
 $form->addElement('text', 'username', array(
@@ -272,32 +219,21 @@ $form->addElement('text', 'username', array(
 ]]></programlisting>
 ]]></programlisting>
 
 
         <note>
         <note>
-            <para>
-                Si encuentra que está asignando elementos con las mismas
-                opciones en varios lugares,
-                podría considerar crear su propia
-                subclase de
-                <classname>Zend_Form_Element</classname>
-                y utilizar
-                ésta; a largo plazo le permitirá escribir menos.
-            </para>
+            <para> Si encuentra que está asignando elementos con las mismas
+                opciones en varios lugares, podría considerar crear su propia
+                subclase de <classname>Zend_Form_Element</classname> y utilizar
+                ésta; a largo plazo le permitirá escribir menos. </para>
         </note>
         </note>
     </sect2>
     </sect2>
 
 
     <sect2 id="zend.form.quickstart.render">
     <sect2 id="zend.form.quickstart.render">
         <title>Generar un formulario</title>
         <title>Generar un formulario</title>
 
 
-        <para>
-            Generar un formulario es simple. La mayoría de los elementos
-            utilizan un auxiliar de
-            <classname>Zend_View</classname>
-            para
+        <para> Generar un formulario es simple. La mayoría de los elementos
+            utilizan un auxiliar de <classname>Zend_View</classname> para
             generarse a sí mismos, por lo tanto necesitan un objeto vista con el
             generarse a sí mismos, por lo tanto necesitan un objeto vista con el
-            fin de
-            generarse. Además, tiene dos opciones: usar el método
-            render() del formulario, o
-            simplemente mostrarlo con echo.
-        </para>
+            fin de generarse. Además, tiene dos opciones: usar el método
+            render() del formulario, o simplemente mostrarlo con echo. </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 // Llamando a render()  explicitamente, y pasando un objeto vista opcional:
 // Llamando a render()  explicitamente, y pasando un objeto vista opcional:
@@ -307,43 +243,26 @@ echo $form->render($view);
 echo $form;
 echo $form;
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            De manera predeterminada,
-            <classname>Zend_Form</classname>
-            y
-            <classname>Zend_Form_Element</classname>
-            intentarán utilizar el
+        <para> De manera predeterminada, <classname>Zend_Form</classname> y
+                <classname>Zend_Form_Element</classname> intentarán utilizar el
             objeto vista inicializado en el
             objeto vista inicializado en el
-            <methodname>ViewRenderer</methodname>
-            , lo que significa que no
+                <methodname>ViewRenderer</methodname> , lo que significa que no
             tendrá que establecer la vista manualmente cuando use el
             tendrá que establecer la vista manualmente cuando use el
-            <acronym>MVC</acronym>
-            de Zend
-            Framework. Generar un formulario en un script vista es tan simple
-            como:
-        </para>
+                <acronym>MVC</acronym> de Zend Framework. Generar un formulario
+            en un script vista es tan simple como: </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 <?php echo $this->form
 <?php echo $this->form
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Detrás del telón,
-            <classname>Zend_Form</classname>
-            utiliza
+        <para> Detrás del telón, <classname>Zend_Form</classname> utiliza
             "decoradores" (decorators) para generar la salida. Estos decoradores
             "decoradores" (decorators) para generar la salida. Estos decoradores
-            pueden
-            reemplazar, añadir o anteponer contenido, y tienen plena
-            introspección al elemento que
-            les es pasado. Como resultado, puede
-            combinar múltiples decoradores para lograr efectos
-            personalizados.
-            Predeterminadamente,
-            <classname>Zend_Form_Element</classname>
+            pueden reemplazar, añadir o anteponer contenido, y tienen plena
+            introspección al elemento que les es pasado. Como resultado, puede
+            combinar múltiples decoradores para lograr efectos personalizados.
+            Predeterminadamente, <classname>Zend_Form_Element</classname>
             actualmente combina cuatro decoradores para obtener su salida; la
             actualmente combina cuatro decoradores para obtener su salida; la
-            configuración sería
-            como sigue:
-        </para>
+            configuración sería como sigue: </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $element->addDecorators(array(
 $element->addDecorators(array(
@@ -355,8 +274,7 @@ $element->addDecorators(array(
 ]]></programlisting>
 ]]></programlisting>
 
 
         <para>(Donde &lt;HELPERNAME&gt; es el nombre de un view helper
         <para>(Donde &lt;HELPERNAME&gt; es el nombre de un view helper
-            que utilizar, y varía según el
-            elemento)</para>
+            que utilizar, y varía según el elemento)</para>
 
 
         <para>Lo anterior crea una salida como la siguiente:</para>
         <para>Lo anterior crea una salida como la siguiente:</para>
 
 
@@ -374,29 +292,19 @@ $element->addDecorators(array(
         <para>(Aunque no con el mismo formato.)</para>
         <para>(Aunque no con el mismo formato.)</para>
 
 
         <para>Puede cambiar los decoradores usados para un elemento si desea
         <para>Puede cambiar los decoradores usados para un elemento si desea
-            tener diferente salida;
-            véase la sección sobre decoradores para
+            tener diferente salida; véase la sección sobre decoradores para
             mayor información.</para>
             mayor información.</para>
 
 
-        <para>El
-            propio formulario simplemente itera sobre los elementos y los
-            cubre en un &lt;form&gt;
-            HTML. El action y method que
-            proporcionó cuando definió el formulario se pasan a la
-            etiqueta
-            <methodname>&lt;form&gt;</methodname>
-            , como cualquier
-            atributo que establezca vía
-            <methodname>setAttribs()</methodname>
-            y
-            familia.
-        </para>
+        <para>El propio formulario simplemente itera sobre los elementos y los
+            cubre en un &lt;form&gt; HTML. El action y method que
+            proporcionó cuando definió el formulario se pasan a la etiqueta
+                <methodname>&lt;form&gt;</methodname> , como cualquier
+            atributo que establezca vía <methodname>setAttribs()</methodname> y
+            familia. </para>
 
 
         <para>Elementos son desplegados en el orden en el que fueron
         <para>Elementos son desplegados en el orden en el que fueron
-            registrados, o, si el elemento
-            contienen un atributo de orden, ese
-            orden será utilizado. Usted puede fijar el orden de
-            un elemento
+            registrados, o, si el elemento contienen un atributo de orden, ese
+            orden será utilizado. Usted puede fijar el orden de un elemento
             usando:</para>
             usando:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
@@ -414,23 +322,14 @@ $form->addElement('text', 'username', array('order' => 10));
         <title>Comprobar si un formulario es válido</title>
         <title>Comprobar si un formulario es válido</title>
 
 
         <para>Después que un formulario es enviado, necesitará comprobar y ver
         <para>Después que un formulario es enviado, necesitará comprobar y ver
-            si pasa las
-            validaciones. Cada elemento es valuado contra los datos
-            provistos; si una clave no está
-            presente y el campo fue marcado como
-            requerido, la validación se ejecuta contra un valor
-            nulo.</para>
-
-        <para>
-            ¿De dónde provienen los datos?. Puede usar
-            <varname>$_POST</varname>
-            o
-            <varname>$_GET</varname>
-            , o
+            si pasa las validaciones. Cada elemento es valuado contra los datos
+            provistos; si una clave no está presente y el campo fue marcado como
+            requerido, la validación se ejecuta contra un valor <constant>NULL</constant>.</para>
+
+        <para> ¿De dónde provienen los datos?. Puede usar
+                <varname>$_POST</varname> o <varname>$_GET</varname> , o
             cualquier otra fuente de datos que tenga a mano (solicitud de un
             cualquier otra fuente de datos que tenga a mano (solicitud de un
-            servicio web, por
-            ejemplo):
-        </para>
+            servicio web, por ejemplo): </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 if ($form->isValid($_POST)) {
 if ($form->isValid($_POST)) {
@@ -440,20 +339,12 @@ if ($form->isValid($_POST)) {
 }
 }
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Con solicitudes
-            <acronym>AJAX</acronym>
-            , a veces puede ignorar la
-            validación de un solo elemento, o grupo de elementos.
-            <methodname>isValidPartial()</methodname>
-            validará parcialmente
-            el formulario. A diferencia de
-            <methodname>isValid()</methodname>
-            ,
+        <para> Con solicitudes <acronym>AJAX</acronym> , a veces puede ignorar
+            la validación de un solo elemento, o grupo de elementos.
+                <methodname>isValidPartial()</methodname> validará parcialmente
+            el formulario. A diferencia de <methodname>isValid()</methodname> ,
             que como sea, si alguna clave no esta presente, no ejecutará las
             que como sea, si alguna clave no esta presente, no ejecutará las
-            validaciones para ese
-            elemento en particular.
-        </para>
+            validaciones para ese elemento en particular. </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 if ($form->isValidPartial($_POST)) {
 if ($form->isValidPartial($_POST)) {
@@ -463,38 +354,28 @@ if ($form->isValidPartial($_POST)) {
 }
 }
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Un método adicional,
-            <methodname>processAjax()</methodname>
-            ,
+        <para> Un método adicional, <methodname>processAjax()</methodname> ,
             puede también ser usado para validar formularios parciales. A
             puede también ser usado para validar formularios parciales. A
-            diferencia de
-            <methodname>isValidPartial()</methodname>
-            , regresa una
-            cadena en formato
-            <acronym>JSON</acronym>
-            -formatted conteniendo mensajes de
-            error en caso de fallo.
-        </para>
+            diferencia de <methodname>isValidPartial()</methodname> , regresa
+            una cadena en formato <acronym>JSON</acronym> -formatted conteniendo
+            mensajes de error en caso de fallo. </para>
 
 
-        <para>Asumiendo que sus validaciones han pasado, ahora puede obtener
-            los valores filtrados:</para>
+        <para>Asumiendo que sus validaciones han pasado, ahora puede obtener los
+            valores filtrados:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $values = $form->getValues();
 $values = $form->getValues();
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>Si necesita los valores sin filtrar en algún punto, utilice:</para>
+        <para>Si necesita los valores sin filtrar en algún punto,
+            utilice:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $unfiltered = $form->getUnfilteredValues();
 $unfiltered = $form->getUnfilteredValues();
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            If you on the other hand need all the valid and filtered values of a partially valid
-            form,
-            you can call:
-        </para>
+        <para> If you on the other hand need all the valid and filtered values
+            of a partially valid form, you can call: </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $values = $form->getValidValues($_POST);
 $values = $form->getValidValues($_POST);
@@ -505,11 +386,9 @@ $values = $form->getValidValues($_POST);
     <sect2 id="zend.form.quickstart.errorstatus">
     <sect2 id="zend.form.quickstart.errorstatus">
         <title>Obteniendo el estado de error</title>
         <title>Obteniendo el estado de error</title>
 
 
-        <para>Entonces, ¿su formulario no es válido? En la mayoría de los
-            casos, simplemente puede
-            generar el formulario nuevamente y los
-            errores se mostrarán cuando se usen los
-            decoradores predeterminados:</para>
+        <para>Entonces, ¿su formulario no es válido? En la mayoría de los casos,
+            simplemente puede generar el formulario nuevamente y los errores se
+            mostrarán cuando se usen los decoradores predeterminados:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 if (!$form->isValid($_POST)) {
 if (!$form->isValid($_POST)) {
@@ -521,20 +400,14 @@ if (!$form->isValid($_POST)) {
 }
 }
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Si quiere inspeccionar los errores, tiene dos métodos.
-            <methodname>getErrors()</methodname>
-            regresa una matriz
+        <para> Si quiere inspeccionar los errores, tiene dos métodos.
+                <methodname>getErrors()</methodname> regresa una matriz
             asociativa de nombres / códigos de elementos (donde códigos es una
             asociativa de nombres / códigos de elementos (donde códigos es una
-            matriz de códigos de error).
-            <methodname>getMessages()</methodname>
+            matriz de códigos de error). <methodname>getMessages()</methodname>
             regresa una matriz asociativa de nombres / mensajes de elementos
             regresa una matriz asociativa de nombres / mensajes de elementos
-            (donde mensajes es una
-            matriz asociativa de pares código de error /
-            mensaje de error). Si un elemento no tiene
-            ningún error, no será
-            incluido en la matriz.
-        </para>
+            (donde mensajes es una matriz asociativa de pares código de error /
+            mensaje de error). Si un elemento no tiene ningún error, no será
+            incluido en la matriz. </para>
     </sect2>
     </sect2>
 
 
     <sect2 id="zend.form.quickstart.puttingtogether">
     <sect2 id="zend.form.quickstart.puttingtogether">
@@ -556,21 +429,15 @@ if (!$form->isValid($_POST)) {
         </itemizedlist>
         </itemizedlist>
 
 
         <para>Para nuestros propósitos, vamos a suponer que un usuario válido
         <para>Para nuestros propósitos, vamos a suponer que un usuario válido
-            cumplirá con tener solo
-            caracteres alfanuméricos, comenzar con una
-            letra, tener una longitud mínima de 6
-            caracteres y una longitud
+            cumplirá con tener solo caracteres alfanuméricos, comenzar con una
+            letra, tener una longitud mínima de 6 caracteres y una longitud
             máxima de 20 caracteres; se normalizarán en minúsculas. Las
             máxima de 20 caracteres; se normalizarán en minúsculas. Las
             contraseñas deben tener un mínimo de 6 caracteres. Cuando se procese
             contraseñas deben tener un mínimo de 6 caracteres. Cuando se procese
-            vamos simplemente a
-            mostrar el valor, por lo que puede permanecer
+            vamos simplemente a mostrar el valor, por lo que puede permanecer
             inválido.</para>
             inválido.</para>
 
 
-        <para>
-            Usaremos el poder de la opciones de configuración de
-            <classname>Zend_Form</classname>
-            para crear el formulario:
-        </para>
+        <para> Usaremos el poder de la opciones de configuración de
+                <classname>Zend_Form</classname> para crear el formulario: </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $form = new Zend_Form();
 $form = new Zend_Form();
@@ -597,7 +464,8 @@ $form->addElement($username)
      ->addElement('submit', 'login', array('label' => 'Login'));
      ->addElement('submit', 'login', array('label' => 'Login'));
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>A continuación, vamos a crear un controlador para manejar esto:</para>
+        <para>A continuación, vamos a crear un controlador para manejar
+            esto:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 class UserController extends Zend_Controller_Action
 class UserController extends Zend_Controller_Action
@@ -640,41 +508,25 @@ class UserController extends Zend_Controller_Action
 <?php echo $this->form
 <?php echo $this->form
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Como notará en el código del controlador, hay más trabajo por
-            hacer: mientras la
-            información enviada sea válida, necesitará
+        <para> Como notará en el código del controlador, hay más trabajo por
+            hacer: mientras la información enviada sea válida, necesitará
             todavía realizar la autenticación usando
             todavía realizar la autenticación usando
-            <classname>Zend_Auth</classname>
-            , por ejemplo.
-        </para>
+                <classname>Zend_Auth</classname> , por ejemplo. </para>
     </sect2>
     </sect2>
 
 
     <sect2 id="zend.form.quickstart.config">
     <sect2 id="zend.form.quickstart.config">
         <title>Usando un objeto Zend_Config</title>
         <title>Usando un objeto Zend_Config</title>
 
 
-        <para>
-            Todas las clases
-            <classname>Zend_Form</classname>
-            son
-            configurables mediante
-            <classname>Zend_Config</classname>
-            ; puede
+        <para> Todas las clases <classname>Zend_Form</classname> son
+            configurables mediante <classname>Zend_Config</classname> ; puede
             incluso pasar un objeto al constructor o pasarlo a través de
             incluso pasar un objeto al constructor o pasarlo a través de
-            <methodname>setConfig()</methodname>
-            . Veamos cómo podemos crear
-            el formulario anterior usando un archivo
-            <acronym>INI</acronym>
-            .
+                <methodname>setConfig()</methodname> . Veamos cómo podemos crear
+            el formulario anterior usando un archivo <acronym>INI</acronym> .
             Primero, vamos a seguir las recomendaciones, y colocaremos nuestras
             Primero, vamos a seguir las recomendaciones, y colocaremos nuestras
-            configuraciones
-            dentro de secciones reflejando su objetivo y y
-            enfocándonos en la sección 'development'.
-            A continuación, pondremos
-            en una sección de configuración para el controlador dado
-            ('user'), y
-            una clave para el formulario ('login'):
-        </para>
+            configuraciones dentro de secciones reflejando su objetivo y y
+            enfocándonos en la sección 'development'. A continuación, pondremos
+            en una sección de configuración para el controlador dado ('user'), y
+            una clave para el formulario ('login'): </para>
 
 
         <programlisting language="ini"><![CDATA[
         <programlisting language="ini"><![CDATA[
 [development]
 [development]
@@ -716,13 +568,9 @@ $form   = new Zend_Form($config->user->login);
     <sect2 id="zend.form.quickstart.conclusion">
     <sect2 id="zend.form.quickstart.conclusion">
         <title>Conclusión</title>
         <title>Conclusión</title>
 
 
-        <para>
-            Esperamos que después de este pequeño tutorial sea capaz de
-            descubrir el poder y
-            flexibilidad de
-            <classname>Zend_Form</classname>
-            . Continúe leyendo para
-            profundizar más en el tema.
-        </para>
+        <para> Esperamos que después de este pequeño tutorial sea capaz de
+            descubrir el poder y flexibilidad de
+                <classname>Zend_Form</classname> . Continúe leyendo para
+            profundizar más en el tema. </para>
     </sect2>
     </sect2>
 </sect1>
 </sect1>

+ 3 - 3
documentation/manual/es/module_specs/Zend_Form-StandardDecorators.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.form.standardDecorators">
 <sect1 id="zend.form.standardDecorators">
     <title>Decoradores de Formulario (Form Decorartors) estándar contenidos en
     <title>Decoradores de Formulario (Form Decorartors) estándar contenidos en
@@ -40,7 +40,7 @@ class Util
             reemplazará, antepondrá o postpondrá el contenido original con el
             reemplazará, antepondrá o postpondrá el contenido original con el
             que devuelva. </para>
             que devuelva. </para>
 
 
-        <para> El decorador Callback permite especificar un valor null para la
+        <para> El decorador Callback permite especificar un valor <constant>NULL</constant> para la
             opción placement (colocación), que reemplazará el contenido original
             opción placement (colocación), que reemplazará el contenido original
             con el valor devuelto de la llamada de retorno; 'prepend'
             con el valor devuelto de la llamada de retorno; 'prepend'
             (anteponer) y 'append' (postponer) siguen siendo válidas. </para>
             (anteponer) y 'append' (postponer) siguen siendo válidas. </para>
@@ -496,7 +496,7 @@ $element->setDecorators(array(array('ViewScript',
             <para> Resulta interesante que el script de vista reemplace el
             <para> Resulta interesante que el script de vista reemplace el
                 contenido provisto por el decorador -- por ejemplo, si desea
                 contenido provisto por el decorador -- por ejemplo, si desea
                 encapsularlo. Puede hacer esto especificando un valor booleano
                 encapsularlo. Puede hacer esto especificando un valor booleano
-                false en la opción 'placement' del decorador: </para>
+                <constant>FALSE</constant>  en la opción 'placement' del decorador: </para>
 
 
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 // En la creación del decorador:
 // En la creación del decorador:

+ 5 - 5
documentation/manual/es/module_specs/Zend_Form-StandardElements.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 17663 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.form.standardElements">
 <sect1 id="zend.form.standardElements">
     <title>Elementos Enviados en el Formulario Estandard de Zend
     <title>Elementos Enviados en el Formulario Estandard de Zend
@@ -498,7 +498,7 @@ $form->addElement('hash', 'no_csrf_foo', array('salt' => 'unique'));
             de llaves de las opciones registradas. Se puede desactivar esta
             de llaves de las opciones registradas. Se puede desactivar esta
             caracteristica llamando a
             caracteristica llamando a
                 <methodname>setRegisterInArrayValidator(false)</methodname> , o
                 <methodname>setRegisterInArrayValidator(false)</methodname> , o
-            pasando un valor falso a la configuración de llaves
+            pasando un valor <constant>FALSE</constant> a la configuración de llaves
                 <methodname>registerInArrayValidator</methodname> . </para>
                 <methodname>registerInArrayValidator</methodname> . </para>
 
 
         <para>Se puede manipular las opciones de checkbox usando los siguinetes
         <para>Se puede manipular las opciones de checkbox usando los siguinetes
@@ -630,7 +630,7 @@ $element->setValue(array('bar', 'bat'));
             de llaves de opciones registradas. se puede deshabilitar esta
             de llaves de opciones registradas. se puede deshabilitar esta
             caracteristica llamando a
             caracteristica llamando a
                 <methodname>setRegisterInArrayValidator(false)</methodname> , o
                 <methodname>setRegisterInArrayValidator(false)</methodname> , o
-            pasando un valor falso a la configuracion de llaves
+            pasando un valor <constant>FALSE</constant> a la configuracion de llaves
                 <methodname>registerInArrayValidator</methodname> . </para>
                 <methodname>registerInArrayValidator</methodname> . </para>
     </sect2>
     </sect2>
 
 
@@ -665,7 +665,7 @@ $element->setValue(array('bar', 'bat'));
             de llaves de opciones registradas. se puede deshabilitar esta
             de llaves de opciones registradas. se puede deshabilitar esta
             caracteristica llamando a
             caracteristica llamando a
                 <methodname>setRegisterInArrayValidator(false)</methodname> , o
                 <methodname>setRegisterInArrayValidator(false)</methodname> , o
-            pasando un valor falso a la configuracion de llaves
+            pasando un valor <constant>FALSE</constant> a la configuracion de llaves
                 <methodname>registerInArrayValidator</methodname> .
                 <methodname>registerInArrayValidator</methodname> .
             configuration key. </para>
             configuration key. </para>
 
 
@@ -745,7 +745,7 @@ $element->setValue(array('bar', 'bat'));
             de llaves de opciones registradas. se puede deshabilitar esta
             de llaves de opciones registradas. se puede deshabilitar esta
             caracteristica llamando a
             caracteristica llamando a
                 <methodname>setRegisterInArrayValidator(false)</methodname> , o
                 <methodname>setRegisterInArrayValidator(false)</methodname> , o
-            pasando un valor falso a la configuracion de llaves
+            pasando un valor <constant>FALSE</constant> a la configuracion de llaves
                 <methodname>registerInArrayValidator</methodname> .
                 <methodname>registerInArrayValidator</methodname> .
             configuration key. </para>
             configuration key. </para>
 
 

+ 333 - 683
documentation/manual/es/module_specs/Zend_Json-Server.xml

@@ -1,39 +1,29 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 19477 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.json.server">
 <sect1 id="zend.json.server">
     <title>Zend_Json_Server - servidor JSON-RPC</title>
     <title>Zend_Json_Server - servidor JSON-RPC</title>
 
 
     <para>
     <para>
-        <classname>Zend_Json_Server</classname>
-        es una implementación del
-        servidor
-        <ulink url="http://groups.google.com/group/json-rpc/">JSON-RPC</ulink>
-        Soporta tanto la versión 1 de la especificación
-        <ulink url="http://json-rpc.org/wiki/specification">JSON-RPC</ulink>
-        así como la especificación de la
-        <ulink url="http://groups.google.com/group/json-rpc/web/json-rpc-1-2-proposal">versión
-            2</ulink>
-        ; además, provee una implementación de
-        <acronym>PHP</acronym>
-        de la especificación del
-        <ulink url="http://groups.google.com/group/json-schema/web/service-mapping-description-proposal">Service
-            Mapping Description (SMD)</ulink>
-        para prestar un servicio
-        de metadatos a consumidores del servicio.
-    </para>
-
-    <para>
-        JSON-RPC es un protocolo liviano de Remote Procedure Call que utiliza
-        JSON para envolver sus
-        mensajes. Esta implementación JSON-RPC sigue la
-        <acronym>API</acronym>
-        <acronym>PHP</acronym>
-        de
-        <ulink url="http://us.php.net/manual/en/function.soap-soapserver-construct.php">SoapServer</ulink>
-        . Esto significa que, en una situación típica,
-        simplemente:
-    </para>
+        <classname>Zend_Json_Server</classname> es una implementación del
+        servidor <ulink url="http://groups.google.com/group/json-rpc/"
+            >JSON-RPC</ulink> Soporta tanto la versión 1 de la especificación
+            <ulink url="http://json-rpc.org/wiki/specification">JSON-RPC</ulink>
+        así como la especificación de la <ulink
+            url="http://groups.google.com/group/json-rpc/web/json-rpc-1-2-proposal"
+            >versión 2</ulink> ; además, provee una implementación de
+            <acronym>PHP</acronym> de la especificación del <ulink
+            url="http://groups.google.com/group/json-schema/web/service-mapping-description-proposal"
+            >Service Mapping Description (SMD)</ulink> para prestar un servicio
+        de metadatos a consumidores del servicio. </para>
+
+    <para> JSON-RPC es un protocolo liviano de Remote Procedure Call que utiliza
+        JSON para envolver sus mensajes. Esta implementación JSON-RPC sigue la
+            <acronym>API</acronym>
+        <acronym>PHP</acronym> de <ulink
+            url="http://us.php.net/manual/en/function.soap-soapserver-construct.php"
+            >SoapServer</ulink> . Esto significa que, en una situación típica,
+        simplemente: </para>
 
 
     <itemizedlist>
     <itemizedlist>
         <listitem>
         <listitem>
@@ -49,20 +39,13 @@
     </itemizedlist>
     </itemizedlist>
 
 
     <para>
     <para>
-        <classname>Zend_Json_Server</classname>
-        utiliza
-        <xref linkend="zend.server.reflection"/>
-        para realizar reflexión sobre
+        <classname>Zend_Json_Server</classname> utiliza <xref
+            linkend="zend.server.reflection"/> para realizar reflexión sobre
         cualquiera de las clases o funciones agregadas, y utiliza esa
         cualquiera de las clases o funciones agregadas, y utiliza esa
         información para construir tanto la SMD y hacer cumplir el método de
         información para construir tanto la SMD y hacer cumplir el método de
-        llamado de firmas. Como
-        tal, es imperativo que cualquier de las
-        funciones agregadas y/o los métodos de clase tengan
-        mínimamente una
-        plena documentación de
-        <acronym>PHP</acronym>
-        docblocks:
-    </para>
+        llamado de firmas. Como tal, es imperativo que cualquier de las
+        funciones agregadas y/o los métodos de clase tengan mínimamente una
+        plena documentación de <acronym>PHP</acronym> docblocks: </para>
 
 
     <itemizedlist>
     <itemizedlist>
         <listitem>
         <listitem>
@@ -74,25 +57,19 @@
     </itemizedlist>
     </itemizedlist>
 
 
     <para>
     <para>
-        <classname>Zend_Json_Server</classname>
-        escucha por solicitudes POST
+        <classname>Zend_Json_Server</classname> escucha por solicitudes POST
         únicamente en este momento; afortunadamente, la mayoría de las
         únicamente en este momento; afortunadamente, la mayoría de las
         implementaciones del cliente JSON-RPC en los medios en el momento de
         implementaciones del cliente JSON-RPC en los medios en el momento de
-        escribir esto, sólo
-        requieren a POST como es. Esto hace que sea fácil de
-        utilizar el mismo punto final del
-        servidor para manejar a ambas
-        peticiones así como para entregar el servicio SMD, como se
-        muestra en el
-        siguiente ejemplo.
-    </para>
+        escribir esto, sólo requieren a POST como es. Esto hace que sea fácil de
+        utilizar el mismo punto final del servidor para manejar a ambas
+        peticiones así como para entregar el servicio SMD, como se muestra en el
+        siguiente ejemplo. </para>
 
 
     <example id="zend.json.server.usage">
     <example id="zend.json.server.usage">
         <title>Uso de Zend_Json_Server</title>
         <title>Uso de Zend_Json_Server</title>
 
 
         <para>Primero, definir una clase que queramos exponer vía servidor
         <para>Primero, definir una clase que queramos exponer vía servidor
-            JSON-RPC. Vamos a la clase
-            'Calculator', y definir los métodos para
+            JSON-RPC. Vamos a la clase 'Calculator', y definir los métodos para
             'add', 'subtract', 'multiply', y 'divide':</para>
             'add', 'subtract', 'multiply', y 'divide':</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
@@ -151,18 +128,11 @@ class Calculator
 }
 }
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Nótese que cada método tiene un docblock con entradas indicando
-            cada parámetro y su tipo,
-            así como una entrada para el valor de
-            retorno. Esto es
-            <emphasis>absolutamente crítico</emphasis>
-            cuando
-            se usa
-            <classname>Zend_Json_Server</classname>
-            -- o cualquier otro
-            componente del servidor en Zend Framework, por esa cuestión.
-        </para>
+        <para> Nótese que cada método tiene un docblock con entradas indicando
+            cada parámetro y su tipo, así como una entrada para el valor de
+            retorno. Esto es <emphasis>absolutamente crítico</emphasis> cuando
+            se usa <classname>Zend_Json_Server</classname> -- o cualquier otro
+            componente del servidor en Zend Framework, por esa cuestión. </para>
 
 
         <para>Ahora, crearemos un script para manejar las peticiones:</para>
         <para>Ahora, crearemos un script para manejar las peticiones:</para>
 
 
@@ -176,16 +146,11 @@ $server->setClass('Calculator');
 $server->handle();
 $server->handle();
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Sin embargo, esto no soluciona el problema de devolución de un
-            SMD para que el cliente
-            JSON-RPC pueda autodescubrir los métodos.
-            Esto puede lograrse determinando el método del
-            requerimiento
-            <acronym>HTTP</acronym>
-            , y
-            luego especificando algún servidor de metadatos:
-        </para>
+        <para> Sin embargo, esto no soluciona el problema de devolución de un
+            SMD para que el cliente JSON-RPC pueda autodescubrir los métodos.
+            Esto puede lograrse determinando el método del requerimiento
+                <acronym>HTTP</acronym> , y luego especificando algún servidor
+            de metadatos: </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $server = new Zend_Json_Server();
 $server = new Zend_Json_Server();
@@ -209,8 +174,7 @@ $server->handle();
 ]]></programlisting>
 ]]></programlisting>
 
 
         <para>Si utiliza el servidor JSON-RPC con Dojo toolkit, también
         <para>Si utiliza el servidor JSON-RPC con Dojo toolkit, también
-            necesitará establecer un flag
-            de compatibilidad especial para
+            necesitará establecer un flag de compatibilidad especial para
             garantizar que los dos interoperen correctamente:</para>
             garantizar que los dos interoperen correctamente:</para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
@@ -237,127 +201,93 @@ $server->handle();
     <sect2 id="zend.json.server.details">
     <sect2 id="zend.json.server.details">
         <title>Detalles Avanzados</title>
         <title>Detalles Avanzados</title>
 
 
-        <para>
-            Aunque la mayor funcionalidad de
-            <classname>Zend_Json_Server</classname>
-            se puntualiza en
-            <xref linkend="zend.json.server.usage"/>
-            , hay más funcionalidad
-            avanzada disponible.
-        </para>
+        <para> Aunque la mayor funcionalidad de
+                <classname>Zend_Json_Server</classname> se puntualiza en <xref
+                linkend="zend.json.server.usage"/> , hay más funcionalidad
+            avanzada disponible. </para>
 
 
         <sect3 id="zend.json.server.details.zendjsonserver">
         <sect3 id="zend.json.server.details.zendjsonserver">
             <title>Zend_Json_Server</title>
             <title>Zend_Json_Server</title>
 
 
             <para>
             <para>
-                <classname>Zend_Json_Server</classname>
-                es la clase núcleo en la
+                <classname>Zend_Json_Server</classname> es la clase núcleo en la
                 propuesta JSON-RPC; que maneja todas las peticiones y como
                 propuesta JSON-RPC; que maneja todas las peticiones y como
                 respuesta devuelve un conjunto de datos. Tiene los siguientes
                 respuesta devuelve un conjunto de datos. Tiene los siguientes
-                métodos:
-            </para>
+                métodos: </para>
 
 
             <itemizedlist>
             <itemizedlist>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>addFunction($function)</methodname>
-                        :
+                        <methodname>addFunction($function)</methodname> :
                         Especifica la función de espacio del usuario para
                         Especifica la función de espacio del usuario para
-                        agregar al servidor.
-                    </para>
+                        agregar al servidor. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setClass($class)</methodname>
-                        : Especifica
+                        <methodname>setClass($class)</methodname> : Especifica
                         una clase u objeto para agregar al servidor; todos los
                         una clase u objeto para agregar al servidor; todos los
-                        métodos
-                        públicos de ese item serán expuestos como
-                        métodos JSON-RPC.
-                    </para>
+                        métodos públicos de ese item serán expuestos como
+                        métodos JSON-RPC. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
                         <methodname>fault($fault = null, $code = 404, $data =
                         <methodname>fault($fault = null, $code = 404, $data =
-                            null)</methodname>
-                        : Crea y devuelve un objeto
-                        <classname>Zend_Json_Server_Error</classname>
-                        .
+                            null)</methodname> : Crea y devuelve un objeto
+                            <classname>Zend_Json_Server_Error</classname> .
                     </para>
                     </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>handle($request = false)</methodname>
-                        :
+                        <methodname>handle($request = false)</methodname> :
                         Maneja una solicitud JSON-RPC; opcionalmente, pasa un
                         Maneja una solicitud JSON-RPC; opcionalmente, pasa un
-                        objeto
-                        <classname>Zend_Json_Server_Request</classname>
-                        a
-                        utlizar (crea uno por defecto).
-                    </para>
+                        objeto <classname>Zend_Json_Server_Request</classname> a
+                        utlizar (crea uno por defecto). </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getFunctions()</methodname>
-                        : Devuelve una
-                        lista de todos los métodos agregados.
-                    </para>
+                        <methodname>getFunctions()</methodname> : Devuelve una
+                        lista de todos los métodos agregados. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
                         <methodname>setRequest(Zend_Json_Server_Request
                         <methodname>setRequest(Zend_Json_Server_Request
-                            $request)</methodname>
-                        : Especifica un objeto
-                        solicitud para el servidor a utilizar.
-                    </para>
+                            $request)</methodname> : Especifica un objeto
+                        solicitud para el servidor a utilizar. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getRequest()</methodname>
-                        : Recupera el
-                        objeto solicitud usado por el servidor.
-                    </para>
+                        <methodname>getRequest()</methodname> : Recupera el
+                        objeto solicitud usado por el servidor. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
                         <methodname>setResponse(Zend_Json_Server_Response
                         <methodname>setResponse(Zend_Json_Server_Response
-                            $response)</methodname>
-                        : Establece el objeto
-                        respuesta para el servidor a utilizar.
-                    </para>
+                            $response)</methodname> : Establece el objeto
+                        respuesta para el servidor a utilizar. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getResponse()</methodname>
-                        : Recupera el
-                        objeto respuesta usado por el servidor.
-                    </para>
+                        <methodname>getResponse()</methodname> : Recupera el
+                        objeto respuesta usado por el servidor. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setAutoEmitResponse($flag)</methodname>
-                        :
+                        <methodname>setAutoEmitResponse($flag)</methodname> :
                         Indica si el servidor debería emitir automáticamente la
                         Indica si el servidor debería emitir automáticamente la
-                        respuesta y todas
-                        las cabeceras; por defecto, esto es
-                        verdadero.
-                    </para>
+                        respuesta y todas las cabeceras; por defecto, esto es
+                        <constant>TRUE</constant>. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>autoEmitResponse()</methodname>
-                        : Determina
-                        si la auto-emisión de la respuesta está
-                        habilitada.
+                        <methodname>autoEmitResponse()</methodname> : Determina
+                        si la auto-emisión de la respuesta está habilitada.
                     </para>
                     </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getServiceMap()</methodname>
-                        : Recupera la
+                        <methodname>getServiceMap()</methodname> : Recupera la
                         descripción del mapa de servicio en el form de un objeto
                         descripción del mapa de servicio en el form de un objeto
-                        <classname>Zend_Json_Server_Smd</classname>
-                        .
+                            <classname>Zend_Json_Server_Smd</classname> .
                     </para>
                     </para>
                 </listitem>
                 </listitem>
             </itemizedlist>
             </itemizedlist>
@@ -366,298 +296,208 @@ $server->handle();
         <sect3 id="zend.json.server.details.zendjsonserverrequest">
         <sect3 id="zend.json.server.details.zendjsonserverrequest">
             <title>Zend_Json_Server_Request</title>
             <title>Zend_Json_Server_Request</title>
 
 
-            <para>
-                El medio ambiente de una solicitud JSON-RPC está encapsulado
-                en el objeto
-                <classname>Zend_Json_Server_Request</classname>
-                .
+            <para> El medio ambiente de una solicitud JSON-RPC está encapsulado
+                en el objeto <classname>Zend_Json_Server_Request</classname> .
                 Este objeto le permite establecer porciones necesarias de la
                 Este objeto le permite establecer porciones necesarias de la
-                solicitud JSON-RPC,
-                incluida el ID de la solicitud, parámetros y
-                especificaciones de la versión JSON-RPC.
-                Tiene la capacidad de
+                solicitud JSON-RPC, incluida el ID de la solicitud, parámetros y
+                especificaciones de la versión JSON-RPC. Tiene la capacidad de
                 cargarse a sí mismo via JSON o un conjunto de opciones, y puede
                 cargarse a sí mismo via JSON o un conjunto de opciones, y puede
                 mostrase a si mismo como JSON vía el método
                 mostrase a si mismo como JSON vía el método
-                <methodname>toJson()</methodname>
-                .
-            </para>
+                    <methodname>toJson()</methodname> . </para>
 
 
-            <para>El objeto solicitud tiene los siguientes métodos disponibles:</para>
+            <para>El objeto solicitud tiene los siguientes métodos
+                disponibles:</para>
 
 
             <itemizedlist>
             <itemizedlist>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setOptions(array $options)</methodname>
-                        :
+                        <methodname>setOptions(array $options)</methodname> :
                         Especifica la configuración del objeto.
                         Especifica la configuración del objeto.
-                        <varname>$options</varname>
-                        puede contener claves
+                            <varname>$options</varname> puede contener claves
                         que concuerden con cualuier método 'set':
                         que concuerden con cualuier método 'set':
-                        <methodname>setParams()</methodname>
-                        ,
-                        <methodname>setMethod()</methodname>
-                        ,
-                        <methodname>setId()</methodname>
-                        , y
-                        <methodname>setVersion()</methodname>
-                        .
-                    </para>
+                            <methodname>setParams()</methodname> ,
+                            <methodname>setMethod()</methodname> ,
+                            <methodname>setId()</methodname> , y
+                            <methodname>setVersion()</methodname> . </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>addParam($value, $key =
-                            null)</methodname>
-                        : Agrega un parámetro para usar con el
-                        método de llamada. Los parámetros
-                        pueden ser sólo los
-                        valores, o pueden incluir opcionalmente el nombre del
-                        parámetro.
-                    </para>
+                        <methodname>addParam($value, $key = null)</methodname> :
+                        Agrega un parámetro para usar con el método de llamada.
+                        Los parámetros pueden ser sólo los valores, o pueden
+                        incluir opcionalmente el nombre del parámetro. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>addParams(array $params)</methodname>
-                        :
+                        <methodname>addParams(array $params)</methodname> :
                         Agrega múltiples parámetros a la vez; proxies a
                         Agrega múltiples parámetros a la vez; proxies a
-                        <methodname>addParam()</methodname>
+                            <methodname>addParam()</methodname>
                     </para>
                     </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setParams(array $params)</methodname>
-                        :
+                        <methodname>setParams(array $params)</methodname> :
                         Establece todos los parámetros a la vez; sobrescribe
                         Establece todos los parámetros a la vez; sobrescribe
-                        cualquiera de los
-                        parámetros existentes.
-                    </para>
+                        cualquiera de los parámetros existentes. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getParam($index)</methodname>
-                        : Recupera un
-                        parámetro por posición o por el nombre.
-                    </para>
+                        <methodname>getParam($index)</methodname> : Recupera un
+                        parámetro por posición o por el nombre. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getParams()</methodname>
-                        : Recupera todos
-                        los parámetros a la vez.
-                    </para>
+                        <methodname>getParams()</methodname> : Recupera todos
+                        los parámetros a la vez. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setMethod($name)</methodname>
-                        : Establece
-                        el método para llamar.
-                    </para>
+                        <methodname>setMethod($name)</methodname> : Establece el
+                        método para llamar. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getMethod()</methodname>
-                        : Recupera el
-                        método que será llamado.
-                    </para>
+                        <methodname>getMethod()</methodname> : Recupera el
+                        método que será llamado. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>isMethodError()</methodname>
-                        : Determinar
-                        si la solicitud está malformada o no y si daría como
-                        resultado un
-                        error.
-                    </para>
+                        <methodname>isMethodError()</methodname> : Determinar si
+                        la solicitud está malformada o no y si daría como
+                        resultado un error. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setId($name)</methodname>
-                        : Establecer el
+                        <methodname>setId($name)</methodname> : Establecer el
                         identificador de solicitud(utilizado por el cliente para
                         identificador de solicitud(utilizado por el cliente para
-                        igualar las solicitudes de respuestas).
-                    </para>
+                        igualar las solicitudes de respuestas). </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getId()</methodname>
-                        : Recuperar el
-                        identificador de solicitudes.
-                    </para>
+                        <methodname>getId()</methodname> : Recuperar el
+                        identificador de solicitudes. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setVersion($version)</methodname>
-                        :
+                        <methodname>setVersion($version)</methodname> :
                         Establecer la versión de la especificación JSON-RPC que
                         Establecer la versión de la especificación JSON-RPC que
-                        conforma la
-                        solicitud. Puede ser '1.0' o '2.0'.
-                    </para>
+                        conforma la solicitud. Puede ser '1.0' o '2.0'. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getVersion()</methodname>
-                        : Recuperar la
+                        <methodname>getVersion()</methodname> : Recuperar la
                         versión de la especificación JSON-RPC utilizados por la
                         versión de la especificación JSON-RPC utilizados por la
-                        solicitud.
-                    </para>
+                        solicitud. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>loadJson($json)</methodname>
-                        : Cargar el
-                        objeto solicitud de una cadena JSON.
-                    </para>
+                        <methodname>loadJson($json)</methodname> : Cargar el
+                        objeto solicitud de una cadena JSON. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>toJson()</methodname>
-                        : Mostrar la
-                        solicitud como un string JSON.
-                    </para>
+                        <methodname>toJson()</methodname> : Mostrar la solicitud
+                        como un string JSON. </para>
                 </listitem>
                 </listitem>
             </itemizedlist>
             </itemizedlist>
 
 
-            <para>
-                Una versión específica de
-                <acronym>HTTP</acronym>
-                está disponible a través de
-                <classname>Zend_Json_Server_Request_Http</classname>
-                . Esta
+            <para> Una versión específica de <acronym>HTTP</acronym> está
+                disponible a través de
+                    <classname>Zend_Json_Server_Request_Http</classname> . Esta
                 clase podrá recuperar la solicitud via
                 clase podrá recuperar la solicitud via
-                <methodname>php://input</methodname>
-                , y permite el acceso
+                    <methodname>php://input</methodname> , y permite el acceso
                 JSON sin procesar vía el método
                 JSON sin procesar vía el método
-                <methodname>getRawJson()</methodname>
-                .
-            </para>
+                    <methodname>getRawJson()</methodname> . </para>
         </sect3>
         </sect3>
 
 
         <sect3 id="zend.json.server.details.zendjsonserverresponse">
         <sect3 id="zend.json.server.details.zendjsonserverresponse">
             <title>Zend_Json_Server_Response</title>
             <title>Zend_Json_Server_Response</title>
 
 
-            <para>
-                La respuesta del conjunto de datos JSON-RPC es encapsulada en
-                el objeto
-                <classname>Zend_Json_Server_Response</classname>
-                . Este
-                objeto le permite ajustar el valor de retorno de la solicitud,
-                siendo la
-                respuesta un error o no, el identificador de
-                solicitud, con que versión de
-                especificación esta conformada la
-                respuesta de JSON-RPC, y, opcionalmente el mapa de
-                servicio.
-            </para>
+            <para> La respuesta del conjunto de datos JSON-RPC es encapsulada en
+                el objeto <classname>Zend_Json_Server_Response</classname> .
+                Este objeto le permite ajustar el valor de retorno de la
+                solicitud, siendo la respuesta un error o no, el identificador
+                de solicitud, con que versión de especificación esta conformada
+                la respuesta de JSON-RPC, y, opcionalmente el mapa de servicio. </para>
 
 
-            <para>El objeto respuesta tiene los siguientes métodos disponibles:</para>
+            <para>El objeto respuesta tiene los siguientes métodos
+                disponibles:</para>
 
 
             <itemizedlist>
             <itemizedlist>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setResult($value)</methodname>
-                        : Establecer
-                        el resultado de la respuesta.
-                    </para>
+                        <methodname>setResult($value)</methodname> : Establecer
+                        el resultado de la respuesta. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getResult()</methodname>
-                        : Recuperar el
-                        resultado de la respuesta.
-                    </para>
+                        <methodname>getResult()</methodname> : Recuperar el
+                        resultado de la respuesta. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
                         <methodname>setError(Zend_Json_Server_Error
                         <methodname>setError(Zend_Json_Server_Error
-                            $error)</methodname>
-                        : Establecer un objeto error. Si
-                        ya está, este será utilizado como la
-                        respuesta cuando se
-                        serialize a JSON.
-                    </para>
+                            $error)</methodname> : Establecer un objeto error.
+                        Si ya está, este será utilizado como la respuesta cuando
+                        se serialize a JSON. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getError()</methodname>
-                        : Recuperar el
-                        objeto error, si lo hubiera.
-                    </para>
+                        <methodname>getError()</methodname> : Recuperar el
+                        objeto error, si lo hubiera. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>isError()</methodname>
-                        : Si la respuesta es
-                        una respuesta de error o no.
-                    </para>
+                        <methodname>isError()</methodname> : Si la respuesta es
+                        una respuesta de error o no. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setId($name)</methodname>
-                        : Establecer el
+                        <methodname>setId($name)</methodname> : Establecer el
                         identificador de solicitud (de manera que la respuesta
                         identificador de solicitud (de manera que la respuesta
-                        del
-                        cliente pueda coincidir con la solicitud original).
+                        del cliente pueda coincidir con la solicitud original).
                     </para>
                     </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getId()</methodname>
-                        : Recuperar el
-                        identificador de solicitud.
-                    </para>
+                        <methodname>getId()</methodname> : Recuperar el
+                        identificador de solicitud. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setVersion($version)</methodname>
-                        :
+                        <methodname>setVersion($version)</methodname> :
                         Establecer la versión JSON-RPC con la que deba estar
                         Establecer la versión JSON-RPC con la que deba estar
-                        conformada la
-                        respuesta.
-                    </para>
+                        conformada la respuesta. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getVersion()</methodname>
-                        : Recuperar la
-                        versión JSON-RPC con la cumple la respuesta.
-                    </para>
+                        <methodname>getVersion()</methodname> : Recuperar la
+                        versión JSON-RPC con la cumple la respuesta. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>toJson()</methodname>
-                        : Serializar la
+                        <methodname>toJson()</methodname> : Serializar la
                         respuesta a JSON. Si la respuesta es una respuesta de
                         respuesta a JSON. Si la respuesta es una respuesta de
-                        error,
-                        serializar el objeto error.
-                    </para>
+                        error, serializar el objeto error. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setServiceMap($serviceMap)</methodname>
-                        :
+                        <methodname>setServiceMap($serviceMap)</methodname> :
                         Establecer el objeto mapa de servicio para la respuesta.
                         Establecer el objeto mapa de servicio para la respuesta.
                     </para>
                     </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getServiceMap()</methodname>
-                        : Recuperar el
-                        objeto mapa de servicio, si hubiera alguno.
-                    </para>
+                        <methodname>getServiceMap()</methodname> : Recuperar el
+                        objeto mapa de servicio, si hubiera alguno. </para>
                 </listitem>
                 </listitem>
             </itemizedlist>
             </itemizedlist>
 
 
-            <para>
-                Una versión específica de
-                <acronym>HTTP</acronym>
-                está disponible a través de
-                <classname>Zend_Json_Server_Response_Http</classname>
-                . Esta
-                clase enviará las cabeceras
-                <acronym>HTTP</acronym>
-                apropiadas así como serializará
-                la respuesta como
-                <acronym>JSON</acronym>
-                .
+            <para> Una versión específica de <acronym>HTTP</acronym> está
+                disponible a través de
+                    <classname>Zend_Json_Server_Response_Http</classname> . Esta
+                clase enviará las cabeceras <acronym>HTTP</acronym> apropiadas
+                así como serializará la respuesta como <acronym>JSON</acronym> .
             </para>
             </para>
         </sect3>
         </sect3>
 
 
@@ -665,92 +505,65 @@ $server->handle();
             <title>Zend_Json_Server_Error</title>
             <title>Zend_Json_Server_Error</title>
 
 
             <para>JSON-RPC tiene un formato especial para informar condiciones
             <para>JSON-RPC tiene un formato especial para informar condiciones
-                de error. Todos los
-                errores necesitan proporcionar, mínimamente,
-                un mensaje de error y un código de
-                error; opcionalmente, pueden
+                de error. Todos los errores necesitan proporcionar, mínimamente,
+                un mensaje de error y un código de error; opcionalmente, pueden
                 proporcionar datos adicionales, tales como un backtrace.</para>
                 proporcionar datos adicionales, tales como un backtrace.</para>
 
 
-            <para>
-                Los códigos de error derivan de los recomendados por
-                <ulink url="http://xmlrpc-epi.sourceforge.net/specs/rfc.fault_codes.php">el
-                    proyecto XML-RPC EPI</ulink>
-                .
-                <classname>Zend_Json_Server</classname>
-                apropiadamente
+            <para> Los códigos de error derivan de los recomendados por <ulink
+                    url="http://xmlrpc-epi.sourceforge.net/specs/rfc.fault_codes.php"
+                    >el proyecto XML-RPC EPI</ulink> .
+                    <classname>Zend_Json_Server</classname> apropiadamente
                 asigna el código sobre la base de la condición de error. Para
                 asigna el código sobre la base de la condición de error. Para
-                las
-                excepciones de la aplicación, se utiliza el código '-32000'.
-            </para>
+                las excepciones de la aplicación, se utiliza el código '-32000'. </para>
 
 
             <para>
             <para>
-                <classname>Zend_Json_Server_Error</classname>
-                expone los
-                siguientes métodos:
-            </para>
+                <classname>Zend_Json_Server_Error</classname> expone los
+                siguientes métodos: </para>
 
 
             <itemizedlist>
             <itemizedlist>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setCode($code)</methodname>
-                        : Establece el
+                        <methodname>setCode($code)</methodname> : Establece el
                         código de error; si el código de error no está en el
                         código de error; si el código de error no está en el
-                        rango de
-                        aceptación de XML-RPC, -32000 será
-                        asignado.
+                        rango de aceptación de XML-RPC, -32000 será asignado.
                     </para>
                     </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getCode()</methodname>
-                        : Recuperar el
-                        actual código de error.
-                    </para>
+                        <methodname>getCode()</methodname> : Recuperar el actual
+                        código de error. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setMessage($message)</methodname>
-                        :
-                        Establecer el mensaje de error.
-                    </para>
+                        <methodname>setMessage($message)</methodname> :
+                        Establecer el mensaje de error. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getMessage()</methodname>
-                        : Recuperar el
-                        mensaje de error actual.
-                    </para>
+                        <methodname>getMessage()</methodname> : Recuperar el
+                        mensaje de error actual. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setData($data)</methodname>
-                        : Establecer el
+                        <methodname>setData($data)</methodname> : Establecer el
                         conjunto de datos auxiliares para calificar más adelante
                         conjunto de datos auxiliares para calificar más adelante
-                        el
-                        error, tal como un backtrace.
-                    </para>
+                        el error, tal como un backtrace. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getData()</methodname>
-                        : Recuperar
-                        cualquier auxiliar actual de errores de datos.
-                    </para>
+                        <methodname>getData()</methodname> : Recuperar cualquier
+                        auxiliar actual de errores de datos. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>toArray()</methodname>
-                        : Mandar el error a
+                        <methodname>toArray()</methodname> : Mandar el error a
                         un array. El array contendrá las claves 'code',
                         un array. El array contendrá las claves 'code',
-                        'message', y 'data'.
-                    </para>
+                        'message', y 'data'. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>toJson()</methodname>
-                        : Mandar el error a
-                        una representación de error JSON-RPC.
-                    </para>
+                        <methodname>toJson()</methodname> : Mandar el error a
+                        una representación de error JSON-RPC. </para>
                 </listitem>
                 </listitem>
             </itemizedlist>
             </itemizedlist>
         </sect3>
         </sect3>
@@ -758,498 +571,335 @@ $server->handle();
         <sect3 id="zend.json.server.details.zendjsonserversmd">
         <sect3 id="zend.json.server.details.zendjsonserversmd">
             <title>Zend_Json_Server_Smd</title>
             <title>Zend_Json_Server_Smd</title>
 
 
-            <para>
-                SMD quiere decir Service Mapping Description, un esquema JSON
-                que define cómo un
-                cliente puede interactuar con un servicio web
-                en particular. En el momento de
-                escribir esto, la
-                <ulink
+            <para> SMD quiere decir Service Mapping Description, un esquema JSON
+                que define cómo un cliente puede interactuar con un servicio web
+                en particular. En el momento de escribir esto, la <ulink
                     url="http://groups.google.com/group/json-schema/web/service-mapping-description-proposal"
                     url="http://groups.google.com/group/json-schema/web/service-mapping-description-proposal"
-                >especificación</ulink>
-                todavía no ha sido ratificada
-                oficialmente, pero ya está en uso en Dojo toolkit así
-                como en
-                otros clientes consumidores de JSON-RPC.
-            </para>
-
-            <para>
-                En su aspecto más básico, un SMD indica el método de
-                transporte (POST, GET, TCP/IP,
-                etc), el tipo de envoltura de la
-                solicitud (generalmente se basa en el protocolo del
-                servidor),
-                el objetivo
-                <acronym>URL</acronym>
-                del proveedor del servicio, y
-                un mapa de los servicios disponibles. En el caso de
-                JSON-RPC, el
+                    >especificación</ulink> todavía no ha sido ratificada
+                oficialmente, pero ya está en uso en Dojo toolkit así como en
+                otros clientes consumidores de JSON-RPC. </para>
+
+            <para> En su aspecto más básico, un SMD indica el método de
+                transporte (POST, GET, TCP/IP, etc), el tipo de envoltura de la
+                solicitud (generalmente se basa en el protocolo del servidor),
+                el objetivo <acronym>URL</acronym> del proveedor del servicio, y
+                un mapa de los servicios disponibles. En el caso de JSON-RPC, el
                 servicio de mapa es una lista de los métodos disponibles, en el
                 servicio de mapa es una lista de los métodos disponibles, en el
-                que cada
-                método documenta los parámetros disponibles y sus
-                tipos, así como los tipos de
-                valores esperados a devolver.
-            </para>
+                que cada método documenta los parámetros disponibles y sus
+                tipos, así como los tipos de valores esperados a devolver. </para>
 
 
             <para>
             <para>
-                <classname>Zend_Json_Server_Smd</classname>
-                Proporciona un
+                <classname>Zend_Json_Server_Smd</classname> Proporciona un
                 objeto orientado para construir servicios de mapas. Básicamente,
                 objeto orientado para construir servicios de mapas. Básicamente,
-                pasa
-                los metadatos describiendo el servicio usando mutators, y
-                especifica los servicios
-                (métodos y funciones).
-            </para>
+                pasa los metadatos describiendo el servicio usando mutators, y
+                especifica los servicios (métodos y funciones). </para>
 
 
-            <para>
-                Las descripciones de los servicios son típicamente instancias
-                de
-                <classname>Zend_Json_Server_Smd_Service</classname>
-                ; también
+            <para> Las descripciones de los servicios son típicamente instancias
+                de <classname>Zend_Json_Server_Smd_Service</classname> ; también
                 puede pasar toda la información como un array a los diversos
                 puede pasar toda la información como un array a los diversos
-                mutators de
-                servicios en
-                <classname>Zend_Json_Server_Smd</classname>
-                , y que
+                mutators de servicios en
+                    <classname>Zend_Json_Server_Smd</classname> , y que
                 instanciará on objeto de servicio por usted. Los objetos de
                 instanciará on objeto de servicio por usted. Los objetos de
-                servicio contienen
-                información como el nombre del servicio
-                (típicamente, la función o el nombre del
-                método), los parámetros
+                servicio contienen información como el nombre del servicio
+                (típicamente, la función o el nombre del método), los parámetros
                 (nombres, tipos y posición), y el tipo del valor de retorno.
                 (nombres, tipos y posición), y el tipo del valor de retorno.
                 Opcionalmente, cada servicio puede tener su propio objetivo y
                 Opcionalmente, cada servicio puede tener su propio objetivo y
-                envoltura, aunque esta
-                funcionalidad rara vez es utilizada.
-            </para>
+                envoltura, aunque esta funcionalidad rara vez es utilizada. </para>
 
 
             <para>
             <para>
-                <classname>Zend_Json_Server</classname>
-                Realmente todo esto
+                <classname>Zend_Json_Server</classname> Realmente todo esto
                 sucede entre bambalinas para usted, utilizando reflexión sobre
                 sucede entre bambalinas para usted, utilizando reflexión sobre
                 las clases y funciones agregadas; debe crear su propio servicio
                 las clases y funciones agregadas; debe crear su propio servicio
-                de mapas sólo si
-                necesita brindar funcionalidad personalizada
-                que la introspección de clase y función
-                no puede ofrecer.
-            </para>
+                de mapas sólo si necesita brindar funcionalidad personalizada
+                que la introspección de clase y función no puede ofrecer. </para>
 
 
-            <para>
-                Los métodos disponibles en
-                <classname>Zend_Json_Server_Smd</classname>
-                incluyen:
-            </para>
+            <para> Los métodos disponibles en
+                    <classname>Zend_Json_Server_Smd</classname> incluyen: </para>
 
 
             <itemizedlist>
             <itemizedlist>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setOptions(array $options)</methodname>
-                        :
+                        <methodname>setOptions(array $options)</methodname> :
                         Establecer un objeto SMD desde un array de opciones.
                         Establecer un objeto SMD desde un array de opciones.
-                        Todos los mutators
-                        (métodos comenzando con 'set') se
-                        pueden usar como claves.
-                    </para>
+                        Todos los mutators (métodos comenzando con 'set') se
+                        pueden usar como claves. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setTransport($transport)</methodname>
-                        :
+                        <methodname>setTransport($transport)</methodname> :
                         Establecer el transporte usado para acceder al servicio;
                         Establecer el transporte usado para acceder al servicio;
-                        únicamente POST es
-                        actualmente soportado.
-                    </para>
+                        únicamente POST es actualmente soportado. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getTransport()</methodname>
-                        : Obtener el
-                        servicio de transporte actual.
-                    </para>
+                        <methodname>getTransport()</methodname> : Obtener el
+                        servicio de transporte actual. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setEnvelope($envelopeType)</methodname>
-                        :
+                        <methodname>setEnvelope($envelopeType)</methodname> :
                         Establecer la envoltura de la solicitud que debería ser
                         Establecer la envoltura de la solicitud que debería ser
-                        utilizada para
-                        acceder al servicio. Actualmente las
+                        utilizada para acceder al servicio. Actualmente las
                         constantes soportadas son
                         constantes soportadas son
-                        <constant>Zend_Json_Server_Smd::ENV_JSONRPC_1</constant>
+                            <constant>Zend_Json_Server_Smd::ENV_JSONRPC_1</constant>
                         y
                         y
-                        <constant>Zend_Json_Server_Smd::ENV_JSONRPC_1</constant>
-                        .
-                    </para>
+                            <constant>Zend_Json_Server_Smd::ENV_JSONRPC_1</constant>
+                        . </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getEnvelope()</methodname>
-                        : Obtener la
-                        envoltura de la petición actual.
-                    </para>
+                        <methodname>getEnvelope()</methodname> : Obtener la
+                        envoltura de la petición actual. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setContentType($type)</methodname>
-                        :
+                        <methodname>setContentType($type)</methodname> :
                         Establecer el tipo de contenido que deben utilizar las
                         Establecer el tipo de contenido que deben utilizar las
-                        solicitudes (por
-                        defecto, es 'application/json»).
+                        solicitudes (por defecto, es 'application/json»).
                     </para>
                     </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getContentType()</methodname>
-                        : Conseguir
-                        el tipo del contenido actual para las solicitudes al
-                        servicio.
-                    </para>
+                        <methodname>getContentType()</methodname> : Conseguir el
+                        tipo del contenido actual para las solicitudes al
+                        servicio. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setTarget($target)</methodname>
-                        :
-                        Establecer el punto final de la
-                        <acronym>URL</acronym>
-                        para el servicio.
-                    </para>
+                        <methodname>setTarget($target)</methodname> : Establecer
+                        el punto final de la <acronym>URL</acronym> para el
+                        servicio. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getTarget()</methodname>
-                        : Obtener el punto
-                        final de la
-                        <acronym>URL</acronym>
-                        para el
-                        servicio.
+                        <methodname>getTarget()</methodname> : Obtener el punto
+                        final de la <acronym>URL</acronym> para el servicio.
                     </para>
                     </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setId($id)</methodname>
-                        : Normalmente, este
-                        es el punto final de la
-                        <acronym>URL</acronym>
-                        del
-                        servicio (igual que el objetivo).
-                    </para>
+                        <methodname>setId($id)</methodname> : Normalmente, este
+                        es el punto final de la <acronym>URL</acronym> del
+                        servicio (igual que el objetivo). </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getId()</methodname>
-                        : Recuperar el ID del
+                        <methodname>getId()</methodname> : Recuperar el ID del
                         servicio (normalmente el punto final de la
                         servicio (normalmente el punto final de la
-                        <acronym>URL</acronym>
-                        del servicio).
-                    </para>
+                            <acronym>URL</acronym> del servicio). </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setDescription($description)</methodname>
-                        :
+                        <methodname>setDescription($description)</methodname> :
                         Establecer una descripción del servicio (típicamente
                         Establecer una descripción del servicio (típicamente
-                        información narrativa
-                        que describe el propósito del
-                        servicio).
-                    </para>
+                        información narrativa que describe el propósito del
+                        servicio). </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getDescription()</methodname>
-                        : Obtener la
-                        descripción del servicio.
-                    </para>
+                        <methodname>getDescription()</methodname> : Obtener la
+                        descripción del servicio. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setDojoCompatible($flag)</methodname>
-                        :
+                        <methodname>setDojoCompatible($flag)</methodname> :
                         Establecer un flag que indique si el SMD es compatible o
                         Establecer un flag que indique si el SMD es compatible o
-                        no con el toolkit
-                        de Dojo. Cuando sea verdadero, el
-                        <acronym>JSON</acronym>
-                        SMD será formateado para cumplir con el formato que
-                        espera el cliente de Dojo
-                        JSON-RPC.
-                    </para>
+                        no con el toolkit de Dojo. Cuando sea verdadero, el
+                            <acronym>JSON</acronym> SMD será formateado para
+                        cumplir con el formato que espera el cliente de Dojo
+                        JSON-RPC. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>isDojoCompatible()</methodname>
-                        : Devuelve
-                        el valor del flag de compatibilidad de Dojo (falso, por
-                        defecto).
-                    </para>
+                        <methodname>isDojoCompatible()</methodname> : Devuelve
+                        el valor del flag de compatibilidad de Dojo (<constant>FALSE</constant>, por
+                        defecto). </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>addService($service)</methodname>
-                        : Añade
-                        un servicio al mapa. Puede ser un array de información a
-                        pasar al
-                        constructor de
-                        <classname>Zend_Json_Server_Smd_Service</classname>
-                        ,
-                        o una instancia de esa clase.
-                    </para>
+                        <methodname>addService($service)</methodname> : Añade un
+                        servicio al mapa. Puede ser un array de información a
+                        pasar al constructor de
+                            <classname>Zend_Json_Server_Smd_Service</classname>
+                        , o una instancia de esa clase. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>addServices(array $services)</methodname>
-                        :
-                        Agrega múltiples servicios a la vez.
-                    </para>
+                        <methodname>addServices(array $services)</methodname> :
+                        Agrega múltiples servicios a la vez. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setServices(array $services)</methodname>
-                        :
+                        <methodname>setServices(array $services)</methodname> :
                         Agrega múltiples servicios a la vez, sobreescribiendo
                         Agrega múltiples servicios a la vez, sobreescribiendo
-                        cualquiera de los
-                        servicios previamente establecidos.
+                        cualquiera de los servicios previamente establecidos.
                     </para>
                     </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getService($name)</methodname>
-                        : Ontiene el
-                        servicio por su nombre.
-                    </para>
+                        <methodname>getService($name)</methodname> : Ontiene el
+                        servicio por su nombre. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getServices()</methodname>
-                        : Obtener todos
-                        los servicios agregados.
-                    </para>
+                        <methodname>getServices()</methodname> : Obtener todos
+                        los servicios agregados. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>removeService($name)</methodname>
-                        : Elimina
-                        un servicio del mapa.
-                    </para>
+                        <methodname>removeService($name)</methodname> : Elimina
+                        un servicio del mapa. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>toArray()</methodname>
-                        : Mandar el mapa de
-                        servicio a un array.
-                    </para>
+                        <methodname>toArray()</methodname> : Mandar el mapa de
+                        servicio a un array. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>toDojoArray()</methodname>
-                        : Mandar el mapa
-                        de servicio a un array compatible con Dojo
-                        Toolkit.
+                        <methodname>toDojoArray()</methodname> : Mandar el mapa
+                        de servicio a un array compatible con Dojo Toolkit.
                     </para>
                     </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>toJson()</methodname>
-                        : Mandar el mapa de
-                        servicio a una representación JSON.
-                    </para>
+                        <methodname>toJson()</methodname> : Mandar el mapa de
+                        servicio a una representación JSON. </para>
                 </listitem>
                 </listitem>
             </itemizedlist>
             </itemizedlist>
 
 
             <para>
             <para>
-                <classname>Zend_Json_Server_Smd_Service</classname>
-                tiene los
-                siguientes métodos:
-            </para>
+                <classname>Zend_Json_Server_Smd_Service</classname> tiene los
+                siguientes métodos: </para>
 
 
             <itemizedlist>
             <itemizedlist>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setOptions(array $options)</methodname>
-                        :
+                        <methodname>setOptions(array $options)</methodname> :
                         Establecer el estado del objeto dede un array. Cualquier
                         Establecer el estado del objeto dede un array. Cualquier
-                        mutator (métodos
-                        comenzando con 'set') puede ser
-                        utilizado como una clave y establecerlo
-                        mediante este
-                        método.
-                    </para>
+                        mutator (métodos comenzando con 'set') puede ser
+                        utilizado como una clave y establecerlo mediante este
+                        método. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setName($name)</methodname>
-                        : Establecer el
+                        <methodname>setName($name)</methodname> : Establecer el
                         nombre del servicio (típicamente, la función o el nombre
                         nombre del servicio (típicamente, la función o el nombre
-                        del
-                        método).
-                    </para>
+                        del método). </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getName()</methodname>
-                        : Recuperar el
-                        nombre del servicio.
-                    </para>
+                        <methodname>getName()</methodname> : Recuperar el nombre
+                        del servicio. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setTransport($transport)</methodname>
-                        :
+                        <methodname>setTransport($transport)</methodname> :
                         Establecer el servicio de transporte (actualmente, sólo
                         Establecer el servicio de transporte (actualmente, sólo
-                        transportes apoyados
-                        por
-                        <classname>Zend_Json_Server_Smd</classname>
-                        son
-                        permitidos).
-                    </para>
+                        transportes apoyados por
+                            <classname>Zend_Json_Server_Smd</classname> son
+                        permitidos). </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getTransport()</methodname>
-                        : Recuperar el
-                        transporte actual.
-                    </para>
+                        <methodname>getTransport()</methodname> : Recuperar el
+                        transporte actual. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setTarget($target)</methodname>
-                        :
-                        Establecer el punto final de la
-                        <acronym>URL</acronym>
-                        del servicio (típicamente, este será el mismo que el SMD
-                        en general, al cual
-                        el servicio está agregado).
-                    </para>
+                        <methodname>setTarget($target)</methodname> : Establecer
+                        el punto final de la <acronym>URL</acronym> del servicio
+                        (típicamente, este será el mismo que el SMD en general,
+                        al cual el servicio está agregado). </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getTarget()</methodname>
-                        : Obtener el punto
-                        final de la
-                        <acronym>URL</acronym>
-                        del servicio.
-                    </para>
+                        <methodname>getTarget()</methodname> : Obtener el punto
+                        final de la <acronym>URL</acronym> del servicio. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setEnvelope($envelopeType)</methodname>
-                        :
+                        <methodname>setEnvelope($envelopeType)</methodname> :
                         Establecer la envoltura del servicio (actualmente, sólo
                         Establecer la envoltura del servicio (actualmente, sólo
-                        se permiten las
-                        envolturas soportadas por
-                        <classname>Zend_Json_Server_Smd</classname>
-                        .
+                        se permiten las envolturas soportadas por
+                            <classname>Zend_Json_Server_Smd</classname> .
                     </para>
                     </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getEnvelope()</methodname>
-                        : Recuperar el
-                        tipo de envoltura del servicio.
-                    </para>
+                        <methodname>getEnvelope()</methodname> : Recuperar el
+                        tipo de envoltura del servicio. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
                         <methodname>addParam($type, array $options = array(),
                         <methodname>addParam($type, array $options = array(),
-                            $order = null)</methodname>
-                        : Añadir un parámetro
-                        para el servicio. Por defecto, sólo el tipo de
-                        parámetro
+                            $order = null)</methodname> : Añadir un parámetro
+                        para el servicio. Por defecto, sólo el tipo de parámetro
                         es necesario. Sin embargo, también puede especificar el
                         es necesario. Sin embargo, también puede especificar el
-                        orden, así
-                        como opciones tales como:
-                    </para>
+                        orden, así como opciones tales como: </para>
                     <itemizedlist>
                     <itemizedlist>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>name</emphasis>
-                                : el nombre del
-                                parámetro
-                            </para>
+                                <emphasis>name</emphasis> : el nombre del
+                                parámetro </para>
                         </listitem>
                         </listitem>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>optional</emphasis>
-                                : cuándo el
-                                parámetro es opcional o no
-                            </para>
+                                <emphasis>optional</emphasis> : cuándo el
+                                parámetro es opcional o no </para>
                         </listitem>
                         </listitem>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>default</emphasis>
-                                : un valor por
-                                defecto para el parámetro
-                            </para>
+                                <emphasis>default</emphasis> : un valor por
+                                defecto para el parámetro </para>
                         </listitem>
                         </listitem>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>description</emphasis>
-                                : texto
-                                describiendo el parámetro
-                            </para>
+                                <emphasis>description</emphasis> : texto
+                                describiendo el parámetro </para>
                         </listitem>
                         </listitem>
                     </itemizedlist>
                     </itemizedlist>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>addParams(array $params)</methodname>
-                        :
+                        <methodname>addParams(array $params)</methodname> :
                         Agregar varios parámetros a la vez; cada param debería
                         Agregar varios parámetros a la vez; cada param debería
-                        ser un array
-                        asociativo conteniendo mínimamente la clave
-                        'type' describiendo el tipo de
-                        parámetro y,
+                        ser un array asociativo conteniendo mínimamente la clave
+                        'type' describiendo el tipo de parámetro y,
                         opcionalmente la clave 'order'; cualquiera de las otras
                         opcionalmente la clave 'order'; cualquiera de las otras
-                        claves
-                        serán pasados como
-                        <varname>$options</varname>
-                        a
-                        <methodname>addOption()</methodname>
-                        .
-                    </para>
+                        claves serán pasados como <varname>$options</varname> a
+                            <methodname>addOption()</methodname> . </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setParams(array $params)</methodname>
-                        :
+                        <methodname>setParams(array $params)</methodname> :
                         Establecer muchos parámetros a la vez, sobrescribiendo
                         Establecer muchos parámetros a la vez, sobrescribiendo
-                        cualquiera de los
-                        parámetros existentes.
-                    </para>
+                        cualquiera de los parámetros existentes. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getParams()</methodname>
-                        : Recuperar todos
-                        los parámetros actualmente establecidos.
-                    </para>
+                        <methodname>getParams()</methodname> : Recuperar todos
+                        los parámetros actualmente establecidos. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>setReturn($type)</methodname>
-                        : Establecer
-                        el tipo del valor de retorno del servicio.
-                    </para>
+                        <methodname>setReturn($type)</methodname> : Establecer
+                        el tipo del valor de retorno del servicio. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>getReturn()</methodname>
-                        : Obtener el tipo
-                        del valor de retorno del servicio.
-                    </para>
+                        <methodname>getReturn()</methodname> : Obtener el tipo
+                        del valor de retorno del servicio. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>toArray()</methodname>
-                        : Mandar el servicio
-                        a un array.
-                    </para>
+                        <methodname>toArray()</methodname> : Mandar el servicio
+                        a un array. </para>
                 </listitem>
                 </listitem>
                 <listitem>
                 <listitem>
                     <para>
                     <para>
-                        <methodname>toJson()</methodname>
-                        : Mandar el servicio
-                        a una representación
-                        <acronym>JSON</acronym>
-                        .
-                    </para>
+                        <methodname>toJson()</methodname> : Mandar el servicio a
+                        una representación <acronym>JSON</acronym> . </para>
                 </listitem>
                 </listitem>
             </itemizedlist>
             </itemizedlist>
         </sect3>
         </sect3>

+ 111 - 242
documentation/manual/es/module_specs/Zend_Loader.xml

@@ -1,63 +1,41 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.loader.load">
 <sect1 id="zend.loader.load">
 
 
     <title>Cargando archivos y clases dinámicamente</title>
     <title>Cargando archivos y clases dinámicamente</title>
 
 
-    <para>
-        La clase
-        <classname>Zend_Loader</classname>
-        incluye métodos para ayudar a cargar archivos
-        dinámicamente.
-    </para>
+    <para> La clase <classname>Zend_Loader</classname> incluye métodos para
+        ayudar a cargar archivos dinámicamente. </para>
 
 
     <tip>
     <tip>
         <title>Zend_Loader vs. require_once()</title>
         <title>Zend_Loader vs. require_once()</title>
-        <para>
-            Los métodos de
-            <classname>Zend_Loader</classname>
-            tienen más utilidad si el
-            nombre de archivo que necesita cargar es variable. Por ejemplo,
-            si éste se basa en un parametro de entrada del usuario o argumento
-            de un método. Si carga
-            un archivo o clase cuyo nombre es constante, no
-            hay ningún beneficio al usar
-            <classname>Zend_Loader</classname>
-            sobre el uso
-            de funciones tradicionales de
-            <acronym>PHP</acronym>
-            como
-            <ulink url="http://php.net/require_once">
+        <para> Los métodos de <classname>Zend_Loader</classname> tienen más
+            utilidad si el nombre de archivo que necesita cargar es variable.
+            Por ejemplo, si éste se basa en un parametro de entrada del usuario
+            o argumento de un método. Si carga un archivo o clase cuyo nombre es
+            constante, no hay ningún beneficio al usar
+                <classname>Zend_Loader</classname> sobre el uso de funciones
+            tradicionales de <acronym>PHP</acronym> como <ulink
+                url="http://php.net/require_once">
                 <methodname>require_once()</methodname>
                 <methodname>require_once()</methodname>
-            </ulink>
-            .
-        </para>
+            </ulink> . </para>
     </tip>
     </tip>
 
 
     <sect2 id="zend.loader.load.file">
     <sect2 id="zend.loader.load.file">
 
 
         <title>Cargando Archivos</title>
         <title>Cargando Archivos</title>
 
 
-        <para>
-            El método estático
-            <methodname>Zend_Loader::loadFile()</methodname>
-            carga un archivo
-            <acronym>PHP</acronym>
-            . El archivo cargado puede contener cualquier código
-            <acronym>PHP</acronym>
-            .
-            El método se comporta como un envoltorio para la función
-            <acronym>PHP</acronym>
+        <para> El método estático
+                <methodname>Zend_Loader::loadFile()</methodname> carga un
+            archivo <acronym>PHP</acronym> . El archivo cargado puede contener
+            cualquier código <acronym>PHP</acronym> . El método se comporta como
+            un envoltorio para la función <acronym>PHP</acronym>
             <ulink url="http://php.net/include">
             <ulink url="http://php.net/include">
                 <methodname>include()</methodname>
                 <methodname>include()</methodname>
-            </ulink>
-            .
-            Este método devuelve un booleano
-            <constant>FALSE</constant>
-            en caso de fallo, por ejemplo,
-            si el archivo especificado no existe.
-        </para>
+            </ulink> . Este método devuelve un booleano
+                <constant>FALSE</constant> en caso de fallo, por ejemplo, si el
+            archivo especificado no existe. </para>
 
 
         <example id="zend.loader.load.file.example">
         <example id="zend.loader.load.file.example">
             <title>Ejemplo del Método loadFile()</title>
             <title>Ejemplo del Método loadFile()</title>
@@ -66,58 +44,31 @@ Zend_Loader::loadFile($filename, $dirs=null, $once=false);
 ]]></programlisting>
 ]]></programlisting>
         </example>
         </example>
 
 
-        <para>
-            El argumento
-            <varname>$filename</varname>
-            especifica el archivo que se va a cargar,
-            el cual no debe contener ninguna información de
-            rutas.
-            Una verificación de seguridad es efectuada sobre
-            <varname>$filename</varname>
-            .
-            El archivo
-            <varname>$filename</varname>
-            sólo puede contener caracteres alfanuméricos,
-            guiones ("-"), barras bajas ("_"), o puntos
-            (".").
-            No hay ninguna restricción en el argumento
-            <varname>$dirs</varname>
-            .
-        </para>
-
-        <para>
-            El parámetro
-            <varname>$dirs</varname>
-            especifica en qué carpetas buscar el archivo.
-            Si el valor es
-            <constant>NULL</constant>
-            , sólo se buscará en el
-            <methodname>include_path</methodname>
-            ; si el valor es un string o un array, se buscará en la carpeta o carpetas especificadas
-            , seguidas del
-            <methodname>include_path</methodname>
-            .
-        </para>
-
-        <para>
-            El argumento
-            <varname>$once</varname>
-            es un booleano. Si es
-            <constant>TRUE</constant>
-            ,
-            <methodname>Zend_Loader::loadFile()</methodname>
-            esa la función
-            <acronym>PHP</acronym>
+        <para> El argumento <varname>$filename</varname> especifica el archivo
+            que se va a cargar, el cual no debe contener ninguna información de
+            rutas. Una verificación de seguridad es efectuada sobre
+                <varname>$filename</varname> . El archivo
+                <varname>$filename</varname> sólo puede contener caracteres
+            alfanuméricos, guiones ("-"), barras bajas ("_"), o puntos ("."). No
+            hay ninguna restricción en el argumento <varname>$dirs</varname> . </para>
+
+        <para> El parámetro <varname>$dirs</varname> especifica en qué carpetas
+            buscar el archivo. Si el valor es <constant>NULL</constant> , sólo
+            se buscará en el <methodname>include_path</methodname> ; si el valor
+            es un string o un array, se buscará en la carpeta o carpetas
+            especificadas , seguidas del <methodname>include_path</methodname> . </para>
+
+        <para> El argumento <varname>$once</varname> es un booleano. Si es
+                <constant>TRUE</constant> ,
+                <methodname>Zend_Loader::loadFile()</methodname> esa la función
+                <acronym>PHP</acronym>
             <ulink url="http://php.net/include">
             <ulink url="http://php.net/include">
                 <methodname>include_once()</methodname>
                 <methodname>include_once()</methodname>
-            </ulink>
-            para cargar el archivo, de lo contrario se utiliza la función
-            <acronym>PHP</acronym>
+            </ulink> para cargar el archivo, de lo contrario se utiliza la
+            función <acronym>PHP</acronym>
             <ulink url="http://php.net/include_once">
             <ulink url="http://php.net/include_once">
                 <methodname>include()</methodname>
                 <methodname>include()</methodname>
-            </ulink>
-            .
-        </para>
+            </ulink> . </para>
 
 
     </sect2>
     </sect2>
 
 
@@ -125,13 +76,9 @@ Zend_Loader::loadFile($filename, $dirs=null, $once=false);
 
 
         <title>Cargando Clases</title>
         <title>Cargando Clases</title>
 
 
-        <para>
-            El método estático
-            <methodname>Zend_Loader::loadClass($class, $dirs)</methodname>
-            carga un archivo
-            <acronym>PHP</acronym>
-            y comprueba la existencia de la clase.
-        </para>
+        <para> El método estático <methodname>Zend_Loader::loadClass($class,
+                $dirs)</methodname> carga un archivo <acronym>PHP</acronym> y
+            comprueba la existencia de la clase. </para>
 
 
         <example id="zend.loader.load.class.example">
         <example id="zend.loader.load.class.example">
             <title>Ejemplo del método loadClass()</title>
             <title>Ejemplo del método loadClass()</title>
@@ -145,47 +92,28 @@ Zend_Loader::loadClass('Container_Tree',
 ]]></programlisting>
 ]]></programlisting>
         </example>
         </example>
 
 
-        <para>
-            La cadena que especifica la clase es convertida a una ruta relativa sustituyendo las
-            barras
-            bajas (_) por el separador de carpeta de su Sistema Operativo, y añadiendo
-            '.php'.
-            En el ejemplo de arriba, 'Container_Tree' se convierte en 'Container\\Tree.php' en
-            Windows.
-       </para>
+        <para> La cadena que especifica la clase es convertida a una ruta
+            relativa sustituyendo las barras bajas (_) por el separador de
+            carpeta de su Sistema Operativo, y añadiendo '.php'. En el ejemplo
+            de arriba, 'Container_Tree' se convierte en 'Container\\Tree.php' en
+            Windows. </para>
 
 
-        <para>
-            Si
-            <varname>$dirs</varname>
-            es una cadena o un array,
-            <methodname>Zend_Loader::loadClass()</methodname>
-            busca las carpetas en el
-            orden suministrado. El primer archivo encontrado es cargado. Si
-            el archivo
-            no existe en el
-            <varname>$dirs</varname>
+        <para> Si <varname>$dirs</varname> es una cadena o un array,
+                <methodname>Zend_Loader::loadClass()</methodname> busca las
+            carpetas en el orden suministrado. El primer archivo encontrado es
+            cargado. Si el archivo no existe en el <varname>$dirs</varname>
             especificado, entonces se busca en el
             especificado, entonces se busca en el
-            <methodname>include_path</methodname>
-            del entorno
-            <acronym>PHP</acronym>
-            .
-        </para>
+                <methodname>include_path</methodname> del entorno
+                <acronym>PHP</acronym> . </para>
 
 
-        <para>
-            Si el archivo no es encontrado o la clase no existe después de la carga,
-            <methodname>Zend_Loader::loadClass()</methodname>
-            lanza una
-            <classname>Zend_Exception</classname>
-            .
-        </para>
+        <para> Si el archivo no es encontrado o la clase no existe después de la
+            carga, <methodname>Zend_Loader::loadClass()</methodname> lanza una
+                <classname>Zend_Exception</classname> . </para>
 
 
         <para>
         <para>
-            <methodname>Zend_Loader::loadFile()</methodname>
-            se usa para cargar, así que
-            el nombre de la clase puede contener únicamente caracteres
-            alfanuméricos,
-            guiones ('-'), barras bajas ('_'), y puntos ('.').
-        </para>
+            <methodname>Zend_Loader::loadFile()</methodname> se usa para cargar,
+            así que el nombre de la clase puede contener únicamente caracteres
+            alfanuméricos, guiones ('-'), barras bajas ('_'), y puntos ('.'). </para>
 
 
     </sect2>
     </sect2>
 
 
@@ -193,16 +121,11 @@ Zend_Loader::loadClass('Container_Tree',
 
 
         <title>Comprobando si un Archivo Puede Ser Leído</title>
         <title>Comprobando si un Archivo Puede Ser Leído</title>
 
 
-        <para>
-            El método estático
-            <methodname>Zend_Loader::isReadable($pathname)</methodname>
-            devuelve
-            <constant>TRUE</constant>
-            si el archivo en la ruta $pathname existe
-            y tiene permisos de lectura,
-            <constant>FALSE</constant>
-            en caso contrario.
-        </para>
+        <para> El método estático
+                <methodname>Zend_Loader::isReadable($pathname)</methodname>
+            devuelve <constant>TRUE</constant> si el archivo en la ruta
+            $pathname existe y tiene permisos de lectura,
+                <constant>FALSE</constant> en caso contrario. </para>
 
 
         <example id="zend.loader.load.isreadable.example">
         <example id="zend.loader.load.isreadable.example">
             <title>Ejemplo del método isReadable()</title>
             <title>Ejemplo del método isReadable()</title>
@@ -213,26 +136,14 @@ if (Zend_Loader::isReadable($filename)) {
 ]]></programlisting>
 ]]></programlisting>
         </example>
         </example>
 
 
-        <para>
-            El argumento
-            <varname>$filename</varname>
-            especifica el nombre de archivo que
-            comprobar. Puede contener información de la ruta.
-            Este método envuelve la función
-            <acronym>PHP</acronym>
+        <para> El argumento <varname>$filename</varname> especifica el nombre de
+            archivo que comprobar. Puede contener información de la ruta. Este
+            método envuelve la función <acronym>PHP</acronym>
             <ulink url="http://php.net/is_readable">
             <ulink url="http://php.net/is_readable">
                 <methodname>is_readable()</methodname>
                 <methodname>is_readable()</methodname>
-            </ulink>
-            .
-            La función
-            <acronym>PHP</acronym>
-            no busca en
-            <methodname>include_path</methodname>
-            ,
-            mientras que
-            <methodname>Zend_Loader::isReadable()</methodname>
-            sí.
-        </para>
+            </ulink> . La función <acronym>PHP</acronym> no busca en
+                <methodname>include_path</methodname> , mientras que
+                <methodname>Zend_Loader::isReadable()</methodname> sí. </para>
 
 
     </sect2>
     </sect2>
 
 
@@ -240,84 +151,51 @@ if (Zend_Loader::isReadable($filename)) {
 
 
         <title>Usando el Autoloader</title>
         <title>Usando el Autoloader</title>
 
 
-        <para>
-            La clase
-            <classname>Zend_Loader</classname>
-            contiene un método que se puede registrar
-            con
-            <acronym>PHP</acronym>
-            SPL autoloader.
-            <methodname>Zend_Loader::autoload()</methodname>
-            es el método
-            callback. Por comodidad,
-            <classname>Zend_Loader</classname>
-            permite a la función
-            <methodname>registerAutoload()</methodname>
-            registrar su método
-            <methodname>autoload()</methodname>
-            . Si la extensión
-            <methodname>spl_autoload</methodname>
-            no está presente en el entorno
-            <acronym>PHP</acronym>
-            , entonces el método
-            <methodname>registerAutoload()</methodname>
-            lanza una
-            <classname>Zend_Exception</classname>
-            .
-        </para>
+        <para> La clase <classname>Zend_Loader</classname> contiene un método
+            que se puede registrar con <acronym>PHP</acronym> SPL autoloader.
+                <methodname>Zend_Loader::autoload()</methodname> es el método
+            callback. Por comodidad, <classname>Zend_Loader</classname> permite
+            a la función <methodname>registerAutoload()</methodname> registrar
+            su método <methodname>autoload()</methodname> . Si la extensión
+                <methodname>spl_autoload</methodname> no está presente en el
+            entorno <acronym>PHP</acronym> , entonces el método
+                <methodname>registerAutoload()</methodname> lanza una
+                <classname>Zend_Exception</classname> . </para>
 
 
         <example id="zend.loader.load.autoload.example">
         <example id="zend.loader.load.autoload.example">
-            <title>Ejemplo de registro del método callback del autoloader</title>
+            <title>Ejemplo de registro del método callback del
+                autoloader</title>
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 Zend_Loader::registerAutoload();
 Zend_Loader::registerAutoload();
 ]]></programlisting>
 ]]></programlisting>
         </example>
         </example>
 
 
-        <para>
-            Después de registrar el callback de autoload de Zend Framework, se pueden
-            referenciar
-            clases de Zend Framework sin tener que cargarlas
-            explícitamente. El método
-            <methodname>autoload()</methodname>
-            usa automáticamente
-            <methodname>Zend_Loader::loadClass()</methodname>
-            cuando referencie una clase.
-        </para>
+        <para> Después de registrar el callback de autoload de Zend Framework,
+            se pueden referenciar clases de Zend Framework sin tener que
+            cargarlas explícitamente. El método
+                <methodname>autoload()</methodname> usa automáticamente
+                <methodname>Zend_Loader::loadClass()</methodname> cuando
+            referencie una clase. </para>
 
 
-        <para>
-            Si ha extendido la clase
-            <classname>Zend_Loader</classname>
-            , se puede pasar un
-            argumento opcional a
-            <methodname>registerAutoload()</methodname>
-            , para especificar
+        <para> Si ha extendido la clase <classname>Zend_Loader</classname> , se
+            puede pasar un argumento opcional a
+                <methodname>registerAutoload()</methodname> , para especificar
             la clase a partir de la cual registrar un método
             la clase a partir de la cual registrar un método
-            <methodname>autoload()</methodname>
-            .
-        </para>
+                <methodname>autoload()</methodname> . </para>
 
 
         <example id="zend.loader.load.autoload.example-extended">
         <example id="zend.loader.load.autoload.example-extended">
-            <title>Ejemplo de registro del método de callback autoload desde una clase
-                extendida</title>
-            <para>
-                Debido a la semántica de referencia de funciones estáticas en
-                <acronym>PHP</acronym>
-                ,
-                se debe implementar código tanto para la clase
-                <methodname>loadClass()</methodname>
-                como
-                <methodname>autoload()</methodname>
-                , y
-                <methodname>autoload()</methodname>
-                debe llamar a
-                <methodname>self::loadClass()</methodname>
-                . Si su método
-                <methodname>autoload()</methodname>
-                delega en su padre la llamada a
-                <methodname>self::loadClass()</methodname>
-                , entonces llamará
-                al método con ese nombre en la clase padre, no la subclase.
-            </para>
+            <title>Ejemplo de registro del método de callback autoload desde una
+                clase extendida</title>
+            <para> Debido a la semántica de referencia de funciones estáticas en
+                    <acronym>PHP</acronym> , se debe implementar código tanto
+                para la clase <methodname>loadClass()</methodname> como
+                    <methodname>autoload()</methodname> , y
+                    <methodname>autoload()</methodname> debe llamar a
+                    <methodname>self::loadClass()</methodname> . Si su método
+                    <methodname>autoload()</methodname> delega en su padre la
+                llamada a <methodname>self::loadClass()</methodname> , entonces
+                llamará al método con ese nombre en la clase padre, no la
+                subclase. </para>
             <programlisting language="php"><![CDATA[
             <programlisting language="php"><![CDATA[
 class My_Loader extends Zend_Loader
 class My_Loader extends Zend_Loader
 {
 {
@@ -341,21 +219,12 @@ Zend_Loader::registerAutoload('My_Loader');
 ]]></programlisting>
 ]]></programlisting>
         </example>
         </example>
 
 
-        <para>
-            Se puede eliminar un callback de autoload.
-            <methodname>registerAutoload()</methodname>
-            tiene un segundo parámetro opcional,
-            que es
-            <constant>TRUE</constant>
-            por defecto. Si este parámetro es
-            <constant>FALSE</constant>
-            , el callback de autoload será borrado de la pila
-            de autoload SPL.
-        </para>
+        <para> Se puede eliminar un callback de autoload.
+                <methodname>registerAutoload()</methodname> tiene un segundo
+            parámetro opcional, que es <constant>TRUE</constant> por defecto. Si
+            este parámetro es <constant>FALSE</constant> , el callback de
+            autoload será borrado de la pila de autoload SPL. </para>
 
 
     </sect2>
     </sect2>
 
 
 </sect1>
 </sect1>
-    <!--
-vim:se ts=4 sw=4 et:
--->

+ 91 - 168
documentation/manual/es/module_specs/Zend_Pdf-Properties.xml

@@ -1,27 +1,17 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 17227 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.pdf.info">
 <sect1 id="zend.pdf.info">
     <!-- @todo review and revise upon completion of refactoring -->
     <!-- @todo review and revise upon completion of refactoring -->
     <title>Información del Documento y Metadatos</title>
     <title>Información del Documento y Metadatos</title>
-    <para>
-        Un documento
-        <acronym>PDF</acronym>
-        puede incluir información general como el título del documento, autor,
-        la creación y
-        modificación de fechas.
-    </para>
-    <para>
-        Históricamente, esta información se almacena usando una estructura especial de
-        Información.
-        Esta estructura está disponible para lectura y la escritura como una array
-        asociativo
-        utilizando propiedades públicas
-        <methodname>properties</methodname>
-        de objetos
-        <classname>Zend_Pdf</classname>
-        :
-        <programlisting language="php"><![CDATA[
+    <para> Un documento <acronym>PDF</acronym> puede incluir información general
+        como el título del documento, autor, la creación y modificación de
+        fechas. </para>
+    <para> Históricamente, esta información se almacena usando una estructura
+        especial de Información. Esta estructura está disponible para lectura y
+        la escritura como una array asociativo utilizando propiedades públicas
+            <methodname>properties</methodname> de objetos
+            <classname>Zend_Pdf</classname> : <programlisting language="php"><![CDATA[
 $pdf = Zend_Pdf::load($pdfPath);
 $pdf = Zend_Pdf::load($pdfPath);
 
 
 echo $pdf->properties['Title'] . "\n";
 echo $pdf->properties['Title'] . "\n";
@@ -31,194 +21,142 @@ $pdf->properties['Title'] = 'New Title.';
 $pdf->save($pdfPath);
 $pdf->save($pdfPath);
 ]]></programlisting>
 ]]></programlisting>
     </para>
     </para>
-    <para>
-        Las siguientes claves están definidas por v1.4
-        <acronym>PDF</acronym>
-        (Acrobat 5) estándar:
-        <itemizedlist>
+    <para> Las siguientes claves están definidas por v1.4 <acronym>PDF</acronym>
+        (Acrobat 5) estándar: <itemizedlist>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>Title</emphasis>
-                    - string, opcional, el título del documento.
-                </para>
+                    <emphasis>Title</emphasis> - string, opcional, el título del
+                    documento. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>Author</emphasis>
-                    - string, opcional, el nombre de la persona que creó
-                    el documento.
-                </para>
+                    <emphasis>Author</emphasis> - string, opcional, el nombre de
+                    la persona que creó el documento. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>Subject</emphasis>
-                    - string, opcional, el tema del documento.
-                </para>
+                    <emphasis>Subject</emphasis> - string, opcional, el tema del
+                    documento. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>Keywords</emphasis>
-                    - string, opcional, las palabras clave asociadas
-                    con el documento.
-                </para>
+                    <emphasis>Keywords</emphasis> - string, opcional, las
+                    palabras clave asociadas con el documento. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>Creator</emphasis>
-                    - string, opcional, si el documento se convirtió
-                    desde otro formato a
-                    <acronym>PDF</acronym>
-                    , el nombre de la aplicación (por ejemplo, Adobe
-                    FrameMaker ®) que creó el
-                    documento original a partir del cual se convirtió.
-                </para>
+                    <emphasis>Creator</emphasis> - string, opcional, si el
+                    documento se convirtió desde otro formato a
+                        <acronym>PDF</acronym> , el nombre de la aplicación (por
+                    ejemplo, Adobe FrameMaker ®) que creó el documento original
+                    a partir del cual se convirtió. </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>Producer</emphasis>
-                    - string, opcional, si el documento se convirtió
-                    desde otro formato a
-                    <acronym>PDF</acronym>
-                    , el nombre de la aplicación (por ejemplo, Acrobat
-                    Distiller), que lo convirtió a
-                    <acronym>PDF</acronym>
-                    .
-                </para>
+                    <emphasis>Producer</emphasis> - string, opcional, si el
+                    documento se convirtió desde otro formato a
+                        <acronym>PDF</acronym> , el nombre de la aplicación (por
+                    ejemplo, Acrobat Distiller), que lo convirtió a
+                        <acronym>PDF</acronym> . </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>CreationDate</emphasis>
-                    - string, opcional, la fecha y la hora en que
-                    el documento fue creado, en la
-                    forma siguiente: "D:YYYYMMDDHHmmSSOHH'mm'", en la
-                    que:
-                    <itemizedlist>
+                    <emphasis>CreationDate</emphasis> - string, opcional, la
+                    fecha y la hora en que el documento fue creado, en la forma
+                    siguiente: "D:YYYYMMDDHHmmSSOHH'mm'", en la que: <itemizedlist>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>YYYY</emphasis>
-                                es el año.
-                            </para>
+                                <emphasis>YYYY</emphasis> es el año. </para>
                         </listitem>
                         </listitem>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>MM</emphasis>
-                                es el mes.
-                            </para>
+                                <emphasis>MM</emphasis> es el mes. </para>
                         </listitem>
                         </listitem>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>DD</emphasis>
-                                es el día (01–31).
+                                <emphasis>DD</emphasis> es el día (01–31).
                             </para>
                             </para>
                         </listitem>
                         </listitem>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>HH</emphasis>
-                                es la hora (00–23).
+                                <emphasis>HH</emphasis> es la hora (00–23).
                             </para>
                             </para>
                         </listitem>
                         </listitem>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>mm</emphasis>
-                                es el minuto (00–59).
+                                <emphasis>mm</emphasis> es el minuto (00–59).
                             </para>
                             </para>
                         </listitem>
                         </listitem>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>SS</emphasis>
-                                es el segundo (00–59).
+                                <emphasis>SS</emphasis> es el segundo (00–59).
                             </para>
                             </para>
                         </listitem>
                         </listitem>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>O</emphasis>
-                                es la relación de la hora local a la hora
-                                universal (UT),
-                                identificado por uno de los caracteres +, -, o Z
-                                (véase más
-                                adelante).
-                            </para>
+                                <emphasis>O</emphasis> es la relación de la hora
+                                local a la hora universal (UT), identificado por
+                                uno de los caracteres +, -, o Z (véase más
+                                adelante). </para>
                         </listitem>
                         </listitem>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>HH</emphasis>
-                                seguido de ' es el valor absoluto de la
-                                posición de la UT en horas
-                                (00-23).
-                            </para>
+                                <emphasis>HH</emphasis> seguido de ' es el valor
+                                absoluto de la posición de la UT en horas
+                                (00-23). </para>
                         </listitem>
                         </listitem>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>mm</emphasis>
-                                seguido de ' es el valor absoluto de la
-                                posición de la UT en minutos
-                                (00-59).
-                            </para>
+                                <emphasis>mm</emphasis> seguido de ' es el valor
+                                absoluto de la posición de la UT en minutos
+                                (00-59). </para>
                         </listitem>
                         </listitem>
-                    </itemizedlist>
-                    El carácter apóstrofe (') después de HH mm es parte de la
-                    sintaxis. Todos los
-                    campos después del año son opcionales. (El prefijo D:,
-                    aunque también opcional,
-                    se recomienda fuertemente.) Los valores por defecto
-                    para MM y DD son 01, y todos
-                    los demás valores numéricos de los campos son cero
-                    por defecto. Un signo más (+)
-                    como el valor del campo O significa que la hora
-                    local es más tarde que la UT, un
-                    signo menos (-) que la hora local es anterior a
-                    la UT, y la letra Z que la hora
-                    local es igual a la UT. Si no se especifica la
-                    información UT, la relación del
-                    tiempo especificado para UT se considera
-                    desconocida. Ya sea que la zona horaria
-                    se conozca o no, el resto de la fecha
-                    debe estar especificada en la hora local.
-                </para>
-                <para>Por ejemplo, el 23 de diciembre de 1998, a las 7:52 PM, hora estándar del
-                    Pacífico de EE.UU., está representado por el string "D:199812231952-08'00'".
-               </para>
+                    </itemizedlist> El carácter apóstrofe (') después de HH mm
+                    es parte de la sintaxis. Todos los campos después del año
+                    son opcionales. (El prefijo D:, aunque también opcional, se
+                    recomienda fuertemente.) Los valores por defecto para MM y
+                    DD son 01, y todos los demás valores numéricos de los campos
+                    son cero por defecto. Un signo más (+) como el valor del
+                    campo O significa que la hora local es más tarde que la UT,
+                    un signo menos (-) que la hora local es anterior a la UT, y
+                    la letra Z que la hora local es igual a la UT. Si no se
+                    especifica la información UT, la relación del tiempo
+                    especificado para UT se considera desconocida. Ya sea que la
+                    zona horaria se conozca o no, el resto de la fecha debe
+                    estar especificada en la hora local. </para>
+                <para>Por ejemplo, el 23 de diciembre de 1998, a las 7:52 PM,
+                    hora estándar del Pacífico de EE.UU., está representado por
+                    el string "D:199812231952-08'00'". </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>ModDate</emphasis>
-                    - string, opcional, la fecha y la hora en que el
-                    documento fue modificado mas
+                    <emphasis>ModDate</emphasis> - string, opcional, la fecha y
+                    la hora en que el documento fue modificado mas
                     recientemente, de la misma forma que
                     recientemente, de la misma forma que
-                    <emphasis>CreationDate</emphasis>
-                    .
-                </para>
+                        <emphasis>CreationDate</emphasis> . </para>
             </listitem>
             </listitem>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>Trapped</emphasis>
-                    - booleano, opcional, indica si el documento ha
-                    sido modificado para incluir la
-                    captura de información.
-                    <itemizedlist>
+                    <emphasis>Trapped</emphasis> - booleano, opcional, indica si
+                    el documento ha sido modificado para incluir la captura de
+                    información. <itemizedlist>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>true</emphasis>
-                                - El documento ha sido capturado; no se
-                                necesitan más capturas.
-                            </para>
+                                <emphasis><constant>TRUE</constant></emphasis> - El documento ha sido
+                                capturado; no se necesitan más capturas. </para>
                         </listitem>
                         </listitem>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>false</emphasis>
-                                - El documento aún no ha sido capturado;
-                                cualquier captura todavía
-                                debe ser hecha.
-                            </para>
+                                <emphasis><constant>FALSE</constant></emphasis> - El documento aún no
+                                ha sido capturado; cualquier captura todavía
+                                debe ser hecha. </para>
                         </listitem>
                         </listitem>
                         <listitem>
                         <listitem>
                             <para>
                             <para>
-                                <emphasis>null</emphasis>
-                                - O bien se desconoce si el documento ha
-                                sido capturado o que lo ha
-                                sido en parte pero no completamente
-                                capturado, y alguna captura
-                                adicional puede ser necesaria.
+                                <emphasis><constant>NULL</constant></emphasis> - O bien se desconoce
+                                si el documento ha sido capturado o que lo ha
+                                sido en parte pero no completamente capturado, y
+                                alguna captura adicional puede ser necesaria.
                             </para>
                             </para>
                         </listitem>
                         </listitem>
                     </itemizedlist>
                     </itemizedlist>
@@ -227,31 +165,16 @@ $pdf->save($pdfPath);
         </itemizedlist>
         </itemizedlist>
     </para>
     </para>
 
 
-    <para>
-        Desde
-        <acronym>PDF</acronym>
-        v 1.6 los metadatos se pueden almacenar en el documento
-        <acronym>XML</acronym>
-        especial adjunto al
-        <acronym>PDF</acronym>
-        (XMP -
-        <ulink url="http://www.adobe.com/products/xmp/">Extensible
-            Metadata Platform</ulink>
-        ).
-    </para>
+    <para> Desde <acronym>PDF</acronym> v 1.6 los metadatos se pueden almacenar
+        en el documento <acronym>XML</acronym> especial adjunto al
+            <acronym>PDF</acronym> (XMP - <ulink
+            url="http://www.adobe.com/products/xmp/">Extensible Metadata
+            Platform</ulink> ). </para>
 
 
-    <para>
-        Este documento
-        <acronym>XML</acronym>
-        se pueden recuperar y adjuntar al
-        <acronym>PDF</acronym>
-        con los
-        métodos
-        <methodname>Zend_Pdf::getMetadata()</methodname>
-        y
-        <methodname>Zend_Pdf::setMetadata($metadata)</methodname>
-        :
-        <programlisting language="php"><![CDATA[
+    <para> Este documento <acronym>XML</acronym> se pueden recuperar y adjuntar
+        al <acronym>PDF</acronym> con los métodos
+            <methodname>Zend_Pdf::getMetadata()</methodname> y
+            <methodname>Zend_Pdf::setMetadata($metadata)</methodname> : <programlisting language="php"><![CDATA[
 $pdf = Zend_Pdf::load($pdfPath);
 $pdf = Zend_Pdf::load($pdfPath);
 $metadata = $pdf->getMetadata();
 $metadata = $pdf->getMetadata();
 $metadataDOM = new DOMDocument();
 $metadataDOM = new DOMDocument();
@@ -273,7 +196,7 @@ $pdf->save($pdfPath);
 ]]></programlisting>
 ]]></programlisting>
     </para>
     </para>
 
 
-    <para>Las propiedades comunes del documento se duplican en la estructura de Info y el documento
-        Metadata (si se presentan). Ahora es responsabilidad del usuario la aplicación para
-        mantenerlos sincronizados.</para>
+    <para>Las propiedades comunes del documento se duplican en la estructura de
+        Info y el documento Metadata (si se presentan). Ahora es responsabilidad
+        del usuario la aplicación para mantenerlos sincronizados.</para>
 </sect1>
 </sect1>

+ 12 - 26
documentation/manual/es/module_specs/Zend_Pdf-Save.xml

@@ -1,39 +1,25 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 17227 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.pdf.save">
 <sect1 id="zend.pdf.save">
     <title>Guardar Cambios a Documentos PDF</title>
     <title>Guardar Cambios a Documentos PDF</title>
-    <para>
-        Hay dos métodos que guardan los cambios a los documentos
-        <acronym>PDF</acronym>
-        : los métodos son
-        <methodname>Zend_Pdf::save()</methodname>
-        y
-        <methodname>Zend_Pdf::render()</methodname>
-        .
-    </para>
+    <para> Hay dos métodos que guardan los cambios a los documentos
+            <acronym>PDF</acronym> : los métodos son
+            <methodname>Zend_Pdf::save()</methodname> y
+            <methodname>Zend_Pdf::render()</methodname> . </para>
 
 
     <para>
     <para>
         <methodname>Zend_Pdf::save($filename, $updateOnly = false)</methodname>
         <methodname>Zend_Pdf::save($filename, $updateOnly = false)</methodname>
-        guarda el documento
-        <acronym>PDF</acronym>
-        en un archivo. Si $updateOnly
-        es verdadero, sólo entonces el nuevo segmento del archivo
-        <acronym>PDF</acronym>
-        se agrega al archivo. De lo contrario, el
-        archivo es sobreescrito.
-    </para>
+        guarda el documento <acronym>PDF</acronym> en un archivo. Si $updateOnly
+        es <constant>TRUE</constant>, sólo entonces el nuevo segmento del archivo
+            <acronym>PDF</acronym> se agrega al archivo. De lo contrario, el
+        archivo es sobreescrito. </para>
 
 
     <para>
     <para>
         <methodname>Zend_Pdf::render($newSegmentOnly = false)</methodname>
         <methodname>Zend_Pdf::render($newSegmentOnly = false)</methodname>
-        regresa
-        el documento
-        <acronym>PDF</acronym>
-        como un string. Si $newSegmentOnly
-        es verdadero, entonces sólo el nuevo segmento del archivo
-        <acronym>PDF</acronym>
-        es devuelto.
-    </para>
+        regresa el documento <acronym>PDF</acronym> como un string. Si
+        $newSegmentOnly es verdadero, entonces sólo el nuevo segmento del
+        archivo <acronym>PDF</acronym> es devuelto. </para>
 
 
     <example id="zend.pdf.save.example-1">
     <example id="zend.pdf.save.example-1">
         <title>Guardando Documentos PDF</title>
         <title>Guardando Documentos PDF</title>

+ 183 - 308
documentation/manual/es/module_specs/Zend_Validate-EmailAddress.xml

@@ -1,25 +1,21 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 19419 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect2 id="zend.validate.set.email_address">
 <sect2 id="zend.validate.set.email_address">
 
 
     <title>Dirección de Email</title>
     <title>Dirección de Email</title>
 
 
     <para>
     <para>
-        <classname>Zend_Validate_EmailAddress</classname>
-        Le permite validar una dirección
-        de email. El validador primero divide la dirección de email
-        en la parte
-        local @ nombre de host e intenta igualar a estos contra especificaciones
-        conocidas para direcciones y nombres de host para el correo electrónico.
-    </para>
+        <classname>Zend_Validate_EmailAddress</classname> Le permite validar una
+        dirección de email. El validador primero divide la dirección de email en
+        la parte local @ nombre de host e intenta igualar a estos contra
+        especificaciones conocidas para direcciones y nombres de host para el
+        correo electrónico. </para>
 
 
     <sect3 id="zend.validate.set.email_address.basic">
     <sect3 id="zend.validate.set.email_address.basic">
         <title>Utilización básica</title>
         <title>Utilización básica</title>
 
 
-        <para>
-            Un ejemplo básico de uso se ve a continuación:
-</para>
+        <para> Un ejemplo básico de uso se ve a continuación: </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_EmailAddress();
 $validator = new Zend_Validate_EmailAddress();
@@ -33,14 +29,9 @@ if ($validator->isValid($email)) {
 }
 }
 ]]></programlisting>
 ]]></programlisting>
 
 
-        <para>
-            Esto coincide con el correo electrónico
-            <varname>$email</varname>
-            y si fracasa,
-            alimenta
-            <code>$validator->getMessages()</code>
-            con mensajes de error útiles.
-        </para>
+        <para> Esto coincide con el correo electrónico <varname>$email</varname>
+            y si fracasa, alimenta <code>$validator->getMessages()</code> con
+            mensajes de error útiles. </para>
     </sect3>
     </sect3>
 
 
     <sect3 id="zend.validate.set.email_address.options">
     <sect3 id="zend.validate.set.email_address.options">
@@ -48,90 +39,59 @@ if ($validator->isValid($email)) {
         <title>>Partes locales complejas</title>
         <title>>Partes locales complejas</title>
 
 
         <para>
         <para>
-            <classname>Zend_Validate_EmailAddress</classname>
-            supports several options which can
-            either be set at initiation, by giving an array with
-            the related options, or
-            afterwards, by using
-            <methodname>setOptions()</methodname>
-            . The following options are
-            supported:
-        </para>
+            <classname>Zend_Validate_EmailAddress</classname> supports several
+            options which can either be set at initiation, by giving an array
+            with the related options, or afterwards, by using
+                <methodname>setOptions()</methodname> . The following options
+            are supported: </para>
 
 
         <itemizedlist>
         <itemizedlist>
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>allow</emphasis>
-                    : Defines which type of domain names are accepted.
-                    This option is used in
-                    conjunction with the hostname option to set the
-                    hostname validator. For more
-                    informations about possible values of this
-                    option, look at
-                    <link linkend="zend.validate.set.hostname">Hostname</link>
-                    and possible
-                    <constant>ALLOW</constant>
+                    <emphasis>allow</emphasis> : Defines which type of domain
+                    names are accepted. This option is used in conjunction with
+                    the hostname option to set the hostname validator. For more
+                    informations about possible values of this option, look at
+                        <link linkend="zend.validate.set.hostname"
+                        >Hostname</link> and possible <constant>ALLOW</constant>
                     * constants. This option defaults to
                     * constants. This option defaults to
-                    <constant>ALLOW_DNS</constant>
-                    .
-                </para>
+                        <constant>ALLOW_DNS</constant> . </para>
             </listitem>
             </listitem>
 
 
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>hostname</emphasis>
-                    : Sets the hostname validator with which the
-                    domain part of the email address
-                    will be validated.
-                </para>
+                    <emphasis>hostname</emphasis> : Sets the hostname validator
+                    with which the domain part of the email address will be
+                    validated. </para>
             </listitem>
             </listitem>
 
 
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>mx</emphasis>
-                    : Defines if the MX records from the server should be
-                    detected. If this option is
-                    defined to
-                    <constant>TRUE</constant>
-                    then the MX
-                    records are used to verify if the server
-                    accepts emails. This option
-                    defaults to
-                    <constant>FALSE</constant>
-                    .
-                </para>
+                    <emphasis>mx</emphasis> : Defines if the MX records from the
+                    server should be detected. If this option is defined to
+                        <constant>TRUE</constant> then the MX records are used
+                    to verify if the server accepts emails. This option defaults
+                    to <constant>FALSE</constant> . </para>
             </listitem>
             </listitem>
 
 
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>deep</emphasis>
-                    : Defines if the servers MX records should be verified
-                    by a deep check. When this
-                    option is set to
-                    <constant>TRUE</constant>
-                    then
-                    additionally to MX records also the A, A6 and
-                    <constant>AAAA</constant>
-                    records
-                    are used to verify if the server accepts emails. This option defaults to
-                    <constant>FALSE</constant>
-                    .
-                </para>
+                    <emphasis>deep</emphasis> : Defines if the servers MX
+                    records should be verified by a deep check. When this option
+                    is set to <constant>TRUE</constant> then additionally to MX
+                    records also the A, A6 and <constant>AAAA</constant> records
+                    are used to verify if the server accepts emails. This option
+                    defaults to <constant>FALSE</constant> . </para>
             </listitem>
             </listitem>
 
 
             <listitem>
             <listitem>
                 <para>
                 <para>
-                    <emphasis>domain</emphasis>
-                    : Defines if the domain part should be checked.
-                    When this option is set to
-                    <constant>FALSE</constant>
-                    , then only the local part
-                    of the email address will be checked. In this case the
-                    hostname validator will
-                    not be called. This option defaults to
-                    <constant>TRUE</constant>
-                    .
-                </para>
+                    <emphasis>domain</emphasis> : Defines if the domain part
+                    should be checked. When this option is set to
+                        <constant>FALSE</constant> , then only the local part of
+                    the email address will be checked. In this case the hostname
+                    validator will not be called. This option defaults to
+                        <constant>TRUE</constant> . </para>
             </listitem>
             </listitem>
         </itemizedlist>
         </itemizedlist>
 
 
@@ -145,45 +105,29 @@ $validator->setOptions(array('domain' => false));
         <title>Complex local parts</title>
         <title>Complex local parts</title>
 
 
         <para>
         <para>
-            <classname>Zend_Validate_EmailAddress</classname>
-            se comparará con cualquier
-            dirección de correo válida de acuardo a RFC2822.
-            Por ejemplo, correos electrónicos válidos incluyen
-            <code>bob@domain.com</code>
-            ,
-            <code>bob+jones@domain.us</code>
-            ,
-            <code>"bob@jones"@domain.com</code>
-            y
-            <code>"bob jones"@domain.com</code>
+            <classname>Zend_Validate_EmailAddress</classname> se comparará con
+            cualquier dirección de correo válida de acuardo a RFC2822. Por
+            ejemplo, correos electrónicos válidos incluyen
+                <code>bob@domain.com</code> , <code>bob+jones@domain.us</code> ,
+                <code>"bob@jones"@domain.com</code> y <code>"bob
+                jones"@domain.com</code>
         </para>
         </para>
 
 
-        <para>
-            Algunos formatos obsoletos de email actualmente no validan
-            (por ejemplo los retornos de carro o "\" un caracter en una dirección
-            de correo electrónico).
-   </para>
+        <para> Algunos formatos obsoletos de email actualmente no validan (por
+            ejemplo los retornos de carro o "\" un caracter en una dirección de
+            correo electrónico). </para>
 
 
     </sect3>
     </sect3>
 
 
     <sect3 id="zend.validate.set.email_address.purelocal">
     <sect3 id="zend.validate.set.email_address.purelocal">
         <title>Validating only the local part</title>
         <title>Validating only the local part</title>
 
 
-        <para>
-            If you need
-            <classname>Zend_Validate_EmailAddress</classname>
-            to check only the local
-            part of an email address, and want to disable validation of the
-            hostname, you can
-            set the
-            <property>domain</property>
-            option to
-            <constant>FALSE</constant>
-            . This forces
-            <classname>Zend_Validate_EmailAddress</classname>
-            not to validate the hostname part of
-            the email address.
-        </para>
+        <para> If you need <classname>Zend_Validate_EmailAddress</classname> to
+            check only the local part of an email address, and want to disable
+            validation of the hostname, you can set the
+                <property>domain</property> option to <constant>FALSE</constant>
+            . This forces <classname>Zend_Validate_EmailAddress</classname> not
+            to validate the hostname part of the email address. </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_EmailAddress();
 $validator = new Zend_Validate_EmailAddress();
@@ -194,28 +138,19 @@ $validator->setOptions(array('domain' => FALSE));
     <sect3 id="zend.validate.set.email_address.hostnametype">
     <sect3 id="zend.validate.set.email_address.hostnametype">
         <title>Validating different types of hostnames</title>
         <title>Validating different types of hostnames</title>
 
 
-        <para>
-            La parte nombre de host de una dirección de correo es validado contra
-            <link linkend="zend.validate.set.hostname">
+        <para> La parte nombre de host de una dirección de correo es validado
+            contra <link linkend="zend.validate.set.hostname">
                 <classname>Zend_Validate_Hostname</classname>
                 <classname>Zend_Validate_Hostname</classname>
-            </link>
-            .
-            Por defecto sólo son aceptados nombres de host DNS de la forma
-            <methodname>domain.com</methodname>
-            , aunque si lo desea también puede aceptar
-            direcciones IP y nombres de host locales.
-        </para>
+            </link> . Por defecto sólo son aceptados nombres de host DNS de la
+            forma <methodname>domain.com</methodname> , aunque si lo desea
+            también puede aceptar direcciones IP y nombres de host locales. </para>
 
 
-        <para>
-            Para ello necesita instanciar a
-            <classname>Zend_Validate_EmailAddress</classname>
-            pasando un parámetro para indicar el tipo de nombres de host que quiere aceptar.
-            Más detalles están incluidos en
-            <classname>Zend_Validate_EmailAddress</classname>
-            ,
-            aunque abajo hay un ejemplo de cómo aceptar tanto nombres de host DNS y
-            locales:
-        </para>
+        <para> Para ello necesita instanciar a
+                <classname>Zend_Validate_EmailAddress</classname> pasando un
+            parámetro para indicar el tipo de nombres de host que quiere
+            aceptar. Más detalles están incluidos en
+                <classname>Zend_Validate_EmailAddress</classname> , aunque abajo
+            hay un ejemplo de cómo aceptar tanto nombres de host DNS y locales: </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_EmailAddress(
 $validator = new Zend_Validate_EmailAddress(
@@ -231,31 +166,26 @@ if ($validator->isValid($email)) {
 }
 }
 ]]></programlisting>
 ]]></programlisting>
 
 
-</sect3>
-        <sect3 id="zend.validate.set.email_address.checkacceptance">
-
-            <title>Verificar si el nombre de host realmente acepta email</title>
-
-            <para>
-                Sólo porque una dirección de correo electrónico está en el formato correcto,
-                no necesariamente significa que esa dirección de correo electrónico
-                existe realmente. Para ayudar a resolver este problema, puede usar la
-                validación MX para comprobar si existe una entrada MX (email) en el
-                registro DNS para correo electrónico en ese nombre de host.
-                Esto le dice que el nombre de host acepta email, pero no le dice si la
-                dirección de correo electrónico exacta es válida en si misma.
-   </para>
-
-            <para>
-                La comprobación MX no está activada por defecto y en este momento es
-                soportada sólo por plataformas UNIX.
-                Para habilitar el control MX puede pasar un segundo parámetro al
-                constructor
-                <classname>Zend_Validate_EmailAddress</classname>
-                .
-            </para>
-
-            <programlisting language="php"><![CDATA[
+    </sect3>
+    <sect3 id="zend.validate.set.email_address.checkacceptance">
+
+        <title>Verificar si el nombre de host realmente acepta email</title>
+
+        <para> Sólo porque una dirección de correo electrónico está en el
+            formato correcto, no necesariamente significa que esa dirección de
+            correo electrónico existe realmente. Para ayudar a resolver este
+            problema, puede usar la validación MX para comprobar si existe una
+            entrada MX (email) en el registro DNS para correo electrónico en ese
+            nombre de host. Esto le dice que el nombre de host acepta email,
+            pero no le dice si la dirección de correo electrónico exacta es
+            válida en si misma. </para>
+
+        <para> La comprobación MX no está activada por defecto y en este momento
+            es soportada sólo por plataformas UNIX. Para habilitar el control MX
+            puede pasar un segundo parámetro al constructor
+                <classname>Zend_Validate_EmailAddress</classname> . </para>
+
+        <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_EmailAddress(
 $validator = new Zend_Validate_EmailAddress(
     array(
     array(
         'allow' => Zend_Validate_Hostname::ALLOW_DNS,
         'allow' => Zend_Validate_Hostname::ALLOW_DNS,
@@ -264,53 +194,35 @@ $validator = new Zend_Validate_EmailAddress(
 );
 );
 ]]></programlisting>
 ]]></programlisting>
 
 
-            <note>
-                <title>MX Check under Windows</title>
+        <note>
+            <title>MX Check under Windows</title>
+
+            <para> Within Windows environments MX checking is only available
+                when <acronym>PHP</acronym> 5.3 or above is used. Below
+                    <acronym>PHP</acronym> 5.3 MX checking will not be used even
+                if it's activated within the options. </para>
+        </note>
+
+        <para> Alternativamente, para activar o desactivar la validación MX
+            puede pasar <constant>TRUE</constant> o <constant>FALSE</constant> a
+                <methodname>$validator->setValidateMx()</methodname> . </para>
+
+        <para> Al habilitarlo, se usarán las funciones de red para comprobar la
+            presencia de un registro MX en el nombre de host de la dirección de
+            correo electrónico que desea validar. Tenga en cuenta esto
+            probablemente hará más lento su script. </para>
+
+        <para> Sometimes validation for MX records returns false, even if emails
+            are accepted. The reason behind this behaviour is, that servers can
+            accept emails even if they do not provide a MX record. In this case
+            they can provide A, A6 or <constant>AAAA</constant> records. To
+            allow <classname>Zend_Validate_EmailAddress</classname> to check
+            also for these other records, you need to set deep MX validation.
+            This can be done at initiation by setting the
+                <property>deep</property> option or by using
+                <methodname>setOptions()</methodname> . </para>
 
 
-                <para>
-                    Within Windows environments MX checking is only available when
-                    <acronym>PHP</acronym>
-                    5.3 or above is used. Below
-                    <acronym>PHP</acronym>
-                    5.3 MX
-                    checking will not be used even if it's activated within the options.
-                </para>
-            </note>
-
-            <para>
-                Alternativamente, para activar o desactivar la validación MX puede pasar
-                <constant>TRUE</constant>
-                o
-                <constant>FALSE</constant>
-                a
-                <methodname>$validator->setValidateMx()</methodname>
-                .
-            </para>
-
-            <para>
-                Al habilitarlo, se usarán las funciones de red para comprobar
-                la presencia de un registro MX en el nombre de host de la dirección
-                de correo electrónico que desea validar.
-                Tenga en cuenta esto probablemente hará más lento su script.
-   </para>
-
-            <para>
-                Sometimes validation for MX records returns false, even if emails are accepted. The
-                reason behind this behaviour is, that servers can accept emails even if they do not
-                provide a MX record. In this case they can provide A, A6 or
-                <constant>AAAA</constant>
-                records. To allow
-                <classname>Zend_Validate_EmailAddress</classname>
-                to check also for
-                these other records, you need to set deep MX validation. This can be done at initiation
-                by setting the
-                <property>deep</property>
-                option or by using
-                <methodname>setOptions()</methodname>
-                .
-            </para>
-
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_EmailAddress(
 $validator = new Zend_Validate_EmailAddress(
     array(
     array(
         'allow' => Zend_Validate_Hostname::ALLOW_DNS,
         'allow' => Zend_Validate_Hostname::ALLOW_DNS,
@@ -320,113 +232,82 @@ $validator = new Zend_Validate_EmailAddress(
 );
 );
 ]]></programlisting>
 ]]></programlisting>
 
 
-            <warning>
-                <title>Performance warning</title>
+        <warning>
+            <title>Performance warning</title>
 
 
-                <para>
-                    You should be aware that enabling MX check will slow down you script because of the
-                    used network functions. Enabling deep check will slow down your script even more as
-                    it searches the given server for 3 additional types.
-            </para>
-            </warning>
+            <para> You should be aware that enabling MX check will slow down you
+                script because of the used network functions. Enabling deep
+                check will slow down your script even more as it searches the
+                given server for 3 additional types. </para>
+        </warning>
 
 
-            <note>
-                <title>Disallowed IP addresses</title>
+        <note>
+            <title>Disallowed IP addresses</title>
 
 
-                <para>
-                    You should note that MX validation is only accepted for external servers. When
-                    deep
-                    MX validation is enabled, then local IP addresses like
-                    <command>192.168.*</command>
-                    or
-                    <command>169.254.*</command>
-                    are not accepted.
-                </para>
-            </note>
-        </sect3>
-
-        <sect3 id="zend.validate.set.email_address.validateidn">
-            <title>Validating International Domains Names</title>
-
-            <para>
-                <classname>Zend_Validate_EmailAddress</classname>
-                también comparará caracteres
-                internationales que existen en algunos dominios.
-                Esto se conoce como soporte de International Domain Name (IDN).
-                Está activado por defecto, aunque puede deshabilitarlo internamente
-                cambiando el ajuste a través del objeto
-                <classname>Zend_Validate_Hostname</classname>
-                que existe en
-                <classname>Zend_Validate_EmailAddress</classname>
-                .
-            </para>
+            <para> You should note that MX validation is only accepted for
+                external servers. When deep MX validation is enabled, then local
+                IP addresses like <command>192.168.*</command> or
+                    <command>169.254.*</command> are not accepted. </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.validate.set.email_address.validateidn">
+        <title>Validating International Domains Names</title>
+
+        <para>
+            <classname>Zend_Validate_EmailAddress</classname> también comparará
+            caracteres internationales que existen en algunos dominios. Esto se
+            conoce como soporte de International Domain Name (IDN). Está
+            activado por defecto, aunque puede deshabilitarlo internamente
+            cambiando el ajuste a través del objeto
+                <classname>Zend_Validate_Hostname</classname> que existe en
+                <classname>Zend_Validate_EmailAddress</classname> . </para>
 
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $validator->getHostnameValidator()->setValidateIdn(false);
 $validator->getHostnameValidator()->setValidateIdn(false);
 ]]></programlisting>
 ]]></programlisting>
 
 
-            <para>
-                Sobre el uso de
-                <methodname>setValidateIdn()</methodname>
-                encontrará más información
-                en la documentación de
-                <classname>Zend_Validate_Hostname</classname>
-                .
-            </para>
-
-            <para>
-                Tenga en cuenta que los IDNs se validarán solo si
-                usted permite que nombres de host DNS sean validados.
-   </para>
-        </sect3>
-
-        <sect3 id="zend.validate.set.email_address.validatetld">
-            <title>Validación de dominios de nivel superior</title>
-
-            <para>
-                Por defecto, un nombre de host se cotejará con una lista conocida de TLDs.
-                Está activado por defecto, aunque puede deshabilitarlo cambiando el
-                ajuste a través del objeto interno
-                <classname>Zend_Validate_Hostname</classname>
-                que existe en
-                <classname>Zend_Validate_EmailAddress</classname>
-                .
-            </para>
+        <para> Sobre el uso de <methodname>setValidateIdn()</methodname>
+            encontrará más información en la documentación de
+                <classname>Zend_Validate_Hostname</classname> . </para>
+
+        <para> Tenga en cuenta que los IDNs se validarán solo si usted permite
+            que nombres de host DNS sean validados. </para>
+    </sect3>
+
+    <sect3 id="zend.validate.set.email_address.validatetld">
+        <title>Validación de dominios de nivel superior</title>
+
+        <para> Por defecto, un nombre de host se cotejará con una lista conocida
+            de TLDs. Está activado por defecto, aunque puede deshabilitarlo
+            cambiando el ajuste a través del objeto interno
+                <classname>Zend_Validate_Hostname</classname> que existe en
+                <classname>Zend_Validate_EmailAddress</classname> . </para>
 
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $validator->getHostnameValidator()->setValidateTld(false);
 $validator->getHostnameValidator()->setValidateTld(false);
 ]]></programlisting>
 ]]></programlisting>
 
 
-            <para>
-                Encontrará más información sobre el uso de
-                <methodname>setValidateTld()</methodname>
-                en la documentación de
-                <classname>Zend_Validate_Hostname</classname>
-                .
-            </para>
+        <para> Encontrará más información sobre el uso de
+                <methodname>setValidateTld()</methodname> en la documentación de
+                <classname>Zend_Validate_Hostname</classname> . </para>
 
 
-            <para>
-                Tenga en cuenta que los TLDs se validarán solo si
-                usted permite que nombres de host DNS sean validados.
-   </para>
-        </sect3>
+        <para> Tenga en cuenta que los TLDs se validarán solo si usted permite
+            que nombres de host DNS sean validados. </para>
+    </sect3>
 
 
-        <sect3 id="zend.validate.set.email_address.setmessage">
-            <title>Setting messages</title>
+    <sect3 id="zend.validate.set.email_address.setmessage">
+        <title>Setting messages</title>
 
 
-            <para>
-                <classname>Zend_Validate_EmailAddress</classname>
-                makes also use of
-                <classname>Zend_Validate_Hostname</classname>
-                to check the hostname part of a given
-                email address. As with Zend Framework 1.10 you can simply set messages for
-                <classname>Zend_Validate_Hostname</classname>
-                from within
-                <classname>Zend_Validate_EmailAddress</classname>
-                .
-            </para>
+        <para>
+            <classname>Zend_Validate_EmailAddress</classname> makes also use of
+                <classname>Zend_Validate_Hostname</classname> to check the
+            hostname part of a given email address. As with Zend Framework 1.10
+            you can simply set messages for
+                <classname>Zend_Validate_Hostname</classname> from within
+                <classname>Zend_Validate_EmailAddress</classname> . </para>
 
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_EmailAddress();
 $validator = new Zend_Validate_EmailAddress();
 $validator->setMessages(
 $validator->setMessages(
     array(
     array(
@@ -435,16 +316,10 @@ $validator->setMessages(
 );
 );
 ]]></programlisting>
 ]]></programlisting>
 
 
-            <para>
-                Before Zend Framework 1.10 you had to attach the messages to your own
-                <classname>Zend_Validate_Hostname</classname>
-                , and then set this validator within
-                <classname>Zend_Validate_EmailAddress</classname>
-                to get your own messages returned.
-            </para>
-        </sect3>
+        <para> Before Zend Framework 1.10 you had to attach the messages to your
+            own <classname>Zend_Validate_Hostname</classname> , and then set
+            this validator within
+                <classname>Zend_Validate_EmailAddress</classname> to get your
+            own messages returned. </para>
+    </sect3>
 </sect2>
 </sect2>
-
-    <!--
-vim:se ts=4 sw=4 et:
--->

+ 56 - 131
documentation/manual/es/module_specs/Zend_Validate-Hostname.xml

@@ -1,29 +1,23 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 19568 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect2 id="zend.validate.set.hostname">
 <sect2 id="zend.validate.set.hostname">
 
 
     <title>Hostname (Nombre de Host)</title>
     <title>Hostname (Nombre de Host)</title>
 
 
     <para>
     <para>
-        <classname>Zend_Validate_Hostname</classname>
-        le permite validar un
+        <classname>Zend_Validate_Hostname</classname> le permite validar un
         nombre de host contra una serie de especificaciones conocidas. Es
         nombre de host contra una serie de especificaciones conocidas. Es
         posible comprobar por tres diferentes tipos de nombres: el DNS Hostname
         posible comprobar por tres diferentes tipos de nombres: el DNS Hostname
-        (domain.com por
-        ejemplo), dirección IP (es decir 1.2.3.4), y nombres de
-        host locales (localhost, por
-        ejemplo). Por defecto sólo se comprobarán
-        nombres de host DNS.
-    </para>
+        (domain.com por ejemplo), dirección IP (es decir 1.2.3.4), y nombres de
+        host locales (localhost, por ejemplo). Por defecto sólo se comprobarán
+        nombres de host DNS. </para>
 
 
     <para>
     <para>
         <emphasis>Uso básico</emphasis>
         <emphasis>Uso básico</emphasis>
     </para>
     </para>
 
 
-    <para>
-        El siguiente es un ejemplo de uso básico:
-        <programlisting language="php"><![CDATA[
+    <para> El siguiente es un ejemplo de uso básico: <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_Hostname();
 $validator = new Zend_Validate_Hostname();
 if ($validator->isValid($hostname)) {
 if ($validator->isValid($hostname)) {
     // hostname parece ser válido
     // hostname parece ser válido
@@ -33,52 +27,29 @@ if ($validator->isValid($hostname)) {
         echo "$message\n";
         echo "$message\n";
     }
     }
 }
 }
-]]></programlisting>
-        Comprobará el nombre de host
-        <varname>$hostname</varname>
-        y si fracasa alimentará a
-        <methodname>getMessages()</methodname>
-        con mensajes de
-        error.
-    </para>
+]]></programlisting> Comprobará el nombre de host <varname>$hostname</varname> y
+        si fracasa alimentará a <methodname>getMessages()</methodname> con
+        mensajes de error. </para>
 
 
     <para>
     <para>
         <emphasis>Validar diferentes tipos de nombres de host</emphasis>
         <emphasis>Validar diferentes tipos de nombres de host</emphasis>
     </para>
     </para>
 
 
-    <para>
-        También se puede encontrar coincidencias de direcciones IP, nombres
-        de host locales, o una
-        combinación de todos los tipos permitidos. Esto
+    <para> También se puede encontrar coincidencias de direcciones IP, nombres
+        de host locales, o una combinación de todos los tipos permitidos. Esto
         puede hacerse pasando un parámetro a
         puede hacerse pasando un parámetro a
-        <classname>Zend_Validate_Hostname</classname>
-        cuando lo instancia.
+            <classname>Zend_Validate_Hostname</classname> cuando lo instancia.
         El parámetro debe ser un entero que determina qué tipos de nombres de
         El parámetro debe ser un entero que determina qué tipos de nombres de
         host están permitidos. Se recomienda el uso de las constantes de
         host están permitidos. Se recomienda el uso de las constantes de
-        <classname>Zend_Validate_Hostname</classname>
-        para hacerlo.
-    </para>
-
-    <para>
-        Las constantes de
-        <classname>Zend_Validate_Hostname</classname>
-        son:
-        <constant>ALLOW_DNS</constant>
-        para permitir sólo nombres de
-        host DNS,
-        <constant>ALLOW_IP</constant>
-        para permitir direcciones
-        IP,
-        <constant>ALLOW_LOCAL</constant>
-        para permitir nombres de host
-        de la red local, y
-        <constant>ALLOW_ALL</constant>
-        para permitir
-        todos estos tres tipos. Para comprobar que direcciones IP puede
-        utilizar, vea el
-        siguiente ejemplo:
-
-        <programlisting language="php"><![CDATA[
+            <classname>Zend_Validate_Hostname</classname> para hacerlo. </para>
+
+    <para> Las constantes de <classname>Zend_Validate_Hostname</classname> son:
+            <constant>ALLOW_DNS</constant> para permitir sólo nombres de host
+        DNS, <constant>ALLOW_IP</constant> para permitir direcciones IP,
+            <constant>ALLOW_LOCAL</constant> para permitir nombres de host de la
+        red local, y <constant>ALLOW_ALL</constant> para permitir todos estos
+        tres tipos. Para comprobar que direcciones IP puede utilizar, vea el
+        siguiente ejemplo: <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_IP);
 $validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_IP);
 if ($validator->isValid($hostname)) {
 if ($validator->isValid($hostname)) {
     // hostname parece ser válido
     // hostname parece ser válido
@@ -91,17 +62,10 @@ if ($validator->isValid($hostname)) {
 ]]></programlisting>
 ]]></programlisting>
     </para>
     </para>
 
 
-    <para>
-        Usando
-        <constant>ALLOW_ALL</constant>
-        para aceptar todos los
-        tipos de nombres de host, también puede combinar estos tipos para
-        realizar combinaciones. Por ejemplo, para aceptar nombres de host DNS y
-        locales, instancie el
-        objeto
-        <classname>Zend_Validate_Hostname</classname>
-        como:
-        <programlisting language="php"><![CDATA[
+    <para> Usando <constant>ALLOW_ALL</constant> para aceptar todos los tipos de
+        nombres de host, también puede combinar estos tipos para realizar
+        combinaciones. Por ejemplo, para aceptar nombres de host DNS y locales,
+        instancie el objeto <classname>Zend_Validate_Hostname</classname> como: <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_DNS |
 $validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_DNS |
                                         Zend_Validate_Hostname::ALLOW_IP);
                                         Zend_Validate_Hostname::ALLOW_IP);
 ]]></programlisting>
 ]]></programlisting>
@@ -111,41 +75,24 @@ $validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_DNS |
         <emphasis>Validación de Nombres de Dominio Internacionales</emphasis>
         <emphasis>Validación de Nombres de Dominio Internacionales</emphasis>
     </para>
     </para>
 
 
-    <para>
-        Algunos (ccTLD), es decir países "Country Code Top Level Domains" ,
-        como 'de' (Alemania),
-        aceptan caracteres internacionales como nombres de
-        dominio. Estos son conocidos como Nombres
-        de Dominio Internacionales
-        (IDN, por sus siglas en inglés). Se puede buscar una coincidencia
-        de
-        estos dominios con
-        <classname>Zend_Validate_Hostname</classname>
-        , a través de caracteres
-        extendidos que se utilizan en el proceso de validación.
-    </para>
+    <para> Algunos (ccTLD), es decir países "Country Code Top Level Domains" ,
+        como 'de' (Alemania), aceptan caracteres internacionales como nombres de
+        dominio. Estos son conocidos como Nombres de Dominio Internacionales
+        (IDN, por sus siglas en inglés). Se puede buscar una coincidencia de
+        estos dominios con <classname>Zend_Validate_Hostname</classname> , a
+        través de caracteres extendidos que se utilizan en el proceso de
+        validación. </para>
 
 
-    <para>
-        Until now more than 50 ccTLDs support IDN domains.
-   </para>
+    <para> Until now more than 50 ccTLDs support IDN domains. </para>
 
 
-    <para>
-        Cotejar dominios IDN es tan simple como usar el validador estándar
-        Hostname, ya que este
-        viene habilitado por defecto. Si desea desactivar
-        la validación IDN, se puede hacer ya sea
-        pasando un parámetro al
-        constructor
-        <classname>Zend_Validate_Hostname</classname>
-        o a través del método
-        <methodname>setValidateIdn()</methodname>
-        .
-    </para>
+    <para> Cotejar dominios IDN es tan simple como usar el validador estándar
+        Hostname, ya que este viene habilitado por defecto. Si desea desactivar
+        la validación IDN, se puede hacer ya sea pasando un parámetro al
+        constructor <classname>Zend_Validate_Hostname</classname> o a través del
+        método <methodname>setValidateIdn()</methodname> . </para>
 
 
     <para>Puede deshabilitar la validación IDN, pasando un segundo parámetro al
     <para>Puede deshabilitar la validación IDN, pasando un segundo parámetro al
-        constructor
-        Zend_Validate_Hostname de la siguiente manera.
-    </para>
+        constructor Zend_Validate_Hostname de la siguiente manera. </para>
 
 
     <programlisting language="php"><![CDATA[
     <programlisting language="php"><![CDATA[
 $validator =
 $validator =
@@ -157,43 +104,28 @@ $validator =
     );
     );
 ]]></programlisting>
 ]]></programlisting>
 
 
-    <para>
-        Alternativamente puede pasar
-        <constant>TRUE</constant>
-        o
-        <constant>FALSE</constant>
-        a
-        <methodname>setValidateIdn()</methodname>
-        para activar o
-        desactivar la validación IDN. Si está tratando de cotejar un nombre de
-        host IDN
-        que actualmente no está soportado, es probable que falle la
-        validación si tiene caracteres
-        internacionales en el nombre de host.
-        Cuando un archivo ccTLD no existe en
-        Zend/Validate/Hostname,
-        especificando los caracteres adicionales se puede realizar una
-        validación normal.
-    </para>
+    <para> Alternativamente puede pasar <constant>TRUE</constant> o
+            <constant>FALSE</constant> a
+            <methodname>setValidateIdn()</methodname> para activar o desactivar
+        la validación IDN. Si está tratando de cotejar un nombre de host IDN que
+        actualmente no está soportado, es probable que falle la validación si
+        tiene caracteres internacionales en el nombre de host. Cuando un archivo
+        ccTLD no existe en Zend/Validate/Hostname, especificando los caracteres
+        adicionales se puede realizar una validación normal. </para>
 
 
     <para>Tenga en cuenta que una validación IDN solo se realizará si tiene
     <para>Tenga en cuenta que una validación IDN solo se realizará si tiene
-        habilidada la validación
-        para nombres de host DNS.</para>
+        habilidada la validación para nombres de host DNS.</para>
 
 
     <para>
     <para>
         <emphasis>Validacuión de dominios de nivel superior</emphasis>
         <emphasis>Validacuión de dominios de nivel superior</emphasis>
     </para>
     </para>
 
 
     <para>Por defecto un nombre de host se cotejará con una lista de TLDs
     <para>Por defecto un nombre de host se cotejará con una lista de TLDs
-        conocidos. Si esta
-        funcionalidad no es necesaria, puede ser desactivada
-        en la misma forma que deshabilita el
-        soporte IDN. Puede deshabilitar la
+        conocidos. Si esta funcionalidad no es necesaria, puede ser desactivada
+        en la misma forma que deshabilita el soporte IDN. Puede deshabilitar la
         validación TLD pasando un tercer parámetro al constructor
         validación TLD pasando un tercer parámetro al constructor
         Zend_Validate_Hostname. En el siguiente ejemplo estamos dando respaldo a
         Zend_Validate_Hostname. En el siguiente ejemplo estamos dando respaldo a
-        la validación IDN a
-        través del segundo parámetro.
-    </para>
+        la validación IDN a través del segundo parámetro. </para>
     <programlisting language="php"><![CDATA[
     <programlisting language="php"><![CDATA[
 $validator =
 $validator =
     new Zend_Validate_Hostname(
     new Zend_Validate_Hostname(
@@ -205,19 +137,12 @@ $validator =
     );
     );
 ]]></programlisting>
 ]]></programlisting>
 
 
-    <para>
-        Alternativamente puede pasar
-        <constant>TRUE</constant>
-        o
-        <constant>FALSE</constant>
-        a
-        <methodname>setValidateTld()</methodname>
-        para activar o
-        desactivar la validación TLD.
-    </para>
+    <para> Alternativamente puede pasar <constant>TRUE</constant> o
+            <constant>FALSE</constant> a
+            <methodname>setValidateTld()</methodname> para activar o desactivar
+        la validación TLD. </para>
 
 
     <para>Tenga en cuenta que una validación de TLDs solo se realizará si tiene
     <para>Tenga en cuenta que una validación de TLDs solo se realizará si tiene
-        habilidada la
-        validación para nombres de host DNS.</para>
+        habilidada la validación para nombres de host DNS.</para>
 
 
 </sect2>
 </sect2>

+ 103 - 199
documentation/manual/es/module_specs/Zend_Validate-Set.xml

@@ -1,67 +1,49 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 20020 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 
 
 <sect1 id="zend.validate.set" xmlns:xi="http://www.w3.org/2001/XInclude">
 <sect1 id="zend.validate.set" xmlns:xi="http://www.w3.org/2001/XInclude">
 
 
     <title>Clases de Validación Estándar</title>
     <title>Clases de Validación Estándar</title>
 
 
-    <para>Zend Framework viene con un conjunto estándar de clases de validación listas para usar.</para>
+    <para>Zend Framework viene con un conjunto estándar de clases de validación
+        listas para usar.</para>
 
 
     <sect2 id="zend.validate.set.alnum">
     <sect2 id="zend.validate.set.alnum">
         <title>Alnum</title>
         <title>Alnum</title>
-        <para>
-            Devuelve
-            <constant>TRUE</constant>
-            si y sólo si
-            <varname>$valor</varname>
-            contiene caracteres alfanuméricos únicamente. Este validador incluye una opción para
-            considerar también al espacio en blanco como caracter válido.
-        </para>
+        <para> Devuelve <constant>TRUE</constant> si y sólo si
+                <varname>$valor</varname> contiene caracteres alfanuméricos
+            únicamente. Este validador incluye una opción para considerar
+            también al espacio en blanco como caracter válido. </para>
     </sect2>
     </sect2>
 
 
     <note>
     <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. El lenguaje es especificado por
+        <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. El lenguaje es especificado por
             Zend_Locale.</para>
             Zend_Locale.</para>
     </note>
     </note>
 
 
     <sect2 id="zend.validate.set.alpha">
     <sect2 id="zend.validate.set.alpha">
         <title>Alpha</title>
         <title>Alpha</title>
-        <para>
-            Devuelve
-            <constant>TRUE</constant>
-            si y sólo si
-            <varname>$valor</varname>
-            sólo
-            contiene caracteres alfabéticos. Este validador incluye una opción para considerar
-            también al espacio en blanco como caracter válido.
-        </para>
+        <para> Devuelve <constant>TRUE</constant> si y sólo si
+                <varname>$valor</varname> sólo contiene caracteres alfabéticos.
+            Este validador incluye una opción para considerar también al espacio
+            en blanco como caracter válido. </para>
     </sect2>
     </sect2>
 
 
     <xi:include href="Zend_Validate-Barcode.xml"/>
     <xi:include href="Zend_Validate-Barcode.xml"/>
 
 
     <sect2 id="zend.validate.set.between">
     <sect2 id="zend.validate.set.between">
         <title>Between</title>
         <title>Between</title>
-        <para>
-            Devuelve
-            <constant>TRUE</constant>
-            si y sólo si
-            <varname>$valor</varname>
-            está entre
-            los valores límites mínimo y máximo. La comparación es inclusiva por defecto
-            (
-            <varname>$valor</varname>
-            puede ser igual a una valor límite), aunque esto
-            puede ser anulado a fin de hacer una
-            comparación estricta, donde
-            <varname>$valor</varname>
-            debe ser estrictamente mayor al mínimo y
-            estrictamente menor al máximo.
-        </para>
+        <para> Devuelve <constant>TRUE</constant> si y sólo si
+                <varname>$valor</varname> está entre los valores límites mínimo
+            y máximo. La comparación es inclusiva por defecto (
+                <varname>$valor</varname> puede ser igual a una valor límite),
+            aunque esto puede ser anulado a fin de hacer una comparación
+            estricta, donde <varname>$valor</varname> debe ser estrictamente
+            mayor al mínimo y estrictamente menor al máximo. </para>
     </sect2>
     </sect2>
 
 
     <xi:include href="Zend_Validate-Callback.xml"/>
     <xi:include href="Zend_Validate-Callback.xml"/>
@@ -69,50 +51,30 @@
 
 
     <sect2 id="zend.validate.set.ccnum">
     <sect2 id="zend.validate.set.ccnum">
         <title>Ccnum</title>
         <title>Ccnum</title>
-        <para>
-            Devuelve
-            <constant>TRUE</constant>
-            si y sólo si
-            <varname>$valor</varname>
-            sigue el
-            algoritmo Luhn (mod-10 checksum) para tarjetas de crédito.
-        </para>
+        <para> Devuelve <constant>TRUE</constant> si y sólo si
+                <varname>$valor</varname> sigue el algoritmo Luhn (mod-10
+            checksum) para tarjetas de crédito. </para>
 
 
         <note>
         <note>
-            <para>
-                The
-                <classname>Ccnum</classname>
-                validator has been deprecated in favor of the
-                <classname>CreditCard</classname>
-                validator. For security reasons you should use
-                CreditCard instead of Ccnum.
-            </para>
+            <para> The <classname>Ccnum</classname> validator has been
+                deprecated in favor of the <classname>CreditCard</classname>
+                validator. For security reasons you should use CreditCard
+                instead of Ccnum. </para>
         </note>
         </note>
     </sect2>
     </sect2>
 
 
     <sect2 id="zend.validate.set.date">
     <sect2 id="zend.validate.set.date">
         <title>Date</title>
         <title>Date</title>
-        <para>
-            Devuelve
-            <constant>TRUE</constant>
-            si y sólo si
-            <varname>$valor</varname>
-            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. Además, si
-            se establece la opción
-            <methodname>format</methodname>
-            ese formato se utiliza para la validación. Para más
-            detalles acerca de los parámetros
-            opcionales ver en:
-            <link linkend="zend.date.others.comparison.table">Zend_Date::isDate()</link>
-            .
-        </para>
+        <para> Devuelve <constant>TRUE</constant> si y sólo si
+                <varname>$valor</varname> 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. Además, si se
+            establece la opción <methodname>format</methodname> ese formato se
+            utiliza para la validación. Para más detalles acerca de los
+            parámetros opcionales ver en: <link
+                linkend="zend.date.others.comparison.table"
+                >Zend_Date::isDate()</link> . </para>
     </sect2>
     </sect2>
 
 
     <xi:include href="Zend_Validate-Db.xml">
     <xi:include href="Zend_Validate-Db.xml">
@@ -120,71 +82,49 @@
     </xi:include>
     </xi:include>
     <sect2 id="zend.validate.set.digits">
     <sect2 id="zend.validate.set.digits">
         <title>Digits</title>
         <title>Digits</title>
-        <para>
-            Devuelve
-            <constant>TRUE</constant>
-            si y sólo si
-            <varname>$valor</varname>
-            contiene solamente dígitos.
-        </para>
+        <para> Devuelve <constant>TRUE</constant> si y sólo si
+                <varname>$valor</varname> contiene solamente dígitos. </para>
     </sect2>
     </sect2>
 
 
     <xi:include href="Zend_Validate-EmailAddress.xml">
     <xi:include href="Zend_Validate-EmailAddress.xml">
-        <xi:fallback href="../../en/module_specs/Zend_Validate-EmailAddress.xml"/>
+        <xi:fallback href="../../en/module_specs/Zend_Validate-EmailAddress.xml"
+        />
     </xi:include>
     </xi:include>
     <sect2 id="zend.validate.set.float">
     <sect2 id="zend.validate.set.float">
         <title>Float</title>
         <title>Float</title>
-        <para>
-            Devuelve
-            <constant>TRUE</constant>
-            si y sólo si
-            <varname>$value</varname>
-            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>
+        <para> Devuelve <constant>TRUE</constant> si y sólo si
+                <varname>$value</varname> 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>
     </sect2>
 
 
     <sect2 id="zend.validate.set.greater_than">
     <sect2 id="zend.validate.set.greater_than">
         <title>GreaterThan</title>
         <title>GreaterThan</title>
-        <para>
-            Devuelve
-            <constant>TRUE</constant>
-            si y sólo si
-            <varname>$valor</varname>
-            es
-            mayor al límite mínimo.
-        </para>
+        <para> Devuelve <constant>TRUE</constant> si y sólo si
+                <varname>$valor</varname> es mayor al límite mínimo. </para>
     </sect2>
     </sect2>
 
 
     <sect2 id="zend.validate.set.hex">
     <sect2 id="zend.validate.set.hex">
         <title>Hex</title>
         <title>Hex</title>
-        <para>
-            Devuelve
-            <constant>TRUE</constant>
-            si y sólo si
-            <varname>$valor</varname>
-            contiene caracteres hexadecimales (0-9 y A-F).
-        </para>
+        <para> Devuelve <constant>TRUE</constant> si y sólo si
+                <varname>$valor</varname> contiene caracteres hexadecimales (0-9
+            y A-F). </para>
     </sect2>
     </sect2>
 
 
     <xi:include href="Zend_Validate-Hostname.xml"/>
     <xi:include href="Zend_Validate-Hostname.xml"/>
 
 
     <sect2 id="zend.validate.set.iban">
     <sect2 id="zend.validate.set.iban">
         <title>Iban</title>
         <title>Iban</title>
-        <para>
-            Returns
-            <constant>TRUE</constant>
-            if and only if
-            <varname>$value</varname>
-            contains a valid IBAN (International Bank Account Number). IBAN numbers are validated
-            against the country where they are used and by a checksum.
-        </para>
-
-        <para>There are two ways to validate IBAN numbers. As first way you can give a locale which
-            represents a country. Any given IBAN number will then be validated against this country.</para>
+        <para> Returns <constant>TRUE</constant> if and only if
+                <varname>$value</varname> contains a valid IBAN (International
+            Bank Account Number). IBAN numbers are validated against the country
+            where they are used and by a checksum. </para>
+
+        <para>There are two ways to validate IBAN numbers. As first way you can
+            give a locale which represents a country. Any given IBAN number will
+            then be validated against this country.</para>
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_Iban('de_AT');
 $validator = new Zend_Validate_Iban('de_AT');
 $iban = 'AT611904300234573201';
 $iban = 'AT611904300234573201';
@@ -197,9 +137,9 @@ if ($validator->isValid($iban)) {
     }
     }
 }
 }
 ]]></programlisting>
 ]]></programlisting>
-        <para>This should be done when you want to validate IBAN numbers for a single countries.
-            The
-            simpler way of validation is not to give a locale like shown in the next example.</para>
+        <para>This should be done when you want to validate IBAN numbers for a
+            single countries. The simpler way of validation is not to give a
+            locale like shown in the next example.</para>
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_Iban();
 $validator = new Zend_Validate_Iban();
 $iban = 'AT611904300234573201';
 $iban = 'AT611904300234573201';
@@ -209,27 +149,21 @@ if ($validator->isValid($iban)) {
     // IBAN is invalid
     // IBAN is invalid
 }
 }
 ]]></programlisting>
 ]]></programlisting>
-        <para>But this shows one big problem: When you have to accept only IBAN numbers from one
-            single country, for example france, then IBAN numbers from other countries would also be
-            valid. Therefor just remember: When you have to validate a IBAN number against a defined
-            country you should give the locale. And when you accept all IBAN numbers regardless of
-            any country omit the locale for simplicity.</para>
+        <para>But this shows one big problem: When you have to accept only IBAN
+            numbers from one single country, for example france, then IBAN
+            numbers from other countries would also be valid. Therefor just
+            remember: When you have to validate a IBAN number against a defined
+            country you should give the locale. And when you accept all IBAN
+            numbers regardless of any country omit the locale for
+            simplicity.</para>
     </sect2>
     </sect2>
 
 
     <sect2 id="zend.validate.set.in_array">
     <sect2 id="zend.validate.set.in_array">
         <title>InArray</title>
         <title>InArray</title>
-        <para>
-            Devuelve
-            <constant>TRUE</constant>
-            si y sólo si
-            <varname>$valor</varname>
-            se
-            encuentra en un array, y si la opción es estricta entonces también verificará el tipo
-            de
-            dato de
-            <varname>$valor</varname>
-            .
-        </para>
+        <para> Devuelve <constant>TRUE</constant> si y sólo si
+                <varname>$valor</varname> se encuentra en un array, y si la
+            opción es estricta entonces también verificará el tipo de dato de
+                <varname>$valor</varname> . </para>
     </sect2>
     </sect2>
 
 
     <xi:include href="Zend_Validate-Identical.xml"/>
     <xi:include href="Zend_Validate-Identical.xml"/>
@@ -237,49 +171,31 @@ if ($validator->isValid($iban)) {
 
 
     <sect2 id="zend.validate.set.int">
     <sect2 id="zend.validate.set.int">
         <title>Int</title>
         <title>Int</title>
-        <para>
-            Returns
-            <constant>TRUE</constant>
-            if and only if
-            <varname>$value</varname>
-            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>
+        <para> Returns <constant>TRUE</constant> if and only if
+                <varname>$value</varname> 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>
 
 
     <xi:include href="Zend_Validate-Ip.xml"/>
     <xi:include href="Zend_Validate-Ip.xml"/>
 
 
     <sect2 id="zend.validate.set.less_than">
     <sect2 id="zend.validate.set.less_than">
         <title>LessThan</title>
         <title>LessThan</title>
-        <para>
-            Devuelve
-            <constant>TRUE</constant>
-            si y sólo si
-            <varname>$valor</varname>
-            es
-            menor al límite máximo.
-        </para>
+        <para> Devuelve <constant>TRUE</constant> si y sólo si
+                <varname>$valor</varname> es menor al límite máximo. </para>
     </sect2>
     </sect2>
 
 
- <xi:include href="Zend_Validate-NotEmpty.xml" />
+    <xi:include href="Zend_Validate-NotEmpty.xml"/>
 
 
     <xi:include href="Zend_Validate-PostCode.xml"/>
     <xi:include href="Zend_Validate-PostCode.xml"/>
 
 
     <sect2 id="zend.validate.set.regex">
     <sect2 id="zend.validate.set.regex">
         <title>Regex</title>
         <title>Regex</title>
-        <para>
-            Devuelve
-            <constant>TRUE</constant>
-            si y sólo si
-            <varname>$valor</varname>
-            coincide con el patrón de una expresión regular.
-        </para>
+        <para> Devuelve <constant>TRUE</constant> si y sólo si
+                <varname>$valor</varname> coincide con el patrón de una
+            expresión regular. </para>
     </sect2>
     </sect2>
 
 
     <xi:include href="Zend_Validate-Sitemap.xml">
     <xi:include href="Zend_Validate-Sitemap.xml">
@@ -290,33 +206,21 @@ if ($validator->isValid($iban)) {
 
 
     <sect2 id="zend.validate.set.string_length">
     <sect2 id="zend.validate.set.string_length">
         <title>StringLength</title>
         <title>StringLength</title>
-        <para>
-            Devuelve
-            <constant>TRUE</constant>
-            si y sólo si la longitud del string
-            <varname>$valor</varname>
-            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 excepción si la longitud mínima tiene
-            un valor mayor que la longitud máxima
-            establecida, y el método
-            <methodname>setMax()</methodname>
-            lanza una excepción si la longitud máxima se fija
-            a un valor inferior que la longitud
-            mínima establecida. Desde la versión 1.0.2, esta
-            clase soporta UTF-8 y a otras
-            codificaciones, basado en el valor actual de:
-            <ulink url="http://www.php.net/manual/en/ref.iconv.php#iconv.configuration">
-                iconv.internal_encoding
-            </ulink>
-            .
-            If you need a different encoding you can set it with the accessor methods getEncoding
-            and setEncoding.
-        </para>
+        <para> Devuelve <constant>TRUE</constant> si y sólo si la longitud del
+            string <varname>$valor</varname> 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 excepción si la
+            longitud mínima tiene un valor mayor que la longitud máxima
+            establecida, y el método <methodname>setMax()</methodname> lanza una
+            excepción si la longitud máxima se fija a un valor inferior que la
+            longitud mínima establecida. Desde la versión 1.0.2, esta clase
+            soporta UTF-8 y a otras codificaciones, basado en el valor actual
+            de: <ulink
+                url="http://www.php.net/manual/en/ref.iconv.php#iconv.configuration"
+                > iconv.internal_encoding </ulink> . If you need a different
+            encoding you can set it with the accessor methods getEncoding and
+            setEncoding. </para>
     </sect2>
     </sect2>
 
 
 </sect1>
 </sect1>

+ 4 - 5
documentation/manual/es/module_specs/Zend_Validate.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 19577 -->
+<!-- EN-Revision: 20115 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <sect1 id="zend.validate.introduction">
 <sect1 id="zend.validate.introduction">
 
 
@@ -174,8 +174,7 @@ if (!validator->isValid('word')) {
 
 
     <sect2 id="zend.validate.introduction.static">
     <sect2 id="zend.validate.introduction.static">
 
 
-        <title> Utilizando el método estático is()
-        </title>
+        <title> Utilizando el método estático is() </title>
 
 
         <para> Si es inconveniente cargar una clase de validación y crear una
         <para> Si es inconveniente cargar una clase de validación y crear una
             instancia del validador, puede usar el método estático
             instancia del validador, puede usar el método estático
@@ -285,8 +284,8 @@ if (Zend_Validate::is($value, 'OtherValidator', array('min' => 1, 'max' => 12))
                     <para>
                     <para>
                         <emphasis>
                         <emphasis>
                             <methodname>Zend_Validate::hasDefaultNamespaces()</methodname>
                             <methodname>Zend_Validate::hasDefaultNamespaces()</methodname>
-                        </emphasis> : Returns true when one or more default
-                        namespaces are set, and false when no default namespaces
+                        </emphasis> : Returns <constant>TRUE</constant>  when one or more default
+                        namespaces are set, and <constant>FALSE</constant> when no default namespaces
                         are set. </para>
                         are set. </para>
                 </listitem>
                 </listitem>
             </itemizedlist>
             </itemizedlist>

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

@@ -16,7 +16,7 @@
         El método estático <methodname>Zend_Version::compareVersion($version)</methodname>
         El método estático <methodname>Zend_Version::compareVersion($version)</methodname>
         esta basada en la función <ulink
         esta basada en la función <ulink
             url="http://php.net/version_compare"><methodname>version_compare()</methodname></ulink>
             url="http://php.net/version_compare"><methodname>version_compare()</methodname></ulink>
-			de <acronym>PHP</acronym>.
+            de <acronym>PHP</acronym>.
         Este método devuelve -1 si la versíón especificada es mayor    
         Este método devuelve -1 si la versíón especificada es mayor    
         que la versión instalada de Zend Framework, 0 si son iguales 
         que la versión instalada de Zend Framework, 0 si son iguales 
         y +1 si la versión especificada es más reciente que la
         y +1 si la versión especificada es más reciente que la

+ 3 - 4
documentation/manual/es/ref/coding_standard.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
-    <!-- EN-Revision: 18940 -->
+<!-- EN-Revision: 20096 -->
     <!-- Reviewed: no -->
     <!-- Reviewed: no -->
 <appendix id="coding-standard">
 <appendix id="coding-standard">
     <title>Estándares de codificación de Zend Framework para PHP</title>
     <title>Estándares de codificación de Zend Framework para PHP</title>
@@ -410,9 +410,8 @@ $greeting = "Hello $name, welcome back!";
 $greeting = "Hello {$name}, welcome back!";
 $greeting = "Hello {$name}, welcome back!";
 ]]></programlisting>
 ]]></programlisting>
 
 
-                <para> Por consistencia, esta forma no está permitida:
-                </para>
-                    <programlisting language="php"><![CDATA[
+                <para> Por consistencia, esta forma no está permitida: </para>
+                <programlisting language="php"><![CDATA[
 $greeting = "Hello ${name}, welcome back!";
 $greeting = "Hello ${name}, welcome back!";
 ]]></programlisting>
 ]]></programlisting>
 
 

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