Author: irooskov(a)redhat.com Date: 2011-07-17 22:48:03 -0400 (Sun, 17 Jul 2011) New Revision: 32986 Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Book_Info.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Feedback.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Preface.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Revision_History.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.ent branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/code_generation.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/config_file_debugger.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/editors.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/introduction.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/master.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/modules.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/page_links_recognizer.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/project_verification.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/projects.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/rel_resources_links.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/struts_project_verification.xml branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/pom.xml Log: updated for GA Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Book_Info.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Book_Info.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Book_Info.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -5,9 +5,9 @@ <title>Struts Tools Reference Guide</title> <subtitle>Provides information relating to the Struts Tools module.</subtitle> <productname>JBoss Developer Studio</productname> - <productnumber>4.0</productnumber> - <edition>4.0.0</edition> - <pubsnumber>4</pubsnumber> + <productnumber>4.1</productnumber> + <edition>4.1.0</edition> + <pubsnumber>1</pubsnumber> <abstract> <para>The Struts Tools Reference Guide explains how to use the Struts Tools to create high-quality web applications.</para> </abstract> Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Feedback.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Feedback.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Feedback.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -1,20 +1,92 @@ <?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Document_Conventions.ent"> +%BOOK_ENTITIES; +]> +<appendix id="sect_JBoss-Getting_Help_and_Giving_Feedback" lang="en-US"> + <title>Getting Help and Giving Feedback</title> + <section id="sect_JBoss-Do_You_Need_Help"> + <title>Do You Need Help?</title> + <indexterm> + <primary>help</primary> + <secondary>getting help</secondary> -<section id="sect-Beginners_Guide-We_Need_Feedback" lang="en-US"> - <title>We Need Feedback!</title> - <indexterm> - <primary>feedback</primary> - <secondary>contact information for this manual</secondary> - </indexterm> - <para> - If you find a typographical error in this manual, or if you have thought of a way to make this manual better, we would love to hear from you! Please submit a report in JIRA against JBoss Developer Studio: <ulink url="https://jira.jboss.org/jira/secure/CreateIssue.jspa?pid=1231050... - </para> - <para> - When submitting a bug report, be sure to mention the manual's name and to select the "documentation" component. - </para> - <para> - If you have a suggestion for improving the documentation, try to be as specific as possible when describing it. If you have found an error, please include the section number and some of the surrounding text so we can find it easily. - </para> -</section> + </indexterm> + <para> + If you experience difficulty with a procedure described in this documentation, visit the Red Hat Customer Portal at <ulink url="http://access.redhat.com" />. Through the customer portal, you can: + </para> + <itemizedlist> + <listitem> + <para> + search or browse through a knowledgebase of technical support articles about Red Hat products. + </para> + </listitem> + <listitem> + <para> + submit a support case to Red Hat Global Support Services (GSS). + </para> + </listitem> + <listitem> + <para> + access other product documentation. + </para> + + </listitem> + + </itemizedlist> + <para> + Red Hat also hosts a large number of electronic mailing lists for discussion of Red Hat software and technology. You can find a list of publicly available mailing lists at <ulink url="https://www.redhat.com/mailman/listinfo" />. Click on the name of any mailing list to subscribe to that list or to access the list archives. + </para> + + </section> + + <section id="jboss-feedback"> + <title>Give us Feedback</title> + <!-- NOTE: You will need the following entities defined in your .ent file. + You will need to replace _YOUR_PRODUCT_HERE_, _YOUR_COMPONENT_ + and _YOUR_SUMMARY_ - entities are not replaced in URLs. + <!ENTITY PRODUCT "JBoss Product Name"> + <!ENTITY BZCOMPONENT "doc-triage"> + <!ENTITY BZURL "<ulink url='https://bugzilla.example.com/enter_bug.cgi?product=_YOUR_PRODUCT... + + These entities should not affect translated documents, since Bugzilla is not localised. + --> <indexterm> + <primary>feedback</primary> + <secondary>contact information for this manual</secondary> + + </indexterm> + <para> + If you find a typographical error, or know how this guide can be improved, we would love to hear from you. Submit a report in Bugzilla against the product <literal>&BZPRODUCT;</literal> and the component <literal>&BZCOMPONENT;</literal>. The following link will take you to a pre-filled bug report for this product: &BZURL;. + </para> + <para> + Fill out the following template in Bugzilla's <literal>Description</literal> field. Be as specific as possible when describing the issue; this will help ensure that we can fix it quickly. + </para> + +<screen>Document URL: + + +Section Number and Name: + + +Describe the issue: + + +Suggestions for improvement: + + +Additional information: + + +</screen> + <para> + Be sure to give us your name so that you can receive full credit for reporting the issue. + </para> + + </section> + + +</appendix> + + Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Preface.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Preface.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Preface.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -8,9 +8,5 @@ <para> This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information. To get more information on these conventions please refer to the <guilabel>Document Conventions</guilabel> manual, which can be found on the <ulink url="http://docs.redhat.com/docs/en-US/JBoss_Developer_Studio/index.... Hat Documentation</ulink> website under the <guilabel>JBoss Developer Studio</guilabel> section. </para> - <!--<xi:include href="Common_Content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"><xi:include href="Common_Content/Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - </xi:fallback> - </xi:include>--> </preface> Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Revision_History.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Revision_History.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Revision_History.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -2,31 +2,51 @@ <!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ ]> <appendix> - <title>Revision History</title> - <simpara> - <revhistory> - <revision> - <revnumber>1</revnumber><date>Wed Jun 09 2010</date> - <author> - <firstname>JBoss Tools</firstname><surname>Documentation Team&lt;/surname&gt;&lt;email&gt;irooskov(a)redhat.com&lt;/email&gt; - </author> - <revdescription> - <simplelist> - <member>General updates</member> - </simplelist> - </revdescription> - </revision> - <revision> - <revnumber>0</revnumber><date>Fri Nov 20 2009</date> - <author> - <firstname&gt;Isaac&lt;/firstname&gt;&lt;surname&gt;Rooskov&lt;/surname&gt;&lt;email&gt;irooskov(a)redhat.com&lt;/email&gt; - </author> - <revdescription> - <simplelist> - <member>Initial creation of book by publican</member> - </simplelist> - </revdescription> - </revision> - </revhistory> - </simpara> + <title>Revision History</title> + <simpara> + <revhistory> + <revision> + <revnumber>2</revnumber> + <date>Wed Jan 19 2011</date> + <author> + <firstname>JBoss Tools</firstname> + <surname>Documentation Team</surname> + <email&gt;mcaspers(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>General updates</member> + </simplelist> + </revdescription> + </revision> + <revision> + <revnumber>1</revnumber> + <date>Wed Jun 09 2010</date> + <author> + <firstname>JBoss Tools</firstname> + <surname>Documentation Team</surname> + <email&gt;irooskov(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>General updates</member> + </simplelist> + </revdescription> + </revision> + <revision> + <revnumber>0</revnumber> + <date>Fri Nov 20 2009</date> + <author> + <firstname>Isaac</firstname> + <surname>Rooskov</surname> + <email&gt;irooskov(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>Initial creation of book by publican</member> + </simplelist> + </revdescription> + </revision> + </revhistory> + </simpara> </appendix> Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.ent =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.ent 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.ent 2011-07-18 02:48:03 UTC (rev 32986) @@ -1,4 +1,7 @@ <!ENTITY PRODUCT "JBoss"> <!ENTITY BOOKID "Struts_Tools_Reference_Guide"> -<!ENTITY YEAR "2010"> +<!ENTITY YEAR "2011"> <!ENTITY HOLDER "Red Hat"> +<!ENTITY BZPRODUCT "JBoss Developer Studio"> +<!ENTITY BZCOMPONENT "Struts Tools Reference Guide"> +<!ENTITY BZURL "<ulink url='https://bugzilla.redhat.com/enter_bug.cgi?product=JBoss&perc... Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -13,6 +13,7 @@ <xi:include href="page_links_recognizer.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> <xi:include href="project_verification.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> <xi:include href="rel_resources_links.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> <index></index> </book> Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/code_generation.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/code_generation.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/code_generation.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -1,97 +1,91 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="code_generation"> - <?dbhtml filename="code_generation.html"?> - - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>Eclipse</keyword> - <keyword>Struts Tools</keyword> - <keyword>Java</keyword> - <keyword>JBoss</keyword> - </keywordset> - </chapterinfo> - - <title>Code Generation</title> - - <para>JBoss Tools comes with a <property>code generation</property> - feature. You can generate stub code for Struts Actions, FormBeans, Forwards - and Exceptions.</para> - - <para>The code generation that JBoss tooling provides is based on Velocity templates - which can be modified for your use. The templates are located at <emphasis> - <property> {JBossStudioHome} > templates > - codegeneration</property>. </emphasis></para> - - <para>There are a number of ways to invoke code generation. One is simply - right-clicking the Struts diagram and selecting <emphasis> - <property>Generate Java Code....</property> - </emphasis></para> - - <figure> - <title>Selecting Generate Java Code</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_45.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>On this screen you can select for which elements to generate code. If you - select Next you will be able to specify more options for each of the - categories you selected.</para> - - <figure> - <title>Generate - Step 1</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_46.png"/> - </imageobject> - </mediaobject> - </figure> - - <note> - <title>Tip:</title> - <para>Please be careful not to override your existing files.</para> - </note> - - <para>When generation is complete, a result window will appear letting you know how + <?dbhtml filename="code_generation.html"?> + + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Struts Tools</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Code Generation</title> + + <para> + JBoss Tools comes with a <property>code generation</property> feature which can be used to generate stub code for Struts Actions, FormBeans, Forwards and Exceptions. + </para> + + <para> + The code generation that JBoss tooling provides is based on Velocity templates which can be modified for your use. The templates are located at <menuchoice><guimenuitem>{JBossStudioHome}</guimenuitem><guimenuitem>templates</guimenuitem><guimenuitem>codegeneration</guimenuitem></menuchoice>. + </para> + + <para> + There are a number of ways to invoke code generation. One way is to simply right-click the Struts diagram and select <guimenuitem>Generate Java Code....</guimenuitem> + </para> + + <figure> + <title>Selecting Generate Java Code</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_45.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + On this screen you can select for which elements to generate code. If you click the <guibutton>Next</guibutton> button you will be able to specify more options for each of the categories you selected. + </para> + + <figure> + <title>Generate - Step 1</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_46.png"/> + </imageobject> + </mediaobject> + </figure> + + <note> + <title>Tip:</title> + <para>Please be careful not to override your existing files.</para> + </note> + + <para>When generation is complete, a result window will appear letting you know how many classes were generated:</para> - - <figure> - <title>Generation Finished</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_47.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>You don&apos;t always have to generate code for all elements at once. You - can invoke generation for just an individual Struts artifact as well. - Right-click an element on the diagram of the Struts configuration file and - select <emphasis> - <property>Generate Java Code...</property> - </emphasis> from the context menu.</para> - - <figure> - <title>Generation For Individual Struts Artifact</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_48.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>The same can be done from within the Tree viewer for the editor of the Struts - configuration file.</para> - - <figure> - <title>Generation in Struts Config Editor</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_49.png"/> - </imageobject> - </mediaobject> - </figure> + + <figure> + <title>Generation Finished</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_47.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + You don&apos;t always have to generate code for all elements at once. You can generate code for an individual Struts artifact as well. Right-click an element on the diagram of the Struts configuration file and select <guimenuitem>Generate Java Code...</guimenuitem> from the context menu. + </para> + + <figure> + <title>Generation For Individual Struts Artifact</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_48.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The same can be done from within the Tree viewer for the editor of the Struts configuration file.</para> + + <figure> + <title>Generation in Struts Config Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_49.png"/> + </imageobject> + </mediaobject> + </figure> </chapter> \ No newline at end of file Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/config_file_debugger.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/config_file_debugger.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/config_file_debugger.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -13,12 +13,11 @@ <title>Struts Configuration File Debugger</title> - <para>JBoss Tools come with <property>Struts configuration file - debugger</property>. It allows you to set break points on Struts diagram and - then simply launch the server in debug mode.</para> + <para> + JBoss Tools come with <property>Struts configuration file debugger</property>. It allows you to set break points on Struts diagram and then simply launch the server in debug mode. + </para> - <para>Simply right click an Action or a page and select Add <emphasis> - <property>Breakpoint</property>. </emphasis></para> + <para>Simply right click an Action or a page and select Add <guimenuitem>Breakpoint</guimenuitem>.</para> <figure> <title>Adding Breakpoint</title> <mediaobject> Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/editors.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/editors.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/editors.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -1,479 +1,469 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="editors"> - <?dbhtml filename="editors.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>Eclipse</keyword> - <keyword>Struts Tools</keyword> - <keyword>Java</keyword> - <keyword>JBoss</keyword> - </keywordset> - </chapterinfo> + <?dbhtml filename="editors.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Struts Tools</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> - <title>Editors</title> - <para>In this chapter we&apos;ll introduce you to featured graphical editors for specific - Struts files such as Struts Configuration files, Tiles files, Struts Validation files and web.xml.</para> + <title>Editors</title> + <para> + This chapter will cover the graphical editors provided for editing specific Struts files such as Struts Configuration files, Tiles files, Struts Validation files and web.xml. + </para> <section id="webxml_editor"> <title>Web.xml Editor</title> - <para>The <emphasis> - <property>web.xml</property></emphasis> file inside the <emphasis> - <property>WEB-INF</property></emphasis> folder is a deployment descriptor file for a Web Application. It - describes the servlets and other components and deployment properties that make up your application.</para> + <para> + The <filename>web.xml</filename> file inside the <filename>WEB-INF</filename> folder is a deployment descriptor file for a Web Application. It describes the servlets, other components and deployment properties that make up your application. + </para> - <para><property>JBoss Tools</property> add the <emphasis> - <property>web.xml</property></emphasis> file to created Struts project automatically and provides a special editor for its editing. - See the Visual Web Tools guide that gives a descriptive information on the <filename>web.xml</filename> editor.</para> + <para> + <property>JBoss Tools</property> adds the <filename>web.xml</filename> file to a Struts project automatically and provides a special editor through which the file can be edited. See the Visual Web Tools guide that gives a descriptive information on the <filename>web.xml</filename> editor. + </para> </section> - - <section id="struts_config_editor"> - <title>Graphical Editor for Struts Configuration Files</title> - <para>First, let&apos;s dwell on the Struts Configuration file editor.</para> - <para>This editor has three views with different representation of <emphasis> - <property>struts-config.xml</property>: </emphasis>Diagram, Tree and Source. The - views can be selected via the tabs at the bottom of the editor. Any changes made in one - view are immediately visible when you switch to any other view.</para> + <section id="struts_config_editor"> - <para>Now, we&apos;ll consider every view in more detail.</para> - <section id="StrutsDiagramMode453"> + <title>Graphical Editor for Struts Configuration Files</title> + <para>First, let&apos;s dwell on the Struts Configuration file editor.</para> + <para> + This editor provides three views of the <filename>struts-config.xml</filename> file: Diagram, Tree and Source. The views can be selected using the tabs at the bottom of the editor. Any changes made in one view are immediately visible when you switch to any other view. + </para> - <title>Diagram View</title> + <para>Now, we&apos;ll consider each of these three views in more detail.</para> + <section id="StrutsDiagramMode453"> - <para>The Diagram view graphically displays the Web flow of the application defined in - the Struts configuration file.</para> + <title>Diagram View</title> - <figure> - <title>Diagram View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_14.png"/> - </imageobject> - </mediaobject> - </figure> + <para>The Diagram view graphically displays the Web flow of the application defined in the Struts configuration file.</para> - <para>The Diagram view allows to edit navigation in your Struts application. Just by - right-clicking anywhere on the diagram, you can use a context menu to create the - building blocks of a Struts application:</para> - <itemizedlist> - <listitem> - <para>Actions</para> - </listitem> - <listitem> - <para>Global forwards</para> - </listitem> - <listitem> - <para>Global exceptions</para> - </listitem> - <listitem> - <para>JSP Pages</para> - </listitem> - </itemizedlist> + <figure> + <title>Diagram View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_14.png"/> + </imageobject> + </mediaobject> + </figure> - <figure> - <title>Diagram Context Menu</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_15.png"/> - </imageobject> - </mediaobject> - </figure> + <para> + The Diagram view provides a way to edit the navigation in your Struts application. By right-clicking anywhere on the diagram, you can use a context menu to create the building blocks of a Struts application: + </para> + <itemizedlist> + <listitem> + <para>Actions</para> + </listitem> + <listitem> + <para>Global forwards</para> + </listitem> + <listitem> + <para>Global exceptions</para> + </listitem> + <listitem> + <para>JSP Pages</para> + </listitem> + </itemizedlist> - <para>Along the upper-left side of the editor is a stack of seven icons for changing the - behavior of the cursor in the diagram. </para> + <figure> + <title>Diagram Context Menu</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_15.png"/> + </imageobject> + </mediaobject> + </figure> - <figure> - <title>Editor Icons</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_16.png"/> - </imageobject> - </mediaobject> - </figure> + <para>Along the upper-left side of the editor is a stack of seven icons for changing the behavior of the cursor in the diagram. </para> - <para>The first icon switches to the default regular selection cursor, the second to the - marquee selection cursor and the third to the new connection cursor. The last four - icons switch the cursor to an insert cursor for each type of Struts build block - listed above (and in the order listed).</para> + <figure> + <title>Editor Icons</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_16.png"/> + </imageobject> + </mediaobject> + </figure> - <para>For instance, clicking on the first of these four icons (the one with the gears) - will switch the cursor to insert actions. Clicking anywhere in the diagram with this - cursor has the same effect as right-click and selecting <emphasis> - <property>Add > Action...</property> - </emphasis> from the context menu with the regular cursor active. It&apos;s just - more efficient to use this cursor if you&apos;re adding more than one action at - once.</para> + <para> + The first icon switches to the default regular selection cursor, the second to the marquee selection cursor and the third to the new connection cursor. The last four icons switch the cursor to an insert cursor for each type of Struts build block listed above (and in the order listed). + </para> + <para> + For instance, clicking on the first of these four icons (the one with the gears) will switch the cursor to insert actions. Clicking anywhere in the diagram with this cursor has the same effect as right-click and selecting <menuchoice><guimenuitem>Add</guimenuitem><guimenuitem>Action...</guimenuitem></menuchoice> from the context menu with the regular cursor active. It&apos;s just more efficient to use this cursor if you&apos;re adding more than one action at once. + </para> - </section> - <section id="StrutsTreeMode42"> - <title>Tree View</title> + </section> + <section id="StrutsTreeMode42"> - <para>The Tree view represents the different elements of the Struts application that are organized into functional categories - on the left-hand side and a form for editing the properties of currently selected items on the right-hand side.</para> + <title>Tree View</title> + + <para> + The Tree view represents the different elements of the Struts application that are organized into functional categories on the left-hand side and a form for editing the properties of currently selected items on the right-hand side. + </para> - <figure> - <title>Tree View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_17.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>You can right-click on any node in the category tree and perform appropriate - operations through a context menu. For instance, by right-clicking on the - action-mappings category node, you can add new actions to the application.</para> + <figure> + <title>Tree View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_17.png"/> + </imageobject> + </mediaobject> + </figure> - <figure> - <title>Tree Context Menu</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_18.png"/> - </imageobject> - </mediaobject> - </figure> + <para> + You can right-click on any node in the category tree to perform a number of operations through a context menu. For instance, by right-clicking on the action-mappings category node, you can add new actions to the application. + </para> + + <figure> + <title>Tree Context Menu</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_18.png"/> + </imageobject> + </mediaobject> + </figure> - <para>Let&apos;s consider the tree on the left more closely.</para> + <para>Let&apos;s consider the tree on the left more closely.</para> - <itemizedlist> - <listitem><para>Under the <emphasis> - <property>data-sources</property></emphasis> node you can create a Data Source object that will be configured - and made available as a servlet context attribute.</para></listitem> + <itemizedlist> + <listitem> + <para> + Under the <emphasis><property>data-sources</property></emphasis> node you can create a Data Source object that will be configured and made available as a servlet context attribute. + </para> + </listitem> - <listitem><para>The <emphasis> - <property>form-beans</property></emphasis> node is meant for creating a set of form bean descriptors for this module. - Every created element under this node is a JavaBean that implements the org.apache.struts.action.ActionForm class. - Use the Properties editor on the right to adjust properties specific to every created form-bean.</para></listitem> + <listitem> + <para> + The <emphasis><property>form-beans</property></emphasis> node is meant for creating a set of form bean descriptors for this module. Every element under this node is a JavaBean that implements the <code>org.apache.struts.action.ActionForm</code> class. Use the Properties editor on the right to adjust the properties specific to each form-bean. + </para> + </listitem> - <listitem><para>The <emphasis> - <property>global-exceptions</property></emphasis> node is intended for registering the handlers for the exceptions - that might be thrown by an Action object.</para></listitem> + <listitem> + <para> + The <emphasis><property>global-exceptions</property></emphasis> node is intended for registering handlers for the exceptions that might be thrown by an Action object. + </para> + </listitem> - <listitem><para>Use the <emphasis> - <property>global-forwards</property></emphasis> node to add, edit or delete a global forwards that represent - ActionForward objects available to all Action objects as a return value.</para></listitem> + <listitem> + <para> + Use the <emphasis><property>global-forwards</property></emphasis> node to add, edit or delete a global forwards that represent ActionForward objects available to all Action objects as a return value. + </para> + </listitem> - <listitem><para>The <emphasis> - <property>controller</property></emphasis> node allows you to configure the controller properties.</para></listitem> + <listitem> + <para>The <emphasis><property>controller</property></emphasis> node allows you to configure the controller properties.</para> + </listitem> - <listitem><para>Under the <emphasis> - <property>resources</property></emphasis> node you can add, delete, or edit message resources.</para></listitem> + <listitem> + <para>Under the <emphasis><property>resources</property></emphasis> node you can add, delete, or edit message resources.</para> + </listitem> - <listitem><para>Under the <emphasis> - <property>plug-ins</property></emphasis> node you can define a Struts plug-in. Right-click the node, select <emphasis> - <property>Create Plug-in</property></emphasis> - and specify the plug-in <emphasis> - <property>Id</property></emphasis> and <emphasis> - <property>ClassName</property></emphasis> by pointing to the Java class which implements the org.apache.struts.action.PlugIn interface. </para></listitem> - - </itemizedlist> - </section> - <section id="StrutsSourceMode9655"> + <listitem> + <para> + Under the <emphasis><property>plug-ins</property></emphasis> node you can define a Struts plug-in. Right-click the node, select <guimenuitem>Create Plug-in</guimenuitem> and specify the plug-in <emphasis><property>Id</property></emphasis> and <emphasis><property>ClassName</property></emphasis> by pointing to the Java class which implements the <code>org.apache.struts.action.PlugIn</code> interface. + </para> + </listitem> + + </itemizedlist> + </section> + <section id="StrutsSourceMode9655"> - <title>Source View</title> + <title>Source View</title> - <para>In the Source view, you have complete editing control of the underlying XML - coding.</para> + <para>In the Source view, you have complete editing control of the underlying XML coding.</para> - <figure> - <title>Source View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_19.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>When working in Source view, you always have all the following features available:</para> - <itemizedlist> - <listitem> - <para>Content Assist</para> - </listitem> - <listitem> - <para>Open On Selection</para> - </listitem> - <listitem> - <para>File Folding</para> - </listitem> - </itemizedlist> - <para>You can take advantage of code assist.</para> - <figure> - <title>Code Assist</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_20.png" scale="85"/> - </imageobject> - </mediaobject> - </figure> + <figure> + <title>Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_19.png"/> + </imageobject> + </mediaobject> + </figure> - <para>The editor will also immediately flag any errors.</para> + <para>When working in Source view, you always have all the following features available:</para> + <itemizedlist> + <listitem> + <para>Content Assist</para> + </listitem> + <listitem> + <para>Open On Selection</para> + </listitem> + <listitem> + <para>File Folding</para> + </listitem> + </itemizedlist> + <para>You can take advantage of code assist.</para> + <figure> + <title>Code Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_20.png" scale="85"/> + </imageobject> + </mediaobject> + </figure> - <figure> - <title>Errors in Source View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_21.png" scale="85"/> - </imageobject> - </mediaobject> - </figure> + <para>The editor will also immediately flag any errors.</para> - <para>Finally, you can use the Outline view with the editor to easily navigate through - the file.</para> + <figure> + <title>Errors in Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_21.png" scale="85"/> + </imageobject> + </mediaobject> + </figure> - <figure> - <title>Outline View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_22.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Find more information about editor features in the editor features chapter.</para> - </section> - </section> + <para>Finally, you can use the Outline view with the editor to easily navigate through the file.</para> - <section id="GraphicalEditorForTilesFiles132"> + <figure> + <title>Outline View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_22.png"/> + </imageobject> + </mediaobject> + </figure> - <title>Graphical Editor for Tiles Files</title> - <para>Here, you&apos;ll know how to make use of the special graphical editor for Tiles configuration files.</para> - <para>The editor has three main views: Tree, Diagram and Source. - The views can be selected via the tabs at the bottom of the editor. Any changes made in - one view are immediately visible when you switch to any other view.</para> + <para>Find more information about editor features in the editor features chapter.</para> + </section> + </section> - <para>Before we consider each view of the editor, let&apos;s look at the way of creating new Tiles files.</para> - <section id="CreateNewTilesFile1422"> + <section id="GraphicalEditorForTilesFiles132"> - <title>Create New Tiles File</title> + <title>Graphical Editor for Tiles Files</title> + <para>Here, you&apos;ll know how to make use of the special graphical editor for Tiles configuration files.</para> + <para> + The editor has three main views: Tree, Diagram and Source. The views can be selected via the tabs at the bottom of the editor. Any changes made in one view are immediately visible when you switch to any other view. + </para> - <para>To create new Tiles files, right click any folder and select <emphasis> - <property>New &gt; Tiles File</property>. </emphasis></para> - <figure> - <title>Creating a New Tiles File</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_23.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - <section id="StrutsTreeView896"> + <para>Before we consider each view of the editor, let&apos;s look at the way of creating new Tiles files.</para> + <section id="CreateNewTilesFile1422"> - <title>Tree View</title> + <title>Create New Tiles File</title> - <para>The Tree view represents the different elements of the Tiles file that are - organized into functional categories on the left-hand side and a form for editing - the properties of currently selected items on the right-hand side.</para> - <figure> - <title>Tree View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_24.png"/> - </imageobject> - </mediaobject> - </figure> + <para> + To create new Tiles files, right click any folder and select <menuchoice><guimenuitem>New</guimenuitem><guimenuitem>Tiles File</guimenuitem></menuchoice>. + </para> + <figure> + <title>Creating a New Tiles File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_23.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="StrutsTreeView896"> - <para>To edit the file, simply right click any node and select among the available - actions.</para> - <figure> - <title>Editing in Tiles Editor</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_25.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - <section id="StrutsDiagramView4643"> + <title>Tree View</title> - <title>Diagram View</title> + <para> + The Tree view represents the different elements of the Tiles file organized into functional categories on the left-hand side and a form for editing the properties of currently selected items on the right-hand side. + </para> + <figure> + <title>Tree View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_24.png"/> + </imageobject> + </mediaobject> + </figure> - <para>The Diagram view allows you to create complex Tiles files in the form of a - diagram.</para> - <figure> - <title>Diagram Mode</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_26.png"/> - </imageobject> - </mediaobject> - </figure> + <para>To edit the file, simply right click any node and select from the available actions.</para> + <figure> + <title>Editing in Tiles Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_25.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="StrutsDiagramView4643"> - <para>To create new definitions, simply right click anywhere in the diagram.</para> - <figure> - <title>Creating New Definition</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_27.png"/> - </imageobject> - </mediaobject> - </figure> + <title>Diagram View</title> - <para>You can also use the Diagram toolbar to make editing easier.</para> - <figure> - <title>Diagram Toolbar</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_28.png"/> - </imageobject> - </mediaobject> - </figure> + <para>The Diagram view allows you to create complex Tiles files in the form of a diagram.</para> + <figure> + <title>Diagram Mode</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_26.png"/> + </imageobject> + </mediaobject> + </figure> - <para> It contains four icons for changing the cursor state. The first one is the - default cursor state for selecting existing nodes. The second icon is marquee - selector. The third is used for creating new connections and the last one is for - adding definition template to the content.</para> - </section> - <section id="StrutsSource75"> + <para>To create new definitions, simply right click anywhere in the diagram.</para> + <figure> + <title>Creating New Definition</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_27.png"/> + </imageobject> + </mediaobject> + </figure> - <title>Source</title> + <para>You can also use the Diagram toolbar to make editing easier.</para> + <figure> + <title>Diagram Toolbar</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_28.png"/> + </imageobject> + </mediaobject> + </figure> - <para>The other view of the <property>Tiles editor</property> is the Source view that - gives you full control over the source. Any changes here will immediately appear in - other modes when you switch to them.</para> - - <para>When working in Source view, you always have all following features available:</para> - <itemizedlist> - <listitem> - <para>Content Assist</para> - </listitem> - <listitem> - <para>Open On Selection</para> - </listitem> - </itemizedlist> - - <figure> - <title>Source View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_29.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Code - assist is available in the Source mode.</para> - <figure> - <title>Code Assist</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_30.png" scale="85"/> - </imageobject> - </mediaobject> - </figure> - <para>Any errors are immediately reported as shown below:</para> - <figure> - <title>Errors Reporting</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_31.png" scale="75"/> - </imageobject> - </mediaobject> - </figure> + <para> + It contains four icons for changing the cursor state. The first one is the default cursor state for selecting existing nodes. The second icon is marquee selector. The third is used for creating new connections and the last one is for adding definition template to the content. + </para> + </section> + <section id="StrutsSource75"> - <para>You can also use the Outline view together with the editor&apos;s Source mode. - It provides an easier navigation through the file.</para> - <figure> - <title>Outline View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_32.png" scale="85"/> - </imageobject> - </mediaobject> - </figure> - </section> - </section> + <title>Source</title> - <section id="GraphicalEditorForStrutsValidationFiles86"> + <para> + The other view of the <property>Tiles editor</property> is the Source view that gives you full control over the source. Any changes here will immediately appear in other modes when you switch to them. + </para> - <title>Graphical Editor for Struts Validation Files</title> + <para>When working in Source view, you always have all following features available:</para> + <itemizedlist> + <listitem> + <para>Content Assist</para> + </listitem> + <listitem> + <para>Open On Selection</para> + </listitem> + </itemizedlist> - <para>Providing full support for development Struts applications JBoss Tools comes with a - visual validation editor. To open the editor double-click on the validation file or if you don&apos;t have it create a new one.</para> - - <para>To create a new validation file, right click any folder in - Project Explorer and select <emphasis> - <property>File > New > Other...</property> - </emphasis>from the context menu and then <emphasis> - <property>JBoss Tools Web > Struts > Validation File</property>. </emphasis></para> - <figure> - <title>Creating New Validation File</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_33.png"/> - </imageobject> - </mediaobject> - </figure> + <figure> + <title>Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_29.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Code assist is available in the Source mode.</para> + <figure> + <title>Code Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_30.png" scale="85"/> + </imageobject> + </mediaobject> + </figure> + <para>Any errors are immediately reported as shown below:</para> + <figure> + <title>Errors Reporting</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_31.png" scale="75"/> + </imageobject> + </mediaobject> + </figure> - <para>The validation editor works with five modes: Formsets, Validators, Constants and - standard Tree and Source that you can easily switch over using tabs at the bottom of the - editor.</para> - <para>The Formsets view shows forms and their elements on the left side and the dialogue for - defining their validation rules on the right side.</para> - <figure> - <title>Formsets View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_34.png"/> - </imageobject> - </mediaobject> - </figure> + <para>You can also use the Outline view together with the editor&apos;s Source mode. It provides a way to more easily navigate through the file.</para> + <figure> + <title>Outline View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_32.png" scale="85"/> + </imageobject> + </mediaobject> + </figure> + </section> + </section> - <para>The Constants view let you set constant values for your validation rules.</para> - <figure> - <title>Constansts View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_35.png"/> - </imageobject> - </mediaobject> - </figure> + <section id="GraphicalEditorForStrutsValidationFiles86"> - <para>The validation file can also be viewed in a Tree view.</para> - <figure> - <title>Tree View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_36.png"/> - </imageobject> - </mediaobject> - </figure> + <title>Graphical Editor for Struts Validation Files</title> - <para>At any point you have full control over the source by switching to the Source view. - Any editing in this view will immediately be available in other views of the editor.</para> - <figure> - <title>Source View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_37.png" scale="85"/> - </imageobject> - </mediaobject> - </figure> + <para> + JBoss Tools comes with a visual validation editor that provides full support for the development of Struts applications. To open the editor double-click on the validation file, or create a new one if it doesn&apos;t exist. + </para> - <para>You can also open your own custom or Struts-standard <emphasis> - <property>validation-rules.xml</property> - </emphasis> file.</para> - <para>The Validators view shows the validation rules for a selected validator. You can of - course add your own rules.</para> - <figure> - <title>Validators View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_38.png" scale="75"/> - </imageobject> - </mediaobject> - </figure> - <para>Here are the validation rules shown in the Source mode.</para> - <figure> - <title>Validation Rules</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_39.png"/> - </imageobject> - </mediaobject> - </figure> - </section> + <para>To create a new validation file, right click any folder in Project Explorer and select <menuchoice><guimenuitem>File</guimenuitem><guimenuitem>New</guimenuitem><guimenuitem>Other...</guimenuitem></menuchoice> from the context menu and then select <menuchoice><guimenuitem>JBoss Tools Web</guimenuitem><guimenuitem>Struts</guimenuitem><guimenuitem>Validation File</guimenuitem></menuchoice>. + </para> + <figure> + <title>Creating New Validation File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_33.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + The validation editor works with five modes: Formsets, Validators, Constants and standard Tree and Source that you can easily switch between using tabs at the bottom of the editor. + </para> + <para>The Formsets view shows forms and their elements on the left side and the dialogue for defining their validation rules on the right side.</para> + <figure> + <title>Formsets View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_34.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The Constants view let you set constant values for your validation rules.</para> + <figure> + <title>Constants View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_35.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The validation file can also be viewed in a Tree view.</para> + <figure> + <title>Tree View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_36.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + At any point you have full control over the source by switching to the Source view. Any editing in this view will immediately be available in other views of the editor. + </para> + <figure> + <title>Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_37.png" scale="85"/> + </imageobject> + </mediaobject> + </figure> + + <para>You can also open your own custom or Struts-standard <filename>validation-rules.xml</filename> file.</para> + <para>The Validators view shows the validation rules for a selected validator. You can of course add your own rules.</para> + <figure> + <title>Validators View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_38.png" scale="75"/> + </imageobject> + </mediaobject> + </figure> + <para>Here are the validation rules shown in the Source mode.</para> + <figure> + <title>Validation Rules</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_39.png"/> + </imageobject> + </mediaobject> + </figure> + </section> </chapter> Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/introduction.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/introduction.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/introduction.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -13,23 +13,20 @@ <title>Introduction</title> - <para>If you prefer to develop web applications using Struts technology JBoss Tools also meet - your needs. The professional developer toolset provides all necessary editors and wizards - for creating Struts resources that enhances the process of building high-quality web - applications.</para> + <para> + JBoss Developer Studio provides a number of editors and wizards that allow Struts developers to quickly and efficiently build high quality web applications. + </para> <note> <title>Note:</title> <para>Note that JBoss Tools support the Struts 1.1, 1.2.x versions.</para> </note> - <para>In this guide you will learn how to take advantage of Struts support that <property>JBoss Tools</property> - provide.</para> + <para>In this guide you will learn how to take advantage of Struts support that is provided by <property>JBoss Developer Studio</property>.</para> <section id="struts_key_features"> <title>Key Features of Struts Tools</title> - <para>For a start, we propose you to look through the table of main features of Struts - Tools:</para> + <para>The table below lists the main features provided by Struts Tools:</para> <table> @@ -50,23 +47,24 @@ <tbody> <row> <entry><para>Struts Support</para></entry> - <entry><para>Step-by-step wizards for creating a new struts project with a number - of predefined templates, importing existing ones and adding struts - capabilities to non-struts web projects.</para></entry> <entry> + <para> + Step-by-step wizards for creating a new Struts project with a number of predefined templates, importing existing ones and adding struts capabilities to non-Struts web projects. + </para> + </entry> + <entry> <xref linkend="projects"/> </entry> </row> <row> <entry><para>Support for Struts Configuration File</para></entry> - <entry><para>Working on file using three modes: diagram, tree and source. - Synchronization between the modes and full control over the code. Easy - moving around the diagram using the Diagram Navigator. Working with - struts projects that have multiple modules. Possibility to use Struts - configuration file debugger allowing to set break points on struts - diagram and then launch the server in debug mode.</para></entry> <entry> + <para> + Working on files using three modes: diagram, tree and source. Synchronization between the modes and full control over the code. Easily move around the diagram using the Diagram Navigator. Working with struts projects that have multiple modules. The option to use thee Struts configuration file debugger, which allows break points to be set on a Struts diagram and then launch the server in debug mode. + </para> + </entry> + <entry> <xref linkend="struts_config_editor"/> <xref linkend="config_file_debugger"/> </entry> @@ -74,21 +72,24 @@ <row> <entry><para>Support for Struts modules</para></entry> - <entry><para>A Struts module (struts-config.xml) is automatically created while - creating a new project. There is also possibility to add new ones or edit - already existing modules in your existing project or while importing Struts project.</para></entry> <entry> + <para> + A Struts module (<filename>struts-config.xml</filename>) is automatically created when creating a new project. There is also the option to add new or edit already existing modules in your existing project or while importing Struts project. + </para> + </entry> + <entry> <xref linkend="modules"/> </entry> </row> <row> <entry><para>Verification and Validation</para></entry> - <entry><para>All occurring errors will be immediately reported by verification - feature, no matter in what view you are working. Constant validation and - errors checking allows to catch many of the errors during development - process that significantly reduces development time.</para></entry> <entry> + <para> + All errors will be immediately reported by verification feature, no matter which view you are working in. Constant validation and errors checking allows developers to catch many of the errors during development process, which significantly reduces development time. + </para> + </entry> + <entry> <xref linkend="project_verification"/> </entry> @@ -102,7 +103,9 @@ <section> <title>Other relevant resources on the topic</title> - <para>All JBoss Developer Studio/JBoss Tools documentation you can find on<ulink url="http://docs.jboss.org/tools/">JBoss Tools project page </ulink>.</para> + <para> + All JBoss Developer Studio/JBoss Tools documentation you can find on<ulink url="http://docs.jboss.org/tools/">JBoss Tools project page </ulink>. + </para> <para>The latest documentation builds are available on<ulink url="http://download.jboss.org/jbosstools/nightly-docs/">nig... docs page</ulink>.</para> </section> Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/master.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/master.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/master.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -56,12 +56,12 @@ Version: 3.1.1.GA </releaseinfo> -<abstract> +<!--<abstract> <title/> <para> <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/struts_too... version</ulink> </para> -</abstract> +</abstract> --> </bookinfo> Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/modules.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/modules.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/modules.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -13,15 +13,13 @@ <title>Modules</title> - <para>JBoss Tools support working with Struts projects that have - multiple modules. You can easily do the following:</para> + <para>JBoss Tools supports working with Struts projects that have multiple modules. You can easily do the following:</para> <itemizedlist> <listitem> <para>Add new modules</para> </listitem> <listitem> - <para>Edit modules for an existing project or during Struts project - import</para> + <para>Edit modules for an existing project or during Struts project import</para> </listitem> </itemizedlist> <para>Now, let&apos;s discuss this functionality in more detail.</para> @@ -29,9 +27,9 @@ <title>When Importing a Struts Project</title> - <para>During Struts project import, if the project has multiple modules, you - will see a screen with all existing modules. You can select each - module and edit its details.</para> + <para> + During Struts project import, if the project has multiple modules, you will see a screen with all existing modules. You can select each module and edit its details. + </para> <figure> <title>Configuring Project Modules</title> @@ -45,14 +43,7 @@ <section id="EditingModulesInAnExistingProject1"> <title>Editing Modules in an Existing Project</title> - <para>To edit modules in an existing project, right click the project in Web Project view - and select <emphasis> - <property>JBoss Tools Struts > Modules Configuration</property> - </emphasis> - (or right click the project in Package Explorer view - and select <emphasis> - <property>Configure > Modules Configuration</property> - </emphasis>). + <para>To edit modules in an existing project, right click the project in Web Project view and select <menuchoice><guimenuitem>JBoss Tools Struts</guimenuitem><guimenuitem>Modules Configuration</guimenuitem></menuchoice> (or right click the project in Package Explorer view and select <menuchoice><guimenuitem>Configure</guimenuitem><guimenuitem>Modules Configuration</guimenuitem></menuchoice>). </para> <figure> <title>Choosing Modules Configuration</title> @@ -62,8 +53,7 @@ </imageobject> </mediaobject> </figure> - <para>You will see the same screen as above where you will be able to select - a module and edit its details.</para> + <para>You will see the same screen as above where you will be able to select a module and edit its details.</para> <figure> <title>Modules Configuration</title> <mediaobject> @@ -77,11 +67,9 @@ <title>Adding New Modules</title> - <para>Adding a new module is very simple. First switch to Web Project view. - Expand your project to the Configuration folder. Under that folder - you should see the current modules. Right click on Configuration and - select <emphasis> - <property>New > Struts Config</property>. </emphasis></para> + <para> + Adding a new module is very simple. First switch to Web Project view. Expand your project to the Configuration folder. Under that folder you should see the current modules. Right click on Configuration and select <menuchoice><guimenuitem>New</guimenuitem><guimenuitem>Struts Config</guimenuitem></menuchoice>. + </para> <figure> <title>Adding New Modules</title> <mediaobject> @@ -90,8 +78,9 @@ </imageobject> </mediaobject> </figure> - <para>You will see the screen below. You can specify a new module name and - also add the new Struts configuration file to web.xml file.</para> + <para> + You will see the screen below. You can specify a new module name and also add the new Struts configuration file to the <filename>web.xml</filename> file. + </para> <figure> <title>Adding New Modules</title> <mediaobject> Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/page_links_recognizer.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/page_links_recognizer.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/page_links_recognizer.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -13,13 +13,8 @@ <title>Customizable Page Links Recognizer</title> - <para><property>Custom page links</property> allow you to define custom Struts page - links that will be recognizable in the Struts application diagram. You can - define these links by selecting <emphasis> - <property>Window > Preferences</property> - </emphasis> from the menu bar and then selecting <emphasis> - <property>JBoss Tools > Web > Struts > Customization</property> - </emphasis> from the Preferences dialog box.</para> + <para> + <property>Custom page links</property> allow you to define custom Struts page links that will be recognizable in the Struts application diagram. You can define these links by selecting <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem></menuchoice> from the menu bar and then selecting <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Struts</guimenuitem><guimenuitem>Customization</guimenuitem></menuchoice> from the Preferences dialog box.</para> <figure> <title>Customization Panel</title> <mediaobject> Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/project_verification.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/project_verification.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/project_verification.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -1,117 +1,89 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="project_verification"> - <?dbhtml filename="project_verification.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>Eclipse</keyword> - <keyword>Struts Tools</keyword> - <keyword>Java</keyword> - <keyword>JBoss</keyword> - </keywordset> - </chapterinfo> - - <title>Struts Project Verification</title> - - <para>In this section we&apos;ll consider one more functionality that JBoss Tools provide for Struts - projects, namely adjusting projects verification.</para> - - <para>To configure Struts project verification select <emphasis> - <property>Window > Preferences</property> - </emphasis> from the menu bar, select <emphasis> - <property>JBoss Tools > Web > Verification</property> - </emphasis> from the Preferences dialog box and then expand the - Struts Rules node.</para> - <figure> - <title>Struts Rules</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_8.png" - /> - </imageobject> - </mediaobject> - </figure> - <para>Suppose you are working in the Source viewer for a Struts - configuration file as shown below:</para> - <figure> - <title>Struts Configuration File</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_9.png" - /> - </imageobject> - </mediaobject> - </figure> - <para>While typing a class name or entering it from the graphical editor, - you might make a minor typo (like <emphasis role="italic"> - <property>&quot;sample.GreetingAction1&quot;</property> - </emphasis> instead of <emphasis role="italic"> - <property>&quot;sample.GreetingAction&quot;</property> - </emphasis>). After saving the file, - <property>verification</property> checks to make sure everything is - correct and finds the error below:</para> - <figure> - <title>Error Reporting</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_10.png" - scale="75"/> - </imageobject> - </mediaobject> - </figure> - <para>Notice that the Package Explorer View shows a marked folder and a - marked file where the error is.</para> - <para>You can place the cursor over the line with the error to view a - detailed error message:</para> - <figure> - <title>Error Message</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_11.png" - /> - </imageobject> - </mediaobject> - </figure> - <para>The verification also checks to make sure you have specified the - correct JSP page for the forward:</para> - <figure> - <title>JSP Page Verification</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_12.png" - scale="75"/> - </imageobject> - </mediaobject> - </figure> - <para>Once you place the cursor over the line, you can see the error - message:</para> - <figure> - <title>Error Message</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_13.png" - /> - </imageobject> - </mediaobject> - </figure> - <para>You can always invoke the verification by switching to the Diagram - viewer, right-clicking and selecting <emphasis> - <property>Verify</property> - </emphasis> from the context menu:</para> - <figure> - <title>Verify Command</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_14.png" - /> - </imageobject> - </mediaobject> - </figure> + <?dbhtml filename="project_verification.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Struts Tools</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Struts Project Verification</title> + + <para> + This section covers the Struts project verification functionality provided by JBoss Tools. + </para> + <para> + To configure Struts project verification select <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem></menuchoice> from the menu bar, select <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Verification</guimenuitem></menuchoice> from the Preferences dialog box, and then expand the Struts Rules node. + </para> + <figure> + <title>Struts Rules</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_8.png" /> + </imageobject> + </mediaobject> + </figure> + <para>Suppose you are working in the Source viewer for a Struts configuration file as shown below:</para> + <figure> + <title>Struts Configuration File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_9.png" /> + </imageobject> + </mediaobject> + </figure> + <para> + While typing a class name or entering it from the graphical editor, you might make a minor typo (like <emphasis role="italic"><property>&quot;sample.GreetingAction1&quot;</property></emphasis> instead of <emphasis role="italic"><property>&quot;sample.GreetingAction&quot;</property></emphasis>). After saving the file, it is verified to make sure everything is correct and finds the error shown below: + </para> + <figure> + <title>Error Reporting</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_10.png" scale="75"/> + </imageobject> + </mediaobject> + </figure> + <para>Notice that the Package Explorer View shows a marked folder and a marked file to indicate where the error is.</para> + <para>You can place the cursor over the line with the error to view a detailed error message:</para> + <figure> + <title>Error Message</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_11.png" /> + </imageobject> + </mediaobject> + </figure> + <para>The verification process also checks to make sure you have specified the correct JSP page for the forward:</para> + <figure> + <title>JSP Page Verification</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_12.png" scale="75"/> + </imageobject> + </mediaobject> + </figure> + <para>Once you place the cursor over the line, you can see the error message:</para> + <figure> + <title>Error Message</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_13.png" /> + </imageobject> + </mediaobject> + </figure> + <para> + You can always invoke the verification process by switching to the Diagram viewer, right-clicking and selecting <guimenuitem>Verify</guimenuitem> from the context menu: + </para> + <figure> + <title>Verify Command</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_14.png" /> + </imageobject> + </mediaobject> + </figure> </chapter> \ No newline at end of file Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/projects.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/projects.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/projects.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -1,275 +1,238 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="projects"> - <?dbhtml filename="projects.html"?> + <?dbhtml filename="projects.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>Eclipse</keyword> - <keyword>Java</keyword> - <keyword>JBoss</keyword> - </keywordset> - </chapterinfo> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> - <title>Projects</title> + <title>Projects</title> - <para>JBoss Tools provide the following functionality when working with Struts:</para> + <para>JBoss Tools provides the following functionality when working with Struts:</para> - <itemizedlist> - <listitem> - <para>Create new <property>Struts projects</property></para> - </listitem> - <listitem> - <para>Import (open) existing Struts projects. You can import any project - structure</para> - </listitem> - <listitem> - <para>Add <property>Struts capabilities</property> to any existing Eclipse - project</para> - </listitem> - <listitem> - <para>Import and add Struts capabilities to any existing project created outside - Eclipse.</para> - </listitem> - </itemizedlist> - <para>Now, we&apos;ll focus on all these points more fully.</para> + <itemizedlist> + <listitem> + <para>Create new <property>Struts projects</property></para> + </listitem> + <listitem> + <para>Import (open) existing Struts projects. You can import any project structure</para> + </listitem> + <listitem> + <para>Add <property>Struts capabilities</property> to any existing Eclipse project</para> + </listitem> + <listitem> + <para>Import and add Struts capabilities to any existing project created outside Eclipse.</para> + </listitem> + </itemizedlist> + <para>Now, we&apos;ll focus on all these points more fully.</para> - <section id="CreatingANewStrutsProjec745t"> + <section id="CreatingANewStrutsProjec745t"> - <title>Creating a New Struts Project</title> + <title>Creating a New Struts Project</title> - <para>JBoss Tools provides a New Struts Project Wizard that radically simplifies the process - for getting started with a new Struts project. You just need to follow these steps:</para> - <itemizedlist> - <listitem> - <para>Select<emphasis> - <property>File > New > Project...</property> - </emphasis> from the menu bar. Then, select <emphasis> - <property>JBoss Tools Web > Struts > Struts Project</property> - </emphasis> in this dialog box. Click <emphasis> - <property>Next</property>: </emphasis></para> - </listitem> - </itemizedlist> - <figure> - <title>Selecting Struts Wizard</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_2.png"/> - </imageobject> - </mediaobject> - </figure> - <itemizedlist> - <listitem> - <para>On this form, provide the <property>Project Name</property>. You can also - select where to create the project or use the default path.</para> - <para>Next to <property>Struts Environment</property> set which Struts version to - use.</para> - </listitem> - </itemizedlist> + <para> + JBoss Tools provides a <guilabel>New Struts Project</guilabel> Wizard that significantly simplifies the process of creating a new Struts project. You just need to follow these steps: + </para> + <itemizedlist> + <listitem> + <para> + Select <menuchoice><guimenuitem>File</guimenuitem><guimenuitem>New</guimenuitem><guimenuitem>Project...</guimenuitem></menuchoice> from the menu bar. Then, select <menuchoice><guimenuitem>JBoss Tools Web</guimenuitem><guimenuitem>Struts</guimenuitem><guimenuitem>Struts Project</guimenuitem></menuchoice> from the dialog box. Click the <guibutton>Next</guibutton> button: + </para> + </listitem> + </itemizedlist> + <figure> + <title>Selecting Struts Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_2.png"/> + </imageobject> + </mediaobject> + </figure> + <itemizedlist> + <listitem> + <para>On this form, provide the <property>Project Name</property>. You can also select where to create the project, or use the default path.</para> + <para>The <property>Struts Environment</property> sets the Struts version that will be used.</para> + </listitem> + </itemizedlist> - <figure> - <title>Creating Struts Project</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_3.png"/> - </imageobject> - </mediaobject> - </figure> + <figure> + <title>Creating Struts Project</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_3.png"/> + </imageobject> + </mediaobject> + </figure> - <note> - <title>Tip:</title> - <para>Don&apos;t put spaces in project names since some OS could experience problems - with their processing and searching these files.</para> - </note> + <note> + <title>Tip:</title> + <para>Don&apos;t put spaces in project names since some operating systems may experience problems processing and searching for these files.</para> + </note> - <para>You can select the KickStart template, then the project created will include a simple - Hello World type application that is ready to run.</para> + <para>You can select the KickStart template, which results in a project that includes a simple Hello World type application that is ready to run.</para> - <figure> - <title>Choosing Struts Template </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_3_1.png"/> - </imageobject> - </mediaobject> - </figure> + <figure> + <title>Choosing Struts Template </title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_3_1.png"/> + </imageobject> + </mediaobject> + </figure> - <itemizedlist> - <listitem> - <para>Next, you register this application with the current servlet container defined - for your workspace (JBoss AS, by default) in order to allow you to test your - application more easily while still developing it. A new entry will be added in - the servlet container configuration file to enable running the application - in-place (called null deployment or link deployment). Uncheck the <emphasis - role="italic"> - <property>&quot;Target Server&quot;</property> - </emphasis> check box if for some reason you don&apos;t want to register - your application at this point.</para> - </listitem> - </itemizedlist> - <figure> - <title>Registering The Project at Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_4.png"/> - </imageobject> - </mediaobject> - </figure> - <itemizedlist> - <listitem> - <para>On the next form, you can select the TLD files to include in this - project:</para> - </listitem> - </itemizedlist> - <figure> - <title>Selecting Tag Libraries</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_5.png"/> - </imageobject> - </mediaobject> - </figure> + <itemizedlist> + <listitem> + <para>Next, you register this application with the current servlet container defined for your workspace (JBoss AS, by default) in order to allow you to easily test your application while still developing it. A new entry will be added in the servlet container configuration file to enable the application to be run in-place (called null deployment or link deployment). Uncheck the <emphasis role="italic"> <property>&quot;Target Server&quot;</property></emphasis> check box if you prefer not to register your application at this point.</para> + </listitem> + </itemizedlist> + <figure> + <title>Registering The Project at Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_4.png"/> + </imageobject> + </mediaobject> + </figure> + <itemizedlist> + <listitem> + <para>On the next form, you can select the TLD files to include in this project:</para> + </listitem> + </itemizedlist> + <figure> + <title>Selecting Tag Libraries</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_5.png"/> + </imageobject> + </mediaobject> + </figure> - <para>After the project is created, you should have the following project structure (if you - used the KickStart template):</para> + <para>After the project is created, you should have the following project structure (if you used the KickStart template):</para> - <figure> - <title>Project Structure</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_6.png"/> - </imageobject> - </mediaobject> - </figure> + <figure> + <title>Project Structure</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_6.png"/> + </imageobject> + </mediaobject> + </figure> - <note> - <title>Tip:</title> - <para>If you want to hide the jar files from Web App Libraries in view, select the - down-pointing arrow in the upper right corner, select - <emphasis>Filters...</emphasis>, check the box next to Name filter patterns - (matching names will be hidden), and type *.jar into the field. Then, click OK. - </para> - </note> - </section> - <section id="ImportingAnExistingStrutsProjectWithAnyStructure9653"> + <note> + <title>Tip:</title> + <para> + If you want to hide the JAR files from Web App Libraries in view, select the down-pointing arrow in the upper right corner, select <guimenuitem>Filters...</guimenuitem>, check the box next to Name filter patterns (matching names will be hidden), and type *.jar into the field. Then, click the <guibutton>OK</guibutton> button. + </para> + </note> + </section> + <section id="ImportingAnExistingStrutsProjectWithAnyStructure9653"> - <title>Importing an Existing Struts Project with Any Structure</title> + <title>Importing an Existing Struts Project with Any Structure</title> - <para>For detailed information on migration projects to JBoss Developer Studio see the Migration Guide.</para> + <para>For detailed information on migration projects to JBoss Developer Studio see the Migration Guide.</para> - </section> - <section id="AddingStrutsCapabilityToAnExistingWebApplication532"> + </section> + <section id="AddingStrutsCapabilityToAnExistingWebApplication532"> - <title>Adding Struts Capability to an Existing Web Application</title> + <title>Adding Struts Capability to an Existing Web Application</title> - <para>Here, we&apos;ll consider how to add Struts functionality (Struts libraries, tag - libraries and a Struts configuration file) to any existing Web application project in - your Eclipse workspace.</para> + <para> + This section will describe how to add Struts functionality (Struts libraries, tag libraries and a Struts configuration file) to any existing Web application project in your Eclipse workspace. + </para> - <para>By adding a Struts Nature to your project, you can now edit files using JBoss Tools - editors, such as the <link linkend="struts_config_editor">Struts configuration - editor</link> and the JBoss Tools JSP editor. To take advantage of this just right-click - the project and select <emphasis> - <property>JBoss Tools > Add Struts Capabilities</property> - </emphasis> from the context menu. This will start the process of adding all necessary - libraries and files to make a Web Struts project from your one.</para> + <para>By adding a Struts Nature to your project, you can now edit files using JBoss Tools editors, such as the <link linkend="struts_config_editor">Struts configuration editor</link> and the JBoss Tools JSP editor. To take advantage of this just right-click the project and select <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Add Struts Capabilities</guimenuitem></menuchoice> from the context menu. This will start the process of adding all the necessary Struts libraries and files to your existing project.</para> - <figure> - <title>Adding Struts Capabilities</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_7.png"/> - </imageobject> - </mediaobject> - </figure> + <figure> + <title>Adding Struts Capabilities</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_7.png"/> + </imageobject> + </mediaobject> + </figure> - <para>In the wizard you should point to location of your deployment descriptor file web.xml - and name of the project.</para> + <para>In the wizard you should point to the location of your deployment descriptor file <filename>web.xml</filename> and name of the project.</para> - <figure> - <title>Choosing Project Location</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_8.png"/> - </imageobject> - </mediaobject> - </figure> - <para>After hitting <emphasis> - <property>Next</property>, </emphasis> you will see the following screen. This - screen simply means that you need to add at least one Struts module to your project to - make this project a Struts project. Adding a Struts module means that a new - struts-config.xml will be added to your project and registered in the web.xml file. In - addition, all required Struts libraries will be added. To add a Struts module, select - the <emphasis> - <property>Add Struts Support</property> - </emphasis> button.</para> - <figure> - <title>Project Modules</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_9.png"/> - </imageobject> - </mediaobject> - </figure> + <figure> + <title>Choosing Project Location</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_8.png"/> + </imageobject> + </mediaobject> + </figure> + <para> + After clicking the <guibutton>Next</guibutton> button you will see the following screen. This screen simply indicates that you need to add at least one Struts module to your project to make this project a Struts project. Adding a Struts module means that a new <filename>struts-config.xml</filename> will be added to your project and registered in the <filename>web.xml</filename> file. In addition, all required Struts libraries will be added. To add a Struts module, click the <guibutton>Add Struts Support</guibutton> button. + </para> + <figure> + <title>Project Modules</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_9.png"/> + </imageobject> + </mediaobject> + </figure> - <para>Here you can select what Struts <property>Version</property>, <property>Servlet - Class</property>, <property>URL Pattern</property> and <property>TLD</property>s to add - to this project.</para> + <para> + Here you can select which Struts <property>Version</property>, <property>Servlet Class</property>, <property>URL Pattern</property> and <property>TLD</property>s to add to this project. + </para> - <figure> - <title>Selecting Struts Support Options</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_10.png"/> - </imageobject> - </mediaobject> - </figure> + <figure> + <title>Selecting Struts Support Options</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_10.png"/> + </imageobject> + </mediaobject> + </figure> - <para>When done, you will see the default Struts module configuration information. See how - to Edit <link linkend="modules">Struts modules</link>.</para> + <para>When done, you will see the default Struts module configuration information. See how to Edit <link linkend="modules">Struts modules</link>.</para> - <figure> - <title>Project Configuration Information</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_11.png"/> - </imageobject> - </mediaobject> - </figure> + <figure> + <title>Project Configuration Information</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_11.png"/> + </imageobject> + </mediaobject> + </figure> - <para>On the last screen you can set the different folders for your project as well as - register this application with a servlet container. If you want the libraries (.jar - files) will be automatically added to your project, click on the checkbox <emphasis> - <property>Add Libraries</property>.</emphasis></para> + <para> + On the last screen you can set the different folders for your project as well as register this application with a servlet container. If you want the libraries (.jar files) to be automatically added to your project, tick the <guilabel>Add Libraries</guilabel> checkbox. + </para> - <figure> - <title>Registering the Project at Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_12.png"/> - </imageobject> - </mediaobject> - </figure> + <figure> + <title>Registering the Project at Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_12.png"/> + </imageobject> + </mediaobject> + </figure> - <para>When done, you can open and edit the struts-config.xml file using useful Struts - configuration file editor provided by JBDS. (The Struts configuration is shown below in - the Tree viewer).</para> + <para>When done, you can open and edit the <filename>struts-config.xml</filename> file using useful Struts configuration file editor provided by JBDS. (The Struts configuration is shown below in the Tree viewer).</para> - <figure> - <title>Struts-config.xml File</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts/struts_13.png" scale="75"/> - </imageobject> - </mediaobject> - </figure> - </section> + <figure> + <title>Struts-config.xml File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_13.png" scale="75"/> + </imageobject> + </mediaobject> + </figure> + </section> - <section> - <title>Relevant Resources Links</title> - - <para>You can find more in-depth explanation on how to work with special wizards, editors and views that can - be used in various scenarios while developing Struts applications in our Visual Web Tools Guide.</para> - </section> + <section> + <title>Relevant Resources Links</title> + + <para> + You can find more in-depth explanation on how to work with special wizards, editors and views that can be used in various scenarios while developing Struts applications in our Visual Web Tools Guide. + </para> + </section> </chapter> Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/rel_resources_links.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/rel_resources_links.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/rel_resources_links.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -1,33 +1,25 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="rel_resources_links"> - <?dbhtml filename="rel_resources_links.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>Eclipse</keyword> - <keyword>Struts Tools</keyword> - <keyword>Java</keyword> - <keyword>JBoss</keyword> - </keywordset> - </chapterinfo> + <?dbhtml filename="rel_resources_links.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Struts Tools</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> - <title>Relevant Resources Links</title> + <title>Relevant Resources Links</title> - <para>Find out necessary information on <ulink url="http://struts.apache.org/">Struts - technology</ulink> if you don&apos;t know enough.</para> + <para>More information on Struts can be found on the <ulink url="http://struts.apache.org/">Struts website</ulink>.</para> - <para>In summary, this reference should help you to get familiar with those parts of - <property>JBoss Tools</property> which are meant for development with Struts - technology. If you&apos;ve carefully gone through the document, you should know - now how to create/import Struts project or enable Struts capabilities for an - existing web project as well as organize and edit all necessary staff for your - Struts application using a set of views and editors provided by <property>JBoss - Tools</property>.</para> + <para> + This reference has been designed to help you become familiar with those parts of <property>JBoss Tools</property> which assist in developing using Struts technology. It covers how to create and import Struts projects, enable Struts capabilities for an existing web project, as well as organize and edit all necessary the necessary files in your Struts application using the views and editors provided by <property>JBoss Tools</property>. + </para> - <para>If you&apos;d like to contribute your feedback is always appreciated. You can - leave your questions and suggestions on our <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... - >Forum</ulink>.</para> - <para>We hope, this guide helped you to get started with the JBoss Struts Tools. Besides, for additional information you are welcome on <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... forum</ulink>.</para> + <para> + Feedback is always appreciated. You can leave your questions and suggestions on our <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&...;. + </para> </chapter> Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/struts_project_verification.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/struts_project_verification.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/en-US/struts_project_verification.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -1,115 +1,86 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="struts_project_verification"> - <?dbhtml filename="struts_project_verification.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>Eclipse</keyword> - <keyword>Struts Tools</keyword> - <keyword>Java</keyword> - <keyword>JBoss</keyword> - </keywordset> - </chapterinfo> - - <title>Struts Project Verification</title> - - <para>JBoss Developer Studio provides the same functionality for Struts - projects. To configure Struts project verification select <emphasis> - <property>Window > Preferences</property> - </emphasis> from the menu bar, select <emphasis> - <property>JBoss Tools > Web > Verification</property> - </emphasis> from the Preferences dialog box and then expand the - Struts Rules node.</para> - <figure> - <title>Struts Rules</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_8.png" - /> - </imageobject> - </mediaobject> - </figure> - <para>Suppose you are working in the Source viewer for a Struts - configuration file as shown below:</para> - <figure> - <title>Struts Configuration File</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_9.png" - /> - </imageobject> - </mediaobject> - </figure> - <para>While typing a class name or entering it from the graphical editor, - you might make a minor typo (like <emphasis role="italic"> - <property>&quot;sample.GreetingAction1&quot;</property> - </emphasis> instead of <emphasis role="italic"> - <property>&quot;sample.GreetingAction&quot;</property> - </emphasis>). After saving the file, - <property>verification</property> checks to make sure everything is - correct and finds the error below:</para> - <figure> - <title>Error Reporting</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_10.png" - scale="75"/> - </imageobject> - </mediaobject> - </figure> - <para>Notice that the Package Explorer View shows a marked folder and a - marked file where the error is.</para> - <para>You can place the cursor over the line with the error to view a - detailed error message:</para> - <figure> - <title>Error Message</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_11.png" - /> - </imageobject> - </mediaobject> - </figure> - <para>The verification also checks to make sure you have specified the - correct JSP page for the forward:</para> - <figure> - <title>JSP Page Verification</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_12.png" - scale="75"/> - </imageobject> - </mediaobject> - </figure> - <para>Once you place the cursor over the line, you can see the error - message:</para> - <figure> - <title>Error Message</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_13.png" - /> - </imageobject> - </mediaobject> - </figure> - <para>You can always invoke the verification by switching to the Diagram - viewer, right-clicking and selecting <emphasis> - <property>Verify</property> - </emphasis> from the context menu:</para> - <figure> - <title>Verify Command</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/verif_valid/verif_valid_14.png" - /> - </imageobject> - </mediaobject> - </figure> + <?dbhtml filename="struts_project_verification.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Struts Tools</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Struts Project Verification</title> + + <para> + JBoss Developer Studio provides the same functionality for Struts projects. To configure Struts project verification select <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem></menuchoice> from the menu bar, select <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Verification</guimenuitem></menuchoice> from the Preferences dialog box and then expand the Struts Rules node. + </para> + <figure> + <title>Struts Rules</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_8.png" /> + </imageobject> + </mediaobject> + </figure> + <para>Suppose you are working in the Source viewer for a Struts configuration file as shown below:</para> + <figure> + <title>Struts Configuration File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_9.png" /> + </imageobject> + </mediaobject> + </figure> + <para> + While typing a class name or entering it from the graphical editor, you might make a minor typo (like <emphasis role="italic"><property>&quot;sample.GreetingAction1&quot;</property></emphasis> instead of <emphasis role="italic"><property>&quot;sample.GreetingAction&quot;</property></emphasis>). After saving the file, <property>verification</property> checks to make sure everything is correct and finds the error below: + </para> + <figure> + <title>Error Reporting</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_10.png" scale="75"/> + </imageobject> + </mediaobject> + </figure> + <para>Notice that the Package Explorer View shows a marked folder and a marked file where the error is.</para> + <para>You can place the cursor over the line with the error to view a detailed error message:</para> + <figure> + <title>Error Message</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_11.png" /> + </imageobject> + </mediaobject> + </figure> + <para>The verification also checks to make sure you have specified the correct JSP page for the forward:</para> + <figure> + <title>JSP Page Verification</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_12.png" scale="75"/> + </imageobject> + </mediaobject> + </figure> + <para>Once you place the cursor over the line, you can see the error message:</para> + <figure> + <title>Error Message</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_13.png" /> + </imageobject> + </mediaobject> + </figure> + <para> + You can always invoke the verification by switching to the Diagram viewer, right-clicking and selecting <guimenuitem>Verify</guimenuitem> from the context menu: + </para> + <figure> + <title>Verify Command</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_14.png" /> + </imageobject> + </mediaobject> + </figure> </chapter> \ No newline at end of file Modified: branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/pom.xml =================================================================== --- branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/pom.xml 2011-07-18 02:45:08 UTC (rev 32985) +++ branches/jbosstools-3.2.x/struts/docs/struts_tools_ref_guide/pom.xml 2011-07-18 02:48:03 UTC (rev 32986) @@ -1,7 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<project xmlns="http://maven.apache.org/POM/4.0.0" - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> +<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>org.jboss.tools</groupId> @@ -10,229 +8,232 @@ <packaging>jdocbook</packaging> <name>${bookname}-(${translation})</name> - <properties> - <translation>en-US</translation> - <docname>Struts_Tools_Reference_Guide</docname> - <bookname>Struts Tools Reference Guide</bookname> - </properties> - - <profiles> + <properties> + <translation>en-US</translation> + <docname>Struts_Tools_Reference_Guide</docname> + <bookname>Struts Tools Reference Guide</bookname> + </properties> + <profiles> + <!-- mvn compile --> - <profile> - <id>all</id> - <activation> - <activeByDefault>true</activeByDefault> - </activation> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.3.3</version> - <extensions>true</extensions> - <configuration> - <formats> - <format> - <formatName>pdf</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${docname}.pdf</finalName> - </format> - <format> - <formatName>html</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>html_single</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>eclipse</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> + <profile> + <id>all</id> + <activation> + <activeByDefault>true</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.3.4</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${docname}.pdf</finalName> + </format> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>html_single</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>eclipse</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + <options> + <useRelativeImageUris>true</useRelativeImageUris> + </options> + </configuration> + </plugin> </plugins> </build> </profile> <!-- mvn compile -Phtml --> - <profile> - <id>html</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.3.3</version> - <extensions>true</extensions> - <configuration> - <formats> - <format> - <formatName>html</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> + <profile> + <id>html</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.3.3</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> </plugins> </build> </profile> <!-- mvn compile -Phtml-single --> - <profile> - <id>html-single</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.3.3</version> - <extensions>true</extensions> - </plugin> + <profile> + <id>html-single</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.3.3</version> + <extensions>true</extensions> + </plugin> </plugins> </build> </profile> <!-- mvn compile -Ppdf --> - <profile> - <id>pdf</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.3.3</version> - <extensions>true</extensions> - <configuration> - <formats> - <format> - <formatName>pdf</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${docname}.pdf</finalName> - </format> - </formats> - </configuration> - </plugin> + <profile> + <id>pdf</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.3.3</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${docname}.pdf</finalName> + </format> + </formats> + </configuration> + </plugin> </plugins> </build> </profile> <!-- mvn compile -Peclipse --> - <profile> - <id>eclipse</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.3.3</version> - <extensions>true</extensions> - <configuration> - <formats> - <format> - <formatName>eclipse</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> + <profile> + <id>eclipse</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.3.3</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>eclipse</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> - </profiles> - <build> - <pluginManagement> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.3.3</version> - <extensions>true</extensions> - <dependencies> - <dependency> - <groupId>org.jboss.pressgang</groupId> - <artifactId>pressgang-xslt</artifactId> - <version>1.2.0</version> - </dependency> - <dependency> - <groupId>org.jboss</groupId> - <artifactId>jbossorg-jdocbook-style</artifactId> - <version>1.1.1</version> - <type>jdocbook-style</type> - </dependency> - </dependencies> - <configuration> - <sourceDirectory>${project.basedir}</sourceDirectory> + </profiles> + <build> + <pluginManagement> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.3.3</version> + <extensions>true</extensions> + <dependencies> + <dependency> + <groupId>org.jboss.pressgang</groupId> + <artifactId>pressgang-xslt</artifactId> + <version>1.2.0</version> + </dependency> + <dependency> + <groupId>org.jboss</groupId> + <artifactId>jbossorg-jdocbook-style</artifactId> + <version>1.1.1</version> + <type>jdocbook-style</type> + </dependency> + </dependencies> + <configuration> + <sourceDirectory>${project.basedir}</sourceDirectory> <!-- <sourceDocumentName>${docname}.xml</sourceDocumentName> --> - <sourceDocumentName>master.xml</sourceDocumentName> - <masterTranslation>en-US</masterTranslation> - <imageResource> - <directory>${project.basedir}/en-US</directory> - <includes> - <include>images/**/*</include> - </includes> - </imageResource> - <formats> - <format> - <formatName>pdf</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${pdf.name}</finalName> - </format> - <format> - <formatName>html</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>html_single</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>eclipse</formatName> - <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - <options> - <xincludeSupported>true</xincludeSupported> - <xmlTransformerType>saxon</xmlTransformerType> - <docbookVersion>1.72.0</docbookVersion> - <localeSeparator>-</localeSeparator> - <transformerParameters> - <property> - <name>javax.xml.parsers.DocumentBuilderFactory</name> - <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value> - </property> - <property> - <name>javax.xml.parsers.SAXParserFactory</name> - <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value> - </property> - </transformerParameters> - </options> - </configuration> - </plugin> - </plugins> - </pluginManagement> - </build> + <sourceDocumentName>master.xml</sourceDocumentName> + <masterTranslation>en-US</masterTranslation> + <imageResource> + <directory>${project.basedir}/en-US</directory> + <includes> + <include>images/**/*</include> + </includes> + </imageResource> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${pdf.name}</finalName> + </format> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>html_single</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>eclipse</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + <options> + <xincludeSupported>true</xincludeSupported> + <xmlTransformerType>saxon</xmlTransformerType> + <docbookVersion>1.72.0</docbookVersion> + <localeSeparator>-</localeSeparator> + <transformerParameters> + <property> + <name>javax.xml.parsers.DocumentBuilderFactory</name> + <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value> + </property> + <property> + <name>javax.xml.parsers.SAXParserFactory</name> + <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value> + </property> + </transformerParameters> + </options> + </configuration> + </plugin> + </plugins> + </pluginManagement> + </build> </project>