[MANUAL] English:

- several manual fixes

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

documentation/manual/en/module_specs/Zend_Text_Figlet.xml

@@ -17,9 +17,9 @@
 
         <para>
             <classname>Zend_Text_Figlet</classname> supports gzipped fonts. This means that
-            you can take an <code>.flf</code> file and gzip it. To allow
+            you can take an <filename>.flf</filename> file and gzip it. To allow
             <classname>Zend_Text_Figlet</classname> to recognize this, the gzipped font
-            must have the extension <code>.gz</code>. Further, to be able to use
+            must have the extension <filename>.gz</filename>. Further, to be able to use
             gzipped fonts, you have to have enabled the GZIP extension of <acronym>PHP</acronym>.
         </para>
     </note>
@@ -42,7 +42,7 @@
         <itemizedlist>
             <listitem>
                 <para>
-                    <code>font</code> - Defines the font which should be used
+                    <property>font</property> - Defines the font which should be used
                     for rendering. If not defines, the built-in font will be
                     used.
                 </para>
@@ -50,7 +50,7 @@
 
             <listitem>
                 <para>
-                    <code>outputWidth</code> - Defines the maximum width of the
+                    <property>outputWidth</property> - Defines the maximum width of the
                     output string. This is used for word-wrap as well as
                     justification. Beware of too small values, they may result
                     in an undefined behaviour. The default value is 80.
@@ -59,7 +59,7 @@
 
             <listitem>
                 <para>
-                    <code>handleParagraphs</code> - A boolean which indicates,
+                    <property>handleParagraphs</property> - A boolean which indicates,
                     how new lines are handled. When set to <constant>TRUE</constant>, single new
                     lines are ignored and instead treated as single spaces. Only multiple
                     new lines will be handled as such. The default value is
@@ -69,18 +69,18 @@
 
             <listitem>
                 <para>
-                    <code>justification</code> - May be one of the values of
+                    <property>justification</property> - May be one of the values of
                     <classname>Zend_Text_Figlet::JUSTIFICATION_*</classname>. There is
                     <constant>JUSTIFICATION_LEFT</constant>,
                     <constant>JUSTIFICATION_CENTER</constant> and
                     <constant>JUSTIFICATION_RIGHT</constant> The default justification
-                    is defined by the <code>rightToLeft</code> value.
+                    is defined by the <property>rightToLeft</property> value.
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <code>rightToLeft</code> - Defines in which direction the
+                    <property>rightToLeft</property> - Defines in which direction the
                     text is written. May be either
                     <constant>Zend_Text_Figlet::DIRECTION_LEFT_TO_RIGHT</constant> or
                     <constant>Zend_Text_Figlet::DIRECTION_RIGHT_TO_LEFT</constant>. By
@@ -92,7 +92,7 @@
 
             <listitem>
                 <para>
-                    <code>smushMode</code> - An integer bitfield which defines,
+                    <property>smushMode</property> - An integer bitfield which defines,
                     how the single characters are smushed together. Can be the
                     sum of multiple values from <classname>Zend_Text_Figlet::SM_*</classname>.
                     There are the following smush modes: SM_EQUAL, SM_LOWLINE,

documentation/manual/en/module_specs/Zend_Text_Table.xml

@@ -18,10 +18,10 @@
         <para>
             <classname>Zend_Text_Table</classname> expects your strings to be UTF-8 encoded
             by default. If this is not the case, you can either supply the character
-            encoding as a parameter to the <code>constructor</code> or the
-            <code>setContent</code> method of <classname>Zend_Text_Table_Column</classname>.
-            Alternatively if you have a different encoding in the entire
-            process, you can define the standard input charset with
+            encoding as a parameter to the <methodname>constructor()</methodname> or the
+            <methodname>setContent()</methodname> method of
+            <classname>Zend_Text_Table_Column</classname>. Alternatively if you have a different
+            encoding in the entire process, you can define the standard input charset with
             <methodname>Zend_Text_Table::setInputCharset($charset)</methodname>. In
             case you need another output charset for the table, you can set
             this with <methodname>Zend_Text_Table::setOutputCharset($charset)</methodname>.
@@ -37,30 +37,30 @@
         <itemizedlist>
             <listitem>
                 <para>
-                    <code>columnWidths</code> (required): An array defining
+                    <property>columnWidths</property> (required): An array defining
                     all columns width their widths in characters.
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <code>decorator</code>: The decorator to use for the
-                    table borders. The default is <code>unicode</code>, but
-                    you may also specify <code>ascii</code> or give an instance
+                    <property>decorator</property>: The decorator to use for the
+                    table borders. The default is <emphasis>unicode</emphasis>, but
+                    you may also specify <emphasis>ascii</emphasis> or give an instance
                     of a custom decorator object.
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <code>padding</code>: The left and right padding withing
+                    <property>padding</property>: The left and right padding withing
                     the columns in characters. The default padding is zero.
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <code>AutoSeparate</code>: The way how the rows are
+                    <property>AutoSeparate</property>: The way how the rows are
                     separated with horizontal lines. The default is a
                     separation between all rows. This is defined as a bitmask
                     containing one ore more of the following constants of
@@ -94,8 +94,8 @@
     <para>
         Rows are simply added to the table by creating a new instance of
         <classname>Zend_Text_Table_Row</classname>, and appending it to the table via the
-        <code>appendRow</code> method. Rows themselves have no options. You can also
-        give an array to directly to the <code>appendRow</code> method, which then
+        <methodname>appendRow()</methodname> method. Rows themselves have no options. You can also
+        give an array to directly to the <methodname>appendRow()</methodname> method, which then
         will automatically converted to a row object, containing multiple column
         objects.
     </para>
@@ -103,11 +103,11 @@
     <para>
         The same way you can add columns to the rows. Create a new instance of
         <classname>Zend_Text_Table_Column</classname> and then either set the column
-        options in the constructor or later with the <code>set*</code> methods.
+        options in the constructor or later with the <methodname>set*()</methodname> methods.
         The first parameter is the content of the column which may have
         multiple lines, which in the best case are separated by just the
-        <code>\n</code> character. The second parameter defines the align, which
-        is <code>left</code> by default and can be one of the class constants of
+        '\n' character. The second parameter defines the align, which
+        is 'left' by default and can be one of the class constants of
         <classname>Zend_Text_Table_Column</classname>:
 
         <itemizedlist>
@@ -134,15 +134,16 @@
         choose "2" as colspan, the column will span over two columns of the table.
         The last parameter defines the encoding of the content, which should be
         supplied, if the content is neither ASCII nor UTF-8. To append the column
-        to the row, you simply call <code>appendColumn</code> in your row object
+        to the row, you simply call <methodname>appendColumn()</methodname> in your row object
         with the column object as parameter. Alternatively you can directly
-        give a string to the <code>appendColumn</code> method.
+        give a string to the <methodname>appendColumn()</methodname> method.
     </para>
 
     <para>
-        To finally render the table, you can either use the <code>render</code>
-        method of the table, or use the magic method <code>__toString</code>
-        by doing <code>echo $table;</code> or <code>$tableString = (string) $table</code>.
+        To finally render the table, you can either use the <methodname>render()</methodname>
+        method of the table, or use the magic method <methodname>__toString()</methodname>
+        by doing <command>echo $table;</command> or
+        <command>$tableString = (string) $table</command>.
     </para>
 
     <example id="zend.text.table.example.using">

documentation/manual/en/module_specs/Zend_Translate-Plurals.xml

@@ -239,8 +239,8 @@ array(
 ]]></programlisting>
 
             <para>
-                In the above example <code>plural_0</code> and <code>plural_1</code> are the
-                plural definitions from the source code. And the array at <code>plural_0</code>
+                In the above example 'plural_0' and 'plural_1' are the
+                plural definitions from the source code. And the array at 'plural_0'
                 has all translated plural forms available. Take a look at the following example
                 with real content and translation from English source to German.
             </para>

documentation/manual/en/module_specs/Zend_Translate-Using.xml

@@ -119,8 +119,8 @@ printf($translate->_("Today is the %1\$s") . "\n", date("d.m.Y"));
 
     <para>
         Instead of <methodname>print()</methodname>, use the <methodname>printf()</methodname>
-        function and replace all parameters with <code>%1\$s</code> parts.
-        The first is <code>%1\$s</code>, the second is <code>%2\$s</code>,
+        function and replace all parameters with <emphasis>%1\$s</emphasis> parts.
+        The first is <emphasis>%1\$s</emphasis>, the second is <emphasis>%2\$s</emphasis>,
         and so on. This way a translation can be done without knowing
         the exact value. In our example, the date is always the actual day,
         but the string can be translated without the knowledge of the actual

documentation/manual/en/module_specs/Zend_XmlRpc_Server.xml

@@ -457,8 +457,8 @@ $server->setClass('Services_PricingService',
             <para>
                 The arguments passed at <methodname>setClass()</methodname> at server construction
                 time are injected into the method call <command>pricing.calculate()</command> on
-                remote invokation. In the example above, only the argument <code>$purchaseId</code>
-                is expected from the client.
+                remote invokation. In the example above, only the argument
+                <varname>$purchaseId</varname> is expected from the client.
             </para>
         </example>
 
@@ -694,15 +694,15 @@ echo $server->handle($request);
             <para>
                 <classname>Zend_XmlRpc_Server</classname> uses
                 <classname>DOMDocument</classname> of <acronym>PHP</acronym>
-                extension <code>ext/dom</code> to generate it's
-                <acronym>XML</acronym> output. While <code>ext/dom</code> is
+                extension <emphasis>ext/dom</emphasis> to generate it's
+                <acronym>XML</acronym> output. While <emphasis>ext/dom</emphasis> is
                 available on a lot of hosts it is not exactly the fastest.
                 Benchmarks have shown, that <classname>XmlWriter</classname>
-                from <code>ext/xmlwriter</code> performs better.
+                from <emphasis>ext/xmlwriter</emphasis> performs better.
             </para>
 
             <para>
-                If <code>ext/xmlwriter</code> is available on your host, you can
+                If <emphasis>ext/xmlwriter</emphasis> is available on your host, you can
                 select a the <classname>XmlWriter</classname>-based generator
                 to leaverage the performance differences.
             </para>