[jbosstools-commits] JBoss Tools SVN: r15151 - in branches/jbosstools-3.0.x/as/docs/reference: en/images/modules and 4 other directories.

Author: smukhina Date: 2009-05-11 07:20:45 -0400 (Mon, 11 May 2009) New Revision: 15151 Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/modules/modules_3.png branches/jbosstools-3.0.x/as/docs/reference/en/images/modules/modules_4.png branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/dnd_toJBossServerView.png branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/filesets1.png branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/filesets3.png branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/filesets4.png branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_1.png branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_11.png branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_12.png branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_14.png branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_15.png branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_16.png branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_2.png branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_8.png branches/jbosstools-3.0.x/as/docs/reference/en/images/quick_start/quick_start_1.png branches/jbosstools-3.0.x/as/docs/reference/en/images/quick_start/quick_start_2.png branches/jbosstools-3.0.x/as/docs/reference/en/images/quick_start/quick_start_3.png branches/jbosstools-3.0.x/as/docs/reference/en/images/quick_start/quick_start_5.png branches/jbosstools-3.0.x/as/docs/reference/en/images/tptp_support/tptp_support_1.png branches/jbosstools-3.0.x/as/docs/reference/en/modules/modules.xml branches/jbosstools-3.0.x/as/docs/reference/en/modules/perspective.xml branches/jbosstools-3.0.x/as/docs/reference/en/modules/quick_start.xml branches/jbosstools-3.0.x/as/docs/reference/en/modules/runtimes_servers.xml branches/jbosstools-3.0.x/as/docs/reference/en/modules/webtools.xml branches/jbosstools-3.0.x/as/docs/reference/pom.xml Log: https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/modules/modules_3.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/modules/modules_4.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/dnd_toJBossServerView.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/filesets1.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/filesets3.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/filesets4.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_1.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_11.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_12.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_14.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_15.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_16.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_2.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/perspective/perspective_8.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/quick_start/quick_start_1.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/quick_start/quick_start_2.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/quick_start/quick_start_3.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/quick_start/quick_start_5.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/images/tptp_support/tptp_support_1.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/as/docs/reference/en/modules/modules.xml =================================================================== --- branches/jbosstools-3.0.x/as/docs/reference/en/modules/modules.xml 2009-05-11 09:41:15 UTC (rev 15150) +++ branches/jbosstools-3.0.x/as/docs/reference/en/modules/modules.xml 2009-05-11 11:20:45 UTC (rev 15151) @@ -11,7 +11,7 @@ <title>Deploying on the Package Explorer</title> <para>On the package explorer it is possible to publish either a project to a server or just - a signal file. Let&apos;s look at how to do this.</para> + a single file. Let&apos;s look at how to do this.</para> <section id="run_on_server_wizard"> <title>Deploying with Run On Server Wizard</title> <para> The first WTP method is to right-click on a project, such as a Dynamic Web @@ -157,8 +157,7 @@ <para>In the <property>Project Archives View</property> you can right-click on any declared archive and select the <emphasis> <property>Publish To Server</property> - </emphasis> element. For more on this subject, see <link linkend="PublishToServer" - >Publishing to Server</link> in the Project Archives View section.</para> + </emphasis> element. For more on this subject, see <link linkend="PublishToServer">Publishing to Server</link> in the Project Archives View section.</para> <figure> <title>Publish to Server</title> <mediaobject> @@ -176,7 +175,7 @@ <property>.class</property> </emphasis> file, is to enable the builder for that project. This is done by either changing the global preferences for the <property>Archives View</property>, or by - enabling project-specific preferences and ensuring the builder is on.</para> + enabling project-specific preferences and ensuring the builder is on.</para> <para>The last chapter covers a variety of methods on how you can deploy needed modules onto a server.</para> </section> Modified: branches/jbosstools-3.0.x/as/docs/reference/en/modules/perspective.xml =================================================================== --- branches/jbosstools-3.0.x/as/docs/reference/en/modules/perspective.xml 2009-05-11 09:41:15 UTC (rev 15150) +++ branches/jbosstools-3.0.x/as/docs/reference/en/modules/perspective.xml 2009-05-11 11:20:45 UTC (rev 15151) @@ -45,9 +45,9 @@ <section id="jbossserver_view_toolbar"> <title>JBoss Server View Toolbar</title> <para>In the right top corner of the <property>JBoss Server View</property> there is a - special toolbar which provides a quick access to starting a server (in debug mode, - run mode, or profile mode), restarting a server, stopping a server, publishing to a - server and a possibility to clean a server.</para> + special toolbar which provides a quick access to starting a server (in the debug mode, + run mode, or profile mode), restarting a server, stopping a server and a possibility to publish to a + server.</para> <figure> <title>The JBoss Server View Toolbar</title> @@ -74,12 +74,7 @@ </emphasis> button will republish any modules where it has determined the workspace is out of sync with the server. It will attempt to do an incremental publish if it turns out that the module in question is capable of doing one.</para> - - - <para>Press <emphasis> - <property>Clean</property> - </emphasis> if you need to clean projects published on the server, i.e. remove - invalid resources from the server.</para> + </section> <section id="jbossserver_view_structure"> @@ -249,22 +244,13 @@ <para>Publish</para> </entry> <entry> - <para>The action for synching the publish information between the - server and workspace</para> + <para>The action for synchronizing the publish information between + the server and workspace</para> </entry> </row> <row> <entry> - <para>Clean</para> - </entry> - <entry> - <para>The option for complete redeploying the resources</para> - </entry> - </row> - - <row> - <entry> <para>Explore</para> </entry> <entry> @@ -405,7 +391,7 @@ </emphasis> category allows you to quickly browse to descriptor files in your server's deploy directory and check or change the values. Basically, <emphasis> <property>XML Configuration</property> - </emphasis> includes XML XPaths where a xpath is a path used to access some + </emphasis> includes XML XPaths where an xpath is a path used to access some specific part of an xml document. </para> <note> @@ -485,7 +471,7 @@ <para>The goal here is to get an end result where the XPath matches up with a necessary property. With that in mind, let&apos;s look how it works. If the property you want to reach is the value of the <emphasis>name</emphasis> - attribute in the element <emphasis>&lt;mbean&gt;</emphasis>, then your <emphasis> + attribute in the element <code>&lt;mbean&gt;</code>, then your <emphasis> <property>XPath Patten</property> </emphasis>should end with <emphasis>mbean</emphasis> and your <emphasis> <property>Attribute Name</property> @@ -523,7 +509,7 @@ </tip> <para>Then, on the other hand, if your desired field is the text of an element - <emphasis>&lt;description&gt;</emphasis>, your <emphasis> + <code>&lt;description&gt;</code>, your <emphasis> <property>XPath Patten</property> </emphasis> should end with <emphasis>description</emphasis> and <emphasis> <property>Attribute Name</property> @@ -548,8 +534,8 @@ <para>Starting from 2.0.0.CR2 version of <property>JBoss AS Tools</property> the <property>JBoss Server View</property> supports drag-n-drop of deployable and - runnable projects/resources.</para> - + runnable projects/resources.</para> + <figure> <title>Dragging to the JBoss Server View</title> <mediaobject> @@ -558,9 +544,9 @@ </imageobject> </mediaobject> </figure> - + <para>With drag-n-drop the following actions can be performed:</para> - + <itemizedlist> <listitem> <para>dragging a project to a server will deploy it to the server and run it by @@ -578,9 +564,9 @@ <listitem> <para>dragging a deployable resource (i.e. a datasource (<emphasis> - <property>-ds.xml</property></emphasis>) file that has - been made deployable) will simply deploy that resource directly to the - server</para> + <property>-ds.xml</property> + </emphasis>) file that has been made deployable) will simply deploy that + resource directly to the server</para> </listitem> </itemizedlist> @@ -704,9 +690,9 @@ <tip> <title>Tip:</title> <para>On the figure you can see that a username/password is available in the UI when - configuring the server. If you get an SecurityException when trying to launch - the server, it is most likely because your server is protected and hence you - need to fill the username/password fields with appropriate values.</para> + configuring the server. If you get a SecurityException when trying to launch the + server, it is most likely because your server is protected and hence you need to + fill the username/password fields with appropriate values.</para> </tip> <para>It should be pointed out that our server adapter by default tries to automatically @@ -754,7 +740,8 @@ modify the server&apos;s launch configuration. It&apos;s just after clicking <emphasis> <property>Open launch configuration</property> </emphasis> link. In the open window there are the tabs for setting command line - arguments and other things that are relevant to launching the server.</para> + arguments, classpaths and other things that are relevant to launching the + server.</para> <figure> <title>Launch Configuration Properties</title> @@ -769,6 +756,49 @@ url="http://docs.jboss.org/jbossas/guides/installguide/r1/en/html/st... Server</property>.</para> + + <note> + <title>Note:</title> + <para>Please note, that the Launch Configurations for JBoss Servers are enough + strict in enforcing the configured values in the server in order to avoid + inconsistencies between server&apos;s and their configured runtime.</para> + + <para>For example, if you change the launch configuration program arguments to + <emphasis>&quot;-c myConfig&quot;</emphasis> but do not change the + targeted runtime configuration, then your program arguments will be ignored. The + server runtime &quot;wins&quot; so to speak. This ensures consistency + and if you change the location of the runtime, your launch configurations will + automatically pick that up.</para> + + <para>Values are not controlled by the server and its runtime setup will be passed + on unaltered.</para> + </note> + + <para>Until 3.0.0.GA release of <property>JBoss Tools</property>, the servers classpath was readonly, but that caused + problems for users wanting to add their own jars in the startup classpath. That is + relevant if you need to patch the server, add a custom charset or other tweaks that + require early access to the classpath.</para> + + <para>Now all servers have a custom &apos;server runtime classpath + container&apos;, which is there by default and point to the default jars in + JBoss. You can now adjust the classpath. Then just make sure this container is there + if you want the classpath to be picked up.</para> + + <figure> + <title>Server Classpaths</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/server_classpaths.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>If for some reason you have a launch configuration without this container, <emphasis> + <property>Restore + Default Entries</property></emphasis> should add it properly. Also, <emphasis> + <property>Restore + Default Entries</property></emphasis> will also remove any + extra entries you added yourself.</para> </section> <section> @@ -982,11 +1012,11 @@ pattern. As you type in either of these fields, the preview viewer should update itself with which files are matched.</para> - <para>You can create a Fileset with flattenning or without it. Look at the - difference on the figure below.</para> + <para>You can create a Fileset with flattening or without it. Look at the difference + on the figure below.</para> <figure> - <title>The FileSet with flattenning and without it</title> + <title>The FileSet with flattening and without it</title> <mediaobject> <imageobject> <imagedata fileref="images/perspective/perspective_24a.png"/> Modified: branches/jbosstools-3.0.x/as/docs/reference/en/modules/quick_start.xml =================================================================== --- branches/jbosstools-3.0.x/as/docs/reference/en/modules/quick_start.xml 2009-05-11 09:41:15 UTC (rev 15150) +++ branches/jbosstools-3.0.x/as/docs/reference/en/modules/quick_start.xml 2009-05-11 11:20:45 UTC (rev 15151) @@ -23,11 +23,9 @@ <property>stop</property> </emphasis> it or <emphasis> <property>restart</property> - </emphasis> it, <emphasis> + </emphasis> it and <emphasis> <property>publish</property> - </emphasis> to the server, <emphasis> - <property>clean</property> - </emphasis> the server.</para> + </emphasis> to the server.</para> <figure> <title>JBoss Server Toolbar</title> Modified: branches/jbosstools-3.0.x/as/docs/reference/en/modules/runtimes_servers.xml =================================================================== --- branches/jbosstools-3.0.x/as/docs/reference/en/modules/runtimes_servers.xml 2009-05-11 09:41:15 UTC (rev 15150) +++ branches/jbosstools-3.0.x/as/docs/reference/en/modules/runtimes_servers.xml 2009-05-11 11:20:45 UTC (rev 15151) @@ -150,7 +150,7 @@ <row> <entry> - <para>jRE</para> + <para>JRE</para> </entry> <entry> <para>The proper Java Runtime Environment. Because of the open-source nature of @@ -263,7 +263,10 @@ <property>Finish</property> </emphasis> to complete the process of the server creation.</para> <para>Now that we&apos;ve created our runtimes and servers, we can dwell on all services - and tools that JBoss Server Manager provides.</para> + and tools that JBoss Server Manager provides.</para> + + <para>We hope, this guide helped you to get started with the JBoss Tools server manager. Besides, for additional information you are welcome on <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... forum</ulink>.</para> </section> </section> Modified: branches/jbosstools-3.0.x/as/docs/reference/en/modules/webtools.xml =================================================================== --- branches/jbosstools-3.0.x/as/docs/reference/en/modules/webtools.xml 2009-05-11 09:41:15 UTC (rev 15150) +++ branches/jbosstools-3.0.x/as/docs/reference/en/modules/webtools.xml 2009-05-11 11:20:45 UTC (rev 15151) @@ -57,7 +57,7 @@ <para> The first page of most WTP projects allows you to target a specific runtime, representing a server's library location. It will also provide you the ability to add - this project to an EAR project, and select a pre-selected default set of facets, called + this project to an EAR project, and select a preselected default set of facets, called a configuration, rather than manually select each facet you might want.</para> <para> Selecting the runtime, again, allows the project to install the proper classpaths to the project so it knows what code to compile against.</para> Modified: branches/jbosstools-3.0.x/as/docs/reference/pom.xml =================================================================== --- branches/jbosstools-3.0.x/as/docs/reference/pom.xml 2009-05-11 09:41:15 UTC (rev 15150) +++ branches/jbosstools-3.0.x/as/docs/reference/pom.xml 2009-05-11 11:20:45 UTC (rev 15151) @@ -88,6 +88,12 @@ <version>1.1.0</version> <type>jdocbook-style</type> </dependency> + <dependency> + <groupId>org.apache.xmlgraphics</groupId> + <artifactId>fop</artifactId> + <version>0.95</version> + </dependency> + </dependencies> <configuration>