Author: SeanRogers Date: 2010-06-01 02:31:24 -0400 (Tue, 01 Jun 2010) New Revision: 17439 Added: root/docs/trunk/Developer_Guide/en-US/extras/prog-Developer_Guide-Compiling_from_source_code-Maven_server_definitions.xml_sample 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/images/figu-Developer_Guide-Creating_a_project-RichFaces_palette_in_JBoss_Tools.png Removed: root/docs/trunk/Developer_Guide/en-US/extras/prog-Developer_Guide-Using_RichFaces_with_Maven-Add_required_repositories.xml_sample Modified: root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-Getting_started_with_RichFaces.xml root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-RichFaces_overview.xml Log: Archetype usage: RF-8648 Modified: root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-Getting_started_with_RichFaces.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-Getting_started_with_RichFaces.xml 2010-05-31 23:26:21 UTC (rev 17438) +++ root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-Getting_started_with_RichFaces.xml 2010-06-01 06:31:24 UTC (rev 17439) @@ -4,7 +4,7 @@ <chapter id="chap-Developer_Guide-Getting_started_with_RichFaces"> <title>Getting started with RichFaces</title> <para> - Follow the instructions in this chapter configure the RichFaces framework for development. RichFaces applications can be developed using <productname>JBoss Tools</productname>, as described in <xref linkend="sect-Developer_Guide-Getting_started_with_RichFaces-Creating_a_project_with_JBoss_Tools" />; or using <productname>Maven</productname>, as described in <xref linkend="sect-Developer_Guide-Getting_started_with_RichFaces-Creating_a_project_with_Maven" />. + Follow the instructions in this chapter to configure the RichFaces framework and get started with application development. RichFaces applications can be developed using <productname>JBoss Tools</productname>, as described in <xref linkend="sect-Developer_Guide-Getting_started_with_RichFaces-Creating_a_project_with_JBoss_Tools" />; or using <productname>Maven</productname>, as described in <xref linkend="sect-Developer_Guide-Getting_started_with_RichFaces-Creating_a_project_with_Maven" />. </para> <para> If you have existing projects that use a previous version of RichFaces, refer to the <citetitle>RichFaces Migration Guide</citetitle>. @@ -147,8 +147,21 @@ </procedure> <para> - You are now ready to begin constructing your RichFaces applications. + You are now ready to begin constructing your RichFaces applications. RichFaces components can be dragged and dropped into your application's XHTML pages from the RichFaces palette in <productname>JBoss Tools</productname>, shown in <xref linkend="figu-Developer_Guide-Creating_a_project-RichFaces_palette_in_JBoss_Tools" /> </para> + <figure id="figu-Developer_Guide-Creating_a_project-RichFaces_palette_in_JBoss_Tools"> + <title>RichFaces palette in JBoss Tools</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/figu-Developer_Guide-Creating_a_project-RichFaces_palette_in_JBoss_Tools.png" format="PNG" /> + </imageobject> + <textobject> + <para> + The RichFaces palette in JBoss Tools, showing a list of components for addition use in a web application. + </para> + </textobject> + </mediaobject> + </figure> </section> <section id="sect-Developer_Guide-Getting_started_with_RichFaces-Creating_a_project_with_Maven"> Modified: root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-RichFaces_overview.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-RichFaces_overview.xml 2010-05-31 23:26:21 UTC (rev 17438) +++ root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-RichFaces_overview.xml 2010-06-01 06:31:24 UTC (rev 17439) @@ -346,9 +346,6 @@ <section id="sect-Developer_Guide-RichFaces_overview-Differences_between_JSF_and_RichFaces_mechanisms"> <title>Differences between <acronym>JSF</acronym> and RichFaces mechanisms</title> - <para> - <remark>Needs additional clarification.</remark> - </para> <itemizedlist> <listitem> <para> @@ -428,6 +425,41 @@ </para> </step> <step> + <title>Configure <productname>Maven</productname> with JBoss developer settings</title> + <para> + To compile the RichFaces source code, <productname>Maven</productname> requires access to JBoss development repositories. Edit the <filename><replaceable>maven_installation_folder</replaceable>/conf/settings.xml</filename> file and add the following settings: + </para> + <variablelist> + <varlistentry> + <term>Server definitions</term> + <listitem> + <programlisting language="XML" role="XML"><xi:include parse="text" href="extras/prog-Developer_Guide-Compiling_from_source_code-Maven_server_definitions.xml_sample" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> + <para> + Change the <code><replaceable>username</replaceable></code> and <code><replaceable>password</replaceable></code> in your server definitions to your <orgname>JBoss.org</orgname> username and password. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Mirror definitions</term> + <listitem> + <programlisting language="XML" role="XML"><xi:include parse="text" href="extras/prog-Developer_Guide-Compiling_from_source_code-Maven_mirror_definitions.xml_sample" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>Profile definitions</term> + <listitem> + <programlisting language="XML" role="XML"><xi:include parse="text" href="extras/prog-Developer_Guide-Compiling_from_source_code-Maven_profile_definitions.xml_sample" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>Activate profile</term> + <listitem> + <programlisting language="XML" role="XML"><xi:include parse="text" href="extras/prog-Developer_Guide-Compiling_from_source_code-Maven_activate_profile.xml_sample" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> + </listitem> + </varlistentry> + </variablelist> + </step> + <step> <title>Compile using <productname>Maven</productname></title> <para> In the root directory of the unzipped source code, enter the following command to compile and build the RichFaces framework: Copied: root/docs/trunk/Developer_Guide/en-US/extras/prog-Developer_Guide-Compiling_from_source_code-Maven_server_definitions.xml_sample (from rev 17400, 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-Compiling_from_source_code-Maven_server_definitions.xml_sample (rev 0) +++ root/docs/trunk/Developer_Guide/en-US/extras/prog-Developer_Guide-Compiling_from_source_code-Maven_server_definitions.xml_sample 2010-06-01 06:31:24 UTC (rev 17439) @@ -0,0 +1,18 @@ +<servers> + <server> + <id>jboss-developer-repository-group</id> + <username>username</username> + <password>password</password> + </server> + <server> + <id>jboss-screenshots-repository</id> + <username>username</username> + <password>password</password> + </server> + <server> + <id>jboss-releases-repository</id> + <username>username</username> + <password>password</password> + </server> + ... +</servers> Deleted: 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.xml_sample 2010-05-31 23:26:21 UTC (rev 17438) +++ root/docs/trunk/Developer_Guide/en-US/extras/prog-Developer_Guide-Using_RichFaces_with_Maven-Add_required_repositories.xml_sample 2010-06-01 06:31:24 UTC (rev 17439) @@ -1,38 +0,0 @@ -<profiles> - ... - <profile> - <id>jboss-public-repository</id> - <repositories> - <repository> - <id>jboss-public-repository-group</id> - <name>JBoss Public Maven Repository Group</name> - <url>https://repository.jboss.org/nexus/content/groups/public/</url> - <layout>default</layout> - <releases> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - </snapshots> - </repository> - </repositories> - <pluginRepositories> - <pluginRepository> - <id>jboss-public-repository-group</id> - <name>JBoss Public Maven Repository Group</name> - <url>https://repository.jboss.org/nexus/content/groups/public/</url> - <layout>default</layout> - <releases> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - </snapshots> - </pluginRepository> - </pluginRepositories> - </profile> -</profiles> 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.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-06-01 06:31:24 UTC (rev 17439) @@ -0,0 +1,38 @@ +<profiles> + ... + <profile> + <id>jboss-public-repository</id> + <repositories> + <repository> + <id>jboss-public-repository-group</id> + <name>JBoss Public Maven Repository Group</name> + <url>https://repository.jboss.org/nexus/content/groups/public/</url> + <layout>default</layout> + <releases> + <enabled>true</enabled> + <updatePolicy>never</updatePolicy> + </releases> + <snapshots> + <enabled>true</enabled> + <updatePolicy>never</updatePolicy> + </snapshots> + </repository> + </repositories> + <pluginRepositories> + <pluginRepository> + <id>jboss-public-repository-group</id> + <name>JBoss Public Maven Repository Group</name> + <url>https://repository.jboss.org/nexus/content/groups/public/</url> + <layout>default</layout> + <releases> + <enabled>true</enabled> + <updatePolicy>never</updatePolicy> + </releases> + <snapshots> + <enabled>true</enabled> + <updatePolicy>never</updatePolicy> + </snapshots> + </pluginRepository> + </pluginRepositories> + </profile> +</profiles> Added: root/docs/trunk/Developer_Guide/en-US/images/figu-Developer_Guide-Creating_a_project-RichFaces_palette_in_JBoss_Tools.png =================================================================== (Binary files differ) Property changes on: root/docs/trunk/Developer_Guide/en-US/images/figu-Developer_Guide-Creating_a_project-RichFaces_palette_in_JBoss_Tools.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream