[jboss-cvs] jboss-seam/doc/reference/en/modules ...
Peter Muir
peter at bleepbleep.org.uk
Thu Sep 6 15:01:57 EDT 2007
User: pmuir
Date: 07/09/06 15:01:57
Modified: doc/reference/en/modules controls.xml
configuration.xml oc4j.xml tutorial.xml
dependencies.xml validation.xml
Log:
Update docs for RichFaces changeover
Revision Changes Path
1.47 +2 -2 jboss-seam/doc/reference/en/modules/controls.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: controls.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/controls.xml,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -b -r1.46 -r1.47
--- controls.xml 27 Aug 2007 21:30:16 -0000 1.46
+++ controls.xml 6 Sep 2007 19:01:57 -0000 1.47
@@ -3,8 +3,8 @@
<para>
Seam includes a number of JSF controls that are useful for working with
Seam. These are intended to complement the built-in JSF controls, and
- controls from other third-party libraries. We recommend the JBoss Ajax4jsf,
- JBoss Richfaces, and Apache MyFaces Trinidad tag libraries for use with Seam.
+ controls from other third-party libraries. We recommend
+ JBoss RichFaces, and Apache MyFaces Trinidad tag libraries for use with Seam.
We do not recommend the use of the Tomahawk tag library.
</para>
1.60 +10 -6 jboss-seam/doc/reference/en/modules/configuration.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: configuration.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/configuration.xml,v
retrieving revision 1.59
retrieving revision 1.60
diff -u -b -r1.59 -r1.60
--- configuration.xml 28 Aug 2007 11:25:20 -0000 1.59
+++ configuration.xml 6 Sep 2007 19:01:57 -0000 1.60
@@ -221,11 +221,15 @@
</sect3>
<sect3>
- <title>Ajax4jsf</title>
+ <title>RichFaces</title>
- <para> If Ajax4jsf is used in your project, Seam will install the Ajax4jsf filter for you, making sure
- to install it before all other built-in filters. You don't need to install the Ajax4jsf filter in
- <literal>web.xml</literal> yourself. </para>
+ <para>
+ If RichFaces is used in your project, Seam will install the
+ RichFaces Ajax filter for you, making sure to install it
+ before all other built-in filters. You don't need to install
+ the RichFaces Ajax filter in <literal>web.xml</literal>
+ yourself.
+ </para>
<para> To override the default settings, add the following entry to <literal>components.xml</literal>.
The options are the same as those specified in the Ajax4jsf Developer Guide: </para>
@@ -238,7 +242,7 @@
<listitem>
<para>
<literal>force-parser</literal> — forces all JSF pages to be validated by
- Ajax4jsf's XML syntax checker. If <literal>false</literal>, only AJAX responses are
+ Richfaces's XML syntax checker. If <literal>false</literal>, only AJAX responses are
validated and converted to well-formed XML. Setting <literal>force-parser</literal> to
<literal>false</literal> improves performance, but can provide visual artifacts on AJAX
updates. </para>
@@ -316,7 +320,7 @@
<para> Adding the <literal>@Startup</literal> annotation means thar the component is available during
Seam startup; bijection isn't available here (<literal>@BypassInterceptors</literal>); and the filter
- should be further down the chain than the Ajax4jsf filter
+ should be further down the chain than the RichFaces filter
(<literal>@Filter(within="org.jboss.seam.web.ajax4jsfFilter")</literal>). </para>
</sect3>
1.2 +7 -1 jboss-seam/doc/reference/en/modules/oc4j.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: oc4j.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/oc4j.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- oc4j.xml 27 Aug 2007 21:31:25 -0000 1.1
+++ oc4j.xml 6 Sep 2007 19:01:57 -0000 1.2
@@ -67,10 +67,16 @@
</listitem>
<listitem>
<para>
- <literal>ajax4jsf-1.1.1.jar</literal> — which requires Apache
+ <literal>richfaces-api.jar</literal> — which requires Apache
commons-digester and commons-beanutils
</para>
</listitem>
+ <listitem>
+ <para>
+ <literal>richfaces-impl.jar</literal> and <literal>richfaces-ui.jar</literal> —
+ which requires Apache commons-digester and commons-beanutils
+ </para>
+ </listitem>
</itemizedlist>
</section>
1.94 +5 -5 jboss-seam/doc/reference/en/modules/tutorial.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: tutorial.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/tutorial.xml,v
retrieving revision 1.93
retrieving revision 1.94
diff -u -b -r1.93 -r1.94
--- tutorial.xml 26 Jun 2007 23:10:44 -0000 1.93
+++ tutorial.xml 6 Sep 2007 19:01:57 -0000 1.94
@@ -1980,7 +1980,7 @@
of these hotels, a conversation begins, and a conversation scoped component calls back to the session
scoped component to retrieve the selected hotel. </para>
- <para> The booking example also demonstrates the use of Ajax4JSF to implement rich client behavior without
+ <para> The booking example also demonstrates the use of RichFaces Ajax to implement rich client behavior without
the use of handwritten JavaScript. </para>
<para> The search functionality is implemented using a session-scope stateful session bean, similar to the
@@ -2179,18 +2179,18 @@
</a:outputPanel> ]]></programlisting>
<calloutlist>
<callout arearefs="booking-support-element">
- <para> The Ajax4JSF <literal><a:support></literal> tag allows a JSF action
+ <para> The RichFaces Ajax <literal><a:support></literal> tag allows a JSF action
event listener to be called by asynchronous <literal>XMLHttpRequest</literal> when a
JavaScript event like <literal>onkeyup</literal> occurs. Even better, the
<literal>reRender</literal> attribute lets us render a fragment of the JSF page and
perform a partial page update when the asynchronous response is received. </para>
</callout>
<callout arearefs="booking-status-element">
- <para> The Ajax4JSF <literal><a:status></literal> tag lets us display a cheesy
+ <para> The RichFaces Ajax <literal><a:status></literal> tag lets us display a cheesy
annimated image while we wait for asynchronous requests to return. </para>
</callout>
<callout arearefs="booking-outputpanel-element">
- <para> The Ajax4JSF <literal><a:outputPanel></literal> tag defines a region of
+ <para> The RichFaces Ajax <literal><a:outputPanel></literal> tag defines a region of
the page which can be re-rendered by an asynchronous request. </para>
</callout>
<callout arearefs="booking-link-element">
@@ -2380,7 +2380,7 @@
later that <literal><s:link></literal> also offers a number of other useful features,
including conversation propagation rules. </para>
- <para> The booking application uses some other Seam and Ajax4JSF controls, especially on the
+ <para> The booking application uses some other Seam and RichFaces Ajax controls, especially on the
<literal>/book.xhtml</literal> page. We won't get into the details of those controls here, but if
you want to understand this code, please refer to the chapter covering Seam's functionality for JSF form
validation. </para>
1.4 +25 -7 jboss-seam/doc/reference/en/modules/dependencies.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: dependencies.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/dependencies.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -b -r1.3 -r1.4
--- dependencies.xml 30 Aug 2007 01:10:25 -0000 1.3
+++ dependencies.xml 6 Sep 2007 19:01:57 -0000 1.4
@@ -320,10 +320,10 @@
</sect1>
<sect1>
- <title>Ajax4JSF / RichFaces</title>
+ <title>RichFaces</title>
<table>
- <title>Ajax4JSF dependencies</title>
+ <title>RichFaces dependencies</title>
<tgroup cols="4">
<colspec colnum="1" colwidth="4*" />
@@ -352,22 +352,25 @@
<row>
<entry>
- <para><literal>ajax4jsf.jar</literal></para>
+ <para><literal>richfaces-api.jar</literal></para>
</entry>
<entry align="center">
- <para>war</para>
+ <para>ear</para>
</entry>
<entry align="center">
<para>no</para>
</entry>
<entry>
- <para>Required to use Ajax4JSF.</para>
+ <para>
+ Required to use RichFaces. Provides API classes that you may
+ wish to use from your application e.g. to create a tree
+ </para>
</entry>
</row>
<row>
<entry>
- <para><literal>richfaces.jar</literal></para>
+ <para><literal>richfaces-impl.jar</literal></para>
</entry>
<entry align="center">
<para>war</para>
@@ -380,6 +383,21 @@
</entry>
</row>
+ <row>
+ <entry>
+ <para><literal>richfaces-ui.jar</literal></para>
+ </entry>
+ <entry align="center">
+ <para>war</para>
+ </entry>
+ <entry align="center">
+ <para>no</para>
+ </entry>
+ <entry>
+ <para>Required to use RichFaces. Provides all the UI components.</para>
+ </entry>
+ </row>
+
</tbody>
</tgroup>
</table>
1.9 +1 -1 jboss-seam/doc/reference/en/modules/validation.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: validation.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/validation.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -b -r1.8 -r1.9
--- validation.xml 15 Jun 2007 07:36:21 -0000 1.8
+++ validation.xml 6 Sep 2007 19:01:57 -0000 1.9
@@ -219,7 +219,7 @@
</h:form>]]></programlisting>
<para>
- Finally, we can use Ajax4JSF to display validation messages as the user
+ Finally, we can use RichFaces Ajax to display validation messages as the user
is navigating around the form:
</para>
More information about the jboss-cvs-commits
mailing list