[MANUAL] English:

- second fix for r22773

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

documentation/manual/en/module_specs/Zend_Service_WindowsAzure_Queue.xml

@@ -7,7 +7,7 @@
         The Queue service stores messages that may be read by any client who has access to the
         storage account.
     </para>
-    
+
     <para>
         A queue can contain an unlimited number of messages, each of which can be up to 8 KB in
         size. Messages are generally added to the end of the queue and retrieved from the front of
@@ -17,9 +17,10 @@
     </para>
 
     <para>
-        Queue Storage is offered by Windows Azure as a <acronym>REST</acronym> API which is wrapped
-        by the <classname>Zend_Service_WindowsAzure_Storage_Queue</classname> class in order to
-        provide a native PHP interface to the storage account.
+        Queue Storage is offered by Windows Azure as a <acronym>REST</acronym>
+        <acronym>API</acronym> which is wrapped by the
+        <classname>Zend_Service_WindowsAzure_Storage_Queue</classname> class in order to
+        provide a native <acronym>PHP</acronym> interface to the storage account.
     </para>
 
     <sect2 id="zend.service.windowsazure.storage.queue.api">
@@ -28,8 +29,8 @@
         <para>
             This topic lists some examples of using the
             <classname>Zend_Service_WindowsAzure_Storage_Queue</classname> class.  Other features
-            are available in the download package, as well as a detailed API documentation of those
-            features.
+            are available in the download package, as well as a detailed <acronym>API</acronym>
+            documentation of those features.
         </para>
 
         <sect3 id="zend.service.windowsazure.storage.queue.api.create-queue">
@@ -83,7 +84,7 @@ $storageClient->deleteQueue('testqueue');
 $storageClient = new Zend_Service_WindowsAzure_Storage_Queue();
 
 // 3600 = time-to-live of the message, if omitted defaults to 7 days
-$storageClient->putMessage('testqueue', 'This is a test message', 3600); 
+$storageClient->putMessage('testqueue', 'This is a test message', 3600);
 ]]></programlisting>
             </example>
         </sect3>
@@ -110,11 +111,11 @@ foreach ($messages as $message) {
 }
 ]]></programlisting>
             </example>
-            
+
             <para>
                 The messages that are read using <methodname>getMessages()</methodname> will be
                 invisible in the queue for 30 seconds, after which the messages will re-appear in
-                the queue.  To mark a message as processed and remove it from the queue, use the
+                the queue. To mark a message as processed and remove it from the queue, use the
                 <methodname>deleteMessage()</methodname> method.
             </para>
 
@@ -141,7 +142,7 @@ foreach ($messages as $message) {
             <title>Check if there are messages in a queue</title>
 
             <para>
-                Using the following code, a queue can be checked for new messages.  Note that the
+                Using the following code, a queue can be checked for new messages. Note that the
                 queue and message have already been created before.
             </para>
 
@@ -159,11 +160,11 @@ foreach ($messages as $message) {
 }
 ]]></programlisting>
             </example>
-            
+
             <para>
                 Note that messages that are read using <methodname>peekMessages()</methodname> will
                 not become invisible in the queue, nor can they be marked as processed using the
-                <methodname>deleteMessage()</methodname> method.  To do this, use
+                <methodname>deleteMessage()</methodname> method. To do this, use
                 <methodname>getMessages()</methodname> instead.
             </para>
         </sect3>

documentation/manual/en/module_specs/Zend_Service_WindowsAzure_Table.xml

@@ -8,22 +8,22 @@
     </para>
 
     <para>
-        Table Storage is offered by Windows Azure as a REST API which is wrapped by the
-        <classname>Zend_Service_WindowsAzure_Storage_Table</classname> class in order to provide a
-        native PHP interface to the storage account.
+        Table Storage is offered by Windows Azure as a REST <acronym>API</acronym> which is wrapped
+        by the <classname>Zend_Service_WindowsAzure_Storage_Table</classname> class in order to
+        provide a native <acronym>PHP</acronym> interface to the storage account.
     </para>
 
     <para>
         This topic lists some examples of using the
-        <classname>Zend_Service_WindowsAzure_Storage_Table</classname> class.  Other features are
-        available in the download package, as well as a detailed API documentation of those
-        features.
+        <classname>Zend_Service_WindowsAzure_Storage_Table</classname> class. Other features are
+        available in the download package, as well as a detailed <acronym>API</acronym>
+        documentation of those features.
     </para>
 
     <para>
-        Note that development table storage (in the Windows Azure SDK) does not support all features
-        provided by the API. Therefore, the examples listed on this page are to be used on Windows
-        Azure production table storage.
+        Note that development table storage (in the Windows Azure <acronym>SDK</acronym>) does not
+        support all features provided by the <acronym>API</acronym>. Therefore, the examples listed
+        on this page are to be used on Windows Azure production table storage.
     </para>
 
     <sect2 id="zend.service.windowsazure.storage.table.api">
@@ -83,17 +83,17 @@ foreach ($result as $table) {
         <title>Operations on entities</title>
 
         <para>
-            Tables store data as collections of entities. Entities are similar to rows.  An entity
+            Tables store data as collections of entities. Entities are similar to rows. An entity
             has a primary key and a set of properties. A property is a named, typed-value pair,
             similar to a column.
         </para>
-        
+
         <para>
             The Table service does not enforce any schema for tables, so two entities in the same
             table may have different sets of properties. Developers may choose to enforce a schema
             on the client side. A table may contain any number of entities.
         </para>
-        
+
         <para>
             <classname>Zend_Service_WindowsAzure_Storage_Table</classname> provides 2 ways of
             working with entities:
@@ -127,12 +127,12 @@ class SampleEntity extends Zend_Service_WindowsAzure_Storage_TableEntity
     * @azure Name
     */
     public $Name;
-    
+
     /**
     * @azure Age Edm.Int64
     */
     public $Age;
-    
+
     /**
     * @azure Visible Edm.Boolean
     */
@@ -154,7 +154,7 @@ class SampleEntity extends Zend_Service_WindowsAzure_Storage_TableEntity
                 To enforce a schema on the client side using the
                 <classname>Zend_Service_WindowsAzure_Storage_Table</classname> class, you can create
                 a class which inherits
-                <classname>Zend_Service_WindowsAzure_Storage_TableEntity</classname>.  This class
+                <classname>Zend_Service_WindowsAzure_Storage_TableEntity</classname>. This class
                 provides some basic functionality for the
                 <classname>Zend_Service_WindowsAzure_Storage_Table</classname> class to work with a
                 client-side schema.
@@ -210,12 +210,12 @@ class SampleEntity extends Zend_Service_WindowsAzure_Storage_TableEntity
      * @azure Name
      */
     public $Name;
-    
+
     /**
      * @azure Age Edm.Int64
      */
     public $Age;
-    
+
     /**
      * @azure Visible Edm.Boolean
      */
@@ -249,7 +249,8 @@ public $<property name in PHP>;
                 storage:
             </para>
 
-            <example id="zend.service.windowsazure.storage.table.entities.enforced.schema-property-sample">
+            <example
+                id="zend.service.windowsazure.storage.table.entities.enforced.schema-property-sample">
                 <title>Sample enforced property</title>
 
                 <programlisting language="php"><![CDATA[
@@ -332,9 +333,10 @@ public $Age;
                 To use the <classname>Zend_Service_WindowsAzure_Storage_Table</classname> class
                 without defining a schema, you can make use of the
                 <classname>Zend_Service_WindowsAzure_Storage_DynamicTableEntity</classname> class.
-                This class inherits <classname>Zend_Service_WindowsAzure_Storage_TableEntity</classname>
-                like an enforced schema class does, but contains additional logic to make it dynamic
-                and not bound to a schema.
+                This class inherits
+                <classname>Zend_Service_WindowsAzure_Storage_TableEntity</classname> like an
+                enforced schema class does, but contains additional logic to make it dynamic and not
+                bound to a schema.
             </para>
 
             <para>
@@ -378,7 +380,10 @@ public $Age;
             </para>
 
             <example id="zend.service.windowsazure.storage.table.entities.dynamic.schema">
-                <title>Dynamicaly adding properties to Zend_Service_WindowsAzure_Storage_DynamicTableEntity</title>
+                <title>
+                    Dynamicaly adding properties to
+                    Zend_Service_WindowsAzure_Storage_DynamicTableEntity
+                </title>
 
                 <programlisting language="php"><![CDATA[
 $target = new Zend_Service_WindowsAzure_Storage_DynamicTableEntity(
@@ -393,8 +398,11 @@ $target->Age  = 25;     // Will add property "Age" of type "Edm.Int32"
                 Optionally, a property type can be enforced:
             </para>
 
-            <example id="zend.service.windowsazure.storage.table.entities.dynamic.schema-forcedproperties">
-                <title>Forcing property types on Zend_Service_WindowsAzure_Storage_DynamicTableEntity</title>
+            <example
+                id="zend.service.windowsazure.storage.table.entities.dynamic.schema-forcedproperties">
+                <title>
+                    Forcing property types on Zend_Service_WindowsAzure_Storage_DynamicTableEntity
+                </title>
 
                 <programlisting language="php"><![CDATA[
 $target = new Zend_Service_WindowsAzure_Storage_DynamicTableEntity(
@@ -404,7 +412,7 @@ $target->Name = 'Name'; // Will add property "Name" of type "Edm.String"
 $target->Age  = 25;     // Will add property "Age" of type "Edm.Int32"
 
 // Change type of property "Age" to "Edm.Int32":
-$target->setAzurePropertyType('Age', 'Edm.Int64'); 
+$target->setAzurePropertyType('Age', 'Edm.Int64');
 ]]></programlisting>
             </example>
 
@@ -424,7 +432,7 @@ $target->setAzurePropertyType('Age', 'Edm.Int64');
 
                 <para>
                     Using the following code, an entity can be inserted into a table named
-                    "testtable".  Note that the table has already been created before.
+                    "testtable". Note that the table has already been created before.
                 </para>
 
                 <example id="zend.service.windowsazure.storage.table.api.entities.insert.example">
@@ -453,10 +461,11 @@ echo 'Etag: ' . $result->getEtag() . "\n";
 
                 <para>
                     Using the following code, an entity can be retrieved by partition key and row
-                    key.  Note that the table and entity have already been created before.
+                    key. Note that the table and entity have already been created before.
                 </para>
 
-                <example id="zend.service.windowsazure.storage.table.entities.api.retrieve-by-id.example">
+                <example
+                    id="zend.service.windowsazure.storage.table.entities.api.retrieve-by-id.example">
                     <title>Retrieving an entity by partition key and row key</title>
 
                     <programlisting language="php"><![CDATA[
@@ -501,7 +510,8 @@ $result = $storageClient->updateEntity('testtable', $entity);
                     newer data.
                 </para>
 
-                <example id="zend.service.windowsazure.storage.table.entities.api.updating.example-etag">
+                <example
+                    id="zend.service.windowsazure.storage.table.entities.api.updating.example-etag">
                     <title>Updating an entity (with Etag check)</title>
 
                     <programlisting language="php"><![CDATA[
@@ -515,7 +525,7 @@ $entity = $storageClient->retrieveEntityById(
 $entity->Name = 'New name';
 
 // last parameter instructs the Etag check:
-$result = $storageClient->updateEntity('testtable', $entity, true); 
+$result = $storageClient->updateEntity('testtable', $entity, true);
 ]]></programlisting>
                 </example>
             </sect4>
@@ -524,7 +534,7 @@ $result = $storageClient->updateEntity('testtable', $entity, true);
                 <title>Deleting an entity</title>
 
                 <para>
-                    Using the following code, an entity can be deleted.  Note that the table and
+                    Using the following code, an entity can be deleted. Note that the table and
                     entity have already been created before.
                 </para>
 
@@ -569,7 +579,7 @@ $result = $storageClient->deleteEntity('testtable', $entity);
             </itemizedlist>
 
             <para>
-                Using the following code, a table can be queried using a filter condition.  Note
+                Using the following code, a table can be queried using a filter condition. Note
                 that the table and entities have already been created before.
             </para>
 
@@ -593,7 +603,7 @@ foreach ($entities as $entity) {
             </example>
 
             <para>
-                Using the following code, a table can be queried using a fluent interface.  Note
+                Using the following code, a table can be queried using a fluent interface. Note
                 that the table and entities have already been created before.
             </para>
 
@@ -646,35 +656,37 @@ $storageClient = new Zend_Service_WindowsAzure_Storage_Table(
 
 // Start batch
 $batch = $storageClient->startBatch();
-            
+
 // Insert entities in batch
 $entities = generateEntities();
 foreach ($entities as $entity) {
     $storageClient->insertEntity($tableName, $entity);
 }
-            
+
 // Commit
 $batch->commit();
 ]]></programlisting>
             </example>
         </sect3>
     </sect2>
-  
+
     <sect2 id="zend.service.windowsazure.storage.table.sessionhandler">
         <title>Table storage session handler</title>
 
         <para>
-            When running a PHP application on the Windows Azure platform in a load-balanced mode
-            (running 2 Web Role instances or more), it is important that PHP session data can be
-            shared between multiple Web Role instances. The Windows Azure SDK for PHP provides the
+            When running a <acronym>PHP</acronym> application on the Windows Azure platform in a
+            load-balanced mode (running 2 Web Role instances or more), it is important that
+            <acronym>PHP</acronym> session data can be shared between multiple Web Role instances.
+            The Windows Azure <acronym>SDK</acronym> for <acronym>PHP</acronym> provides the
             <classname>Zend_Service_WindowsAzure_SessionHandler</classname> class, which uses
-            Windows Azure Table Storage as a session handler for PHP applications.
+            Windows Azure Table Storage as a session handler for <acronym>PHP</acronym>
+            applications.
         </para>
-        
+
         <para>
             To use the <classname>Zend_Service_WindowsAzure_SessionHandler</classname> session
-            handler, it should be registered as the default session handler for your PHP
-            application:
+            handler, it should be registered as the default session handler for your
+            <acronym>PHP</acronym> application:
         </para>
 
         <example id="zend.service.windowsazure.storage.table.api.sessionhandler-register">
@@ -691,19 +703,20 @@ $sessionHandler = new Zend_Service_WindowsAzure_SessionHandler(
 $sessionHandler->register();
 ]]></programlisting>
         </example>
-    
+
         <para>
             The above classname registers the
             <classname>Zend_Service_WindowsAzure_SessionHandler</classname> session handler and will
             store sessions in a table called "sessionstable".
         </para>
-        
+
         <para>
             After registration of the
             <classname>Zend_Service_WindowsAzure_SessionHandler</classname> session handler,
-            sessions can be started and used in the same way as a normal PHP session:
+            sessions can be started and used in the same way as a normal <acronym>PHP</acronym>
+            session:
         </para>
-        
+
         <example id="zend.service.windowsazure.storage.table.api.sessionhandler-usage">
             <title>Using table storage session handler</title>
 
@@ -726,11 +739,11 @@ if (!isset($_SESSION['firstVisit'])) {
 // ...
 ]]></programlisting>
         </example>
-    
+
         <warning>
             <para>
                 The <classname>Zend_Service_WindowsAzure_SessionHandler</classname> session handler
-                should be registered before a call to <functionname>session_start()</functionname>
+                should be registered before a call to <methodname>session_start()</methodname>
                 is made!
             </para>
         </warning>