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

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

Author: cluts
Date: 2008-12-18 08:11:22 -0500 (Thu, 18 Dec 2008)
New Revision: 11869

Modified:
   trunk/docs/userguide/en/src/main/docbook/included/commandLink.xml
Log:
RF-5099 - the tip for the "Key attributes and ways of usage" section has been added

Modified: trunk/docs/userguide/en/src/main/docbook/included/commandLink.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/commandLink.xml	2008-12-18 12:59:31 UTC (rev 11868)
+++ trunk/docs/userguide/en/src/main/docbook/included/commandLink.xml	2008-12-18 13:11:22 UTC (rev 11869)
@@ -59,21 +59,26 @@
     </section>
     <section>
       <title>Key attributes and ways of usage</title>
-      <para><emphasis role="bold"><property>&lt;a4j:commandLink&gt;</property></emphasis> is used in the same way as <emphasis role="bold"><property>&lt;h:commandLink&gt;</property></emphasis>, but with definition of the area that is updated after the response comes back from the server.</para>
+      <para>The <emphasis role="bold"><property>&lt;a4j:commandLink&gt;</property></emphasis> component is used in the same way as the <emphasis role="bold"><property>&lt;h:commandLink&gt;</property></emphasis> component, but with definition of the area that is updated after the response comes back from the server.</para>
       <para>This definition of the component provides a link, and a click on the link causes an Ajax form
         submit on the server, <code>&quot;action1&quot;</code> method performance, and rendering of the component 
         with <code>&quot;someData&quot;</code> id after the response comes back from the server.</para>
-      <para>The component <emphasis role="bold"><property>&lt;a4j:commandLink&gt;</property></emphasis> placed on a page generates the following HTML code:</para>
-	  <programlisting role="XML"><![CDATA[...
+      <tip>
+        <title>Tip:</title>
+        <para>The example in the &quot;Creation on a page&quot; section generates the following HTML code:</para>
+        <programlisting role="XML"><![CDATA[...
 <a href="#" onclick="A4J.AJAX.Submit(?"request parameters"); return false;">
-	  <span>Link Value</span>
+	  <span>Link</span>
 </a>
 ...]]></programlisting>
-      <para>Hence, the utility method <code>&quot;A4J.AJAX.Submit&quot;</code> is called on a click, the method performs Ajax request as the <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> component</para>
-	 <note>
+        <para>If you click on the generated anchor the utility method <code>A4J.AJAX.Submit()</code> is fired. 
+		The method performs an Ajax request as the Ajax support is built-in. It&apos;s not necessary to add nested <emphasis role="bold"><property>&lt;a4j:support /&gt;</property></emphasis> to the <emphasis role="bold"><property>&lt;a4j:commandLink /&gt;</property></emphasis> component.</para>
+      </tip>
+     
+	 <!--<note>
       <title>Note:</title>
-      <para>AJAX support is built in and it&apos;s not necessary to add nested <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> to the component.</para>
-	  </note>
+      
+	  </note>-->
 	  <para>Common JSF navigation could be performed after Ajax submit and partial rendering, but Navigation Case must be defined as <emphasis role="bold"><property>&lt;redirect/&gt;</property></emphasis> in order to avoid problems with some browsers.</para>
       <para>As any Core Ajax component sending Ajax requests and processing server responses <emphasis role="bold"><property>&lt;a4j:commandLink&gt;</property></emphasis> has all attributes described above (see <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> <link linkend="support">chapter</link>) that provide the required behavior of requests sending (delay, limitation of submit area and rendering, etc.)</para>
       <para>