From jbosstools-commits at lists.jboss.org Thu Feb 26 11:57:27 2009
Content-Type: multipart/mixed; boundary="===============0968049176933038282=="
MIME-Version: 1.0
From: jbosstools-commits at lists.jboss.org
To: jbosstools-commits at lists.jboss.org
Subject: [jbosstools-commits] JBoss Tools SVN: r13845 -
 trunk/portlet/docs/reference/en/modules.
Date: Thu, 26 Feb 2009 11:57:26 -0500
Message-ID: <E1LcjY6-00076z-Sz@committer01.frg.pub.inap.atl.jboss.com>

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

Author: ochikvina
Date: 2009-02-26 11:57:26 -0500 (Thu, 26 Feb 2009)
New Revision: 13845

Modified:
   trunk/portlet/docs/reference/en/modules/starting_project.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-552, https://jira.jboss.org/jira/br=
owse/JBDS-577 - updating the "Creating a Dynamic Web Project" section;

Modified: trunk/portlet/docs/reference/en/modules/starting_project.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
--- trunk/portlet/docs/reference/en/modules/starting_project.xml	2009-02-26=
 16:56:10 UTC (rev 13844)
+++ trunk/portlet/docs/reference/en/modules/starting_project.xml	2009-02-26=
 16:57:26 UTC (rev 13845)
@@ -30,9 +30,11 @@
                 <property>New</property>
             </emphasis> button in the <emphasis>
                 <property>Target Runtime</property>
-            </emphasis> section to specify a new Target Runtime. Click <em=
phasis>
-                <property>JBoss 4.2 Runtime</property>
-            </emphasis> and press <emphasis>
+            </emphasis> section to specify a new Target Runtime. Choose <e=
mphasis>
+                <property> JBoss Community &gt; JBoss 4.2 Runtime</propert=
y>
+            </emphasis> and select the <emphasis>
+                <property>Create a new local server</property>
+            </emphasis> checkbox. Click <emphasis>
                 <property>Next</property>.</emphasis></para>
 =

         <figure>
@@ -49,6 +51,15 @@
             </emphasis>, and then point it to the location of your JBoss A=
S + Portal
             installation.</para>
 =

+        <figure>
+            <title>New Server Runtime Environment</title>
+            <mediaobject>
+                <imageobject>
+                    <imagedata fileref=3D"images/starting_project/server_r=
untime_environment.png"/>
+                </imageobject>
+            </mediaobject>
+        </figure>
+
         <note>
             <title>Note:</title>
 =

@@ -57,8 +68,13 @@
                 version 2.0 (JSR-268), you have to choose JBoss Portal 2.7=
.</para>
         </note>
 =

+        <para>At this point a new JBoss Server instance will be created. H=
ere you can verify the
+            defined runtime information. If something is incorrect, press =
<emphasis>
+                <property>Back</property>
+            </emphasis> to return on the previous wizard page.</para>
+
         <figure>
-            <title>Target Runtime</title>
+            <title>Target Server</title>
             <mediaobject>
                 <imageobject>
                     <imagedata fileref=3D"images/starting_project/starting=
_project_3.png"/>
@@ -74,12 +90,6 @@
             </emphasis> button next to the <property>Configuration</proper=
ty> section to enable
             Portlet Facets for the project.</para>
 =

-        <!--para>where it&apos;s also necessary to set the project
-            Configuration. <property>JBoss Tools</property> (starting from=
 3.0.0.Alpha1) support the
-            JSR-168 Portlet Specification (Portlet 1.0), JSR-286 Portlet S=
pecification (Portlet
-            2.0). Thus you can choose <emphasis>Portlet Project v1.0</emph=
asis> or <emphasis>Portlet
-                Project v2.0</emphasis>.</para-->
-
         <figure>
             <title>Setting the Project Configuration</title>
             <mediaobject>
@@ -104,10 +114,33 @@
             </mediaobject>
         </figure>
 =

-        <para>The last wizard page is for configuring web modules. Here al=
l values are set, so you
-            can leave everything as it is.</para>
+        <note>
+            <title>Note:</title>
+            <para>If the portlet libraries aren&apos;t available in the ru=
ntime you targeted,
+                JBoss Portlet facets will be hidden on this page.</para>
+            <para>To made portal functionality always visible no matter wh=
at the runtime support,
+                you should go to <emphasis>
+                    <property>Window &gt; Preferences</property>
+                </emphasis> and then <emphasis>
+                    <property>JBoss Tools &gt; JBoss Portlet</property>
+                </emphasis> and deselect <emphasis>
+                    <property>Check runtimes for Portlet Components</prope=
rty>
+                </emphasis> checkbox (see figure below).</para>
+        </note>
 =

         <figure>
+            <title>JBoss Runtime Preferences</title>
+            <mediaobject>
+                <imageobject>
+                    <imagedata fileref=3D"images/starting_project/portlet_=
preferences.png"/>
+                </imageobject>
+            </mediaobject>
+        </figure>
+
+        <para>The next page is for configuring web modules. Here all value=
s are set, so you can
+            leave everything as it is.</para>
+
+        <figure>
             <title>The Project Web Modules</title>
             <mediaobject>
                 <imageobject>
@@ -116,9 +149,96 @@
             </mediaobject>
         </figure>
 =

-        <para>Press <emphasis>
-                <property>Finish</property>.</emphasis>
+        <para>Finally, the last wizard page will ask you to add JBoss Port=
let capabilities to your
+            project. Here you can choose whether to set up user libraries,=
 libraries provided by
+            server runtime or not include libraries at all.</para>
+        =

+        <itemizedlist>
+            <listitem><para>To set up server runtime libraries, you need t=
o select <emphasis>
+                <property>Libraries provided by server runtime</property><=
/emphasis> in the list box.</para>
+            </listitem>
+        </itemizedlist>
+        =

+        <figure>
+            <title>Including Server Runtime Libraries</title>
+            <mediaobject>
+                <imageobject>
+                    <imagedata fileref=3D"images/starting_project/portlet_=
capabilities6.png"/>
+                </imageobject>
+            </mediaobject>
+        </figure>
+
+        <itemizedlist>
+            <listitem>
+            <para>For setting up user libraries, select <emphasis>
+                <property>User library</property></emphasis> in the list b=
ox and then press <emphasis>
+                    <property>Add</property></emphasis> in the <emphasis>
+                        <property>User Library</property></emphasis> secti=
on.</para>
+            </listitem>
+        </itemizedlist>
+        =

+        <figure>
+            <title>Adding User Library</title>
+            <mediaobject>
+                <imageobject>
+                    <imagedata fileref=3D"images/starting_project/portlet_=
capabilities1.png"/>
+                </imageobject>
+            </mediaobject>
+        </figure>
+        =

+        <para>Then press <emphasis>
+            <property>New</property></emphasis> and type the user library =
name in the appeared dialog.</para>
+        =

+        <figure>
+        <title>Adding User Library</title>
+        <mediaobject>
+            <imageobject>
+                <imagedata fileref=3D"images/starting_project/portlet_capa=
bilities2.png"/>
+            </imageobject>
+        </mediaobject>
+        </figure>
+        =

+        <para>Next add necessary jar&apos;s.</para>
+        =

+        <figure>
+        <title>Adding the Portlet API Jar</title>
+        <mediaobject>
+            <imageobject>
+                <imagedata fileref=3D"images/starting_project/portlet_capa=
bilities3.png"/>
+            </imageobject>
+        </mediaobject>
+        </figure>
+        =

+        <para>Hit <emphasis>
+                <property>OK</property>.</emphasis> The user library will =
be added.
         </para>
+        =

+        <figure>
+            <title>User Library Added</title>
+            <mediaobject>
+                <imageobject>
+                    <imagedata fileref=3D"images/starting_project/portlet_=
capabilities4.png"/>
+                </imageobject>
+            </mediaobject>
+        </figure>
+        =

+        <itemizedlist>
+            <listitem><para>If you don&apos;t need to include libraries at=
 all, just deselect the <emphasis>
+                <property>Enable implementation library</property></emphas=
is> checkbox.</para>
+            </listitem>
+        </itemizedlist>
+        =

+        <figure>
+            <title>Disabling Implementation Libraries</title>
+            <mediaobject>
+                <imageobject>
+                    <imagedata fileref=3D"images/starting_project/portlet_=
capabilities5.png"/>
+                </imageobject>
+            </mediaobject>
+        </figure>
+        =

+        <para>After setting JBoss Portlet capabilities press <emphasis>
+            <property>Finish</property>.</emphasis></para>
 =

         <para>That&apos;s it! Our base project is done.</para>
 =



--===============0968049176933038282==--