Author: ochikvina
Date: 2008-01-16 09:15:17 -0500 (Wed, 16 Jan 2008)
New Revision: 5742
Modified:
trunk/seam/docs/reference/en/modules/creating_new_seam.xml
Log:
http://jira.jboss.com/jira/browse/JBDS-234 - updating according to the remarks made by
Svetlana Mukhina
Modified: trunk/seam/docs/reference/en/modules/creating_new_seam.xml
===================================================================
--- trunk/seam/docs/reference/en/modules/creating_new_seam.xml 2008-01-16 14:10:23 UTC
(rev 5741)
+++ trunk/seam/docs/reference/en/modules/creating_new_seam.xml 2008-01-16 14:15:17 UTC
(rev 5742)
@@ -33,12 +33,12 @@
<property>File > New > Seam Web Project</property>
</emphasis> to run the <property>New Seam
Project</property> wizard. The wizard form
allows you to create runtime and server instances in order to get started
creating,
- running, and debugging J2EE applications.</para>
+ running, and debugging J2EE (only) applications.</para>
<para>Seam Web Project wizard has an option for selecting the actual Server
(not just WTP
runtime) that will be used for the project. This allows the wizard to
identify correctly
where the required datasource and driver libraries need to go.</para>
<para>Let's get through the wizard step-by-step. First, you should
enter a name and
- a location directory for your new project</para>
+ a location directory for your new project/</para>
<figure>
<title>New Seam Project Wizard</title>
<mediaobject>
@@ -74,7 +74,7 @@
you want.</para>
<figure>
- <title>Specifying Target Server Runtime</title>
+ <title>Specifying Target Runtime Configurations</title>
<mediaobject>
<imageobject>
<imagedata
fileref="images/create_new_seam/create_seam3.png"/>
@@ -104,13 +104,13 @@
</mediaobject>
</figure>
- <para>Next dialog allows you to verify chosen Runtime information as well
as set login
- credentials and specify a deploy directory. Leave everything as it is and
click on <emphasis>
+ <para>Next dialog allows you to verify chosen Runtime information, set
login
+ credentials to authorize an access to the server and specify a directory for
deploying. Leave everything as it is and click on <emphasis>
<property>Next</property>
</emphasis>.</para>
<figure>
- <title>New Server Dialog</title>
+ <title>Specifying Server Configurations</title>
<mediaobject>
<imageobject>
<imagedata
fileref="images/create_new_seam/create_seam5.png"/>
@@ -121,7 +121,7 @@
<para>On the last wizard step you can modify your project to configure it
on server.</para>
<figure>
- <title>New Server Dialog</title>
+ <title>Project Modification for Configuring on the
Server</title>
<mediaobject>
<imageobject>
<imagedata
fileref="images/create_new_seam/create_seam6.png"/>
@@ -135,19 +135,19 @@
</emphasis> button you should have the following wizard
view:</para>
<figure>
- <title>New Seam Project Creation</title>
+ <title>Completion of Runtime and Server Configuration</title>
<mediaobject>
<imageobject>
<imagedata
fileref="images/create_new_seam/create_seam7.png"/>
</imageobject>
</mediaobject>
</figure>
-
+
<para>The last section on this wizard step is
<property>Configurations</property>. Here, you
- can select one of the pre-defined project configurations either Dynamic Web
Project with
- Seam 1.2 or with Seam 2.0 that's the latest release but just only a
technology
- preview. In addition, you can create your own configuration. Choosing
Default
- Configuration for jBoss 4.2 Runtime allows you later to specify your own set
of facets
+ can select one of the pre-defined project configurations either associated
with Seam 1.2 or with Seam 2.0 that is the latest release but just only a technology
+ preview. In addition, you can create your own configuration. Choosing
<emphasis>
+ <property>Default
+ Configuration for jBoss 4.2 Runtime</property></emphasis> allows
you later to specify your own set of facets
for adding extra functionality to your project. For more details about
facets, see next
section.</para>
@@ -160,11 +160,11 @@
<title>Select the Project Facets</title>
<para>This page of the wizard allows you to enable or disable specific
facets that define
- necessary characteristics for the project. In time you switch to this wizard
form,
- all critical facets are already checked for the chosen Dynamic Web
Project.</para>
+ necessary characteristics for the project. In time you switch to this wizard
form, all
+ critical facets are already checked for the chosen Dynamic Web
Project.</para>
- <para>Notice that this page of the wizard also allows you to specify the
necessary version for
- any facet. </para>
+ <para>Notice that this page of the wizard also allows you to specify the
necessary version
+ for any facet. </para>
<figure>
<title>Project Facets Selection</title>
@@ -196,7 +196,7 @@
</emphasis> button.</para>
<figure>
- <title>Project Facets Selection</title>
+ <title>Runtime Manipulations</title>
<mediaobject>
<imageobject>
<imagedata
fileref="images/create_new_seam/create_seam8_2.png"/>
@@ -216,7 +216,7 @@
<section id="configureWebModule">
<title>How to Configure Web Module Settings</title>
- <para> As we deal with a dynamic web application we should first specify
the top level
+ <para> As we deal with a Dynamic Web Application we should first specify
the top level
directory of our application for deploying it to a server afterwards. You
know, this
kind of application contains both Web and Java code resources. Thus, it's
also important
to indicate the content directory as well as Java source directory. The
wizard will put
@@ -280,7 +280,7 @@
</emphasis> to complete the choice.</para>
<figure>
- <title>Create JSF Implementation Library</title>
+ <title>Create JSF Implementation Component Library</title>
<mediaobject>
<imageobject>
<imagedata
fileref="images/create_new_seam/create_seam10_2.png"/>
@@ -368,11 +368,6 @@
</listitem>
</itemizedlist>
- <para>By default, <emphasis>
- <property>DefaultDS</property></emphasis> value of
Connection profile is set here. You can organise the
- other one by clicking on <emphasis>
- <property>New</property>
- </emphasis> button and selecting necessary for you type of connection
profile.</para>
<figure>
<title>Connection Profile Options</title>
<mediaobject>
@@ -382,6 +377,11 @@
</mediaobject>
</figure>
+ <para>You can edit chosen profile by using <emphasis>
+ <property>Edit</property>
+ </emphasis> button or organise a new one by clicking on <emphasis>
+ <property>New</property>
+ </emphasis> button and selecting necessary for you type of connection
profile.</para>
<figure>
<title>Connection Profile Selecting</title>
<mediaobject>
@@ -391,12 +391,27 @@
</mediaobject>
</figure>
- <para>Other Database fields are describing a Database and a connection to
it.</para>
- <para>In the <property>Code Generation</property> section the
wizard have already put the names for your
- <property>Session Bean</property>, <property>Entity
Bean</property> and
- <property>Test</property> packages. Of course, you can change
them to any others likable for you.</para>
+ <para>On the other dialog you'll be asked to enter its name and
description. And then you should select a proper
+ driver and adjust connection details. Press <emphasis>
+ <property>Next</property>
+ </emphasis> to preview all the adjusted settings and complete the
creation of the new profile.</para>
<figure>
+ <title>Connection Details</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/create_new_seam/create_seam13_2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The next block of settings in the Seam Facet wizard are describing a
Database and a connection to it.</para>
+ <para>In the <property>Code Generation</property> section the
wizard have already put the
+ names for your <property>Session Bean</property>,
<property>Entity Bean</property> and
+ <property>Test</property> packages. Of course, you can change
them into the others
+ which you like.</para>
+
+ <figure>
<title>Code Generation Section</title>
<mediaobject>
<imageobject>