Author: mcaspers Date: 2011-01-17 21:43:05 -0500 (Mon, 17 Jan 2011) New Revision: 28334 Modified: trunk/documentation/guides/GettingStartedGuide/en-US/Revision_History.xml trunk/documentation/guides/GettingStartedGuide/en-US/gsg_faq.xml trunk/documentation/guides/GettingStartedGuide/en-US/rad_jsf_application.xml Log: General Updates Modified: trunk/documentation/guides/GettingStartedGuide/en-US/Revision_History.xml =================================================================== --- trunk/documentation/guides/GettingStartedGuide/en-US/Revision_History.xml 2011-01-18 02:28:29 UTC (rev 28333) +++ trunk/documentation/guides/GettingStartedGuide/en-US/Revision_History.xml 2011-01-18 02:43:05 UTC (rev 28334) @@ -1,4 +1,52 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ ]> -<appendix><title>Revision History</title><simpara><revhistory><revision><revnumber>1</revnumber><date>Wed Jun 09 2010</date><author><firstname>JBoss Tools</firstname><surname>Documentation Team</surname><email></email></author><revdescription><simplelist><member>General updates</member></simplelist></revdescription></revision><revision><revnumber>0</revnumber><date>Fri Nov 20 2009</date><author><firstname>Isaac</firstname><surname>Rooskov</surname><email>irooskov@redhat.com</email></author><revdescription><simplelist><member>Initial creation of book by publican</member></simplelist></revdescription></revision></revhistory></simpara></appendix> +<appendix> + <title>Revision History</title> + <simpara> + <revhistory> + <revision> + <revnumber>2</revnumber> + <date>Tue Jan 18 2010</date> + <author> + <firstname>JBoss Tools</firstname> + <surname>Documentation Team</surname> + <email></email> + </author> + <revdescription> + <simplelist> + <member>General updates</member> + </simplelist> + </revdescription> + </revision> + <revision> + <revnumber>1</revnumber> + <date>Wed Jun 09 2010</date> + <author> + <firstname>JBoss Tools</firstname> + <surname>Documentation Team</surname> + <email></email> + </author> + <revdescription> + <simplelist> + <member>General updates</member> + </simplelist> + </revdescription> + </revision> + <revision> + <revnumber>0</revnumber> + <date>Fri Nov 20 2009</date> + <author> + <firstname>Isaac</firstname> + <surname>Rooskov</surname> + <email&gt;irooskov(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>Initial creation of book by publican</member> + </simplelist> + </revdescription> + </revision> + </revhistory> + </simpara> +</appendix> Modified: trunk/documentation/guides/GettingStartedGuide/en-US/gsg_faq.xml =================================================================== --- trunk/documentation/guides/GettingStartedGuide/en-US/gsg_faq.xml 2011-01-18 02:28:29 UTC (rev 28333) +++ trunk/documentation/guides/GettingStartedGuide/en-US/gsg_faq.xml 2011-01-18 02:43:05 UTC (rev 28334) @@ -1,88 +1,82 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="gsg_faq" role="updated"> - <?dbhtml filename="gsg_faq.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>Eclipse</keyword> - <keyword>Java</keyword> - <keyword>JBoss</keyword> - </keywordset> - </chapterinfo> - <title>FAQ</title> + <?dbhtml filename="gsg_faq.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + <title>FAQ</title> - <para>For more information on <property>JBoss Developer Studio</property> features, refer to the - following FAQ to get the answers on the most &quot;popular&quot; questions.</para> + <para>Refer to the following FAQ to get the answers on the most &quot;popular&quot; questions concerning <property>JBoss Developer Studio</property>.</para> - <section id="question_1"> - <title>What should I do if Visual Page Editor does not start under Linux</title> + <section id="question_1"> + <title>What should I do if the Visual Page Editor does not start under Linux</title> - <para>Linux users may need to do the following to get the <property>Visual Page - Editor</property> to work correctly on their machines.</para> + <para>Linux users may need to do the following to get the <property>Visual Page Editor</property> to work correctly on their machines.</para> - <orderedlist> - <listitem> - <para>On Red Hat based Linux distributions install the xpLib.i386 package</para> - </listitem> - <listitem> - <para>Type</para> - <programlisting role="JAVA"><![CDATA[ln -s libstdc++.so.5.0.7 libstdc++.so.5 + <orderedlist> + <listitem> + <para>On Red Hat based Linux distributions install the xpLib.i386 package</para> + </listitem> + <listitem> + <para>Type</para> + <programlisting role="JAVA"><![CDATA[ln -s libstdc++.so.5.0.7 libstdc++.so.5 ]]></programlisting> - </listitem> - <listitem> - <para>and/or use</para> - <programlisting role="JAVA"><![CDATA[yum install libXp + </listitem> + <listitem> + <para>and/or use</para> + <programlisting role="JAVA"><![CDATA[yum install libXp ]]></programlisting> - </listitem> - <listitem> - <para>Open the JBDS perspective. If you see the Help view open, close it and restart - JBDS</para> - </listitem> - <listitem><para> If it doesn't help and you use Fedora Core Linux and Eclipse Version: 3.4.1,the issue can be produced because libswt-xulrunner-gtk-3449.so file doesn't present - in eclipse-swt-3.4.1-5.fc10.x86_64.rpm/eclipse/plugins/org.eclipse.swt.gtk.linux.x86_64_3.4.1.v3449c.jar.To add this file to eclipse you should: + </listitem> + <listitem> + <para>Open the JBDS perspective. If you see the Help view open, close it and restart JBDS</para> + </listitem> + <listitem> + <para> If it doesn't help and you use Fedora Core Linux and Eclipse Version: 3.4.1,the issue can be produced because libswt-xulrunner-gtk-3449.so file doesn't present in eclipse-swt-3.4.1-5.fc10.x86_64.rpm/eclipse/plugins/org.eclipse.swt.gtk.linux.x86_64_3.4.1.v3449c.jar. To add this file to eclipse you should: </para> - <itemizedlist> - <listitem> - <para>Decompress eclipse/plugins/org.eclipse.swt.gtk.linux.x86_3.4.1.v3449c.jar form eclipse-SDK-3.4.1-linux-gtk-x86_64.tar.gz</para> - </listitem> - <listitem> - <para>Copy <property>libswt-xulrunner-gtk-3449.so</property> file to your Fedora Eclipse location.</para> - </listitem> - - <listitem> - <para>Open the file eclipse.ini,which can be found in your Fedora Eclipse location and add the following line: </para> - <programlisting role="JAVA"><![CDATA[-Dswt.library.path=/usr/lib/eclipse -]]></programlisting><para>,where <code>/usr/lib/eclipse</code> is the path to your eclipse folder.</para> - </listitem> - </itemizedlist> - </listitem> - <listitem> - <para>If none of these work, do the following:</para> - <itemizedlist> - <listitem> - <para>Clear the Eclipse log file, - <emphasis>&lt;workspace&gt;\.metadata\.log</emphasis></para> - </listitem> - <listitem> - <para>Start Eclipse with the -debug option:</para> - <programlisting role="JAVA"><![CDATA[eclipse -debug -]]></programlisting> - </listitem> - <listitem> - <para>Post the Eclipse log file - (<emphasis>&lt;workspace&gt;\.metadata\.log</emphasis>) on - the forums.</para> - </listitem> - </itemizedlist> - </listitem> - </orderedlist> - </section> - - <section id="question_0x2"> - <title>Visual Editor starts OK, but the Missing Natures dialog appears</title> + <itemizedlist> + <listitem> + <para>Decompress eclipse/plugins/org.eclipse.swt.gtk.linux.x86_3.4.1.v3449c.jar form eclipse-SDK-3.4.1-linux-gtk-x86_64.tar.gz</para> + </listitem> + <listitem> + <para>Copy <property>libswt-xulrunner-gtk-3449.so</property> file to your Fedora Eclipse location.</para> + </listitem> - <figure> + <listitem> + <para>Open the file <filename>eclipse.ini</filename>, which can be found in your Fedora Eclipse location and add the following line: </para> + <programlisting role="JAVA"><![CDATA[-Dswt.library.path=/usr/lib/eclipse]]></programlisting> + <para>,where <code>/usr/lib/eclipse</code> is the path to your eclipse folder.</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para>If none of these work, do the following:</para> + <itemizedlist> + <listitem> + <para>Clear the Eclipse log file,<filename>&lt;workspace&gt;\.metadata\.log</filename> + </para> + </listitem> + <listitem> + <para>Start Eclipse with the -debug option:</para> + <programlisting role="JAVA"><![CDATA[eclipse -debug]]></programlisting> + </listitem> + <listitem> + <para>Post the Eclipse log file(<filename>&lt;workspace&gt;\.metadata\.log</filename>) on the forums.</para> + </listitem> + </itemizedlist> + </listitem> + </orderedlist> + </section> + + <section id="question_0x2"> + <title>Visual Editor starts OK, but the Missing Natures dialog appears</title> + + <figure> <title>Missing Nature</title> <mediaobject> <imageobject> @@ -92,165 +86,135 @@ </figure> - <para> + <para> Some functionality of Visual Editor may not work if a project doesn't have <property>org.jboss.tools.jsf.jsfnature</property> or <property>org.jboss.tools.jst.web.kb.kbnature</property> in <property>.project</property> configuration. To fix this problem and turn off the message box execute next steps: -</para> -<orderedlist> -<listitem><para> + </para> + <orderedlist> + <listitem> + <para> Right mouse button click on a project in Package Explorer. - </para></listitem> - <listitem><para> - Select <property>Configure -> Add JSF Capabilities</property> from the context menu. - </para></listitem> - <listitem><para> + </para> + </listitem> + <listitem> + <para> Select <menuchoice><guimenuitem>Configure</guimenuitem><guimenuitem>Add JSF Capabilities</guimenuitem></menuchoice> from the context menu. + </para> + </listitem> + <listitem> + <para> Configure your project using Add JSF Capabilities wizard and press Finish. -</para></listitem> +</para> + </listitem> -</orderedlist> -<para> -If you are shure that your project does not need JSF capabilities, just disable this message box by checking <property>Do not show this dialog again!</property> checkbox. + </orderedlist> + <para> +If you are sure that your project does not need JSF capabilities, just disable this message box by checking <property>Do not show this dialog again!</property> checkbox. </para> </section> - <section id="question_2"> - <title>Do I need to have JBoss Server installed to run JBoss Developer Studio?</title> + <section id="question_2"> + <title>Do I need to have JBoss Server installed to run JBoss Developer Studio?</title> - <para>No. <property>JBoss Developer Studio</property> already comes bundled with JBoss - Server. We bundle it together so that you don&apos;t need to download any additional - software and can test your application in a Web browser right away.</para> - <para>If you want to use a different JBoss server installation, after <property>JBoss - Developer Studio</property> is installed open Servers View (select - <emphasis><property>Window &gt; Show View &gt; Others &gt; Server - &gt; Servers</property>),</emphasis> then right click on this <emphasis> - <property>view &gt; New &gt; Server</property> - </emphasis> and follow the wizards steps to point to another Jboss Server - installation.</para> - <para><property>JBoss Developer Studio</property> works with any servlet container, not just - JBoss. For more information on deployment, please see the Deploying Your Application - section.</para> - </section> + <para>No. <property>JBoss Developer Studio</property> already comes bundled with JBoss Server. We bundle it together so that you don&apos;t need to download any additional software and can test your application in a Web browser right away.</para> + <para>If you want to use a different JBoss server installation, after <property>JBoss Developer Studio</property> is installed open Servers View (select <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Show View</guimenuitem><guimenuitem>Others</guimenuitem><guimenuitem>Server</guimenuitem><guimenuitem>Servers</guimenuitem></menuchoice>), then right click and select <menuchoice><guimenuitem>View</guimenuitem><guimenuitem>New</guimenuitem><guimenuitem>Server</guimenuitem></menuchoice> and follow the wizards steps to point to another Jboss Server installation.</para> + <para> + <property>JBoss Developer Studio</property> works with any servlet container, not just JBoss. For more information on deployment, please see the Deploying Your Application section.</para> + </section> - <section id="question_3"> - <title>I have an existing Seam 1.2.1 project. Can I migrate/import the project to a JBDS - Seam project?</title> + <section id="question_3"> + <title>I have an existing Seam 1.2.1 project. Can I migrate/import the project to a JBDS Seam project?</title> - <para>We highly recommend you to create Seam 1.2.1 project using the - <property>JBDS</property>. In other case try to do manually:</para> + <para>We highly recommend you to create Seam 1.2.1 project using the <property>JBDS</property>. In other case try to do manually:</para> - <itemizedlist> - <listitem> - <para>Create a Seam Web project to get the JBoss tools structure</para> - </listitem> - </itemizedlist> - <para>Then from your Seam 1.2.1 seam-gen project start doing the following:</para> - <itemizedlist> - <listitem> - <para>Copy <property>src</property> to <property>src</property></para> - </listitem> - <listitem> - <para>Copy <property>view</property> to <property>Web content</property></para> - </listitem> - <listitem> - <para>Copy resources individual files to where they are in the seam web project - etc.</para> - </listitem> - </itemizedlist> + <itemizedlist> + <listitem> + <para>Create a Seam Web project to get the JBoss tools structure</para> + </listitem> + </itemizedlist> + <para>Then from your Seam 1.2.1 seam-gen project start doing the following:</para> + <itemizedlist> + <listitem> + <para>Copy <filename>src</filename> to <filename>src</filename> + </para> + </listitem> + <listitem> + <para>Copy <filename>view</filename> to <filename>Web content</filename> + </para> + </listitem> + <listitem> + <para>Copy resources individual files to where they are in the seam web project etc.</para> + </listitem> + </itemizedlist> - </section> - <section id="questio_4"> - <title>I have an existing Struts or JSF project. Can I open the project in JBDS?</title> + </section> + <section id="questio_4"> + <title>I have an existing Struts or JSF project. Can I open the project in JBDS?</title> - <para>Yes. From main menu select <emphasis> - <property>File &gt; Import &gt; Other &gt; JSF Project (or Struts - Project)</property> - </emphasis> and follow wizards steps.</para> + <para>Yes. From main menu select <menuchoice><guimenuitem>File</guimenuitem><guimenuitem>File</guimenuitem><guimenuitem>Import</guimenuitem><guimenuitem>Other</guimenuitem><guimenuitem>JSF Project (or Struts Project)</guimenuitem></menuchoice> and follow wizards steps.</para> - </section> + </section> - <section id="question_5"> - <title>Can I import a .war file?</title> + <section id="question_5"> + <title>Can I import a .war file?</title> - <para>Yes. Select <emphasis><property>File &gt; Import &gt; Web &gt; WAR - file</property>, </emphasis> then follow importing steps.</para> - </section> + <para>Yes. Select <menuchoice><guimenuitem>File</guimenuitem><guimenuitem>Import</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>WAR file</guimenuitem></menuchoice> then follow importing steps.</para> + </section> - <section id="question_6"> - <title>Is it possible to increase the performance of Eclipse after installing your - product?</title> + <section id="question_6"> + <title>Is it possible to increase the performance of Eclipse after installing your product?</title> - <para><property>JBoss Developer Studio</property> preconfigures eclipse via the eclipse.ini - file to allocate extra memory, but if you for some reason need more memory then by - default, you can manually make adjustments in this file. For example:</para> - <programlisting role="XML"> - <![CDATA[-vmargs -Xms128m -Xmx512m -XX:MaxPermSize=128m -]]></programlisting> - </section> + <para> + <property>JBoss Developer Studio</property> preconfigures eclipse via the <filename>eclipse.ini</filename> file to allocate extra memory, but if you for some reason need more memory then by default, you can manually make adjustments in this file. For example:</para> + <programlisting role="XML"><![CDATA[-vmargs -Xms128m -Xmx512m -XX:MaxPermSize=128m]]></programlisting> + </section> - <section id="question_7"> - <title>How can I add my own tag library to the JBoss Tools Palette?</title> + <section id="question_7"> + <title>How can I add my own tag library to the JBoss Tools Palette?</title> - <para>See the section on Adding Tag - Libraries in the Visual Web Tools Guide.</para> - </section> + <para>See the section on Adding Tag Libraries in the Visual Web Tools Guide.</para> + </section> - <section id="question_8"> - <title>How to get Code Assist for Seam specific resources in an externally generated - project?</title> + <section id="question_8"> + <title>How to get Code Assist for Seam specific resources in an externally generated project?</title> - <para>To get Code Assist for Seam specific resources in an externally generated project, you - should enable Seam features in Project Preferences. Right click an imported project and - navigate <emphasis> - <property>Properties > Seam Settings</property>.</emphasis> Check <emphasis> - <property>Seam support</property> - </emphasis> box to enable all available Seam - Settings.</para> - </section> + <para>To get Code Assist for Seam specific resources in an externally generated project, you should enable Seam features in Project Preferences. Right click an imported project and navigate + + <menuchoice><guimenuitem>Properties</guimenuitem><guimenuitem>Seam Settings</guimenuitem></menuchoice>. Check <emphasis><property>Seam support</property> + </emphasis> box to enable all available Seam Settings.</para> + </section> - <section id="question_9"> - <title>How to import an example Seam project from jboss-eap directory?</title> + <section id="question_9"> + <title>How to import an example Seam project from jboss-eap directory?</title> - <para>To import an example Seam project from <emphasis> - <property>jboss-eap</property> - </emphasis> into your working directory, you should perform the following steps:</para> + <para>To import an example Seam project from <emphasis><property>jboss-eap</property></emphasis> into your working directory, you should perform the following steps:</para> - <itemizedlist> - <listitem> - <para>Go to <emphasis> - <property>New > Other > Java Project from Existing Buildfile</property> - </emphasis></para> - </listitem> + <itemizedlist> + <listitem> + <para>Select <menuchoice><guimenuitem>New</guimenuitem><guimenuitem>Other</guimenuitem><guimenuitem>Java Project from Existing Buildfile</guimenuitem></menuchoice></para> + </listitem> - <listitem> - <para>Point to the <emphasis> - <property>build.xml</property> - </emphasis> of any chosen project by pressing <emphasis> - <property>Browse</property> - </emphasis> button</para> - </listitem> + <listitem> + <para>Point to the<filename>build.xml</filename> file of any chosen project by clicking the <guibutton>Browse</guibutton> button</para> + </listitem> - <listitem> - <para>Hit <emphasis> - <property>Finish</property> - </emphasis> to open the project</para> - </listitem> - </itemizedlist> + <listitem> + <para>Click the <guibutton>Finish</guibutton> button to open the project</para> + </listitem> + </itemizedlist> - <para>As these seam examples are non WTP projects, next you should enable Seam support for - them. To do that, right click the project and go to <emphasis> - <property>Properties > Seam Settings</property>.</emphasis></para> - </section> + <para> + As these seam examples are non WTP projects, next you should enable Seam support for them. To do that, right click the project and select <menuchoice><guimenuitem>Properties</guimenuitem><guimenuitem>Seam Settings</guimenuitem></menuchoice>. + </para> + </section> - <section id="question_10"> - <title>Is a cross-platform project import possible for JBDS?</title> + <section id="question_10"> + <title>Is a cross-platform project import possible for JBDS?</title> - <para>Yes. You can easily import created in Linux JSF, Struts or Seam project to Windows and - vice versa.</para> + <para>Yes. You can easily import created in Linux JSF, Struts or Seam project to Windows and vice versa.</para> - <para>To do the transferring JSF, Struts or Seam project, go to <emphasis> - <property>Menu > Import > General > Existing Projects into Workspace</property>,</emphasis> - select the folder where your project stored and press <emphasis> - <property>Finish</property>.</emphasis></para> - </section> + <para> + To do the transferring JSF, Struts or Seam project, select <menuchoice><guimenuitem>Menu</guimenuitem><guimenuitem>Import</guimenuitem><guimenuitem>General</guimenuitem><guimenuitem>Existing Projects into Workspace</guimenuitem></menuchoice>. + </para> + </section> </chapter> Modified: trunk/documentation/guides/GettingStartedGuide/en-US/rad_jsf_application.xml =================================================================== --- trunk/documentation/guides/GettingStartedGuide/en-US/rad_jsf_application.xml 2011-01-18 02:28:29 UTC (rev 28333) +++ trunk/documentation/guides/GettingStartedGuide/en-US/rad_jsf_application.xml 2011-01-18 02:43:05 UTC (rev 28334) @@ -317,7 +317,7 @@ <para>JBDS allows to quickly generate getters and setters for java bean.</para> <itemizedlist> <listitem> - <para>Right click the <filename>NumberBean.java</filename> file </emphasis> in the Package Explorer view</para> + <para>Right click the <filename>NumberBean.java</filename> file in the Package Explorer view</para> </listitem> <listitem> <para>Select <menuchoice><guimenuitem>Source</guimenuitem><guimenuitem>Generate Getters and Setters...</guimenuitem></menuchoice>