[jbosstools-commits] JBoss Tools SVN: r10585 - trunk/documentation/guides/GettingStartedGuide/en/modules.

Author: ochikvina Date: 2008-10-01 07:33:56 -0400 (Wed, 01 Oct 2008) New Revision: 10585 Modified: trunk/documentation/guides/GettingStartedGuide/en/modules/gsg_faq.xml Log: https://jira.jboss.org/jira/browse/JBDS-429 - reconstracting the FAQ; Modified: trunk/documentation/guides/GettingStartedGuide/en/modules/gsg_faq.xml =================================================================== --- trunk/documentation/guides/GettingStartedGuide/en/modules/gsg_faq.xml 2008-10-01 11:32:51 UTC (rev 10584) +++ trunk/documentation/guides/GettingStartedGuide/en/modules/gsg_faq.xml 2008-10-01 11:33:56 UTC (rev 10585) @@ -11,176 +11,182 @@ </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> - - <section id="Installation_Issues"> - <title>Installation Issues</title> - <para> - <emphasis role="bold">Visual Editor does not start under Linux</emphasis> - </para> - <para>Linux users may need to do the following to get the visual editor 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 + + <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> + + <section id="question_1"> + <title>What should I do if 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> + + <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 none of these work, do the following:</para> - <itemizedlist> - <listitem> - <para>Clear the Eclipse log file, + </listitem> + <listitem> + <para>Open the JBDS perspective. If you see the Help view open, close it and restart + JBDS</para> + </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 + </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> - - - <para> - <emphasis role="bold">Do I need to have JBoss server installed to run JBoss Developer - Studio?</emphasis> - </para> - <para>No. JBoss Developer Studio 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 JBoss Developer Studio 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>JBoss Developer Studio works with any servlet container, not just JBoss. For more - information on deployment, please see the Deploying Your Application section.</para> - </section> - <section id="Importing_Projects"> - <title>Importing Projects</title> - <para> - <emphasis role="bold">I have an existing Seam 1.2.1 project. Can I migrate/import the project to - a JBDS Seam project?</emphasis> - </para> - <para>We highly recommend you to create Seam 1.2.1 project using the JBDS. 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> - <para> - <emphasis role="bold">I have an existing Struts or JSF project. Can I open the project in - JBDS?</emphasis> - </para> - <para>Yes. From main menu select <emphasis> + </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_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> + + <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> + + <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> + + </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> - <emphasis role="bold">Can I import a .war file?</emphasis> - </para> - <para>Yes. Select <emphasis><property>File &gt; Import &gt; Web &gt; WAR + </emphasis> and follow wizards steps.</para> + + </section> + + <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> - <section id="Troubleshooting"> - <title>Troubleshooting, Problems, Configuration, Error Messages</title> - <para> - <emphasis role="bold">Is it possible to increase the performance of Eclipse after installing - your product?</emphasis> - </para> - <para>JBoss Developer Studio 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"> + </section> + + <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> - - <para> - <emphasis role="bold">How can I add my own tag library to the JBoss Tools Palette?</emphasis> - </para> - <para>See <ulink url="&jsflink;#AddingCustomJSFTagsToTheRedHatPalette7433">Adding Tag + </section> + + <section id="question_7"> + <title>How can I add my own tag library to the JBoss Tools + Palette?</title> + + <para>See <ulink url="&jsflink;#AddingCustomJSFTagsToTheRedHatPalette7433">Adding Tag Libraries</ulink> in Visual Web Tools Guide.</para> - </section> - - <section id="question1"> - <title>How to get Code Assist for Seam specific resources in an externally - generated project?</title> - + </section> + + <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 <ulink url="&seamlink;#project_pref">Seam Settings</ulink>.</para> + <property>Seam support</property> + </emphasis> box to enable all available <ulink url="&seamlink;#project_pref">Seam + Settings</ulink>.</para> </section> - - <section id="question2"> - <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> - + <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> + <property>New > Other > Java Project from Existing Buildfile</property> + </emphasis></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> + <property>build.xml</property> + </emphasis> of any chosen project by pressing <emphasis> + <property>Browse</property> + </emphasis> button</para> </listitem> - + <listitem> <para>Hit <emphasis> - <property>Finish</property> - </emphasis> to open the project</para> + <property>Finish</property> + </emphasis> 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> + + <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> - -</chapter> \ No newline at end of file + +</chapter>