From richfaces-svn-commits at lists.jboss.org Thu Apr  7 22:24:12 2011
Content-Type: multipart/mixed; boundary="===============6040781923300017441=="
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: r22394 -
 modules/docs/trunk/Developer_Guide/src/main/docbook/en-US.
Date: Thu, 07 Apr 2011 22:24:12 -0400
Message-ID: <201104080224.p382OClq031798@svn01.web.mwc.hst.phx2.redhat.com>

--===============6040781923300017441==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: SeanRogers
Date: 2011-04-07 22:24:11 -0400 (Thu, 07 Apr 2011)
New Revision: 22394

Modified:
   modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer=
_Guide-Getting_started_with_RichFaces.xml
Log:
Revised Maven integration section: RFPL-1415

Modified: modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-De=
veloper_Guide-Getting_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
--- modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Develope=
r_Guide-Getting_started_with_RichFaces.xml	2011-04-08 01:06:44 UTC (rev 223=
93)
+++ modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Develope=
r_Guide-Getting_started_with_RichFaces.xml	2011-04-08 02:24:11 UTC (rev 223=
94)
@@ -317,13 +317,9 @@
 						The <computeroutput>BUILD SUCCESSFUL</computeroutput> message indica=
tes the project has been assembled and is ready to import into an IDE (inte=
grated development environment), such as <productname>JBoss Tools</productn=
ame>.
 					</para>
 				</step>
-			=

-				<step id=3D"step-Developer_Guide-Using_RichFaces_with_Maven-Import_the=
_project_into_an_IDE">
-					<title>Import the project into an IDE</title>
-					<para>
-						To import the project into <productname>Eclipse</productname>, eithe=
r use Maven to prepare the project or import it directly using <productname=
>JBoss Tools</productname>.
-					</para>
-					<stepalternatives>
+
+				<!--deprecated-->
+				<!--
 						<step>
 							<title>Use <application>Maven</application> to prepare the project =
for <application>Eclipse</application></title>
 							<substeps>
@@ -341,37 +337,58 @@
 								</step>
 							</substeps>
 						</step>
+				-->
+			=

+				<step id=3D"step-Developer_Guide-Using_RichFaces_with_Maven-Import_the=
_project_into_an_IDE">
+					<title>Import the project into an IDE</title>
+					<para>
+						To import the project into <productname>Eclipse</productname> and <p=
roductname>JBoss Tools</productname>, use the JBoss Maven Integration plug-=
ins. These plug-ins work with plug-ins from the M2Eclipse project to import=
 Maven projects.
+					</para>
+					<substeps>
 						<step>
-							<title>Import directly using <productname>JBoss Tools</productname>=
</title>
-							<para>
-								<productname>JBoss Tools</productname> contains the following plug=
-ins to import Maven projects:
-							</para>
-							<itemizedlist>
-								<listitem>
+							<title>Install the plug-ins</title>
+							<substeps>
+								<step>
 									<para>
-										JBoss Maven Integration
+										Choose <menuchoice><guimenu>Help</guimenu><guimenuitem>Install N=
ew Software</guimenuitem></menuchoice> from the Eclipse menu.
 									</para>
-								</listitem>
-								<listitem>
+								</step>
+								<step>
 									<para>
-										JBoss Maven JSF Integration
+										Select the JBoss Tools update site to use, then open the <guilab=
el>Maven Support</guilabel> group and select the <guilabel>JBoss Maven Inte=
gration</guilabel> and <guilabel>JBoss Maven JSF Configurator</guilabel> pl=
ug-ins.
 									</para>
-								</listitem>
-							</itemizedlist>
-							<substeps>
+								</step>
 								<step>
 									<para>
-										Install <productname>JBoss Tools</productname> using the instruc=
tions on the <citetitle>JBoss Tools Downloads</citetitle> site at <ulink ur=
l=3D"http://www.jboss.org/tools/download.html" />.
-									</para>	=

+										Follow the prompts to install the integration plug-ins. Include =
the transitive dependencies <guilabel>Maven Integration for Eclipse</guilab=
el> and <guilabel>Maven Integration for WTP</guilabel>. Both of these depen=
dencies are from the M2Eclipse project.
+									</para>
 								</step>
 								<step>
 									<para>
-										With the plug-ins installed, open the importing wizard by choosi=
ng <menuchoice><guimenu>File</guimenu><guimenuitem>Import</guimenuitem></me=
nuchoice> from the menu. Select <menuchoice><guimenu>Maven</guimenu><guimen=
uitem>Existing Maven Projects</guimenuitem></menuchoice> as the import sour=
ce and choose the <filename>pom.xml</filename> file for your project.
+										Restart Eclipse to finish the installation.
 									</para>
 								</step>
 							</substeps>
 						</step>
-					</stepalternatives>
+						<step>
+							<title>Open the importing wizard</title>
+							<para>
+								With the plug-ins installed, open the importing wizard by choosing=
 <menuchoice><guimenu>File</guimenu><guimenuitem>Import</guimenuitem></menu=
choice> from the menu.
+							</para>
+						</step>
+						<step>
+							<title>Select the project</title>
+							<para>
+								Select <menuchoice><guimenu>Maven</guimenu><guimenuitem>Existing M=
aven Projects</guimenuitem></menuchoice> as the import source and choose th=
e directory with the <filename>pom.xml</filename> file for your project.
+							</para>
+						</step>
+					</substeps>
+					<note>
+						<title>Exporting from Maven</title>
+						<para>
+							The ability to prepare the project for Eclipse and export it using =
Maven is deprecated in RichFaces 4.0. The process does not support JBoss in=
tegration-specific features, such as JSF Facets.
+						</para>
+					</note>
 				</step>
 			</procedure>
 		=



--===============6040781923300017441==--