From jbosstools-commits at lists.jboss.org Sun Jan 30 22:00:33 2011 Content-Type: multipart/mixed; boundary="===============8766582324051661114==" MIME-Version: 1.0 From: jbosstools-commits at lists.jboss.org To: jbosstools-commits at lists.jboss.org Subject: [jbosstools-commits] JBoss Tools SVN: r28741 - trunk/as/docs/reference/en-US. Date: Sun, 30 Jan 2011 22:00:32 -0500 Message-ID: <201101310300.p0V30WZY028312@svn01.web.mwc.hst.phx2.redhat.com> --===============8766582324051661114== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: mcaspers Date: 2011-01-30 22:00:32 -0500 (Sun, 30 Jan 2011) New Revision: 28741 Modified: trunk/as/docs/reference/en-US/perspective.xml Log: General Updates Modified: trunk/as/docs/reference/en-US/perspective.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/as/docs/reference/en-US/perspective.xml 2011-01-31 02:22:45 UTC (= rev 28740) +++ trunk/as/docs/reference/en-US/perspective.xml 2011-01-31 03:00:32 UTC (= rev 28741) @@ -420,7 +420,7 @@ what its current value is. = - By right-clicking on the XML Configuration node = you can create a new category. Besides, context menu for XML Configuration category makes possible to disab= le it. You can disable any category in the bottom part of the Ser= vers view. Look for them in the Inactive Categories afterwards to re-enable. + By right-clicking on the XML Configuration node = you can create a new category. Besides, context menu for XML Conf= iguration category makes possible to disable it. You can disable= any category in the bottom part of the Servers view. = Look for them in the Inactive Categories afterwards to= re-enable. =
@@ -432,11 +432,9 @@
= - By right-clicking on - Ports - or any other category in - XML Configuration - , you can create a new xpath. + + By right-clicking on the Ports category, or any = other category in XML Configuration, you can create a = new XPath. + =
Adding New XPath @@ -458,14 +456,9 @@
= - 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 name - attribute in the element <mbean>, t= hen your - XPath Patten - should end with mbean and your - Attribute Name - should be name like on the next figu= re. + + 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 name attrib= ute in the element <mbean>, then your XPath Pa= tten should end with mbean and your Attri= bute Name should be name, as demonstrated in the ne= xt figure. + = @@ -492,20 +485,14 @@ = - + Tip: - Notice, when you type the fields autocomplete to help you locat= e exactly - what xpath you're looking for. - + Notice when you type the fields autocomplete to help you locate= exactly what XPath you're looking for. + = - Then, on the other hand, if your desired field is the text of an= element - <description>, your - XPath Patten - should end with description and - Attribute Name - field should be left blank. When finished, click - Preview - to see how many matches you have for that particular XPat= h. + + If your desired field is the text of an element <description= >, your XPath Patten should end with d= escription and Attribute Name field should be l= eft blank. When finished, click the Preview button t= o see how many matches are found for that particular XPath. + =
XPath Preview @@ -522,9 +509,9 @@
Drag-n-Drop to Servers view = - Starting from 2.0.0.CR2 version of JBoss AS Tools the - Servers view supports drag-n-drop= of deployable and - runnable projects/resources. + + Starting from JBoss AS Tools 2.0.0.CR2 the = Servers view supports drag-n-drop of deployable and ru= nnable projects and resources. + =
Dragging to the Servers view @@ -539,48 +526,37 @@ = - dragging a project to a server will deploy it to the server and= run it by - showing the main page in a browser + Dragging a project to a server will deploy it to the server and= run it by showing the main page in a browser. = - dragging an - .xhtml - file from - WebContent - will do the same and show the corresponding page in a - browser + + Dragging an .xhtml file from the WebC= ontent folder will do the same and show the corresponding page i= n a browser. + = - dragging a deployable resource (i.e. a datasource ( - -ds.xml - ) file that has been made deployable) will simply deploy = that - resource directly to the server + + Dragging a deployable resource (i.e. a datasource -ds.xml<= /filename> file that has been made deployable) will simply deploy that reso= urce directly to the server. + = - In short, the feature does the same thing as if you used the - Run On Server - option or - Add and Remove Projects - option in the context menu of the server. + + In short, the feature does the same thing as if you used the Run On Server or Add and Remove Projects option in the context menu of the server. +
=
Server Log View = - You can monitor the current server behavior with the help of the = Server - Log. To open a server in the Serv= er Log view you - should right-click on the server and follow to - Open in > Server Log. + + You can monitor the current server behavior with the help of the Server Log. To open a server in the Server Log vi= ew you should right-click on the server and follow to Open inServer Log. = - The - Server Log - shows relevant information to your server's startup, = shutdown, - and publish processes. This allows you to keep an eye on w= hat's going on - (such as automatic incremental deployment if you have it e= nabled). + + The Server Log view shows relevant information to= your server's startup, shutdown, and publish processes. This allows y= ou to keep an eye on what's going on (such as automatic incremental de= ployment if you have it enabled). + =
Event Log Actions @@ -591,8 +567,7 @@
= - The Server Log toolbar contains several icon= s that perform - the following actions: + The Server Log view toolbar contains several= icons that perform the following actions: = Server Log Toolbar Icons @@ -618,7 +593,7 @@ Export Log - Possibility to export the log into a text file + Allows you to export the log into a text file = @@ -627,7 +602,7 @@ Clear Log Viewer - The option clears the current server log + This option clears the current server log = @@ -666,8 +641,7 @@ =
Server Editor - By double-clicking on any server, an editor window will appear al= lowing you to - edit parts of that server. + By double-clicking on any server, an window will appear allowing = you to edit the servers settings. =
Preferences Page for the Chosen Server @@ -678,28 +652,20 @@
= - + Tip: - On the figure you can see that a username/password is available = in the UI when - configuring the server. If you get a SecurityException= when trying to launch the - server, it is most likely because your server is prote= cted and hence you need to - fill the username/password fields with appropriate val= ues. - + + On the figure you can see that the username and password fields are a= vailable. If you get a SecurityException when trying to launch the server, = it is most likely because your server is protected, which requires that you= need to fill the username and password fields with appropriate values. + + = - Under the - Publishing - section it' possible to disable/inable the automatic = publishing of the changes in the workspace. + + Under the Publishing section it is possible to di= sable or enable the automatic publishing of the changes in the workspace. + = - It should be pointed out that our server adapter by default tries= to automatically - detect the ports it needs for integrating with a JBoss Server. - Sometimes it can though be relevant to override this autom= atic detection if you are - using some custom configuration. For this purposes the - Server Ports - section in the Server editor is provi= ded where the - port settings are configurable. Click the - Configure... - link to bring up the wizard for adjusting the settings for= the - ports. + + It should be pointed out that the server adapter tries to automaticall= y detect the ports it needs for integrating with a JBoss Server by default. Sometimes it is necessary to override this automatic = detection if you are using a custom configuration. The Server Por= ts section in the Server editor provides fi= elds to customize port settings. Click the Configure... link to bring up the wizard for adjusting the settings for the ports. + =
Server Ports Preferences @@ -710,9 +676,7 @@
= - Press - Edit XPath - button for the chosen port to configure its XPath's values= . + Click the Edit XPath button for the chosen p= ort to configure its XPath's values. =
XPath Pattern for a Server Port @@ -723,26 +687,18 @@
= - In the Server editor you are able to edit th= e timeouts and the server pollers to use. + In the Server editor you are able to edit th= e timeouts and the server pollers to use. = Note: - By default, the Startup poller is set to JMX Poller (see the - Server Polling - section). If you change the Startup poller - to Timeout Poller (it may need in case, for example, you&a= pos;re using the minimal configuration for your server), this will do no po= lling at all and will only set the server - state to - "Started" - after your startup timeout is reached. + + By default, the Startup poller is set to JMX Poller. If you change th= e Startup poller to Timeout Poller (which may be required if you are using = the minimal configuration for your server), this will do no polling at all = and will only set the server state to "Started" after your startup timeout is reached. + = - Server editor makes it also possible to - modify the server's launch configuration. It's j= ust after clicking - Open launch configuration - link. In the open window there are the tabs for setting co= mmand line - arguments, main, classpaths and other things that are rele= vant to launching the - server. + The Server editor window also allows you to modif= y the server's launch configuration. The settings is available by clic= king the the Open launch configuration link. The resul= ting window provides tabs for setting command line arguments, main, classpa= ths and other things that are relevant to launching the server. + =
Launch Configuration Properties @@ -755,37 +711,34 @@ = = The first tab shows the Jboss server arguments - Look up AS Installation Guide to find p= arameters which can be specified for JBoss - Server. + + See the AS Installation Guide to find the pa= rameters that can be specified for JBoss Server. + = Note: - Please note, that the Launch Configurations for JBoss Servers ar= e enough - strict in enforcing the configured values in the serve= r in order to avoid - inconsistencies between server's and their config= ured runtime. + + Please note that the values in the Launch Configurations for JBoss Se= rvers are strictly enforced in order to avoid inconsistencies between serve= r's and their configured runtime. + = - For example, if you change the launch configuration program argu= ments to - "-c myConfig" but d= o not change the - targeted runtime configuration, then your program argu= ments will be ignored. The - server runtime "wins" so to speak. This ensu= res consistency - and if you change the location of the runtime, your la= unch configurations will - automatically pick that up. + + For example, if you change the launch configuration program arguments= to "-c myConfig" but do not change the targeted run= time configuration, then your program arguments will be ignored. The config= uration of the server runtime "wins" so to speak. This ensures co= nsistency and if you change the location of the runtime, your launch config= urations will automatically pick that up. + = - Values are not controlled by the server and its runtime setup wi= ll be passed - on unaltered. + Values are not controlled by the server and its runtime setup wi= ll be passed on unaltered. = - On the second tab you find the main class used for launching JBos= s AS (default is org.jboss.Main), you can change it, if necessary. + + On the second tab you find the main class used for launching JBoss AS = (the default is org.jboss.Main). this value can be changed if = necessary. + = - Until 3.0.0.GA release of JBoss Tools, the s= ervers classpath - was readonly, but that caused problems for users wanting t= o add their own jars in - the startup classpath. That is relevant if you need to pat= ch the server, add a - custom charset or other tweaks that require early access t= o the classpath. + + Until JBoss Tools 3.0.0.GA the servers classpath = was read only, 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 se= rver, add a custom charset or other tweaks that require early access to the= classpath. + = - Now all servers have a custom 'server runtime classpath - container', which is there by default and point to th= e default jars in - JBoss. You can now adjust the classpath. Then just make su= re this container is there - if you want the classpath to be picked up. + + Now all servers have a custom 'server runtime classpath container= ', which is there by default and point to the default JARs in JBoss. Y= ou can now adjust the classpath. Then just make sure this container is ther= e if you want the classpath to be picked up. + =
Server Classpaths --===============8766582324051661114==--