Author: irooskov(a)redhat.com Date: 2010-09-21 00:30:40 -0400 (Tue, 21 Sep 2010) New Revision: 25039 Added: trunk/as/docs/reference/en-US/images/runtimes_servers/runtimes_servers-detecting_new_runtime_1.png trunk/as/docs/reference/en-US/images/runtimes_servers/runtimes_servers-detecting_new_runtime_2.png Modified: trunk/as/docs/reference/en-US/runtimes_servers.xml Log: updated with the addition of a runtime dedection section -> the beginnings of one Added: trunk/as/docs/reference/en-US/images/runtimes_servers/runtimes_servers-detecting_new_runtime_1.png =================================================================== (Binary files differ) Property changes on: trunk/as/docs/reference/en-US/images/runtimes_servers/runtimes_servers-detecting_new_runtime_1.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/as/docs/reference/en-US/images/runtimes_servers/runtimes_servers-detecting_new_runtime_2.png =================================================================== (Binary files differ) Property changes on: trunk/as/docs/reference/en-US/images/runtimes_servers/runtimes_servers-detecting_new_runtime_2.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Modified: trunk/as/docs/reference/en-US/runtimes_servers.xml =================================================================== --- trunk/as/docs/reference/en-US/runtimes_servers.xml 2010-09-20 23:04:14 UTC (rev 25038) +++ trunk/as/docs/reference/en-US/runtimes_servers.xml 2010-09-21 04:30:40 UTC (rev 25039) @@ -14,10 +14,10 @@ <para>In this chapter we will discuss how to install runtimes and servers.</para> - <para>First of all it&apos;s necessary to mention that the JBoss AS plugin makes use of WTP. + <para>First of all it is necessary to mention that the JBoss AS plugin makes use of WTP. This includes starting and stopping servers in run or debug mode. It also includes targeting WTP projects, such as Dynamic Web Projects, to certain server runtimes in order to ensure that the - proper jars from a specific server are added to the project&apos;s classpath + proper jars from a specific server are added to the project's classpath properly.</para> <para>In order to get started creating, running, and debugging J2EE applications, we should create our <property>runtime</property> and <property>server</property> instances.</para> @@ -38,8 +38,37 @@ </listitem> </itemizedlist> + <section id="Detecting_a_new_runtime"> + <title>Detecting a new runtime</title> + <para> + JBoss Tools features the ability to search, detect and add existing JBoss server runtimes installed on your system. If you don't have an existing runtime <xref linkend="InstNewRuntime"/> will guide you through the creation process. To begin searching for your existing JBoss runtime navigate to <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>JBoss Runtimes</guimenuitem></menuchoice>. + </para> + <figure> + <title>Preference page for JBoss Runtimes</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/runtimes_servers/runtimes_servers-detecting_new_runtime_1.png"/> + </imageobject> + </mediaobject> + </figure> + <para> + The JBoss Runtimes preference page allows you to perform three different actions: <guibutton>Search</guibutton> for a JBoss runtime installation, <guibutton>Export</guibutton> a JBoss runtime configuration and <guibutton>Import</guibutton> the configuration of a JBoss runtime. + </para> + <para> + The <guibutton>Search</guibutton> button opens a file system browser window. Select a directory where you wish JBoss Tools to begin recursively searching for JBoss runtimes and upon completion it will return all those found. From the returned list, choose the runtimes you wish to make available to your JBoss Tools instance by clicking the box beside each runtime and clicking the <guibutton>OK</guibutton> button. + </para> + <figure> + <title>JBoss Runtime search results</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/runtimes_servers/runtimes_servers-detecting_new_runtime_2.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="InstNewRuntime"> - <title>Installing a New Runtime</title> + <title>Installing a new runtime</title> <para>You can install runtimes into eclipse from the <emphasis> <property>Window &gt; Preferences </property> </emphasis> menu, and then select <emphasis>