Author: SeanRogers
Date: 2010-05-27 03:17:13 -0400 (Thu, 27 May 2010)
New Revision: 17307
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:
Updating Getting Started chapter based on feedback.
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-27
01:08:07 UTC (rev 17306)
+++
root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-Getting_started_with_RichFaces.xml 2010-05-27
07:17:13 UTC (rev 17307)
@@ -4,234 +4,95 @@
<chapter id="chap-Developer_Guide-Getting_started_with_RichFaces">
<title>Getting started with RichFaces</title>
<para>
- Follow the instructions in this chapter to install and configure RichFaces for
development. If you have existing projects that use an previous version of RichFaces,
refer to the <citetitle>RichFaces Migration Guide</citetitle>.
+ 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"
/>.
</para>
+ <para>
+ If you have existing projects that use a previous version of RichFaces, refer to the
<citetitle>RichFaces Migration Guide</citetitle>.
+ </para>
<section
id="sect-Developer_Guide-Getting_started_with_RichFaces-Technical_Requirements">
<title>Technical Requirements</title>
<para>
- RichFaces has been developed with an open architecture to be compatible with a wide
variety of environments. In addition to the RichFaces framework, you need the following
frameworks, environments, and applications installed on your computer to start developing
with RichFaces:
- <variablelist>
- <varlistentry>
- <term>Java Development Kit (<acronym>JDK</acronym>)</term>
- <listitem>
- <para>
- RichFaces supports the following JDK versions:
- <itemizedlist>
- <listitem>
- <para>
- JDK 1.5 and higher
- </para>
- </listitem>
- </itemizedlist>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>JavaServer Faces (<acronym>JSF</acronym>)</term>
- <listitem>
- <para>
- RichFaces supports the following JSF implementations and frameworks:
- <itemizedlist>
- <!--
- <listitem>
- <para>
- Facelets 1.1.1 – 1.2
- </para>
- </listitem>
- -->
- <listitem>
- <para>
- MyFaces 1.2.5
- </para>
- </listitem>
- <listitem>
- <para>
- Seam 1.2 and higher
- </para>
- </listitem>
- <!--
- <listitem>
- <para>
- Sun JSF-RI 1.2_12
- </para>
- </listitem>
- -->
- </itemizedlist>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>A Java application server or servlet container</term>
- <listitem>
- <para>
- RichFaces supports the following servers:
- <itemizedlist>
- <listitem>
- <para>
- Apache Tomcat 5.5 – 6.0
- </para>
- </listitem>
- <listitem>
- <para>
- BEA WebLogic 9.1 – 10.0
- </para>
- </listitem>
- <listitem>
- <para>
- JBoss 4.2 – 5.0
- </para>
- </listitem>
- <listitem>
- <para>
- Geronimo 2.0 and higher
- </para>
- </listitem>
- <listitem>
- <para>
- Glassfish (J2EE 5)
- </para>
- </listitem>
- <listitem>
- <para>
- Resin 3.1
- </para>
- </listitem>
- <listitem>
- <para>
- Sun Application Server 9 (J2EE 1.5)
- </para>
- </listitem>
- <listitem>
- <para>
- Websphere 7.0 and higher
- </para>
- </listitem>
- </itemizedlist>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>A web browser</term>
- <listitem>
- <para>
- RichFaces supports the following web browsers:
- <itemizedlist
id="item-Developer_Guide-Technical_Requirements-Linux_environments">
- <title>Linux environments</title>
- <listitem>
- <para>
- Firefox 3.0 and higher
- </para>
- </listitem>
- <listitem>
- <para>
- Google Chrome
- </para>
- </listitem>
- <listitem>
- <para>
- Opera 9.5 and higher
- </para>
- </listitem>
- </itemizedlist>
- <itemizedlist
id="item-Developer_Guide-Technical_Requirements-Mac_OS_environments">
- <title>Mac OS environments</title>
- <listitem>
- <para>
- Firefox 3.5 and higher
- </para>
- </listitem>
- <listitem>
- <para>
- Google Chrome
- </para>
- </listitem>
- <listitem>
- <para>
- Safari 3.0 and higher
- </para>
- </listitem>
- </itemizedlist>
- <itemizedlist
id="item-Developer_Guide-Technical_Requirements-Microsoft_Windows_environments">
- <title>Microsoft Windows environments</title>
- <listitem>
- <para>
- Firefox 3.0 and higher
- </para>
- </listitem>
- <listitem>
- <para>
- Google Chrome
- </para>
- </listitem>
- <listitem>
- <para>
- Internet Explorer 7.0 and higher
- </para>
- </listitem>
- <listitem>
- <para>
- Opera 9.5 and higher
- </para>
- </listitem>
- <listitem>
- <para>
- Safari 3.0 and higher
- </para>
- </listitem>
- </itemizedlist>
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
+ The minimum technical requirements needed to get started with RichFaces are outlined
below.
</para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Java Development Kit (<acronym>JDK</acronym>) 1.5 or higher
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <productname>JBoss Tools 3.1</productname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ A <productname>JavaServer Faces 2</productname> (<acronym>JSF
2</acronym>) implementation
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ An application server, such as <productname>JBoss Application Server
6</productname> or <productname>Apache Tomcat 6</productname>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ A web browser, such as <productname>Firefox 3.5</productname> or
<productname>Internet Explorer 7</productname>
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ RichFaces supports additional products not listed here. Refer to <xref
linkend="sect-Component_Reference-RichFaces_overview-Full_technical_requirements"
/> for a full list of technical requirements and supported envrionments, browsers, and
tools.
+ </para>
+
</section>
- <section
id="sect-Developer_Guide-Getting_started_with_RichFaces-Installing_RichFaces">
- <title>Installing RichFaces</title>
+ <section
id="sect-Developer_Guide-Getting_started_with_RichFaces-Setting_up_RichFaces">
+ <title>Setting up RichFaces</title>
<para>
- Follow the instructions in this section to install the RichFaces framework and begin
building applications.
+ Follow the instructions in this section to set up the RichFaces framework and begin
building applications.
</para>
- <section
id="sect-Developer_Guide-Installing_RichFaces-Downloading_RichFaces">
- <title>Downloading RichFaces</title>
- <para>
- Download RichFaces from the JBoss RichFaces Downloads area at <ulink
url="http://www.jboss.org/richfaces/download.html">http://ww...;.
The binary files (available in <filename
class="extension">.bin.zip</filename> or <filename
class="extension">.bin.tar.gz</filename> archives) contain a compiled,
ready-to-use version of RichFaces with a set of basic skins.
- </para>
- <para>
- Create a new directory named <filename>RichFaces</filename>, then unzip
the archive containing the binaries there.
- </para>
- <section
id="sect-Developer_Guide-Downloading_RichFaces-Compiling_the_source">
- <title>Compiling the source</title>
- <!-- Update download location in Enterprise docs, or remove this section
altogether -->
+ <procedure>
+ <step>
+ <title>Download RichFaces archive</title>
<para>
- Instead of downloading the pre-compiled binaries, you can download the source files
and compile them yourself. Download the source files (also available in <filename
class="extension">.bin.zip</filename> or <filename
class="extension">.bin.tar.gz</filename> archives) from the JBoss
RichFaces Downloads area at <ulink
url="http://www.jboss.org/richfaces/download.html">http://ww...;.
+ Download RichFaces from the JBoss RichFaces Downloads area at <ulink
url="http://www.jboss.org/richfaces/download.html">http://ww...;.
The binary files (available in <filename
class="extension">.bin.zip</filename> or <filename
class="extension">.bin.tar.gz</filename> archives) contain a compiled,
ready-to-use version of RichFaces with a set of basic skins.
</para>
- <!-- Remove SVN details in Enterprise docs -->
+ <stepalternatives>
+ <step>
+ <title>Compiling from source</title>
+ <para>
+ Instead of downloading the pre-compiled binaries, you can download the source
files and compile them yourself. Refer to <xref
linkend="sect-Component_Reference-RichFaces_overview-Compiling_from_source_code"
/> for further instructions.
+ </para>
+ </step>
+ </stepalternatives>
+ </step>
+ <step>
+ <title>Unzip archive</title>
<para>
- Alternatively, the source files can be downloaded from the anonymous SVN repository
at <ulink
url="http://anonsvn.jboss.org/repos/richfaces/root/">http://...
using the following command:
+ Create a new directory named <filename>RichFaces</filename>, then unzip
the archive containing the binaries there.
</para>
-<screen>svn co
http://anonsvn.jboss.org/repos/richfaces/root/</screen>
- </section>
+ </step>
+ </procedure>
- </section>
-
</section>
- <section
id="sect-Developer_Guide-Getting_started_with_RichFaces-Creating_a_project">
- <title>Creating a project</title>
+ <section
id="sect-Developer_Guide-Getting_started_with_RichFaces-Creating_a_project_with_JBoss_Tools">
+ <title>Creating a project with <productname>JBoss
Tools</productname></title>
<para>
- Follow the procedure in this section to create a new RichFaces application with
<application>JBoss Tools</application>.
+ Follow the procedure in this section to create a new RichFaces application with
<productname>JBoss Tools</productname>.
</para>
<procedure>
<step
id="step-Developer_Guide-Creating_a_project-Create_a_new_project">
<title>Create a new project</title>
<para>
- Create a new project based on the JSF 2 environment. In <application>JBoss
Tools</application>, select
<menuchoice><guimenu>File</guimenu><guimenu>New</guimenu><guimenuitem>JSF
Project</guimenuitem></menuchoice> from the menu. Name the project, select
<guilabel>JSF 2</guilabel> from the <guilabel>JSF
Environment</guilabel> drop-down box, and click the
<guibutton>Finish</guibutton> button to create the project.
+ Create a new project based on the JSF 2 environment. In <productname>JBoss
Tools</productname>, select
<menuchoice><guimenu>File</guimenu><guimenu>New</guimenu><guimenuitem>JSF
Project</guimenuitem></menuchoice> from the menu. Name the project, select
<guilabel>JSF 2</guilabel> from the <guilabel>JSF
Environment</guilabel> drop-down box, and click the
<guibutton>Finish</guibutton> button to create the project.
</para>
</step>
<step
id="step-Developer_Guide-Creating_a_project-Add_the_RichFaces_libraries_to_the_project">
<title>Add the RichFaces libraries to the project</title>
<para>
- Add <filename>core-ui.jar</filename>,
<filename>richfaces-api.jar</filename>, and
<filename>richfaces-impl.jar</filename> into your project by dragging them
from the location where you unzipped the RichFaces archive to the
<filename>WebContent/WEB-INF/lib/</filename> directory of your project in
<application>JBoss Tools</application>.
+ Add <filename>core-ui.jar</filename>,
<filename>richfaces-api.jar</filename>, and
<filename>richfaces-impl.jar</filename> into your project by copying them from
the location where you unzipped the RichFaces archive to the
<filename>WebContent/WEB-INF/lib/</filename> directory of your project in
<application>JBoss Tools</application>.
</para>
<!--
<note>
@@ -290,10 +151,10 @@
</para>
</section>
- <section
id="sect-Developer_Guide-Getting_started_with_RichFaces-Using_RichFaces_with_Maven">
- <title>Using RichFaces with Maven</title>
+ <section
id="sect-Developer_Guide-Getting_started_with_RichFaces-Creating_a_project_with_Maven">
+ <title>Creating a project with
<productname>Maven</productname></title>
<para>
- Maven is a build automation and project management tool for Java projects. Follow the
instructions in this section to integrate RichFaces into a Maven project.
+ <productname>Maven</productname> is a build automation and project
management tool for Java projects. Follow the instructions in this section to create a
Maven project for RichFaces.
</para>
<procedure>
<step
id="step-Developer_Guide-Using_RichFaces_with_Maven-Add_required_repositories">
@@ -465,7 +326,7 @@
<section
id="sect-Developer_Guide-Getting_started_with_RichFaces-Using_RichFaces_in_existing_JSF2_projects">
<title>Using RichFaces in existing JSF2 projects</title>
<para>
- RichFaces can be added to existing JSF2 projects by adding references to the RichFaces
libraries. Refer to <xref
linkend="step-Developer_Guide-Creating_a_project-Add_the_RichFaces_libraries_to_the_project"
/> and <xref
linkend="step-Developer_Guide-Creating_a_project-Reference_the_tag_libraries"
/> in <xref
linkend="sect-Developer_Guide-Getting_started_with_RichFaces-Creating_a_project"
/> for details.
+ RichFaces can be added to existing JSF2 projects by adding references to the new
RichFaces libraries. Refer to <xref
linkend="step-Developer_Guide-Creating_a_project-Add_the_RichFaces_libraries_to_the_project"
/> and <xref
linkend="step-Developer_Guide-Creating_a_project-Reference_the_tag_libraries"
/> in <xref
linkend="sect-Developer_Guide-Getting_started_with_RichFaces-Creating_a_project_with_JBoss_Tools"
/> for details.
</para>
</section>
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-27
01:08:07 UTC (rev 17306)
+++
root/docs/trunk/Developer_Guide/en-US/chap-Developer_Guide-RichFaces_overview.xml 2010-05-27
07:17:13 UTC (rev 17307)
@@ -28,6 +28,207 @@
<para>
Using JSF tags, RichFaces allows different parts of a JSF page to be updated with an
Ajax request. JSF pages using RichFaces do not change from "regular" JSF pages,
and additional JavaScript code is not required.
</para>
+ <section
id="sect-Component_Reference-RichFaces_overview-Full_technical_requirements">
+ <title>Full technical requirements</title>
+ <para>
+ RichFaces has been developed with an open architecture to be compatible with a wide
variety of environments.
+ </para>
+ <section
id="sect-Component_Reference-RichFaces_overview-Server_requirements">
+ <title>Server requirements</title>
+ <para>
+ A Java application server or servlet container is required for running RichFaces
applications. RichFaces supports the following servers:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Apache Tomcat 6.0 and higher
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ BEA WebLogic 9.1 – 10.0
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ JBoss 4.2 and higher
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Geronimo 2.0 and higher
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Glassfish (J2EE 5 and JEE 6)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Resin 3.1
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Sun Application Server 9 (J2EE 1.5)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Websphere 7.0 and higher
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section
id="sect-Component_Reference-RichFaces_overview-Client_requirements">
+ <title>Client requirements</title>
+ <para>
+ Clients accessing RichFaces applications require a web browser. Richfaces supports
the following web browsers:
+ </para>
+ <itemizedlist
id="item-Developer_Guide-Technical_Requirements-Linux_environments">
+ <title>Linux environments</title>
+ <listitem>
+ <para>
+ Firefox 3.0 and higher
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Google Chrome
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Opera 9.5 and higher
+ </para>
+ </listitem>
+ </itemizedlist>
+ <itemizedlist
id="item-Developer_Guide-Technical_Requirements-Mac_OS_environments">
+ <title>Mac OS environments</title>
+ <listitem>
+ <para>
+ Firefox 3.5 and higher
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Google Chrome
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Safari 3.0 and higher
+ </para>
+ </listitem>
+ </itemizedlist>
+ <itemizedlist
id="item-Developer_Guide-Technical_Requirements-Microsoft_Windows_environments">
+ <title>Microsoft Windows environments</title>
+ <listitem>
+ <para>
+ Firefox 3.0 and higher
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Google Chrome
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Internet Explorer 7.0 and higher
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Opera 9.5 and higher
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Safari 3.0 and higher
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section
id="sect-Component_Reference-RichFaces_overview-Development_requirements">
+ <title>Development requirements</title>
+ <para>
+ Developing applications with the RichFaces framework requires the Java Development
Kit (<acronym>JDK</acronym>), an implementation of JavaServer Faces
(<acronym>JSF</acronym>), and a development environment.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>Java Development Kit (<acronym>JDK</acronym>)</term>
+ <listitem>
+ <para>
+ RichFaces supports the following JDK versions:
+ <itemizedlist>
+ <listitem>
+ <para>
+ JDK 1.5 and higher
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>JavaServer Faces (<acronym>JSF</acronym>)</term>
+ <listitem>
+ <para>
+ RichFaces supports the following JSF implementations and frameworks:
+ <itemizedlist>
+ <!--
+ <listitem>
+ <para>
+ Facelets 1.1.1 – 1.2
+ </para>
+ </listitem>
+ -->
+ <listitem>
+ <para>
+ MyFaces 2 and higher
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Seam 2 and higher
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Sun JSF-RI 2 and higher
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Development environment</term>
+ <listitem>
+ <para>
+ RichFaces can be developed using most Java development environments. The following
are recommended, and used for examples in this guide:
+ <itemizedlist>
+ <listitem>
+ <para>
+ JBoss Tools 3.1 and higher
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Maven 2.1.0 and higher
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+
+ </section>
+
<section id="sect-Developer_Guide-RichFaces_overview-Architecture">
<title>Architecture</title>
<para>
@@ -193,6 +394,158 @@
</itemizedlist>
</para>
</section>
+
+ <section
id="sect-Component_Reference-RichFaces_overview-Compiling_from_source_code">
+ <title>Compiling from source code</title>
+ <para>
+ The source code for the RichFaces framework can be downloaded and compiled manually
rather than using the pre-compiled binaries.
+ </para>
+ <procedure>
+ <step>
+ <title>Download source code</title>
+ <stepalternatives>
+ <step>
+ <title>JBoss RichFaces Downloads area</title>
+ <!-- Update download location in Enterprise docs, or remove this section
altogether -->
+ <para>
+ Download the source files (also available in <filename
class="extension">.bin.zip</filename> or <filename
class="extension">.bin.tar.gz</filename> archives) from the JBoss
RichFaces Downloads area at <ulink
url="http://www.jboss.org/richfaces/download.html">http://ww...;.
+ </para>
+ </step>
+ <step>
+ <title>Anonymous SVN repository</title>
+ <!-- Remove SVN details in Enterprise docs -->
+ <para>
+ Alternatively, the source files can be downloaded from the anonymous SVN
repository at <ulink
url="http://anonsvn.jboss.org/repos/richfaces/root/">http://...
using the following command:
+ </para>
+ <screen>svn co
http://anonsvn.jboss.org/repos/richfaces/root/</screen>
+ </step>
+ </stepalternatives>
+ </step>
+ <step>
+ <title>Unzip archive</title>
+ <para>
+ Create a new directory named <filename>RichFaces</filename>, then unzip
the archive containing the source code there.
+ </para>
+ </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:
+ </para>
+ <screen>mvn clean install</screen>
+ <para>
+ Add any of the following options after the command to customize the build:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term><command>-P release,docs</command></term>
+ <listitem>
+ <para>
+ Maven additionally builds the documentation and release artifacts.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><command>-D skipTests=true</command></term>
+ <listitem>
+ <para>
+ Maven skips the unit and functional tests, which completes the build faster.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><command>-D checkstyle.skip=true</command></term>
+ <listitem>
+ <para>
+ Maven skips the scans for checking style, which completes the build faster.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><command>-D skip-source</command></term>
+ <listitem>
+ <para>
+ Maven does not produce any source <filename>jar</filename> files from
the build.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><command>-D skip-enforce</command></term>
+ <listitem>
+ <para>
+ Maven does not check for the correct JDK version, Maven version, and
<literal>SNAPSHOT</literal> plug-in, and forces the build.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><command>-D
jsf-profile=<replaceable>implementation</replaceable></command></term>
+ <listitem>
+ <para>
+ Maven tests builds and tests against the specified JSF implementation. The
<replaceable>implementation</replaceable> value can be any of the following:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>jsf_ri</literal>: The latest release of
<productname>JSF RI (Mojarra)</productname>. This is the default
implemenation.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>jsf_ri_javax</literal>: The latest release of
<productname>javax.faces</productname>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>jsf_ri_snapshot</literal>: The latest snapshot version of
<productname>JSF RI (Mojarra)</productname>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>myfaces</literal>: The latest release of
<productname>MyFaces</productname>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>myfaces</literal>: The latest snapshot version of
<productname>MyFaces</productname>.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </step>
+ <step>
+ <title>Access compiled binaries</title>
+ <para>
+ The compiled libraries are located in the following sub-directories of the root
RichFaces directory:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <filename>ui/assembly/target/dist/richfaces-ui-<replaceable>version</replaceable>-SNAPSHOT.jar</filename>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <filename>framework/api/target/richfaces-api-<replaceable>version</replaceable>-SNAPSHOT.jar</filename>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <filename>framework/impl/target/richfaces-impl-<replaceable>version</replaceable>-SNAPSHOT.jar</filename>
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ If Maven built the framework using the <command>-P release</command>
option, the distribution package containing all three compiled libraries and reference
documentation is located at
<filename>ui/assembly/target/dist/richfaces-ui-<replaceable>version</replaceable>-SNAPSHOT-bin.zip</filename>.
+ </para>
+ </step>
+ </procedure>
+ <para>
+ You can now add the compiled libraries to your project as described in <xref
linkend="step-Developer_Guide-Creating_a_project-Add_the_RichFaces_libraries_to_the_project"
/>.
+ </para>
+
+ </section>
</chapter>