Author: ykryvinchanka Date: 2007-10-30 09:48:08 -0400 (Tue, 30 Oct 2007) New Revision: 4577 Modified: trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/DevelopAsimpleJSPWebApplication.xml trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/GetStartSeamGen.xml trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/GettingStartedWithRHDS.xml trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/ManageJBossAS.xml trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/RADdevelopmentOfSimpleJSFapplication.xml trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/testNG.xml Log: http://jira.jboss.com/jira/browse/RHDS-150 GSG. Meaningful words in figures titles start with uppercase letter, created highlighting for paths and phrases. Modified: trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/DevelopAsimpleJSPWebApplication.xml =================================================================== --- trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/DevelopAsimpleJSPWebApplication.xml 2007-10-30 12:25:59 UTC (rev 4576) +++ trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/DevelopAsimpleJSPWebApplication.xml 2007-10-30 13:48:08 UTC (rev 4577) @@ -11,17 +11,16 @@ <title>Developing a simple JSP web application</title> <para>In this chapter you'll find out how to create a simple JSP application using the Red Hat Developer Studio. The application will show a classic &quot;Hello World!&quot; on the page.</para> <para>We&apos;ll assume that you have already launched Red Hat Developer Studio and -also that the Red Hat perspective is the current perspective. (If not, make it active by selecting <emphasis><property>Window/Open Perspective/Red Hat Developer Studio</property></emphasis> from the menu bar or by selecting <emphasis><property>Window/ -Open Perspective/Other...</property></emphasis> from the menu bar and then selecting Red Hat Developer Studio from +also that the Web Development perspective is the current perspective. (If not, make it active by selecting <emphasis><property>Window &gt; Open Perspective &gt; Web Development</property></emphasis> from the menu bar or by selecting <emphasis><property>Window &gt; Open Perspective &gt; Other...</property></emphasis> from the menu bar and then selecting Web Development from the Select Perspective dialog box.)</para> <section id="SettingUpTheProject"> <?dbhtml filename="SettingUpTheProject.html"?> <title>Setting Up the Project</title> <para>At first a new project for the application will be created.</para> <itemizedlist> - <listitem><para>Go to the menu bar and select <emphasis><property>File/New/Project...</property></emphasis></para></listitem> - <listitem><para>Select <emphasis><property>Web/Dynamic Web Project</property></emphasis> in the New Project dialog box</para></listitem> - <listitem><para>Click Next &gt;</para></listitem> + <listitem><para>Go to the menu bar and select <emphasis><property>File &gt; New &gt; Project...</property></emphasis></para></listitem> + <listitem><para>Select <emphasis><property>Web &gt; Dynamic Web Project</property></emphasis> in the New Project dialog box</para></listitem> + <listitem><para>Click <emphasis><property>Next</property></emphasis> </para></listitem> <listitem><para>Enter &quot;jspHello&quot; as a project name</para></listitem> <listitem><para>Leave everything else as is, and click <emphasis><property>Finish</property></emphasis></para></listitem> </itemizedlist> @@ -49,12 +48,12 @@ <title>Creating JSP Page</title> <para>In our simple application we need to create only one JSP page which displays a &quot;Hello World!&quot; message.</para> <itemizedlist continuation="continues"> -<listitem><para>Right click <emphasis>WebContent &gt; New &gt; JSP.</emphasis></para></listitem> +<listitem><para>Right click <emphasis><property>WebContent &gt; New &gt; JSP</property></emphasis>.</para></listitem> <listitem><para>Type &quot;hello.jsp&quot; for a file name and click the <emphasis><property>Next</property></emphasis> button.</para></listitem> </itemizedlist> <para>In the next window you can choose a template for your jsp page and see its preview.</para> <itemizedlist continuation="continues"> -<listitem><para>Select &quot;New JSP File (xhtml)&quot; template and click <emphasis><property>Finish</property></emphasis> button.</para></listitem> +<listitem><para>Select <emphasis><property>New JSP File (xhtml)</property></emphasis> template and click <emphasis><property>Finish</property></emphasis> button.</para></listitem> </itemizedlist> <figure> <title>Create JSP Page</title> @@ -78,7 +77,7 @@ <para>Notice that content assist functionality is always available when you are typing:</para> <figure> - <title>Content Assist in JSP page</title> + <title>Content Assist in JSP Page</title> <mediaobject> <imageobject> <imagedata fileref="images/DevelopSimpleJSP/newproject4.png"/> @@ -87,7 +86,7 @@ </figure> <para>After changes made your hello.jsp page should look like this:</para> <figure> - <title>Hello.jsp page</title> + <title>Hello.jsp Page</title> <mediaobject> <imageobject> <imagedata fileref="images/DevelopSimpleJSP/newproject5.png"/> @@ -101,7 +100,7 @@ <title>web.xml file</title> <para>When you are creating web project the wizard creates the web.xml for you automatically. The web.xml file editor provided by Red Hat Developer Studio is available in two modes: design and source.</para> <figure> - <title>web.xml in design mode</title> + <title>Web.xml in Design Mode</title> <mediaobject> <imageobject> <imagedata fileref="images/DevelopSimpleJSP/webxmldesign.png"/> @@ -109,7 +108,7 @@ </mediaobject> </figure> <figure> - <title>web.xml in source mode</title> + <title>Web.xml in Source Mode</title> <mediaobject> <imageobject> <imagedata fileref="images/DevelopSimpleJSP/webxmlsource.png"/> @@ -118,7 +117,7 @@ </figure> <para>Both modes are fully synchronized. Let&apos;s add mapping to our hello.jsp page in web.xml file.</para> <itemizedlist> - <listitem><para>Switch to source mode.</para></listitem> + <listitem><para>Switch to <property>source</property> mode.</para></listitem> <listitem><para>Add the next code into <emphasis role="bold"><property>&lt;welcome-file-list&gt;</property></emphasis>:</para></listitem> </itemizedlist> <programlisting role="XML"><![CDATA[<welcome-file>hello.jsp</welcome-file> @@ -136,9 +135,9 @@ <section id="WarConfig"> <?dbhtml filename="WarConfig.html"?> <title>WAR Config</title> - <para>Project archives managing is available through <emphasis>Project archives</emphasis> view.</para> + <para>Project archives managing is available through <property>Project archives</property> view.</para> <itemizedlist> - <listitem><para>Select <emphasis>Window &gt; Show view &gt; Other &gt; JBoss Tools &gt; Project archives</emphasis> from menu bar</para></listitem> + <listitem><para>Select <emphasis><property>Window &gt; Show view &gt; Other &gt; JBoss Tools &gt; Project archives</property></emphasis> from menu bar</para></listitem> <listitem><para>Select a project in Package Explorer you want to be archived</para></listitem> </itemizedlist> <para>In Project Archives you will see available archive types for the project:</para> @@ -155,7 +154,7 @@ </itemizedlist> <para>In the dialog New WAR you can see automatically selected default values</para> <figure> - <title>New WAR archive</title> + <title>New WAR Archive</title> <mediaobject> <imageobject> <imagedata fileref="images/DevelopSimpleJSP/simplejspwebapplication2.png"/> @@ -163,7 +162,7 @@ </mediaobject> </figure> <itemizedlist> - <listitem><para>Click Next to see a stub archive configuration for your project: + <listitem><para>Click <emphasis><property>Next</property></emphasis> to see a stub archive configuration for your project: <figure> <title>Stub Archive Configuration</title> <mediaobject> @@ -173,9 +172,9 @@ </mediaobject> </figure> </para></listitem> - <listitem><para>Click Finish. The <emphasis>.war</emphasis> file will appear in Package Explorer and in Project archives view as structure tree: + <listitem><para>Click <emphasis><property>Finish</property></emphasis>. The <emphasis>.war</emphasis> file will appear in Package Explorer and in Project archives view as structure tree: <figure> - <title>Archive is created</title> + <title>Archive is Created</title> <mediaobject> <imageobject> <imagedata fileref="images/DevelopSimpleJSP/simplejspwebapplication4.png"/> @@ -183,7 +182,7 @@ </mediaobject> </figure> <figure> - <title>Archive in Project archives view</title> + <title>Archive in Project Archives View</title> <mediaobject> <imageobject> <imagedata fileref="images/DevelopSimpleJSP/simplejspwebapplication5.png"/> @@ -194,7 +193,7 @@ </itemizedlist> <para>Via Project archives view you could now edit your archive, add new folders, publish to server, and so on:</para> <figure> - <title>Configure archive</title> + <title>Configure Archive</title> <mediaobject> <imageobject> <imagedata fileref="images/DevelopSimpleJSP/simplejspwebapplication6.png"/> @@ -220,7 +219,7 @@ <programlisting role="XML"><![CDATA[<%= new java.util.Date() %> ]]></programlisting> <itemizedlist> - <listitem><para>Click Save button.</para></listitem> + <listitem><para>Click <emphasis><property>Save</property></emphasis> button.</para></listitem> <listitem><para>Switch to Preview page by clicking Preview tab at the bottom of the page. You will see how the page will look at runtime.</para></listitem> </itemizedlist> <figure> @@ -240,7 +239,7 @@ <listitem><para>Start JBoss server from JBoss Server view by clicking the Start icon.</para></listitem> </itemizedlist> <figure> - <title>Starting server</title> + <title>Starting Server</title> <mediaobject> <imageobject> <imagedata fileref="images/DevelopSimpleJSP/startingfromicon.png"/> @@ -248,10 +247,10 @@ </mediaobject> </figure> <itemizedlist continuation="continues"> -<listitem><para>Click the Run icon or right click your project folder and select <emphasis>Run on Server</emphasis>. If you haven&apos;t made any changes in web.xml file or cleared it out you can launch the application by right clicking the hello.jsp page and selecting <emphasis>Run on the Server</emphasis>.</para></listitem> +<listitem><para>Click the Run icon or right click your project folder and select <emphasis><property>Run on Server</property></emphasis>. If you haven&apos;t made any changes in web.xml file or cleared it out you can launch the application by right clicking the hello.jsp page and selecting <emphasis><property>Run on the Server</property></emphasis>.</para></listitem> </itemizedlist> <figure> - <title>Run project</title> + <title>Run Project</title> <mediaobject> <imageobject> <imagedata fileref="images/DevelopSimpleJSP/newproject19.png"/> @@ -260,7 +259,7 @@ </figure> <para>You should see the next page in a browser :</para> <figure> - <title>Running project</title> + <title>Running Project</title> <mediaobject> <imageobject> <imagedata fileref="images/DevelopSimpleJSP/newprojectjsp20.png"/> Modified: trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/GetStartSeamGen.xml =================================================================== --- trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/GetStartSeamGen.xml 2007-10-30 12:25:59 UTC (rev 4576) +++ trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/GetStartSeamGen.xml 2007-10-30 13:48:08 UTC (rev 4577) @@ -13,17 +13,17 @@ <para>The Red Hat Developer Studio provides sophisticated tools for enterprise applications. With the Red Hat Developer Studio, you can get started very quickly with a web prototype, and then scale up your application to include enterprise features (e.g., business processes, web services, etc.) using the same developer tools. It is a &quot;scalable&quot; RAD (Rapid Application Development) tool.</para> - <para>A core element that makes the Red Hat Developer Studio &quot;scalable&quot; is the JBoss <property>Seam</property> framework. <property>Seam</property> is a fully featured application framework on top of Java EE 5. It is also one of the most popular enterprise Java framework today. <property>Seam</property> deeply integrates many other standard-based or open source frameworks (e.g., JSF, EJB3, JMS, Web Services, jBPM, JBoss Rules, Ajax4jsf, RichFaces, Facelets, Spring, iText, Quartz, TestNG, etc.), and provides a single programming model for developers to &quot;drive&quot; those underlying frameworks via simple annotated POJOs (Plain Old Java Objects). It makes life easier for developers to tackle complex enterprise applications with many component frameworks.</para> + <para>A core element that makes the Red Hat Developer Studio &quot;scalable&quot; is the JBoss <property>Seam framework</property>. Seam is a fully featured application framework on top of Java EE 5. It is also one of the most popular enterprise Java framework today. Seam deeply integrates many other standard-based or open source frameworks (e.g., JSF, EJB3, JMS, Web Services, jBPM, JBoss Rules, Ajax4jsf, RichFaces, Facelets, Spring, iText, Quartz, TestNG, etc.), and provides a single programming model for developers to &quot;drive&quot; those underlying frameworks via simple annotated POJOs (Plain Old Java Objects). It makes life easier for developers to tackle complex enterprise applications with many component frameworks.</para> - <para>In this chapter, we will cover how to build a simple <property>Seam</property> web application in minutes with the Red Hat Developer Studio.</para> + <para>In this chapter, we will cover how to build a simple Seam web application in minutes with the Red Hat Developer Studio.</para> <section> <title>Create a Seam Project</title> - <para>To create a new web application in <property>Seam</property>, select <emphasis>New &gt; Project ... &gt; Seam &gt; Seam Web Project</emphasis>. You will be prompted to enter a name and a location directory for your new project. You will also be asked to choose a JBoss AS server to deploy the project. You must choose the JBoss AS 4.2.0 instance we had defined in the JBoss AS Server manager view.</para> + <para>To create a new web application in <property>Seam</property>, select <emphasis><property>New &gt; Project ... &gt; Seam &gt; Seam Web Project</property></emphasis>. You will be prompted to enter a name and a location directory for your new project. You will also be asked to choose a JBoss AS server to deploy the project. You must choose the JBoss AS 4.2.0 instance we had defined in the JBoss AS Server manager view.</para> <figure> - <title>Create a Seam project</title> + <title>Create a Seam Project</title> <mediaobject> <imageobject> <imagedata fileref="images/WriteYourFirst/SeamNewProj01.png"/> @@ -31,10 +31,10 @@ </mediaobject> </figure> - <para>Next, you will be asked to select the &quot;features&quot; you want to use in your project. This allows Red Hat Developer Studio to setup the appropriate tooling for your project. Since JBoss <property>Seam</property> integrates all popular Java EE frameworks, you can select any combination of technologies from the list. Here, for this project, we will select Dynamic Web Module, Java, Java Persistence (JPA), JavaServer Faces (JSF), and <property>Seam</property> Facet for a typical database-driven web application.</para> + <para>Next, you will be asked to select the &quot;features&quot; you want to use in your project. This allows Red Hat Developer Studio to setup the appropriate tooling for your project. Since JBoss Seam integrates all popular Java EE frameworks, you can select any combination of technologies from the list. Here, for this project, we will select Dynamic Web Module, Java, Java Persistence (JPA), JavaServer Faces (JSF), and Seam Facet for a typical database-driven web application.</para> <figure> - <title>Select toolings for the project</title> + <title>Select Toolings for the Project</title> <mediaobject> <imageobject> <imagedata fileref="images/WriteYourFirst/SeamNewProj02.png"/> @@ -45,7 +45,7 @@ <para>A dynamic web application contains both web pages and Java code. The wizard will ask you where you want to put those files. You can just leave the default values.</para> <figure> - <title>Select directory names for web pages and Java files</title> + <title>Select Directory Names for Web Pages and Java Files</title> <mediaobject> <imageobject> <imagedata fileref="images/WriteYourFirst/SeamNewProj03.png"/> @@ -57,10 +57,10 @@ <para>We will use a default connection provided by RHDS.</para> <orderedlist> - <listitem><para>Click Next in the dialog &quot;JPA Facet&quot;</para></listitem> + <listitem><para>Click <emphasis><property>Next</property></emphasis> in the dialog <property>JPA Facet</property></para></listitem> </orderedlist> <figure> - <title>Select provider for JPA JARs</title> + <title>Select Provider for JPA JARs</title> <mediaobject> <imageobject> <imagedata fileref="images/WriteYourFirst/SeamNewProj04.png"/> @@ -69,8 +69,8 @@ </figure> <para>Since you selected JPA and JSF tooling support, the project needs to incorporate the JAR files for those frameworks on its classpath. In the next screen, you will be able to select where those library JARs come from. The easiest is just to select the JARs provided by the JBoss AS runtime associated with this project. That is why it is important to chose the right JBoss AS 4.2 runtime in the project setup window.</para> <orderedlist continuation="continues"> - <listitem><para>Check &quot;Server Supplied JSF Implementation&quot;. We will use JSF implementation that comes with JBoss server</para></listitem> - <listitem><para>Click Next</para></listitem> + <listitem><para>Check <emphasis><property>Server Supplied JSF Implementation</property></emphasis>. We will use JSF implementation that comes with JBoss server</para></listitem> + <listitem><para>Click <emphasis><property>Next</property></emphasis></para></listitem> </orderedlist> <figure> <title>Define JSF Implementation</title> @@ -83,7 +83,7 @@ <para>We will also use a default Hibernate Dialect - <emphasis>org.hibernate.dialect.HSQLDialect</emphasis> and deploy as a <emphasis>war</emphasis> archive.</para> - <para>The project setup wizard also asks you to configure how <property>Seam</property> generates code for the project. The <property>Seam</property> Home Folder should point to a valid <property>Seam</property> distribution. By default, it is set to the <property>Seam</property> distribution bundled in your Red Hat Developer Studio tool. If you need another one choose it from the drop down list box:</para> + <para>The project setup wizard also asks you to configure how Seam generates code for the project. The Seam Home Folder should point to a valid Seam distribution. By default, it is set to the Seam distribution bundled in your Red Hat Developer Studio tool. If you need another one choose it from the drop down list box:</para> <figure> <title>Enter Java Packages for Generated Code</title> @@ -93,7 +93,7 @@ </imageobject> </mediaobject> </figure> -<para>If in this list there is no Seam runtime you want to use add it through <emphasis>Window &gt; Preferences &gt; JBoss Tools &gt; Web &gt; Seam</emphasis> or just click <emphasis>Add</emphasis> button near the Seam Runtime list:</para> +<para>If in this list there is no Seam runtime you want to use add it through <emphasis><property>Window &gt; Preferences &gt; JBoss Tools &gt; Web &gt; Seam</property></emphasis> or just click <emphasis><property>Add</property></emphasis> button near the Seam Runtime list:</para> <figure> <title>Add New Seam Runtime</title> <mediaobject> @@ -105,7 +105,7 @@ <para>For the deployment format, choose WAR deployment if you want to use POJOs for UI event handling and business logic; choose EAR deployment if you want to EJB3 beans for added features. In most web applications, the WAR deployment option would suffice. You should also enter Java packages for the entity beans (for database mapping) and session beans (for action handlers). All generated code will be placed in those packages. </para> - <para>Click on Finish to generate a project. The generated project contains all the necessary library JARs, XML configuration files, the ANT build script, as well as simple XHTML web pages and Java classes for the skeleton web application.</para> + <para>Click on <emphasis><property>Finish</property></emphasis> to generate a project. The generated project contains all the necessary library JARs, XML configuration files, the ANT build script, as well as simple XHTML web pages and Java classes for the skeleton web application.</para> </section> @@ -116,7 +116,7 @@ <para>Once the application is generated, you can use the &quot;Run on server&quot; menu to build and deploy it into the JBoss AS runtime associated with the project. All you need is to start JBoss AS in the server manager, and load the browser at URL http://localhost:8080/MySeamProj/. You should see the following web page.</para> <figure> - <title>The generated application in action</title> + <title>The Generated Application in Action</title> <mediaobject> <imageobject> <imagedata fileref="images/WriteYourFirst/startedapplication.png"/> @@ -127,7 +127,7 @@ <para>To make simple changes to the page, you just need to double click on the <emphasis><property>WebContent/home.xhtml file</property></emphasis> and edit it in the visual editor. Notice that the visual editor lets you both the XHTML code and the rendered page. The rendered view is designed to make it easy to find stuff in a complex XHTML page.</para> <figure> - <title>Making changes in the visual editor</title> + <title>Making Changes in the Visual Editor</title> <mediaobject> <imageobject> <imagedata fileref="images/WriteYourFirst/SeamJsfEditor.png"/> @@ -135,10 +135,10 @@ </mediaobject> </figure> - <para>Once you finished editing, save the file (<emphasis>File &gt; Save</emphasis>), re-deploy the application, and reload the browser to see the changes.</para> + <para>Once you finished editing, save the file (<emphasis><property>File &gt; Save</property></emphasis>), re-deploy the application, and reload the browser to see the changes.</para> <figure> - <title>The front page is changed</title> + <title>The Front Page is Changed</title> <mediaobject> <imageobject> <imagedata fileref="images/WriteYourFirst/xxxx.png"/> @@ -155,10 +155,10 @@ <section> <title>Add a Web Page and an Action</title> - <para>To add a new page and related UI action to the project, use the <emphasis>New &gt; Other ... &gt; Seam &gt; Seam Form</emphasis> wizard. You are prompted to enter the name of the web page, the name for the <property>Seam</property> component that handles UI actions from the page, and UI action method name.</para> + <para>To add a new page and related UI action to the project, use the <emphasis><property>New &gt; Other ... &gt; Seam &gt; Seam Form</property></emphasis> wizard. You are prompted to enter the name of the web page, the name for the Seam component that handles UI actions from the page, and UI action method name.</para> <figure> - <title>New form for the application</title> + <title>New Form for the Application</title> <mediaobject> <imageobject> <imagedata fileref="images/WriteYourFirst/newseamproj22.png"/> @@ -210,14 +210,14 @@ </ui:composition> ]]></programlisting> <figure> - <title>Generated form</title> + <title>Generated Form</title> <mediaobject> <imageobject> <imagedata fileref="images/WriteYourFirst/newseamproj23.png"/> </imageobject> </mediaobject> </figure> - <para>The <emphasis>#{simpleAction.value}</emphasis> notation on the web page maps to the &quot;value&quot; property in the backend component named &quot;simpleAction&quot;, and the <emphasis>#{simpleAction.hello}</emphasis> notation indicates that the <emphasis><property>hello()</property></emphasis> method is called when the button is clicked on. Here is the &quot;simpleAction&quot; named backend <property>Seam</property> component generated by the wizard.</para> + <para>The <emphasis>#{simpleAction.value}</emphasis> notation on the web page maps to the &quot;value&quot; property in the backend component named &quot;simpleAction&quot;, and the <emphasis>#{simpleAction.hello}</emphasis> notation indicates that the <emphasis><property>hello()</property></emphasis> method is called when the button is clicked on. Here is the &quot;simpleAction&quot; named backend Seam component generated by the wizard.</para> <programlisting role="JAVA"><![CDATA[ @Name("simpleAction") @@ -265,7 +265,7 @@ <para>Notice that in the generated SimpleAction class, there is a <emphasis>@Length</emphasis> annotation to validate the input when the input string is bound to <emphasis>#{simpleAction.value}</emphasis>. To see how this works, enter a text string longer than 10 chars and click on the button. This is what you should see.</para> <figure> - <title>The input validation in action</title> + <title>The Input Validation in Action</title> <mediaobject> <imageobject> <imagedata fileref="images/WriteYourFirst/xxxx.png"/> @@ -273,7 +273,7 @@ </mediaobject> </figure> - <para><property>Seam</property> supports many different input validation annotations. To see an example, you can replace the <emphasis>@Length(max=10)</emphasis> annotation with the following. It would require the input string to have a first name and last name separated by a space. If the validation fails, the web page would print the customized error message.</para> + <para>Seam supports many different input validation annotations. To see an example, you can replace the <emphasis>@Length(max=10)</emphasis> annotation with the following. It would require the input string to have a first name and last name separated by a space. If the validation fails, the web page would print the customized error message.</para> <programlisting role="JAVA"><![CDATA[ @NotNull @@ -288,7 +288,7 @@ <para>Save the Java file, deploy the application, and reload the browser to see the new validation scheme in action.</para> <figure> - <title>More input validation</title> + <title>More Input Validation</title> <mediaobject> <imageobject> <imagedata fileref="images/WriteYourFirst/xxxx.png"/> @@ -337,7 +337,7 @@ <para>Deploy the application and see it in action now.</para> <figure> - <title>Add UI components and business logic</title> + <title>Add UI Components and Business Logic</title> <mediaobject> <imageobject> <imagedata fileref="images/WriteYourFirst/xxxx.png"/> @@ -350,7 +350,7 @@ <section> <title>Add Security to the Application</title> - <para>You have probably noticed that the web page template has a login link at the top of the page. You can use the <property>Seam</property> security framework to secure access to any web page or web action. You can implement the login logic in the <emphasis>checkLoggedIn</emphasis> method. In the following example, we just use hardcoded username and password. But you can easily change it to use database, LDAP or any other means.</para> + <para>You have probably noticed that the web page template has a login link at the top of the page. You can use the Seam security framework to secure access to any web page or web action. You can implement the login logic in the <emphasis>checkLoggedIn</emphasis> method. In the following example, we just use hardcoded username and password. But you can easily change it to use database, LDAP or any other means.</para> <programlisting role="JAVA"><![CDATA[ ]]></programlisting> @@ -378,7 +378,7 @@ <para>Now, re-deploy the application and try the action button. The application redirects to the <emphasis>login</emphasis> page asking for login credentials. The method is invoked after you successfully logged in.</para> <figure> - <title>Access control for action methods</title> + <title>Access Control for Action Methods</title> <mediaobject> <imageobject> <imagedata fileref="images/WriteYourFirst/xxxx.png"/> Modified: trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/GettingStartedWithRHDS.xml =================================================================== --- trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/GettingStartedWithRHDS.xml 2007-10-30 12:25:59 UTC (rev 4576) +++ trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/GettingStartedWithRHDS.xml 2007-10-30 13:48:08 UTC (rev 4577) @@ -155,7 +155,7 @@ <para></para> <figure> - <title>JBoss Enterprise Application Platform installing</title> + <title>JBoss Enterprise Application Platform Installing</title> <imageobject> <imagedata fileref="images/GetStartRHDS/install2.png"/> </imageobject> @@ -174,7 +174,7 @@ <para></para> <figure> - <title>Summary information</title> + <title>Summary Information</title> <imageobject> <imagedata fileref="images/GetStartRHDS/install4.png"/> </imageobject> Modified: trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/ManageJBossAS.xml =================================================================== --- trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/ManageJBossAS.xml 2007-10-30 12:25:59 UTC (rev 4576) +++ trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/ManageJBossAS.xml 2007-10-30 13:48:08 UTC (rev 4577) @@ -53,7 +53,7 @@ </figure> <para>When the server is started you should see <emphasis><property>Started</property></emphasis> right to its name in <property>JBoss Server View</property> (column &quot;Status&quot;).</para> <figure> -<title>Server Is Started</title> +<title>Server is Started</title> <mediaobject> <imageobject> <imagedata fileref="images/ManageJBossAS/serverstarted.png"/> @@ -87,7 +87,7 @@ <section id="ServerPreferences"> <?dbhtml filename="ServerPreferences.html"?> <title>Server Container Preferences</title> - <para>You can control how Red Hat Developer Studio interacts with servlet containers in Preferences. Select <emphasis><property>Window > Preferences > JBoss Tools > JBoss Servers</property></emphasis> and switch to the desired server:</para> + <para>You can control how Red Hat Developer Studio interacts with servlet containers in Preferences. Select <emphasis><property>Window &gt; Preferences &gt; JBoss Tools &gt; JBoss Servers</property></emphasis> and switch to the desired server:</para> <figure> <title>Server Preferences</title> <mediaobject> @@ -136,9 +136,9 @@ <title>Adding and configuring JBoss server</title> <para>Now we should add just installed server into server manager in Red Hat Developer Studio.</para> <itemizedlist> - <listitem><para>Open the JBoss Server View by selecting <emphasis><property>Window > Show View > Other > Server > JBoss Server View</property></emphasis>. You will see JBoss Server view.</para></listitem> + <listitem><para>Open the JBoss Server View by selecting <emphasis><property>Window &gt; Show View &gt; Other &gt; Server &gt; JBoss Server View</property></emphasis>. You will see JBoss Server view.</para></listitem> <listitem><para>Right click anywhere in this view and select <emphasis><property>New Server</property></emphasis>.</para></listitem> - <listitem><para>Select <emphasis><property>JBoss, a division of Red Hat > JBoss v4.2</property></emphasis> and click the <emphasis><property>Installed Runtimes</property></emphasis> button to select a new installed runtime.</para></listitem> + <listitem><para>Select <emphasis><property>JBoss, a division of Red Hat &gt; JBoss v4.2</property></emphasis> and click the <emphasis><property>Installed Runtimes</property></emphasis> button to select a new installed runtime.</para></listitem> </itemizedlist> <figure> <title>Selecting Server Type</title> @@ -151,7 +151,7 @@ <itemizedlist continuation="continues"> <listitem><para>Click <emphasis><property>Add</property></emphasis> button to add a new jboss runtime.</para></listitem> - <listitem><para>Select <emphasis><property>JBoss, a division of Red Hat > JBoss v4.2</property></emphasis> and press <emphasis><property>Next</property></emphasis>.</para></listitem> + <listitem><para>Select <emphasis><property>JBoss, a division of Red Hat &gt; JBoss v4.2</property></emphasis> and press <emphasis><property>Next</property></emphasis>.</para></listitem> </itemizedlist> <figure> @@ -191,9 +191,9 @@ </imageobject> </mediaobject> </figure> - <para>A new runtime will now appear in the <emphasis><property>Preferences > Server > Installed Runtimes</property></emphasis> dialog.</para> + <para>A new runtime will now appear in the <emphasis><property>Preferences &gt; Server &gt; Installed Runtimes</property></emphasis> dialog.</para> <figure> -<title>Runtime Is Added</title> +<title>Runtime is Added</title> <mediaobject> <imageobject> <imagedata fileref="images/ManageJBossAS/addedruntime.png"/> @@ -275,7 +275,7 @@ </figure> - <para>In order to access the view's preferences, you should access <emphasis><property>Window > Preferences > JBoss Tools > JBoss Servers > View</property></emphasis>. + <para>In order to access the view's preferences, you should access <emphasis><property>Window &gt; Preferences &gt; JBoss Tools &gt; JBoss Servers &gt; View</property></emphasis>. This preference page allows you to select which view extensions you want on or off, the order they appear in the view, as well as any other extension-specific preferences that may be available.</para> <figure> @@ -460,7 +460,7 @@ <section id="PublishToServer"> <title>Publish to Server</title> <figure> - <title>Context menu on the item</title> + <title>Context Menu on the Item</title> <mediaobject> <imageobject> <imagedata fileref="images/ManageJBossAS/archives4.png"/> Modified: trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/RADdevelopmentOfSimpleJSFapplication.xml =================================================================== --- trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/RADdevelopmentOfSimpleJSFapplication.xml 2007-10-30 12:25:59 UTC (rev 4576) +++ trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/RADdevelopmentOfSimpleJSFapplication.xml 2007-10-30 13:48:08 UTC (rev 4577) @@ -19,7 +19,7 @@ <title>Setting up the project</title> <para>We will create a JSF 1.2 project using an integrated RHDS&apos;s new project wizard and predefined templates.</para> <itemizedlist> -<listitem><para>In Web Projects View (if it is not open select <emphasis>Window &gt; Show View &gt; Others &gt; Red Hat Developer Studio &gt; Web Projects View</emphasis>) click &quot;Create New JSF Project&quot; button. + <listitem><para>In Web Projects View (if it is not open select <emphasis><property>Window &gt; Show View &gt; Others &gt; JBoss Tools Web &gt; Web Projects View</property></emphasis>) click <emphasis><property>Create New JSF Project</property></emphasis> button. <figure> <title>Create New JSF Project</title> <mediaobject> @@ -29,8 +29,8 @@ </mediaobject> </figure></para></listitem> -<listitem><para>Put &quot;GuessNumber&quot; as a project name, in &quot;JSF Environment&quot; drop down list choose JSF 1.2.</para></listitem> -<listitem><para>Leave everything else as it is and click Finish</para></listitem> +<listitem><para>Put <property>GuessNumber</property> as a project name, in JSF Environment drop down list choose <property>JSF 1.2.</property></para></listitem> +<listitem><para>Leave everything else as it is and click <emphasis><property>Finish</property></emphasis></para></listitem> </itemizedlist> <para>Our project will appear in Project Explorer and Web Projects Views. As you can see Red Had Developer Studio has created for us the whole skeleton for the project with all needed libraries, faces-config.xml and web.xml files.</para> <figure> @@ -50,9 +50,9 @@ <para>On the first page inputnumber.jsp you will enter a number.</para> <itemizedlist> -<listitem><para>Open faces-config.xml file</para></listitem> + <listitem><para>Open <emphasis><property>faces-config.xml</property></emphasis> file</para></listitem> <listitem><para>Right click anywhere on the diagram mode</para></listitem> -<listitem><para>From the context menu select <emphasis>New View</emphasis></para></listitem> +<listitem><para>From the context menu select <emphasis><property>New View</property></emphasis></para></listitem> </itemizedlist> <figure> <title>Create New View</title> @@ -64,10 +64,10 @@ </figure> <itemizedlist> -<listitem><para>Type <emphasis>pages/inputname</emphasis> as the value for &quot;From-view-id&quot;</para></listitem> -<listitem><para>Leave everything else as is and click Finish</para></listitem> -<listitem><para>In the same way create another jsf view. Type &quot;pages/success&quot; as the value for &quot;From-view-id&quot;</para></listitem> -<listitem><para>Select <emphasis>File &gt; Save</emphasis></para></listitem> + <listitem><para>Type <emphasis><property>pages/inputnumber</property></emphasis> as the value for <emphasis><property>From-view-id</property></emphasis></para></listitem> + <listitem><para>Leave everything else as is and click <emphasis><property>Finish</property></emphasis></para></listitem> + <listitem><para>In the same way create another jsf view. Type <emphasis><property>pages/success</property></emphasis> as the value for <emphasis><property>From-view-id</property></emphasis></para></listitem> +<listitem><para>Select <emphasis><property>File &gt; Save</property></emphasis></para></listitem> </itemizedlist> <para>On the diagram you will see two created views.</para> <figure> @@ -85,9 +85,9 @@ <title>Creating Transition between two views</title> <para>We should now create connection between jsp pages.</para> <itemizedlist> -<listitem><para>In the diagram, select the connection icon third from the top along the upper left side of the diagram to get an arrow cursor with a two-pronged plug at the arrow&apos;s bottom + <listitem><para>In the diagram, select the <emphasis><property>Create New Connection</property></emphasis> icon third from the top along the upper left side of the diagram to get an arrow cursor with a two-pronged plug at the arrow&apos;s bottom <figure> -<title>Create connection</title> +<title>Create Connection</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/newrad5.png"/> @@ -95,11 +95,11 @@ </mediaobject> </figure> </para></listitem> -<listitem><para>Click on the <emphasis>pages/inputname</emphasis> page icon and then click on the <emphasis>pages/greeting</emphasis> page icon</para></listitem> +<listitem><para>Click on the <emphasis><property>pages/inputnumber</property></emphasis> page icon and then click on the <emphasis><property>pages/success</property></emphasis> page icon</para></listitem> </itemizedlist> <para>A transition should appear between the two icons of views.</para> <figure> -<title>Created connection</title> +<title>Created Connection</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/newrad6.png"/> @@ -107,7 +107,7 @@ </mediaobject> </figure> <itemizedlist> -<listitem><para>Select <emphasis>File/Save</emphasis> from the menu bar</para></listitem> +<listitem><para>Select <emphasis><property>File &gt; Save</property></emphasis> from the menu bar</para></listitem> </itemizedlist> </section> <section id="CreatingResourceFile"> @@ -115,19 +115,19 @@ <title>Creating Resource File</title> <para>Red Hat Developer Studio allows to create quickly a resource file. Using this feature you can collect text messages in one central place. A resource file is just a file with a <emphasis>.properties</emphasis> extension. The messages stored in resource file can be displayed to you on a Web page during application execution. </para> <para>With resource file first, you don&apos;t hard code anything into the JSP pages. And second, it makes it easier to translate your application to other languages. All you have to do is to translate all your messages to the other language and save them in a new properties file with a name that ends with the appropriate ISO-639 language code.</para> -<para>It is a good idea to keep your resources inside the <emphasis>JavaSource</emphasis> folder, where you keep your .java files. Every time you build the project, all <emphasis>.properties</emphasis> files will then be copied to the <emphasis>classes</emphasis> folder by default.</para> +<para>It is a good idea to keep your resources inside the <emphasis><property>JavaSource</property></emphasis> folder, where you keep your .java files. Every time you build the project, all <emphasis>.properties</emphasis> files will then be copied to the <emphasis>classes</emphasis> folder by default.</para> <itemizedlist> -<listitem><para>Right click <emphasis>JavaSource</emphasis> folder and select <emphasis>New &gt; Folder</emphasis></para></listitem> -<listitem><para>Type &quot;game&quot; for Folder name and click <emphasis><property>Finish</property></emphasis></para></listitem> +<listitem><para>Right click <emphasis><property>JavaSource</property></emphasis> folder and select <emphasis><property>New &gt; Folder</property></emphasis></para></listitem> + <listitem><para>Type <emphasis><property>game</property></emphasis> for Folder name and click <emphasis><property>Finish</property></emphasis></para></listitem> </itemizedlist> <para>We will store in this folder our resource file and java bean.</para> <itemizedlist> -<listitem><para>Right click game folder and select <emphasis>New &gt; Properties File</emphasis></para></listitem> -<listitem><para>Type <emphasis>messages</emphasis> as the value for <emphasis>name</emphasis> attribute and click <emphasis><property>Finish</property></emphasis></para></listitem> + <listitem><para>Right click on <emphasis><property>game folder</property></emphasis> and select <emphasis><property>New &gt; Properties File</property></emphasis></para></listitem> +<listitem><para>Type <emphasis><property>messages</property></emphasis> as the value for &quot;name&quot; attribute and click <emphasis><property>Finish</property></emphasis></para></listitem> </itemizedlist> -<para>Red Hat Developer Studio will automatically open messages.properties file for editing.</para> +<para>Red Hat Developer Studio will automatically open <property>messages.properties</property> file for editing.</para> <figure> -<title>messages.properties file</title> +<title>Messages.properties File</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/newrad62.png"/> @@ -135,7 +135,7 @@ </mediaobject> </figure> <itemizedlist> -<listitem><para>Click <emphasis>Add</emphasis> button</para></listitem> +<listitem><para>Click <emphasis><property>Add</property></emphasis> button</para></listitem> <listitem><para>Type <emphasis role="italic"><property>how_to_play</property></emphasis> for &quot;name&quot; and <emphasis role="italic"><property>Please pick a number between 0 and 100.</property></emphasis> for value</para></listitem> <listitem><para>Click <emphasis><property>Finish</property></emphasis></para></listitem> <listitem><para>In such a way add the next properties:</para></listitem> @@ -147,11 +147,11 @@ tryagain_bigger=Oops..incorrect guess. Please try a bigger number. ]]></programlisting> <itemizedlist> -<listitem><para>Click <emphasis>File &gt; Save</emphasis> from the menu bar</para></listitem> +<listitem><para>Click <emphasis><property>File &gt; Save</property></emphasis> from the menu bar</para></listitem> </itemizedlist> <para>Your .properties file should now look like follows:</para> <figure> -<title>Properties are added</title> +<title>Properties are Added</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/newrad63.png"/> @@ -165,9 +165,9 @@ <title>Creating Java Bean</title> <para>Now we create a Java bean that will hold business logic of our application.</para> <itemizedlist> -<listitem><para>Right click <emphasis>game</emphasis> folder</para></listitem> -<listitem><para>Select <emphasis>New &gt; Class</emphasis></para></listitem> -<listitem><para>Type <emphasis>NumberBean</emphasis> for bean name</para></listitem> +<listitem><para>Right click <emphasis><property>game folder</property></emphasis></para></listitem> +<listitem><para>Select <emphasis><property>New &gt; Class</property></emphasis></para></listitem> +<listitem><para>Type <emphasis><property>NumberBean</property></emphasis> for bean name</para></listitem> </itemizedlist> <para>A java bean is created.</para> <itemizedlist> @@ -177,9 +177,9 @@ ]]></programlisting> <para>Red Hat Studio allows to quickly generate getters and setters for java bean.</para> <itemizedlist> -<listitem><para>Right click NumberBean.java in Package Explorer</para></listitem> -<listitem><para>Select <emphasis>Source &gt; Generate Getters and Setters...</emphasis></para></listitem> -<listitem><para>Check <emphasis>userNumber</emphasis> box and click <emphasis><property>OK</property></emphasis> + <listitem><para>Right click <emphasis><property>NumberBean.java</property></emphasis> in Package Explorer</para></listitem> +<listitem><para>Select <emphasis><property>Source &gt; Generate Getters and Setters...</property></emphasis></para></listitem> +<listitem><para>Check <emphasis><property>userNumber</property></emphasis> box and click <emphasis><property>OK</property></emphasis> <figure> <title>Generate Getters and Setters</title> <mediaobject> @@ -353,15 +353,15 @@ <section id="EditingTheJSPViewFiles2"> <?dbhtml filename="EditingTheJSPViewFiles2.html"?> <title>Editing the JSP View Files</title> -<para>Now we will finish editing the JSP files for our two &quot;views&quot; using Red Hat&apos;s Visual Page +<para>Now we will finish editing the JSP files for our two &quot;views&quot; using Visual Page Editor.</para> <section id="EditingInputjsp"> <?dbhtml filename="EditingInputjsp.html"?> <title>Editing inputname.jsp page</title> <para>On this page we will have an output text component displaying a message, a text field for user&apos;s number entering and a button for input submission.</para> <itemizedlist> -<listitem><para>Open inputnumber.jsp by double-clicking on the <emphasis>/pages/inputnamber. -jsp</emphasis> icon</para></listitem> +<listitem><para>Open inputnumber.jsp by double-clicking on the <emphasis><property>/pages/inputnamber. +jsp</property></emphasis> icon</para></listitem> </itemizedlist> <para>The Visual Page Editor will open in a screen split between source code along the top and a WYSIWIG view along the bottom. You can see that some JSF code will be already generated as we choose a template when creating the page.</para> @@ -379,9 +379,9 @@ </mediaobject> </figure> </para></listitem> -<listitem><para>In the dialog Insert Tag select <emphasis>id</emphasis> and click on this line below the value header. A blinking cursor will appear in a input text field inviting to enter a value of id +<listitem><para>In the dialog Insert Tag select <emphasis><property>id</property></emphasis> and click on this line below the value header. A blinking cursor will appear in a input text field inviting to enter a value of id <figure> -<title>Define id of form</title> +<title>Define Id of Form</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/newrad8.png"/> @@ -389,11 +389,11 @@ </mediaobject> </figure> </para></listitem> -<listitem><para>Type &quot;inputNumbers&quot; and click <emphasis><property>Finish</property></emphasis></para></listitem> +<listitem><para>Type <emphasis><property>inputNumbers</property></emphasis> and click <emphasis><property>Finish</property></emphasis></para></listitem> </itemizedlist> <para>In source view you can see the declaration of a form.</para> <figure> -<title>Created form</title> +<title>Created Form</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/newrad9.png"/> @@ -408,7 +408,7 @@ ]]></programlisting> <para>As always Red Hat Studio provides code assist:</para> <figure> -<title>Code assist</title> +<title>Code Assist</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/newrad10.png"/> @@ -417,10 +417,10 @@ </figure> <itemizedlist> <listitem><para>Switch to Visual tab, so it could be possible to work with the editor completely in its WYSIWYG mode</para></listitem> -<listitem><para>Click on <emphasis>outputText</emphasis>, drag the cursor over to the editor, and drop it inside the blue box in the editor</para></listitem> +<listitem><para>Click on <emphasis><property>outputText</property></emphasis>, drag the cursor over to the editor, and drop it inside the blue box in the editor</para></listitem> -<listitem><para>Select <emphasis>value</emphasis> and click on this line below &quot;value&quot; header</para></listitem> -<listitem><para>Click <emphasis>...</emphasis> button next to the value field</para></listitem> +<listitem><para>Select <emphasis><property>value</property></emphasis> and click on this line below &quot;value&quot; header</para></listitem> +<listitem><para>Click <property>...</property> button next to the value field</para></listitem> </itemizedlist> <para>RHDS will nicely propose you to choose within available values:</para> <figure> @@ -432,8 +432,8 @@ </mediaobject> </figure> <itemizedlist> -<listitem><para>Expand <emphasis>Resource Bundles &gt; msg</emphasis></para></listitem> -<listitem><para>Select &quot;how_to_play&quot; value and click <emphasis><property>Ok</property></emphasis>. Then click <emphasis><property>Finish</property></emphasis> +<listitem><para>Expand <emphasis><property>Resource Bundles &gt; msg</property></emphasis></para></listitem> + <listitem><para>Select <emphasis><property>how_to_play</property></emphasis> value and click <emphasis><property>Ok</property></emphasis>. Then click <emphasis><property>Finish</property></emphasis> <figure> <title>Selecting Value</title> <mediaobject> @@ -446,7 +446,7 @@ </itemizedlist> <para>The text will appear on the page:</para> <figure> -<title>Created outputText component</title> +<title>Created OutputText Component</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/newrad13.png"/> @@ -456,23 +456,23 @@ <itemizedlist> <listitem><para>Switch to Source mode and insert <emphasis role="bold"><property>&lt;br/&gt;</property></emphasis> tag after <emphasis role="bold"><property>&lt;h:outputText&gt;</property></emphasis> component to make a new line.</para></listitem> <listitem><para>Click <emphasis><property>Save</property></emphasis> button.</para></listitem> -<listitem><para>On the Palette click on <emphasis>inputText</emphasis>, drag the cursor over to the editor, and drop it inside the editor after the text.</para></listitem> +<listitem><para>On the Palette click on <emphasis><property>inputText</property></emphasis>, drag the cursor over to the editor, and drop it inside the editor after the text.</para></listitem> <listitem><para>Switch to a Source mode and insert <emphasis role="bold"><property>&lt;br/&gt;</property></emphasis> tag after <emphasis role="bold"><property>&lt;h:outputText&gt;</property></emphasis> component to make a new line</para></listitem> <listitem><para>Click <emphasis><property>Save</property></emphasis> button</para></listitem> -<listitem><para>On the Palette click on <emphasis>inputText</emphasis>, drag the cursor over to the editor, and drop it inside the editor after the text</para></listitem> -<listitem><para>Select <emphasis>value</emphasis> and click on this line below &quot;value&quot; header</para></listitem> -<listitem><para>Click <emphasis>...</emphasis> button next to the value field</para></listitem> -<listitem><para>Expand <emphasis>Managed Beans &gt; NumberBean</emphasis></para></listitem> -<listitem><para>Select &quot;userNumber&quot; value and click Ok</para></listitem> -<listitem><para>Switch <emphasis>Advanced</emphasis> tab</para></listitem> -<listitem><para>Select <emphasis>id</emphasis> and click on this line below &quot;value&quot; header</para></listitem> -<listitem><para>Type &quot;userNumber&quot; in text field</para></listitem> -<listitem><para>Select <emphasis>required</emphasis> and click on this line below &quot;value&quot; header</para></listitem> -<listitem><para>Click <emphasis>...</emphasis> button next to the value field</para></listitem> -<listitem><para>Expand <emphasis>Enumeration</emphasis> and select <emphasis>true</emphasis> as a value</para></listitem> +<listitem><para>On the Palette click on <emphasis><property>inputText</property></emphasis>, drag the cursor over to the editor, and drop it inside the editor after the text</para></listitem> +<listitem><para>Select <emphasis><property>value</property></emphasis> and click on this line below &quot;value&quot; header</para></listitem> +<listitem><para>Click <property>...</property> button next to the value field</para></listitem> +<listitem><para>Expand <emphasis><property>Managed Beans &gt; NumberBean</property></emphasis></para></listitem> + <listitem><para>Select <emphasis><property>userNumber</property></emphasis> value and click <emphasis><property>Ok</property></emphasis></para></listitem> +<listitem><para>Switch <emphasis><property>Advanced</property></emphasis> tab</para></listitem> +<listitem><para>Select <emphasis><property>id</property></emphasis> and click on this line below &quot;value&quot; header</para></listitem> + <listitem><para>Type <emphasis><property>userNumber</property></emphasis> in text field</para></listitem> +<listitem><para>Select <emphasis><property>required</property></emphasis> and click on this line below &quot;value&quot; header</para></listitem> +<listitem><para>Click <property>...</property> button next to the value field</para></listitem> +<listitem><para>Expand <emphasis><property>Enumeration</property></emphasis> and select <emphasis><property>true</property></emphasis> as a value</para></listitem> </itemizedlist> <figure> -<title>Add &quot;required&quot; attribute</title> +<title>Add &quot;required&quot; Attribute</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/newrad14.png"/> @@ -489,15 +489,14 @@ ]]></programlisting> <itemizedlist> <listitem><para>Click <emphasis><property>Save</property></emphasis> button</para></listitem> -<listitem><para>Again select Visual mode</para></listitem> -<listitem><para>On the Palette, click on <emphasis>commandButton</emphasis>, drag the cursor over to the editor, and drop it inside the editor after the inputText component.</para></listitem> -<listitem><para>On the Palette click on <emphasis>commandButton</emphasis>, drag the cursor over to the editor, and drop it inside the editor after the inputText component</para></listitem> -<listitem><para>In the editing dialog select <emphasis>value</emphasis> and click on this line below &quot;value&quot; header</para></listitem> -<listitem><para>Click <emphasis>...</emphasis> button next to the value field</para></listitem> -<listitem><para>Expand <emphasis>Resource Bundles &gt; msg</emphasis> and select <emphasis>makeguess_button</emphasis> as a value</para></listitem> -<listitem><para>Click Ok</para></listitem> -<listitem><para>Select <emphasis>action</emphasis> and click on this line below &quot;value&quot; header</para></listitem> -<listitem><para>Type &quot;NumberBean.checkGuess&quot; in text field</para></listitem> + <listitem><para>Again select <emphasis><property>Visual</property></emphasis> mode</para></listitem> +<listitem><para>On the Palette, click on <emphasis><property>commandButton</property></emphasis>, drag the cursor over to the editor, and drop it inside the editor after the inputText component.</para></listitem> +<listitem><para>In the editing dialog select <emphasis><property>value</property></emphasis> and click on this line below &quot;value&quot; header</para></listitem> +<listitem><para>Click <property>...</property> button next to the value field</para></listitem> +<listitem><para>Expand <emphasis><property>Resource Bundles &gt; msg</property></emphasis> and select <emphasis><property>makeguess_button</property></emphasis> as a value</para></listitem> + <listitem><para>Click <emphasis><property>Ok</property></emphasis></para></listitem> +<listitem><para>Select <emphasis><property>action</property></emphasis> and click on this line below &quot;value&quot; header</para></listitem> + <listitem><para>Type <emphasis><property>NumberBean.checkGuess</property></emphasis> in text field</para></listitem> <listitem><para>Click <emphasis><property>Finish</property></emphasis></para></listitem> <listitem><para>In Source mode add <emphasis role="bold"><property>&lt;br/&gt;</property></emphasis> tags between <emphasis role="bold"><property>&lt;outputText&gt;</property></emphasis>, <emphasis role="bold"><property>&lt;inputText&gt;</property></emphasis> and <emphasis role="bold"><property>&lt;commandButton&gt;</property></emphasis> components to place them on different lines</para></listitem> </itemizedlist> @@ -558,7 +557,7 @@ <listitem><para>Switch to Preview mode to see how this page will look in a browser:</para></listitem> </itemizedlist> <figure> -<title>success.jsp in Preview mode</title> +<title>Success.jsp in Preview Mode</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/newrad16.png"/> @@ -572,8 +571,8 @@ <title>Creating index.jsp page</title> <para>The index.jsp page is the entry point of our application. It&apos;s just forwarding to inputnumber.jsp page.</para> <itemizedlist> -<listitem><para>Right click <emphasis>WebContent &gt; New &gt; JSP File</emphasis></para></listitem> -<listitem><para>Type &quot;index&quot; for name field and choose JSPRedirect as a template</para></listitem> +<listitem><para>Right click <emphasis><property>WebContent &gt; New &gt; JSP File</property></emphasis></para></listitem> + <listitem><para>Type <emphasis><property>index</property></emphasis> for name field and choose <emphasis><property>JSPRedirect</property></emphasis> as a template</para></listitem> <listitem><para>Click <emphasis><property>Finish</property></emphasis></para></listitem> <listitem><para>The source for this page should be like the following:</para></listitem> </itemizedlist> @@ -592,12 +591,12 @@ <title>Running the Application</title> <para>Everything is ready to run the application.</para> <itemizedlist> -<listitem><para>Start up JBoss server by clicking on the Start icon in JBoss Server view. (If JBoss is already running, stop it by clicking on the red icon and then start it again. After the messages in the Console tabbed view stop scrolling, JBoss is available</para></listitem> -<listitem><para>Click on the Red Hat run icon in the toolbar</para></listitem> + <listitem><para>Start up JBoss server by clicking on the <emphasis><property>Start</property></emphasis> icon in JBoss Server view. (If JBoss is already running, stop it by clicking on the red icon and then start it again. After the messages in the Console tabbed view stop scrolling, JBoss is available</para></listitem> + <listitem><para>Click on the <emphasis><property>Red Hat</property></emphasis> run icon in the toolbar</para></listitem> <listitem><para>Play with the application by entering correct as well as incorrect values</para></listitem> </itemizedlist> <figure> -<title>You are asked to enter a number between 0 and 100</title> +<title>You are Asked to Enter a Number Between 0 and 100</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/guessnumber.png"/> @@ -605,7 +604,7 @@ </mediaobject> </figure> <figure> -<title>Your input is validated and an error message is displayed if invalid input was entered</title> +<title>Your Input is Validated and an Error Message is Displayed if Invalid Input was Entered</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/guessnumber2.png"/> @@ -614,7 +613,7 @@ </figure> <figure> -<title>After you enter a guess, the application tells you whether a smaller or a larger number should be tried</title> +<title>After You Enter a Guess, the Application Tells You Whether a Smaller or a Larger Number Should be Tried</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/guessnumber3.png"/> @@ -623,7 +622,7 @@ </figure> <figure> -<title>Your guess is correct</title> +<title>Your Guess is Correct</title> <mediaobject> <imageobject> <imagedata fileref="images/RADdevelopment/guessnumber4.png"/> Modified: trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/testNG.xml =================================================================== --- trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/testNG.xml 2007-10-30 12:25:59 UTC (rev 4576) +++ trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/testNG.xml 2007-10-30 13:48:08 UTC (rev 4577) @@ -12,7 +12,7 @@ <section> <title>What is TestNG?</title> <para><property>TestNG</property> (&quot;Testing, the Next Generation&quot;) is a Java unit testing framework that aims to overcome many limitations of JUnit. - <property>TestNG</property> introduces some new functionalities that make it more powerful and easier to use, such as:</para> + TestNG introduces some new functionalities that make it more powerful and easier to use, such as:</para> <itemizedlist> <listitem><para>JDK 5 Annotations (JDK 1.4 is also supported with JavaDoc annotations)</para></listitem> <listitem><para>Flexible test configuration</para></listitem> @@ -41,11 +41,11 @@ <title>How to use the generated Seam-test project to run Seam tests in Red Hat Developer Studio</title> <itemizedlist> - <listitem><para>Create a new Seam Web Project using New Project wizard or main menu <emphasis>File &gt; New &gt; Project &gt; Seam &gt; Seam Web Project</emphasis></para></listitem> + <listitem><para>Create a new Seam Web Project using New Project wizard or main menu <emphasis><property>File &gt; New &gt; Project &gt; Seam &gt; Seam Web Project</property></emphasis></para></listitem> </itemizedlist> <figure> - <title>Seam Web Project creation</title> + <title>Seam Web Project Creation</title> <mediaobject> <imageobject> <imagedata fileref="images/testNG/testNG1.png"/> @@ -67,7 +67,7 @@ </figure> <itemizedlist> - <listitem><para>Check the needed boxes and click <emphasis>Next</emphasis></para></listitem> + <listitem><para>Check the needed boxes and click <emphasis><property>Next</property></emphasis></para></listitem> </itemizedlist> <figure> @@ -79,7 +79,7 @@ </mediaobject> </figure> <itemizedlist> - <listitem><para>Click <emphasis>Next</emphasis> in the &quot;Web Module&quot; wizard&apos;s dialog</para></listitem> + <listitem><para>Click <emphasis><property>Next</property></emphasis> in the &quot;Web Module&quot; wizard&apos;s dialog</para></listitem> </itemizedlist> <figure> @@ -93,11 +93,11 @@ <itemizedlist> - <listitem><para>Check <emphasis>Server Supplied JSF Implementation</emphasis></para></listitem> + <listitem><para>Check <emphasis><property>Server Supplied JSF Implementation</property></emphasis></para></listitem> </itemizedlist> <figure> - <title>Adding JSF capabilities</title> + <title>Adding JSF Capabilities</title> <mediaobject> <imageobject> <imagedata fileref="images/testNG/testNG3.png"/> @@ -106,11 +106,11 @@ </figure> <itemizedlist> - <listitem><para>Select <emphasis>ear</emphasis> next to <emphasis>Deploy as:</emphasis> field</para></listitem> + <listitem><para>Select <emphasis><property>ear</property></emphasis> next to <emphasis><property>Deploy as:</property></emphasis> field</para></listitem> </itemizedlist> <figure> - <title>Select deployment type</title> + <title>Select Deployment Type</title> <mediaobject> <imageobject> <imagedata fileref="images/testNG/testNG4.png"/> @@ -119,11 +119,11 @@ </figure> <itemizedlist> - <listitem><para>After project is created you will have the generated Seam-test project that is setup to run <property>TestNG</property> directly against the proper libraries and server runtime libraries</para></listitem> + <listitem><para>After project is created you will have the generated Seam-test project that is setup to run TestNG directly against the proper libraries and server runtime libraries</para></listitem> </itemizedlist> <figure> - <title>Seam-test project</title> + <title>Seam-test Project</title> <mediaobject> <imageobject> <imagedata fileref="images/testNG/testNG5.png"/> @@ -132,11 +132,11 @@ </figure> <itemizedlist> - <listitem><para>Add Seam Action to your project via <emphasis>New &gt; Seam Action</emphasis></para></listitem> + <listitem><para>Add Seam Action to your project via <emphasis><property>New &gt; Seam Action</property></emphasis></para></listitem> </itemizedlist> <figure> - <title>Seam Action creation</title> + <title>Seam Action Creation</title> <mediaobject> <imageobject> <imagedata fileref="images/testNG/testNG6.png"/> @@ -149,7 +149,7 @@ </itemizedlist> <figure> - <title>New Seam Action wizard</title> + <title>New Seam Action Wizard</title> <mediaobject> <imageobject> <imagedata fileref="images/testNG/testNG7.png"/> @@ -178,7 +178,7 @@ </figure> <itemizedlist> - <listitem><para>Select <emphasis>ActionLocalTest.xml</emphasis> in Seam-test project and run the test via right click <emphasis>Run As &gt; TestNG Suite</emphasis></para></listitem> + <listitem><para>Select <emphasis><property>ActionLocalTest.xml</property></emphasis> in Seam-test project and run the test via right click <emphasis><property>Run As &gt; TestNG Suite</property></emphasis></para></listitem> </itemizedlist> <figure> @@ -190,11 +190,11 @@ </mediaobject> </figure> - <para>The test process will start and its ouput will be written in Console. After the messages in the Console tabbed view stop scrollig <property>TestNG</property> is finished.</para> + <para>The test process will start and its ouput will be written in Console. After the messages in the Console tabbed view stop scrollig TestNG is finished.</para> <figure> - <title>Test is finished</title> + <title>Test is Finished</title> <mediaobject> <imageobject> <imagedata fileref="images/testNG/testNG10a.png"/> @@ -203,7 +203,7 @@ </figure> <itemizedlist> - <listitem><para>After running <property>TestNG</property> you will have the test results in <emphasis>test-output</emphasis> folder in Seam-test project (press F5 to refresh the Package Explorer view). Open <emphasis><property>index.html</property></emphasis> file with web browser</para></listitem> + <listitem><para>After running TestNG you will have the test results in <emphasis>test-output</emphasis> folder in Seam-test project (press F5 to refresh the Package Explorer view). Open <emphasis><property>index.html</property></emphasis> file with web browser</para></listitem> </itemizedlist> <figure> @@ -223,7 +223,7 @@ </imageobject> </mediaobject> </figure> - <para>The <property>TestNG</property> information is split up into two panes in browser. You can select a result on the left-hand pane and its details will be displayed on the right-hand one.</para> + <para>The TestNG information is split up into two panes in browser. You can select a result on the left-hand pane and its details will be displayed on the right-hand one.</para> <figure> <title>TestNG Information</title> <mediaobject>