[MANUAL] English:

- structural fixes (no translations needed)

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

documentation/manual/en/module_specs/Zend_Reflection-Introduction.xml

@@ -4,41 +4,53 @@
     <title>Introduction</title>
 
     <para>
-        <classname>Zend_Reflection</classname> is a drop-in extension to <acronym>PHP</acronym>'s own <ulink
-            url="http://php.net/reflection">Reflection <acronym>API</acronym></ulink>, providing
-        several additional features:
+        <classname>Zend_Reflection</classname> is a drop-in extension to <acronym>PHP</acronym>'s
+        own <ulink url="http://php.net/reflection">Reflection <acronym>API</acronym></ulink>,
+        providing several additional features:
     </para>
 
     <itemizedlist>
-        <listitem><para>
-            Ability to retrieve return values types.
-        </para></listitem>
-
-        <listitem><para>
-            Ability to retrieve method and function parameter types.
-        </para></listitem>
-
-        <listitem><para>
-            Ability to retrieve class property types.
-        </para></listitem>
-
-        <listitem><para>
-            DocBlocks gain a Reflection class, allowing introspection of
-            docblocks. This provides the ability to determine what annotation
-            tags have been defined as well as to retrieve their values, and the
-            ability to retrieve the short and long descriptions.
-        </para></listitem>
-
-        <listitem><para>
-            Files gain a Reflection class, allowing introspection of <acronym>PHP</acronym> files.
-            This provides the ability to determine what functions and classes
-            are defined in a given file, as well as to introspect them.
-        </para></listitem>
-
-        <listitem><para>
-            Ability to override any Reflection class with your own variant, for
-            the entire reflection tree you create.
-        </para></listitem>
+        <listitem>
+            <para>
+                Ability to retrieve return values types.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Ability to retrieve method and function parameter types.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Ability to retrieve class property types.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                DocBlocks gain a Reflection class, allowing introspection of
+                docblocks. This provides the ability to determine what annotation
+                tags have been defined as well as to retrieve their values, and the
+                ability to retrieve the short and long descriptions.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Files gain a Reflection class, allowing introspection of <acronym>PHP</acronym>
+                files. This provides the ability to determine what functions and classes
+                are defined in a given file, as well as to introspect them.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Ability to override any Reflection class with your own variant, for
+                the entire reflection tree you create.
+            </para>
+        </listitem>
     </itemizedlist>
 
     <para>

documentation/manual/en/module_specs/Zend_Rest.xml

@@ -30,7 +30,6 @@
         REST requests to controllers.
     </para>
 </sect1>
-
 <!--
 vim:se ts=4 sw=4 et:
 -->

documentation/manual/en/module_specs/Zend_Rest_Server.xml

@@ -61,6 +61,7 @@ $server->handle();
 
         <note>
             <title>Numeric index</title>
+
             <para>
                 Numeric arguments use a 1-based index.
             </para>
@@ -93,6 +94,7 @@ $server->handle();
 
         <example id="zend.rest.server.customstatus.example-1">
             <title>Returning Custom Status</title>
+
             <programlisting language="php"><![CDATA[
 /**
  * Say Hello
@@ -158,7 +160,6 @@ $server->handle();
         </para>
     </sect2>
 </sect1>
-
 <!--
 vim:se ts=4 sw=4 et:
 -->

documentation/manual/en/module_specs/Zend_Serializer-Adapter.xml

@@ -64,9 +64,9 @@
         </para>
 
         <para>
-            The adapter simply uses the <ulink url="http://php.net/manual/book.wddx.php">wddx_*()</ulink>
-            PHP functions. Please read the php manual to determine how you may enable them in your
-            PHP installation.
+            The adapter simply uses the <ulink
+                url="http://php.net/manual/book.wddx.php">wddx_*()</ulink> PHP functions. Please
+            read the php manual to determine how you may enable them in your PHP installation.
         </para>
 
         <para>
@@ -88,11 +88,8 @@
                  <thead>
                       <row>
                           <entry>Option</entry>
-
                           <entry>Data Type</entry>
-
                           <entry>Default Value</entry>
-
                           <entry>Description</entry>
                     </row>
                  </thead>
@@ -100,14 +97,9 @@
                  <tbody>
                       <row>
                           <entry><emphasis>comment</emphasis></entry>
-
                           <entry><type>string</type></entry>
-
                           <entry></entry>
-
-                          <entry>
-                            An optional comment that appears in the packet header.
-                          </entry>
+                          <entry>An optional comment that appears in the packet header.</entry>
                       </row>
                   </tbody>
              </tgroup>
@@ -135,11 +127,8 @@
                  <thead>
                       <row>
                         <entry>Option</entry>
-
                         <entry>Data Type</entry>
-
                         <entry>Default Value</entry>
-
                         <entry>Description</entry>
                     </row>
                  </thead>
@@ -147,38 +136,23 @@
                  <tbody>
                       <row>
                           <entry><emphasis>cycleCheck</emphasis></entry>
-
                           <entry><type>boolean</type></entry>
-
                           <entry>false</entry>
-
-                          <entry>
-                               See <xref linkend= "zend.json.advanced.objects1"/>
-                          </entry>
+                          <entry>See <xref linkend="zend.json.advanced.objects1"/></entry>
                       </row>
 
                       <row>
                           <entry><emphasis>objectDecodeType</emphasis></entry>
-
                           <entry><type>Zend_Json::TYPE_*</type></entry>
-
                           <entry>Zend_Json::TYPE_ARRAY</entry>
-
-                          <entry>
-                               See <xref linkend= "zend.json.advanced.objects1"/>
-                          </entry>
+                          <entry>See <xref linkend= "zend.json.advanced.objects1"/></entry>
                       </row>
 
                       <row>
                           <entry><emphasis>enableJsonExprFinder</emphasis></entry>
-
                           <entry><type>boolean</type></entry>
-
                           <entry>false</entry>
-
-                          <entry>
-                               See <xref linkend= "zend.json.advanced.expr"/>
-                          </entry>
+                          <entry>See <xref linkend= "zend.json.advanced.expr"/></entry>
                       </row>
                   </tbody>
              </tgroup>
@@ -222,11 +196,8 @@
                  <thead>
                       <row>
                         <entry>Option</entry>
-
                         <entry>Data Type</entry>
-
                         <entry>Default Value</entry>
-
                         <entry>Description</entry>
                     </row>
                  </thead>
@@ -234,13 +205,12 @@
                  <tbody>
                       <row>
                           <entry><emphasis>protocol</emphasis></entry>
-
                           <entry><type>integer</type> (0 | 1 | 2 | 3)</entry>
-
                           <entry>0</entry>
 
                           <entry>
-                               The Pickle protocol version used on <methodname>serialize</methodname>
+                               The Pickle protocol version used on
+                               <methodname>serialize</methodname>
                           </entry>
                       </row>
                   </tbody>
@@ -258,7 +228,6 @@
                  <thead>
                       <row>
                         <entry>PHP Type</entry>
-
                         <entry>Python Type</entry>
                     </row>
                  </thead>
@@ -266,49 +235,41 @@
                  <tbody>
                       <row>
                           <entry><type>NULL</type></entry>
-
                           <entry><type>None</type></entry>
                       </row>
 
                       <row>
                           <entry><type>boolean</type></entry>
-
                           <entry><type>boolean</type></entry>
                       </row>
 
                       <row>
                           <entry><type>integer</type></entry>
-
                           <entry><type>integer</type></entry>
                       </row>
 
                       <row>
                           <entry><type>float</type></entry>
-
                           <entry><type>float</type></entry>
                       </row>
 
                       <row>
                           <entry><type>string</type></entry>
-
                           <entry><type>string</type></entry>
                       </row>
 
                       <row>
                           <entry><type>array</type></entry>
-
                           <entry><type>list</type></entry>
                       </row>
 
                       <row>
                           <entry><type>associative array</type></entry>
-
                           <entry><type>dictionary</type></entry>
                       </row>
 
                       <row>
                           <entry><type>object</type></entry>
-
                           <entry><type>dictionary</type></entry>
                       </row>
                   </tbody>
@@ -326,7 +287,6 @@
                  <thead>
                       <row>
                         <entry>Python-Type</entry>
-
                         <entry>PHP-Type</entry>
                     </row>
                  </thead>
@@ -334,19 +294,16 @@
                  <tbody>
                       <row>
                           <entry><type>None</type></entry>
-
                           <entry><type>NULL</type></entry>
                       </row>
 
                       <row>
                           <entry><type>boolean</type></entry>
-
                           <entry><type>boolean</type></entry>
                       </row>
 
                       <row>
                           <entry><type>integer</type></entry>
-
                           <entry><type>integer</type></entry>
                       </row>
 
@@ -354,58 +311,48 @@
                           <entry><type>long</type></entry>
 
                           <entry>
-                              <type>integer</type>
-                              | <type>float</type>
-                              | <type>string</type>
+                              <type>integer</type> | <type>float</type> | <type>string</type>
                               | <classname>Zend_Serializer_Exception</classname>
                           </entry>
                       </row>
 
                       <row>
                           <entry><type>float</type></entry>
-
                           <entry><type>float</type></entry>
                       </row>
 
                       <row>
                           <entry><type>string</type></entry>
-
                           <entry><type>string</type></entry>
                       </row>
 
                       <row>
                           <entry><type>bytes</type></entry>
-
                           <entry><type>string</type></entry>
                       </row>
 
                       <row>
                           <entry><type>Unicode string</type></entry>
-
                           <entry><type>UTF-8 string</type></entry>
                       </row>
 
                       <row>
                           <entry><type>list</type></entry>
-
                           <entry><type>array</type></entry>
                       </row>
 
                       <row>
                           <entry><type>tuple</type></entry>
-
                           <entry><type>array</type></entry>
                       </row>
 
                       <row>
                           <entry><type>dictionary</type></entry>
-
                           <entry><type>associative array</type></entry>
                       </row>
 
                       <row>
                           <entry>All other types</entry>
-
                           <entry><classname>Zend_Serializer_Exception</classname></entry>
                       </row>
                   </tbody>

documentation/manual/en/module_specs/Zend_Server.xml

@@ -2,15 +2,17 @@
 <!-- Reviewed: no -->
 <sect1 id="zend.server.introduction">
     <title>Introduction</title>
+
     <para>
         The <classname>Zend_Server</classname> family of classes provides functionality
         for the various server classes, including
         <classname>Zend_XmlRpc_Server</classname>, <classname>Zend_Rest_Server</classname>,
         <classname>Zend_Json_Server</classname> and <classname>Zend_Soap_Wsdl</classname>.
-        <classname>Zend_Server_Interface</classname> provides an interface that mimics <acronym>PHP</acronym>
-        5's <code>SoapServer</code> class; all server classes should implement
-        this interface in order to provide a standard server <acronym>API</acronym>.
+        <classname>Zend_Server_Interface</classname> provides an interface that mimics
+        <acronym>PHP</acronym> 5's <code>SoapServer</code> class; all server classes should
+        implement this interface in order to provide a standard server <acronym>API</acronym>.
     </para>
+
     <para>
         The <classname>Zend_Server_Reflection</classname> tree provides a standard
         mechanism for performing function and class introspection for use as

documentation/manual/en/module_specs/Zend_Server_Reflection.xml

@@ -7,18 +7,20 @@
         <title>Introduction</title>
 
         <para>
-            <classname>Zend_Server_Reflection</classname> provides a standard mechanism for performing
-            function and class introspection for use with server classes. It is
-            based on <acronym>PHP</acronym> 5's Reflection <acronym>API</acronym>, augmenting it with methods
-            for retrieving parameter and return value types and descriptions, a
+            <classname>Zend_Server_Reflection</classname> provides a standard mechanism for
+            performing function and class introspection for use with server classes. It is
+            based on <acronym>PHP</acronym> 5's Reflection <acronym>API</acronym>, augmenting it
+            with methods for retrieving parameter and return value types and descriptions, a
             full list of function and method prototypes (i.e., all possible
             valid calling combinations), and function/method descriptions.
         </para>
+
         <para>
             Typically, this functionality will only be used by developers of
             server classes for the framework.
         </para>
     </sect2>
+
     <sect2 id="zend.server.reflection.usage">
         <title>Usage</title>
 

documentation/manual/en/module_specs/Zend_Service.xml

@@ -2,14 +2,17 @@
 <!-- Reviewed: no -->
 <sect1 id="zend.service.introduction">
     <title>Introduction</title>
+
     <para>
         <classname>Zend_Service</classname> is an abstract class which serves as a
         foundation for web service implementations, such as <acronym>SOAP</acronym> or REST.
     </para>
+
     <para>
         If you need support for generic, <acronym>XML</acronym>-based REST services, you may want
         to look at <link linkend="zend.rest.client"><classname>Zend_Rest_Client</classname></link>.
     </para>
+
     <para>
         In addition to being able to extend the <classname>Zend_Service</classname> and
         use <classname>Zend_Rest_Client</classname> for REST-based web services, Zend also
@@ -23,41 +26,49 @@
                 <link linkend="zend.service.akismet">Akismet</link>
             </para>
         </listitem>
+
         <listitem>
             <para>
                 <link linkend="zend.service.amazon">Amazon</link>
             </para>
         </listitem>
+
         <listitem>
             <para>
                 <link linkend="zend.service.audioscrobbler">Audioscrobbler</link>
             </para>
         </listitem>
+
         <listitem>
             <para>
                 <link linkend="zend.service.delicious">Del.icio.us</link>
             </para>
         </listitem>
+
         <listitem>
             <para>
                 <link linkend="zend.service.flickr">Flickr</link>
             </para>
         </listitem>
+
         <listitem>
             <para>
                 <link linkend="zend.service.simpy">Simpy</link>
             </para>
         </listitem>
+
         <listitem>
             <para>
                 <link linkend="zend.service.slideshare">SlideShare</link>
             </para>
         </listitem>
+
         <listitem>
             <para>
                 <link linkend="zend.service.strikeiron">StrikeIron</link>
             </para>
         </listitem>
+
         <listitem>
             <para>
                 <link linkend="zend.service.yahoo">Yahoo!</link>
@@ -68,7 +79,6 @@
     <para>
         Additional services are coming in the future.
     </para>
-
 </sect1>
 <!--
 vim:se ts=4 sw=4 et:

documentation/manual/en/module_specs/Zend_Service_Akismet.xml

@@ -253,9 +253,9 @@ $akismet->submitSpam($data));
         <para>
             <methodname>Zend_Service_Akismet::submitHam()</methodname> takes the same data
             array as passed to <methodname>isSpam()</methodname> or
-            <methodname>submitSpam()</methodname>, and, like <methodname>submitSpam()</methodname>, does
-            not return a value. An exception will be raised if the <acronym>API</acronym> key used
-            is invalid.
+            <methodname>submitSpam()</methodname>, and, like <methodname>submitSpam()</methodname>,
+            does not return a value. An exception will be raised if the <acronym>API</acronym> key
+            used is invalid.
         </para>
 
         <example id="zend.service.akismet.submitham.example-1">
@@ -324,12 +324,12 @@ $akismet->submitHam($data));
 
             <listitem>
                 <para>
-                    <methodname>getUserAgent()</methodname> and <methodname>setUserAgent()</methodname>
-                    allow you to retrieve and modify the <acronym>HTTP</acronym> user agent used to
-                    make the request. Note: this is not the user_agent used in
-                    data submitted to the service, but rather the value provided
-                    in the <acronym>HTTP</acronym> User-Agent header when making a request to the
-                    service.
+                    <methodname>getUserAgent()</methodname> and
+                    <methodname>setUserAgent()</methodname> allow you to retrieve and modify the
+                    <acronym>HTTP</acronym> user agent used to make the request. Note: this is not
+                    the user_agent used in data submitted to the service, but rather the value
+                    provided in the <acronym>HTTP</acronym> User-Agent header when making a request
+                    to the service.
                 </para>
 
                 <para>
@@ -343,7 +343,6 @@ $akismet->submitHam($data));
         </itemizedlist>
     </sect2>
 </sect1>
-
 <!--
 vim:se ts=4 sw=4 et:
 -->

documentation/manual/en/module_specs/Zend_Service_Amazon_Ec2-CloudWatch.xml

@@ -2,6 +2,7 @@
 <!-- Reviewed: no -->
 <sect1 id="zend.service.amazon.ec2.cloudwatch">
     <title>Zend_Service_Amazon_Ec2: CloudWatch Monitoring</title>
+
     <para>
         Amazon CloudWatch is an easy-to-use web service that provides
         comprehensive monitoring for Amazon Elastic Compute Cloud (Amazon
@@ -16,6 +17,7 @@
 
         <example id="zend.service.amazon.ec2.cloudwatch.usage.list">
             <title>Listing Aviable Metrics</title>
+
             <para>
                 <methodname>listMetrics()</methodname> returns a list of up to 500 valid metrics for
                 which there is recorded data available to a you and a NextToken string
@@ -30,10 +32,12 @@ $return = $ec2_ebs->listMetrics();
 
         <example id="zend.service.amazon.ec2.cloudwatch.usage.getmetricstatistics">
             <title>Return Statistics for a given metric</title>
+
             <para>
                 <methodname>getMetricStatistics()</methodname> Returns data for one or more
                 statistics of given a metric.
             </para>
+
             <para>
                 <note>
                     <para>
@@ -47,14 +51,17 @@ $return = $ec2_ebs->listMetrics();
                     </para>
                 </note>
             </para>
+
             <para>
                 <methodname>getMetricStatistics()</methodname> only requires two parameters but it
                 also has four additional parameters that are optional.
             </para>
+
             <itemizedlist>
                 <listitem>
                     <para><emphasis>Required:</emphasis></para>
                 </listitem>
+
                 <listitem>
                     <para>
                         <emphasis>MeasureName</emphasis> The measure name that corresponds to
@@ -63,10 +70,11 @@ $return = $ec2_ebs->listMetrics();
                         DiskReadBytes, DiskReadOps, DiskWriteBytes. Valid Elastic
                         Load Balancing Metrics are Latency, RequestCount, HealthyHostCount
                         UnHealthyHostCount. <ulink
-                            url="http://docs.amazonwebservices.com/AmazonCloudWatch/latest/DeveloperGuide/arch-AmazonCloudWatch-metricscollected.html">
-                            For more information click here</ulink>
+                            url="http://docs.amazonwebservices.com/AmazonCloudWatch/latest/DeveloperGuide/arch-AmazonCloudWatch-metricscollected.html">For
+                            more information click here</ulink>
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         <emphasis>Statistics</emphasis> The statistics to be returned for the given
@@ -74,13 +82,15 @@ $return = $ec2_ebs->listMetrics();
                         specify this as a string or as an array of values. If you don't specify one
                         it will default to Average instead of failing out. If you specify an
                         incorrect option it will just skip it. <ulink
-                            url="http://docs.amazonwebservices.com/AmazonCloudWatch/latest/DeveloperGuide/arch-Amazon-CloudWatch-statistics.html">
-                            For more information click here</ulink>
+                            url="http://docs.amazonwebservices.com/AmazonCloudWatch/latest/DeveloperGuide/arch-Amazon-CloudWatch-statistics.html">For
+                            more information click here</ulink>
                     </para>
                 </listitem>
+
                 <listitem>
                     <para><emphasis>Optional:</emphasis></para>
                 </listitem>
+
                 <listitem>
                     <para>
                         <emphasis>Dimensions</emphasis> Amazon CloudWatch allows you to specify one
@@ -89,6 +99,7 @@ $return = $ec2_ebs->listMetrics();
                         given measure name and time range.
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         <emphasis>Unit</emphasis> The standard unit of Measurement for a given
@@ -100,15 +111,18 @@ $return = $ec2_ebs->listMetrics();
                         to always equals one when the unit is count/second.
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         <emphasis>StartTime</emphasis> The timestamp of the first datapoint to
                         return, inclusive. For example, 2008-02-26T19:00:00+00:00. We round your
                         value down to the nearest minute. You can set your start time for more than
                         two weeks in the past. However, you will only get data for the past two
-                        weeks. (in <acronym>ISO</acronym> 8601 format). Constraints: Must be before EndTime.
+                        weeks. (in <acronym>ISO</acronym> 8601 format). Constraints: Must be before
+                        EndTime.
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         <emphasis>EndTime</emphasis> The timestamp to use for determining the last

documentation/manual/en/module_specs/Zend_Service_Amazon_Ec2-Ebs.xml

@@ -12,11 +12,13 @@
         device interface. You can load a file system on top of Amazon EBS volumes,
         or use them just as you would use a block device.
     </para>
+
     <para>
         You can create up to twenty Amazon EBS volumes of any size (from one GiB up
         to one TiB). Each Amazon EBS volume can be attached to any Amazon EC2
         instance in the same Availability Zone or can be left unattached.
     </para>
+
     <para>
         Amazon EBS provides the ability to create snapshots of your Amazon EBS volumes
         to Amazon S3. You can use these snapshots as the starting point for new Amazon
@@ -28,10 +30,12 @@
 
         <example id="zend.service.amazon.ec2.ebs.creating.volume">
             <title>Create a new EBS Volume</title>
+
             <para>
                 Creating a brand new EBS Volume requires the size and which zone you
                 want the EBS Volume to be in.
             </para>
+
             <para>
                 <code>createNewVolume</code> will return an array containing information
                 about the new Volume which includes the volumeId, size, zone, status
@@ -46,13 +50,16 @@ $return = $ec2_ebs->createNewVolume(40, 'us-east-1a');
 
         <example id="zend.service.amazon.ec2.ebs.creating.volumesnapshot">
             <title>Create an EBS Volume from a Snapshot</title>
+
             <para>
                 Creating an EBS Volume from a snapshot requires the snapshot_id and which zone you
                 want the EBS Volume to be in.
             </para>
+
             <para>
-                <code>createVolumeFromSnapshot</code> will return an array containing information about
-                the new Volume which includes the volumeId, size, zone, status, createTime and snapshotId.
+                <code>createVolumeFromSnapshot</code> will return an array containing information
+                about the new Volume which includes the volumeId, size, zone, status, createTime and
+                snapshotId.
             </para>
 
             <programlisting language="php"><![CDATA[
@@ -63,9 +70,11 @@ $return = $ec2_ebs->createVolumeFromSnapshot('snap-78a54011', 'us-east-1a');
 
         <example id="zend.service.amazon.ec2.ebs.creating.snapshot">
             <title>Create a Snapshot of an EBS Volume</title>
+
             <para>
                 Creating a Snapshot of an EBS Volume requires the volumeId of the EBS Volume.
             </para>
+
             <para>
                 <code>createSnapshot</code> will return an array containing information about the
                 new Volume Snapshot which includes the snapshotId, volumeId, status, startTime
@@ -84,18 +93,20 @@ $return = $ec2_ebs->createSnapshot('volumeId');
 
         <example id="zend.service.amazon.ec2.ebs.describing.volume">
             <title>Describing an EBS Volume</title>
+
             <para>
-                <code>describeVolume</code> allows you to get information on an EBS Volume or a set of EBS
-                Volumes. If nothing is passed in then it will return all EBS Volumes. If only
+                <code>describeVolume</code> allows you to get information on an EBS Volume or a set
+                of EBS Volumes. If nothing is passed in then it will return all EBS Volumes. If only
                 one EBS Volume needs to be described a string can be passed in while an array of
                 EBS Volume Id's can be passed in to describe them.
             </para>
+
             <para>
-                <code>describeVolume</code> will return an array with information about each Volume which
-                includes the volumeId, size, status and createTime. If the volume is attached to an instance,
-                an addition value of attachmentSet will be returned. The attachment set contains information
-                about the instance that the EBS Volume is attached to, which includes volumeId, instanceId,
-                device, status and attachTime.
+                <code>describeVolume</code> will return an array with information about each Volume
+                which includes the volumeId, size, status and createTime. If the volume is attached
+                to an instance, an addition value of attachmentSet will be returned. The attachment
+                set contains information about the instance that the EBS Volume is attached to,
+                which includes volumeId, instanceId, device, status and attachTime.
             </para>
 
             <programlisting language="php"><![CDATA[
@@ -106,13 +117,17 @@ $return = $ec2_ebs->describeVolume('volumeId');
 
         <example id="zend.service.amazon.ec2.ebs.describing.attachedvolumes">
             <title>Describe Attached Volumes</title>
+
             <para>
-                To return a list of EBS Volumes currently attached to a running instance you can call this method.
-                It will only return EBS Volumes attached to the instance with the passed in instanceId.
+                To return a list of EBS Volumes currently attached to a running instance you can
+                call this method. It will only return EBS Volumes attached to the instance with the
+                passed in instanceId.
             </para>
+
             <para>
-                <code>describeAttachedVolumes</code> returns the same information as the <code>describeVolume</code>
-                but only for the EBS Volumes that are currently attached to the specified instanceId.
+                <code>describeAttachedVolumes</code> returns the same information as the
+                <code>describeVolume</code> but only for the EBS Volumes that are currently attached
+                to the specified instanceId.
             </para>
 
             <programlisting language="php"><![CDATA[
@@ -123,16 +138,19 @@ $return = $ec2_ebs->describeAttachedVolumes('instanceId');
 
         <example id="zend.service.amazon.ec2.ebs.describing.snapshot">
             <title>Describe an EBS Volume Snapshot</title>
+
             <para>
-                <code>describeSnapshot</code> allows you to get information on an EBS Volume Snapshot
-                or a set of EBS Volume Snapshots. If nothing is passed in then it will return information
-                about all EBS Volume Snapshots. If only one EBS Volume Snapshot needs to be described its
-                snapshotId can be passed in while an array of EBS Volume Snapshot Id's can be passed in to
-                describe them.
+                <code>describeSnapshot</code> allows you to get information on an EBS Volume
+                Snapshot or a set of EBS Volume Snapshots. If nothing is passed in then it will
+                return information about all EBS Volume Snapshots. If only one EBS Volume Snapshot
+                needs to be described its snapshotId can be passed in while an array of EBS Volume
+                Snapshot Id's can be passed in to describe them.
             </para>
+
             <para>
-                <code>describeSnapshot</code> will return an array containing information about each EBS Volume Snapshot
-                which includes the snapshotId, volumeId, status, startTime and progress.
+                <code>describeSnapshot</code> will return an array containing information about each
+                EBS Volume Snapshot which includes the snapshotId, volumeId, status, startTime and
+                progress.
             </para>
 
             <programlisting language="php"><![CDATA[
@@ -147,11 +165,13 @@ $return = $ec2_ebs->describeSnapshot('volumeId');
 
         <example id="zend.service.amazon.ec2.ebs.attachdetach.attach">
             <title>Attaching an EBS Volume</title>
+
             <para>
                 <code>attachVolume</code> will attach an EBS Volume to a running Instance. To
                 attach a volume you need to specify the volumeId, the instanceId and the
                 device <emphasis>(ex: /dev/sdh)</emphasis>.
             </para>
+
             <para>
                 <code>attachVolume</code> will return an array with information about the
                 attach status which contains volumeId, instanceId, device, status and
@@ -185,8 +205,10 @@ $ec2_ebs = new Zend_Service_Amazon_Ec2_Ebs('aws_key','aws_secret_key');
 $return = $ec2_ebs->detachVolume('volumeId');
 ]]></programlisting>
         </example>
+
         <note>
             <title>Forced Detach</title>
+
             <para>
                 You should only force a detach if the previous detachment attempt did not occur
                 cleanly (logging into an instance, unmounting the volume, and detaching normally).
@@ -204,6 +226,7 @@ $return = $ec2_ebs->detachVolume('volumeId');
 
         <example id="zend.service.amazon.ec2.ebs.deleting.volume">
             <title>Deleting an EBS Volume</title>
+
             <para>
                 <code>deleteVolume</code> will delete an unattached EBS Volume.
             </para>

documentation/manual/en/module_specs/Zend_Service_Amazon_Ec2-Elasticip.xml

@@ -28,9 +28,11 @@
 
     <example id="zend.service.amazon.ec2.elasticip.allocate">
         <title>Allocating a new Elastic IP</title>
+
         <para>
             <code>allocate</code> will assign your account a new Elastic IP Address.
         </para>
+
         <para>
             <code>allocate</code> returns the newly allocated ip.
         </para>
@@ -46,11 +48,13 @@ print $ip;
 
     <example id="zend.service.amazon.ec2.elasticip.describe">
         <title>Describing Allocated Elastic IP Addresses</title>
+
         <para>
             <code>describe</code> has an optional paramater to describe all
             of your allocated Elastic IP addresses or just some of your
             allocated addresses.
         </para>
+
         <para>
             <code>describe</code> returns an array that contains information on each Elastic IP
             Address which contains the publicIp and the instanceId if it is assocated.
@@ -71,6 +75,7 @@ $ip = $ec2_eip->describe('ip1');
 
     <example id="zend.service.amazon.ec2.elasticip.release">
         <title>Releasing Elastic IP</title>
+
         <para>
             <code>release</code> will release an Elastic IP to Amazon.
         </para>
@@ -87,6 +92,7 @@ $ec2_eip->release('ipaddress');
 
     <example id="zend.service.amazon.ec2.elasticip.associate">
         <title>Associates an Elastic IP to an Instance</title>
+
         <para>
             <code>associate</code> will assign an Elastic IP to an
             already running instance.
@@ -104,6 +110,7 @@ $ec2_eip->associate('instance_id', 'ipaddress');
 
     <example id="zend.service.amazon.ec2.elasticip.disassociate">
         <title>Disassociate an Elastic IP from an instance</title>
+
         <para>
             <code>disassociate</code> will disassociate an Elastic IP from an instance.
             If you terminate an Instance it will automaticly disassociate the Elastic
@@ -119,5 +126,4 @@ $ec2_eip = new Zend_Service_Amazon_Ec2_Elasticip('aws_key','aws_secret_key');
 $ec2_eip->disassociate('ipaddress');
 ]]></programlisting>
     </example>
-
-</sect1>
+</sect1>

documentation/manual/en/module_specs/Zend_Service_Amazon_Ec2-Instance.xml

@@ -17,6 +17,7 @@
             database instances. Additionally, you might want to run <acronym>CPU</acronym> instance
             types for <acronym>CPU</acronym>-intensive data processing tasks.
         </para>
+
         <para>
             One of the advantages of EC2 is that you pay by the instance hour,
             which makes it convenient and inexpensive to test the performance of
@@ -27,13 +28,16 @@
 
         <note>
             <title>Instance Types</title>
+
             <para>
                 The instance types are defined as constants in the code. Column eight
                 in the table is the defined constant name
             </para>
         </note>
+
         <table id="zend.service.amazon.ec2.instance.types-table">
             <title>Available Instance Types</title>
+
             <tgroup cols="8">
                 <thead>
                     <row>
@@ -47,126 +51,127 @@
                         <entry>Constant Name</entry>
                     </row>
                 </thead>
+
                 <tbody>
                     <row>
                         <entry><code>Small</code></entry>
-                        <entry><para>
-                            1 <constant>EC2</constant> Compute Unit (1 virtual core with 1 <constant>EC2</constant>
-                            Compute Unit)
-                        </para></entry>
-                        <entry><para>
-                            1.7 GB
-                        </para></entry>
-                        <entry><para>
-                            160 GB instance storage (150 GB plus 10 GB root
-                            partition)
-                        </para></entry>
-                        <entry><para>
-                            32-bit
-                        </para></entry>
-                        <entry><para>
-                            Moderate
-                        </para></entry>
-                        <entry><para>
-                            m1.small
-                        </para></entry>
+
+                        <entry>
+                            <para>
+                                1 <constant>EC2</constant> Compute Unit (1 virtual core with 1
+                                <constant>EC2</constant> Compute Unit)
+                            </para>
+                        </entry>
+
+                        <entry><para>1.7 GB</para></entry>
+
+                        <entry>
+                            <para>160 GB instance storage (150 GB plus 10 GB root partition)</para>
+                        </entry>
+
+                        <entry><para>32-bit</para></entry>
+                        <entry><para>Moderate</para></entry>
+                        <entry><para>m1.small</para></entry>
                         <entry><constant>Zend_Service_Amazon_Ec2_Instance::SMALL</constant></entry>
                     </row>
+
                     <row>
                         <entry><code>Large</code></entry>
-                        <entry><para>
-                            4 <constant>EC2</constant> Compute Units (2 virtual cores with 2 <constant>EC2</constant>
-                            Compute Units each)
-                        </para></entry>
-                        <entry><para>
-                            7.5 GB
-                        </para></entry>
-                        <entry><para>
-                            850 GB instance storage (2 x 420 GB plus 10
-                            GB root partition)
-                        </para></entry>
-                        <entry><para>
-                            64-bit
-                        </para></entry>
-                        <entry><para>
-                            High
-                        </para></entry>
-                        <entry><para>
-                            m1.large
-                        </para></entry>
+
+                        <entry>
+                            <para>
+                                4 <constant>EC2</constant> Compute Units (2 virtual cores with 2
+                                <constant>EC2</constant> Compute Units each)
+                            </para>
+                        </entry>
+
+                        <entry><para>7.5 GB</para></entry>
+
+                        <entry>
+                            <para>
+                                850 GB instance storage (2 x 420 GB plus 10 GB root partition)
+                            </para>
+                        </entry>
+
+                        <entry><para>64-bit</para></entry>
+                        <entry><para>High</para></entry>
+                        <entry><para>m1.large</para></entry>
                         <entry><constant>Zend_Service_Amazon_Ec2_Instance::LARGE</constant></entry>
                     </row>
+
                     <row>
                         <entry><code>Extra Large</code></entry>
-                        <entry><para>
-                            8 <constant>EC2</constant> Compute Units (4 virtual cores with 2 <constant>EC2</constant>
-                            Compute Units each)
-                        </para></entry>
-                        <entry><para>
-                            15 GB
-                        </para></entry>
-                        <entry><para>
-                            1,690 GB instance storage (4 x 420 GB plus 10
-                            GB root partition)
-                        </para></entry>
-                        <entry><para>
-                            64-bit
-                        </para></entry>
-                        <entry><para>
-                            High
-                        </para></entry>
-                        <entry><para>
-                            m1.xlarge
-                        </para></entry>
+                        <entry>
+                            <para>
+                                8 <constant>EC2</constant> Compute Units (4 virtual cores with 2
+                                <constant>EC2</constant> Compute Units each)
+                            </para>
+                        </entry>
+
+                        <entry><para>15 GB</para></entry>
+
+                        <entry>
+                            <para>
+                                1,690 GB instance storage (4 x 420 GB plus 10 GB root partition)
+                            </para>
+                        </entry>
+
+                        <entry><para>64-bit</para></entry>
+                        <entry><para>High</para></entry>
+                        <entry><para>m1.xlarge</para></entry>
                         <entry><constant>Zend_Service_Amazon_Ec2_Instance::XLARGE</constant></entry>
                     </row>
+
                     <row>
                         <entry><code>High-CPU Medium</code></entry>
-                        <entry><para>
-                            5 <constant>EC2</constant> Compute Units (2 virtual cores with 2.5 <constant>EC2</constant>
-                            Compute Units each)
-                        </para></entry>
-                        <entry><para>
-                            1.7 GB
-                        </para></entry>
-                        <entry><para>
-                            350 GB instance storage (340 GB plus 10
-                            GB root partition)
-                        </para></entry>
-                        <entry><para>
-                            32-bit
-                        </para></entry>
-                        <entry><para>
-                            Moderate
-                        </para></entry>
-                        <entry><para>
-                            c1.medium
-                        </para></entry>
-                        <entry><constant>Zend_Service_Amazon_Ec2_Instance::HCPU_MEDIUM</constant></entry>
+
+                        <entry>
+                            <para>
+                                5 <constant>EC2</constant> Compute Units (2 virtual cores with 2.5
+                                <constant>EC2</constant> Compute Units each)
+                            </para>
+                        </entry>
+
+                        <entry><para>1.7 GB</para></entry>
+
+                        <entry>
+                            <para>350 GB instance storage (340 GB plus 10 GB root partition)</para>
+                        </entry>
+
+                        <entry><para>32-bit</para></entry>
+                        <entry><para>Moderate</para></entry>
+                        <entry><para>c1.medium</para></entry>
+
+                        <entry>
+                            <constant>Zend_Service_Amazon_Ec2_Instance::HCPU_MEDIUM</constant>
+                        </entry>
                     </row>
+
                     <row>
                         <entry><code>High-CPU Extra Large</code></entry>
-                        <entry><para>
-                            20 <constant>EC2</constant> Compute Units (8 virtual cores with 2.5 <constant>EC2</constant>
-                            Compute Units each)
-                        </para></entry>
-                        <entry><para>
-                            7 GB
-                        </para></entry>
-                        <entry><para>
-                            1,690 GB instance storage (4 x 420 GB plus 10
-                            GB root partition)
-                        </para></entry>
-                        <entry><para>
-                            64-bit
-                        </para></entry>
-                        <entry><para>
-                            High
-                        </para></entry>
-                        <entry><para>
-                            c1.xlarge
-                        </para></entry>
-                        <entry><constant>Zend_Service_Amazon_Ec2_Instance::HCPU_XLARGE</constant></entry>
+
+                        <entry>
+                            <para>
+                                20 <constant>EC2</constant> Compute Units (8 virtual cores with 2.5
+                                <constant>EC2</constant> Compute Units each)
+                            </para>
+                        </entry>
+
+                        <entry><para>7 GB</para></entry>
+
+                        <entry>
+                            <para>
+                                1,690 GB instance storage (4 x 420 GB plus 10 GB root partition)
+                            </para>
+                        </entry>
+
+                        <entry><para>64-bit</para></entry>
+                        <entry><para>High</para></entry>
+                        <entry><para>c1.xlarge</para></entry>
+
+                        <entry>
+                            <constant>Zend_Service_Amazon_Ec2_Instance::HCPU_XLARGE</constant>
+                        </entry>
                     </row>
                 </tbody>
             </tgroup>
@@ -175,139 +180,208 @@
 
     <sect2 id="zend.service.amazon.ec2.instance.operations">
         <title>Running Amazon EC2 Instances</title>
+
         <para>
             This section describes the operation methods for maintaining Amazon EC2 Instances.
         </para>
 
         <example id="zend.service.amazon.ec2.instance.operations.run">
             <title>Starting New Ec2 Instances</title>
+
             <para>
                 <code>run</code> will launch a specified number of EC2 Instances.
                 <code>run</code> takes an array of parameters to start, below is a table
                 containing the valid values.
             </para>
+
             <para>
-            <table id="zend.service.amazon.ec2.instance.operations.run-table">
-                <title>Valid Run Options</title>
-                <tgroup cols="3">
-                    <thead>
-                        <row>
-                            <entry>Name</entry>
-                            <entry>Description</entry>
-                            <entry>Required</entry>
-                        </row>
-                    </thead>
-                    <tbody>
-                        <row>
-                            <entry><code>imageId</code></entry>
-                            <entry><para>
-                                ID of the <acronym>AMI</acronym> with which to launch instances.
-                            </para></entry>
-                            <entry><para>Yes</para></entry>
-                        </row>
-                        <row>
-                            <entry><code>minCount</code></entry>
-                            <entry><para>
-                                Minimum number of instances to launch. Default: 1
-                            </para></entry>
-                            <entry><para>No</para></entry>
-                        </row>
-                        <row>
-                            <entry><code>maxCount</code></entry>
-                            <entry><para>
-                                Maximum number of instances to launch. Default: 1
-                            </para></entry>
-                            <entry><para>No</para></entry>
-                        </row>
-                        <row>
-                            <entry><code>keyName</code></entry>
-                            <entry><para>
-                                Name of the key pair with which to launch instances.
-                                If you do not provide a key, all instances will
-                                be inaccessible.
-                            </para></entry>
-                            <entry><para>No</para></entry>
-                        </row>
-                        <row>
-                            <entry><code>securityGroup</code></entry>
-                            <entry><para>
-                                Names of the security groups with which to associate
-                                the instances.
-                            </para></entry>
-                            <entry><para>No</para></entry>
-                        </row>
-                        <row>
-                            <entry><code>userData</code></entry>
-                            <entry><para>
-                                The user data available to the launched instances.
-                                This should not be Base64 encoded.
-                            </para></entry>
-                            <entry><para>No</para></entry>
-                        </row>
-                        <row>
-                            <entry><code>instanceType</code></entry>
-                            <entry><para>
-                                Specifies the instance type. Default: m1.small
-                            </para></entry>
-                            <entry><para>No</para></entry>
-                        </row>
-                        <row>
-                            <entry><code>placement</code></entry>
-                            <entry><para>
-                                Specifies the availability zone in which to
-                                launch the instance(s). By default, Amazon
-                                <constant>EC2</constant> selects an availability zone for you.
-                            </para></entry>
-                            <entry><para>No</para></entry>
-                        </row>
-                        <row>
-                            <entry><code>kernelId</code></entry>
-                            <entry><para>
-                                The ID of the kernel with which to launch
-                                the instance.
-                            </para></entry>
-                            <entry><para>No</para></entry>
-                        </row>
-                        <row>
-                            <entry><code>ramdiskId</code></entry>
-                            <entry><para>
-                                The ID of the <acronym>RAM</acronym> disk with which to launch
-                                the instance.
-                            </para></entry>
-                            <entry><para>No</para></entry>
-                        </row>
-                        <row>
-                            <entry><code>blockDeviceVirtualName</code></entry>
-                            <entry><para>
-                                Specifies the virtual name to map to the
-                                corresponding device name. For example:
-                                instancestore0
-                            </para></entry>
-                            <entry><para>No</para></entry>
-                        </row>
-                        <row>
-                            <entry><code>blockDeviceName</code></entry>
-                            <entry><para>
-                                 Specifies the device to which you are
-                                 mapping a virtual name. For example: sdb
-                            </para></entry>
-                            <entry><para>No</para></entry>
-                        </row>
-                        <row>
-                            <entry><code>monitor</code></entry>
-                            <entry><para>
-                                 Turn on <acronym>AWS</acronym> CloudWatch Instance Monitoring
-                            </para></entry>
-                            <entry><para>No</para></entry>
-                        </row>
-                    </tbody>
-                </tgroup>
-            </table>
+                <table id="zend.service.amazon.ec2.instance.operations.run-table">
+                    <title>Valid Run Options</title>
+
+                    <tgroup cols="3">
+                        <thead>
+                            <row>
+                                <entry>Name</entry>
+                                <entry>Description</entry>
+                                <entry>Required</entry>
+                            </row>
+                        </thead>
+
+                        <tbody>
+                            <row>
+                                <entry><code>imageId</code></entry>
+
+                                <entry>
+                                    <para>
+                                        ID of the <acronym>AMI</acronym> with which to launch
+                                        instances.
+                                    </para>
+                                </entry>
+
+                                <entry><para>Yes</para></entry>
+                            </row>
+
+                            <row>
+                                <entry><code>minCount</code></entry>
+
+                                <entry>
+                                    <para>Minimum number of instances to launch. Default: 1</para>
+                                </entry>
+
+                                <entry><para>No</para></entry>
+                            </row>
+
+                            <row>
+                                <entry><code>maxCount</code></entry>
+
+                                <entry>
+                                    <para>Maximum number of instances to launch. Default: 1</para>
+                                </entry>
+
+                                <entry><para>No</para></entry>
+                            </row>
+
+                            <row>
+                                <entry><code>keyName</code></entry>
+
+                                <entry>
+                                    <para>
+                                        Name of the key pair with which to launch instances.
+                                        If you do not provide a key, all instances will
+                                        be inaccessible.
+                                    </para>
+                                </entry>
+
+                                <entry><para>No</para></entry>
+                            </row>
+
+                            <row>
+                                <entry><code>securityGroup</code></entry>
+
+                                <entry>
+                                    <para>
+                                        Names of the security groups with which to associate
+                                        the instances.
+                                    </para>
+                                </entry>
+
+                                <entry><para>No</para></entry>
+                            </row>
+
+                            <row>
+                                <entry><code>userData</code></entry>
+
+                                <entry>
+                                    <para>
+                                        The user data available to the launched instances.
+                                        This should not be Base64 encoded.
+                                    </para>
+                                </entry>
+
+                                <entry><para>No</para></entry>
+                            </row>
+
+                            <row>
+                                <entry><code>instanceType</code></entry>
+
+                                <entry>
+                                    <para>
+                                        Specifies the instance type. Default: m1.small
+                                    </para>
+                                </entry>
+
+                                <entry><para>No</para></entry>
+                            </row>
+
+                            <row>
+                                <entry><code>placement</code></entry>
+
+                                <entry>
+                                    <para>
+                                        Specifies the availability zone in which to
+                                        launch the instance(s). By default, Amazon
+                                        <constant>EC2</constant> selects an availability zone for
+                                        you.
+                                    </para>
+                                </entry>
+
+                                <entry><para>No</para></entry>
+                            </row>
+
+                            <row>
+                                <entry><code>kernelId</code></entry>
+
+                                <entry>
+                                    <para>
+                                        The ID of the kernel with which to launch
+                                        the instance.
+                                    </para>
+                                </entry>
+
+                                <entry><para>No</para></entry>
+                            </row>
+
+                            <row>
+                                <entry><code>ramdiskId</code></entry>
+
+                                <entry>
+                                    <para>
+                                        The ID of the <acronym>RAM</acronym> disk with which to
+                                        launch the instance.
+                                    </para>
+                                </entry>
+
+                                <entry><para>No</para></entry>
+                            </row>
+
+                            <row>
+                                <entry><code>blockDeviceVirtualName</code></entry>
+
+                                <entry>
+                                    <para>
+                                        Specifies the virtual name to map to the
+                                        corresponding device name. For example:
+                                        instancestore0
+                                    </para>
+                                </entry>
+
+                                <entry><para>No</para></entry>
+                            </row>
+
+                            <row>
+                                <entry><code>blockDeviceName</code></entry>
+
+                                <entry>
+                                    <para>
+                                         Specifies the device to which you are
+                                         mapping a virtual name. For example: sdb
+                                    </para>
+                                </entry>
+
+                                <entry><para>No</para></entry>
+                            </row>
+                            <row>
+                                <entry><code>monitor</code></entry>
+
+                                <entry>
+                                    <para>
+                                         Turn on <acronym>AWS</acronym> CloudWatch Instance
+                                         Monitoring
+                                    </para>
+                                </entry>
+
+                                <entry><para>No</para></entry>
+                            </row>
+                        </tbody>
+                    </tgroup>
+                </table>
             </para>
+
             <para>
                 <code>run</code> will return information about each instance
                 that is starting up.
             </para>
+
             <programlisting language="php"><![CDATA[
 $ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                      'aws_secret_key');
@@ -316,34 +390,37 @@ $return = $ec2_instance->run(array('imageId' => 'ami-509320',
                                    'securityGroup' => array('web',
                                                             'default')));
 ]]></programlisting>
-
         </example>
 
         <example id="zend.service.amazon.ec2.instance.operations.reboot">
             <title>Rebooting an Ec2 Instances</title>
+
             <para>
                 <code>reboot</code> will reboot one or more instances.
             </para>
+
             <para>
                 This operation is asynchronous; it only queues a request to
                 reboot the specified instance(s). The operation will succeed
                 if the instances are valid and belong to the user. Requests
                 to reboot terminated instances are ignored.
             </para>
+
             <para>
                 <code>reboot</code> returns boolean <constant>TRUE</constant> or
                 <constant>FALSE</constant>
             </para>
+
             <programlisting language="php"><![CDATA[
 $ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                      'aws_secret_key');
 $return = $ec2_instance->reboot('instanceId');
 ]]></programlisting>
-
         </example>
 
         <example id="zend.service.amazon.ec2.instance.operations.terminate">
             <title>Terminating an Ec2 Instances</title>
+
             <para>
                 <code>terminate</code> shuts down one or more instances. This
                 operation is idempotent; if you terminate an instance more
@@ -361,6 +438,7 @@ $ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
 $return = $ec2_instance->terminate('instanceId');
 ]]></programlisting>
         </example>
+
         <note>
             <title>Terminated Instances</title>
             <para>Terminated instances will remain visible after termination
@@ -370,6 +448,7 @@ $return = $ec2_instance->terminate('instanceId');
 
     <sect2 id="zend.service.amazon.ec2.instance.utility">
         <title>Amazon Instance Utilities</title>
+
         <para>
             In this section you will find out how to retreive information, the console
             output and see if an instance contains a product code.
@@ -377,9 +456,11 @@ $return = $ec2_instance->terminate('instanceId');
 
         <example id="zend.service.amazon.ec2.instance.utility.describe">
             <title>Describing Instances</title>
+
             <para>
                 <code>describe</code> returns information about instances that you own.
             </para>
+
             <para>
                 If you specify one or more instance IDs, Amazon EC2 returns information
                 for those instances. If you do not specify instance IDs, Amazon EC2
@@ -387,10 +468,12 @@ $return = $ec2_instance->terminate('instanceId');
                 instance ID, a fault is returned. If you specify an instance that you do
                 not own, it will not be included in the returned results.
             </para>
+
             <para>
                 <code>describe</code> will return an array containing information on the
                 instance.
             </para>
+
             <programlisting language="php"><![CDATA[
 $ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                      'aws_secret_key');
@@ -411,14 +494,17 @@ $return = $ec2_instance->describe('instanceId');
 
         <example id="zend.service.amazon.ec2.instance.utility.describebyimageid">
             <title>Describing Instances By Image Id</title>
+
             <para>
                 <code>describeByImageId</code> is functionally the same as <code>describe</code>
                 but it will only return the instances that are using the provided imageId.
             </para>
+
             <para>
                 <code>describeByImageId</code> will return an array containing information on the
                 instances thare were started by the passed in imageId
             </para>
+
             <programlisting language="php"><![CDATA[
 $ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                      'aws_secret_key');
@@ -426,41 +512,44 @@ $return = $ec2_instance->describeByImageId('imageId');
 ]]></programlisting>
         </example>
 
-            <note>
-                <title>Terminated Instances</title>
+        <note>
+            <title>Terminated Instances</title>
 
-                <para>
-                    Recently terminated instances might appear in the returned results. This
-                    interval is usually less than one hour. If you do not want terminated
-                    instances to be returned, pass in a second variable of boolean
-                    <constant>TRUE</constant> to <code>describe</code> and the terminated instances
-                    will be ignored.
-                </para>
-            </note>
+            <para>
+                Recently terminated instances might appear in the returned results. This
+                interval is usually less than one hour. If you do not want terminated
+                instances to be returned, pass in a second variable of boolean
+                <constant>TRUE</constant> to <code>describe</code> and the terminated instances
+                will be ignored.
+            </para>
+        </note>
 
         <example id="zend.service.amazon.ec2.instance.utility.consoleOutput">
             <title>Retreiving Console Output</title>
+
             <para>
                 <code>consoleOutput</code> retrieves console output for the specified
                 instance.
             </para>
+
             <para>
                 Instance console output is buffered and posted shortly after instance
                 boot, reboot, and termination. Amazon EC2 preserves the most recent
                 64 KB output which will be available for at least one hour after the
                 most recent post.
             </para>
+
             <para>
                 <code>consoleOutput</code> returns an array containing the
                 <code>instanceId</code>, <code>timestamp</code> from the last output
                 and the <code>output</code> from the console.
             </para>
+
             <programlisting language="php"><![CDATA[
 $ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                      'aws_secret_key');
 $return = $ec2_instance->consoleOutput('instanceId');
 ]]></programlisting>
-
         </example>
 
         <example id="zend.service.amazon.ec2.instance.utility.confirmproduct">
@@ -483,37 +572,38 @@ $ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                      'aws_secret_key');
 $return = $ec2_instance->confirmProduct('productCode', 'instanceId');
 ]]></programlisting>
-
         </example>
 
         <example id="zend.service.amazon.ec2.instance.utility.monitor">
             <title>Turn on CloudWatch Monitoring on an Instance(s)</title>
+
             <para>
                 <code>monitor</code> returns the list of instances and their
                 current state of the CloudWatch Monitoring. If the instance
                 does not currently have Monitoring enabled it will be turned on.
             </para>
+
             <programlisting language="php"><![CDATA[
 $ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                      'aws_secret_key');
 $return = $ec2_instance->monitor('instanceId');
 ]]></programlisting>
-
         </example>
 
         <example id="zend.service.amazon.ec2.instance.utility.unmonitor">
             <title>Turn off CloudWatch Monitoring on an Instance(s)</title>
+
             <para>
                 <code>monitor</code> returns the list of instances and their
                 current state of the CloudWatch Monitoring. If the instance
                 currently has Monitoring enabled it will be turned off.
             </para>
+
             <programlisting language="php"><![CDATA[
 $ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                      'aws_secret_key');
 $return = $ec2_instance->unmonitor('instanceId');
 ]]></programlisting>
-
         </example>
     </sect2>
-</sect1>
+</sect1>

documentation/manual/en/module_specs/Zend_Service_Amazon_Ec2-Keypair.xml

@@ -2,21 +2,25 @@
 <!-- Reviewed: no -->
 <sect1 id="zend.service.amazon.ec2.keypairs">
     <title>Zend_Service_Amazon_Ec2: Keypairs</title>
+
     <para>
         Keypairs are used to access instances.
     </para>
 
     <example id="zend.service.amazon.ec2.keypairs.create">
         <title>Creating a new Amazon Keypair</title>
+
         <para>
             <code>create</code>, creates a new 2048 bit RSA key pair and
             returns a unique ID that can be used to reference this key
             pair when launching new instances.
         </para>
+
         <para>
             <code>create</code> returns an array which contains the keyName,
             keyFingerprint and keyMaterial.
         </para>
+
         <programlisting language="php"><![CDATA[
 $ec2_kp = new Zend_Service_Amazon_Ec2_Keypair('aws_key','aws_secret_key');
 $return = $ec2_kp->create('my-new-key');
@@ -25,6 +29,7 @@ $return = $ec2_kp->create('my-new-key');
 
     <example id="zend.service.amazon.ec2.keypairs.delete">
         <title>Deleting an Amazon Keypair</title>
+
         <para>
             <code>delete</code>, will delete the key pair. This will only
             prevent it from being used with new instances. Instances currently
@@ -44,17 +49,20 @@ $return = $ec2_kp->delete('my-new-key');
 
     <example id="zend.service.amazon.ec2.describe">
         <title>Describe an Amazon Keypair</title>
+
         <para>
             <code>describe</code> returns information about key pairs available to you.
             If you specify key pairs, information about those key pairs is returned. Otherwise,
             information for all registered key pairs is returned.
         </para>
+
         <para>
             <code>describe</code> returns an array which contains keyName and keyFingerprint
         </para>
+
         <programlisting language="php"><![CDATA[
 $ec2_kp = new Zend_Service_Amazon_Ec2_Keypair('aws_key','aws_secret_key');
 $return = $ec2_kp->describe('my-new-key');
 ]]></programlisting>
     </example>
-</sect1>
+</sect1>

documentation/manual/en/module_specs/Zend_Service_Amazon_Ec2-RegionsAndAvalibilityZones.xml

@@ -16,12 +16,14 @@
 
     <sect2 id="zend.service.amazon.ec2.zones.regions">
         <title>Amazon EC2 Regions</title>
+
         <para>
             Amazon EC2 provides multiple regions so you can launch Amazon EC2
             instances in locations that meet your requirements. For example,
             you might want to launch instances in Europe to be closer to your
             European customers or to meet legal requirements.
         </para>
+
         <para>
             Each Amazon EC2 region is designed to be completely isolated from
             the other Amazon EC2 regions. This achieves the greatest possible
@@ -31,12 +33,14 @@
 
         <example id="zend.service.amazon.ec2.zones.regions.example">
             <title>Viewing the available regions</title>
+
             <para>
                 <code>describe</code> is used to find out which regions your account has access to.
             </para>
+
             <para>
-                <code>describe</code> will return an array containing information about which regions
-                are available. Each array will contain regionName and regionUrl.
+                <code>describe</code> will return an array containing information about which
+                regions are available. Each array will contain regionName and regionUrl.
             </para>
 
             <programlisting language="php"><![CDATA[
@@ -52,6 +56,7 @@ foreach($regions as $region) {
 
     <sect2 id="zend.service.amazon.ec2.zones.availability">
         <title>Amazon EC2 Availability Zones</title>
+
         <para>
             When you launch an instance, you can optionally specify an Availability
             Zone. If you do not specify an Availability Zone, Amazon EC2 selects one
@@ -66,10 +71,12 @@ foreach($regions as $region) {
 
         <example id="zend.service.amazon.ec2.zones.availability.example">
             <title>Viewing the available zones</title>
+
             <para>
                 <code>describe</code> is used to find out which what the status is of each
                 availability zone.
             </para>
+
             <para>
                 <code>describe</code> will return an array containing information about which zones
                 are available. Each array will contain zoneName and zoneState.
@@ -86,4 +93,4 @@ foreach($zones as $zone) {
 ]]></programlisting>
         </example>
     </sect2>
-</sect1>
+</sect1>

documentation/manual/en/module_specs/Zend_Service_Amazon_Ec2-ReservedInstance.xml

@@ -8,6 +8,7 @@
         for each instance to reserve and receive a significant discount on the hourly
         usage charge for that instance.
     </para>
+
     <para>
         Amazon <acronym>EC2</acronym> Reserved Instances are based on instance type and location
         (region and Availability Zone) for a specified period of time (e.g.,
@@ -16,36 +17,45 @@
 
     <sect2 id="zend.service.amazon.ec2.reserved.instance.howitworks">
         <title>How Reserved Instances are Applied</title>
+
         <para>
             Reserved Instances are applied to instances that meet the type/location
             criteria during the specified period. In this example, a user is running
             the following instances:
         </para>
+
         <itemizedlist>
             <listitem>
                 <para>(4) m1.small instances in Availability Zone us-east-1a</para>
             </listitem>
+
             <listitem>
                 <para>(4) c1.medium instances in Availability Zone us-east-1b</para>
             </listitem>
+
             <listitem>
                 <para>(2) c1.xlarge instances in Availability Zone us-east-1b</para>
             </listitem>
         </itemizedlist>
+
         <para>
             The user then purchases the following Reserved Instances.
         </para>
+
         <itemizedlist>
             <listitem>
                 <para>(2) m1.small instances in Availability Zone us-east-1a</para>
             </listitem>
+
             <listitem>
                 <para>(2) c1.medium instances in Availability Zone us-east-1a</para>
             </listitem>
+
             <listitem>
                 <para>(2) m1.xlarge instances in Availability Zone us-east-1a</para>
             </listitem>
         </itemizedlist>
+
         <para>
             Amazon <acronym>EC2</acronym> applies the two m1.small Reserved Instances to two of the
             instances in Availability Zone us-east-1a. Amazon <acronym>EC2</acronym> doesn't apply
@@ -57,27 +67,31 @@
 
     <sect2 id="zend.service.amazon.ec2.reserved.instance.operations">
         <title>Reserved Instances Usage</title>
+
         <example id="zend.service.amazon.ec2.reserved.instance.operations.describe">
             <title>Describes Reserved Instances that you purchased</title>
+
             <para>
                 <methodname>describeInstances()</methodname> will return information about a
                 reserved instance or instances that you purchased.
             </para>
+
             <para>
                 <methodname>describeInstances()</methodname> returns a multi-demential array that
                 contains reservedInstancesId, instanceType, availabilityZone, duration, fixedPrice,
                 usagePrice, productDescription, instanceCount and state.
             </para>
+
             <programlisting language="php"><![CDATA[
 $ec2_instance = new Zend_Service_Amazon_Ec2_Instance_Reserved('aws_key',
                                                      'aws_secret_key');
 $return = $ec2_instance->describeInstances('instanceId');
 ]]></programlisting>
-
         </example>
 
         <example id="zend.service.amazon.ec2.reserved.instance.offerings.describe">
             <title>Describe current Reserved Instance Offerings available</title>
+
             <para>
                 <methodname>describeOfferings()</methodname> Describes Reserved Instance offerings
                 that are available for purchase. With Amazon <acronym>EC2</acronym> Reserved
@@ -85,11 +99,13 @@ $return = $ec2_instance->describeInstances('instanceId');
                 for a period of time (without getting insufficient capacity errors) and pay a lower
                 usage rate for the actual time used.
             </para>
+
             <para>
                 <methodname>describeOfferings()</methodname> returns a multi-demential array that
                 contains reservedInstancesId, instanceType, availabilityZone, duration, fixedPrice,
                 usagePrice and productDescription.
             </para>
+
             <programlisting language="php"><![CDATA[
 $ec2_instance = new Zend_Service_Amazon_Ec2_Instance_Reserved('aws_key',
                                                      'aws_secret_key');
@@ -99,6 +115,7 @@ $return = $ec2_instance->describeOfferings();
 
         <example id="zend.service.amazon.ec2.reserved.instance.offerings.purchase">
             <title>Turn off CloudWatch Monitoring on an Instance(s)</title>
+
             <para>
                 <methodname>purchaseOffering()</methodname> Purchases a Reserved Instance for use
                 with your account. With Amazon <acronym>EC2</acronym> Reserved Instances, you
@@ -106,15 +123,16 @@ $return = $ec2_instance->describeOfferings();
                 of time (without getting insufficient capacity errors) and pay a lower usage rate
                 for the actual time used.
             </para>
+
             <para>
                 <methodname>purchaseOffering()</methodname> returns the reservedInstanceId.
             </para>
+
             <programlisting language="php"><![CDATA[
 $ec2_instance = new Zend_Service_Amazon_Ec2_Instance_Reserved('aws_key',
                                                      'aws_secret_key');
 $return = $ec2_instance->purchaseOffering('offeringId', 'instanceCount');
 ]]></programlisting>
-
         </example>
     </sect2>
 </sect1>

documentation/manual/en/module_specs/Zend_Service_Amazon_Ec2.xml

@@ -5,52 +5,64 @@
 
     <sect2 id="zend.service.amazon.ec2.introduction">
         <title>Introduction</title>
+
         <para>
             <classname>Zend_Service_Amazon_Ec2</classname> provides an interface to Amazon Elastic
             Clound Computing (EC2).
         </para>
     </sect2>
+
     <sect2 id="zend.service.amazon.ec2.whatis">
         <title>What is Amazon Ec2?</title>
+
         <para>
-            Amazon EC2 is a web service that enables you to launch and manage server instances
-            in Amazon's data centers using <acronym>API</acronym>s or available tools and utilities. You can use
-            Amazon EC2 server instances at any time, for as long as you need, and for any legal
-            purpose.
+            Amazon EC2 is a web service that enables you to launch and manage server instances in
+            Amazon's data centers using <acronym>API</acronym>s or available tools and utilities.
+            You can use Amazon EC2 server instances at any time, for as long as you need, and for
+            any legal purpose.
         </para>
     </sect2>
+
     <sect2 id="zend.service.amazon.ec2.staticmethods">
         <title>Static Methods</title>
+
         <para>
             To make using the Ec2 class easier to use there are two static methods that can be
             invoked from any of the Ec2 Elements. The first static method is <code>setKeys</code>
-            which will defind you <acronym>AWS</acronym> Access Keys as default keys. When you then create any new
-            object you don't need to pass in any keys to the constructor.
+            which will defind you <acronym>AWS</acronym> Access Keys as default keys. When you then
+            create any new object you don't need to pass in any keys to the constructor.
         </para>
+
         <example id="zend.service.amazon.ec2.staticmethods.setkeys">
             <title>setKeys() Example</title>
+
             <programlisting language="php"><![CDATA[
 Zend_Service_Amazon_Ec2_Ebs::setKeys('aws_key','aws_secret_key');
 ]]></programlisting>
         </example>
+
         <para>
-            To set the region that you are working in you can call the <code>setRegion</code> to set which
-            Amazon Ec2 Region you are working in. Currently there is only two region available us-east-1
-            and eu-west-1. If an invalid value is passed it will throw an exception stating that.
+            To set the region that you are working in you can call the <code>setRegion</code> to set
+            which Amazon Ec2 Region you are working in. Currently there is only two region available
+            us-east-1 and eu-west-1. If an invalid value is passed it will throw an exception
+            stating that.
         </para>
+
         <example id="zend.service.amazon.ec2.staticmethods.setregion">
             <title>setRegion() Example</title>
+
             <programlisting language="php"><![CDATA[
 Zend_Service_Amazon_Ec2_Ebs::setRegion('us-east-1');
 ]]></programlisting>
         </example>
+
         <note id="zend.service.amazon.ec2.staticmethods.setregion.note">
             <title>Set Amazon Ec2 Region</title>
+
             <para>
-                Alternativly you can set the region when you create each class as the third parameter in the
-                constructor method.
+                Alternativly you can set the region when you create each class as the third
+                parameter in the constructor method.
             </para>
         </note>
     </sect2>
-
-</sect1>
+</sect1>

documentation/manual/en/module_specs/Zend_Service_Simpy.xml

@@ -2,38 +2,48 @@
 <!-- Reviewed: no -->
 <sect1 id="zend.service.simpy">
     <title>Zend_Service_Simpy</title>
+
     <sect2 id="zend.service.simpy.introduction">
         <title>Introduction</title>
+
         <para>
-            <classname>Zend_Service_Simpy</classname> is a lightweight wrapper for the free REST <acronym>API</acronym> available
-            for the Simpy social bookmarking service.
+            <classname>Zend_Service_Simpy</classname> is a lightweight wrapper for the free REST
+            <acronym>API</acronym> available for the Simpy social bookmarking service.
         </para>
+
         <para>
-            In order to use <classname>Zend_Service_Simpy</classname>, you should already have a Simpy account.
-            To get an account, visit the <ulink url="http://simpy.com">Simpy web site</ulink>. For more
-            information on the Simpy REST <acronym>API</acronym>, refer to the
-            <ulink url="http://www.simpy.com/doc/api/rest">Simpy REST <acronym>API</acronym> documentation</ulink>.
+            In order to use <classname>Zend_Service_Simpy</classname>, you should already have a
+            Simpy account. To get an account, visit the <ulink
+                url="http://simpy.com">Simpy web site</ulink>. For more information on the Simpy
+            REST <acronym>API</acronym>, refer to the <ulink
+                url="http://www.simpy.com/doc/api/rest">Simpy REST <acronym>API</acronym>
+                documentation</ulink>.
         </para>
+
         <para>
-            The Simpy REST <acronym>API</acronym> allows developers to interact with specific aspects of the service that
-            the Simpy web site offers. The sections following will outline the use of
-            <classname>Zend_Service_Simpy</classname> for each of these areas.
+            The Simpy REST <acronym>API</acronym> allows developers to interact with specific
+            aspects of the service that the Simpy web site offers. The sections following will
+            outline the use of <classname>Zend_Service_Simpy</classname> for each of these areas.
+
             <itemizedlist>
                 <listitem>
                     <para>
                         Links: Create, Retrieve, Update, Delete
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         Tags: Retrieve, Delete, Rename, Merge, Split
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         Notes: Create, Retrieve, Update, Delete
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         Watchlists: Get, Get All
@@ -42,19 +52,23 @@
             </itemizedlist>
         </para>
     </sect2>
+
     <sect2 id="zend.service.simpy.links">
         <title>Links</title>
+
         <para>
-            When querying links, results are returned in descending order by date added. Links can be
-            searched by title, nickname, tags, note, or even the content of the web page associated
-            with the link. Simpy offers searching by any or all of these fields with phrases, boolean
-            operators, and wildcards. See the
+            When querying links, results are returned in descending order by date added. Links can
+            be searched by title, nickname, tags, note, or even the content of the web page
+            associated with the link. Simpy offers searching by any or all of these fields with
+            phrases, boolean operators, and wildcards. See the
             <ulink url="http://www.simpy.com/faq#searchSyntax">search syntax</ulink> and
             <ulink url="http://www.simpy.com/faq#searchFieldsLinks">search fields</ulink>
             sections of the Simpy FAQ for more information.
         </para>
+
         <example id="zend.service.simpy.links.querying">
             <title>Querying Links</title>
+
             <programlisting language="php"><![CDATA[
 $simpy = new Zend_Service_Simpy('yourusername', 'yourpassword');
 
@@ -102,13 +116,17 @@ $linkQuery->setBeforeDate('2006-12-01');
 $linkQuery->setAfterDate('2006-12-09');
 ]]></programlisting>
         </example>
+
         <para>
-            Links are represented uniquely by their <acronym>URL</acronym>s. In other words, if an attempt is made to save
-            a link that has the same <acronym>URL</acronym> as an existing link, data for the existing link will be
-            overwritten with the data specified in the save attempt.
+            Links are represented uniquely by their <acronym>URL</acronym>s. In other words, if an
+            attempt is made to save a link that has the same <acronym>URL</acronym> as an existing
+            link, data for the existing link will be overwritten with the data specified in the save
+            attempt.
         </para>
+
         <example id="zend.service.simpy.links.modifying">
             <title>Modifying Links</title>
+
             <programlisting language="php"><![CDATA[
 $simpy = new Zend_Service_Simpy('yourusername', 'yourpassword');
 
@@ -143,14 +161,18 @@ foreach ($linkSet as $link) {
 ]]></programlisting>
         </example>
     </sect2>
+
     <sect2 id="zend.service.simpy.tags">
         <title>Tags</title>
+
         <para>
             When retrieved, tags are sorted in decreasing order (i.e. highest
             first) by the number of links that use the tag.
         </para>
+
         <example id="zend.service.simpy.tags.working">
             <title>Working With Tags</title>
+
             <programlisting language="php"><![CDATA[
 $simpy = new Zend_Service_Simpy('yourusername', 'yourpassword');
 
@@ -191,14 +213,18 @@ $simpy->mergeTags('framework', 'development', 'frameworks');
 ]]></programlisting>
         </example>
     </sect2>
+
     <sect2 id="zend.service.simpy.notes">
         <title>Notes</title>
+
         <para>
             Notes can be saved, retrieved, and deleted. They are uniquely
             identified by a numeric ID value.
         </para>
+
         <example id="zend.service.simpy.notes.working">
             <title>Working With Notes</title>
+
             <programlisting language="php"><![CDATA[
 $simpy = new Zend_Service_Simpy('yourusername', 'yourpassword');
 
@@ -243,15 +269,19 @@ $simpy->deleteNote($note->getId());
 ]]></programlisting>
         </example>
     </sect2>
+
     <sect2 id="zend.service.simpy.watchlists">
         <title>Watchlists</title>
+
         <para>
             Watchlists cannot be created or removed using the <acronym>API</acronym>, only
             retrieved. Thus, you must set up a watchlist via the Simpy web
             site prior to attempting to access it using the <acronym>API</acronym>.
         </para>
+
         <example id="zend.service.simpy.watchlists.retrieving">
             <title>Retrieving Watchlists</title>
+
             <programlisting language="php"><![CDATA[
 $simpy = new Zend_Service_Simpy('yourusername', 'yourpassword');
 

documentation/manual/en/module_specs/Zend_Service_StrikeIron-BundledServices.xml

@@ -4,34 +4,39 @@
     <title>Zend_Service_StrikeIron: Bundled Services</title>
 
     <para>
-      <classname>Zend_Service_StrikeIron</classname> comes with wrapper classes for three popular StrikeIron services.
+        <classname>Zend_Service_StrikeIron</classname> comes with wrapper classes for three popular
+        StrikeIron services.
     </para>
 
     <sect2 id="zend.service.strikeiron.bundled-services.zip-code-information">
-      <title>ZIP Code Information</title>
-
-      <para>
-        <classname>Zend_Service_StrikeIron_ZipCodeInfo</classname> provides a client for StrikeIron's
-        Zip Code Information Service. For more information on this service, visit these
-        StrikeIron resources:
-
-        <itemizedlist>
-          <listitem>
-            <para>
-              <ulink url="http://www.strikeiron.com/ProductDetail.aspx?p=267">Zip Code Information Service Page</ulink>
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <ulink url="http://sdpws.strikeiron.com/zf1.StrikeIron/sdpZIPCodeInfo?WSDL">Zip Code Information Service WSDL</ulink>
-            </para>
-          </listitem>
-        </itemizedlist>
-
-        The service contains a <methodname>getZipCode()</methodname> method that will retrieve information
-        about a United States ZIP code or Canadian postal code:
-
-        <programlisting language="php"><![CDATA[
+        <title>ZIP Code Information</title>
+
+        <para>
+            <classname>Zend_Service_StrikeIron_ZipCodeInfo</classname> provides a client for
+            StrikeIron's Zip Code Information Service. For more information on this service, visit
+            these StrikeIron resources:
+
+            <itemizedlist>
+                <listitem>
+                    <para>
+                      <ulink url="http://www.strikeiron.com/ProductDetail.aspx?p=267">Zip Code
+                          Information Service Page</ulink>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                      <ulink
+                          url="http://sdpws.strikeiron.com/zf1.StrikeIron/sdpZIPCodeInfo?WSDL">Zip
+                          Code Information Service WSDL</ulink>
+                    </para>
+                </listitem>
+            </itemizedlist>
+
+            The service contains a <methodname>getZipCode()</methodname> method that will retrieve
+            information about a United States ZIP code or Canadian postal code:
+
+            <programlisting language="php"><![CDATA[
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'your-username',
                                                 'password' => 'your-password'));
 
@@ -68,36 +73,40 @@ if ($zips->count == 0) {
 // http://www.strikeiron.com/exampledata/StrikeIronZipCodeInformation_v3.pdf
 $status = $response->serviceStatus;
 ]]></programlisting>
-      </para>
+        </para>
     </sect2>
 
     <sect2 id="zend.service.strikeiron.bundled-services.us-address-verification">
-      <title>U.S. Address Verification</title>
-
-      <para>
-        <classname>Zend_Service_StrikeIron_USAddressVerification</classname> provides a client for
-        StrikeIron's U.S. Address Verification Service. For more information on this
-        service, visit these StrikeIron resources:
-
-        <itemizedlist>
-          <listitem>
-            <para>
-              <ulink url="http://www.strikeiron.com/ProductDetail.aspx?p=198">U.S. Address Verification Service Page</ulink>
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <ulink url="http://ws.strikeiron.com/zf1.StrikeIron/USAddressVerification4_0?WSDL">U.S. Address Verification Service WSDL</ulink>
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-
-      <para>
-        The service contains a <methodname>verifyAddressUSA()</methodname> method that will verify
-        an address in the United States:
-
-        <programlisting language="php"><![CDATA[
+        <title>U.S. Address Verification</title>
+
+        <para>
+            <classname>Zend_Service_StrikeIron_USAddressVerification</classname> provides a client
+            for StrikeIron's U.S. Address Verification Service. For more information on this
+            service, visit these StrikeIron resources:
+
+            <itemizedlist>
+                <listitem>
+                    <para>
+                        <ulink url="http://www.strikeiron.com/ProductDetail.aspx?p=198">U.S. Address
+                            Verification Service Page</ulink>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <ulink
+                            url="http://ws.strikeiron.com/zf1.StrikeIron/USAddressVerification4_0?WSDL">U.S.
+                            Address Verification Service WSDL</ulink>
+                    </para>
+                </listitem>
+            </itemizedlist>
+        </para>
+
+        <para>
+            The service contains a <methodname>verifyAddressUSA()</methodname> method that will
+            verify an address in the United States:
+
+            <programlisting language="php"><![CDATA[
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'your-username',
                                                 'password' => 'your-password'));
 
@@ -129,36 +138,41 @@ if ($result->addressErrorNumber != 0) {
     $valid = ($result->valid == 'VALID');
 }
 ]]></programlisting>
-      </para>
+        </para>
     </sect2>
 
     <sect2 id="zend.service.strikeiron.bundled-services.sales-use-tax-basic">
-      <title>Sales &amp; Use Tax Basic</title>
-
-      <para>
-        <classname>Zend_Service_StrikeIron_SalesUseTaxBasic</classname> provides a client for
-        StrikeIron's Sales &amp; Use Tax Basic service. For more information on this
-        service, visit these StrikeIron resources:
-
-        <itemizedlist>
-          <listitem>
-            <para>
-              <ulink url="http://www.strikeiron.com/ProductDetail.aspx?p=351">Sales &amp; Use Tax Basic Service Page</ulink>
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <ulink url="http://ws.strikeiron.com/zf1.StrikeIron/taxdatabasic4?WSDL">Sales &amp; Use Tax Basic Service WSDL</ulink>
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-
-      <para>
-        The service contains two methods, <methodname>getTaxRateUSA()</methodname> and <methodname>getTaxRateCanada()</methodname>,
-        that will retrieve sales and use tax data for the United States and Canada, respectively.
-
-        <programlisting language="php"><![CDATA[
+        <title>Sales &amp; Use Tax Basic</title>
+
+        <para>
+            <classname>Zend_Service_StrikeIron_SalesUseTaxBasic</classname> provides a client for
+            StrikeIron's Sales &amp; Use Tax Basic service. For more information on this
+            service, visit these StrikeIron resources:
+
+            <itemizedlist>
+                <listitem>
+                    <para>
+                        <ulink url="http://www.strikeiron.com/ProductDetail.aspx?p=351">Sales &amp;
+                            Use Tax Basic Service Page</ulink>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <ulink
+                            url="http://ws.strikeiron.com/zf1.StrikeIron/taxdatabasic4?WSDL">Sales
+                            &amp; Use Tax Basic Service WSDL</ulink>
+                    </para>
+                </listitem>
+            </itemizedlist>
+        </para>
+
+        <para>
+            The service contains two methods, <methodname>getTaxRateUSA()</methodname> and
+            <methodname>getTaxRateCanada()</methodname>, that will retrieve sales and use tax data
+            for the United States and Canada, respectively.
+
+            <programlisting language="php"><![CDATA[
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'your-username',
                                                 'password' => 'your-password'));
 
@@ -175,6 +189,6 @@ $rateInfo = $taxBasic->getTaxRateUS(array('zip_code' => 95014));
 print_r($rateInfo);               // show all properties
 echo $rateInfo->state_sales_tax;  // or just the state sales tax
 ]]></programlisting>
-      </para>
+        </para>
     </sect2>
 </sect1>

documentation/manual/en/module_specs/Zend_Service_StrikeIron-Overview.xml

@@ -4,19 +4,25 @@
     <title>Zend_Service_StrikeIron</title>
 
     <para>
-        <classname>Zend_Service_StrikeIron</classname> provides a <acronym>PHP</acronym> 5 client to StrikeIron
-        web services. See the following sections:
+        <classname>Zend_Service_StrikeIron</classname> provides a <acronym>PHP</acronym> 5 client to
+        StrikeIron web services. See the following sections:
     </para>
 
     <para>
         <itemizedlist>
             <listitem><para><xref linkend="zend.service.strikeiron" /></para></listitem>
         </itemizedlist>
+
         <itemizedlist>
-            <listitem><para><xref linkend="zend.service.strikeiron.bundled-services" /></para></listitem>
+            <listitem>
+                <para><xref linkend="zend.service.strikeiron.bundled-services" /></para>
+            </listitem>
         </itemizedlist>
+
         <itemizedlist>
-            <listitem><para><xref linkend="zend.service.strikeiron.advanced-uses" /></para></listitem>
+            <listitem>
+                <para><xref linkend="zend.service.strikeiron.advanced-uses" /></para>
+            </listitem>
         </itemizedlist>
     </para>
 
@@ -24,165 +30,184 @@
         <title>Overview</title>
 
         <para>
-          <ulink url="http://www.strikeiron.com">StrikeIron</ulink>
-          offers hundreds of commercial data services ("Data as a Service")
-          such as Online Sales Tax, Currency Rates, Stock Quotes, Geocodes, Global
-          Address Verification, Yellow/White Pages, MapQuest Driving Directions,
-          Dun &amp; Bradstreet Business Credit Checks, and much, much more.
+            <ulink url="http://www.strikeiron.com">StrikeIron</ulink>
+            offers hundreds of commercial data services ("Data as a Service")
+            such as Online Sales Tax, Currency Rates, Stock Quotes, Geocodes, Global
+            Address Verification, Yellow/White Pages, MapQuest Driving Directions,
+            Dun &amp; Bradstreet Business Credit Checks, and much, much more.
         </para>
 
         <para>
-          Each StrikeIron web service shares a standard <acronym>SOAP</acronym> (and REST)
-          <acronym>API</acronym>, making it easy to integrate and manage multiple services.
-          StrikeIron also manages customer billing for all services in a single
-          account, making it perfect for solution providers. Get
-          started with free web services at
-          <ulink url="http://www.strikeiron.com/sdp">http://www.strikeiron.com/sdp</ulink>.
+            Each StrikeIron web service shares a standard <acronym>SOAP</acronym> (and REST)
+            <acronym>API</acronym>, making it easy to integrate and manage multiple services.
+            StrikeIron also manages customer billing for all services in a single
+            account, making it perfect for solution providers. Get
+            started with free web services at
+            <ulink url="http://www.strikeiron.com/sdp">http://www.strikeiron.com/sdp</ulink>.
         </para>
 
         <para>
-          StrikeIron's services may be used through the
-          <ulink url="http://us.php.net/soap">PHP 5 <acronym>SOAP</acronym> extension</ulink> alone.
-          However, using StrikeIron this way does not give an ideal <acronym>PHP</acronym>-like interface.
-          The <classname>Zend_Service_StrikeIron</classname> component provides a lightweight layer on
-          top of the <acronym>SOAP</acronym> extension for working with StrikeIron services in a
-          more convenient, <acronym>PHP</acronym>-like manner.
+            StrikeIron's services may be used through the
+            <ulink url="http://us.php.net/soap">PHP 5 <acronym>SOAP</acronym> extension</ulink>
+            alone. However, using StrikeIron this way does not give an ideal
+            <acronym>PHP</acronym>-like interface. The
+            <classname>Zend_Service_StrikeIron</classname> component provides a lightweight layer on
+            top of the <acronym>SOAP</acronym> extension for working with StrikeIron services in a
+            more convenient, <acronym>PHP</acronym>-like manner.
         </para>
 
         <note>
-          <para>
-            The <acronym>PHP</acronym> 5 <acronym>SOAP</acronym> extension must be installed and enabled to use
-            <classname>Zend_Service_StrikeIron</classname>.
-          </para>
+            <para>
+                The <acronym>PHP</acronym> 5 <acronym>SOAP</acronym> extension must be installed and
+                enabled to use <classname>Zend_Service_StrikeIron</classname>.
+            </para>
         </note>
 
         <para>
-          The <classname>Zend_Service_StrikeIron</classname> component provides:
+            The <classname>Zend_Service_StrikeIron</classname> component provides:
+
+            <itemizedlist>
+                <listitem>
+                    <para>
+                        A single point for configuring your StrikeIron authentication credentials
+                        that can be used across many StrikeIron services.
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        A standard way of retrieving your StrikeIron subscription information
+                        such as license status and the number of hits remaining to a service.
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        The ability to use any StrikeIron service from its WSDL without
+                        creating a <acronym>PHP</acronym> wrapper class, and the option of creating
+                        a wrapper for a more convenient interface.
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        Wrappers for three popular StrikeIron services.
+                    </para>
+                </listitem>
+            </itemizedlist>
+        </para>
+    </sect2>
 
-          <itemizedlist>
-            <listitem>
-              <para>
-                A single point for configuring your StrikeIron authentication credentials
-                that can be used across many StrikeIron services.
-              </para>
-            </listitem>
+    <sect2 id="zend.service.strikeiron.registering">
+        <title>Registering with StrikeIron</title>
+
+        <para>
+            Before you can get started with <classname>Zend_Service_StrikeIron</classname>, you must
+            first <ulink url="http://strikeiron.com/Register.aspx">register</ulink> for a
+            StrikeIron developer account.
+        </para>
+
+        <para>
+            After registering, you will receive a StrikeIron username and password.
+            These will be used when connecting to StrikeIron using
+            <classname>Zend_Service_StrikeIron</classname>.
+        </para>
+
+        <para>
+            You will also need to <ulink
+                url="http://www.strikeiron.com/ProductDetail.aspx?p=257">sign up</ulink>
+            for StrikeIron's Super Data Pack Web Service.
+        </para>
+
+        <para>
+            Both registration steps are free and can be done relatively quickly through
+            the StrikeIron website.
+        </para>
+    </sect2>
+
+    <sect2 id="zend.service.strikeiron.getting-started">
+        <title>Getting Started</title>
 
+        <para>
+            Once you have <ulink url="http://strikeiron.com/Register.aspx">registered</ulink>
+            for a StrikeIron account and signed up for the
+            <ulink url="http://www.strikeiron.com/ProductDetail.aspx?p=257">Super Data Pack</ulink>,
+            you're ready to start using <classname>Zend_Service_StrikeIron</classname>.
+        </para>
+
+        <para>
+            StrikeIron consists of hundreds of different web services.
+            <classname>Zend_Service_StrikeIron</classname> can be used with many of these services
+            but provides supported wrappers for three of them:
+        </para>
+
+        <itemizedlist>
             <listitem>
-              <para>
-                A standard way of retrieving your StrikeIron subscription information
-                such as license status and the number of hits remaining to a service.
-              </para>
+                <para>
+                    <link
+                        linkend="zend.service.strikeiron.bundled-services.zip-code-information">ZIP
+                        Code Information</link>
+                </para>
             </listitem>
 
             <listitem>
-              <para>
-                The ability to use any StrikeIron service from its WSDL without
-                creating a <acronym>PHP</acronym> wrapper class, and the option of creating a wrapper for
-                a more convenient interface.
-              </para>
+                <para>
+                    <link
+                        linkend="zend.service.strikeiron.bundled-services.us-address-verification">US
+                        Address Verification</link>
+                </para>
             </listitem>
 
             <listitem>
-              <para>
-                Wrappers for three popular StrikeIron services.
-              </para>
+                <para>
+                    <link
+                        linkend="zend.service.strikeiron.bundled-services.sales-use-tax-basic">Sales
+                        &amp; Use Tax Basic</link>
+                </para>
             </listitem>
-          </itemizedlist>
-        </para>
-
-    </sect2>
+        </itemizedlist>
 
-    <sect2 id="zend.service.strikeiron.registering">
-      <title>Registering with StrikeIron</title>
-      <para>
-        Before you can get started with <classname>Zend_Service_StrikeIron</classname>, you must first
-        <ulink url="http://strikeiron.com/Register.aspx">register</ulink> for a
-        StrikeIron developer account.
-      </para>
-
-      <para>
-        After registering, you will receive a StrikeIron username and password.
-        These will be used when connecting to StrikeIron using <classname>Zend_Service_StrikeIron</classname>.
-      </para>
-
-      <para>
-        You will also need to <ulink url="http://www.strikeiron.com/ProductDetail.aspx?p=257">sign up</ulink>
-        for StrikeIron's Super Data Pack Web Service.
-      </para>
-
-      <para>
-        Both registration steps are free and can be done relatively quickly through
-        the StrikeIron website.
-      </para>
-    </sect2>
+        <para>
+            The class <classname>Zend_Service_StrikeIron</classname> provides a simple way
+            of specifying your StrikeIron account information and other options in
+            its constructor. It also has a factory method that will return clients
+            for StrikeIron services:
 
-    <sect2 id="zend.service.strikeiron.getting-started">
-      <title>Getting Started</title>
-      <para>
-        Once you have <ulink url="http://strikeiron.com/Register.aspx">registered</ulink>
-        for a StrikeIron account and signed up for the
-        <ulink url="http://www.strikeiron.com/ProductDetail.aspx?p=257">Super Data Pack</ulink>,
-        you're ready to start using <classname>Zend_Service_StrikeIron</classname>.
-      </para>
-
-      <para>
-        StrikeIron consists of hundreds of different web services.
-        <classname>Zend_Service_StrikeIron</classname> can be used with many of these services but provides supported
-        wrappers for three of them:
-      </para>
-
-      <itemizedlist>
-        <listitem>
-          <para><link linkend="zend.service.strikeiron.bundled-services.zip-code-information">ZIP Code Information</link></para>
-        </listitem>
-        <listitem>
-          <para><link linkend="zend.service.strikeiron.bundled-services.us-address-verification">US Address Verification</link></para>
-        </listitem>
-        <listitem>
-          <para><link linkend="zend.service.strikeiron.bundled-services.sales-use-tax-basic">Sales &amp; Use Tax Basic</link></para>
-        </listitem>
-      </itemizedlist>
-
-      <para>
-        The class <classname>Zend_Service_StrikeIron</classname> provides a simple way
-        of specifying your StrikeIron account information and other options in
-        its constructor. It also has a factory method that will return clients
-        for StrikeIron services:
-
-        <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'your-username',
                                                 'password' => 'your-password'));
 
 $taxBasic = $strikeIron->getService(array('class' => 'SalesUseTaxBasic'));
 ]]></programlisting>
-      </para>
-
-      <para>
-        The <methodname>getService()</methodname> method will return a client for any
-        StrikeIron service by the name of its <acronym>PHP</acronym> wrapper class. In this case,
-        the name <code>SalesUseTaxBasic</code> refers to the wrapper class
-        <classname>Zend_Service_StrikeIron_SalesUseTaxBasic</classname>. Wrappers are
-        included for three services and described in
-        <link linkend="zend.service.strikeiron.bundled-services">Bundled Services</link>.
-      </para>
-
-      <para>
-        The <methodname>getService()</methodname> method can also return a client for
-        a StrikeIron service that does not yet have a <acronym>PHP</acronym> wrapper. This is
-        explained in
-        <link linkend="zend.service.strikeiron.advanced-uses.services-by-wsdl">Using Services by WSDL</link>.
-      </para>
+        </para>
+
+        <para>
+            The <methodname>getService()</methodname> method will return a client for any
+            StrikeIron service by the name of its <acronym>PHP</acronym> wrapper class. In this
+            case, the name <code>SalesUseTaxBasic</code> refers to the wrapper class
+            <classname>Zend_Service_StrikeIron_SalesUseTaxBasic</classname>. Wrappers are
+            included for three services and described in
+            <link linkend="zend.service.strikeiron.bundled-services">Bundled Services</link>.
+        </para>
+
+        <para>
+            The <methodname>getService()</methodname> method can also return a client for
+            a StrikeIron service that does not yet have a <acronym>PHP</acronym> wrapper. This is
+            explained in
+            <link linkend="zend.service.strikeiron.advanced-uses.services-by-wsdl">Using Services by
+                WSDL</link>.
+        </para>
     </sect2>
 
     <sect2 id="zend.service.strikeiron.making-first-query">
-      <title>Making Your First Query</title>
+        <title>Making Your First Query</title>
 
-      <para>
-        Once you have used the <methodname>getService()</methodname> method to get a client
-        for a particular StrikeIron service, you can utilize that client
-        by calling methods on it just like any other PHP object.
+        <para>
+            Once you have used the <methodname>getService()</methodname> method to get a client
+            for a particular StrikeIron service, you can utilize that client
+            by calling methods on it just like any other PHP object.
 
-        <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'your-username',
                                                 'password' => 'your-password'));
 
@@ -196,46 +221,48 @@ echo $rateInfo->abbreviation;
 echo $rateInfo->GST;
 ]]></programlisting>
 
-        In the example above, the <methodname>getService()</methodname> method is used
-        to return a client to the
-        <link linkend="zend.service.strikeiron.bundled-services.sales-use-tax-basic">Sales &amp; Use Tax Basic</link> service.
-        The client object is stored in <varname>$taxBasic</varname>.
-      </para>
-
-      <para>
-        The <methodname>getTaxRateCanada()</methodname> method is then called on the
-        service. An associative array is used to supply keyword parameters to
-        the method. This is the way that all StrikeIron methods are called.
-      </para>
-
-      <para>
-        The result from <methodname>getTaxRateCanada()</methodname> is stored in
-        <varname>$rateInfo</varname> and has properties like <code>province</code>
-        and <constant>GST</constant>.
-      </para>
-
-      <para>
-        Many of the StrikeIron services are as simple to use as the example above. See
-        <link linkend="zend.service.strikeiron.bundled-services">Bundled Services</link>
-        for detailed information on three StrikeIron services.
-      </para>
+            In the example above, the <methodname>getService()</methodname> method is used
+            to return a client to the <link
+                linkend="zend.service.strikeiron.bundled-services.sales-use-tax-basic">Sales &amp;
+                Use Tax Basic</link> service. The client object is stored in
+            <varname>$taxBasic</varname>.
+        </para>
+
+        <para>
+            The <methodname>getTaxRateCanada()</methodname> method is then called on the
+            service. An associative array is used to supply keyword parameters to
+            the method. This is the way that all StrikeIron methods are called.
+        </para>
+
+        <para>
+            The result from <methodname>getTaxRateCanada()</methodname> is stored in
+            <varname>$rateInfo</varname> and has properties like <code>province</code>
+            and <constant>GST</constant>.
+        </para>
+
+        <para>
+            Many of the StrikeIron services are as simple to use as the example above. See
+            <link linkend="zend.service.strikeiron.bundled-services">Bundled Services</link>
+            for detailed information on three StrikeIron services.
+        </para>
     </sect2>
 
     <sect2 id="zend.service.strikeiron.examining-results">
-      <title>Examining Results</title>
-      <para>
-        When learning or debugging the StrikeIron services, it's often useful to dump the
-        result returned from a method call. The result will always be an object that is an
-        instance of <classname>Zend_Service_StrikeIron_Decorator</classname>. This is a
-        small <ulink url="http://en.wikipedia.org/wiki/Decorator_pattern">decorator</ulink>
-        object that wraps the results from the method call.
-      </para>
-
-      <para>
-        The simplest way to examine a result from the service is to use the built-in
-        PHP functions like <ulink url="http://www.php.net/print_r">print_r()</ulink>:
-
-        <programlisting language="php"><![CDATA[
+        <title>Examining Results</title>
+
+        <para>
+            When learning or debugging the StrikeIron services, it's often useful to dump the
+            result returned from a method call. The result will always be an object that is an
+            instance of <classname>Zend_Service_StrikeIron_Decorator</classname>. This is a
+            small <ulink url="http://en.wikipedia.org/wiki/Decorator_pattern">decorator</ulink>
+            object that wraps the results from the method call.
+        </para>
+
+        <para>
+            The simplest way to examine a result from the service is to use the built-in
+            PHP functions like <ulink url="http://www.php.net/print_r">print_r()</ulink>:
+
+            <programlisting language="php"><![CDATA[
 <?php
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'your-username',
                                                 'password' => 'your-password'));
@@ -260,49 +287,53 @@ Zend_Service_StrikeIron_Decorator Object
         )
 )
 ]]></programlisting>
-      </para>
-
-      <para>
-        In the output above, we see that the decorator (<varname>$rateInfo</varname>) wraps an object
-        named <code>GetTaxRateCanadaResult</code>, the result of the call to <methodname>getTaxRateCanada()</methodname>.
-      </para>
+        </para>
 
-      <para>
-        This means that <varname>$rateInfo</varname> has public properties like <code>abbreviation</code>,
-        <code>province</code>, and <constant>GST</constant>. These are accessed like <code>$rateInfo->province</code>.
-      </para>
+        <para>
+            In the output above, we see that the decorator (<varname>$rateInfo</varname>) wraps an
+            object named <code>GetTaxRateCanadaResult</code>, the result of the call to
+            <methodname>getTaxRateCanada()</methodname>.
+        </para>
 
-      <tip>
         <para>
-          StrikeIron result properties sometimes start with an uppercase
-          letter such as <code>Foo</code> or <code>Bar</code> where most <acronym>PHP</acronym> object
-          properties normally start with a lowercase letter as in <code>foo</code> or
-          <code>bar</code>. The decorator will automatically do this inflection so you
-          may read a property <code>Foo</code> as <code>foo</code>.
+            This means that <varname>$rateInfo</varname> has public properties like
+            <code>abbreviation</code>, <code>province</code>, and <constant>GST</constant>. These
+            are accessed like <code>$rateInfo->province</code>.
         </para>
-      </tip>
 
-      <para>
-        If you ever need to get the original object or its name out of the decorator, use the
-        respective methods <methodname>getDecoratedObject()</methodname> and <methodname>getDecoratedObjectName()</methodname>.
-      </para>
+        <tip>
+            <para>
+                StrikeIron result properties sometimes start with an uppercase letter such as
+                <code>Foo</code> or <code>Bar</code> where most <acronym>PHP</acronym> object
+                properties normally start with a lowercase letter as in <code>foo</code> or
+                <code>bar</code>. The decorator will automatically do this inflection so you
+                may read a property <code>Foo</code> as <code>foo</code>.
+            </para>
+        </tip>
+
+        <para>
+            If you ever need to get the original object or its name out of the decorator, use the
+            respective methods <methodname>getDecoratedObject()</methodname> and
+            <methodname>getDecoratedObjectName()</methodname>.
+        </para>
     </sect2>
 
     <sect2 id="zend.service.strikeiron.handling-errors">
-      <title>Handling Errors</title>
-      <para>
-        The previous examples are naive, i.e. no error handling was shown.
-        It's possible that StrikeIron will return a fault during a method
-        call. Events like bad account credentials or an expired subscription
-        can cause StrikeIron to raise a fault.
-      </para>
-
-      <para>
-        An exception will be thrown when such a fault occurs. You should
-        anticipate and catch these exceptions when making method calls to the
-        service:
-
-        <programlisting language="php"><![CDATA[
+        <title>Handling Errors</title>
+
+        <para>
+            The previous examples are naive, i.e. no error handling was shown.
+            It's possible that StrikeIron will return a fault during a method
+            call. Events like bad account credentials or an expired subscription
+            can cause StrikeIron to raise a fault.
+        </para>
+
+        <para>
+            An exception will be thrown when such a fault occurs. You should
+            anticipate and catch these exceptions when making method calls to the
+            service:
+
+            <programlisting language="php"><![CDATA[
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'your-username',
                                                 'password' => 'your-password'));
 
@@ -319,45 +350,48 @@ try {
 
 }
 ]]></programlisting>
-        The exceptions thrown will always be <classname>Zend_Service_StrikeIron_Exception</classname>.
-      </para>
-
-      <para>
-        It's important to understand the difference between exceptions and
-        normal failed method calls. Exceptions occur for
-        <emphasis>exceptional</emphasis> conditions, such as
-        the network going down or your subscription expiring.
-        Failed method calls that are a common occurrence,
-        such as <methodname>getTaxRateCanada()</methodname> not finding the
-        <code>province</code> you supplied, will not result an in exception.
-      </para>
-
-      <note>
+
+            The exceptions thrown will always be
+            <classname>Zend_Service_StrikeIron_Exception</classname>.
+        </para>
+
         <para>
-          Every time you make a method call to a StrikeIron service, you
-          should check the response object for validity and also be
-          prepared to catch an exception.
+            It's important to understand the difference between exceptions and
+            normal failed method calls. Exceptions occur for
+            <emphasis>exceptional</emphasis> conditions, such as
+            the network going down or your subscription expiring.
+            Failed method calls that are a common occurrence,
+            such as <methodname>getTaxRateCanada()</methodname> not finding the
+            <code>province</code> you supplied, will not result an in exception.
         </para>
-      </note>
 
-      <para><!-- included for whitespace --></para>
+        <note>
+            <para>
+                Every time you make a method call to a StrikeIron service, you
+                should check the response object for validity and also be
+                prepared to catch an exception.
+            </para>
+        </note>
+
+        <para><!-- included for whitespace --></para>
     </sect2>
 
     <sect2 id="zend.service.strikeiron.checking-subscription">
-      <title>Checking Your Subscription</title>
-      <para>
-        StrikeIron provides many different services. Some of these are
-        free, some are available on a trial basis, and some are pay subscription only.
-        When using StrikeIron, it's important to be aware of your subscription
-        status for the services you are using and check it regularly.
-      </para>
-
-      <para>
-        Each StrikeIron client returned by the <code>getService</code> method
-        has the ability to check the subscription status for that service using
-        the <methodname>getSubscriptionInfo()</methodname> method of the client:
-
-        <programlisting language="php"><![CDATA[
+        <title>Checking Your Subscription</title>
+
+        <para>
+            StrikeIron provides many different services. Some of these are
+            free, some are available on a trial basis, and some are pay subscription only.
+            When using StrikeIron, it's important to be aware of your subscription
+            status for the services you are using and check it regularly.
+        </para>
+
+        <para>
+            Each StrikeIron client returned by the <code>getService</code> method
+            has the ability to check the subscription status for that service using
+            the <methodname>getSubscriptionInfo()</methodname> method of the client:
+
+            <programlisting language="php"><![CDATA[
 // Get a client for the Sales & Use Tax Basic service
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'your-username',
                                                 'password' => 'your-password'));
@@ -368,24 +402,24 @@ $taxBasic = $strikeIron->getService(array('class => 'SalesUseTaxBasic'));
 $subscription = $taxBasic->getSubscriptionInfo();
 echo $subscription->remainingHits;
 ]]></programlisting>
-      </para>
-
-      <para>
-        The <methodname>getSubscriptionInfo()</methodname> method will return an object
-        that typically has a <code>remainingHits</code> property. It's
-        important to check the status on each service that you are using. If
-        a method call is made to StrikeIron after the remaining hits have been
-        used up, an exception will occur.
-      </para>
-
-      <para>
-        Checking your subscription to a service does not use any remaining
-        hits to the service. Each time any method call to the service is made,
-        the number of hits remaining will be cached and this cached value will
-        be returned by <methodname>getSubscriptionInfo()</methodname> without connecting
-        to the service again. To force <methodname>getSubscriptionInfo()</methodname>
-        to override its cache and query the subscription information again, use
-        <methodname>getSubscriptionInfo(true)</methodname>.
-      </para>
+        </para>
+
+        <para>
+            The <methodname>getSubscriptionInfo()</methodname> method will return an object
+            that typically has a <code>remainingHits</code> property. It's
+            important to check the status on each service that you are using. If
+            a method call is made to StrikeIron after the remaining hits have been
+            used up, an exception will occur.
+        </para>
+
+        <para>
+            Checking your subscription to a service does not use any remaining
+            hits to the service. Each time any method call to the service is made,
+            the number of hits remaining will be cached and this cached value will
+            be returned by <methodname>getSubscriptionInfo()</methodname> without connecting
+            to the service again. To force <methodname>getSubscriptionInfo()</methodname>
+            to override its cache and query the subscription information again, use
+            <methodname>getSubscriptionInfo(true)</methodname>.
+        </para>
     </sect2>
 </sect1>

documentation/manual/en/module_specs/Zend_Service_Technorati.xml

@@ -5,50 +5,66 @@
 
     <sect2 id="zend.service.technorati.introduction">
         <title>Introduction</title>
+
         <para>
-            <classname>Zend_Service_Technorati</classname> provides an easy, intuitive and object-oriented interface for using
-            the Technorati <acronym>API</acronym>. It provides access to all available
-            <ulink url="http://technorati.com/developers/api/">Technorati <acronym>API</acronym> queries</ulink>
-            and returns the original <acronym>XML</acronym> response as a friendly <acronym>PHP</acronym> object.
+            <classname>Zend_Service_Technorati</classname> provides an easy, intuitive and
+            object-oriented interface for using the Technorati <acronym>API</acronym>. It provides
+            access to all available <ulink url="http://technorati.com/developers/api/">Technorati
+            <acronym>API</acronym> queries</ulink> and returns the original <acronym>XML</acronym>
+            response as a friendly <acronym>PHP</acronym> object.
         </para>
+
         <para>
-            <ulink url="http://technorati.com/">Technorati</ulink> is one of the most popular blog search engines.
-            The <acronym>API</acronym> interface enables developers to retrieve information about a specific blog, search blogs matching a
-            single tag or phrase and get information about a specific author (blogger). For a full list of available
-            queries please see the
-            <ulink url="http://technorati.com/developers/api/">Technorati <acronym>API</acronym> documentation</ulink>
-            or the <link linkend="zend.service.technorati.queries">Available Technorati queries</link> section of this
-            document.
+            <ulink url="http://technorati.com/">Technorati</ulink> is one of the most popular blog
+            search engines. The <acronym>API</acronym> interface enables developers to retrieve
+            information about a specific blog, search blogs matching a single tag or phrase and get
+            information about a specific author (blogger). For a full list of available queries
+            please see the <ulink url="http://technorati.com/developers/api/">Technorati
+                <acronym>API</acronym> documentation</ulink> or the <link
+                linkend="zend.service.technorati.queries">Available Technorati queries</link>
+            section of this document.
         </para>
     </sect2>
 
     <sect2 id="zend.service.technorati.getting-started">
         <title>Getting Started</title>
+
         <para>
-            Technorati requires a valid <acronym>API</acronym> key for usage. To get your own <acronym>API</acronym> Key you first need to
-            <ulink url="http://technorati.com/signup/">create a new Technorati account</ulink>, then visit the
-            <ulink url="http://technorati.com/developers/apikey.html">API Key section</ulink>.
+            Technorati requires a valid <acronym>API</acronym> key for usage. To get your own
+            <acronym>API</acronym> Key you first need to <ulink
+                url="http://technorati.com/signup/">create a new Technorati account</ulink>, then
+            visit the <ulink url="http://technorati.com/developers/apikey.html">API Key
+                section</ulink>.
         </para>
+
         <note>
             <title>API Key limits</title>
+
             <para>
-                You can make up to 500 Technorati <acronym>API</acronym> calls per day, at no charge.
-                Other usage limitations may apply, depending on the current Technorati <acronym>API</acronym> license.
+                You can make up to 500 Technorati <acronym>API</acronym> calls per day, at no
+                charge. Other usage limitations may apply, depending on the current Technorati
+                <acronym>API</acronym> license.
             </para>
         </note>
+
         <para>
-            Once you have a valid <acronym>API</acronym> key, you're ready to start using <classname>Zend_Service_Technorati</classname>.
+            Once you have a valid <acronym>API</acronym> key, you're ready to start using
+            <classname>Zend_Service_Technorati</classname>.
         </para>
     </sect2>
 
     <sect2 id="zend.service.technorati.making-first-query">
         <title>Making Your First Query</title>
+
         <para>
-            In order to run a query, first you need a <classname>Zend_Service_Technorati</classname> instance with a valid <acronym>API</acronym>
-            key. Then choose one of the available query methods, and call it providing required arguments.
+            In order to run a query, first you need a <classname>Zend_Service_Technorati</classname>
+            instance with a valid <acronym>API</acronym> key. Then choose one of the available query
+            methods, and call it providing required arguments.
         </para>
+
         <example id="zend.service.technorati.making-first-query.example-1">
             <title>Sending your first query</title>
+
             <programlisting language="php"><![CDATA[
 // create a new Zend_Service_Technorati
 // with a valid API_KEY
@@ -58,11 +74,15 @@ $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 $resultSet = $technorati->search('PHP');
 ]]></programlisting>
         </example>
+
         <para>
-            Each query method accepts an array of optional parameters that can be used to refine your query.
+            Each query method accepts an array of optional parameters that can be used to refine
+            your query.
         </para>
+
         <example id="zend.service.technorati.making-first-query.example-2">
             <title>Refining your query</title>
+
             <programlisting language="php"><![CDATA[
 // create a new Zend_Service_Technorati
 // with a valid API_KEY
@@ -76,13 +96,16 @@ $options = array('authority' => 'a4');
 $resultSet = $technorati->search('PHP', $options);
 ]]></programlisting>
         </example>
+
         <para>
-            A <classname>Zend_Service_Technorati</classname> instance is not a single-use object. That is, you don't need to
-            create a new instance for each query call; simply use your current <classname>Zend_Service_Technorati</classname>
-            object as long as you need it.
+            A <classname>Zend_Service_Technorati</classname> instance is not a single-use object.
+            That is, you don't need to create a new instance for each query call; simply use your
+            current <classname>Zend_Service_Technorati</classname> object as long as you need it.
         </para>
+
         <example id="zend.service.technorati.making-first-query.example-3">
             <title>Sending multiple queries with the same Zend_Service_Technorati instance</title>
+
             <programlisting language="php"><![CDATA[
 // create a new Zend_Service_Technorati
 // with a valid API_KEY
@@ -99,18 +122,24 @@ $topTags = $technorati->topTags();
 
     <sect2 id="zend.service.technorati.consuming-results">
         <title>Consuming Results</title>
+
         <para>
             You can get one of two types of result object in response to a query.
         </para>
+
         <para>
-            The first group is represented by <classname>Zend_Service_Technorati_*ResultSet</classname> objects. A result set
-            object is basically a collection of result objects. It extends the basic
-            <classname>Zend_Service_Technorati_ResultSet</classname> class and implements the <code>SeekableIterator</code> <acronym>PHP</acronym>
-            interface. The best way to consume a result set object is to loop over it with the <acronym>PHP</acronym> <code>foreach</code>
-            statement.
+            The first group is represented by
+            <classname>Zend_Service_Technorati_*ResultSet</classname> objects. A result set object
+            is basically a collection of result objects. It extends the basic
+            <classname>Zend_Service_Technorati_ResultSet</classname> class and implements the
+            <code>SeekableIterator</code> <acronym>PHP</acronym> interface. The best way to consume
+            a result set object is to loop over it with the <acronym>PHP</acronym>
+            <code>foreach</code> statement.
         </para>
+
         <example id="zend.service.technorati.consuming-results.example-1">
             <title>Consuming a result set object</title>
+
             <programlisting language="php"><![CDATA[
 // create a new Zend_Service_Technorati
 // with a valid API_KEY
@@ -126,12 +155,16 @@ foreach ($resultSet as $result) {
 }
 ]]></programlisting>
         </example>
+
         <para>
-            Because <classname>Zend_Service_Technorati_ResultSet</classname> implements the <code>SeekableIterator</code>
-            interface, you can seek a specific result object using its position in the result collection.
+            Because <classname>Zend_Service_Technorati_ResultSet</classname> implements the
+            <code>SeekableIterator</code> interface, you can seek a specific result object using its
+            position in the result collection.
         </para>
+
         <example id="zend.service.technorati.consuming-results.example-2">
             <title>Seeking a specific result set object</title>
+
             <programlisting language="php"><![CDATA[
 // create a new Zend_Service_Technorati
 // with a valid API_KEY
@@ -146,20 +179,27 @@ $resultSet->seek(1);
 $result = $resultSet->current();
 ]]></programlisting>
         </example>
+
         <note>
             <para>
-                <code>SeekableIterator</code> works as an array and counts positions starting from index 0. Fetching
-                position number 1 means getting the second result in the collection.
+                <code>SeekableIterator</code> works as an array and counts positions starting from
+                index 0. Fetching position number 1 means getting the second result in the
+                collection.
             </para>
         </note>
+
         <para>
             The second group is represented by special standalone result objects.
-            <classname>Zend_Service_Technorati_GetInfoResult</classname>, <classname>Zend_Service_Technorati_BlogInfoResult</classname> and
-            <classname>Zend_Service_Technorati_KeyInfoResult</classname> act as wrappers for additional objects, such as
-            <classname>Zend_Service_Technorati_Author</classname> and <classname>Zend_Service_Technorati_Weblog</classname>.
+            <classname>Zend_Service_Technorati_GetInfoResult</classname>,
+            <classname>Zend_Service_Technorati_BlogInfoResult</classname> and
+            <classname>Zend_Service_Technorati_KeyInfoResult</classname> act as wrappers for
+            additional objects, such as <classname>Zend_Service_Technorati_Author</classname> and
+            <classname>Zend_Service_Technorati_Weblog</classname>.
         </para>
+
         <example id="zend.service.technorati.consuming-results.example-3">
             <title>Consuming a standalone result object</title>
+
             <programlisting language="php"><![CDATA[
 // create a new Zend_Service_Technorati
 // with a valid API_KEY
@@ -178,31 +218,40 @@ foreach ($result->getWeblogs() as $weblog) {
 echo "</ol>";
 ]]></programlisting>
         </example>
+
         <para>
-            Please read the <link linkend="zend.service.technorati.classes">Zend_Service_Technorati Classes</link>
-            section for further details about response classes.
+            Please read the <link linkend="zend.service.technorati.classes">Zend_Service_Technorati
+                Classes</link> section for further details about response classes.
         </para>
-
     </sect2>
 
     <sect2 id="zend.service.technorati.handling-errors">
         <title>Handling Errors</title>
+
         <para>
             Each <classname>Zend_Service_Technorati</classname> query method throws a
-            <classname>Zend_Service_Technorati_Exception</classname> exception on failure with a meaningful error message.
+            <classname>Zend_Service_Technorati_Exception</classname> exception on failure with a
+            meaningful error message.
         </para>
+
         <para>
-            There are several reasons that may cause a <classname>Zend_Service_Technorati</classname> query to fail.
-            <classname>Zend_Service_Technorati</classname> validates all parameters for any query request. If a parameter is
-            invalid or it contains an invalid value, a new <classname>Zend_Service_Technorati_Exception</classname> exception is
-            thrown. Additionally, the Technorati <acronym>API</acronym> interface could be temporally unavailable, or it could return a
-            response that is not well formed.
+            There are several reasons that may cause a
+            <classname>Zend_Service_Technorati</classname> query to fail.
+            <classname>Zend_Service_Technorati</classname> validates all parameters for any query
+            request. If a parameter is invalid or it contains an invalid value, a new
+            <classname>Zend_Service_Technorati_Exception</classname> exception is thrown.
+            Additionally, the Technorati <acronym>API</acronym> interface could be temporally
+            unavailable, or it could return a response that is not well formed.
         </para>
+
         <para>
-            You should always wrap a Technorati query with a <code>try</code>...<code>catch</code> block.
+            You should always wrap a Technorati query with a <code>try</code>...<code>catch</code>
+            block.
         </para>
+
         <example id="zend.service.technorati.handling-errors.example-1">
             <title>Handling a Query Exception</title>
+
             <programlisting language="php"><![CDATA[
 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 try {
@@ -216,19 +265,26 @@ try {
 
     <sect2 id="zend.service.technorati.checking-api-daily-usage">
         <title>Checking Your API Key Daily Usage</title>
+
         <para>
-            From time to time you probably will want to check your <acronym>API</acronym> key daily usage. By default Technorati limits
-            your <acronym>API</acronym> usage to 500 calls per day, and an exception is returned by <classname>Zend_Service_Technorati</classname>
-            if you try to use it beyond this limit. You can get information about your <acronym>API</acronym> key usage using the
+            From time to time you probably will want to check your <acronym>API</acronym> key daily
+            usage. By default Technorati limits your <acronym>API</acronym> usage to 500 calls per
+            day, and an exception is returned by <classname>Zend_Service_Technorati</classname> if
+            you try to use it beyond this limit. You can get information about your
+            <acronym>API</acronym> key usage using the
             <methodname>Zend_Service_Technorati::keyInfo()</methodname> method.
         </para>
+
         <para>
             <methodname>Zend_Service_Technorati::keyInfo()</methodname> returns a
-            <classname>Zend_Service_Technorati_KeyInfoResult</classname> object. For full details please see the
-            <ulink url="http://framework.zend.com/apidoc/core/">API reference guide</ulink>.
+            <classname>Zend_Service_Technorati_KeyInfoResult</classname> object. For full details
+            please see the <ulink url="http://framework.zend.com/apidoc/core/">API reference
+                guide</ulink>.
         </para>
+
         <example id="zend.service.technorati.checking-api-daily-usage.example-1">
             <title>Getting API key daily usage information</title>
+
             <programlisting language="php"><![CDATA[
 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 $key = $technorati->keyInfo();
@@ -242,31 +298,84 @@ echo "Daily Usage: " . $key->getApiQueries() . "/" .
 
     <sect2 id="zend.service.technorati.queries">
         <title>Available Technorati Queries</title>
+
         <para>
             <classname>Zend_Service_Technorati</classname> provides support for the following queries:
+
             <itemizedlist>
-                <listitem><para><link linkend="zend.service.technorati.queries.cosmos"><code>Cosmos</code></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.queries.search"><code>Search</code></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.queries.tag"><code>Tag</code></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.queries.dailycounts"><code>DailyCounts</code></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.queries.toptags"><code>TopTags</code></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.queries.bloginfo"><code>BlogInfo</code></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.queries.blogposttags"><code>BlogPostTags</code></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.queries.getinfo"><code>GetInfo</code></link></para></listitem>
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.queries.cosmos"><code>Cosmos</code></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.queries.search"><code>Search</code></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link linkend="zend.service.technorati.queries.tag"><code>Tag</code></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.queries.dailycounts"><code>DailyCounts</code></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.queries.toptags"><code>TopTags</code></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.queries.bloginfo"><code>BlogInfo</code></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.queries.blogposttags"><code>BlogPostTags</code></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.queries.getinfo"><code>GetInfo</code></link>
+                    </para>
+                </listitem>
             </itemizedlist>
         </para>
 
         <sect3 id="zend.service.technorati.queries.cosmos">
             <title>Technorati Cosmos</title>
+
             <para>
-                <ulink url="http://technorati.com/developers/api/cosmos.html">Cosmos</ulink> query lets you see what
-                blogs are linking to a given <acronym>URL</acronym>. It returns a
-                <link linkend="zend.service.technorati.classes.cosmosresultset"><classname>Zend_Service_Technorati_CosmosResultSet</classname></link>
-                object. For full details please see <methodname>Zend_Service_Technorati::cosmos()</methodname> in the
+                <ulink url="http://technorati.com/developers/api/cosmos.html">Cosmos</ulink> query
+                lets you see what blogs are linking to a given <acronym>URL</acronym>. It returns a
+                <link
+                    linkend="zend.service.technorati.classes.cosmosresultset"><classname>Zend_Service_Technorati_CosmosResultSet</classname></link>
+                object. For full details please see
+                <methodname>Zend_Service_Technorati::cosmos()</methodname> in the
                 <ulink url="http://framework.zend.com/apidoc/core/">API reference guide</ulink>.
             </para>
+
             <example id="zend.service.technorati.queries.cosmos.example-1">
                 <title>Cosmos Query</title>
+
                 <programlisting language="php"><![CDATA[
 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 $resultSet = $technorati->cosmos('http://devzone.zend.com/');
@@ -285,15 +394,19 @@ echo "</ol>";
 
         <sect3 id="zend.service.technorati.queries.search">
             <title>Technorati Search</title>
+
             <para>
-                The <ulink url="http://technorati.com/developers/api/search.html">Search</ulink> query lets you see
-                what blogs contain a given search string. It returns a
-                <link linkend="zend.service.technorati.classes.searchresultset"><classname>Zend_Service_Technorati_SearchResultSet</classname></link>
-                object. For full details please see <methodname>Zend_Service_Technorati::search()</methodname> in the
+                The <ulink url="http://technorati.com/developers/api/search.html">Search</ulink>
+                query lets you see what blogs contain a given search string. It returns a <link
+                    linkend="zend.service.technorati.classes.searchresultset"><classname>Zend_Service_Technorati_SearchResultSet</classname></link>
+                object. For full details please see
+                <methodname>Zend_Service_Technorati::search()</methodname> in the
                 <ulink url="http://framework.zend.com/apidoc/core/">API reference guide</ulink>.
             </para>
+
             <example id="zend.service.technorati.queries.search.example-1">
                 <title>Search Query</title>
+
                 <programlisting language="php"><![CDATA[
 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 $resultSet = $technorati->search('zend framework');
@@ -312,15 +425,19 @@ echo "</ol>";
 
         <sect3 id="zend.service.technorati.queries.tag">
             <title>Technorati Tag</title>
+
             <para>
-                The <ulink url="http://technorati.com/developers/api/tag.html">Tag</ulink> query lets you see what
-                posts are associated with a given tag. It returns a
-                <link linkend="zend.service.technorati.classes.tagresultset"><classname>Zend_Service_Technorati_TagResultSet</classname></link>
-                object. For full details please see <methodname>Zend_Service_Technorati::tag()</methodname> in the
+                The <ulink url="http://technorati.com/developers/api/tag.html">Tag</ulink> query
+                lets you see what posts are associated with a given tag. It returns a <link
+                    linkend="zend.service.technorati.classes.tagresultset"><classname>Zend_Service_Technorati_TagResultSet</classname></link>
+                object. For full details please see
+                <methodname>Zend_Service_Technorati::tag()</methodname> in the
                 <ulink url="http://framework.zend.com/apidoc/core/">API reference guide</ulink>.
             </para>
+
             <example id="zend.service.technorati.queries.tag.example-1">
                 <title>Tag Query</title>
+
                 <programlisting language="php"><![CDATA[
 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 $resultSet = $technorati->tag('php');
@@ -339,15 +456,21 @@ echo "</ol>";
 
         <sect3 id="zend.service.technorati.queries.dailycounts">
             <title>Technorati DailyCounts</title>
+
             <para>
-                The <ulink url="http://technorati.com/developers/api/dailycounts.html">DailyCounts</ulink> query
-                provides daily counts of posts containing the queried keyword. It returns a
-                <link linkend="zend.service.technorati.classes.dailycountsresultset"><classname>Zend_Service_Technorati_DailyCountsResultSet</classname></link>
-                object. For full details please see <methodname>Zend_Service_Technorati::dailyCounts()</methodname> in the
+                The <ulink
+                    url="http://technorati.com/developers/api/dailycounts.html">DailyCounts</ulink>
+                query provides daily counts of posts containing the queried keyword. It returns a
+                <link
+                    linkend="zend.service.technorati.classes.dailycountsresultset"><classname>Zend_Service_Technorati_DailyCountsResultSet</classname></link>
+                object. For full details please see
+                <methodname>Zend_Service_Technorati::dailyCounts()</methodname> in the
                 <ulink url="http://framework.zend.com/apidoc/core/">API reference guide</ulink>.
             </para>
+
             <example id="zend.service.technorati.queries.dailycounts.example-1">
                 <title>DailyCounts Query</title>
+
                 <programlisting language="php"><![CDATA[
 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 $resultSet = $technorati->dailyCounts('php');
@@ -363,15 +486,19 @@ echo "</ol>";
 
         <sect3 id="zend.service.technorati.queries.toptags">
             <title>Technorati TopTags</title>
+
             <para>
-                The <ulink url="http://technorati.com/developers/api/toptags.html">TopTags</ulink> query provides
-                information on top tags indexed by Technorati. It returns a
-                <link linkend="zend.service.technorati.classes.tagsresultset"><classname>Zend_Service_Technorati_TagsResultSet</classname></link>
-                object. For full details please see <methodname>Zend_Service_Technorati::topTags()</methodname> in the
+                The <ulink url="http://technorati.com/developers/api/toptags.html">TopTags</ulink>
+                query provides information on top tags indexed by Technorati. It returns a <link
+                    linkend="zend.service.technorati.classes.tagsresultset"><classname>Zend_Service_Technorati_TagsResultSet</classname></link>
+                object. For full details please see
+                <methodname>Zend_Service_Technorati::topTags()</methodname> in the
                 <ulink url="http://framework.zend.com/apidoc/core/">API reference guide</ulink>.
             </para>
+
             <example id="zend.service.technorati.queries.toptags.example-1">
                 <title>TopTags Query</title>
+
                 <programlisting language="php"><![CDATA[
 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 $resultSet = $technorati->topTags();
@@ -390,15 +517,20 @@ echo "</ol>";
 
         <sect3 id="zend.service.technorati.queries.bloginfo">
             <title>Technorati BlogInfo</title>
+
             <para>
-                The <ulink url="http://technorati.com/developers/api/bloginfo.html">BlogInfo</ulink> query provides
-                information on what blog, if any, is associated with a given <acronym>URL</acronym>. It returns a
-                <link linkend="zend.service.technorati.classes.bloginforesult"><classname>Zend_Service_Technorati_BlogInfoResult</classname></link>
-                object. For full details please see <methodname>Zend_Service_Technorati::blogInfo()</methodname> in the
+                The <ulink url="http://technorati.com/developers/api/bloginfo.html">BlogInfo</ulink>
+                query provides information on what blog, if any, is associated with a given
+                <acronym>URL</acronym>. It returns a <link
+                    linkend="zend.service.technorati.classes.bloginforesult"><classname>Zend_Service_Technorati_BlogInfoResult</classname></link>
+                object. For full details please see
+                <methodname>Zend_Service_Technorati::blogInfo()</methodname> in the
                 <ulink url="http://framework.zend.com/apidoc/core/">API reference guide</ulink>.
             </para>
+
             <example id="zend.service.technorati.queries.bloginfo.example-1">
                 <title>BlogInfo Query</title>
+
                 <programlisting language="php"><![CDATA[
 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 $result = $technorati->blogInfo('http://devzone.zend.com/');
@@ -411,15 +543,21 @@ echo '<h2><a href="' . (string) $result->getWeblog()->getUrl() . '">' .
 
         <sect3 id="zend.service.technorati.queries.blogposttags">
             <title>Technorati BlogPostTags</title>
+
             <para>
-                The <ulink url="http://technorati.com/developers/api/blogposttags.html">BlogPostTags</ulink> query
-                provides information on the top tags used by a specific blog. It returns a
-                <link linkend="zend.service.technorati.classes.tagsresultset"><classname>Zend_Service_Technorati_TagsResultSet</classname></link>
-                object. For full details please see <methodname>Zend_Service_Technorati::blogPostTags()</methodname> in the
+                The <ulink
+                    url="http://technorati.com/developers/api/blogposttags.html">BlogPostTags</ulink>
+                query provides information on the top tags used by a specific blog. It returns a
+                <link
+                    linkend="zend.service.technorati.classes.tagsresultset"><classname>Zend_Service_Technorati_TagsResultSet</classname></link>
+                object. For full details please see
+                <methodname>Zend_Service_Technorati::blogPostTags()</methodname> in the
                 <ulink url="http://framework.zend.com/apidoc/core/">API reference guide</ulink>.
             </para>
+
             <example id="zend.service.technorati.queries.blogposttags.example-1">
                 <title>BlogPostTags Query</title>
+
                 <programlisting language="php"><![CDATA[
 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 $resultSet = $technorati->blogPostTags('http://devzone.zend.com/');
@@ -438,15 +576,19 @@ echo "</ol>";
 
         <sect3 id="zend.service.technorati.queries.getinfo">
             <title>Technorati GetInfo</title>
+
             <para>
-                The <ulink url="http://technorati.com/developers/api/getinfo.html">GetInfo</ulink> query tells you
-                things that Technorati knows about a member. It returns a
-                <link linkend="zend.service.technorati.classes.getinforesult"><classname>Zend_Service_Technorati_GetInfoResult</classname></link>
-                object. For full details please see <methodname>Zend_Service_Technorati::getInfo()</methodname> in the
+                The <ulink url="http://technorati.com/developers/api/getinfo.html">GetInfo</ulink>
+                query tells you things that Technorati knows about a member. It returns a <link
+                    linkend="zend.service.technorati.classes.getinforesult"><classname>Zend_Service_Technorati_GetInfoResult</classname></link>
+                object. For full details please see
+                <methodname>Zend_Service_Technorati::getInfo()</methodname> in the
                 <ulink url="http://framework.zend.com/apidoc/core/">API reference guide</ulink>.
             </para>
+
             <example id="zend.service.technorati.queries.getinfo.example-1">
                 <title>GetInfo Query</title>
+
                 <programlisting language="php"><![CDATA[
 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 $result = $technorati->getInfo('weppos');
@@ -465,76 +607,183 @@ echo "</ol>";
 
         <sect3 id="zend.service.technorati.queries.keyinfo">
             <title>Technorati KeyInfo</title>
+
             <para>
-                The KeyInfo query provides information on daily usage of an <acronym>API</acronym> key. It returns a
-               <link linkend="zend.service.technorati.classes.keyinforesult"><classname>Zend_Service_Technorati_KeyInfoResult</classname></link>
-               object. For full details please see <methodname>Zend_Service_Technorati::keyInfo()</methodname> in the
-               <ulink url="http://framework.zend.com/apidoc/core/">API reference guide</ulink>.
+                The KeyInfo query provides information on daily usage of an <acronym>API</acronym>
+                key. It returns a <link
+                    linkend="zend.service.technorati.classes.keyinforesult"><classname>Zend_Service_Technorati_KeyInfoResult</classname></link>
+                object. For full details please see
+                <methodname>Zend_Service_Technorati::keyInfo()</methodname> in the
+                <ulink url="http://framework.zend.com/apidoc/core/">API reference guide</ulink>.
             </para>
         </sect3>
-
     </sect2>
 
     <sect2 id="zend.service.technorati.classes">
         <title>Zend_Service_Technorati Classes</title>
+
         <para>
             The following classes are returned by the various Technorati queries. Each
-            <classname>Zend_Service_Technorati_*ResultSet</classname> class holds a type-specific result set which can be easily
-            iterated, with each result being contained in a type result object. All result set classes extend
-            <classname>Zend_Service_Technorati_ResultSet</classname> class and implement the <code>SeekableIterator</code>
-            interface, allowing for easy iteration and seeking to a specific result.
+            <classname>Zend_Service_Technorati_*ResultSet</classname> class holds a type-specific
+            result set which can be easily iterated, with each result being contained in a type
+            result object. All result set classes extend
+            <classname>Zend_Service_Technorati_ResultSet</classname> class and implement the
+            <code>SeekableIterator</code> interface, allowing for easy iteration and seeking to a
+            specific result.
+
             <itemizedlist>
-                <listitem><para><link linkend="zend.service.technorati.classes.resultset"><classname>Zend_Service_Technorati_ResultSet</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.cosmosresultset"><classname>Zend_Service_Technorati_CosmosResultSet</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.searchresultset"><classname>Zend_Service_Technorati_SearchResultSet</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.tagresultset"><classname>Zend_Service_Technorati_TagResultSet</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.dailycountsresultset"><classname>Zend_Service_Technorati_DailyCountsResultSet</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.tagsresultset"><classname>Zend_Service_Technorati_TagsResultSet</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.result"><classname>Zend_Service_Technorati_Result</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.cosmosresult"><classname>Zend_Service_Technorati_CosmosResult</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.searchresult"><classname>Zend_Service_Technorati_SearchResult</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.tagresult"><classname>Zend_Service_Technorati_TagResult</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.dailycountsresult"><classname>Zend_Service_Technorati_DailyCountsResult</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.tagsresult"><classname>Zend_Service_Technorati_TagsResult</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.getinforesult"><classname>Zend_Service_Technorati_GetInfoResult</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.bloginforesult"><classname>Zend_Service_Technorati_BlogInfoResult</classname></link></para></listitem>
-                <listitem><para><link linkend="zend.service.technorati.classes.keyinforesult"><classname>Zend_Service_Technorati_KeyInfoResult</classname></link></para></listitem>
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.resultset"><classname>Zend_Service_Technorati_ResultSet</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.cosmosresultset"><classname>Zend_Service_Technorati_CosmosResultSet</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.searchresultset"><classname>Zend_Service_Technorati_SearchResultSet</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.tagresultset"><classname>Zend_Service_Technorati_TagResultSet</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.dailycountsresultset"><classname>Zend_Service_Technorati_DailyCountsResultSet</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.tagsresultset"><classname>Zend_Service_Technorati_TagsResultSet</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.result"><classname>Zend_Service_Technorati_Result</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.cosmosresult"><classname>Zend_Service_Technorati_CosmosResult</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.searchresult"><classname>Zend_Service_Technorati_SearchResult</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.tagresult"><classname>Zend_Service_Technorati_TagResult</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.dailycountsresult"><classname>Zend_Service_Technorati_DailyCountsResult</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.tagsresult"><classname>Zend_Service_Technorati_TagsResult</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.getinforesult"><classname>Zend_Service_Technorati_GetInfoResult</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.bloginforesult"><classname>Zend_Service_Technorati_BlogInfoResult</classname></link>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <link
+                            linkend="zend.service.technorati.classes.keyinforesult"><classname>Zend_Service_Technorati_KeyInfoResult</classname></link>
+                    </para>
+                </listitem>
             </itemizedlist>
         </para>
+
         <note>
             <para>
-                <classname>Zend_Service_Technorati_GetInfoResult</classname>, <classname>Zend_Service_Technorati_BlogInfoResult</classname>
-                and <classname>Zend_Service_Technorati_KeyInfoResult</classname> represent exceptions to the above because they
-                don't belong to a result set and they don't implement any interface. They represent a single response
-                object and they act as a wrapper for additional <classname>Zend_Service_Technorati</classname> objects, such as
-                <classname>Zend_Service_Technorati_Author</classname> and <classname>Zend_Service_Technorati_Weblog</classname>.
+                <classname>Zend_Service_Technorati_GetInfoResult</classname>,
+                <classname>Zend_Service_Technorati_BlogInfoResult</classname> and
+                <classname>Zend_Service_Technorati_KeyInfoResult</classname> represent exceptions to
+                the above because they don't belong to a result set and they don't implement any
+                interface. They represent a single response object and they act as a wrapper for
+                additional <classname>Zend_Service_Technorati</classname> objects, such as
+                <classname>Zend_Service_Technorati_Author</classname> and
+                <classname>Zend_Service_Technorati_Weblog</classname>.
             </para>
         </note>
+
         <para>
-            The <classname>Zend_Service_Technorati</classname> library includes additional convenient classes representing
-            specific response objects. <classname>Zend_Service_Technorati_Author</classname> represents a single Technorati
-            account, also known as a blog author or blogger. <classname>Zend_Service_Technorati_Weblog</classname> represents a
-            single weblog object, along with all specific weblog properties such as feed <acronym>URL</acronym>s or blog name. For full
-            details please see <classname>Zend_Service_Technorati</classname> in the
+            The <classname>Zend_Service_Technorati</classname> library includes additional
+            convenient classes representing specific response objects.
+            <classname>Zend_Service_Technorati_Author</classname> represents a single Technorati
+            account, also known as a blog author or blogger.
+            <classname>Zend_Service_Technorati_Weblog</classname> represents a single weblog object,
+            along with all specific weblog properties such as feed <acronym>URL</acronym>s or blog
+            name. For full details please see <classname>Zend_Service_Technorati</classname> in the
             <ulink url="http://framework.zend.com/apidoc/core/">API reference guide</ulink>.
         </para>
 
         <sect3 id="zend.service.technorati.classes.resultset">
             <title>Zend_Service_Technorati_ResultSet</title>
+
             <para>
-                <classname>Zend_Service_Technorati_ResultSet</classname> is the most essential result set. The scope of this
-                class is to be extended by a query-specific child result set class, and it should never be used to
-                initialize a standalone object. Each of the specific result sets represents a collection of
-                query-specific
-                <link linkend="zend.service.technorati.classes.result"><classname>Zend_Service_Technorati_Result</classname></link>
+                <classname>Zend_Service_Technorati_ResultSet</classname> is the most essential
+                result set. The scope of this class is to be extended by a query-specific child
+                result set class, and it should never be used to initialize a standalone object.
+                Each of the specific result sets represents a collection of query-specific <link
+                    linkend="zend.service.technorati.classes.result"><classname>Zend_Service_Technorati_Result</classname></link>
                 objects.
             </para>
+
             <para>
-                <classname>Zend_Service_Technorati_ResultSet</classname> implements the <acronym>PHP</acronym> <code>SeekableIterator</code>
-                interface, and you can iterate all result objects via the <acronym>PHP</acronym> <code>foreach</code> statement.
+                <classname>Zend_Service_Technorati_ResultSet</classname> implements the
+                <acronym>PHP</acronym> <code>SeekableIterator</code> interface, and you can iterate
+                all result objects via the <acronym>PHP</acronym> <code>foreach</code> statement.
             </para>
+
             <example id="zend.service.technorati.classes.resultset.example-1">
                 <title>Iterating result objects from a resultset collection</title>
+
                 <programlisting language="php"><![CDATA[
 // run a simple query
 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
@@ -553,183 +802,218 @@ foreach ($resultSet as $result) {
 
         <sect3 id="zend.service.technorati.classes.cosmosresultset">
             <title>Zend_Service_Technorati_CosmosResultSet</title>
+
             <para>
-                <classname>Zend_Service_Technorati_CosmosResultSet</classname> represents a Technorati Cosmos query result set.
+                <classname>Zend_Service_Technorati_CosmosResultSet</classname> represents a
+                Technorati Cosmos query result set.
             </para>
+
             <note>
                 <para>
-                    <classname>Zend_Service_Technorati_CosmosResultSet</classname> extends
-                    <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>.
+                    <classname>Zend_Service_Technorati_CosmosResultSet</classname> extends <link
+                        linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>.
                 </para>
             </note>
         </sect3>
 
         <sect3 id="zend.service.technorati.classes.searchresultset">
             <title>Zend_Service_Technorati_SearchResultSet</title>
+
             <para>
-                <classname>Zend_Service_Technorati_SearchResultSet</classname> represents a Technorati Search query result set.
+                <classname>Zend_Service_Technorati_SearchResultSet</classname> represents a
+                Technorati Search query result set.
             </para>
+
             <note>
                 <para>
-                    <classname>Zend_Service_Technorati_SearchResultSet</classname> extends
-                    <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>.
+                    <classname>Zend_Service_Technorati_SearchResultSet</classname> extends <link
+                        linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>.
                 </para>
             </note>
         </sect3>
 
         <sect3 id="zend.service.technorati.classes.tagresultset">
             <title>Zend_Service_Technorati_TagResultSet</title>
+
             <para>
-                <classname>Zend_Service_Technorati_TagResultSet</classname> represents a Technorati Tag query result set.
+                <classname>Zend_Service_Technorati_TagResultSet</classname> represents a Technorati
+                Tag query result set.
             </para>
+
             <note>
                 <para>
-                    <classname>Zend_Service_Technorati_TagResultSet</classname> extends
-                    <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>.
+                    <classname>Zend_Service_Technorati_TagResultSet</classname> extends <link
+                        linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>.
                 </para>
             </note>
         </sect3>
 
         <sect3 id="zend.service.technorati.classes.dailycountsresultset">
             <title>Zend_Service_Technorati_DailyCountsResultSet</title>
+
             <para>
-                <classname>Zend_Service_Technorati_DailyCountsResultSet</classname> represents a Technorati DailyCounts query result set.
+                <classname>Zend_Service_Technorati_DailyCountsResultSet</classname> represents a
+                Technorati DailyCounts query result set.
             </para>
+
             <note>
                 <para>
                     <classname>Zend_Service_Technorati_DailyCountsResultSet</classname> extends
-                    <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>.
+                    <link
+                        linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>.
                 </para>
             </note>
         </sect3>
 
         <sect3 id="zend.service.technorati.classes.tagsresultset">
             <title>Zend_Service_Technorati_TagsResultSet</title>
+
             <para>
-                <classname>Zend_Service_Technorati_TagsResultSet</classname> represents a Technorati TopTags or BlogPostTags queries result set.
+                <classname>Zend_Service_Technorati_TagsResultSet</classname> represents a Technorati
+                TopTags or BlogPostTags queries result set.
             </para>
+
             <note>
                 <para>
                     <classname>Zend_Service_Technorati_TagsResultSet</classname> extends
-                    <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>.
+                    <link
+                        linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>.
                 </para>
             </note>
         </sect3>
 
         <sect3 id="zend.service.technorati.classes.result">
             <title>Zend_Service_Technorati_Result</title>
+
             <para>
-                <classname>Zend_Service_Technorati_Result</classname> is the most essential result object. The scope of this
-                class is to be extended by a query specific child result class, and it should never be used to
-                initialize a standalone object.
+                <classname>Zend_Service_Technorati_Result</classname> is the most essential result
+                object. The scope of this class is to be extended by a query specific child result
+                class, and it should never be used to initialize a standalone object.
             </para>
         </sect3>
 
         <sect3 id="zend.service.technorati.classes.cosmosresult">
             <title>Zend_Service_Technorati_CosmosResult</title>
+
             <para>
-                <classname>Zend_Service_Technorati_CosmosResult</classname> represents a single Technorati Cosmos query result
-                object. It is never returned as a standalone object, but it always belongs to a valid
-                <link linkend="zend.service.technorati.classes.cosmosresultset">Zend_Service_Technorati_CosmosResultSet</link>
+                <classname>Zend_Service_Technorati_CosmosResult</classname> represents a single
+                Technorati Cosmos query result object. It is never returned as a standalone object,
+                but it always belongs to a valid <link
+                    linkend="zend.service.technorati.classes.cosmosresultset">Zend_Service_Technorati_CosmosResultSet</link>
                 object.
             </para>
+
             <note>
                 <para>
-                    <classname>Zend_Service_Technorati_CosmosResult</classname> extends
-                    <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>.
+                    <classname>Zend_Service_Technorati_CosmosResult</classname> extends <link
+                        linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>.
                 </para>
             </note>
         </sect3>
 
         <sect3 id="zend.service.technorati.classes.searchresult">
             <title>Zend_Service_Technorati_SearchResult</title>
+
             <para>
-                <classname>Zend_Service_Technorati_SearchResult</classname> represents a single Technorati Search query result
-                object. It is never returned as a standalone object, but it always belongs to a valid
-                <link linkend="zend.service.technorati.classes.searchresultset">Zend_Service_Technorati_SearchResultSet</link>
+                <classname>Zend_Service_Technorati_SearchResult</classname> represents a single
+                Technorati Search query result object. It is never returned as a standalone object,
+                but it always belongs to a valid <link
+                    linkend="zend.service.technorati.classes.searchresultset">Zend_Service_Technorati_SearchResultSet</link>
                 object.
             </para>
+
             <note>
                 <para>
-                    <classname>Zend_Service_Technorati_SearchResult</classname> extends
-                    <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>.
+                    <classname>Zend_Service_Technorati_SearchResult</classname> extends <link
+                        linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>.
                 </para>
             </note>
         </sect3>
 
         <sect3 id="zend.service.technorati.classes.tagresult">
             <title>Zend_Service_Technorati_TagResult</title>
+
             <para>
-                <classname>Zend_Service_Technorati_TagResult</classname> represents a single Technorati Tag query result object.
-                It is never returned as a standalone object, but it always belongs to a valid
-                <link linkend="zend.service.technorati.classes.tagresultset">Zend_Service_Technorati_TagResultSet</link>
+                <classname>Zend_Service_Technorati_TagResult</classname> represents a single
+                Technorati Tag query result object. It is never returned as a standalone object, but
+                it always belongs to a valid <link
+                    linkend="zend.service.technorati.classes.tagresultset">Zend_Service_Technorati_TagResultSet</link>
                 object.
             </para>
+
             <note>
                 <para>
-                    <classname>Zend_Service_Technorati_TagResult</classname> extends
-                    <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>.
+                    <classname>Zend_Service_Technorati_TagResult</classname> extends <link
+                        linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>.
                 </para>
             </note>
         </sect3>
 
         <sect3 id="zend.service.technorati.classes.dailycountsresult">
             <title>Zend_Service_Technorati_DailyCountsResult</title>
+
             <para>
-                <classname>Zend_Service_Technorati_DailyCountsResult</classname> represents a single Technorati DailyCounts query
-                result object. It is never returned as a standalone object, but it always belongs to a valid
-                <link linkend="zend.service.technorati.classes.dailycountsresultset">Zend_Service_Technorati_DailyCountsResultSet</link>
+                <classname>Zend_Service_Technorati_DailyCountsResult</classname> represents a single
+                Technorati DailyCounts query result object. It is never returned as a standalone
+                object, but it always belongs to a valid <link
+                    linkend="zend.service.technorati.classes.dailycountsresultset">Zend_Service_Technorati_DailyCountsResultSet</link>
                 object.
             </para>
+
             <note>
                 <para>
-                    <classname>Zend_Service_Technorati_DailyCountsResult</classname> extends
-                    <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>.
+                    <classname>Zend_Service_Technorati_DailyCountsResult</classname> extends <link
+                        linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>.
                 </para>
             </note>
         </sect3>
 
         <sect3 id="zend.service.technorati.classes.tagsresult">
             <title>Zend_Service_Technorati_TagsResult</title>
+
             <para>
-                <classname>Zend_Service_Technorati_TagsResult</classname> represents a single Technorati TopTags or BlogPostTags
-                query result object. It is never returned as a standalone object, but it always belongs to a valid
-                <link linkend="zend.service.technorati.classes.tagsresultset">Zend_Service_Technorati_TagsResultSet </link>
+                <classname>Zend_Service_Technorati_TagsResult</classname> represents a single
+                Technorati TopTags or BlogPostTags query result object. It is never returned as a
+                standalone object, but it always belongs to a valid <link
+                    linkend="zend.service.technorati.classes.tagsresultset">Zend_Service_Technorati_TagsResultSet </link>
                 object.
             </para>
+
             <note>
                 <para>
-                    <classname>Zend_Service_Technorati_TagsResult</classname> extends
-                    <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>.
+                    <classname>Zend_Service_Technorati_TagsResult</classname> extends <link
+                        linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>.
                 </para>
             </note>
         </sect3>
 
         <sect3 id="zend.service.technorati.classes.getinforesult">
             <title>Zend_Service_Technorati_GetInfoResult</title>
+
             <para>
-                <classname>Zend_Service_Technorati_GetInfoResult</classname> represents a single Technorati GetInfo query result
-                object.
+                <classname>Zend_Service_Technorati_GetInfoResult</classname> represents a single
+                Technorati GetInfo query result object.
             </para>
         </sect3>
 
         <sect3 id="zend.service.technorati.classes.bloginforesult">
             <title>Zend_Service_Technorati_BlogInfoResult</title>
+
             <para>
-                <classname>Zend_Service_Technorati_BlogInfoResult</classname> represents a single Technorati BlogInfo query
-                result object.
+                <classname>Zend_Service_Technorati_BlogInfoResult</classname> represents a single
+                Technorati BlogInfo query result object.
             </para>
         </sect3>
 
         <sect3 id="zend.service.technorati.classes.keyinforesult">
             <title>Zend_Service_Technorati_KeyInfoResult</title>
+
             <para>
-                <classname>Zend_Service_Technorati_KeyInfoResult</classname> represents a single Technorati KeyInfo query result
-                object. It provides information about your
-                <link linkend="zend.service.technorati.checking-api-daily-usage">Technorati <acronym>API</acronym> Key daily usage</link>.
+                <classname>Zend_Service_Technorati_KeyInfoResult</classname> represents a single
+                Technorati KeyInfo query result object. It provides information about your
+                <link linkend="zend.service.technorati.checking-api-daily-usage">Technorati
+                    <acronym>API</acronym> Key daily usage</link>.
             </para>
         </sect3>
-
     </sect2>
-
 </sect1>

documentation/manual/en/module_specs/Zend_Service_Twitter.xml

@@ -92,6 +92,7 @@
 
         <example id="zend.service.twitter.authentication.example">
             <title>Creating the Twitter Class</title>
+
             <para>
                 The following code sample is how you create the Twitter service, pass in your
                 username and password, and verify that they are correct.
@@ -419,12 +420,14 @@ $response   = $twitter->user->friends();
                             return a list of friends.
                         </para>
                     </listitem>
+
                     <listitem>
                         <para>
                             <code>since</code> narrows the returned results to just those statuses
                             created after the specified date/time (up to 24 hours old).
                         </para>
                     </listitem>
+
                     <listitem>
                         <para>
                             <code>page</code> specifies which page you want to return.
@@ -526,6 +529,7 @@ $response   = $twitter->directMessage->messages();
                             created after the specified date/time (up to 24 hours old).
                         </para>
                     </listitem>
+
                     <listitem>
                         <para>
                             <code>page</code> specifies which page you want to return.
@@ -591,7 +595,6 @@ $twitter    = new Zend_Service_Twitter('myusername', 'mysecretpassword');
 $response   = $twitter->directMessage->new('myfriend', 'mymessage');
 ]]></programlisting>
                 </example>
-
             </listitem>
 
             <listitem>
@@ -625,6 +628,7 @@ $response   = $twitter->directMessage->destroy(123548);
 
                 <example id="zend.service.twitter.friendship.create">
                     <title>Creating friend</title>
+
                     <programlisting language="php"><![CDATA[
 $twitter    = new Zend_Service_Twitter('myusername', 'mysecretpassword');
 $response   = $twitter->friendship->create('mynewfriend');

documentation/manual/en/module_specs/Zend_Service_Twitter_Search.xml

@@ -117,6 +117,7 @@ foreach ($twitterTrends as $trend) {
                 </para>
             </listitem>
         </itemizedlist>
+
         <example id="zend.service.twitter.search.search.json">
             <title>JSON Search Example</title>
 
@@ -134,7 +135,8 @@ $searchResults  = $twitterSearch->search('zend', array('lang' => 'en'));
             <title>ATOM Search Example</title>
 
             <para>
-                The following code sample will return a <classname>Zend_Feed_Atom</classname> object.
+                The following code sample will return a <classname>Zend_Feed_Atom</classname>
+                object.
             </para>
 
             <programlisting language="php"><![CDATA[

documentation/manual/en/module_specs/Zend_XmlRpc_Server.xml

@@ -680,7 +680,6 @@ $server->setResponseClass('Services_Response');
 
 echo $server->handle($request);
 ]]></programlisting>
-
         </example>
 
         <note>