[DOCUMENTATION] English:

- some manual fixes

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

documentation/manual/en/module_specs/Zend_File_Transfer-Validators.xml

@@ -166,9 +166,9 @@
         <itemizedlist>
             <listitem>
                 <para>
-                    <methodname>isValid($files = null)</methodname>: Checks the specified files using all
-                    validators. <varname>$files</varname> may be either a real filename, the element's
-                    name or the name of the temporary file.
+                    <methodname>isValid($files = null)</methodname>: Checks the specified files
+                    using all validators. <varname>$files</varname> may be either a real filename,
+                    the element's name or the name of the temporary file.
                 </para>
             </listitem>
 
@@ -265,8 +265,8 @@ $upload->setValidators(array(
             <title>Limit Validators to Single Files</title>
 
             <para>
-                <methodname>addValidator()</methodname>, <methodname>addValidators()</methodname>, and
-                <methodname>setValidators()</methodname> each accept a final
+                <methodname>addValidator()</methodname>, <methodname>addValidators()</methodname>,
+                and <methodname>setValidators()</methodname> each accept a final
                 <varname>$files</varname> argument. This argument can be used to
                 specify a particular file or array of files on which to set the
                 given validator.
@@ -281,18 +281,18 @@ $upload->addValidator('Size', false, 20000, 'file2');
         </example>
 
         <para>
-            Normally, you should use the <methodname>addValidators()</methodname> method, which can be called
-            multiple times.
+            Normally, you should use the <methodname>addValidators()</methodname> method, which
+            can be called multiple times.
         </para>
 
         <example id="zend.file.transfer.validators.usage.examplemultiple">
             <title>Add Multiple Validators</title>
 
             <para>
-                Often it's simpler just to call <methodname>addValidator()</methodname> multiple times with one
-                call for each validator. This also increases readability and makes your code more
-                maintainable. All methods provide a fluent interface, so you can couple the calls as
-                shown below:
+                Often it's simpler just to call <methodname>addValidator()</methodname> multiple
+                times with one call for each validator. This also increases readability and makes
+                your code more maintainable. All methods provide a fluent interface, so you can
+                couple the calls as shown below:
             </para>
 
             <programlisting language="php"><![CDATA[
@@ -315,16 +315,17 @@ $upload->addValidator('Size', false, 20000)
         </note>
 
         <para>
-            Last but not least, you can simply check the files using <methodname>isValid()</methodname>.
+            Last but not least, you can simply check the files using
+            <methodname>isValid()</methodname>.
         </para>
 
         <example id="zend.file.transfer.validators.usage.exampleisvalid">
             <title>Validate the Files</title>
 
             <para>
-                <methodname>isValid()</methodname> accepts the file name of the uploaded or downloaded file, the
-                temporary file name and or the name of the form element. If no parameter or null is
-                given all files will be validated
+                <methodname>isValid()</methodname> accepts the file name of the uploaded or
+                downloaded file, the temporary file name and or the name of the form element. If
+                no parameter or null is given all files will be validated
             </para>
 
             <programlisting language="php"><![CDATA[
@@ -344,8 +345,8 @@ if ($upload->isValid()) {
 
         <note>
             <para>
-                Note that <methodname>isValid()</methodname> will be called automatically when you receive the
-                files and have not called it previously.
+                Note that <methodname>isValid()</methodname> will be called automatically when you
+                receive the files and have not called it previously.
             </para>
         </note>
 
@@ -353,8 +354,9 @@ if ($upload->isValid()) {
             When validation has failed it is a good idea to get information about the
             problems found. To get this information, you can use the methods
             <methodname>getMessages()</methodname> which returns all validation messages as array,
-            <methodname>getErrors()</methodname> which returns all error codes, and <methodname>hasErrors()</methodname>
-            which returns true as soon as a validation error has been found.
+            <methodname>getErrors()</methodname> which returns all error codes, and
+            <methodname>hasErrors()</methodname> which returns true as soon as a validation error
+            has been found.
         </para>
 
     </sect2>
@@ -402,8 +404,9 @@ if ($upload->isValid()) {
         <para>
             If you initiate this validator with a string or integer, the value will be used as
             <code>max</code>. Or you can also use the methods <methodname>setMin()</methodname> and
-            <methodname>setMax()</methodname> to set both options afterwards and <methodname>getMin()</methodname> and
-            <methodname>getMax()</methodname> to retrieve the actual set values.
+            <methodname>setMax()</methodname> to set both options afterwards and
+            <methodname>getMin()</methodname> and <methodname>getMax()</methodname> to retrieve
+            the actual set values.
         </para>
 
         <example id="zend.file.transfer.validators.count.example">
@@ -492,16 +495,17 @@ $upload->addValidator('Crc32', false, array('3b3652f', 'e612b69'));
         </itemizedlist>
 
         <para>
-            This validator accepts multiple extensions, either as a comma-delimited string, or as an
-            array. You may also use the methods <methodname>setExtension()</methodname>,
-            <methodname>addExtension()</methodname>, and <methodname>getExtension()</methodname> to set and retrieve
-            extensions.
+            This validator accepts multiple extensions, either as a comma-delimited string, or as
+            an array. You may also use the methods <methodname>setExtension()</methodname>,
+            <methodname>addExtension()</methodname>, and <methodname>getExtension()</methodname>
+            to set and retrieve extensions.
         </para>
 
         <para>
             In some cases it is useful to match in a case-sensitive fashion. So the constructor
-            allows a second parameter called <varname>$case</varname> which, if set to true, validates the
-            extension by comparing it with the specified values in a case-sensitive fashion.
+            allows a second parameter called <varname>$case</varname> which, if set to true,
+            validates the extension by comparing it with the specified values in a case-sensitive
+            fashion.
         </para>
 
         <example id="zend.file.transfer.validators.excludeextension.example">
@@ -557,10 +561,10 @@ $upload->addValidator('ExcludeExtension',
         </itemizedlist>
 
         <para>
-            This validator accepts multiple MIME types, either as a comma-delimited string, or as an
-            array. You may also use the methods <methodname>setMimeType()</methodname>,
-            <methodname>addMimeType()</methodname>, and <methodname>getMimeType()</methodname> to set and retrieve the MIME
-            types.
+            This validator accepts multiple MIME types, either as a comma-delimited string, or as
+            an array. You may also use the methods <methodname>setMimeType()</methodname>,
+            <methodname>addMimeType()</methodname>, and <methodname>getMimeType()</methodname> to
+            set and retrieve the MIME types.
         </para>
 
         <example id="zend.file.transfer.validators.excludemimetype.example">
@@ -618,8 +622,8 @@ $upload->addValidator('ExcludeMimeType', false, 'image');
         <para>
             This validator accepts multiple directories, either as a comma-delimited string, or as
             an array. You may also use the methods <methodname>setDirectory()</methodname>,
-            <methodname>addDirectory()</methodname>, and <methodname>getDirectory()</methodname> to set and retrieve
-            directories.
+            <methodname>addDirectory()</methodname>, and <methodname>getDirectory()</methodname>
+            to set and retrieve directories.
         </para>
 
         <example id="zend.file.transfer.validators.exists.example">
@@ -675,14 +679,14 @@ $upload->addValidator('Exists',
         <para>
             This validator accepts multiple extensions, either as a comma-delimited string, or as an
             array. You may also use the methods <methodname>setExtension()</methodname>,
-            <methodname>addExtension()</methodname>, and <methodname>getExtension()</methodname> to set and retrieve
-            extension values.
+            <methodname>addExtension()</methodname>, and <methodname>getExtension()</methodname> to
+            set and retrieve extension values.
         </para>
 
         <para>
             In some cases it is useful to test in a case-sensitive fashion. Therefore the
-            constructor takes a second parameter <varname>$case</varname>, which, if set to true, will
-            validate the extension in a case-sensitive fashion.
+            constructor takes a second parameter <varname>$case</varname>, which, if set to true,
+            will validate the extension in a case-sensitive fashion.
         </para>
 
         <example id="zend.file.transfer.validators.extension.example">
@@ -755,10 +759,10 @@ if (!$upload->isValid('C:\temp\myfile.MO')) {
 
         <para>
             You can initialize this validator with a string, which will then be used to set the
-            <code>max</code> option. You can also use the methods <methodname>setMin()</methodname> and
-            <methodname>setMax()</methodname> to set both options after construction, along with
-            <methodname>getMin()</methodname> and <methodname>getMax()</methodname> to retrieve the values that have been
-            set previously.
+            <code>max</code> option. You can also use the methods <methodname>setMin()</methodname>
+            and <methodname>setMax()</methodname> to set both options after construction, along with
+            <methodname>getMin()</methodname> and <methodname>getMax()</methodname> to retrieve the
+            values that have been set previously.
         </para>
 
         <para>

documentation/manual/en/module_specs/Zend_Filter-Callback.xml

@@ -37,8 +37,8 @@ print $filter->filter('Hello!');
 ]]></programlisting>
 
     <para>
-        To get the actual set callback use <methodname>getCallback()</methodname> and to set another callback
-        use <methodname>setCallback()</methodname>.
+        To get the actual set callback use <methodname>getCallback()</methodname> and to set
+        another callback use <methodname>setCallback()</methodname>.
     </para>
 
     <para>

documentation/manual/en/module_specs/Zend_Filter-Decryption.xml

@@ -24,8 +24,8 @@
         <para>
             There is one emminent difference for you. When you did not provide a vector at
             encryption you need to get it after you encrypted the content by using the
-            <methodname>getVector()</methodname> method on the encryption filter. Without the correct vector you
-            will not be able to decrypt the content.
+            <methodname>getVector()</methodname> method on the encryption filter. Without the
+            correct vector you will not be able to decrypt the content.
         </para>
 
         <para>

documentation/manual/en/module_specs/Zend_Filter-Encryption.xml

@@ -107,7 +107,8 @@ $filter->setAdapter('openssl');
 
         <para>
             You can get/set the encryption values also afterwards with the
-            <methodname>getEncryption()</methodname> and <methodname>setEncryption()</methodname> methods.
+            <methodname>getEncryption()</methodname> and <methodname>setEncryption()</methodname>
+            methods.
         </para>
 
         <note>
@@ -126,9 +127,9 @@ $filter->setAdapter('openssl');
         </note>
 
         <para>
-            You can get/set the encryption vector by calling <methodname>getVector()</methodname> and
-            <methodname>setVector()</methodname>. A given string will be truncated or padded to the needed
-            vector size of the used algorithm.
+            You can get/set the encryption vector by calling <methodname>getVector()</methodname>
+            and <methodname>setVector()</methodname>. A given string will be truncated or padded to
+            the needed vector size of the used algorithm.
         </para>
 
         <note>
@@ -181,9 +182,11 @@ print $encrypted;
         </itemizedlist>
 
         <para>
-            You can get/set the public keys also afterwards with the <methodname>getPublicKey()</methodname>
-            and <methodname>setPublicKey()</methodname> methods. The private key can also be get and set with
-            the related <methodname>getPrivateKey()</methodname> and <methodname>setPrivateKey()</methodname> methods.
+            You can get/set the public keys also afterwards with the
+            <methodname>getPublicKey()</methodname> and <methodname>setPublicKey()</methodname>
+            methods. The private key can also be get and set with the related
+            <methodname>getPrivateKey()</methodname> and <methodname>setPrivateKey()</methodname>
+            methods.
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -209,9 +212,9 @@ $filter->setPublicKey(array(
 
         <para>
             When you want to encode also the keys, then you have to provide a passphrase with the
-            <methodname>setPassphrase()</methodname> method. When you want to decode content which was encoded
-            with a passphrase you will not only need the public key, but also the passphrase to
-            decode the encrypted key.
+            <methodname>setPassphrase()</methodname> method. When you want to decode content which
+            was encoded with a passphrase you will not only need the public key, but also the
+            passphrase to decode the encrypted key.
         </para>
 
         <programlisting language="php"><![CDATA[

documentation/manual/en/module_specs/Zend_Filter-Inflector.xml

@@ -341,8 +341,8 @@ $inflector->setFilterRule('script', array(
             <para>
                 Typically, it's easier to set many rules at once than to
                 configure a single variable and its inflection rules at a time.
-                <classname>Zend_Filter_Inflector</classname>'s <methodname>addRules()</methodname> and
-                <methodname>setRules()</methodname> method allow this.
+                <classname>Zend_Filter_Inflector</classname>'s <methodname>addRules()</methodname>
+                and <methodname>setRules()</methodname> method allow this.
             </para>
 
             <para>

documentation/manual/en/module_specs/Zend_Filter-Set.xml

@@ -28,8 +28,8 @@
     <sect2 id="zend.filter.set.alpha">
         <title>Alpha</title>
         <para>
-            Returns the string <varname>$value</varname>, removing all but alphabetic characters. This
-            filter includes an option to also allow white space characters.
+            Returns the string <varname>$value</varname>, removing all but alphabetic characters.
+            This filter includes an option to also allow white space characters.
         </para>
     </sect2>
 
@@ -63,8 +63,8 @@
     <sect2 id="zend.filter.set.htmlentities">
         <title>HtmlEntities</title>
         <para>
-            Returns the string <varname>$value</varname>, converting characters to their corresponding
-            HTML entity equivalents where they exist.
+            Returns the string <varname>$value</varname>, converting characters to their
+            corresponding <acronym>HTML</acronym> entity equivalents where they exist.
         </para>
     </sect2>
 
@@ -90,24 +90,24 @@
     <sect2 id="zend.filter.set.stringtolower">
         <title>StringToLower</title>
         <para>
-            Returns the string <varname>$value</varname>, converting alphabetic characters to lowercase as
-            necessary.
+            Returns the string <varname>$value</varname>, converting alphabetic characters to
+            lowercase as necessary.
         </para>
     </sect2>
 
     <sect2 id="zend.filter.set.stringtoupper">
         <title>StringToUpper</title>
         <para>
-            Returns the string <varname>$value</varname>, converting alphabetic characters to uppercase as
-            necessary.
+            Returns the string <varname>$value</varname>, converting alphabetic characters to
+            uppercase as necessary.
         </para>
     </sect2>
 
     <sect2 id="zend.filter.set.stringtrim">
         <title>StringTrim</title>
         <para>
-            Returns the string <varname>$value</varname> with characters stripped from the beginning and
-            end.
+            Returns the string <varname>$value</varname> with characters stripped from the
+            beginning and end.
         </para>
     </sect2>
 

documentation/manual/en/module_specs/Zend_Filter-WritingFilters.xml

@@ -11,9 +11,10 @@
     </para>
 
     <para>
-        <classname>Zend_Filter_Interface</classname> defines a single method, <methodname>filter()</methodname>,
-        that may be implemented by user classes. An object that implements this interface may be
-        added to a filter chain with <classname>Zend_Filter::addFilter()</classname>.
+        <classname>Zend_Filter_Interface</classname> defines a single method,
+        <methodname>filter()</methodname>, that may be implemented by user classes. An object that
+        implements this interface may be added to a filter chain with
+        <methodname>Zend_Filter::addFilter()</methodname>.
     </para>
 
     <para>

documentation/manual/en/module_specs/Zend_Filter_Input.xml

@@ -124,10 +124,9 @@ $validators = array(
 ]]></programlisting>
 
         <para>
-            Each key in the <varname>$filters</varname> array above is the name of a rule for applying a
-            filter to a specific data field. By default, the name of the rule
-            is also the name of the input data field to which to apply the
-            rule.
+            Each key in the <varname>$filters</varname> array above is the name of a rule for
+            applying a filter to a specific data field. By default, the name of the rule
+            is also the name of the input data field to which to apply the rule.
         </para>
 
         <para>
@@ -990,9 +989,9 @@ $input = new Zend_Filter_Input($filters, $validators, $data, $options);
 ]]></programlisting>
 
         <para>
-            Alternatively, you can use the <methodname>addValidatorPrefixPath($prefix, $path)</methodname>
-            or <methodname>addFilterPrefixPath($prefix, $path)</methodname> methods, which directly
-            proxy to the plugin loader that is used by Zend_Filter_Input:
+            Alternatively, you can use the <methodname>addValidatorPrefixPath($prefix,
+                $path)</methodname> or <methodname>addFilterPrefixPath($prefix, $path)</methodname>
+            methods, which directly proxy to the plugin loader that is used by Zend_Filter_Input:
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -1018,21 +1017,22 @@ $input->addFilterPrefixPath('Foo_Namespace', 'Foo/Namespace');
 
         <note>
             <para>
-                As of version 1.5 the function <methodname>addNamespace($namespace)</methodname> was deprecated
-                and exchanged with the plugin loader and the <code>addFilterPrefixPath</code> and
-                <code>addValidatorPrefixPath</code> were added. Also the constant
-                <classname>Zend_Filter_Input::INPUT_NAMESPACE</classname> is now deprecated. The
-                constants <classname>Zend_Filter_Input::VALIDATOR_NAMESPACE</classname> and
-                <classname>Zend_Filter_Input::FILTER_NAMESPACE</classname> are available in releases
+                As of version 1.5 the function <methodname>addNamespace($namespace)</methodname>
+                was deprecated and exchanged with the plugin loader and the
+                <code>addFilterPrefixPath</code> and <code>addValidatorPrefixPath</code> were
+                added. Also the constant <classname>Zend_Filter_Input::INPUT_NAMESPACE</classname>
+                is now deprecated. The constants
+                <constant>Zend_Filter_Input::VALIDATOR_NAMESPACE</constant> and
+                <constant>Zend_Filter_Input::FILTER_NAMESPACE</constant> are available in releases
                 after 1.7.0.
             </para>
         </note>
 
         <note>
             <para>
-                As of version 1.0.4, <classname>Zend_Filter_Input::NAMESPACE</classname>, having
+                As of version 1.0.4, <constant>Zend_Filter_Input::NAMESPACE</constant>, having
                 value <code>namespace</code>, was changed to
-                <classname>Zend_Filter_Input::INPUT_NAMESPACE</classname>, having value
+                <constant>Zend_Filter_Input::INPUT_NAMESPACE</constant>, having value
                 <code>inputNamespace</code>, in order to comply with the PHP 5.3 reservation of the
                 keyword <code>namespace</code>.
             </para>

documentation/manual/en/module_specs/Zend_Form-Elements.xml

@@ -684,7 +684,8 @@ $messages = $element->getMessages();
             </para></listitem>
 
             <listitem><para>
-                <methodname>setValidators(array $validators)</methodname> (overwrites all validators)
+                <methodname>setValidators(array $validators)</methodname> (overwrites all
+                validators)
             </para></listitem>
 
             <listitem><para>
@@ -978,7 +979,8 @@ $fooBar  = $element->getDecorator('FooBar');
             </para></listitem>
 
             <listitem><para>
-                <methodname>setDecorators(array $decorators)</methodname> (overwrites all decorators)
+                <methodname>setDecorators(array $decorators)</methodname> (overwrites all
+                decorators)
             </para></listitem>
 
             <listitem><para>
@@ -1037,7 +1039,8 @@ echo $element->renderHtmlTag("This is the html tag content");
 
             <listitem><para>
                 <emphasis>label</emphasis>: the element label. Uses the
-                <methodname>setLabel()</methodname> and <methodname>getLabel()</methodname> accessors.
+                <methodname>setLabel()</methodname> and <methodname>getLabel()</methodname>
+                accessors.
             </para></listitem>
 
             <listitem><para>
@@ -1048,22 +1051,23 @@ echo $element->renderHtmlTag("This is the html tag content");
 
             <listitem><para>
                 <emphasis>value</emphasis>: the current element value. Uses the
-                <methodname>setValue()</methodname> and <methodname>getValue()</methodname> accessors.
+                <methodname>setValue()</methodname> and <methodname>getValue()</methodname>
+                accessors.
             </para></listitem>
 
             <listitem><para>
                 <emphasis>description</emphasis>: a description of the element;
                 often used to provide tooltip or javascript contextual hinting
                 describing the purpose of the element. Uses the
-                <methodname>setDescription()</methodname> and <methodname>getDescription()</methodname>
-                accessors.
+                <methodname>setDescription()</methodname> and
+                <methodname>getDescription()</methodname> accessors.
             </para></listitem>
 
             <listitem><para>
                 <emphasis>required</emphasis>: flag indicating whether or not
                 the element is required when performing form validation. Uses
-                the <methodname>setRequired()</methodname> and <methodname>getRequired()</methodname>
-                accessors. This flag is false by default.
+                the <methodname>setRequired()</methodname> and
+                <methodname>getRequired()</methodname> accessors. This flag is false by default.
             </para></listitem>
 
             <listitem><para>
@@ -1071,8 +1075,8 @@ echo $element->renderHtmlTag("This is the html tag content");
                 a non-required (optional) element should attempt to validate
                 empty values. If it is set to true and the required flag is false, empty
                 values are not passed to the validator chain and are presumed true.
-                Uses the <methodname>setAllowEmpty()</methodname> and <methodname>getAllowEmpty()</methodname>
-                accessors. This flag is true by default.
+                Uses the <methodname>setAllowEmpty()</methodname> and
+                <methodname>getAllowEmpty()</methodname> accessors. This flag is true by default.
             </para></listitem>
 
             <listitem><para>
@@ -1151,8 +1155,12 @@ $element->class = 'text;
         <itemizedlist>
             <listitem><para>Configuration:</para>
                 <itemizedlist>
-                    <listitem><para><methodname>setOptions(array $options)</methodname></para></listitem>
-                    <listitem><para><methodname>setConfig(Zend_Config $config)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setOptions(array $options)</methodname></para>
+                    </listitem>
+                    <listitem>
+                        <para><methodname>setConfig(Zend_Config $config)</methodname></para>
+                    </listitem>
                 </itemizedlist>
             </listitem>
 
@@ -1160,12 +1168,17 @@ $element->class = 'text;
                 <itemizedlist>
                     <listitem>
                         <para>
-                            <methodname>setTranslator(Zend_Translate_Adapter $translator = null)</methodname>
+                            <methodname>setTranslator(Zend_Translate_Adapter $translator
+                                = null)</methodname>
                         </para>
                     </listitem>
                     <listitem><para><methodname>getTranslator()</methodname></para></listitem>
-                    <listitem><para><methodname>setDisableTranslator($flag)</methodname></para></listitem>
-                    <listitem><para><methodname>translatorIsDisabled()</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setDisableTranslator($flag)</methodname></para>
+                    </listitem>
+                    <listitem>
+                        <para><methodname>translatorIsDisabled()</methodname></para>
+                    </listitem>
                 </itemizedlist>
             </listitem>
 
@@ -1178,7 +1191,9 @@ $element->class = 'text;
                     <listitem><para><methodname>getUnfilteredValue()</methodname></para></listitem>
                     <listitem><para><methodname>setLabel($label)</methodname></para></listitem>
                     <listitem><para><methodname>getLabel()</methodname></para></listitem>
-                    <listitem><para><methodname>setDescription($description)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setDescription($description)</methodname></para>
+                    </listitem>
                     <listitem><para><methodname>getDescription()</methodname></para></listitem>
                     <listitem><para><methodname>setOrder($order)</methodname></para></listitem>
                     <listitem><para><methodname>getOrder()</methodname></para></listitem>
@@ -1189,12 +1204,18 @@ $element->class = 'text;
                     <listitem>
                         <para><methodname>setAutoInsertNotEmptyValidator($flag)</methodname></para>
                     </listitem>
-                    <listitem><para><methodname>autoInsertNotEmptyValidator()</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>autoInsertNotEmptyValidator()</methodname></para>
+                    </listitem>
                     <listitem><para><methodname>setIgnore($flag)</methodname></para></listitem>
                     <listitem><para><methodname>getIgnore()</methodname></para></listitem>
                     <listitem><para><methodname>getType()</methodname></para></listitem>
-                    <listitem><para><methodname>setAttrib($name, $value)</methodname></para></listitem>
-                    <listitem><para><methodname>setAttribs(array $attribs)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setAttrib($name, $value)</methodname></para>
+                    </listitem>
+                    <listitem>
+                        <para><methodname>setAttribs(array $attribs)</methodname></para>
+                    </listitem>
                     <listitem><para><methodname>getAttrib($name)</methodname></para></listitem>
                     <listitem><para><methodname>getAttribs()</methodname></para></listitem>
                 </itemizedlist>
@@ -1208,11 +1229,17 @@ $element->class = 'text;
                                 $type)</code>
                         </para>
                     </listitem>
-                    <listitem><para><methodname>getPluginLoader($type)</methodname></para></listitem>
                     <listitem>
-                        <para><methodname>addPrefixPath($prefix, $path, $type = null)</methodname></para>
+                        <para><methodname>getPluginLoader($type)</methodname></para>
+                    </listitem>
+                    <listitem>
+                        <para>
+                            <methodname>addPrefixPath($prefix, $path, $type = null)</methodname>
+                        </para>
+                    </listitem>
+                    <listitem>
+                        <para><methodname>addPrefixPaths(array $spec)</methodname></para>
                     </listitem>
-                    <listitem><para><methodname>addPrefixPaths(array $spec)</methodname></para></listitem>
                 </itemizedlist>
             </listitem>
 
@@ -1224,13 +1251,21 @@ $element->class = 'text;
                                 array())</code>
                         </para>
                     </listitem>
-                    <listitem><para><methodname>addValidators(array $validators)</methodname></para></listitem>
-                    <listitem><para><methodname>setValidators(array $validators)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>addValidators(array $validators)</methodname></para>
+                    </listitem>
+                    <listitem>
+                        <para><methodname>setValidators(array $validators)</methodname></para>
+                    </listitem>
                     <listitem><para><methodname>getValidator($name)</methodname></para></listitem>
                     <listitem><para><methodname>getValidators()</methodname></para></listitem>
-                    <listitem><para><methodname>removeValidator($name)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>removeValidator($name)</methodname></para>
+                    </listitem>
                     <listitem><para><methodname>clearValidators()</methodname></para></listitem>
-                    <listitem><para><methodname>isValid($value, $context = null)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>isValid($value, $context = null)</methodname></para>
+                    </listitem>
                     <listitem><para><methodname>getErrors()</methodname></para></listitem>
                     <listitem><para><methodname>getMessages()</methodname></para></listitem>
                 </itemizedlist>
@@ -1241,8 +1276,12 @@ $element->class = 'text;
                     <listitem>
                         <para><methodname>addFilter($filter, $options = array())</methodname></para>
                     </listitem>
-                    <listitem><para><methodname>addFilters(array $filters)</methodname></para></listitem>
-                    <listitem><para><methodname>setFilters(array $filters)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>addFilters(array $filters)</methodname></para>
+                    </listitem>
+                    <listitem>
+                        <para><methodname>setFilters(array $filters)</methodname></para>
+                    </listitem>
                     <listitem><para><methodname>getFilter($name)</methodname></para></listitem>
                     <listitem><para><methodname>getFilters()</methodname></para></listitem>
                     <listitem><para><methodname>removeFilter($name)</methodname></para></listitem>
@@ -1253,20 +1292,32 @@ $element->class = 'text;
             <listitem><para>Rendering:</para>
                 <itemizedlist>
                     <listitem>
-                        <para><methodname>setView(Zend_View_Interface $view = null)</methodname></para>
+                        <para>
+                            <methodname>setView(Zend_View_Interface $view = null)</methodname>
+                        </para>
                     </listitem>
                     <listitem><para><methodname>getView()</methodname></para></listitem>
                     <listitem>
-                        <para><methodname>addDecorator($decorator, $options = null)</methodname></para>
+                        <para>
+                            <methodname>addDecorator($decorator, $options = null)</methodname>
+                        </para>
+                    </listitem>
+                    <listitem>
+                        <para><methodname>addDecorators(array $decorators)</methodname></para>
+                    </listitem>
+                    <listitem>
+                        <para><methodname>setDecorators(array $decorators)</methodname></para>
                     </listitem>
-                    <listitem><para><methodname>addDecorators(array $decorators)</methodname></para></listitem>
-                    <listitem><para><methodname>setDecorators(array $decorators)</methodname></para></listitem>
                     <listitem><para><methodname>getDecorator($name)</methodname></para></listitem>
                     <listitem><para><methodname>getDecorators()</methodname></para></listitem>
-                    <listitem><para><methodname>removeDecorator($name)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>removeDecorator($name)</methodname></para>
+                    </listitem>
                     <listitem><para><methodname>clearDecorators()</methodname></para></listitem>
                     <listitem>
-                        <para><methodname>render(Zend_View_Interface $view = null)</methodname></para>
+                        <para>
+                            <methodname>render(Zend_View_Interface $view = null)</methodname>
+                        </para>
                     </listitem>
                 </itemizedlist>
             </listitem>

documentation/manual/en/module_specs/Zend_Form-Forms.xml

@@ -710,7 +710,8 @@ $form->setDefaultDisplayGroupClass('My_DisplayGroup');
 
             <itemizedlist>
                 <listitem><para>
-                    <methodname>addDisplayGroup(array $elements, $name, $options = null)</methodname>
+                    <methodname>addDisplayGroup(array $elements, $name, $options
+                        = null)</methodname>
                 </para></listitem>
 
                 <listitem><para>
@@ -766,7 +767,11 @@ $form->setDefaultDisplayGroupClass('My_DisplayGroup');
             <itemizedlist>
                 <listitem><para>Configuration:</para>
                     <itemizedlist>
-                        <listitem><para><methodname>setOptions(array $options)</methodname></para></listitem>
+                        <listitem>
+                            <para>
+                                <methodname>setOptions(array $options)</methodname>
+                            </para>
+                        </listitem>
 
                         <listitem>
                             <para><methodname>setConfig(Zend_Config $config)</methodname></para>
@@ -776,17 +781,25 @@ $form->setDefaultDisplayGroupClass('My_DisplayGroup');
 
                 <listitem><para>Metadata:</para>
                     <itemizedlist>
-                        <listitem><para><methodname>setAttrib($key, $value)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>setAttrib($key, $value)</methodname></para>
+                        </listitem>
 
-                        <listitem><para><methodname>addAttribs(array $attribs)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>addAttribs(array $attribs)</methodname></para>
+                        </listitem>
 
-                        <listitem><para><methodname>setAttribs(array $attribs)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>setAttribs(array $attribs)</methodname></para>
+                        </listitem>
 
                         <listitem><para><methodname>getAttrib($key)</methodname></para></listitem>
 
                         <listitem><para><methodname>getAttribs()</methodname></para></listitem>
 
-                        <listitem><para><methodname>removeAttrib($key)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>removeAttrib($key)</methodname></para>
+                        </listitem>
 
                         <listitem><para><methodname>clearAttribs()</methodname></para></listitem>
 
@@ -794,11 +807,15 @@ $form->setDefaultDisplayGroupClass('My_DisplayGroup');
 
                         <listitem><para><methodname>getName()</methodname></para></listitem>
 
-                        <listitem><para><methodname>setDescription($value)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>setDescription($value)</methodname></para>
+                        </listitem>
 
                         <listitem><para><methodname>getDescription()</methodname></para></listitem>
 
-                        <listitem><para><methodname>setLegend($legend)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>setLegend($legend)</methodname></para>
+                        </listitem>
 
                         <listitem><para><methodname>getLegend()</methodname></para></listitem>
 
@@ -812,7 +829,8 @@ $form->setDefaultDisplayGroupClass('My_DisplayGroup');
                     <itemizedlist>
                         <listitem>
                             <para>
-                                <methodname>createElement($type, $name, array $options = array())</methodname>
+                                <methodname>createElement($type, $name, array $options
+                                    = array())</methodname>
                             </para>
                         </listitem>
 
@@ -823,15 +841,21 @@ $form->setDefaultDisplayGroupClass('My_DisplayGroup');
                             </para>
                         </listitem>
 
-                        <listitem><para><methodname>addElements(array $elements)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>addElements(array $elements)</methodname></para>
+                        </listitem>
 
-                        <listitem><para><methodname>setElements(array $elements)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>setElements(array $elements)</methodname></para>
+                        </listitem>
 
                         <listitem><para><methodname>getElement($name)</methodname></para></listitem>
 
                         <listitem><para><methodname>getElements()</methodname></para></listitem>
 
-                        <listitem><para><methodname>removeElement($name)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>removeElement($name)</methodname></para>
+                        </listitem>
 
                         <listitem><para><methodname>clearElements()</methodname></para></listitem>
                     </itemizedlist>
@@ -841,22 +865,29 @@ $form->setDefaultDisplayGroupClass('My_DisplayGroup');
                     <itemizedlist>
                         <listitem>
                             <para>
-                                <methodname>setPluginLoader(Zend_Loader_PluginLoader $loader)</methodname>
+                                <methodname>setPluginLoader(Zend_Loader_PluginLoader
+                                    $loader)</methodname>
                             </para>
                         </listitem>
 
                         <listitem><para><methodname>getPluginLoader()</methodname></para></listitem>
 
-                        <listitem><para><methodname>addPrefixPath($prefix, $path)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>addPrefixPath($prefix, $path)</methodname></para>
+                        </listitem>
 
-                        <listitem><para><methodname>addPrefixPaths(array $spec)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>addPrefixPaths(array $spec)</methodname></para>
+                        </listitem>
                     </itemizedlist>
                 </listitem>
 
                 <listitem><para>Decorators:</para>
                     <itemizedlist>
                         <listitem>
-                            <para><methodname>addDecorator($decorator, $options = null)</methodname></para>
+                            <para>
+                                <methodname>addDecorator($decorator, $options = null)</methodname>
+                            </para>
                         </listitem>
 
                         <listitem>
@@ -867,11 +898,15 @@ $form->setDefaultDisplayGroupClass('My_DisplayGroup');
                             <para><methodname>setDecorators(array $decorators)</methodname></para>
                         </listitem>
 
-                        <listitem><para><methodname>getDecorator($name)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>getDecorator($name)</methodname></para>
+                        </listitem>
 
                         <listitem><para><methodname>getDecorators()</methodname></para></listitem>
 
-                        <listitem><para><methodname>removeDecorator($name)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>removeDecorator($name)</methodname></para>
+                        </listitem>
 
                         <listitem><para><methodname>clearDecorators()</methodname></para></listitem>
                     </itemizedlist>
@@ -880,13 +915,17 @@ $form->setDefaultDisplayGroupClass('My_DisplayGroup');
                 <listitem><para>Rendering:</para>
                     <itemizedlist>
                         <listitem>
-                            <para><methodname>setView(Zend_View_Interface $view = null)</methodname></para>
+                            <para>
+                                <methodname>setView(Zend_View_Interface $view = null)</methodname>
+                            </para>
                         </listitem>
 
                         <listitem><para><methodname>getView()</methodname></para></listitem>
 
                         <listitem>
-                            <para><methodname>render(Zend_View_Interface $view = null)</methodname></para>
+                            <para>
+                                <methodname>render(Zend_View_Interface $view = null)</methodname>
+                            </para>
                         </listitem>
                     </itemizedlist>
                 </listitem>
@@ -902,9 +941,13 @@ $form->setDefaultDisplayGroupClass('My_DisplayGroup');
 
                         <listitem><para><methodname>getTranslator()</methodname></para></listitem>
 
-                        <listitem><para><methodname>setDisableTranslator($flag)</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>setDisableTranslator($flag)</methodname></para>
+                        </listitem>
 
-                        <listitem><para><methodname>translatorIsDisabled()</methodname></para></listitem>
+                        <listitem>
+                            <para><methodname>translatorIsDisabled()</methodname></para>
+                        </listitem>
                     </itemizedlist>
                 </listitem>
             </itemizedlist>
@@ -1498,9 +1541,13 @@ $messages = $form->getMessages('username');
         <itemizedlist>
             <listitem><para>Configuration and Options:</para>
                 <itemizedlist>
-                    <listitem><para><methodname>setOptions(array $options)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setOptions(array $options)</methodname></para>
+                    </listitem>
 
-                    <listitem><para><methodname>setConfig(Zend_Config $config)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setConfig(Zend_Config $config)</methodname></para>
+                    </listitem>
                 </itemizedlist>
             </listitem>
 
@@ -1513,16 +1560,23 @@ $messages = $form->getMessages('username');
                         </para>
                     </listitem>
 
-                    <listitem><para><methodname>getPluginLoader($type = null)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>getPluginLoader($type = null)</methodname></para>
+                    </listitem>
 
                     <listitem>
                         <para><code>addPrefixPath($prefix, $path, $type = null) </code></para>
                     </listitem>
 
-                    <listitem><para><methodname>addPrefixPaths(array $spec)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>addPrefixPaths(array $spec)</methodname></para>
+                    </listitem>
 
                     <listitem>
-                        <para><methodname>addElementPrefixPath($prefix, $path, $type = null)</methodname></para>
+                        <para>
+                            <methodname>addElementPrefixPath($prefix, $path, $type
+                                = null)</methodname>
+                        </para>
                     </listitem>
 
                     <listitem>
@@ -1530,18 +1584,26 @@ $messages = $form->getMessages('username');
                     </listitem>
 
                     <listitem>
-                        <para><methodname>addDisplayGroupPrefixPath($prefix, $path)</methodname></para>
+                        <para>
+                            <methodname>addDisplayGroupPrefixPath($prefix, $path)</methodname>
+                        </para>
                     </listitem>
                 </itemizedlist>
             </listitem>
 
             <listitem><para>Metadata:</para>
                 <itemizedlist>
-                    <listitem><para><methodname>setAttrib($key, $value)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setAttrib($key, $value)</methodname></para>
+                    </listitem>
 
-                    <listitem><para><methodname>addAttribs(array $attribs)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>addAttribs(array $attribs)</methodname></para>
+                    </listitem>
 
-                    <listitem><para><methodname>setAttribs(array $attribs)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setAttribs(array $attribs)</methodname></para>
+                    </listitem>
 
                     <listitem><para><methodname>getAttrib($key)</methodname></para></listitem>
 
@@ -1567,11 +1629,20 @@ $messages = $form->getMessages('username');
 
             <listitem><para>Elements:</para>
                 <itemizedlist>
-                    <listitem><para><methodname>addElement($element, $name = null, $options = null)</methodname></para></listitem>
+                    <listitem>
+                        <para>
+                            <methodname>addElement($element, $name = null, $options
+                                = null)</methodname>
+                        </para>
+                    </listitem>
 
-                    <listitem><para><methodname>addElements(array $elements)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>addElements(array $elements)</methodname></para>
+                    </listitem>
 
-                    <listitem><para><methodname>setElements(array $elements)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setElements(array $elements)</methodname></para>
+                    </listitem>
 
                     <listitem><para><methodname>getElement($name)</methodname></para></listitem>
 
@@ -1581,22 +1652,32 @@ $messages = $form->getMessages('username');
 
                     <listitem><para><methodname>clearElements()</methodname></para></listitem>
 
-                    <listitem><para><methodname>setDefaults(array $defaults)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setDefaults(array $defaults)</methodname></para>
+                    </listitem>
 
-                    <listitem><para><methodname>setDefault($name, $value)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setDefault($name, $value)</methodname></para>
+                    </listitem>
 
                     <listitem><para><methodname>getValue($name)</methodname></para></listitem>
 
                     <listitem><para><methodname>getValues()</methodname></para></listitem>
 
-                    <listitem><para><methodname>getUnfilteredValue($name)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>getUnfilteredValue($name)</methodname></para>
+                    </listitem>
 
                     <listitem><para><methodname>getUnfilteredValues()</methodname></para></listitem>
 
-                    <listitem><para><methodname>setElementFilters(array $filters)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setElementFilters(array $filters)</methodname></para>
+                    </listitem>
 
                     <listitem>
-                        <para><methodname>setElementDecorators(array $decorators)</methodname></para>
+                        <para>
+                            <methodname>setElementDecorators(array $decorators)</methodname>
+                        </para>
                     </listitem>
                 </itemizedlist>
             </listitem>
@@ -1604,12 +1685,19 @@ $messages = $form->getMessages('username');
             <listitem><para>Sub forms:</para>
                 <itemizedlist>
                     <listitem>
-                        <para><methodname>addSubForm(Zend_Form $form, $name, $order = null)</methodname></para>
+                        <para>
+                            <methodname>addSubForm(Zend_Form $form, $name, $order
+                                = null)</methodname>
+                        </para>
                     </listitem>
 
-                    <listitem><para><methodname>addSubForms(array $subForms)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>addSubForms(array $subForms)</methodname></para>
+                    </listitem>
 
-                    <listitem><para><methodname>setSubForms(array $subForms)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setSubForms(array $subForms)</methodname></para>
+                    </listitem>
 
                     <listitem><para><methodname>getSubForm($name)</methodname></para></listitem>
 
@@ -1620,7 +1708,9 @@ $messages = $form->getMessages('username');
                     <listitem><para><methodname>clearSubForms()</methodname></para></listitem>
 
                     <listitem>
-                        <para><methodname>setSubFormDecorators(array $decorators)</methodname></para>
+                        <para>
+                            <methodname>setSubFormDecorators(array $decorators)</methodname>
+                        </para>
                     </listitem>
                 </itemizedlist>
             </listitem>
@@ -1629,72 +1719,105 @@ $messages = $form->getMessages('username');
                 <itemizedlist>
                     <listitem>
                         <para>
-                            <methodname>addDisplayGroup(array $elements, $name, $options = null)</methodname>
+                            <methodname>addDisplayGroup(array $elements, $name, $options
+                                = null)</methodname>
                         </para>
                     </listitem>
 
-                    <listitem><para><methodname>addDisplayGroups(array $groups)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>addDisplayGroups(array $groups)</methodname></para>
+                    </listitem>
 
-                    <listitem><para><methodname>setDisplayGroups(array $groups)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setDisplayGroups(array $groups)</methodname></para>
+                    </listitem>
 
-                    <listitem><para><methodname>getDisplayGroup($name)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>getDisplayGroup($name)</methodname></para>
+                    </listitem>
 
                     <listitem><para><methodname>getDisplayGroups()</methodname></para></listitem>
 
-                    <listitem><para><methodname>removeDisplayGroup($name)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>removeDisplayGroup($name)</methodname></para>
+                    </listitem>
 
                     <listitem><para><methodname>clearDisplayGroups()</methodname></para></listitem>
 
                     <listitem>
-                        <para><methodname>setDisplayGroupDecorators(array $decorators)</methodname></para>
+                        <para>
+                            <methodname>setDisplayGroupDecorators(array $decorators)</methodname>
+                        </para>
                     </listitem>
                 </itemizedlist>
             </listitem>
 
             <listitem><para>Validation</para>
                 <itemizedlist>
-                    <listitem><para><methodname>populate(array $values)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>populate(array $values)</methodname></para>
+                    </listitem>
 
                     <listitem><para><methodname>isValid(array $data)</methodname></para></listitem>
 
-                    <listitem><para><methodname>isValidPartial(array $data)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>isValidPartial(array $data)</methodname></para>
+                    </listitem>
 
-                    <listitem><para><methodname>processAjax(array $data)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>processAjax(array $data)</methodname></para>
+                    </listitem>
 
                     <listitem><para><methodname>persistData()</methodname></para></listitem>
 
-                    <listitem><para><methodname>getErrors($name = null)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>getErrors($name = null)</methodname></para>
+                    </listitem>
 
-                    <listitem><para><methodname>getMessages($name = null)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>getMessages($name = null)</methodname></para>
+                    </listitem>
                 </itemizedlist>
             </listitem>
 
             <listitem><para>Rendering:</para>
                 <itemizedlist>
                     <listitem>
-                        <para><methodname>setView(Zend_View_Interface $view = null)</methodname></para>
+                        <para>
+                            <methodname>setView(Zend_View_Interface $view = null)</methodname>
+                        </para>
                     </listitem>
 
                     <listitem><para><methodname>getView()</methodname></para></listitem>
 
                     <listitem>
-                        <para><methodname>addDecorator($decorator, $options = null)</methodname></para>
+                        <para>
+                            <methodname>addDecorator($decorator, $options = null)</methodname>
+                        </para>
                     </listitem>
 
-                    <listitem><para><methodname>addDecorators(array $decorators)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>addDecorators(array $decorators)</methodname></para>
+                    </listitem>
 
-                    <listitem><para><methodname>setDecorators(array $decorators)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setDecorators(array $decorators)</methodname></para>
+                    </listitem>
 
                     <listitem><para><methodname>getDecorator($name)</methodname></para></listitem>
 
                     <listitem><para><methodname>getDecorators()</methodname></para></listitem>
 
-                    <listitem><para><methodname>removeDecorator($name)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>removeDecorator($name)</methodname></para>
+                    </listitem>
 
                     <listitem><para><methodname>clearDecorators()</methodname></para></listitem>
 
                     <listitem>
-                        <para><methodname>render(Zend_View_Interface $view = null)</methodname></para>
+                        <para>
+                            <methodname>render(Zend_View_Interface $view = null)</methodname>
+                        </para>
                     </listitem>
                 </itemizedlist>
             </listitem>
@@ -1703,15 +1826,20 @@ $messages = $form->getMessages('username');
                 <itemizedlist>
                     <listitem>
                         <para>
-                            <methodname>setTranslator(Zend_Translate_Adapter $translator = null)</methodname>
+                            <methodname>setTranslator(Zend_Translate_Adapter $translator
+                                = null)</methodname>
                         </para>
                     </listitem>
 
                     <listitem><para><methodname>getTranslator()</methodname></para></listitem>
 
-                    <listitem><para><methodname>setDisableTranslator($flag)</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>setDisableTranslator($flag)</methodname></para>
+                    </listitem>
 
-                    <listitem><para><methodname>translatorIsDisabled()</methodname></para></listitem>
+                    <listitem>
+                        <para><methodname>translatorIsDisabled()</methodname></para>
+                    </listitem>
                 </itemizedlist>
             </listitem>
         </itemizedlist>