[richfaces-svn-commits] JBoss Rich Faces SVN: r12116 - trunk/docs/userguide/en/src/main/docbook/included.

[richfaces-svn-commits at lists.jboss.org]

Author: cluts
Date: 2009-01-05 13:23:59 -0500 (Mon, 05 Jan 2009)
New Revision: 12116

Modified:
   trunk/docs/userguide/en/src/main/docbook/included/queue.desc.xml
   trunk/docs/userguide/en/src/main/docbook/included/queue.xml
Log:
RF-4664 - information for the some sections has been updated

Modified: trunk/docs/userguide/en/src/main/docbook/included/queue.desc.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/queue.desc.xml	2009-01-05 18:17:49 UTC (rev 12115)
+++ trunk/docs/userguide/en/src/main/docbook/included/queue.desc.xml	2009-01-05 18:23:59 UTC (rev 12116)
@@ -7,7 +7,8 @@
         </keywordset>
     </sectioninfo>
         <title>Description</title>
-        <para>The <emphasis role="bold"><property>&lt;a4j:queue&gt;</property></emphasis> component creates queues of requests of Ajax request that other Ajax4JSF or RichFaces components can reference and use.</para> 
-        <para>This component can manage server requests of the components, which referred to it, with help of its attributes.</para>
+        <para>The <emphasis role="bold"><property>&lt;a4j:queue&gt;</property></emphasis> component creates queues of requests of Ajax request. 
+            With the help of this component other Ajax4JSF or RichFaces components can reference and use it.</para> 
+        <para>By means of the attributes of this component you can manage server requests of the components, which refered to it.</para>
         </section>
 </chapter>
\ No newline at end of file

Modified: trunk/docs/userguide/en/src/main/docbook/included/queue.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/queue.xml	2009-01-05 18:17:49 UTC (rev 12115)
+++ trunk/docs/userguide/en/src/main/docbook/included/queue.xml	2009-01-05 18:23:59 UTC (rev 12116)
@@ -37,7 +37,9 @@
     
     <section>
         <title>Creating on a page</title>
-        <para>In order to create the named queue, see following example.</para>
+        <para>There is possibility of the creation as a named queue so and a queue with the default name. 
+            You can reference the named queue only from such components which have <emphasis><property>&quot;eventsQueue&quot;</property></emphasis> attribute.</para>
+        <para>So, the following example helps to create the named queue.</para>
         <para>
             <emphasis role="bold">Example:</emphasis>
         </para>
@@ -46,16 +48,15 @@
 <h:inputText value="#{myQueue.text}">
     <a:support id="onblur" event="onblur" eventsQueue="myQueue"/>
 </h:inputText>
-...
-<a4j:commandButton eventsQueue="myQueue" ... >]]></programlisting>
-        <para>You can also create the queue with a default name. This queue is global for the all form. See the example below.</para>
+...>]]></programlisting>
+        <para>See the example of the creation the default queue below.</para>
         <para>
             <emphasis role="bold">Example:</emphasis>
         </para>
         <programlisting role="XML"><![CDATA[<h:form>
-            ...
+    ...
        <a4j:queue/>
-       ...
+    ...
 </h:form>
 ]]></programlisting>
     </section>
@@ -74,23 +75,23 @@
     
     <section>
         <title>Key attributes and ways of usage</title>
-        <para>By means of the <emphasis role="bold"><property>&lt;a4j:queue&gt;</property></emphasis> component you can create several types of queues associated with it.</para>
+        <para>It&apos;s possible by means of the <emphasis role="bold"><property>&lt;a4j:queue&gt;</property></emphasis> component to create the several types of the queues.</para>
         <itemizedlist>
             <listitem>
                 <para>
-                    In order to create global queue for the all Can set a queue globally in &quot;web.xml&quot;. You don&apos;t need set the queue on the page itself. The global queue can be used by all components. You can see the example below:
+                    So that to create a global queue you should add the following code into your &quot;web.xml&quot; file. In this instance the queue can be used for the all pages and all components of these pages.
                 </para>
+                <para>
+                    You can define only one global queue.
+                </para>
                 <programlisting role="XML"><![CDATA[<context-param>
    <param-name>org.richfaces.queue.global.enabled</param-name>
    <param-value>true</param-value>
    </context-param>]]></programlisting>
                 <para>
-                    In order to enable/disable a global queue for concrete views see the following examples:
+                    By default the global queue is disabled. In order to enable or disable the queue the value of the &quot;<code>org.richfaces.global_queue</code>&quot; parameter should be &quot;true&quot; or &quot;false&quot; accordingly. 
                 </para>
                 <programlisting role="XML"><![CDATA[<a4j:queue name="org.richfaces.global_queue" disabled="false"... />]]></programlisting>
-                <para>
-                    In order to disable the queue the<emphasis><property>&quot;disabled&quot;</property></emphasis> attribute should be &quot;true&quot;.
-                </para>
             </listitem>
             <listitem>
                 <para>