6:27 p.m.
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><a4j:commandButton></classname> and
<classname><a4j:commandLink></classname></title>
<para>
- Both the <classname><a4j:commandButton></classname> and
<classname><a4j:commandLink></classname> use the
<property>onclick</property> event attribute instead of the
<property>onbegin</property> attribute.
+ Both the <classname><a4j:commandButton></classname> and
<classname><a4j:commandLink></classname> use the
<code>onclick</code> event attribute instead of the
<code>onbegin</code> attribute.
</para>
</section>
- <!--
+ <!--
<section>
<title><classname><a4j:jsFunction></classname></title>
<para>
</para>
</section>
- -->
+ -->
<section id="sect-Migration_Guide-Feature_changes-a4jlog">
<title><classname><a4j:log></classname></title>
<para>
@@ -1161,7 +1161,7 @@
<section
id="sect-Migration_Guide-Feature_changes-a4jmessage_and_a4jmessages">
<title><classname><a4j:message></classname> and
<classname><a4j:messages></classname></title>
<para>
- Both the <classname><a4j:message></classname> and
<classname><a4j:messages></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><a4j:message></classname> and
<classname><a4j:messages></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><a4j:push></classname> and
<classname><a4j:poll></classname></title>
<para>
- Both the <classname><a4j:push></classname> and
<classname><a4j:poll></classname> behaviors now raise a
client-side event. For <classname><a4j:push></classname>, this
is the <property>ondataavailable</property> event, while for
<classname><a4j:poll></classname> it is the
<property>ontimeevent</property>.
+ Both the <classname><a4j:push></classname> and
<classname><a4j:poll></classname> behaviors now raise a
client-side event. For <classname><a4j:push></classname>, this
is the <code>ondataavailable</code> event, while for
<classname><a4j:poll></classname> it is the
<code>ontimeevent</code>.
</para>
</section>
- <!--
+ <!--
<section>
<title><classname><a4j:region></classname></title>
<para>
</para>
</section>
- -->
+ -->
<section id="sect-Migration_Guide-Feature_changes-a4jstatus">
<title><classname><a4j:status></classname></title>
<para>
@@ -1220,12 +1220,12 @@
</listitem>
<listitem>
<para>
- <classname><a4j:status></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><a4j:status></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><rich:togglePanel></classname></title>
+ <para>
+ Incomplete.
+ </para>
+ </section>
+
+ <section id="sect-Migration_Guide-Feature_changes-richtabPanel">
+ <title><classname><rich:tabPanel></classname></title>
+ <para>
+ Incomplete.
+ </para>
+ </section>
+
+ <section id="sect-Migration_Guide-Feature_changes-richtoolBar">
+ <title><classname><rich:toolBar></classname></title>
+ <para>
+ Incomplete.
+ </para>
+ </section>
+
+ <section id="sect-Migration_Guide-Feature_changes-richtoolTip">
+ <title><classname><rich:toolTip></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><a4j:ajax></title>
+ <title><classname><a4j:ajax></classname></title>
<para>
- The <classname><a4j:ajax</classname> behavior replaces the
deprecated <classname><a4j:support></classname> behavior.
+ The <classname><a4j:ajax></classname> behavior replaces the
deprecated <classname><a4j:support></classname> behavior.
</para>
<para>
- <classname><a4j:ajax></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><a4j:ajax></classname>, refer to the
<citetitle>Developer Guide</citetitle>.
+ <classname><a4j:ajax></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><rich:busyBehavior></classname></title>
+ <para>
+ <classname><rich:busyBehavior></classname> is used when
heavy processing takes place to provide feedback to the user. It can be attached to a
component's events to trigger appropriate messages.
+ </para>
+ </section>
+
+ <section
id="sect-Migration_Guide-New_components_and_behaviors-richpopupPanel">
+ <title><classname><rich:popupPanel></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><a4j:page></title>
+ <title><classname><a4j:page></classname></title>
<para>
RichFaces 4.0 drops support for the
<classname><a4j:page></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><a4j:support></title>
+ <title><classname><a4j:support></classname></title>
<para>
The <classname><a4j:support></classname> component had been
deprecated and its functionality replaced by the
<classname><a4j:ajax></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><rich:modalPanel></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>