Author: smukhina Date: 2007-10-02 09:12:18 -0400 (Tue, 02 Oct 2007) New Revision: 3959 Modified: trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/GettingStartedWithRHDS.xml trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/RADdevelopmentOfSimpleJSFapplication.xml Log: http://jira.jboss.com/jira/browse/RHDS-163 have checked language and content of half of the chapter. the errors were found, language is corrected. content will be corrected. Modified: trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/GettingStartedWithRHDS.xml =================================================================== --- trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/GettingStartedWithRHDS.xml 2007-10-02 09:56:31 UTC (rev 3958) +++ trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/GettingStartedWithRHDS.xml 2007-10-02 13:12:18 UTC (rev 3959) @@ -13,7 +13,7 @@ <section id="ConfigJavaEnvironment"> <?dbhtml filename="ConfigJavaEnvironment.html"?> <title>Configuring Your Java Environment</title> - <para>You must have a working installation of JDK 1.5 before you install Red Hat Developer Studio. Currently it will only fully work with a 32-bit JVM, not a 64-bit JVM. On a 64-bit JVM the visual editor will fail to launch. Thus in this guide we will show you how to install a 32-bit Sun JDK 5.0 on a Linux Platform and Microsoft Windows Platform.</para> + <para>You must have a working installation of JDK 1.5 before you install Red Hat Developer Studio. Currently it will only fully work with a 32-bit JVM, not a 64-bit JVM. On a 64-bit JVM the visual editor fails to launch. Thus in this guide we will show you how to install a 32-bit Sun JDK 5.0 on a Linux Platform and Microsoft Windows Platform.</para> <section id="InstallJDK50onLinux"> <title>Installing and Configuring 32-bit Sun JDK 5.0 on Linux</title> <itemizedlist> @@ -22,10 +22,10 @@ <listitem><para>If you don&apos;t want to use SysV service scripts you can install the &quot;self-extracting file&quot; for Linux instead of choosing the &quot;RPM in self-extracting&quot; file. In that case you can skip the next step mentioned here. But it is recommended to use the SysV service scripts for production servers.</para></listitem> <listitem><para>Download and install the appropriate -compat RPM from JPackage <ulink url="ftp://jpackage.hmdc.harvard.edu/JPackage/1.7/generic/RPMS.non-f...;. - Please ensure you choose a matching version of the -compat package to the JDK you installed.</para></listitem> + Please ensure you choose a matching version of the -compat package to the JDK you've installed.</para></listitem> <listitem><para>Create an environment variable that points to the JDK installation directory and call it JAVA_HOME. Add <emphasis><property>$JAVA_HOME/bin</property></emphasis> to the system path to be able to run java from the command line. You can do this by adding the following lines to the .bashrc file in your home directory.</para> - <programlisting role="JAVA"><![CDATA[#In this example /usr/java/jdk1.5.0_11 is the JDK installation directory. + <programlisting><![CDATA[#In this example /usr/java/jdk1.5.0_11 is the JDK installation directory. export JAVA_HOME=/usr/java/jdk1.5.0_11 export PATH=$PATH:$JAVA_HOME/bin]]></programlisting> </listitem> @@ -36,18 +36,18 @@ You only need to run &quot;alternative&quot; as a safe guard for the right JVM.</para> </note> - <para>Set this variable for the your account doing the installation and also for the user account that will run the server.</para> + <para>Set this variable for your account doing the installation and also for the user account that will run the server.</para> <itemizedlist> - <listitem><para>If you have more than one version of JVM installed in your machine, make sure you are using the JDK 1.5 installation as the default java and javac. - You can do this using the alternatives system. The alternatives system allows different versions of Java, from different sources to co-exist on your system.</para></listitem> + <listitem><para>If you have more than one version of JVM installed on your machine, make sure you are using the JDK 1.5 installation as the default java and javac. + You can do this using the alternatives system. The alternatives system allows different versions of Java from different sources to co-exist on your system.</para></listitem> </itemizedlist> <section id="SelectAlternativesforJava"> <title>Select alternatives for java, javac and java_sdk_1.5.0</title> <itemizedlist> - <listitem><para>As root, type the following command at the shell prompt and you should see something like this:</para></listitem> + <listitem><para>As a root user, type the following command at the shell prompt and you should see something like this:</para></listitem> </itemizedlist> - <programlisting role="JAVA"><![CDATA[[root@vsr ~]$ /usr/sbin/alternatives --config java -There are 2 programs which provide 'java'. + <programlisting ><![CDATA[[root@vsr ~]$ /usr/sbin/alternatives --config java +There are 2 programs that provide 'java'. Selection Command ----------------------------------------------- 1 /usr/lib/jvm/jre-1.4.2-gcj/bin/java @@ -57,15 +57,15 @@ <itemizedlist> <listitem><para>Repeat the same for javac and java_sdk_1.5.0.</para></listitem> </itemizedlist> - <programlisting role="JAVA"><![CDATA[[root@vsr ~]$ /usr/sbin/alternatives --config javac -There are 1 programs which provide 'javac'. + <programlisting ><![CDATA[[root@vsr ~]$ /usr/sbin/alternatives --config javac +There is 1 program that provides 'javac'. Selection Command ----------------------------------------------- *+ 1 /usr/lib/jvm/java-1.5.0-sun/bin/javac Enter to keep the current selection[+], or type selection number: [root@vsr ~]$ /usr/sbin/alternatives --config java_sdk_1.5.0 -There are 1 programs which provide 'java_sdk_1.5.0'. +There is 1 program that provide 'java_sdk_1.5.0'. Selection Command ----------------------------------------------- *+ 1 /usr/lib/jvm/java-1.5.0-sun @@ -84,10 +84,8 @@ Java HotSpot(TM) Client VM (build 1.5.0_11-b03, mixed mode, sharing)]]></programlisting> </section> - - </section> - - <section id="InstallJDK50onWindows"> + </section> + <section id="InstallJDK50onWindows"> <title>Installing and Configuring 32-bit Sun JDK 5.0 on Microsoft Windows</title> <itemizedlist> <listitem><para>Download the <ulink url="http://java.sun.com/javase/downloads/index_jdk5.jsp">Sun JDK 5.0 (Java 2 Development Kit)</ulink> from Sun&apos;s website. @@ -95,18 +93,17 @@ <listitem><para>Create an environment variable called JAVA_HOME that points to the JDK installation directory, for example:</para></listitem> </itemizedlist> <para><emphasis>C:\Program Files\Java\jdk1.5.0_11\</emphasis></para> - <para>In order to run java from the command line add the <emphasis>jre\bin</emphasis> directory to your path, for example:</para> + <para>In order to run java from the command line, add the <emphasis>jre\bin</emphasis> directory to your path, for example:</para> <para><emphasis>C:\Program Files\Java\jdk1.5.0_11\jre\bin</emphasis></para> - <para>To do this, open the Control Panel from the Start Menu, switch to Classic View if necessary, open the System Control Panel applet, select the Advanced Tab, and click on the Environment Variables button.</para> - - </section> + <para>To do this, open the Control Panel from the Start Menu, switch to Classic View if necessary, open the System Control Panel applet (System), select the Advanced Tab, and click on the Environment Variables button.</para> + </section> </section> <section id="InstallingRHDS"> <?dbhtml filename="InstallingRHDS.html"?> <title>Red Hat Developer Studio Installation</title> <section id="Instfromdownver"> <title>Installing from the downloaded version</title> - <para>RHDS comes with simple installer, bundled with tested/pre-configured versions of Eclipse, Webtools, JBossEAP, and SpringIDE.</para> + <para>RHDS comes with a simple installer, bundled with tested/pre-configured versions of Eclipse, Webtools, JBossEAP, Seam, and SpringIDE.</para> <itemizedlist> <listitem> <para>Download the appropriate installation file for your platform from <ulink url="http://www.redhat.com/developers/rhds/index.html">Red Hat website</ulink>.</para> @@ -145,7 +142,7 @@ </figure> <note> <title>Note:</title> - <para>The installer will install JBoss J2EE Application Server for running your applications if you select this option during the installation process. + <para>The installer installs JBoss J2EE Application Server for running your applications if you select this option during the installation process. If you want to use a different server than ours, you can change the setting in Red Hat Developer Studio.</para> </note> Modified: trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/RADdevelopmentOfSimpleJSFapplication.xml =================================================================== --- trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/RADdevelopmentOfSimpleJSFapplication.xml 2007-10-02 09:56:31 UTC (rev 3958) +++ trunk/documentation/GettingStartedGuide/docs/userguide/en/modules/RADdevelopmentOfSimpleJSFapplication.xml 2007-10-02 13:12:18 UTC (rev 3959) @@ -117,17 +117,17 @@ <section id="CreatingResourceFile"> <?dbhtml filename="CreatingResourceFile.html"?> <title>Creating Resource File</title> -<para>Red Hat Developer Studio allows to quickly create 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>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> <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 Finish</para></listitem> +<listitem><para>Type &quot;game&quot; 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 Finish</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> </itemizedlist> <para>Red Hat Developer Studio will automatically open messages.properties file for editing.</para> <figure> @@ -141,7 +141,7 @@ <itemizedlist> <listitem><para>Click <emphasis>Add</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 Finish</para></listitem> +<listitem><para>Click <emphasis><property>Finish</property></emphasis></para></listitem> <listitem><para>In such a way add the next properties:</para></listitem> </itemizedlist> <programlisting role="JAVA"><![CDATA[makeguess_button=Make Guess @@ -183,7 +183,7 @@ <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 OK +<listitem><para>Check <emphasis>userNumber</emphasis> box and click <emphasis><property>OK</property></emphasis> <figure> <title>Generate Getters and Setters</title> <mediaobject> @@ -316,9 +316,9 @@ <section id="EditingFacesConfig"> <?dbhtml filename="EditingFacesConfig.html"?> <title>Editing faces-config.xml File</title> -<para>This file holds our two navigation rules and defines the backing bean used.</para> +<para>This file holds two navigation rules and defines the backing bean used.</para> <itemizedlist> -<listitem><para>Open faces-config.xml file in source mode</para></listitem> +<listitem><para>Open faces-config.xml file in a source mode</para></listitem> <listitem><para>Add here one more navigation rule and a managed bean declarations that the content of the file looks like this:</para></listitem> </itemizedlist> <programlisting role="XML"><![CDATA[<?xml version="1.0" encoding="UTF-8"?> @@ -420,7 +420,7 @@ </mediaobject> </figure> <itemizedlist> -<listitem><para>Switch to Visual tab, so we can work with the editor completely in its WYSIWYG mode</para></listitem> +<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>Select <emphasis>value</emphasis> and click on this line below &quot;value&quot; header</para></listitem> @@ -437,7 +437,7 @@ </figure> <itemizedlist> <listitem><para>Expand <emphasis>Resource Bundles &gt; msg</emphasis></para></listitem> -<listitem><para>Select &quot;how_to_play&quot; value and click Ok. Then click <emphasis><property>Finish</property></emphasis> +<listitem><para>Select &quot;how_to_play&quot; value and click <emphasis><property>Ok</property></emphasis>. Then click <emphasis><property>Finish</property></emphasis> <figure> <title>Selecting Value</title> <mediaobject> @@ -460,10 +460,10 @@ <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>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 Save 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>inputText</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> @@ -495,14 +495,14 @@ <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>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>Click Finish</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> <para>inputnumber.jsp page should look like this:</para>