Author: irooskov(a)redhat.com Date: 2012-05-31 22:05:41 -0400 (Thu, 31 May 2012) New Revision: 41607 Modified: trunk/seam/docs/reference/en-US/Book_Info.xml trunk/seam/docs/reference/en-US/adding_seam_support_to_ear_project.xml trunk/seam/docs/reference/en-US/creating_mavenized_seam.xml trunk/seam/docs/reference/en-US/directory_structure.xml trunk/seam/docs/reference/en-US/generate_entities.xml trunk/seam/docs/reference/en-US/images/create_mavenized_seam/configure_maven_integration.png trunk/seam/docs/reference/en-US/images/seam_editors/seam_editors_3.png trunk/seam/docs/reference/en-US/images/seam_preferences/seam_preferences1_3.png trunk/seam/docs/reference/en-US/images/seam_preferences/seam_preferences1_5.png trunk/seam/docs/reference/en-US/seam_editors.xml trunk/seam/docs/reference/en-US/seam_menus_and_actions.xml trunk/seam/docs/reference/en-US/seam_preferences.xml trunk/seam/docs/reference/en-US/seam_refactoring.xml trunk/seam/docs/reference/en-US/seam_view.xml trunk/seam/docs/reference/en-US/seam_wizards.xml Log: updated for JBDS-2022 Modified: trunk/seam/docs/reference/en-US/Book_Info.xml =================================================================== --- trunk/seam/docs/reference/en-US/Book_Info.xml 2012-05-31 23:52:11 UTC (rev 41606) +++ trunk/seam/docs/reference/en-US/Book_Info.xml 2012-06-01 02:05:41 UTC (rev 41607) @@ -7,7 +7,7 @@ <productname>JBoss Developer Studio</productname> <productnumber>5.0</productnumber> <edition>5.0.0</edition> - <pubsnumber>4</pubsnumber> + <pubsnumber>5</pubsnumber> <abstract> <para>The Seam Developer Tools Reference Guide explains how to use the Seam Developer Tools module to create Seam projects for deployment.</para> </abstract> Modified: trunk/seam/docs/reference/en-US/adding_seam_support_to_ear_project.xml =================================================================== --- trunk/seam/docs/reference/en-US/adding_seam_support_to_ear_project.xml 2012-05-31 23:52:11 UTC (rev 41606) +++ trunk/seam/docs/reference/en-US/adding_seam_support_to_ear_project.xml 2012-06-01 02:05:41 UTC (rev 41607) @@ -31,7 +31,13 @@ </imageobject> </mediaobject> </figure> - + <para> + To enable Seam support for an existing EAR, WAR or EJB project, right-click on the project in the <guilabel>Project Explorer</guilabel> to bring up the context menu and navigate to <menuchoice><guimenuitem>Configure</guimenuitem><guimenuitem>Enable Seam Support</guimenuitem></menuchoice>. + </para> + <para> + Copy required JAR files manually into the project. For EAR projects specifically, copy library folders into the projects <filename>/lib</filename> folder and they will be automatically detected. + </para> +<!-- <para>Make sure EJB and WAR are included in EAR as modules (Properties for <menuchoice><guimenuitem>seamproject-ear</guimenuitem><guimenuitem>Java EE Module Dependencies</guimenuitem></menuchoice>)</para> <figure> @@ -120,5 +126,5 @@ </imageobject> </mediaobject> </figure> - + --> </chapter> \ No newline at end of file Modified: trunk/seam/docs/reference/en-US/creating_mavenized_seam.xml =================================================================== --- trunk/seam/docs/reference/en-US/creating_mavenized_seam.xml 2012-05-31 23:52:11 UTC (rev 41606) +++ trunk/seam/docs/reference/en-US/creating_mavenized_seam.xml 2012-06-01 02:05:41 UTC (rev 41607) @@ -179,10 +179,10 @@ </figure> </section> - <section> +<!-- <section> <title>Relevant Resources Links</title> <para> In the <ulink url="http://in.relation.to/Bloggers/UsingMavenWithJBossTools">Using Maven with JBoss Tools</ulink> article written by Max Andersen you&apos;ll find references to the screencasts on how to use the examples of mavenized Seam projects provided by <property>JBoss Tools</property>. </para> - </section> +</section> --> </chapter> Modified: trunk/seam/docs/reference/en-US/directory_structure.xml =================================================================== --- trunk/seam/docs/reference/en-US/directory_structure.xml 2012-05-31 23:52:11 UTC (rev 41606) +++ trunk/seam/docs/reference/en-US/directory_structure.xml 2012-06-01 02:05:41 UTC (rev 41607) @@ -51,7 +51,7 @@ </note> <para> - Furthermore the Seam Project wizard generates a test project that is setup to run <xref linkend="testNG"/> directly against the proper libraries and server runtime libraries. When the TestNG plugin is installed you can just run your tests via <menuchoice><guimenuitem>Run As</guimenuitem><guimenuitem>TestNG Test.</guimenuitem></menuchoice> + Furthermore the Seam Project wizard generates a test project that is setup to run <xref linkend="testNG"/> directly against the proper libraries and server runtime libraries. You can run tests via <menuchoice><guimenuitem>Run As</guimenuitem><guimenuitem>TestNG Test.</guimenuitem></menuchoice> </para> <para> @@ -145,14 +145,11 @@ <section id="changing_seam_parent_project"> <title>Changing Seam Parent Project</title> + <para> - Starting from the 2.0.0.CR2 version of <property>JBoss Tools</property> it is possible to change the Seam parent project. In earlier versions this was only controllable at a project creation time, now it can be changed for existing projects too. + To change the Seam parent project, navigate to your project preferences and select <emphasis> <property>Seam Settings</property> </emphasis> category on the left. Press the <emphasis> <property>Browse</property> </emphasis> button next to the <emphasis> <property>Main Seam Project</property> </emphasis> section to select the other Seam parent project. </para> - <para> - Go to your project preferences and select <emphasis> <property>Seam Settings</property> </emphasis> category on the left. Press the <emphasis> <property>Browse</property> </emphasis> button next to the <emphasis> <property>Main Seam Project</property> </emphasis> section to select the other Seam parent project. - </para> - <figure> <title>Changing Seam Parent Project</title> <mediaobject> @@ -167,7 +164,7 @@ <section id="renaming_projects_folders"> <title>Renaming the Projects and Folders</title> <para> - If you need to rename one of the Seam Project artifacts (<emphasis>&lt;project_name&gt;</emphasis>, <emphasis>&lt;project_name&gt;-ear</emphasis>, <emphasis>&lt;project_name&gt;-ejb</emphasis> or <emphasis>&lt;project_name&gt;-test</emphasis>) or any entire folder like <emphasis>&lt;project_name&gt;/WebContent</emphasis>, <emphasis>&lt;project_name&gt;/ejbModule</emphasis>, <emphasis>&lt;project_name&gt;-test/test-src</emphasis>, or project name in packages <emphasis>org.domain.&lt;project_name&gt;.session</emphasis>, <emphasis>org.domain.&lt;project_name&gt;.entity</emphasis>, you can do this by brining the context menu and navigating <emphasis> <property>Refactor &gt; Rename...</property> </emphasis> or just pressing <emphasis> <property>Shift + Alt + R</property> </emphasis> under the chosen resource. + If you need to rename one of the Seam Project artifacts (<emphasis>&lt;project_name&gt;</emphasis>, <emphasis>&lt;project_name&gt;-ear</emphasis>, <emphasis>&lt;project_name&gt;-ejb</emphasis> or <emphasis>&lt;project_name&gt;-test</emphasis>) or any entire folder like <emphasis>&lt;project_name&gt;/WebContent</emphasis>, <emphasis>&lt;project_name&gt;/ejbModule</emphasis>, <emphasis>&lt;project_name&gt;-test/test-src</emphasis>, or project name in packages <emphasis>org.domain.&lt;project_name&gt;.session</emphasis>, <emphasis>org.domain.&lt;project_name&gt;.entity</emphasis>, you can do this by accessing the context menu and navigating to <emphasis> <property>Refactor &gt; Rename...</property> </emphasis> or just pressing <emphasis> <property>Shift + Alt + R</property> </emphasis> under the chosen resource. </para> <figure> Modified: trunk/seam/docs/reference/en-US/generate_entities.xml =================================================================== --- trunk/seam/docs/reference/en-US/generate_entities.xml 2012-05-31 23:52:11 UTC (rev 41606) +++ trunk/seam/docs/reference/en-US/generate_entities.xml 2012-06-01 02:05:41 UTC (rev 41607) @@ -12,14 +12,10 @@ </chapterinfo> <title>Seam Generate Entities</title> <para> - The main purpose of this chapter is to tell you about Seam Generate Entities. + Generate Entities is available by navigating to <menuchoice><guimenuitem>File</guimenuitem><guimenuitem>New</guimenuitem><guimenuitem>Other</guimenuitem><guimenuitem>Seam</guimenuitem><guimenuitem>Seam Generate Entities</guimenuitem></menuchoice> </para> <para> - Generate Entities is available directly from Eclipse using Hibernate Tools plugin for the standard seam-gen generation. - </para> - - <para> The wizard generates a set of CRUD Seam components and web pages based on existing tables in a database or on existing entities in your application. </para> Modified: trunk/seam/docs/reference/en-US/images/create_mavenized_seam/configure_maven_integration.png =================================================================== (Binary files differ) Modified: trunk/seam/docs/reference/en-US/images/seam_editors/seam_editors_3.png =================================================================== (Binary files differ) Modified: trunk/seam/docs/reference/en-US/images/seam_preferences/seam_preferences1_3.png =================================================================== (Binary files differ) Modified: trunk/seam/docs/reference/en-US/images/seam_preferences/seam_preferences1_5.png =================================================================== (Binary files differ) Modified: trunk/seam/docs/reference/en-US/seam_editors.xml =================================================================== --- trunk/seam/docs/reference/en-US/seam_editors.xml 2012-05-31 23:52:11 UTC (rev 41606) +++ trunk/seam/docs/reference/en-US/seam_editors.xml 2012-06-01 02:05:41 UTC (rev 41607) @@ -302,7 +302,7 @@ <section> <title>Seam Pages Diagram Preferences</title> <para> - In order to customize the layout of Diagram you can go to <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Seam</guimenuitem><guimenuitem>Editors</guimenuitem><guimenuitem>Seam Pages Diagram</guimenuitem></menuchoice>. + In order to customize the layout of Diagram you can go to <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Editors</guimenuitem><guimenuitem>Seam Pages Diagram</guimenuitem></menuchoice>. </para> <figure> @@ -583,9 +583,8 @@ </itemizedlist> <note> - <title>Note:</title> <para> - In this section were described only use cases special for Seam applications.For general information please read <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/jsf/html/e... section in Visual Web Tools Reference Guide</ulink>. + For more information on OpenOn, see the Visual Web Tools Reference Guide. </para> </note> <formalpara id="xhtmlFiles"> @@ -623,7 +622,7 @@ <formalpara id="xmlFiles"> <title>OpenOn in XML files</title> <para> - OpenOn is also supported in Page Descriptors (<property>.page.xml</property> and <property>pages.xml</property>). OpenOn allows you to navigate to Java beans as well as to view pages. You can <property>Ctrl + left click</property> on a bean or on view page file (e.g. XTML file) to navigate to the file you clicked on. + OpenOn is also supported in Page Descriptors (<property>.page.xml</property> and <property>pages.xml</property>). OpenOn allows you to navigate to Java beans as well as to view pages. You can <property>Ctrl + left click</property> on a bean or on view page file (for example, a XHTML file) to navigate to the file you clicked on. </para> </formalpara> <figure> Modified: trunk/seam/docs/reference/en-US/seam_menus_and_actions.xml =================================================================== --- trunk/seam/docs/reference/en-US/seam_menus_and_actions.xml 2012-05-31 23:52:11 UTC (rev 41606) +++ trunk/seam/docs/reference/en-US/seam_menus_and_actions.xml 2012-06-01 02:05:41 UTC (rev 41607) @@ -42,7 +42,7 @@ <section id="file_menu"> <title>File Menu Actions</title> <para> - In a Seam perspective, by default there are the following actions in <menuchoice><guimenuitem>File</guimenuitem><guimenuitem>New</guimenuitem></menuchoice> submenu + The following actions are in the Seam Perspective by default: <menuchoice><guimenuitem>File</guimenuitem><guimenuitem>New</guimenuitem></menuchoice> submenu </para> <table> @@ -166,7 +166,17 @@ <section id="find_seam_ref_decl"> <title>Find Seam References/Declarations</title> <para> - To find EL expressions both in <emphasis> <property>.java</property> </emphasis> and <emphasis> <property>.xhtml</property> </emphasis> files use Find Seam References/Declarations actions. For that, in the main menu bar click on <menuchoice><guimenuitem>Search</guimenuitem><guimenuitem>Find Seam References</guimenuitem></menuchoice> or <emphasis><property>Find Seam Declarations</property>.</emphasis> + To find EL expressions both in <emphasis> + <property>.java</property> + </emphasis> and <emphasis> + <property>.xhtml</property> + </emphasis> files use Find Seam References and Declarations actions. For that, in the main menu bar click on <menuchoice> + <guimenuitem>Search</guimenuitem> + <guimenuitem>Find Seam References</guimenuitem> + </menuchoice> or <menuchoice> + <guimenuitem>Search</guimenuitem> + <guimenuitem>Find Seam Declarations</guimenuitem> + </menuchoice>. </para> <para> Modified: trunk/seam/docs/reference/en-US/seam_preferences.xml =================================================================== --- trunk/seam/docs/reference/en-US/seam_preferences.xml 2012-05-31 23:52:11 UTC (rev 41606) +++ trunk/seam/docs/reference/en-US/seam_preferences.xml 2012-06-01 02:05:41 UTC (rev 41607) @@ -77,7 +77,7 @@ </imageobject> </mediaobject> </figure> - + <!-- <para> Notice, that in the <emphasis> <property>Expression language</property> </emphasis> section there is now a preference for setting severity of EL Syntax. You can select whether the Seam validator displays an error, a warning or just ignore the EL Syntax error. </para> @@ -100,7 +100,7 @@ <para> The <emphasis> <property>Revalidate unresolved ELs automatically</property></emphasis> option is enabled by default. If necessary, you can uncheck it. It may increase a performance for big complex projects. </para> - + --> <para> In the upper right corner of the Seam Validator preferences page there is a <emphasis><property>Configure Project Specific Settings</property></emphasis> link. Clicking on it you get the form where you can choose a project for specific setting. Project specific configuration allows you to have different validator settings for each project. Check the <emphasis><property>Show only projects with project specific settings</property></emphasis> if you want to see the projects that have been already set. Click on <property>Ok</property>. </para> @@ -222,7 +222,7 @@ </para> <para> - To enable it, you should call the context menu for a Seam project and select <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Add Custom Capabilities.</guimenuitem></menuchoice> Then check the needed modules and press <emphasis><property>Finish</property>.</emphasis> + To enable it, you should call the context menu for a Seam project and select <menuchoice><guimenuitem>Configure</guimenuitem><guimenuitem>Add Custom Capabilities.</guimenuitem></menuchoice> Then check the needed modules and press <emphasis><property>Finish</property>.</emphasis> </para> <figure> Modified: trunk/seam/docs/reference/en-US/seam_refactoring.xml =================================================================== --- trunk/seam/docs/reference/en-US/seam_refactoring.xml 2012-05-31 23:52:11 UTC (rev 41606) +++ trunk/seam/docs/reference/en-US/seam_refactoring.xml 2012-06-01 02:05:41 UTC (rev 41607) @@ -12,11 +12,11 @@ </chapterinfo> <title>Seam Refactoring Tools</title> <para> - The goal of Seam components refactoring is to make system-wide code changes without affecting the behavior of the program. The Seam module of <property>JBoss Tools</property> provides assistance in easily code refactoring. + The goal of Seam components refactoring is to make system-wide code changes without affecting the behavior of the program. Seam Tools provides assistance with code refactoring. </para> <para> - Starting from Jboss Tools M4 refactoring functionality became also available for managed beans, method and properties used in ELs. Thus now Seam refactoring tools include the next refactoring operations: + Seam refactoring tools includes the following refactoring operations: </para> <itemizedlist> @@ -34,7 +34,7 @@ </itemizedlist> <para> - Refactoring commands are available from the context menus of several views and editors and use a standard Eclipse refactoring wizard. For details, see <xref linkend="RefactornigWizard"/> later in this chapter. + Refactoring commands are available from the context menus of several views and editors; for details, see <xref linkend="RefactornigWizard"/>. </para> <note> @@ -180,9 +180,9 @@ </mediaobject> </figure> - <para> + <!-- <para> For details, see also the movie, <ulink url="http://docs.jboss.org/tools/movies/demos/rename_seam_components... a Seam component in the Java Editor&quot;</ulink>. - </para> + </para> --> </section> <section id="SeamComponents"> @@ -200,9 +200,9 @@ </mediaobject> </figure> - <para> + <!-- <para> For details, see also the movie, <ulink url="http://docs.jboss.org/tools/movies/demos/rename_seam_components... a Seam component in the Seam Components view&quot;</ulink>. - </para> + </para> --> </section> <section id="components_xml_editor"> @@ -219,10 +219,10 @@ </imageobject> </mediaobject> </figure> - + <!-- <para> For details, see also the movie, <ulink url="http://docs.jboss.org/tools/movies/demos/rename_seam_components... a Seam component in the components.xml file&quot;</ulink>. - </para> + </para> --> </section> </section> @@ -258,7 +258,7 @@ </imageobject> </mediaobject> </figure> - + <!-- <para> For details, see also a set of movies about renaming Seam context variables in EL in different locations: </para> @@ -287,6 +287,6 @@ <ulink url="http://docs.jboss.org/tools/movies/demos/rename_context_variabl... the Visual Page Editor</ulink> </para> </listitem> - </itemizedlist> + </itemizedlist> --> </section> </chapter> Modified: trunk/seam/docs/reference/en-US/seam_view.xml =================================================================== --- trunk/seam/docs/reference/en-US/seam_view.xml 2012-05-31 23:52:11 UTC (rev 41606) +++ trunk/seam/docs/reference/en-US/seam_view.xml 2012-06-01 02:05:41 UTC (rev 41607) @@ -108,7 +108,7 @@ <para>Select the <emphasis><property>Seam Components from Libraries</property></emphasis> under the Filters tab. This will make the view ignore components defined in jars. This will hide the many built-in Seam components and leave only those that are actually defined in the project or have been actively configured via components.xml. Therefore, deselecting the filter will show you all available components.</para> - <para>Selecting the <emphasis><property>Seam Components from Referenced Projects</property></emphasis> will hide the components that dependent on other project.</para> + <para>Selecting the <emphasis><property>Seam Components from Referenced Projects</property></emphasis> will hide the components that depend on other projects.</para> <figure> <title>Available Seam Component View Customizations</title> Modified: trunk/seam/docs/reference/en-US/seam_wizards.xml =================================================================== --- trunk/seam/docs/reference/en-US/seam_wizards.xml 2012-05-31 23:52:11 UTC (rev 41606) +++ trunk/seam/docs/reference/en-US/seam_wizards.xml 2012-06-01 02:05:41 UTC (rev 41607) @@ -143,15 +143,18 @@ </imageobject> </mediaobject> </figure> + <para> + Click on <guimenuitem>actionMethod</guimenuitem> in the internal browser and add a form in your project using the <guilabel>New Seam Form</guilabel> wizard <menuchoice> + <guimenuitem>File</guimenuitem> + <guimenuitem>New</guimenuitem> + <guimenuitem>Seam Form</guimenuitem> + </menuchoice>. + </para> </section> <section id="seam_form"> - <title>New Seam Form</title> + <title>New Seam Form</title> <para> - Click on <property>actionMethod</property> in the internal browser and add a form in your project using the New Seam Form wizard <menuchoice><guimenuitem>File</guimenuitem><guimenuitem>New</guimenuitem><guimenuitem>Seam Form</guimenuitem></menuchoice>. - </para> - - <para> Select a necessary project, type a name for <property>Seam component</property>, <property>POJO class</property>, <property>Method</property>, <property>Page</property> and select a <property>Package</property> using <emphasis> <property>Browse</property> </emphasis> button. </para> @@ -206,15 +209,14 @@ <para> Form component was hot-deployed. </para> + <para> + Enter some value in the text field (for example, <property>value1</property>) and click on <guibutton>formMethod</guibutton>. + </para> </section> <section id="seam_conversation"> <title>New Seam Conversation</title> <para> - Enter some value in the text field (e.g. <property>value1</property>) and click on <property>formMethod</property>. - </para> - - <para> Add a conversation using the New Seam Conversation wizard <menuchoice><guimenuitem>File</guimenuitem><guimenuitem>New</guimenuitem><guimenuitem>Seam Form.</guimenuitem></menuchoice> </para>