[jbosstools-commits] JBoss Tools SVN: r20928 - in trunk/jsf/docs/userguide/en-US: images/preferences and 1 other directory.

Author: smukhina Date: 2010-03-19 08:40:44 -0400 (Fri, 19 Mar 2010) New Revision: 20928 Modified: trunk/jsf/docs/userguide/en-US/images/preferences/preferences_2.png trunk/jsf/docs/userguide/en-US/preferences.xml Log: https://jira.jboss.org/jira/browse/JBDS-1144 - Packaging Archives tree item is not in Preferences Tree - fixed Modified: trunk/jsf/docs/userguide/en-US/images/preferences/preferences_2.png =================================================================== (Binary files differ) Modified: trunk/jsf/docs/userguide/en-US/preferences.xml =================================================================== --- trunk/jsf/docs/userguide/en-US/preferences.xml 2010-03-19 11:49:17 UTC (rev 20927) +++ trunk/jsf/docs/userguide/en-US/preferences.xml 2010-03-19 12:40:44 UTC (rev 20928) @@ -1,1272 +1,1295 @@ -<?xml version='1.0' encoding='UTF-8'?> -<chapter id="preferences" xreflabel="preferences"> - <?dbhtml filename="preferences.html"?> - <title>JBoss Tools Preferences</title> - - <para>Configuring the various <property>JBoss Developer Studio</property> features is done via - the <property>Preferences</property> screen by selecting <emphasis> - <property>Window &gt; Preferences &gt; JBoss Tools</property> - </emphasis> from the menu bar.</para> - <figure> - <title>Preferences are included in this dialog.</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_1.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>From this screen, you can select these more specific sets of <property>JBoss Tools - preferences</property>:</para> - - <itemizedlist> - <listitem> - <para> - <link linkend="PackagingArchives">Packaging Archives</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="Editors">Editors</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="VisualPageEditor2">Visual Page Editor</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="el_variables">El Variables</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="JSF">JSF</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="JSFPage">JSF Page</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="JSFPropject">JSF Project</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="JSFFlowDiagram">JSF Flow Diagram</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="Seam">Seam</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="SeamValidator">Seam Validator</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="Struts">Struts</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="struts_automation">Struts Automatic</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="Plug-inInsets">Plug-in Insets</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="ResourceInsets">Resource Insets</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="StrutsCustomization">Struts Customization</link> - </para> - </listitem> - - - <listitem> - <para> - <link linkend="StrutsProject">Struts Project</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="StrutsSupport">Struts Support</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="StrutsPages">Struts Pages</link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="StrutsFlowDiagram">Struts Flow Diagram</link> - </para> - </listitem> - - - <listitem> - <para> - <link linkend="tiles_diagram">Tiles Diagram</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="Verification">Verification</link> - </para> - </listitem> - </itemizedlist> - - <para>The <property>Preferences</property> dialog <emphasis>( <property>Window &gt; - Preferences</property>) </emphasis> also allows to adjust settings for <link - linkend="JBossServerPreferences">JBoss Server</link> and <link linkend="XDoclet" - >XDoclet</link> module.</para> - - <section id="PackagingArchives"> - <?dbhtml filename="PackagingArchives.html"?> - <title>Packaging Archives</title> - - <para>Fallow to <emphasis> - <property>JBoss Tools > Packaging Archives</property> - </emphasis> to open the page for changing Packaging Archives preferences.</para> - <para>Here you can determine settings for Project Packages view and core preferences.</para> - - <figure> - <title>Packaging Archives</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_2.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>The next table lists all available preferences for Packaging Archives and their - description.</para> - - <table> - <title>Packaging Archives Preferences</title> - - <tgroup cols="3"> - - <colspec colnum="1" align="left" colwidth="2*"/> - <colspec colnum="2" colwidth="4*"/> - <colspec colnum="3" colwidth="2*"/> - - <thead> - <row> - <entry>Option</entry> - <entry>Description</entry> - <entry>Default</entry> - </row> - </thead> - - <tbody> - <row> - <entry>Enable incremental builder</entry> - <entry>Uncheck this option if you don&apos;t want to enable incremental - builder for your resources</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show full output path next to packages</entry> - <entry>This option allows you to show or hide an output path next to - packages - <!--(<link linkend="full_outputpath_for_packages">See the - figure</link>)-->.</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show the full root directory of filesets</entry> - <entry>If on, the full root directory is displayed next to filesets. - Otherwise, it&apos;s hidden - <!--(<link - linkend="full_rootdir_for_filesets">See the figure</link>)-->.</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show project at the root</entry> - <entry>This option allows you to choose whether to display a project name at - the root of the packages or not. When checked, &apos;Show all - projects that contain packages&apos; is enabled - <!--(<link - linkend="project_at_the_root">See the figure</link>)-->.</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show all projects that contain packages</entry> - <entry>Selecting this setting enables the Projects Archiving view to show or - hide all projects that contain packages. The option is available when - the previous one is checked.</entry> - <entry>Off</entry> - </row> - </tbody> - </tgroup> - </table> - <!-- - <figure id="full_outputpath_for_packages"> - <title>Show Full Output Path next to Packages</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_3.png"/> - </imageobject> - </mediaobject> - </figure> - - <figure id="full_rootdir_for_filesets"> - <title>Show the Full Root Directory of Filesets</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_4.png"/> - </imageobject> - </mediaobject> - </figure> - - <figure id="project_at_the_root"> - <title>Show Project at the root</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_5.png"/> - </imageobject> - </mediaobject> - </figure> ---> - - </section> - - <!--section id="CodeAssist"> - <?dbhtml filename="CodeAssist.html"?> - <title>CodeAssist</title> - <para>Select <emphasis> - <property>JBoss Tools > XDoclet > Code Assist</property> - </emphasis> to see Code Assist preference page.</para> - <para>Here is what the Code Assist preference page looks like: </para> - <figure> - <title>CodeAssist</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_2.png"/> - </imageobject> - </mediaobject> - </figure> - </section--> - - <section id="Editors"> - <?dbhtml filename="Editors.html"?> - <title>Editors</title> - <para>To adjust settings common for all editors supplied with <property>JBoss Developer - Studio</property> you should select <emphasis> - <property>JBoss Tools > Web > Editors</property>.</emphasis></para> - - <figure> - <title>Editors</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_6.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>On the Editors page the following preferences are available:</para> - - <table> - - <title>Editors Preferences</title> - <tgroup cols="3"> - - <colspec colnum="1" align="left" colwidth="2*"/> - <colspec colnum="2" colwidth="4*"/> - <colspec colnum="3" colwidth="2*"/> - - <thead> - <row> - <entry>Option</entry> - <entry>Description</entry> - <entry>Default</entry> - </row> - </thead> - - <tbody> - <row> - <entry>Always use JBoss Tools editors with Open option</entry> - <entry/> - <entry>On</entry> - </row> - - <row> - <entry>Show warning when project has no JBoss Tools capabilities</entry> - <entry>Check this option to be sure that any JBoss Tools editor fully - available for a particular type of file. If no, you&apos;ll be - warned about this.</entry> - <entry>On</entry> - </row> - - <row> - <entry>Use Source tab as a default for multi-tab editors</entry> - <entry>If on, an editor will open the files in the Source view by - default</entry> - <entry>Off</entry> - </row> - </tbody> - </tgroup> - </table> - - </section> - - <section id="VisualPageEditor2"> - <?dbhtml filename="VisualPageEditor.html"?> - <title>Visual Page Editor</title> - <para><emphasis> - <property>JBoss Tools &gt; Web &gt; Editors &gt; Visual Page - Editor</property> - </emphasis> screen allows you to control some aspects of the behavior of the - <property>Visual Page Editor</property> (VPE) for JSF/HTML files.</para> - <figure> - <title>Visual Page Editor</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_7.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>The next table lists the possible settings that you can adjust on the - <property>General tab</property> of the VPE Preferences page.</para> - - - <table> - - <title>VPE Preferences</title> - <tgroup cols="3"> - - <colspec colnum="1" align="left" colwidth="2*"/> - <colspec colnum="2" colwidth="4*"/> - <colspec colnum="3" colwidth="2*"/> - - <thead> - <row> - <entry>Option</entry> - <entry>Description</entry> - <entry>Default</entry> - </row> - </thead> - - <tbody> - <row> - <entry>Show border for unknown tags</entry> - <entry>The option allows to place the border around unknown tags or undo - this</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show non-visual tags</entry> - <entry>Check this box, if you want the editor shows non-visual elements on - the page you're editing</entry> - <entry>Off</entry> - </row> - - <row> - <entry>Show selection tag bar</entry> - <entry>The option allows to show/hide the Selection Bar</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show text formatting bar</entry> - <entry>Check this box in order to show/hide the Text Formatting bar</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show resource bundles usage as EL expressions</entry> - <entry>If the option is checked, the editor will show EL expressions instead - of the resource values</entry> - <entry>Off</entry> - </row> - - <row> - <entry>Ask for tag attributes during tag insert </entry> - <entry>Having this option off, the dialog with possible attributes for - inserting tag won&apos;t appear if all its attributes are optional</entry> - <entry>On</entry> - </row> - - <row> - <entry>Ask for confirmation when closing the Selection Bar</entry> - <entry>Check this box if you don&apos;t want the confirmation window - appears when closing the Selection Bar</entry> - <entry>On</entry> - </row> - - <row> - <entry>Select the default active editor&apos;s tab</entry> - <entry>The option provides possibility to choose one of the following - views - Visual/Source, Source or Preview, as default when opening the - editor</entry> - <entry>Visual/Source</entry> - </row> - <row> - <entry>Visual/Source editors splitting</entry> - <entry>The option allows to choose one of the following - Visual,Source layouts - Vertical Source on top, Vertical Visual on top,Horizontal Source to the left or Horizontal Visual to the left, - as a default one when opening the Visual/Source view</entry> - <entry>Vertical splitting with Source Editor on the top</entry> - </row> - <row> - <entry>Size of the Visual Editor pane (0 – 100%)</entry> - <entry>With the help of this scroll bar you can adjust the percentage rating - between the Source and Visual modes of the Visual/Source view</entry> - <entry>50%</entry> - </row> - </tbody> - </tgroup> - </table> - - <para>On the <property>Templates tab</property> you can edit or remove <link - linkend="vpe_templating">VPE templates</link>.</para> - <figure> - <title>Visual Page Editor Templates</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_8.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Select a template for editing from the available list and press <emphasis> - <property>Edit</property> - </emphasis> button. It will pick up the <link linkend="template_dialog">Template - dialog</link> where you can adjust new settings.</para> - </section> - - <section id="el_variables"> - <?dbhtml filename="el_variables.html"?> - <title>El Variables</title> - <para>To specify necessary EL variables globally, i. e. for all projects and resources in - your workspace, you should go to <emphasis> - <property>JBoss Tools > Web > El Variables</property>. </emphasis></para> - - <figure> - <title>El Variables</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_9.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Click <emphasis> - <property>Add...</property> - </emphasis> to set value for a new EL variable. In the appeared wizard you should - specify the global values and press <emphasis> - <property>Finish</property> - </emphasis>.</para> - - <figure> - <title>Adding a Global El Variable</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_10.png"/> - </imageobject> - </mediaobject> - </figure> - - <tip> - <title>Tip:</title> - <para>If you specify an equal variable in <link linkend="el_exp_para">Substitute EL - expressions dialog</link> and in Preference EL dialog, variable from preference dialog will - have priority.</para> - </tip> - </section> - <!--section id="JBossServers"> - <?dbhtml filename="JBossServers.html"?> - <title>JBoss Servers</title> - <para>The following preferences can be changed on the <emphasis> - <property>JBoss Tools > JBoss Servers</property> - </emphasis> preference page.</para> - <para>Here is what the JBoss Servers preference page looks like:</para> - <figure> - <title>JBoss Servers</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_4.png"/> - </imageobject> - </mediaobject> - </figure> - </section--> - - <section id="JSF"> - <?dbhtml filename="JSF.html"?> - <title>JSF</title> - <para>Select <emphasis> - <property>JBoss Tools &gt; Web &gt; JSF</property> - </emphasis> to get to the JSF Project specific preferences.</para> - <figure> - <title>JSF</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_11.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="JSFPage"> - <?dbhtml filename="JSF Page.html"?> - <title>JSF Pages</title> - <para>By selecting <emphasis> - <property>JBoss Tools &gt; Web &gt; JSF &gt; JSF Pages</property> - </emphasis> you can add jsf pages or remove existing ones.</para> - <figure> - <title>JSF Page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_12.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="JSFPropject"> - <?dbhtml filename="JSFPropject.html"?> - <title>JSF Project</title> - <para>Select <emphasis> - <property>JBoss Tools > Web > JSF > Project</property> - </emphasis> to see JSF Project preferences page.</para> - <para>On the <emphasis> - <property>New Project</property> - </emphasis> tab you can set default values for New JSF Project wizard:</para> - - <itemizedlist> - <listitem> - <para><emphasis> - <property>Version</property> - </emphasis> for setting the default JSF Environment</para> - </listitem> - - <listitem> - <para><emphasis> - <property>Project Template</property> - </emphasis> so as <property>New JSF Project wizard</property> shows this - template as default for the chosen JSF Environment</para> - </listitem> - - <listitem> - <para><emphasis> - <property>Project Root</property> - </emphasis> for specifying default location for a new JSF project</para> - <para>If you check <emphasis> - <property>Use Default Path</property> - </emphasis> here, this box will be also checked in the <property>New JSF Project - wizard</property>.</para> - </listitem> - - <listitem> - <para><emphasis> - <property>Servlet Version</property> - </emphasis> for setting the default Servlet version of a new JSF project</para> - <para>Here it&apos;s also possible to define whether to register Web Context in <emphasis> - <property>server.xml</property> - </emphasis> while organizing a new project or not. Check the proper box in order - to do that.</para> - </listitem> - </itemizedlist> - - <figure> - <title>New JSF Project Preferences</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_13.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>On the <emphasis> - <property>Import Project</property> - </emphasis> tab in the JSF Project screen you can determine the default Servlet version - for the Import JSF Project - wizard and also whether to register Web Context in <emphasis> - <property>server.xml</property> - </emphasis> or not.</para> - - <figure> - <title>Import JSF Project Preferences</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_14.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="JSFValidator"> - <?dbhtml filename="JSFValidator.html"?> - <title>JSF Validator</title> - <para>Select <property>JBoss Tools > Web > JSF > Validator</property> page to configure the validator behavior. On this page you can change the severity level for different jsf problems which are controlled by validator.</para> - <figure> - <title>JSF Validator</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_14a.png" /> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="JSFFlowDiagram"> - <?dbhtml filename="JSFFlowDiagram.html"?> - <title>JSF Flow Diagram</title> - <para>Selecting <emphasis> - <property>JBoss Tools > Web > Editors > JSF Flow Diagram</property> - </emphasis> allows you to specify some aspects of the Diagram mode of the JSF - configuration file editor.</para> - - <figure> - <title>JSF Flow Diagram</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_15.png" scale="75"/> - </imageobject> - </mediaobject> - </figure> - - <para>The first two items control the background grid for the diagram. The next two items - allow you to control the appearance of the labels for views (pages) and the transitions - between views. For these two items, clicking the <emphasis> - <property>Change... </property> - </emphasis>button allows you to assign a font with a dialog box.</para> - - <para>The first check box determines whether a view in the diagram that doesn't have a - transition connecting it to another view yet should be written to the source code as a - partial navigation rule. The next check box determines whether the diagram cursor - reverts immediately to the standard selection mode after it's used in the - transition-drawing mode to draw a transition. Finally, the last two check boxes concern - shortcuts. A shortcut is a transition that is there but isn't actually displayed in the - diagram as going all the way to the target view it's connected to, in order to make the - diagram clearer. With the check boxes, you can decide whether to display a small - shortcut icon as part of the shortcut and also whether to display the target view as a - label or not.</para> - <figure> - <title>Add View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_16.png" scale="75"/> - </imageobject> - </mediaobject> - </figure> - <para>Selecting the Add Page tab in the JSF Flow Diagram screen allows you to determine the - default template and file extension for views (pages) you add directly into the diagram - using a context menu or the view-adding mode of the diagram cursor.</para> - </section> - - <section id="label_decorations"> - <title>Label Decorations</title> - - <para>The Label Decorations page is opened from <emphasis> - <property>JBoss Tools > Web > Label Decorations</property>. </emphasis></para> - - <figure> - <title>Label Decorations</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_17.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>On this page you can determine the format for a text output near the decoration label - for different Web resources. To change the value for selected element, click <emphasis> - <property>Add Variable...</property> - </emphasis> button next to <emphasis> - <property>Format</property> - </emphasis> field. Appeared wizard will prompt you to select one from the available - list.</para> - - <figure> - <title>Label Decoration for Validator</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_18.png"/> - </imageobject> - </mediaobject> - </figure> - - </section> - - <section id="Seam"> - <?dbhtml filename="Seam.html"?> - <title>Seam</title> - <para>The following preferences can be changed on the <emphasis> - <property>JBoss Tools > Web > Seam</property> - </emphasis> page.</para> - <para>On <emphasis> - <property>Seam</property> - </emphasis> screen you can add and remove Seam runtimes.</para> - <para>Here is what Seam preference page looks like:</para> - <figure> - <title>Seam preference page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_19.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="SeamValidator"> - <?dbhtml filename="SeamValidator.html"?> - <title>Seam Validator</title> - <para>The following preferences can be changed on the <emphasis> - <property>JBoss Tools > Web > Seam > Validator</property> - </emphasis> page.</para> - <para>In <emphasis> - <property>Validator</property> - </emphasis> panel you configure seam problems that will be processed by - validator.</para> - <figure> - <title>Seam Validator</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_20.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="SeamPagesDiagram"> - <?dbhtml filename="SeamPagesDiagram.html"?> - <title>Seam Pages Diagram</title> - - - - <para>In order to customize the layout of the Diagram used for editing and composing <property>page.xml</property> file in <property>Graphical mode</property> of <property>Seam Pages Editor</property> you can go to - <property>Window > Preferences > JBoss Tools > Web > Seam > Editors > Seam Pages Diagram</property>. - </para> - - <figure> - <title>Preferences of Seam Pages Diagram</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_44.png"/> - </imageobject> - </mediaobject> - </figure> - - </section> - - - - - - <section id="Struts"> - <?dbhtml filename="Struts.html"?> - <title>Struts</title> - <para>By selecting <emphasis> - <property>JBoss Tools &gt; Web &gt; Struts</property> - </emphasis> you can configure Struts projects specific preferences.</para> - <figure> - <title>Struts projects preferences Page.</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_21.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="struts_automation"> - <?dbhtml filename="struts_automation.html"?> - <title>Struts Automation</title> - <para>On <emphasis> - <property>Automation</property> - </emphasis> panel you can modify default text for the Title Struts plug-in element, the - Validator Struts plug-in element, and error message resource files.</para> - <figure> - <title>Struts Automatic</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_22.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="Plug-inInsets"> - <?dbhtml filename="Plug-inInsets.html"?> - <title>Plug-in Insets</title> - <para>By selecting <emphasis> - <property>Web &gt; Struts &gt; Automation &gt; Plug-in Insets</property> - </emphasis> on tab Tiles you can define a default text for tiles plugin.</para> - <figure> - <title>Plug-in Insets</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_23.png"/> - </imageobject> - </mediaobject> - </figure> - <para>The same is done but for validator plugin on the tab Validators.</para> - <figure> - <title>Plug-in Insets of Validators</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_24.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="ResourceInsets"> - <?dbhtml filename="ResourceInsets.html"?> - <title>Resource Insets</title> - <para>To see Resource Insets preference page select <emphasis> - <property>JBoss Tools > Web > Strats > Automation > Resource Insets</property> - </emphasis>.</para> - <para>On <emphasis> - <property>Resource Insets</property> - </emphasis> panel you determine default error messages for error resource files.</para> - <figure> - <title>Resource Insets</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_25.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="StrutsCustomization"> - <?dbhtml filename="StrutsCustomization"?> - <title>Struts Customization</title> - <para>The following preferences can be changed on the <emphasis> - <property>JBoss Tools > Web > Struts > Customization</property> - </emphasis> page.</para> - <para>In the<emphasis> - <property>Customization</property> - </emphasis> screen you configure Link Recognizer for Struts tags.</para> - <figure> - <title>Struts Customization</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_26.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="StrutsProject"> - <?dbhtml filename="StrutsProject.html"?> - <title>Struts Project</title> - <para>You can change the following preferences on the <emphasis> - <property>JBoss Tools > Web > Struts > Project</property> - </emphasis> preference page:</para> - <para>On <emphasis> - <property>Project</property> - </emphasis> panel you define a template for a new Struts created project: servlet - version, page template and so on.</para> - <figure> - <title>Struts Project</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_27.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Selecting the Import Project tab in the Struts Project screen allows you to determine - the default servlet version and whether to register Web Context in server.xml.</para> - <figure> - <title>Import Struts Pages</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_28.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="StrutsSupport"> - <?dbhtml filename="StrutsSupport.html"?> - <title>Struts Support</title> - <para>The following preferences can be changed on the <emphasis> - <property>JBoss Tools > Web > Struts > Project > Struts Support</property> - </emphasis> page.</para> - <para>Select <emphasis> - <property>Struts Support</property> - </emphasis> screen if you want to configure Struts versions support settings.</para> - <figure> - <title>Struts Support</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_29.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="StrutsPages"> - <?dbhtml filename="StrutsPages.html"?> - <title>Struts Pages</title> - <para>You can change the following preferences on the JBoss Tools > Web > Struts > Struts - Pages preference page.</para> - <para>On <emphasis> - <property>Struts Pages</property> - </emphasis> panel you can add or remove Struts pages.</para> - <figure> - <title>Struts Pages</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_30.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="StrutsFlowDiagram"> - <?dbhtml filename="StrutsFlowDiagram.html"?> - <title>Struts Flow Diagram</title> - <para>Similarly to the JSF Flow Diagram screen, selecting <emphasis> - <property>JBoss Tools > Web > Editor > Struts Flow Diagram</property> - </emphasis> page allows you to specify aspects of the Diagram mode of the Struts - configuration file editor. The Struts Flow Diagram screen adds an option to hide the - Diagram tab and labeling settings for additional artifacts. </para> - <figure> - <title>Struts Flow Diagram</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_31.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Selecting the Add Page tab in the Struts Flow Diagram screen allows you to determine - the default template and file extension for views (pages) you add directly into the - diagram using a context menu or the view-adding mode of the diagram cursor.</para> - <figure> - <title>Adding Page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_32.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="tiles_diagram"> - <?dbhtml filename="titles_diagram.html"?> - <title>Tiles Diagram</title> - <para><emphasis> - <property>JBoss Tools > Web > Editors > Title Diagram</property> - </emphasis> screen allows you control some settings for the placement of Tiles - definitions in the Diagram mode of the JBoss Tools Tiles editor.</para> - <figure> - <title>Title Diagram</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_33.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="Verification"> - <?dbhtml filename="Verification.html"?> - <title>Verification</title> - <para>The following preferences can be changed on the <emphasis> - <property>JBoss Tools > Web > Verification</property> - </emphasis> page.</para> - <para>On Rules Configuration tab of <emphasis> - <property>Verification</property> - </emphasis> panel you can determine JSF and Struts rules.</para> - <figure> - <title>Verification</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_34.png"/> - </imageobject> - </mediaobject> - </figure> - <para>On Options tab you can define a limit for the reported errors number.</para> - <figure> - <title>Options of Verification</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_35.png"/> - </imageobject> - </mediaobject> - </figure> - - </section> - - <section id="JBossServerPreferences"> - <?dbhtml filename="View.html"?> - <title>Server Preferences</title> - <para>Preferences for <property>JBoss Server</property> and other servers can be changed on - the <emphasis> - <property>Server</property> - </emphasis> page.</para> - - <figure> - <title>Server Preferences</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_36.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>On the <emphasis> - <property>Server > Runtime Environments</property> - </emphasis> page you can add new or modify already defined Server Runtime.</para> - - <figure> - <title>Runtime Environments</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_37.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Server Launching preferences can be configured on the <emphasis> - <property>Server > Launching</property> - </emphasis> page.</para> - - <figure> - <title>Server Launching Preferences</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_38.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Going to <emphasis> - <property>Server > Audio</property> - </emphasis> you can enable/disable the sound notification for different Server states - and actions and set the sound volume as well.</para> - - <figure> - <title>Sound Notification Adjustment</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_40.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="XDoclet"> - <?dbhtml filename="XDoclet.html"?> - <title>XDoclet</title> - <para>The preferences for XDoclet can be changed if you click <emphasis> - <property>XDoclet</property> - </emphasis> on the left navigation bar.</para> - <para>On the <emphasis> - <property>XDoclet</property> - </emphasis> screen it&apos;s possible to enable/disable XDoclet builder by checking - proper box, specify XDoclet home and determine XDoclet module version as well.</para> - - <figure> - <title>XDoclet Runtime Preferences Page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_41.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Switch to <emphasis> - <property>XDoclet > ejbdoclet</property> - </emphasis> page in order to adjust settings for EJB-specific sub-tasks.</para> - - <figure> - <title>ejbdoclet</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_42.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>To configure settings for various web-specific XDoclet sub-tasks, follow to <emphasis> - <property>XDoclet > webdoclet</property> - </emphasis> page.</para> - - <figure> - <title>webdoclet</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_43.png"/> - </imageobject> - </mediaobject> - </figure> - - </section> - - <!--section id="XDocletTemplates"> - <?dbhtml filename="XDocletTemplates.html"?> - <title>XDoclet Templates</title> - <para>To see what XDoclet tags templates available for completion select <emphasis> - <property>JBoss Tools > XDoclet > Code Assist > Templates</property> - </emphasis>.</para> - <figure> - <title>XDoclet Templates</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_32.png"/> - </imageobject> - </mediaobject> - </figure> - <para>By right clicking on any tree element you can add a new template, remove or rename it - and also add a new tree.</para> - <para>Select, for example, <emphasis> - <property>Add</property> - </emphasis> and you&apos;ll be prompted by a list of available elements to - add.</para> - <figure> - <title>Add New XDoclet Template</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_33.png"/> - </imageobject> - </mediaobject> - </figure> - <para>By double-clicking some element a new list will be shown: now for available - methods.</para> - <figure> - <title>Select New Element</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_34.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Choose any element from the list, then select an attribute.</para> - <figure> - <title>Select New Element</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_35.png"/> - </imageobject> - </mediaobject> - </figure> - <para>It will be added to the available templates.</para> - <figure> - <title>Select New Element</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_36.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="XDocletsVariables"> - <?dbhtml filename="XDocletsVariables.html"?> - <title>XDoclets Variables</title> - <para>By selecting <emphasis> - <property>JBoss Tools &gt; XDoclet &gt; Variables</property> - </emphasis> you define variables used in templates.</para> - <figure> - <title>XDoclets Variables</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_37.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="ChangingDefaultEnvironmentDuringProjectCreation"> - <?dbhtml filename="ChangingDefaultEnvironmentDuringProjectCreation.html"?> - <title>Changing Default Environment During Project Creation</title> - - <para>To change the default environment and project template for either JSF or Struts new - project creation:</para> - - <orderedlist> - <listitem> - <para>Select<emphasis> - <property> Window &gt; Preferences &gt; JBoss Tools &gt; Web - &gt; {JSF or Struts} &gt; Project</property> - </emphasis></para> - </listitem> - <listitem> - <para>For Version set the environment you want to be the default one</para> - </listitem> - <listitem> - <para>For Project Template set the template you want to be the default one</para> - </listitem> - </orderedlist> - - <figure> - <title>Changing Enviroment Template</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_36.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="ChangingDefaultProjectTemplateDuringProjectCreatio8n"> - <?dbhtml filename="ChangingDefaultEnvironmentDuringProjectCreation.html"?> - <title>Changing Default Project Template During Project Creation</title> - - <para>To change the default project template for either JSF or Struts new project - creation:</para> - - <orderedlist> - <listitem> - <para>Select<emphasis> - <property> Window > Preferences > JBoss Tools > Web > {JSF or Struts} > - Project</property> - </emphasis></para> - </listitem> - <listitem> - <para>For Project Template set the template you want to be the default one</para> - </listitem> - </orderedlist> - - <figure> - <title>Changing Project Template</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_37.png"/> - </imageobject> - </mediaobject> - </figure> - </section> ---> -</chapter> +<?xml version='1.0' encoding='UTF-8'?> +<chapter id="preferences" xreflabel="preferences"> + <?dbhtml filename="preferences.html"?> + <title>JBoss Tools Preferences</title> + + <para>Configuring the various <property>JBoss Developer Studio</property> features is done via + the <property>Preferences</property> screen by selecting <emphasis> + <property>Window &gt; Preferences &gt; JBoss Tools</property> + </emphasis> from the menu bar.</para> + <figure> + <title>Preferences are included in this dialog.</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_1.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>From this screen, you can select these more specific sets of <property>JBoss Tools + preferences</property>:</para> + + <itemizedlist> + <listitem> + <para> + <link linkend="ProjectArchives">Project Archives</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="Editors">Editors</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="VisualPageEditor2">Visual Page Editor</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="el_variables">El Variables</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="JSF">JSF</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="JSFPage">JSF Page</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="JSFPropject">JSF Project</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="JSFFlowDiagram">JSF Flow Diagram</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="Seam">Seam</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="SeamValidator">Seam Validator</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="Struts">Struts</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="struts_automation">Struts Automatic</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="Plug-inInsets">Plug-in Insets</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="ResourceInsets">Resource Insets</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="StrutsCustomization">Struts Customization</link> + </para> + </listitem> + + + <listitem> + <para> + <link linkend="StrutsProject">Struts Project</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="StrutsSupport">Struts Support</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="StrutsPages">Struts Pages</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="StrutsFlowDiagram">Struts Flow Diagram</link> + </para> + </listitem> + + + <listitem> + <para> + <link linkend="tiles_diagram">Tiles Diagram</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="Verification">Verification</link> + </para> + </listitem> + </itemizedlist> + + <para>The <property>Preferences</property> dialog <emphasis>( <property>Window &gt; + Preferences</property>) </emphasis> also allows to adjust settings for <link + linkend="JBossServerPreferences">JBoss Server</link> and <link linkend="XDoclet" + >XDoclet</link> module.</para> + + <section id="ProjectArchives"> + <?dbhtml filename="ProjectArchives.html"?> + <title>Project Archives</title> + + <para>Click on the <emphasis> + <property>Project Archives</property> + </emphasis> to open the page for changing Project Archives preferences.</para> + <para>Here you can determine settings for Core Preferences, Project Archives View, + Project Explorer Preferences and Fileset Preferences.</para> + + <figure> + <title>Project Archives</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_2.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The next table lists all available preferences for Project Archives and their + description.</para> + + <table> + <title>Project Archives Preferences</title> + + <tgroup cols="3"> + + <colspec colnum="1" align="left" colwidth="2*"/> + <colspec colnum="2" colwidth="4*"/> + <colspec colnum="3" colwidth="2*"/> + + <thead> + <row> + <entry>Option</entry> + <entry>Description</entry> + <entry>Default</entry> + </row> + </thead> + + <tbody> + <row> + <entry>Enable incremental builder</entry> + <entry>Uncheck this option if you don&apos;t want to enable incremental + builder for your resources</entry> + <entry>On</entry> + </row> + + <row> + <entry>Show build error dialog</entry> + <entry>If on, the Project Archives will show an error dialog + in case of a build or incremental update fails.</entry> + <entry>On</entry> + </row> + + <row> + <entry>Show output path next to packages</entry> + <entry>This option allows you to show or hide an output path next to + packages + <!--(<link linkend="full_outputpath_for_packages">See the + figure</link>)-->.</entry> + <entry>On</entry> + </row> + + <row> + <entry>Show the root directory of filesets</entry> + <entry>If on, the root directory is displayed next to filesets. + Otherwise, it&apos;s hidden + <!--(<link + linkend="full_rootdir_for_filesets">See the figure</link>)-->.</entry> + <entry>On</entry> + </row> + + <row> + <entry>Show project at the root</entry> + <entry>This option allows you to choose whether to display a project name at + the root of the packages or not. When checked, &apos;Show all + projects that contain packages&apos; is enabled + <!--(<link + linkend="project_at_the_root">See the figure</link>)-->.</entry> + <entry>On</entry> + </row> + + <row> + <entry>Show all projects that contain packages</entry> + <entry>Selecting this setting enables the Projects Archiving view to show or + hide all projects that contain packages. The option is available when + the previous one is checked.</entry> + <entry>Off</entry> + </row> + + <row> + <entry>Show node in all proejcts</entry> + <entry>Selecting this setting enables the Projects Archiving view to show + node in all projects.</entry> + <entry>Off</entry> + </row> + + <row> + <entry>Enable Default Excludes</entry> + <entry>You can set the list of files which will be excluded by default. + Other files will be omitted.</entry> + <entry>On</entry> + </row> + + </tbody> + </tgroup> + </table> + <!-- + <figure id="full_outputpath_for_packages"> + <title>Show Full Output Path next to Packages</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_3.png"/> + </imageobject> + </mediaobject> + </figure> + + <figure id="full_rootdir_for_filesets"> + <title>Show the Full Root Directory of Filesets</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_4.png"/> + </imageobject> + </mediaobject> + </figure> + + <figure id="project_at_the_root"> + <title>Show Project at the root</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_5.png"/> + </imageobject> + </mediaobject> + </figure> +--> + + </section> + + <!--section id="CodeAssist"> + <?dbhtml filename="CodeAssist.html"?> + <title>CodeAssist</title> + <para>Select <emphasis> + <property>JBoss Tools > XDoclet > Code Assist</property> + </emphasis> to see Code Assist preference page.</para> + <para>Here is what the Code Assist preference page looks like: </para> + <figure> + <title>CodeAssist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_2.png"/> + </imageobject> + </mediaobject> + </figure> + </section--> + + <section id="Editors"> + <?dbhtml filename="Editors.html"?> + <title>Editors</title> + <para>To adjust settings common for all editors supplied with <property>JBoss Developer + Studio</property> you should select <emphasis> + <property>JBoss Tools > Web > Editors</property>.</emphasis></para> + + <figure> + <title>Editors</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_6.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>On the Editors page the following preferences are available:</para> + + <table> + + <title>Editors Preferences</title> + <tgroup cols="3"> + + <colspec colnum="1" align="left" colwidth="2*"/> + <colspec colnum="2" colwidth="4*"/> + <colspec colnum="3" colwidth="2*"/> + + <thead> + <row> + <entry>Option</entry> + <entry>Description</entry> + <entry>Default</entry> + </row> + </thead> + + <tbody> + <row> + <entry>Always use JBoss Tools editors with Open option</entry> + <entry/> + <entry>On</entry> + </row> + + <row> + <entry>Show warning when project has no JBoss Tools capabilities</entry> + <entry>Check this option to be sure that any JBoss Tools editor fully + available for a particular type of file. If no, you&apos;ll be + warned about this.</entry> + <entry>On</entry> + </row> + + <row> + <entry>Use Source tab as a default for multi-tab editors</entry> + <entry>If on, an editor will open the files in the Source view by + default</entry> + <entry>Off</entry> + </row> + </tbody> + </tgroup> + </table> + + </section> + + <section id="VisualPageEditor2"> + <?dbhtml filename="VisualPageEditor.html"?> + <title>Visual Page Editor</title> + <para><emphasis> + <property>JBoss Tools &gt; Web &gt; Editors &gt; Visual Page + Editor</property> + </emphasis> screen allows you to control some aspects of the behavior of the + <property>Visual Page Editor</property> (VPE) for JSF/HTML files.</para> + <figure> + <title>Visual Page Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_7.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The next table lists the possible settings that you can adjust on the + <property>General tab</property> of the VPE Preferences page.</para> + + + <table> + + <title>VPE Preferences</title> + <tgroup cols="3"> + + <colspec colnum="1" align="left" colwidth="2*"/> + <colspec colnum="2" colwidth="4*"/> + <colspec colnum="3" colwidth="2*"/> + + <thead> + <row> + <entry>Option</entry> + <entry>Description</entry> + <entry>Default</entry> + </row> + </thead> + + <tbody> + <row> + <entry>Show border for unknown tags</entry> + <entry>The option allows to place the border around unknown tags or undo + this</entry> + <entry>On</entry> + </row> + + <row> + <entry>Show non-visual tags</entry> + <entry>Check this box, if you want the editor shows non-visual elements on + the page you're editing</entry> + <entry>Off</entry> + </row> + + <row> + <entry>Show selection tag bar</entry> + <entry>The option allows to show/hide the Selection Bar</entry> + <entry>On</entry> + </row> + + <row> + <entry>Show text formatting bar</entry> + <entry>Check this box in order to show/hide the Text Formatting bar</entry> + <entry>On</entry> + </row> + + <row> + <entry>Show resource bundles usage as EL expressions</entry> + <entry>If the option is checked, the editor will show EL expressions instead + of the resource values</entry> + <entry>Off</entry> + </row> + + <row> + <entry>Ask for tag attributes during tag insert </entry> + <entry>Having this option off, the dialog with possible attributes for + inserting tag won&apos;t appear if all its attributes are optional</entry> + <entry>On</entry> + </row> + + <row> + <entry>Ask for confirmation when closing the Selection Bar</entry> + <entry>Check this box if you don&apos;t want the confirmation window + appears when closing the Selection Bar</entry> + <entry>On</entry> + </row> + + <row> + <entry>Select the default active editor&apos;s tab</entry> + <entry>The option provides possibility to choose one of the following + views - Visual/Source, Source or Preview, as default when opening the + editor</entry> + <entry>Visual/Source</entry> + </row> + <row> + <entry>Visual/Source editors splitting</entry> + <entry>The option allows to choose one of the following + Visual,Source layouts - Vertical Source on top, Vertical Visual on top,Horizontal Source to the left or Horizontal Visual to the left, + as a default one when opening the Visual/Source view</entry> + <entry>Vertical splitting with Source Editor on the top</entry> + </row> + <row> + <entry>Size of the Visual Editor pane (0 – 100%)</entry> + <entry>With the help of this scroll bar you can adjust the percentage rating + between the Source and Visual modes of the Visual/Source view</entry> + <entry>50%</entry> + </row> + </tbody> + </tgroup> + </table> + + <para>On the <property>Templates tab</property> you can edit or remove <link + linkend="vpe_templating">VPE templates</link>.</para> + <figure> + <title>Visual Page Editor Templates</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_8.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Select a template for editing from the available list and press <emphasis> + <property>Edit</property> + </emphasis> button. It will pick up the <link linkend="template_dialog">Template + dialog</link> where you can adjust new settings.</para> + </section> + + <section id="el_variables"> + <?dbhtml filename="el_variables.html"?> + <title>El Variables</title> + <para>To specify necessary EL variables globally, i. e. for all projects and resources in + your workspace, you should go to <emphasis> + <property>JBoss Tools > Web > El Variables</property>. </emphasis></para> + + <figure> + <title>El Variables</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_9.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Click <emphasis> + <property>Add...</property> + </emphasis> to set value for a new EL variable. In the appeared wizard you should + specify the global values and press <emphasis> + <property>Finish</property> + </emphasis>.</para> + + <figure> + <title>Adding a Global El Variable</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_10.png"/> + </imageobject> + </mediaobject> + </figure> + + <tip> + <title>Tip:</title> + <para>If you specify an equal variable in <link linkend="el_exp_para">Substitute EL + expressions dialog</link> and in Preference EL dialog, variable from preference dialog will + have priority.</para> + </tip> + </section> + <!--section id="JBossServers"> + <?dbhtml filename="JBossServers.html"?> + <title>JBoss Servers</title> + <para>The following preferences can be changed on the <emphasis> + <property>JBoss Tools > JBoss Servers</property> + </emphasis> preference page.</para> + <para>Here is what the JBoss Servers preference page looks like:</para> + <figure> + <title>JBoss Servers</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_4.png"/> + </imageobject> + </mediaobject> + </figure> + </section--> + + <section id="JSF"> + <?dbhtml filename="JSF.html"?> + <title>JSF</title> + <para>Select <emphasis> + <property>JBoss Tools &gt; Web &gt; JSF</property> + </emphasis> to get to the JSF Project specific preferences.</para> + <figure> + <title>JSF</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_11.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="JSFPage"> + <?dbhtml filename="JSF Page.html"?> + <title>JSF Pages</title> + <para>By selecting <emphasis> + <property>JBoss Tools &gt; Web &gt; JSF &gt; JSF Pages</property> + </emphasis> you can add jsf pages or remove existing ones.</para> + <figure> + <title>JSF Page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_12.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="JSFPropject"> + <?dbhtml filename="JSFPropject.html"?> + <title>JSF Project</title> + <para>Select <emphasis> + <property>JBoss Tools > Web > JSF > Project</property> + </emphasis> to see JSF Project preferences page.</para> + <para>On the <emphasis> + <property>New Project</property> + </emphasis> tab you can set default values for New JSF Project wizard:</para> + + <itemizedlist> + <listitem> + <para><emphasis> + <property>Version</property> + </emphasis> for setting the default JSF Environment</para> + </listitem> + + <listitem> + <para><emphasis> + <property>Project Template</property> + </emphasis> so as <property>New JSF Project wizard</property> shows this + template as default for the chosen JSF Environment</para> + </listitem> + + <listitem> + <para><emphasis> + <property>Project Root</property> + </emphasis> for specifying default location for a new JSF project</para> + <para>If you check <emphasis> + <property>Use Default Path</property> + </emphasis> here, this box will be also checked in the <property>New JSF Project + wizard</property>.</para> + </listitem> + + <listitem> + <para><emphasis> + <property>Servlet Version</property> + </emphasis> for setting the default Servlet version of a new JSF project</para> + <para>Here it&apos;s also possible to define whether to register Web Context in <emphasis> + <property>server.xml</property> + </emphasis> while organizing a new project or not. Check the proper box in order + to do that.</para> + </listitem> + </itemizedlist> + + <figure> + <title>New JSF Project Preferences</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_13.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>On the <emphasis> + <property>Import Project</property> + </emphasis> tab in the JSF Project screen you can determine the default Servlet version + for the Import JSF Project + wizard and also whether to register Web Context in <emphasis> + <property>server.xml</property> + </emphasis> or not.</para> + + <figure> + <title>Import JSF Project Preferences</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_14.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="JSFValidator"> + <?dbhtml filename="JSFValidator.html"?> + <title>JSF Validator</title> + <para>Select <property>JBoss Tools > Web > JSF > Validator</property> page to configure the validator behavior. On this page you can change the severity level for different jsf problems which are controlled by validator.</para> + <figure> + <title>JSF Validator</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_14a.png" /> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="JSFFlowDiagram"> + <?dbhtml filename="JSFFlowDiagram.html"?> + <title>JSF Flow Diagram</title> + <para>Selecting <emphasis> + <property>JBoss Tools > Web > Editors > JSF Flow Diagram</property> + </emphasis> allows you to specify some aspects of the Diagram mode of the JSF + configuration file editor.</para> + + <figure> + <title>JSF Flow Diagram</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_15.png" scale="75"/> + </imageobject> + </mediaobject> + </figure> + + <para>The first two items control the background grid for the diagram. The next two items + allow you to control the appearance of the labels for views (pages) and the transitions + between views. For these two items, clicking the <emphasis> + <property>Change... </property> + </emphasis>button allows you to assign a font with a dialog box.</para> + + <para>The first check box determines whether a view in the diagram that doesn't have a + transition connecting it to another view yet should be written to the source code as a + partial navigation rule. The next check box determines whether the diagram cursor + reverts immediately to the standard selection mode after it's used in the + transition-drawing mode to draw a transition. Finally, the last two check boxes concern + shortcuts. A shortcut is a transition that is there but isn't actually displayed in the + diagram as going all the way to the target view it's connected to, in order to make the + diagram clearer. With the check boxes, you can decide whether to display a small + shortcut icon as part of the shortcut and also whether to display the target view as a + label or not.</para> + <figure> + <title>Add View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_16.png" scale="75"/> + </imageobject> + </mediaobject> + </figure> + <para>Selecting the Add Page tab in the JSF Flow Diagram screen allows you to determine the + default template and file extension for views (pages) you add directly into the diagram + using a context menu or the view-adding mode of the diagram cursor.</para> + </section> + + <section id="label_decorations"> + <title>Label Decorations</title> + + <para>The Label Decorations page is opened from <emphasis> + <property>JBoss Tools > Web > Label Decorations</property>. </emphasis></para> + + <figure> + <title>Label Decorations</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_17.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>On this page you can determine the format for a text output near the decoration label + for different Web resources. To change the value for selected element, click <emphasis> + <property>Add Variable...</property> + </emphasis> button next to <emphasis> + <property>Format</property> + </emphasis> field. Appeared wizard will prompt you to select one from the available + list.</para> + + <figure> + <title>Label Decoration for Validator</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_18.png"/> + </imageobject> + </mediaobject> + </figure> + + </section> + + <section id="Seam"> + <?dbhtml filename="Seam.html"?> + <title>Seam</title> + <para>The following preferences can be changed on the <emphasis> + <property>JBoss Tools > Web > Seam</property> + </emphasis> page.</para> + <para>On <emphasis> + <property>Seam</property> + </emphasis> screen you can add and remove Seam runtimes.</para> + <para>Here is what Seam preference page looks like:</para> + <figure> + <title>Seam preference page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_19.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="SeamValidator"> + <?dbhtml filename="SeamValidator.html"?> + <title>Seam Validator</title> + <para>The following preferences can be changed on the <emphasis> + <property>JBoss Tools > Web > Seam > Validator</property> + </emphasis> page.</para> + <para>In <emphasis> + <property>Validator</property> + </emphasis> panel you configure seam problems that will be processed by + validator.</para> + <figure> + <title>Seam Validator</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_20.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="SeamPagesDiagram"> + <?dbhtml filename="SeamPagesDiagram.html"?> + <title>Seam Pages Diagram</title> + + + + <para>In order to customize the layout of the Diagram used for editing and composing <property>page.xml</property> file in <property>Graphical mode</property> of <property>Seam Pages Editor</property> you can go to + <property>Window > Preferences > JBoss Tools > Web > Seam > Editors > Seam Pages Diagram</property>. + </para> + + <figure> + <title>Preferences of Seam Pages Diagram</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_44.png"/> + </imageobject> + </mediaobject> + </figure> + + </section> + + + + + + <section id="Struts"> + <?dbhtml filename="Struts.html"?> + <title>Struts</title> + <para>By selecting <emphasis> + <property>JBoss Tools &gt; Web &gt; Struts</property> + </emphasis> you can configure Struts projects specific preferences.</para> + <figure> + <title>Struts projects preferences Page.</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_21.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="struts_automation"> + <?dbhtml filename="struts_automation.html"?> + <title>Struts Automation</title> + <para>On <emphasis> + <property>Automation</property> + </emphasis> panel you can modify default text for the Title Struts plug-in element, the + Validator Struts plug-in element, and error message resource files.</para> + <figure> + <title>Struts Automatic</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_22.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="Plug-inInsets"> + <?dbhtml filename="Plug-inInsets.html"?> + <title>Plug-in Insets</title> + <para>By selecting <emphasis> + <property>Web &gt; Struts &gt; Automation &gt; Plug-in Insets</property> + </emphasis> on tab Tiles you can define a default text for tiles plugin.</para> + <figure> + <title>Plug-in Insets</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_23.png"/> + </imageobject> + </mediaobject> + </figure> + <para>The same is done but for validator plugin on the tab Validators.</para> + <figure> + <title>Plug-in Insets of Validators</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_24.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="ResourceInsets"> + <?dbhtml filename="ResourceInsets.html"?> + <title>Resource Insets</title> + <para>To see Resource Insets preference page select <emphasis> + <property>JBoss Tools > Web > Strats > Automation > Resource Insets</property> + </emphasis>.</para> + <para>On <emphasis> + <property>Resource Insets</property> + </emphasis> panel you determine default error messages for error resource files.</para> + <figure> + <title>Resource Insets</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_25.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="StrutsCustomization"> + <?dbhtml filename="StrutsCustomization"?> + <title>Struts Customization</title> + <para>The following preferences can be changed on the <emphasis> + <property>JBoss Tools > Web > Struts > Customization</property> + </emphasis> page.</para> + <para>In the<emphasis> + <property>Customization</property> + </emphasis> screen you configure Link Recognizer for Struts tags.</para> + <figure> + <title>Struts Customization</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_26.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="StrutsProject"> + <?dbhtml filename="StrutsProject.html"?> + <title>Struts Project</title> + <para>You can change the following preferences on the <emphasis> + <property>JBoss Tools > Web > Struts > Project</property> + </emphasis> preference page:</para> + <para>On <emphasis> + <property>Project</property> + </emphasis> panel you define a template for a new Struts created project: servlet + version, page template and so on.</para> + <figure> + <title>Struts Project</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_27.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Selecting the Import Project tab in the Struts Project screen allows you to determine + the default servlet version and whether to register Web Context in server.xml.</para> + <figure> + <title>Import Struts Pages</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_28.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="StrutsSupport"> + <?dbhtml filename="StrutsSupport.html"?> + <title>Struts Support</title> + <para>The following preferences can be changed on the <emphasis> + <property>JBoss Tools > Web > Struts > Project > Struts Support</property> + </emphasis> page.</para> + <para>Select <emphasis> + <property>Struts Support</property> + </emphasis> screen if you want to configure Struts versions support settings.</para> + <figure> + <title>Struts Support</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_29.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="StrutsPages"> + <?dbhtml filename="StrutsPages.html"?> + <title>Struts Pages</title> + <para>You can change the following preferences on the JBoss Tools > Web > Struts > Struts + Pages preference page.</para> + <para>On <emphasis> + <property>Struts Pages</property> + </emphasis> panel you can add or remove Struts pages.</para> + <figure> + <title>Struts Pages</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_30.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="StrutsFlowDiagram"> + <?dbhtml filename="StrutsFlowDiagram.html"?> + <title>Struts Flow Diagram</title> + <para>Similarly to the JSF Flow Diagram screen, selecting <emphasis> + <property>JBoss Tools > Web > Editor > Struts Flow Diagram</property> + </emphasis> page allows you to specify aspects of the Diagram mode of the Struts + configuration file editor. The Struts Flow Diagram screen adds an option to hide the + Diagram tab and labeling settings for additional artifacts. </para> + <figure> + <title>Struts Flow Diagram</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_31.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Selecting the Add Page tab in the Struts Flow Diagram screen allows you to determine + the default template and file extension for views (pages) you add directly into the + diagram using a context menu or the view-adding mode of the diagram cursor.</para> + <figure> + <title>Adding Page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_32.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="tiles_diagram"> + <?dbhtml filename="titles_diagram.html"?> + <title>Tiles Diagram</title> + <para><emphasis> + <property>JBoss Tools > Web > Editors > Title Diagram</property> + </emphasis> screen allows you control some settings for the placement of Tiles + definitions in the Diagram mode of the JBoss Tools Tiles editor.</para> + <figure> + <title>Title Diagram</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_33.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="Verification"> + <?dbhtml filename="Verification.html"?> + <title>Verification</title> + <para>The following preferences can be changed on the <emphasis> + <property>JBoss Tools > Web > Verification</property> + </emphasis> page.</para> + <para>On Rules Configuration tab of <emphasis> + <property>Verification</property> + </emphasis> panel you can determine JSF and Struts rules.</para> + <figure> + <title>Verification</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_34.png"/> + </imageobject> + </mediaobject> + </figure> + <para>On Options tab you can define a limit for the reported errors number.</para> + <figure> + <title>Options of Verification</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_35.png"/> + </imageobject> + </mediaobject> + </figure> + + </section> + + <section id="JBossServerPreferences"> + <?dbhtml filename="View.html"?> + <title>Server Preferences</title> + <para>Preferences for <property>JBoss Server</property> and other servers can be changed on + the <emphasis> + <property>Server</property> + </emphasis> page.</para> + + <figure> + <title>Server Preferences</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_36.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>On the <emphasis> + <property>Server > Runtime Environments</property> + </emphasis> page you can add new or modify already defined Server Runtime.</para> + + <figure> + <title>Runtime Environments</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_37.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Server Launching preferences can be configured on the <emphasis> + <property>Server > Launching</property> + </emphasis> page.</para> + + <figure> + <title>Server Launching Preferences</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_38.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Going to <emphasis> + <property>Server > Audio</property> + </emphasis> you can enable/disable the sound notification for different Server states + and actions and set the sound volume as well.</para> + + <figure> + <title>Sound Notification Adjustment</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_40.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="XDoclet"> + <?dbhtml filename="XDoclet.html"?> + <title>XDoclet</title> + <para>The preferences for XDoclet can be changed if you click <emphasis> + <property>XDoclet</property> + </emphasis> on the left navigation bar.</para> + <para>On the <emphasis> + <property>XDoclet</property> + </emphasis> screen it&apos;s possible to enable/disable XDoclet builder by checking + proper box, specify XDoclet home and determine XDoclet module version as well.</para> + + <figure> + <title>XDoclet Runtime Preferences Page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_41.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Switch to <emphasis> + <property>XDoclet > ejbdoclet</property> + </emphasis> page in order to adjust settings for EJB-specific sub-tasks.</para> + + <figure> + <title>ejbdoclet</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_42.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>To configure settings for various web-specific XDoclet sub-tasks, follow to <emphasis> + <property>XDoclet > webdoclet</property> + </emphasis> page.</para> + + <figure> + <title>webdoclet</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_43.png"/> + </imageobject> + </mediaobject> + </figure> + + </section> + + <!--section id="XDocletTemplates"> + <?dbhtml filename="XDocletTemplates.html"?> + <title>XDoclet Templates</title> + <para>To see what XDoclet tags templates available for completion select <emphasis> + <property>JBoss Tools > XDoclet > Code Assist > Templates</property> + </emphasis>.</para> + <figure> + <title>XDoclet Templates</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_32.png"/> + </imageobject> + </mediaobject> + </figure> + <para>By right clicking on any tree element you can add a new template, remove or rename it + and also add a new tree.</para> + <para>Select, for example, <emphasis> + <property>Add</property> + </emphasis> and you&apos;ll be prompted by a list of available elements to + add.</para> + <figure> + <title>Add New XDoclet Template</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_33.png"/> + </imageobject> + </mediaobject> + </figure> + <para>By double-clicking some element a new list will be shown: now for available + methods.</para> + <figure> + <title>Select New Element</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_34.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Choose any element from the list, then select an attribute.</para> + <figure> + <title>Select New Element</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_35.png"/> + </imageobject> + </mediaobject> + </figure> + <para>It will be added to the available templates.</para> + <figure> + <title>Select New Element</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_36.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="XDocletsVariables"> + <?dbhtml filename="XDocletsVariables.html"?> + <title>XDoclets Variables</title> + <para>By selecting <emphasis> + <property>JBoss Tools &gt; XDoclet &gt; Variables</property> + </emphasis> you define variables used in templates.</para> + <figure> + <title>XDoclets Variables</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_37.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="ChangingDefaultEnvironmentDuringProjectCreation"> + <?dbhtml filename="ChangingDefaultEnvironmentDuringProjectCreation.html"?> + <title>Changing Default Environment During Project Creation</title> + + <para>To change the default environment and project template for either JSF or Struts new + project creation:</para> + + <orderedlist> + <listitem> + <para>Select<emphasis> + <property> Window &gt; Preferences &gt; JBoss Tools &gt; Web + &gt; {JSF or Struts} &gt; Project</property> + </emphasis></para> + </listitem> + <listitem> + <para>For Version set the environment you want to be the default one</para> + </listitem> + <listitem> + <para>For Project Template set the template you want to be the default one</para> + </listitem> + </orderedlist> + + <figure> + <title>Changing Enviroment Template</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_36.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="ChangingDefaultProjectTemplateDuringProjectCreatio8n"> + <?dbhtml filename="ChangingDefaultEnvironmentDuringProjectCreation.html"?> + <title>Changing Default Project Template During Project Creation</title> + + <para>To change the default project template for either JSF or Struts new project + creation:</para> + + <orderedlist> + <listitem> + <para>Select<emphasis> + <property> Window > Preferences > JBoss Tools > Web > {JSF or Struts} > + Project</property> + </emphasis></para> + </listitem> + <listitem> + <para>For Project Template set the template you want to be the default one</para> + </listitem> + </orderedlist> + + <figure> + <title>Changing Project Template</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_37.png"/> + </imageobject> + </mediaobject> + </figure> + </section> +--> +</chapter> \ No newline at end of file