Author: SeanRogers Date: 2009-10-20 19:27:37 -0400 (Tue, 20 Oct 2009) New Revision: 15738 Modified: root/docs/trunk/Migration_Guide/en-US/Changes_and_new_features.xml root/docs/trunk/Migration_Guide/en-US/Revision_History.xml Log: Added some rich components to Migration Guide Modified: root/docs/trunk/Migration_Guide/en-US/Changes_and_new_features.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/Changes_and_new_features.xml 2009-10-20 17:59:58 UTC (rev 15737) +++ root/docs/trunk/Migration_Guide/en-US/Changes_and_new_features.xml 2009-10-20 23:27:37 UTC (rev 15738) @@ -44,10 +44,10 @@ <row> <entry> <para> - <property>process</property> + <code>process</code> </para> <para> - Changed to <property>execute</property> in 4.0. + Changed to <code>execute</code> in 4.0. </para> </entry> <entry> @@ -167,10 +167,10 @@ <row> <entry> <para> - <property>reRender</property> + <code>reRender</code> </para> <para> - Changed to <property>render</property> in 4.0. + Changed to <code>render</code> in 4.0. </para> </entry> <entry> @@ -310,10 +310,10 @@ <row> <entry> <para> - <property>eventsQueue</property> + <code>eventsQueue</code> </para> <para> - Changed to <property>queue</property> in 4.0. + Changed to <code>queue</code> in 4.0. </para> </entry> <entry> @@ -443,10 +443,10 @@ <row> <entry> <para> - <property>limitToList</property> + <code>limitToList</code> </para> <para> - Changed to <property>limitRender</property> in 4.0. + Changed to <code>limitRender</code> in 4.0. </para> </entry> <entry> @@ -581,10 +581,10 @@ <row> <entry> <para> - <property>onbeforedomupdate</property> + <code>onbeforedomupdate</code> </para> <para> - Changed to <property>onsuccess</property> in 4.0. + Changed to <code>onsuccess</code> in 4.0. </para> </entry> <entry> @@ -622,10 +622,10 @@ <row> <entry> <para> - <property>ignoreDupResponses</property> + <code>ignoreDupResponses</code> </para> <para> - Deprecated. Functionality moved to <property>queue</property> in 4.0. + Deprecated. Functionality moved to <code>queue</code> in 4.0. </para> </entry> <entry> @@ -765,10 +765,10 @@ <row> <entry> <para> - <property>requestDelay</property> + <code>requestDelay</code> </para> <para> - Deprecated. Functionality moved to <property>queue</property> in 4.0. + Deprecated. Functionality moved to <code>queue</code> in 4.0. </para> </entry> <entry> @@ -883,10 +883,10 @@ <row> <entry> <para> - <property>ajaxSingle</property> + <code>ajaxSingle</code> </para> <para> - Deprecated. Use <property>execute="@this"</property> in 4.0 instead. + Deprecated. Use <code>execute="@this"</code> in 4.0 instead. </para> </entry> <entry> @@ -1060,7 +1060,7 @@ The three Javascript libraries previously used by the RichFaces framework have been consolidated and standardized into a single library for better performance. </para> <para> - Usage of Cascading Style Sheets (<acronym>CSS</acronym>) has been simplified, trimming out duplicate or otherwise unnecessary entries and better utilizing the cascading approach for attribute values. + Usage of Cascading Style Sheets (<acronym>CSS</acronym>) has been simplified, trimming out duplicate or otherwise unnecessary entries and better utilizing the cascading approach for style values. </para> </section> @@ -1079,27 +1079,27 @@ <section id="sect-Migration_Guide-Server_side_process_and_render_mechanisms-Regions"> <title>Regions</title> <para> - It is now possible to define zones for processing on the server-side without specifying <property>execute</property> definitions for every component. The <property>execute="@region"</property> property can be used to process regions defined on the server side. + It is now possible to define zones for processing on the server-side without specifying <code>execute</code> definitions for every component. The <code>execute="@region"</code> property can be used to process regions defined on the server side. </para> <important> <title>Important</title> <para> - This approach is the different to that in <acronym>JSF 2</acronym>, which uses default values of <property>execute="@this"</property> and <property>render="@this"</property> if no other value is defined. + This approach is different to that in <acronym>JSF 2</acronym>, which uses default values of <code>execute="@this"</code> and <code>render="@this"</code> if no other value is defined. </para> </important> </section> <section id="sect-Migration_Guide-Server_side_process_and_render_mechanisms-execute"> - <title><property>execute</property></title> + <title><code>execute</code></title> <para> - The <property>execute</property> property has been extended to include the <literal>@region</literal> keyword, which facilitates the region rendering changes described in <xref linkend="sect-Migration_Guide-Server_side_process_and_render_mechanisms-Regions" />. + The <code>execute</code> property has been extended to include the <literal>@region</literal> keyword, which facilitates the region rendering changes described in <xref linkend="sect-Migration_Guide-Server_side_process_and_render_mechanisms-Regions" />. </para> </section> <section id="sect-Migration_Guide-Server_side_process_and_render_mechanisms-render"> - <title><property>render</property></title> + <title><code>render</code></title> <para> - The <property>render</property> property can also be defined from the server side, using actions and listeners. + The <code>render</code> property can also be defined from the server side, using actions and listeners. </para> </section> @@ -1113,27 +1113,27 @@ </section> <section id="sect-Migration_Guide-Feature_changes-onbegin_event_attribute"> - <title><property>onbegin</property> event attribute</title> + <title><code>onbegin</code> event attribute</title> <para> - The <property>onbegin</property> attribute has been added to support <acronym>JSF</acronym> events with the type <literal>begin</literal>. + The <code>onbegin</code> attribute has been added to support <acronym>JSF</acronym> events with the type <literal>begin</literal>. </para> </section> <section id="sect-Migration_Guide-Feature_changes-a4jcommandButton_and_a4jcommandLink"> <title><classname>&lt;a4j:commandButton&gt;</classname> and <classname>&lt;a4j:commandLink&gt;</classname></title> <para> - Both the <classname>&lt;a4j:commandButton&gt;</classname> and <classname>&lt;a4j:commandLink&gt;</classname> use the <property>onclick</property> event attribute instead of the <property>onbegin</property> attribute. + Both the <classname>&lt;a4j:commandButton&gt;</classname> and <classname>&lt;a4j:commandLink&gt;</classname> use the <code>onclick</code> event attribute instead of the <code>onbegin</code> attribute. </para> </section> - <!-- + <!-- <section> <title><classname>&lt;a4j:jsFunction&gt;</classname></title> <para> </para> </section> - --> + --> <section id="sect-Migration_Guide-Feature_changes-a4jlog"> <title><classname>&lt;a4j:log&gt;</classname></title> <para> @@ -1161,7 +1161,7 @@ <section id="sect-Migration_Guide-Feature_changes-a4jmessage_and_a4jmessages"> <title><classname>&lt;a4j:message&gt;</classname> and <classname>&lt;a4j:messages&gt;</classname></title> <para> - Both the <classname>&lt;a4j:message&gt;</classname> and <classname>&lt;a4j:messages&gt;</classname> components can be automatically updated by any Ajax request, except those requests with <property>limitRender = true</property>. Attributes from previously-passed states are now cleared. + Both the <classname>&lt;a4j:message&gt;</classname> and <classname>&lt;a4j:messages&gt;</classname> components can be automatically updated by any Ajax request, except those requests with <code>limitRender = true</code>. Attributes from previously-passed states are now cleared. </para> </section> @@ -1173,12 +1173,12 @@ <itemizedlist> <listitem> <para> - The default value for the <property>layout</property> attribute is now <literal>block</literal>. + The default value for the <code>layout</code> attribute is now <literal>block</literal>. </para> </listitem> <listitem> <para> - The default value for the <property>ajaxRendered</property> attribute is now <literal>false</literal>. + The default value for the <code>ajaxRendered</code> attribute is now <literal>false</literal>. </para> </listitem> <listitem> @@ -1192,18 +1192,18 @@ <section id="sect-Migration_Guide-Feature_changes-a4jpush_and_a4jpoll"> <title><classname>&lt;a4j:push&gt;</classname> and <classname>&lt;a4j:poll&gt;</classname></title> <para> - Both the <classname>&lt;a4j:push&gt;</classname> and <classname>&lt;a4j:poll&gt;</classname> behaviors now raise a client-side event. For <classname>&lt;a4j:push&gt;</classname>, this is the <property>ondataavailable</property> event, while for <classname>&lt;a4j:poll&gt;</classname> it is the <property>ontimeevent</property>. + Both the <classname>&lt;a4j:push&gt;</classname> and <classname>&lt;a4j:poll&gt;</classname> behaviors now raise a client-side event. For <classname>&lt;a4j:push&gt;</classname>, this is the <code>ondataavailable</code> event, while for <classname>&lt;a4j:poll&gt;</classname> it is the <code>ontimeevent</code>. </para> </section> - <!-- + <!-- <section> <title><classname>&lt;a4j:region&gt;</classname></title> <para> </para> </section> - --> + --> <section id="sect-Migration_Guide-Feature_changes-a4jstatus"> <title><classname>&lt;a4j:status&gt;</classname></title> <para> @@ -1220,12 +1220,12 @@ </listitem> <listitem> <para> - <classname>&lt;a4j:status&gt;</classname> can now report request errors. An additional <property>errorText</property> attribute and <literal>error</literal> facet have been added to show if an error was raised when a request completed. + <classname>&lt;a4j:status&gt;</classname> can now report request errors. An additional <code>errorText</code> attribute and <literal>error</literal> facet have been added to show if an error was raised when a request completed. </para> </listitem> <listitem> <para> - The event attributes now include <property>onstart</property>, <property>onstop</property>, <property>onerror</property>, and <property>onsuccess</property>. + The event attributes now include <code>onstart</code>, <code>onstop</code>, <code>onerror</code>, and <code>onsuccess</code>. </para> </listitem> <listitem> @@ -1235,23 +1235,66 @@ </listitem> </itemizedlist> </section> + + <section id="sect-Migration_Guide-Feature_changes-richtogglePanel"> + <title><classname>&lt;rich:togglePanel&gt;</classname></title> + <para> + Incomplete. + </para> + </section> + + <section id="sect-Migration_Guide-Feature_changes-richtabPanel"> + <title><classname>&lt;rich:tabPanel&gt;</classname></title> + <para> + Incomplete. + </para> + </section> + + <section id="sect-Migration_Guide-Feature_changes-richtoolBar"> + <title><classname>&lt;rich:toolBar&gt;</classname></title> + <para> + Incomplete. + </para> + </section> + + <section id="sect-Migration_Guide-Feature_changes-richtoolTip"> + <title><classname>&lt;rich:toolTip&gt;</classname></title> + <para> + Incomplete. + </para> + </section> </section> <section id="sect-Migration_Guide-Changes_and_new_features-New_components_and_behaviors"> <title>New components and behaviors</title> <para> - Several new components and behaviors have been added to RichFaces 4.0, some of which replace the functionality of deprecated components and behaviors. + Several new components and behaviors have been added to RichFaces 4.0, some of which replace the functionality of deprecated elements. For full details on how to use these new components and behaviors, refer to the <citetitle>Developer Guide</citetitle>. </para> + <!-- dataTable, dataLists, trees possibly included here as they may be consolidated --> <section id="sect-Migration_Guide-New_components_and_behaviors-a4jajax"> - <title>&lt;a4j:ajax&gt;</title> + <title><classname>&lt;a4j:ajax&gt;</classname></title> <para> - The <classname>&lt;a4j:ajax</classname> behavior replaces the deprecated <classname>&lt;a4j:support&gt;</classname> behavior. + The <classname>&lt;a4j:ajax&gt;</classname> behavior replaces the deprecated <classname>&lt;a4j:support&gt;</classname> behavior. </para> <para> - <classname>&lt;a4j:ajax&gt;</classname> uses <acronym>JSF 2</acronym>, and can be used to add Ajax capabilities to any non-Ajax JSF or RichFaces component. For details on how to use <classname>&lt;a4j:ajax&gt;</classname>, refer to the <citetitle>Developer Guide</citetitle>. + <classname>&lt;a4j:ajax&gt;</classname> uses <acronym>JSF 2</acronym>, and can be used to add Ajax capabilities to any non-Ajax <acronym>JSF</acronym> or RichFaces component. </para> </section> + + <section id="sect-Migration_Guide-New_components_and_behaviors-richbusyBehavior"> + <title><classname>&lt;rich:busyBehavior&gt;</classname></title> + <para> + <classname>&lt;rich:busyBehavior&gt;</classname> is used when heavy processing takes place to provide feedback to the user. It can be attached to a component&#39;s events to trigger appropriate messages. + </para> + </section> + + <section id="sect-Migration_Guide-New_components_and_behaviors-richpopupPanel"> + <title><classname>&lt;rich:popupPanel&gt;</classname></title> + <para> + Incomplete. + </para> + </section> </section> @@ -1261,18 +1304,25 @@ Some components and behaviors have been deprecated in RichFaces 4.0. For the most part these items have their functionality replicated by another component or behavior. </para> <section id="sect-Migration_Guide-Deprecated_components_and_behaviors-a4jpage"> - <title>&lt;a4j:page&gt;</title> + <title><classname>&lt;a4j:page&gt;</classname></title> <para> RichFaces 4.0 drops support for the <classname>&lt;a4j:page&gt;</classname> component. The component was previously used for solving incompatibility in the JavaServer Pages (<acronym>JSP</acronym>) environment with Apache MyFaces in early Ajax4jsf versions. </para> </section> <section id="sect-Migration_Guide-Deprecated_components_and_behaviors-a4jsupport"> - <title>&lt;a4j:support&gt;</title> + <title><classname>&lt;a4j:support&gt;</classname></title> <para> The <classname>&lt;a4j:support&gt;</classname> component had been deprecated and its functionality replaced by the <classname>&lt;a4j:ajax&gt;</classname> component. Refer to <xref linkend="sect-Migration_Guide-New_components_and_behaviors-a4jajax" /> for details. </para> </section> + + <section id="sect-Migration_Guide-Deprecated_components_and_behaviors-richmodalPanel"> + <title><classname>&lt;rich:modalPanel&gt;</classname></title> + <para> + Incomplete. + </para> + </section> </section> Modified: root/docs/trunk/Migration_Guide/en-US/Revision_History.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/Revision_History.xml 2009-10-20 17:59:58 UTC (rev 15737) +++ root/docs/trunk/Migration_Guide/en-US/Revision_History.xml 2009-10-20 23:27:37 UTC (rev 15738) @@ -8,7 +8,7 @@ <revhistory> <revision> <revnumber>0.1</revnumber> - <date>October 20, 2009</date> + <date>Tue Oct 20 2009</date> <author> <firstname>Sean</firstname> <surname>Rogers</surname>