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's look at how to do this.</para>
+ a single file. Let'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'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><mbean></emphasis>, then your <emphasis>
+ attribute in the element
<code><mbean></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><description></emphasis>,
your <emphasis>
+ <code><description></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's launch configuration. It'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...
here</ulink> to find parameters which can be specified for
<property>JBoss
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's and their configured
runtime.</para>
+
+ <para>For example, if you change the launch configuration program
arguments to
+ <emphasis>"-c myConfig"</emphasis>
but do not change the
+ targeted runtime configuration, then your program arguments will be
ignored. The
+ server runtime "wins" 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 'server runtime classpath
+ container', 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'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&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>