From portal-commits at lists.jboss.org Mon Feb 18 03:25:42 2008
Content-Type: multipart/mixed; boundary="===============0840929828456094536=="
MIME-Version: 1.0
From: portal-commits at lists.jboss.org
To: portal-commits at lists.jboss.org
Subject: [portal-commits] JBoss Portal SVN: r10012 -
 docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules.
Date: Mon, 18 Feb 2008 03:25:42 -0500
Message-ID: <E1JR1Jm-0001QE-90@committer01.frg.pub.inap.atl.jboss.com>

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

Author: mmcallis
Date: 2008-02-18 03:25:42 -0500 (Mon, 18 Feb 2008)
New Revision: 10012

Modified:
   docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorial=
s.xml
Log:
5.2.4.4. Building your Apache MyFaces JSF Porlet
revising and adding content to make this section
consistent with 5.2.2.5. Building your JSP Portlet


Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/t=
utorials.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
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutoria=
ls.xml	2008-02-18 06:04:52 UTC (rev 10011)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutoria=
ls.xml	2008-02-18 08:25:42 UTC (rev 10012)
@@ -1431,9 +1431,9 @@
 </para>
 <para>
 	<note>
-		<title>Adding Functionality to a Apache MyFaces JSF Porlet</title>
+		<title>Adding Functionality to an Apache MyFaces JSF Porlet</title>
 		<para>
-			To add functionality to a Apache MyFaces JSF Porlet, sub-class it and c=
reate your own class.
+			To add functionality to an Apache MyFaces JSF Porlet, sub-class it and =
create your own class.
 		</para>
 	</note>
 </para>
@@ -1482,11 +1482,68 @@
 </sect3>
          <sect3>
             <title>Building your Apache MyFaces JSF Porlet</title>
-            <para>If you have downloaded the sample, you can execute the b=
uild.xml with ant or inside your IDE.
-               Executing <literal>ant</literal> will compile all source fi=
les and produce a
-               <literal>helloworldjsfportlet.war</literal> file in a way s=
imilar to what we saw in
-               <xref linkend=3D"first_portlet_build"/>.
-            </para>
+	    <para>
+		    The <filename>HelloWorldJSFMyFaces42Portlet.zip</filename> file cont=
ains a pre-compiled <filename>helloworldjsfmyfacesportlet.war</filename> fi=
le; however, to manually build the <filename>helloworldjsfmyfacesportlet.wa=
r</filename> file:
+	    </para>
+	    <para>
+		    <orderedlist>
+			    <listitem>
+				    <para>
+					    Change into the <filename>HelloWorldJSFMyFaces42Portlet/</filenam=
e> directory, and remove the existing <filename>helloworldjsfmyfacesportlet=
.war</filename> file.
+				    </para>
+			    </listitem>
+			    <listitem>
+				    <para>
+					    If required, edit the <filename>HelloWorldJSFMyFaces42Portlet/src=
/main/org/jboss/portlet/hello/bean/User.java</filename> file, and the appli=
cation descriptors in the <filename>HelloWorldJSFMyFaces42Portlet/src/resou=
rces/helloworldjsfmyfacesportlet-war/WEB-INF/</filename> directory.
+				    </para>
+			    </listitem>
+			    <listitem>
+				    <para>
+					    Change into <filename>HelloWorldJSFMyFaces42Portlet/</filename> d=
irectory, and run the <command>ant deploy</command> command. On Linux, the =
output will be similar to the following:
+				    </para>
+				    <para>
+					    <mediaobject>
+						    <imageobject>
+							    <imagedata align=3D"center" fileref=3D"images/tutorials/jsf_por=
tlet/myfaces_ant_deploy.png" valign=3D"middle"/>
+						    </imageobject>
+					    </mediaobject>
+				    </para>
+			    </listitem>
+		    </orderedlist>
+	    </para>
+	    <para>
+		    Note: the directory names will be different for your system.
+	    </para>
+	    <para>
+		    Expanding the <filename>helloworldjsfmyfacesportlet.war</filename> f=
ile allows you to deploy the portlet as an expanded directory, which makes =
development easier. As well, it gives you access to the application descrip=
tors, resource files, JSF, and JSP pages. To expand the <filename>helloworl=
djsfmyfacesportlet.war</filename> file:
+	    </para>
+	    <para>
+		    <orderedlist>
+			    <listitem>
+				    <para>
+					    If you do not have the <filename>HelloWorldJSFMyFaces42Portlet/he=
lloworldjsfmyfacesportlet.war</filename> file, change into the <filename>He=
lloWorldJSFMyFaces42Portlet/</filename> directory, and run the <command>ant=
 deploy</command> command. This creates the <filename>helloworldjsfmyfacesp=
ortlet.war</filename> file.
+				    </para>
+			    </listitem>
+			    <listitem>
+				    <para>
+					    To expand the WAR file, change into the <filename>HelloWorldJSFMy=
Faces42Portlet/</filename> directory, and run the <command>ant explode</com=
mand> command. On Linux, the output will be similar to the following:
+				    </para>
+				    <para>
+					    <mediaobject>
+						    <imageobject>
+							    <imagedata align=3D"center" fileref=3D"images/tutorials/jsf_por=
tlet/myfaces_ant_explode.png" valign=3D"middle"/>
+						    </imageobject>
+					    </mediaobject>
+				    </para>
+			    </listitem>
+		    </orderedlist>
+	    </para>
+	    <para>
+		    Note: the directory names will be different for your system.
+	    </para>
+	    <para>
+		    The expanded WAR file and the application descriptors are located in=
 the <filename>HelloWorldJSFMyFaces42Portlet/output/lib/exploded/helloworld=
jsfmyfacesportlet.war/WEB-INF/</filename> directory.
+	    </para>
     </sect3>
     <sect3>
 	    <title>Deploying your Apache MyFaces JSF Portlet</title>


--===============0840929828456094536==--