From richfaces-svn-commits at lists.jboss.org Wed May 5 23:58:58 2010 Content-Type: multipart/mixed; boundary="===============0413140140434422858==" MIME-Version: 1.0 From: richfaces-svn-commits at lists.jboss.org To: richfaces-svn-commits at lists.jboss.org Subject: [richfaces-svn-commits] JBoss Rich Faces SVN: r16905 - in root/docs/trunk: Developer_Guide/en-US and 1 other directories. Date: Wed, 05 May 2010 23:58:58 -0400 Message-ID: <201005060358.o463wwZY027140@svn01.web.mwc.hst.phx2.redhat.com> --===============0413140140434422858== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: SeanRogers Date: 2010-05-05 23:58:58 -0400 (Wed, 05 May 2010) New Revision: 16905 Added: root/docs/trunk/Developer_Guide/en-US/extras/prog-Developer_Guide-Using_= RichFaces_with_Maven-Add_required_repositories.xml_sample root/docs/trunk/Developer_Guide/en-US/extras/prog-Developer_Guide-Using_= RichFaces_with_Maven-Add_required_repositories_(legacy).xml_sample Modified: root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Table= s_and_grids.xml root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-Basic_concept= s.xml root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-Getting_start= ed_with_RichFaces.xml root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-RichFaces_ove= rview.xml Log: Completed revision of Developer Guide based on tech review. Modified: root/docs/trunk/Component_Reference/en-US/chap-Component_Referenc= e-Tables_and_grids.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Tabl= es_and_grids.xml 2010-05-06 00:27:39 UTC (rev 16904) +++ root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Tabl= es_and_grids.xml 2010-05-06 03:58:58 UTC (rev 16905) @@ -633,6 +633,33 @@ =
<sgmltag><rich:dataOrderedList></sgmltag> + + + + component-type: org.richfaces.DataOrderedList + + + + + component-class: org.richfaces.component.html.HtmlDataOrde= redList + + + + + component-family: org.richfaces.DataOrderedList + + + + + renderer-type: org.richfaces.DataOrderedListRenderer + + + + + tag-class: org.richfaces.taglib.DataOrderedListTag + + + Incomplete Modified: root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-Basic_= concepts.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-Basic_concep= ts.xml 2010-05-06 00:27:39 UTC (rev 16904) +++ root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-Basic_concep= ts.xml 2010-05-06 03:58:58 UTC (rev 16905) @@ -14,7 +14,7 @@ - The <a4j:commandButton> and <a4j= :commandLink> tags are used to send an Ajax request on the onclick JavaScript event. + The <a4j:commandButton> and <a4j= :commandLink> tags are used to send an Ajax request on the click JavaScript event. @@ -24,7 +24,7 @@ - The <a4j:ajax> tag allows you to add Ajax fu= nctionality to standard JSF components and send Ajax request on a chosen Ja= vaScript event, such as onkeyup or onmouseover<= /varname>, for example. + The <a4j:ajax> tag allows you to add Ajax fu= nctionality to standard JSF components and send Ajax request on a chosen Ja= vaScript event, such as keyup or mouseover, for example. @@ -51,7 +51,7 @@
Partial page updates - Specific regions of a page can be defined through the use of container= components such as <a4j:region>. These regions ca= n then be specified with their id identifiers in the render attribute of a component so that when the component = sends an Ajax request, only the specified regions are updated. In this way = you can control which part of the JSF View is decoded on the server side wh= en the Ajax request is sent. Multiple regions can be defined and sent, and = regions can be nested inside other regions. + Specific regions of a page can be defined through the use of container= components such as <a4j:region>. These regions ca= n then be specified with their id identifiers in the render attribute of a component so that when the component = sends an Ajax request, only the specified regions are updated. In this way = you can control which part of the JSF View is decoded on the server side wh= en the Ajax request is sent. Multiple regions can be defined and sent, and = regions can be nested inside other regions. Controls and components from th= ird-party libraries contained in these regions are also updated. Additionally, regions can be wrapped with the <a4j:outputP= anel ajaxRendered=3D"true"> tag. This causes all contents of t= he region to be updated on every Ajax response, even if not explicitly list= ed in the requesting component's render attribute. Modified: root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-Gettin= g_started_with_RichFaces.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-Getting_star= ted_with_RichFaces.xml 2010-05-06 00:27:39 UTC (rev 16904) +++ root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-Getting_star= ted_with_RichFaces.xml 2010-05-06 03:58:58 UTC (rev 16905) @@ -215,7 +215,7 @@ Create a new project - Create a new project based on the JSF 2 environment by using the JSF = Project wizard in JBoss Tools. + Create a new project based on the JSF 2 environment. In = JBoss Tools, select FileNewJSF Project from th= e menu. Name the project, select JSF 2 from the JSF Environment drop-down box, and click the Fini= sh button to create the project. @@ -226,7 +226,7 @@ Other required libraries - RichFaces also requires the following libraries to be referenced in = your project. Typically they are already included when creating a JSF proje= ct in JBoss Tools. These dependencies ne= ed to be confirmed. + RichFaces also requires the following libraries to be referenced in = your project. Typically they are already included when creating a JSF proje= ct in JBoss Tools. @@ -287,44 +287,10 @@ Add required repositories - A structure for the Maven project with minimal content can be created= with the Maven archetype named maven-archetype-jsfwebapp (may be renamed in a later release) included as part o= f the RichFaces Component Development Kit (CDK). The arc= hetype and the project itself require extra repositories to be provided, na= mely http://snapshots.jboss.org/maven2/ and = http://repository.jboss.com/maven2/. To make the repositories ac= cessible to Maven, add a profile in the maven_installation_folder= /conf/settings.xml file under the <profiles> element: + A structure for the Maven project with minimal content can be created= with the Maven archetype named maven-archetype-jsfwebapp (may be renamed in a later release) included as part o= f the RichFaces Component Development Kit (CDK). The arc= hetype and the project itself require the JBoss repository to be provided (= https://repository.jboss.org/nexus/content/groups/public/). To make the repositories accessible to Maven, add a profile in the maven_installation_folder/conf/settings.= xml file under the <profiles> element: = -<profiles> - <profile> - <id>jsf-app-profile</id> - <repositories> - <repository> - <releases> - <enabled>true</enabled> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - </snapshots> - <id>snapshots.jboss.org</id> - <name>Snapshot Jboss Repository for Maven</name&g= t; - <url>http://snapshots.jboss.org/maven2/</url> - <layout>default</layout> - </repository> - <repository> - <releases> - <enabled>true</enabled> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - </snapshots> - <id>repository.jboss.com</id> - <name>Jboss Repository for Maven</name> - <url>http://repository.jboss.com/maven2/</url> - <layout>default</layout> - </repository> - </repositories> - </profile> - ... -</profiles> - + The profile then needs to be activated in the <activeProf= iles> element: @@ -396,107 +362,26 @@ The jsf-app directory contains a project descrip= tor file, pom.xml. To add RichFaces libraries to your = project, edit the project descriptor to add dependencies to the &l= t;dependencies> element as follows: = -<dependencies> - <dependency> - <groupId>junit</groupId> - <artifactId>junit</artifactId> - <version>3.8.1</version> - <scope>test</scope> - </dependency> - <dependency> - <groupId>javax.servlet</groupId> - <artifactId>servlet-api</artifactId> - <version>2.4</version> - <scope>provided</scope> - </dependency> - <dependency> - <groupId>javax.servlet</groupId> - <artifactId>jsp-api</artifactId> - <version>2.0</version> - <scope>provided</scope> - </dependency> - <dependency> - <groupId>jstl</groupId> - <artifactId>jstl</artifactId> - <version>1.1.2</version> - </dependency> - <dependency> - <groupId>javax.servlet.jsp</groupId> - <artifactId>jsp-api</artifactId> - <version>2.1</version> - <scope>provided</scope> - </dependency> - <dependency> - <groupId>javax.faces</groupId> - <artifactId>jsf-api</artifactId> - <version>1.2_12</version> - </dependency> - <dependency> - <groupId>javax.faces</groupId> - <artifactId>jsf-impl</artifactId> - <version>1.2_12</version> - </dependency> - <dependency> - <groupId>javax.el</groupId> - <artifactId>el-api</artifactId> - <version>1.0</version> - <scope>provided</scope> - </dependency> - <dependency> - <groupId>el-impl</groupId> - <artifactId>el-impl</artifactId> - <version>1.0</version> - <scope>provided</scope> - </dependency> - <dependency> - <groupId>javax.annotation</groupId> - <artifactId>jsr250-api</artifactId> - <version>1.0</version> - </dependency> - <!-- RichFaces libraries --> - <dependency> - <groupId>org.richfaces.framework</groupId> - <artifactId>richfaces-api</artifactId> - <version>4.0.0</version> - </dependency> - <dependency> - <groupId>org.richfaces.framework</groupId> - <artifactId>richfaces-impl</artifactId> - <version>4.0.0</version> - </dependency> - <dependency> - <groupId>org.richfaces.ui</groupId> - <artifactId>richfaces-ui</artifactId> - <version>4.0.0</version> - </dependency> -</dependencies> - + Build the project - - - Standard building - - Build the project from the command line by entering the mv= n install command. - - - The BUILD SUCCESSFUL message indic= ates the project has been assembled and is ready to import into an IDE (int= egrated development environment) and run on a server. - - - - Building for <application>Eclipse</application> and <applicat= ion>JBoss Tools</application> - - To build the project for Eclipse and JBoss Tools, enter the following command at the com= mand line: = -mvn eclipse:eclipse -Dwtpversion=3D2.0 - - - - The BUILD SUCCESSFUL message indic= ates the project has been assembled and is ready to import into Eclipse. - - - + + Build the project from the command line by entering the mvn = install command. + + + The BUILD SUCCESSFUL message indicat= es the project has been assembled and is ready to import into an IDE (integ= rated development environment). + + + Import the project into an IDE + + Import the Maven project into your IDE. + + + For Eclipse and JBoss Tools, you need to have the M2Eclipse plu= g-in installed. You can then import the Maven pr= oject through a wizard by choosing FileImport from the menu. Select M= aven Projects as the input source and choose the pom.x= ml file for your project. + + Add tag library references Modified: root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-RichFa= ces_overview.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-RichFaces_ov= erview.xml 2010-05-06 00:27:39 UTC (rev 16904) +++ root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-RichFaces_ov= erview.xml 2010-05-06 03:58:58 UTC (rev 16905) @@ -26,7 +26,7 @@ - Using JSF tags, RichFaces allows different parts of a JSF page to be upd= ated with an Ajax request. JSF pages using RichFaces do not change from "re= gular" JSF pages, and additional JavaScript or XMLHTTPRequest objects do no= t need to be written. + Using JSF tags, RichFaces allows different parts of a JSF page to be upd= ated with an Ajax request. JSF pages using RichFaces do not change from "re= gular" JSF pages, and additional JavaScript code is not required.
Architecture Added: root/docs/trunk/Developer_Guide/en-US/extras/prog-Developer_Guide-Us= ing_RichFaces_with_Maven-Add_required_repositories.xml_sample =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- root/docs/trunk/Developer_Guide/en-US/extras/prog-Developer_Guide-Using= _RichFaces_with_Maven-Add_required_repositories.xml_sample = (rev 0) +++ root/docs/trunk/Developer_Guide/en-US/extras/prog-Developer_Guide-Using= _RichFaces_with_Maven-Add_required_repositories.xml_sample 2010-05-06 03:58= :58 UTC (rev 16905) @@ -0,0 +1,47 @@ + + ... + + ... + + jboss-public-repository + + + jboss-public-repository-group + JBoss Public Maven Repository Group + https://repository.jboss.org/nexus/content/groups/public/ + default + + true + never + + + true + never + + + + + + jboss-public-repository-group + JBoss Public Maven Repository Group + https://repository.jboss.org/nexus/content/groups/public/ + default + + true + never + + + true + never + + + + + + + + + jboss-public-repository + + ... + Added: root/docs/trunk/Developer_Guide/en-US/extras/prog-Developer_Guide-Us= ing_RichFaces_with_Maven-Add_required_repositories_(legacy).xml_sample =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- root/docs/trunk/Developer_Guide/en-US/extras/prog-Developer_Guide-Using= _RichFaces_with_Maven-Add_required_repositories_(legacy).xml_sample = (rev 0) +++ root/docs/trunk/Developer_Guide/en-US/extras/prog-Developer_Guide-Using= _RichFaces_with_Maven-Add_required_repositories_(legacy).xml_sample 2010-05= -06 03:58:58 UTC (rev 16905) @@ -0,0 +1,34 @@ + + + jsf-app-profile + + + + true + + + true + always + + snapshots.jboss.org + Snapshot Jboss Repository for Maven + http://snapshots.jboss.org/maven2/ + default + + + + true + + + true + always + + repository.jboss.com + Jboss Repository for Maven + http://repository.jboss.com/maven2/ + default + + + + ... + --===============0413140140434422858==--