August 2009 - jbosstools-commits - Jboss List Archives

JBoss Tools SVN: r17330 - trunk/struts/docs/struts_tools_ref_guide/en.

by jbosstools-commits＠lists.jboss.org

Author: ochikvina Date: 2009-08-27 08:44:52 -0400 (Thu, 27 Aug 2009) New Revision: 17330 Modified: trunk/struts/docs/struts_tools_ref_guide/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-810 - new master_output.xml is added; Modified: trunk/struts/docs/struts_tools_ref_guide/en/master_output.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en/master_output.xml 2009-08-27 12:40:51 UTC (rev 17329) +++ trunk/struts/docs/struts_tools_ref_guide/en/master_output.xml 2009-08-27 12:44:52 UTC (rev 17330) @@ -30,13 +30,13 @@ <bookinfo> <title>Struts Tools Reference Guide</title> - <corpauthor> - <inlinemediaobject> - <imageobject role="fo"> - <imagedata fileref="images/jbosstools_logo.png" format="PNG"></imagedata> + <corpauthor diffmk:change="added"> + <inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added" role="fo"> + <imagedata diffmk:change="added" fileref="images/jbosstools_logo.png" format="PNG"></imagedata> </imageobject> - <imageobject role="html"> - <imagedata></imagedata> + <imageobject diffmk:change="added" role="html"> + <imagedata diffmk:change="added"></imagedata> </imageobject> </inlinemediaobject> </corpauthor> @@ -48,7 +48,7 @@ <copyright> <year>2007</year> <year>2009</year> - <holder>JBoss by Red Hat</holder> + <holder><diffmk:wrapper diffmk:change="changed">JBoss by Red Hat</diffmk:wrapper></holder> </copyright> <releaseinfo><diffmk:wrapper diffmk:change="changed"> Version: 3.1.0.M2 @@ -170,8 +170,8 @@ <section> <title>Other relevant resources on the topic</title> - <para>All JBoss Developer Studio/JBoss Tools documentation you can find <ulink url="http://docs.jboss.org/tools/">here</ulink>.</para> - <para>The latest documentation builds are available <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">here</ulink>.</para> + <para><diffmk:wrapper diffmk:change="changed">All JBoss Developer Studio/JBoss Tools documentation you can find on</diffmk:wrapper><ulink url="http://docs.jboss.org/tools/"><diffmk:wrapper diffmk:change="changed">JBoss Tools project page </diffmk:wrapper></ulink>.</para> + <para><diffmk:wrapper diffmk:change="changed">The latest documentation builds are available on</diffmk:wrapper><ulink url="http://download.jboss.org/jbosstools/nightly-docs/"><diffmk:wrapper diffmk:change="changed">nightly docs page</diffmk:wrapper></ulink>.</para> </section> @@ -444,11 +444,11 @@ </figure> </section> - <section> - <title>Relevant Resources Links</title> + <section diffmk:change="added"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Relevant Resources Links</diffmk:wrapper></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 <ulink url="../../jsf/html_single/index.html">Visual Web Tools guide</ulink>.</para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">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 </diffmk:wrapper><ulink diffmk:change="added" url="../../jsf/html_single/index.html"><diffmk:wrapper diffmk:change="added">Visual Web Tools guide</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> </section> </chapter> @@ -466,8 +466,22 @@ </chapterinfo> <title>Editors</title> - <para>In this chapter we'll introduce you to featured graphical editors for specific - Struts files such as Struts Configuration files, Tiles files and Struts Validation files.</para> + <para><diffmk:wrapper diffmk:change="changed">In this chapter we'll introduce you to featured graphical editors for specific + Struts files such as Struts Configuration files, Tiles files, Struts Validation files and web.xml.</diffmk:wrapper></para> + + <section diffmk:change="added" id="webxml_editor"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Web.xml Editor</diffmk:wrapper></title> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">web.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> file inside the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">WEB-INF</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> 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.</diffmk:wrapper></para> + + <para diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> add the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">web.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> 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 </diffmk:wrapper><ulink diffmk:change="added" url="../../jsf/html_single/index.html#GraphicalWebApplicationFileEditor"><diffmk:wrapper diffmk:change="added">web.xml editor</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + </section> + <section id="struts_config_editor"> <title>Graphical Editor for Struts Configuration Files</title> @@ -552,9 +566,8 @@ <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> + <para><diffmk:wrapper diffmk:change="changed">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.</diffmk:wrapper></para> <figure float="0"> <title>Tree View</title> @@ -563,11 +576,11 @@ <imagedata fileref="images/struts/struts_17.png"></imagedata> </imageobject> </mediaobject> - </figure> - - <para>You can also right-click on any node in the category tree and perform appropriate + </figure> + + <para><diffmk:wrapper diffmk:change="changed">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> + action-mappings category node, you can add new actions to the application.</diffmk:wrapper></para> <figure float="0"> <title>Tree Context Menu</title> @@ -577,6 +590,41 @@ </imageobject> </mediaobject> </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Let's consider the tree on the left more closely.</diffmk:wrapper></para> + + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Under the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">data-sources</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> node you can create a Data Source object that will be configured + and made available as a servlet context attribute.</diffmk:wrapper></para></listitem> + + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">form-beans</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> 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.</diffmk:wrapper></para></listitem> + + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">global-exceptions</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> node is intended for registering the handlers for the exceptions + that might be thrown by an Action object.</diffmk:wrapper></para></listitem> + + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Use the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">global-forwards</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> node to add, edit or delete a global forwards that represent + ActionForward objects available to all Action objects as a return value.</diffmk:wrapper></para></listitem> + + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">controller</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> node allows you to configure the controller properties.</diffmk:wrapper></para></listitem> + + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Under the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">resources</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> node you can add, delete, or edit message resources.</diffmk:wrapper></para></listitem> + + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Under the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">plug-ins</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> node you can define a Struts plug-in. Right-click the node, select </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Create Plug-in</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> + and specify the plug-ib </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Id</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> and </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">ClassName</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> by pointing to the Java class which implements the org.apache.struts.action.PlugIn interface. </diffmk:wrapper></para></listitem> + + </itemizedlist> </section> <section id="StrutsSourceMode9655"> @@ -639,7 +687,7 @@ </mediaobject> </figure> - <para>Find more information about editor features <ulink url="../../jsf/html_single/index.html#editors_features">here</ulink>.</para> + <para>Find more information about editor features <ulink url="../../jsf/html_single/index.html#editors_features"><diffmk:wrapper diffmk:change="changed">in the editor features chapter</diffmk:wrapper></ulink>.</para> </section> </section>

15 years, 4 months

1
0
0 / 0

JBoss Tools SVN: r17329 - trunk/ws/docs/reference/en.

by jbosstools-commits＠lists.jboss.org

Author: ochikvina Date: 2009-08-27 08:40:51 -0400 (Thu, 27 Aug 2009) New Revision: 17329 Modified: trunk/ws/docs/reference/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-810 - new master_output.xml is added; Modified: trunk/ws/docs/reference/en/master_output.xml =================================================================== --- trunk/ws/docs/reference/en/master_output.xml 2009-08-27 12:38:01 UTC (rev 17328) +++ trunk/ws/docs/reference/en/master_output.xml 2009-08-27 12:40:51 UTC (rev 17329) @@ -12,13 +12,13 @@ <bookinfo> <title>JBoss WS User Guide</title> - <corpauthor> - <inlinemediaobject> - <imageobject role="fo"> - <imagedata fileref="images/jbosstools_logo.png" format="PNG"></imagedata> + <corpauthor diffmk:change="added"> + <inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added" role="fo"> + <imagedata diffmk:change="added" fileref="images/jbosstools_logo.png" format="PNG"></imagedata> </imageobject> - <imageobject role="html"> - <imagedata></imagedata> + <imageobject diffmk:change="added" role="html"> + <imagedata diffmk:change="added"></imagedata> </imageobject> </inlinemediaobject> </corpauthor> @@ -180,8 +180,8 @@ </figure> </listitem> </itemizedlist> - <para><diffmk:wrapper diffmk:change="added">If you added the JBoss Web Service facet to the project, now the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> button is disable. You must click </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Next</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> button to set more information about the JBoss Web Service facet. The page is like </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Figure 2.5</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. Then click on the </diffmk:wrapper><property moreinfo="none">Finish</property><diffmk:wrapper diffmk:change="added"> button.</diffmk:wrapper></para> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">If you didn't add the JBoss Web Service facet to the project, click on the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> button. Next you will need to add JBoss Web Service facet to the project.</diffmk:wrapper></para> + <para><diffmk:wrapper diffmk:change="added">If you added the JBoss Web Service facet to the project, now the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> button is disable. You must click </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Next</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> button to set more information about the JBoss Web Service facet. The page is like </diffmk:wrapper><property moreinfo="none"><diffmk:wrapper diffmk:change="added">Figure 2.5</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. Then click on the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> button.</diffmk:wrapper></para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">If you didn't add the JBoss Web Service facet to the project, click on the </diffmk:wrapper><property diffmk:change="added" moreinfo="none">Finish</property><diffmk:wrapper diffmk:change="changed"> button. Next you will need to add JBoss Web Service facet to the project.</diffmk:wrapper></para> </section> <section id="addfacet">

15 years, 4 months

1
0
0 / 0

JBoss Tools SVN: r17328 - trunk/seam/docs/reference/en.

by jbosstools-commits＠lists.jboss.org

Author: ochikvina Date: 2009-08-27 08:38:01 -0400 (Thu, 27 Aug 2009) New Revision: 17328 Modified: trunk/seam/docs/reference/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-810 - new master_output.xml is added; Modified: trunk/seam/docs/reference/en/master_output.xml =================================================================== --- trunk/seam/docs/reference/en/master_output.xml 2009-08-27 12:37:15 UTC (rev 17327) +++ trunk/seam/docs/reference/en/master_output.xml 2009-08-27 12:38:01 UTC (rev 17328) @@ -4,6 +4,7 @@ [<!ENTITY intro SYSTEM "modules/intro.xml"> <!ENTITY creating_new_seam SYSTEM "modules/creating_new_seam.xml"> +<!ENTITY creating_mavenized_seam SYSTEM "modules/creating_mavenized_seam.xml"> <!ENTITY directory_structure SYSTEM "modules/directory_structure.xml"> <!ENTITY menus_and_actions SYSTEM "modules/seam_menus_and_actions.xml"> <!ENTITY seam_wizards SYSTEM "modules/seam_wizards.xml"> @@ -36,13 +37,13 @@ <bookinfo> <title>Seam Dev Tools Reference Guide</title> - <corpauthor> - <inlinemediaobject> - <imageobject role="fo"> - <imagedata fileref="images/jbosstools_logo.png" format="PNG"></imagedata> + <corpauthor diffmk:change="added"> + <inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added" role="fo"> + <imagedata diffmk:change="added" fileref="images/jbosstools_logo.png" format="PNG"></imagedata> </imageobject> - <imageobject role="html"> - <imagedata></imagedata> + <imageobject diffmk:change="added" role="html"> + <imagedata diffmk:change="added"></imagedata> </imageobject> </inlinemediaobject> </corpauthor> @@ -678,6 +679,106 @@ </chapter> +<chapter diffmk:change="added" id="create_mavenized_seam" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/seam/docs/reference/en/modules/creating_mavenized_seam.xml" xreflabel="create_mavenized_seam"> + <?dbhtml filename="create_mavenized_seam.html"?> + <chapterinfo diffmk:change="added"> + <keywordset diffmk:change="added"> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></keyword> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">Seam</diffmk:wrapper></keyword> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBDS</diffmk:wrapper></keyword> + </keywordset> + </chapterinfo> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Creating Maven ready Seam project</diffmk:wrapper></title> + + <para diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools 3.1 M2</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> comes with new Jboss Maven Integration plug-in. It makes the Seam Wizard capable of creating + Maven ready projects to let Maven get the libraries instead of using the Seam runtime. The Jboss Maven Integration requires </diffmk:wrapper><ulink diffmk:change="added" url="http://m2eclipse.sonatype.org/"><diffmk:wrapper diffmk:change="added">m2eclipse</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> to be installed.</diffmk:wrapper></para> + + <note diffmk:change="added"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Note:</diffmk:wrapper></title> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">For M2 release of </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Jboss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> it is important to use m2eclipse </diffmk:wrapper><ulink diffmk:change="added" url="http://m2eclipse.sonatype.org/update/"><diffmk:wrapper diffmk:change="added">stable updatesite</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> or the </diffmk:wrapper><ulink diffmk:change="added" url="http://m2eclipse.sonatype.org/releases/0.9.9.200906081351"><diffmk:wrapper diffmk:change="added">latest integration build</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> that M2 was + developed against. If you want to use the latest development release of m2eclipse you need to use the </diffmk:wrapper><ulink diffmk:change="added" url="http://download.jboss.org/jbosstools/updates/nightly/trunk/"><diffmk:wrapper diffmk:change="added">nightly builds</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> of + </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + </note> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">To create a mavenized Seam project you should perform the following steps:</diffmk:wrapper></para> + + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Navigate to </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">File > New Seam Project</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> Give the project a meaningful name, specify a target runtime and server + and select the proper configuration for your Seam project:</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Starting the Mavenized Seam Project</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/create_mavenized_seam/createMavenizedSeamProject.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Click the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Modify</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> button to enable the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Jboss Maven Integration</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> facet:</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Enabling the Jboss Maven Integration Facet</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/create_mavenized_seam/jbossMavenIntegrationFacet.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">On the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss M2 capabilities</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> page you'll be prompted to add the following maven properties: + groupId, artifactId, version, packaging, name and description. Here it's possible to set a maven version of Seam + and also decide whether to remove WTP classpath containers (where the path starts with org.eclipse.jst). + </diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adjusting JBoss M2 Capabilities</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/create_mavenized_seam/jbossM2capabilities.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">On the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Seam Facet</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> page configure the Seam Facet settings and click </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">:</diffmk:wrapper></emphasis></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Seam Facet Settings</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/create_mavenized_seam/seamFacetPage.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + </itemizedlist> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The organized Seam project contains five projects with the Maven nature, builder, Maven classpath and the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">pom.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> files added: + projectname, projectname-ear, projectname-ejb, projectname-parent and projectname-test.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Mavenized Seam Project</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/create_mavenized_seam/mavenizedProjectStructure.png"></imagedata> + </imageobject> + </mediaobject> + </figure> +</chapter> + + <chapter id="directory_str" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/seam/docs/reference/en/modules/directory_structure.xml" xreflabel="directory_str"> <?dbhtml filename="directory_structure.html"?> <chapterinfo> @@ -1236,8 +1337,8 @@ </imageobject> </mediaobject> </figure> - <para>You can also open Seam Component from the other component where the required one is declared in <code>@In </code> by using - <link linkend="OpenOn">OpenOn</link> (<property moreinfo="none">Ctrl + left click</property> and select <property moreinfo="none">Open Declaration of Seam Component for seam_component in Seam_class.java</property> ).</para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can also open Seam Component from the other component where the required one is declared in </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added">@In </diffmk:wrapper></code><diffmk:wrapper diffmk:change="added"> by using + </diffmk:wrapper><link diffmk:change="added" linkend="OpenOn"><diffmk:wrapper diffmk:change="added">OpenOn</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> (</diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Ctrl + left click</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> and select </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Open Declaration of Seam Component for seam_component in Seam_class.java</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> ).</diffmk:wrapper></para> </section> </section> @@ -2211,22 +2312,22 @@ </itemizedlist> </listitem> <listitem diffmk:change="added" id="javaFiles"> - <para> - OpenOn is also supported in seam components where <property moreinfo="none"> In annotation</property> is presented. - After pressing <property moreinfo="none">Ctrl + left click</property> on the seam component specified in <code>@In </code> you will get the possibility to open the file where the component is declarated as well as - all of the seam components where it is used in the next declarations:</para> - <itemizedlist> - <listitem><para diffmk:change="added">@Out</para></listitem> - <listitem><para diffmk:change="added">@DataModel</para></listitem> - <listitem><para diffmk:change="added">@Role</para></listitem> - <listitem><para diffmk:change="added">@Roles</para></listitem> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added"> + OpenOn is also supported in seam components where </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added"> In annotation</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> is presented. + After pressing </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Ctrl + left click</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> on the seam component specified in </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added">@In </diffmk:wrapper></code><diffmk:wrapper diffmk:change="added"> you will get the possibility to open the file where the component is declarated as well as + all of the seam components where it is used in the next declarations:</diffmk:wrapper></para> + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">@Out</diffmk:wrapper></para></listitem> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">@DataModel</diffmk:wrapper></para></listitem> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">@Role</diffmk:wrapper></para></listitem> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">@Roles</diffmk:wrapper></para></listitem> </itemizedlist> - <figure float="0"> - <title>OpenOn in Seam Component</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/seam_editors/seam_editors_2b.png"></imagedata> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">OpenOn in Seam Component</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/seam_editors/seam_editors_2b.png"></imagedata> </imageobject> </mediaobject> </figure> @@ -2460,11 +2561,11 @@ </imageobject> </mediaobject> </figure> - <tip> - <title>Tip:</title> - <para>If you try to delete the Seam Runtime that is already in use by some project in the current workspace, then a warning message will appear. To confirm the removal press <property moreinfo="none">OK</property> + <tip diffmk:change="added"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Tip:</diffmk:wrapper></title> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">If you try to delete the Seam Runtime that is already in use by some project in the current workspace, then a warning message will appear. To confirm the removal press </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">OK</diffmk:wrapper></property> </para> - <para>Besides, when you right-click on your Seam project with deleted runtime in Project Explorer and select<property moreinfo="none"> Properties > Seam Settings</property> the error message "Runtime <runtime_name> does not exist" will appear. </para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Besides, when you right-click on your Seam project with deleted runtime in Project Explorer and select</diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added"> Properties > Seam Settings</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> the error message "Runtime <runtime_name> does not exist" will appear. </diffmk:wrapper></para> </tip> <section id="validator_pref"> @@ -2494,7 +2595,9 @@ </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> - + <note diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">There are references made between each EL and variable name, so you can revalidate a particular EL if a context variable was changed. This makes parsing of each resource with referenced ELs much faster.</diffmk:wrapper></para></note> + + <figure float="0"> <title>Severity Preference for EL Syntax</title> <mediaobject> @@ -3697,10 +3800,10 @@ <para>In conclusion, the main goal of this document is to get you know with a full featureset that <property moreinfo="none">JBoss Tools</property> provides to support Seam development. Thus if you have some questions, comments or suggestions on the topic, please fell free to ask in the <ulink url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201">JBoss - Tools Forum</ulink>. You can also influence on how you want to see JBoss Tools docs in - future leaving your vote on our page <ulink url="http://wiki.jboss.org/wiki/JBossToolsDocsFuture">here</ulink>. </para> + Tools Forum</ulink><diffmk:wrapper diffmk:change="changed">. You can also influence on how you want to see JBoss Tools docs in + future leaving your vote on the article </diffmk:wrapper><ulink url="http://wiki.jboss.org/wiki/JBossToolsDocsFuture"><diffmk:wrapper diffmk:change="changed">Overview of the improvements required by JBossTools/JBDS Docs users</diffmk:wrapper></ulink>. </para> - <para>A set of movies on Seam tooling is available <ulink url="http://docs.jboss.org/tools/movies">here</ulink>.</para> + <para><diffmk:wrapper diffmk:change="changed">A set of movies on Seam tooling is available on </diffmk:wrapper><ulink url="http://docs.jboss.org/tools/movies"><diffmk:wrapper diffmk:change="changed">Seam movies page</diffmk:wrapper></ulink>.</para> </section> </chapter>

15 years, 4 months

1
0
0 / 0

JBoss Tools SVN: r17327 - trunk/portlet/docs/reference/en.

by jbosstools-commits＠lists.jboss.org

Author: ochikvina Date: 2009-08-27 08:37:15 -0400 (Thu, 27 Aug 2009) New Revision: 17327 Modified: trunk/portlet/docs/reference/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-810 - new master_output.xml is added; Modified: trunk/portlet/docs/reference/en/master_output.xml =================================================================== --- trunk/portlet/docs/reference/en/master_output.xml 2009-08-27 12:31:11 UTC (rev 17326) +++ trunk/portlet/docs/reference/en/master_output.xml 2009-08-27 12:37:15 UTC (rev 17327) @@ -24,13 +24,13 @@ <bookinfo> <title>JBoss Portal Tools Reference Guide</title> - <corpauthor> - <inlinemediaobject> - <imageobject role="fo"> - <imagedata fileref="images/jbosstools_logo.png" format="PNG"></imagedata> + <corpauthor diffmk:change="added"> + <inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added" role="fo"> + <imagedata diffmk:change="added" fileref="images/jbosstools_logo.png" format="PNG"></imagedata> </imageobject> - <imageobject role="html"> - <imagedata></imagedata> + <imageobject diffmk:change="added" role="html"> + <imagedata diffmk:change="added"></imagedata> </imageobject> </inlinemediaobject> </corpauthor> @@ -715,7 +715,7 @@ <tip> <title>Tip:</title> - <para>You can download JBoss Portlet Bridge 1.0.0.B4 from <ulink url="http://www.jboss.org/portletbridge/download/">here</ulink>.</para> + <para>You can download JBoss Portlet Bridge 1.0.0.B4 from <ulink url="http://www.jboss.org/portletbridge/download/"><diffmk:wrapper diffmk:change="changed">Portletbridge Download page</diffmk:wrapper></ulink>.</para> </tip> <para>Next click <emphasis>

15 years, 4 months

1
0
0 / 0

JBoss Tools SVN: r17326 - trunk/jsf/docs/userguide/en.

by jbosstools-commits＠lists.jboss.org

Author: ochikvina Date: 2009-08-27 08:31:11 -0400 (Thu, 27 Aug 2009) New Revision: 17326 Modified: trunk/jsf/docs/userguide/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-810 - new master_output.xml is added; Modified: trunk/jsf/docs/userguide/en/master_output.xml =================================================================== --- trunk/jsf/docs/userguide/en/master_output.xml 2009-08-27 12:24:18 UTC (rev 17325) +++ trunk/jsf/docs/userguide/en/master_output.xml 2009-08-27 12:31:11 UTC (rev 17326) @@ -6,6 +6,7 @@ <!ENTITY Visual_Web_Tools SYSTEM "modules/Visual_Web_Tools.xml"> <!ENTITY springTools SYSTEM "modules/spring_tools.xml"> <!ENTITY editors SYSTEM "modules/editors.xml"> +<!ENTITY cssPerspective SYSTEM "modules/css_perspective.xml"> <!ENTITY palette SYSTEM "modules/palette.xml"> <!ENTITY richfaces_support SYSTEM "modules/richfaces_support.xml"> <!ENTITY web_projects SYSTEM "modules/web_projects.xml"> @@ -37,9 +38,9 @@ <year>2009</year> <holder><diffmk:wrapper diffmk:change="changed">JBoss by Red Hat</diffmk:wrapper></holder> </copyright> - <releaseinfo> - Version: 2.0.1.GA - </releaseinfo> + <releaseinfo><diffmk:wrapper diffmk:change="changed"> + Version: 2.1.0.GA + </diffmk:wrapper></releaseinfo> <abstract> <title></title> <para> @@ -130,12 +131,12 @@ </row> - <row> - <entry>Multiple Editors</entry> - <entry>An extensive collection of specialized editors for different file types: properties, TLD, web.xml, tiles, and so on: Graphical Properties Editor, - Graphical TLD Editor, Graphical Web Application File (web.xml) Editor, CSS Editor, JavaScript Editor, XSD Editor, Support for XML Schema.</entry> - <entry> - <link linkend="more_editors">more editors</link> + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Multiple Editors</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">An extensive collection of specialized editors for different file types: properties, TLD, web.xml, tiles, and so on: Graphical Properties Editor, + Graphical TLD Editor, Graphical Web Application File (web.xml) Editor, CSS Editor, JavaScript Editor, XSD Editor, Support for XML Schema.</diffmk:wrapper></entry> + <entry diffmk:change="added"> + <link diffmk:change="added" linkend="more_editors"><diffmk:wrapper diffmk:change="added">more editors</diffmk:wrapper></link> </entry> </row> @@ -200,15 +201,15 @@ components in any web application. Support for RichFaces and Ajax4jsf libraries in JBoss Tools Palette. Rendering RichFaces components in Visual Page Editor.</entry> <entry> - <link linkend="richfaces_support">RichFaces support</link> + <link linkend="richfaces_support">RichFaces support</link> </entry> </row> - <row> - <entry>Flexible Configuration</entry> - <entry>Various features of JBoss Developer Studio can be easily configured via the Preferences screen.</entry> - <entry> - <link linkend="preferences">preferences</link> + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Flexible Configuration</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Various features of JBoss Developer Studio can be easily configured via the Preferences screen.</diffmk:wrapper></entry> + <entry diffmk:change="added"> + <link diffmk:change="added" linkend="preferences"><diffmk:wrapper diffmk:change="added">preferences</diffmk:wrapper></link> </entry> </row> @@ -981,7 +982,13 @@ <property moreinfo="none">Visual Page Editor</property> (VPE). You can use the Visual Page Editor to develop an application using any technology: JSF, Struts, JSP, HTML and others. Double-click on the necessary file in the Package Explorer view to open it in the Visual Editor or just drag-and-drop it into perspective (the drag-and-drop feature can be also applied to JSP, XHTML or HTML files created locally).</para> - <para>Current VPE version has three tabs: <property moreinfo="none">Visual/Source</property>, + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">As a new JSF 2.0 specification has been released, support of new features is now implemented in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Visual Page Editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. + The JSF 2.0 tags like </diffmk:wrapper><literal diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added"><h:body></diffmk:wrapper></literal><diffmk:wrapper diffmk:change="added">, </diffmk:wrapper><literal diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added"><h:head></diffmk:wrapper></literal><diffmk:wrapper diffmk:change="added">, </diffmk:wrapper><literal diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added"><h:outputscript></diffmk:wrapper></literal><diffmk:wrapper diffmk:change="added">, </diffmk:wrapper><literal diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added"><h:outputstyle></diffmk:wrapper></literal><diffmk:wrapper diffmk:change="added"> + are supported in the editor as well as the resource handling from the expression language. (See the + </diffmk:wrapper><ulink diffmk:change="added" url="http://blogs.sun.com/rlubke/entry/jsf_2_0_new_feature3"><diffmk:wrapper diffmk:change="added">following blog post</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> on how to handle the resources form the EL). + </diffmk:wrapper></para> + + <para>Current VPE version has three tabs: <property moreinfo="none">Visual/Source</property>, <property moreinfo="none">Source</property> and <property moreinfo="none">Preview</property>. To switch between the views you can use tabs at the bottom of the VPE or the shortcuts <emphasis> <property moreinfo="none">Ctrl + PageUp/Ctrl + PageDown</property> @@ -1039,6 +1046,11 @@ </mediaobject> </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The Outline view displays a specific outline of a structured file that is currently open in the editor area, and lists its structural elements. Right-click on the elements will open additional options that allow adding other specific elements in necessary positions.</diffmk:wrapper></para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The Properties view shows property names and their values for a selected item. The values are editable, just select any and click on the button that appeared to choose a new value. Key combination </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Ctrl+Z</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> will return the previous value, </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Ctrl+Y</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> will return the new value again. The Properties view has additional options and can be set up to display categories and advanced properties. </diffmk:wrapper></para> + + <para>It's also possible to use the <link linkend="palette">JBoss Tools Palette</link> to insert any tag from the list of tag libraries to the page you are editing with just a click or drag-and-drop.</para> @@ -1116,14 +1128,81 @@ </mediaobject> </figure> - <para>You can also switch on this option in the VPE preferences, having clicked on the <emphasis><property moreinfo="none">Preferences</property> - </emphasis> button - (<inlinemediaobject> - <imageobject> - <imagedata fileref="images/visual_page/icon_1.png"></imagedata> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can also switch on this option in the VPE preferences, having clicked on the </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Preferences</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> button + (</diffmk:wrapper><inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/icon_1.png"></imagedata> </imageobject> - </inlinemediaobject>).</para> - + </inlinemediaobject><diffmk:wrapper diffmk:change="added">).</diffmk:wrapper></para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Visual Page Editor also displays custom tags correctly if they are configured properly. + The picture below shows an example how custom tags </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"pagination"</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> and </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"echo"</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> will be displayed in VPE. + </diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Custom Tags in the VPE</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_4d.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added"> + The listings of the custom tags implementations will help to clear how VPE works. + </diffmk:wrapper></para> + + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">echo.xhtml: </diffmk:wrapper></para> + <programlisting diffmk:change="added" format="linespecific" role="XML"><diffmk:wrapper diffmk:change="added"><![CDATA[ + <ui:composition xmlns:ui="http://java.sun.com/jsf/facelets"> + <span class="message">#{msg}</span> + </ui:composition> + ]]></diffmk:wrapper></programlisting></listitem> + + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">paginator.xhtml:</diffmk:wrapper></para> + + <programlisting diffmk:change="added" format="linespecific" role="XML"><diffmk:wrapper diffmk:change="added"><![CDATA[ + <?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" +"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" + xmlns:ui="http://java.sun.com/jsf/facelets" + xmlns:h="http://java.sun.com/jsf/html" + xmlns:f="http://java.sun.com/jsf/core"> +<ui:component> + + <h:panelGrid style="margin-right:auto;margin-left:auto;" columns="4"> + <h:commandButton value="<<" type="submit" + onclick="document.getElementById('currentPage').value=0" > + </h:commandButton> + <h:commandButton value="<" type="submit" + onclick="document.getElementById('currentPage').value=#{user.currentPage-user.rowsPerPage}"> + </h:commandButton> + <h:commandButton value=">" type="submit" + onclick="document.getElementById('currentPage').value=#{user.currentPage+user.rowsPerPage}"> + </h:commandButton> + <h:commandButton value=">>" type="submit" + onclick="document.getElementById('currentPage').value=#{user.numberOfItems - user.rowsPerPage}"> + </h:commandButton> + </h:panelGrid> + <h:inputHidden id="currentPage" value=""/> +</ui:component> +</html> +]]></diffmk:wrapper></programlisting> + </listitem> + </itemizedlist> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added"> + If your custom tags aren't configured correctly your Visual mode will look like this: + </diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Wrong configured Custom Tags in the VPE</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_4e.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <section id="comments"> <title>Commenting out Code</title> @@ -1218,6 +1297,7 @@ </section> </section> + <section id="pages_styling"> <title>Pages Styling</title> @@ -1229,9 +1309,10 @@ <section id="inline_styling"> <title>Inline Style Editing</title> - <para>In the Visual part of the <property moreinfo="none">VPE</property> there is a graphical + <para>In the Visual part of the <property moreinfo="none">VPE</property><diffmk:wrapper diffmk:change="added"> there is a graphical toolbar, use it to add inline styling to JSF and Struts tags on your page. The - toolbar can be hidden by clicking on arrow sign in the upper left corner.</para> + toolbar can be hidden by selecting the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Hide Text Formatting</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> option in the submenu on the left pane.</diffmk:wrapper></para> <figure float="0"> <title>Text Formatting</title> @@ -1242,8 +1323,8 @@ </mediaobject> </figure> - <para>For editing inline styles for DOM elements <property moreinfo="none">VPE</property> also - provides <property moreinfo="none">CSS Dialog</property>. It can be called from <emphasis> + <para>For editing inline styles for DOM elements <property moreinfo="none">VPE</property><diffmk:wrapper diffmk:change="changed"> + provides the </diffmk:wrapper><property moreinfo="none">CSS Dialog</property>. It can be called from <emphasis> <property moreinfo="none">style</property> </emphasis> line in the <property moreinfo="none">Properties view</property> for a currently selected element.</para> @@ -1322,7 +1403,7 @@ </mediaobject> </figure> - <para><diffmk:wrapper diffmk:change="added">Then you can configure style settings switching between the tabs: </diffmk:wrapper><emphasis> + <para><diffmk:wrapper diffmk:change="changed">Then you can configure style settings switching between the tabs: </diffmk:wrapper><emphasis> <property moreinfo="none">Text/Font</property>, </emphasis> <emphasis> <property moreinfo="none">Background</property>, </emphasis> @@ -1492,7 +1573,7 @@ <title>Advanced Settings</title> - <para>In the left vertical pane of the Visual part there are four buttons: <emphasis> + <para><diffmk:wrapper diffmk:change="changed">In the left vertical pane of the Visual part there are four buttons: </diffmk:wrapper><emphasis> <property moreinfo="none">Preferences</property></emphasis> ( <inlinemediaobject> @@ -1513,47 +1594,47 @@ <imageobject> <imagedata fileref="images/visual_page/icon_2.png"></imagedata> </imageobject> - </inlinemediaobject> + </inlinemediaobject><diffmk:wrapper diffmk:change="changed"> ) - ,<emphasis> - <property moreinfo="none">Page Design Options</property> </emphasis>( - <inlinemediaobject> + ,</diffmk:wrapper><emphasis> + <property moreinfo="none">Page Design Options</property> </emphasis><diffmk:wrapper diffmk:change="changed">( + </diffmk:wrapper><inlinemediaobject> <imageobject> <imagedata fileref="images/visual_page/icon_3.png"></imagedata> </imageobject> - </inlinemediaobject> + </inlinemediaobject><diffmk:wrapper diffmk:change="added"> ) and some of the next buttons: - <emphasis> - <property moreinfo="none">Vertical Source on top</property> </emphasis>( - <inlinemediaobject> - <imageobject> - <imagedata fileref="images/visual_page/source_top.png"></imagedata> + </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Vertical Source on top</diffmk:wrapper></property> </emphasis><diffmk:wrapper diffmk:change="added">( + </diffmk:wrapper><inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/source_top.png"></imagedata> </imageobject> - </inlinemediaobject>), - <emphasis> - <property moreinfo="none">Vertical Visual on top</property> </emphasis>( - <inlinemediaobject> - <imageobject> - <imagedata fileref="images/visual_page/source_bottom.png"></imagedata> + </inlinemediaobject><diffmk:wrapper diffmk:change="added">), + </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Vertical Visual on top</diffmk:wrapper></property> </emphasis><diffmk:wrapper diffmk:change="added">( + </diffmk:wrapper><inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/source_bottom.png"></imagedata> </imageobject> - </inlinemediaobject>), - <emphasis> - <property moreinfo="none">Horizontal Source to the left</property> </emphasis>( - <inlinemediaobject> - <imageobject> - <imagedata fileref="images/visual_page/source_left.png"></imagedata> + </inlinemediaobject><diffmk:wrapper diffmk:change="added">), + </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Horizontal Source to the left</diffmk:wrapper></property> </emphasis><diffmk:wrapper diffmk:change="added">( + </diffmk:wrapper><inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/source_left.png"></imagedata> </imageobject> - </inlinemediaobject>), - <emphasis> - <property moreinfo="none">Horizontal Visual to the left</property> </emphasis>( - <inlinemediaobject> - <imageobject> - <imagedata fileref="images/visual_page/source_right.png"></imagedata> + </inlinemediaobject><diffmk:wrapper diffmk:change="added">), + </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Horizontal Visual to the left</diffmk:wrapper></property> </emphasis><diffmk:wrapper diffmk:change="added">( + </diffmk:wrapper><inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/source_right.png"></imagedata> </imageobject> - </inlinemediaobject>), + </inlinemediaobject><diffmk:wrapper diffmk:change="changed">), depending on the current Visual/Source layout - .</para> + .</diffmk:wrapper></para> <figure float="0"> <title>Buttons on the Visual Part of VPE</title> @@ -1593,23 +1674,23 @@ </mediaobject> </figure> - <para>The available preferences are as follows:</para> - <itemizedlist> - <listitem><para>Show Border for Unknown Tags</para></listitem> - <listitem><para>Show Non-Visual Tags</para></listitem> - <listitem><para>Show Resource Bundles Usage as EL Expressions</para></listitem> - <listitem><para>Always Prompt for Tag Attributes During Tag Insert</para></listitem> - <listitem><para>Show Selection Tag Bar</para></listitem> - <listitem><para>Always Hide Selection Bar without Prompt</para></listitem> - <listitem><para>Default Editor Tab: <emphasis>Visual/Source</emphasis>, <emphasis>Source</emphasis> or <emphasis>Preview</emphasis></para></listitem> - <listitem><para>Size of Visual Editor Pane 0-100%</para></listitem> - </itemizedlist> <para>Click on the <emphasis><property moreinfo="none">Apply</property></emphasis> button to apply the changes or on the <emphasis><property moreinfo="none">Restore Defaults</property></emphasis> button to cancel the changes and set the default preferences.</para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The available preferences are as follows:</diffmk:wrapper></para> + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show Border for Unknown Tags</diffmk:wrapper></para></listitem> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show Non-Visual Tags</diffmk:wrapper></para></listitem> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show Resource Bundles Usage as EL Expressions</diffmk:wrapper></para></listitem> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Always Prompt for Tag Attributes During Tag Insert</diffmk:wrapper></para></listitem> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show Selection Tag Bar</diffmk:wrapper></para></listitem> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Always Hide Selection Bar without Prompt</diffmk:wrapper></para></listitem> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Default Editor Tab: </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">Visual/Source</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">, </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">Source</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> or </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">Preview</diffmk:wrapper></emphasis></para></listitem> + <listitem><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Size of Visual Editor Pane 0-100%</diffmk:wrapper></para></listitem> + </itemizedlist> <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Click on the </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Apply</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> button to apply the changes or on the </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Restore Defaults</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> button to cancel the changes and set the default preferences.</diffmk:wrapper></para> </listitem> - <listitem> + <listitem diffmk:change="added"> <para>Clicking on <emphasis> <property moreinfo="none">Refresh</property> @@ -1692,7 +1773,7 @@ </mediaobject> </figure> - <para id="el_exp_para">And finally, the <emphasis> + <para id="el_exp_para">And finally, the <emphasis> <property moreinfo="none">Substituted El expressions</property> </emphasis> tab is used to add El expressions that will be substituted by the editor when generating a preview:</para> @@ -1801,56 +1882,57 @@ </mediaobject> </figure> </listitem> - <listitem id="splitting_buttons"> - <para><emphasis> - <property moreinfo="none">Visual/Source Editors splitting buttons</property></emphasis> + <listitem diffmk:change="added" id="splitting_buttons"> + <para diffmk:change="added"><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Visual/Source Editors splitting buttons</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> provide the possibility to choose one of the four possible layouts for the Visual/Source Editor. - </para> + </diffmk:wrapper></para> - <para>The available layouts and corresponding buttons are as follows:</para> - <itemizedlist> - <listitem><para>Vertical Source on top(<inlinemediaobject> - <imageobject> - <imagedata fileref="images/visual_page/source_top.png"></imagedata> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The available layouts and corresponding buttons are as follows: + </diffmk:wrapper><itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Vertical Source on top(</diffmk:wrapper><inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/source_top.png"></imagedata> </imageobject> - </inlinemediaobject>)</para></listitem> - <listitem><para>Vertical Visual on top ( <inlinemediaobject> - <imageobject> - <imagedata fileref="images/visual_page/source_bottom.png"></imagedata> + </inlinemediaobject><diffmk:wrapper diffmk:change="added">)</diffmk:wrapper></para></listitem> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Vertical Visual on top ( </diffmk:wrapper><inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/source_bottom.png"></imagedata> </imageobject> - </inlinemediaobject>)</para></listitem> - <listitem><para>Horizontal Source to the left ( <inlinemediaobject> - <imageobject> - <imagedata fileref="images/visual_page/source_left.png"></imagedata> + </inlinemediaobject><diffmk:wrapper diffmk:change="added">)</diffmk:wrapper></para></listitem> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Horizontal Source to the left ( </diffmk:wrapper><inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/source_left.png"></imagedata> </imageobject> - </inlinemediaobject>)</para></listitem> - <listitem><para>Horizontal Visual to the left ( <inlinemediaobject> - <imageobject> - <imagedata fileref="images/visual_page/source_right.png"></imagedata> + </inlinemediaobject><diffmk:wrapper diffmk:change="added">)</diffmk:wrapper></para></listitem> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Horizontal Visual to the left ( </diffmk:wrapper><inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/source_right.png"></imagedata> </imageobject> - </inlinemediaobject>)</para></listitem> + </inlinemediaobject><diffmk:wrapper diffmk:change="added">)</diffmk:wrapper></para></listitem> </itemizedlist> - <figure float="0"> - <title>Visual Page Editor Before Layout Changing </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/visual_page/visual_page_24.png"></imagedata> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Visual Page Editor Before Layout Changing </diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_24.png"></imagedata> </imageobject> </mediaobject> - </figure> - Note, at the current view there is only <emphasis> - <property moreinfo="none"> one</property></emphasis> button, that proposes the possibility to change it in order the Source and the View are moved <emphasis> - <property moreinfo="none">in a clockwise direction</property></emphasis>. - <figure float="0"> - <title>Visual Page Editor After Layout Changing </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/visual_page/visual_page_25.png"></imagedata> + </figure><diffmk:wrapper diffmk:change="added"> + Note, at the current view there is only </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added"> one</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> button, that proposes the possibility to change it in order the Source and the View are moved </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">in a clockwise direction</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">. + </diffmk:wrapper><figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Visual Page Editor After Layout Changing </diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_25.png"></imagedata> </imageobject> </mediaobject> </figure> + </para> </listitem> </itemizedlist> @@ -1868,10 +1950,19 @@ </mediaobject> </figure> - <para>If you want to hide the <property moreinfo="none">Selection Tag Bar</property>, use the button in + <para>If you want to hide the <property moreinfo="none">Selection Tag Bar</property><diffmk:wrapper diffmk:change="added">, use the button in the form of a red cross on the lower right side. To reset it again you should check - the proper option in the <link linkend="vpe_preferences">VPE - Preferences</link>.</para> + the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Show Selection Bar</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> option in the submenu on the left pane.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show the Selection Tag Bar</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/show_selection_bar.png"></imagedata> + </imageobject> + </mediaobject> + </figure> </section> <section id="page_preview"> @@ -1943,21 +2034,21 @@ visual page editor then close all browser views/editors and leave one visual page editor open and restart eclipse. This should force a load of the right XULRunner viewer.</para> - <para> If it doesn't help and you use Fedora Core Linux and Eclipse Version: 3.4.1,the issue can be produced because libswt-xulrunner-gtk-3449.so file doesn't present + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added"> If it doesn't help and you use Fedora Core Linux and Eclipse Version: 3.4.1,the issue can be produced because libswt-xulrunner-gtk-3449.so file doesn't present in eclipse-swt-3.4.1-5.fc10.x86_64.rpm/eclipse/plugins/org.eclipse.swt.gtk.linux.x86_64_3.4.1.v3449c.jar.To add this file to eclipse you should: - </para> - <itemizedlist> - <listitem> - <para>Decompress eclipse/plugins/org.eclipse.swt.gtk.linux.x86_3.4.1.v3449c.jar form eclipse-SDK-3.4.1-linux-gtk-x86_64.tar.gz</para> + </diffmk:wrapper></para> + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Decompress eclipse/plugins/org.eclipse.swt.gtk.linux.x86_3.4.1.v3449c.jar form eclipse-SDK-3.4.1-linux-gtk-x86_64.tar.gz</diffmk:wrapper></para> </listitem> - <listitem> - <para>Copy <property moreinfo="none">libswt-xulrunner-gtk-3449.so</property> file to your Fedora Eclipse location.</para> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Copy </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">libswt-xulrunner-gtk-3449.so</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> file to your Fedora Eclipse location.</diffmk:wrapper></para> </listitem> - <listitem> - <para>Open the file eclipse.ini,which can be found in your Fedora Eclipse location and add the following line: </para> - <programlisting format="linespecific" role="JAVA"><![CDATA[-Dswt.library.path=/usr/lib/eclipse -]]></programlisting><para>,where <code>/usr/lib/eclipse</code> is the path to your eclipse folder.</para> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Open the file eclipse.ini,which can be found in your Fedora Eclipse location and add the following line: </diffmk:wrapper></para> + <programlisting diffmk:change="added" format="linespecific" role="JAVA"><diffmk:wrapper diffmk:change="added"><![CDATA[-Dswt.library.path=/usr/lib/eclipse +]]></diffmk:wrapper></programlisting><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">,where </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added">/usr/lib/eclipse</diffmk:wrapper></code><diffmk:wrapper diffmk:change="added"> is the path to your eclipse folder.</diffmk:wrapper></para> </listitem> </itemizedlist> </section> @@ -2017,8 +2108,8 @@ <para><property moreinfo="none">The Properties editor</property> allows you to work in two different modes and also supports unicode characters.</para> - <para>To create a new properties file, in the Package Explorer view, select<emphasis> - <property moreinfo="none"> New > Properties File</property> + <para><diffmk:wrapper diffmk:change="changed">To create a new properties file, in the Package Explorer view, select </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">New > Properties File</diffmk:wrapper></property> </emphasis> from the right-click context menu on the folder where you want to create the file.</para> <figure float="0"> @@ -2150,8 +2241,12 @@ <title>Graphical Web Application File (web.xml) Editor</title> - <para>The Web Application File editor comes with the same features you will find in all - other JBoss Developer Studio editors:</para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The deployment descriptor </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">web.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> file is intended for describing the servlets, container-managed + security constraints and various deployment properties specific for your Web Application.</diffmk:wrapper></para> + + <para><diffmk:wrapper diffmk:change="added">To edit the deployment descriptor </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> provides its own + </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">web.xml editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> that comes with the same features you will find in all other </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBDS</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> editors:</diffmk:wrapper></para> <itemizedlist> <listitem> @@ -2164,6 +2259,11 @@ <section id="TreeView1"> <title>Tree View</title> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Switch to the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Tree view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> if you want to edit </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">web.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> in a graphical mode. + All elements that </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">web.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> could include are located in the left area of the editor in a tree format. + Click a node on the left to display and edit its properties that will appear in the right-hand area.</diffmk:wrapper></para> <figure float="0"> <title>Tree View</title> <mediaobject> @@ -2540,10 +2640,10 @@ new one, as well.</para> <para>To open the editor, click on the <emphasis> <property moreinfo="none">Palette Editor</property> - </emphasis> icon(<inlinemediaobject> <imageobject> + </emphasis><diffmk:wrapper diffmk:change="added"> icon(</diffmk:wrapper><inlinemediaobject diffmk:change="added"> <imageobject> <imagedata fileref="images/palette/palette_7.png"></imagedata> - </imageobject></inlinemediaobject>). - </para> + </imageobject></inlinemediaobject><diffmk:wrapper diffmk:change="added">). + </diffmk:wrapper></para> <para>The window has two parts. There is a reflected grouped list of components on the left side of the palette editor. Each group is divided into multiple groups, every of which is a tag library. The right side of the palette editor is an editing window @@ -2768,9 +2868,9 @@ <listitem> <para>Click <emphasis> <property moreinfo="none">Show/Hide</property> - </emphasis> button(<inlinemediaobject> <imageobject> + </emphasis><diffmk:wrapper diffmk:change="added"> button(</diffmk:wrapper><inlinemediaobject diffmk:change="added"> <imageobject> <imagedata fileref="images/palette/palette_10.png"></imagedata> - </imageobject></inlinemediaobject>), at the top right side of the JBoss Tools Palette.</para> + </imageobject></inlinemediaobject><diffmk:wrapper diffmk:change="added">), at the top right side of the JBoss Tools Palette.</diffmk:wrapper></para> </listitem> </itemizedlist> @@ -2904,7 +3004,10 @@ <property moreinfo="none">".tld"</property> </emphasis> file or the <emphasis role="italic"> <property moreinfo="none">".jar"</property> - </emphasis> that includes your tag library under the lib folder in your project. </para> + </emphasis><diffmk:wrapper diffmk:change="added"> that includes your tag library under the lib folder in your project. + Or you can just add </diffmk:wrapper><emphasis diffmk:change="added"> <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">".tld"</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added">or </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">".jar"</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> file to the classpath , and the library will be added to the Tag Library List in Web Projects View.</diffmk:wrapper></para> <section id="Drag_and_Drop65332"> <?dbhtml filename="DragAndDrop.html"?> <title>Drag-and-Drop</title> @@ -2959,10 +3062,10 @@ <title>Import Button</title> <para>The same you can do with <emphasis> <property moreinfo="none">Import</property> - </emphasis> button(<inlinemediaobject> <imageobject> + </emphasis><diffmk:wrapper diffmk:change="added"> button(</diffmk:wrapper><inlinemediaobject diffmk:change="added"> <imageobject> <imagedata fileref="images/palette/palette_6.png"></imagedata> - </imageobject></inlinemediaobject>).You can see this button at the top right side of the JBoss Tools Palette. - </para> + </imageobject></inlinemediaobject><diffmk:wrapper diffmk:change="added">).You can see this button at the top right side of the JBoss Tools Palette. + </diffmk:wrapper></para> <para>By clicking on the <emphasis> <property moreinfo="none">Import button</property> </emphasis> you will see the Import Tag window a similar like in the <link linkend="Drag_and_Drop65332"> Drag-and-Drop</link> method. Set the name and @@ -2987,7 +3090,234 @@ </chapter> -<chapter id="richfaces_support" role="new" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/richfaces_support.xml" xreflabel="richfaces_support"> +<chapter diffmk:change="added" id="css_perspective" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/css_perspective.xml" xreflabel="css_perspective"> + <?dbhtml filename="css_perspective.html"?> + <chapterinfo diffmk:change="added"> + <keywordset diffmk:change="added"> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">CSS Editing Perspective</diffmk:wrapper></keyword> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">css</diffmk:wrapper></keyword> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">html</diffmk:wrapper></keyword> + </keywordset> + </chapterinfo> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">CSS Editing Perspective</diffmk:wrapper></title> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The CSS Editing Perspective combines a set of views which allow you to see the structure of + your css files,edit them and see the results. + To use this perspective you need to choose </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Window >Open Perspective> CSS Editing </diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> + .All of the views are fully synchronized with each other:the changes being made in one view are reflected in othes at once.</diffmk:wrapper></para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">In CSS Editing Perspective you can change your css file in three ways:</diffmk:wrapper></para> + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">directly in your CSS Editor + </diffmk:wrapper></para> + </listitem> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">using </diffmk:wrapper><link diffmk:change="added" linkend="CSSPropertiesView"><diffmk:wrapper diffmk:change="added">CSS Properties view</diffmk:wrapper></link> + </para> + </listitem> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">using </diffmk:wrapper><link diffmk:change="added" linkend="PropertiesView"><diffmk:wrapper diffmk:change="added">Properties view</diffmk:wrapper></link> + </para> + </listitem> + </itemizedlist> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">CSS Editing Perspective</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/css_perspective/cssEditor.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <section diffmk:change="added" id="OutlineView"> + <?dbhtml filename="OutlineView.html"?> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Outline view</diffmk:wrapper></title> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Using this view you can easily skip between the selectors described in the source files, + see the list of properties in any selector just by clicking the triangle near it. + </diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Outline view</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/css_perspective/cssEditor1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can use the Source viewer with the Outline view to navigate around the file. + To do this you should just left click the selector or property you want and it will be automatically highlighted in the source code: + </diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Navigating around the file</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/css_perspective/cssEditor2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + + <section diffmk:change="added" id="PropertiesView"> + <?dbhtml filename="PropertiesView.html"?> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Properties view</diffmk:wrapper></title> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Properties view provides a full list of properties of a chosen selector. + The properties are divided into logic groups for better navigation. + </diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Properties view</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/css_perspective/cssEditor3.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">With the help of Properties view you have also the possibility to edit the css file by adding/editing/removing properties in the selector. + Left click the "</diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Value</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">" field near the property you want to edit and write the changes in the text field. + </diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Updating css using Properties view</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/css_perspective/cssEditor4.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + <section diffmk:change="added" id="CSSPropertiesView"> + <?dbhtml filename="CSSPropertiesView.html"?> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">CSS Properties view </diffmk:wrapper></title> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">CSS Properties view has five tabs: + </diffmk:wrapper></para> + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"> + <para diffmk:change="added"><link diffmk:change="added" linkend="text_font"><diffmk:wrapper diffmk:change="added">Text/Font</diffmk:wrapper></link> + </para> + </listitem> + <listitem diffmk:change="added"> + <para diffmk:change="added"><link diffmk:change="added" linkend="background"><diffmk:wrapper diffmk:change="added">Background</diffmk:wrapper></link></para> + </listitem> + <listitem diffmk:change="added"> + <para diffmk:change="added"><link diffmk:change="added" linkend="boxes"><diffmk:wrapper diffmk:change="added">Boxes</diffmk:wrapper></link></para> + </listitem> + <listitem diffmk:change="added"> + <para diffmk:change="added"><link diffmk:change="added" linkend="property_sheet"><diffmk:wrapper diffmk:change="added">Property Sheet</diffmk:wrapper></link></para> + </listitem> + <listitem diffmk:change="added"> + <para diffmk:change="added"><link diffmk:change="added" linkend="edited_properties"><diffmk:wrapper diffmk:change="added">Edited Properties</diffmk:wrapper></link></para> + </listitem> + </itemizedlist> + + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"> + <para diffmk:change="added" id="text_font"><diffmk:wrapper diffmk:change="added">CSS Text/Font properties define the appearance of text,its font family, boldness, size, and the style. + </diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Text/Font tab</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/css_perspective/cssEditor5.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">For example, to define the "</diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">font-family</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">" property you should click </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Choose font family</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> button( </diffmk:wrapper><inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/css_perspective/cssEditor7.png"></imagedata> + </imageobject> + </inlinemediaobject><diffmk:wrapper diffmk:change="added">) near </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Font Family</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> text field + and select the fonts you want to use from the list.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">CSS Text/Font tab</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/css_perspective/cssEditor6.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added"> + When you click </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Ok</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> the chosen fonts should appear in </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Font Family</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> text field and in the sourse css file. + To define other properties in CSS </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Text/Font</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> tab you should just click button near the + corresponding field you want and select the appropriate option in the list. + Or if you are absolutely sure of the property's value to use you can just write it in the text field. + </diffmk:wrapper></para> + + </listitem> + <listitem diffmk:change="added"><para diffmk:change="added" id="background"><diffmk:wrapper diffmk:change="added"> + You should use CSS background properties and </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Background</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> tab to define the background effects of an element. + + </diffmk:wrapper></para> + <para diffmk:change="added" id="boxes"><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Boxes</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> tab is used to define CSS border properties and the box model. + The CSS border properties allow you to specify the style and color of an element's border. + </diffmk:wrapper></para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">As well as in Text/Font tab, it's also possible to define the property in two ways:</diffmk:wrapper></para> + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">clicking </diffmk:wrapper><inlinemediaobject diffmk:change="added"> <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/css_perspective/cssEditor8.png"></imagedata> + </imageobject></inlinemediaobject><diffmk:wrapper diffmk:change="added">and choosing it from the list of options: + </diffmk:wrapper><figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Defining the property</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/css_perspective/cssEditor9.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </para> + </listitem> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added"> writing the property in the appropriate text field + </diffmk:wrapper></para> + </listitem> + </itemizedlist> + </listitem> + <listitem diffmk:change="added"><para diffmk:change="added" id="property_sheet"><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Property Sheet</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> tab contains the categorized list of properties. + Like in </diffmk:wrapper><link diffmk:change="added" linkend="PropertiesView"><diffmk:wrapper diffmk:change="added">Properties view</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> it's possible to edit the properties values.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Property Sheet tab</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/css_perspective/cssEditor10.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem diffmk:change="added"> + <para diffmk:change="added" id="edited_properties"><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Edited Properties</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> tab contains only the properties,defined in the selector.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Property Sheet tab</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/css_perspective/cssEditor11.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">It's also possible to edit the properties in the tab.</diffmk:wrapper></para> + </listitem> + </itemizedlist> + </section> + <section diffmk:change="added" id="CSSPreview"> + <?dbhtml filename="CSSPropertiesView.html"?> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">CSS Preview</diffmk:wrapper></title> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Using CSS Preview you can see how a selector affects any text.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Property Sheet tab</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/css_perspective/cssEditor12.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The preview is also edited by double click.You can write instead of the default text any text you want,including html tags.</diffmk:wrapper></para> + </section> + +</chapter> + + + +<chapter diffmk:change="added" id="richfaces_support" role="new" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/richfaces_support.xml" xreflabel="richfaces_support"> <?dbhtml filename="richfaces_support.html"?> <chapterinfo> <keywordset> @@ -3003,8 +3333,8 @@ <note> <title>Note:</title> - <para><ulink url="http://www.jboss.org/jbossrichfaces/downloads/">RichFaces - 3.3</ulink> is fully supported in the current version of <property moreinfo="none">JBoss Developer Studio</property> (i. e. 2.0.1.GA) and <property moreinfo="none">JBoss Tools 3.0.1.GA</property>.</para> + <para><ulink url="http://www.jboss.org/jbossrichfaces/downloads/"><diffmk:wrapper diffmk:change="changed">RichFaces + 3.3.X</diffmk:wrapper></ulink> is fully supported in the current version of <property moreinfo="none">JBoss Developer Studio</property><diffmk:wrapper diffmk:change="changed"> (i. e. 2.1.0.GA) and </diffmk:wrapper><property moreinfo="none">JBoss Tools 3.0.1.GA</property>.</para> </note> <para>The following features are implemented and fully supported for the current version of the RichFaces components:</para> @@ -3013,7 +3343,7 @@ <listitem><para><link linkend="ContentAssistForRF">Content Assist</link></para></listitem> <listitem><para><link linkend="RF_openOn">OpenOn</link></para></listitem> <listitem><para><link linkend="RF_in_palette">Representing in JBoss Tools Palette</link></para></listitem> - </itemizedlist> + </itemizedlist> <para>All you have to do is to <ulink url="http://www.jboss.org/jbossrichfaces/downloads/">download</ulink> and install RichFaces libraries into your project, i. e. just put <emphasis> @@ -3031,7 +3361,7 @@ <tip> <title>Tip:</title> - <para>RichFaces 3.3 is now fully supported in code completion.</para> + <para><diffmk:wrapper diffmk:change="changed">RichFaces 3.3.X is now fully supported in code completion.</diffmk:wrapper></para> </tip> <figure float="0"> @@ -3080,7 +3410,7 @@ <section id="RF_in_palette"> <title>RichFaces in the JBoss Tools Palette</title> - <para>RichFaces and<link linkend="palette">JBoss Tools + <para><diffmk:wrapper diffmk:change="changed">RichFaces and </diffmk:wrapper><link linkend="palette">JBoss Tools Palette</link>.</para> <figure float="0"> @@ -3835,12 +4165,12 @@ editor</entry> <entry>Visual/Source</entry> </row> - <row> - <entry>Visual/Source Editors Splitting</entry> - <entry>The option allows to choose one of the following + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Visual/Source Editors Splitting</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">The option allows to choose one of the following Visual,Source layouts - Vertical Source on top, Vertical Visual on top,Horizontal Source to the left or Horizontal Visual to the left ,as a default one when opening the - Visual/Source view</entry> - <entry>Vertical Source on top</entry> + Visual/Source view</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Vertical Source on top</diffmk:wrapper></entry> </row> <row> <entry>Size of Visual Editor Pane 0 – 100% </entry> @@ -3902,8 +4232,8 @@ <tip> <title>Tip:</title> - <para>If you specify an equal variable in <link linkend="el_exp_para">VPE EL - dialog</link> and in Preference EL dialog, variable from preference dialog will + <para>If you specify an equal variable in <link linkend="el_exp_para"><diffmk:wrapper diffmk:change="changed">Substitute EL + expressions dialog</diffmk:wrapper></link> and in Preference EL dialog, variable from preference dialog will have priority.</para> </tip> </section> @@ -4655,148 +4985,147 @@ </chapter> -<chapter id="context_menu_preferences" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/context_menu_preferences.xml" xreflabel="context_menu_preferences"> +<chapter diffmk:change="added" id="context_menu_preferences" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/context_menu_preferences.xml" xreflabel="context_menu_preferences"> <?dbhtml filename="context_menu_preferences.html"?> - <title>Context Menu Preferences and Options</title> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Context Menu Preferences and Options</diffmk:wrapper></title> - <para>To adjust the project specific preferences, you should bring the context menu for your - project and select the <emphasis> - <property moreinfo="none">Preferences</property> - </emphasis> option. More details on what adjustments you can perform in the - <property moreinfo="none">Preferences screen</property>, see in the <link linkend="preferences">"JBoss Tools Preferences"</link> chapter.</para> + <para><diffmk:wrapper diffmk:change="added">To adjust the project specific preferences, you should bring the context menu for your + project and select the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Preferences</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> option. More details on what adjustments you can perform in the + </diffmk:wrapper><property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Preferences screen</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, see in the </diffmk:wrapper><link diffmk:change="added" linkend="preferences"><diffmk:wrapper diffmk:change="added">"JBoss Tools Preferences"</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> chapter.</diffmk:wrapper></para> - <para>Under the <emphasis> - <property moreinfo="none">JBoss Tools</property> - </emphasis> option in the context menu there are also several actions provided by - <property moreinfo="none">JBDS</property>:</para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Under the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> option in the context menu there are also several actions provided by + </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBDS</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">:</diffmk:wrapper></para> - <itemizedlist> - <listitem> - <para>Add/Remove Struts Capabilities</para> + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Add/Remove Struts Capabilities</diffmk:wrapper></para> </listitem> - <listitem> - <para>Add/Remove JSF Capabilities</para> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Add/Remove JSF Capabilities</diffmk:wrapper></para> </listitem> - <listitem> - <para>Add Custom Capabilities</para> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Add Custom Capabilities</diffmk:wrapper></para> </listitem> </itemizedlist> - <section id="add_remove_struts_cap"> - <title>Add/Remove Struts Capabilities</title> + <section diffmk:change="added" id="add_remove_struts_cap"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Add/Remove Struts Capabilities</diffmk:wrapper></title> - <para>Please, for details refer to the <ulink url="../../struts_tools_ref_guide/html_single/index.html#AddingStrutsCapabilityToAnExistingWebApplication532">Struts - Tools Reference Guide</ulink>.</para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Please, for details refer to the </diffmk:wrapper><ulink diffmk:change="added" url="../../struts_tools_ref_guide/html_single/index.html#AddingStrutsCapabilityToAnExistingWebApplication532"><diffmk:wrapper diffmk:change="added">Struts + Tools Reference Guide</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> </section> - <section id="add_remove_jsf_cap"> - <title>Add/Remove JSF Capabilities</title> + <section diffmk:change="added" id="add_remove_jsf_cap"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Add/Remove JSF Capabilities</diffmk:wrapper></title> - <para>Please, for details refer to the <ulink url="../../jsf_tools_ref_guide/html_single/index.html#add_jsf_capability">JSF - Tools Reference Guide</ulink>.</para> + <para><diffmk:wrapper diffmk:change="added">Please, for details refer to the </diffmk:wrapper><ulink diffmk:change="added" url="../../jsf_tools_ref_guide/html_single/index.html#add_jsf_capability"><diffmk:wrapper diffmk:change="added">JSF + Tools Reference Guide</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> </section> - <section id="add_custom_cap"> - <title>Add Custom Capabilities</title> + <section diffmk:change="added" id="add_custom_cap"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Add Custom Capabilities</diffmk:wrapper></title> - <para>You can add custom capabilities to any JSF, Struts or Seam project made within - <property moreinfo="none">JBDS</property>, i.e. add a support of additional frameworks built on top - of JSF, such as </para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can add custom capabilities to any JSF, Struts or Seam project made within + </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBDS</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, i.e. add a support of additional frameworks built on top + of JSF, such as </diffmk:wrapper></para> - <itemizedlist> - <listitem> - <para>ADF</para> + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">ADF</diffmk:wrapper></para> </listitem> - <listitem> - <para>Facelets</para> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Facelets</diffmk:wrapper></para> </listitem> - <listitem> - <para>JBoss Rich Faces (versions 3.1, 3.2, 3.3)</para> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Rich Faces (versions 3.1, 3.2, 3.3)</diffmk:wrapper></para> </listitem> </itemizedlist> - <para>When the option is selected, the <property moreinfo="none">Add Custom Capabilities dialog</property> - appears. You should check the needed modules and press <emphasis> - <property moreinfo="none">Finish</property>.</emphasis></para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">When the option is selected, the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Add Custom Capabilities dialog</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> + appears. You should check the needed modules and press </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para> - <figure float="0"> - <title>Adding Custom Capabilities</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/context_menu_preferences/addCustomCapabilities.png"></imagedata> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adding Custom Capabilities</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/context_menu_preferences/addCustomCapabilities.png"></imagedata> </imageobject> </mediaobject> </figure> - <para>The next page displays all the updates that have been made to the project.</para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The next page displays all the updates that have been made to the project.</diffmk:wrapper></para> - <figure float="0"> - <title>Updates Displayed</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/context_menu_preferences/addCustomCapabilities2.png"></imagedata> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Updates Displayed</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/context_menu_preferences/addCustomCapabilities2.png"></imagedata> </imageobject> </mediaobject> </figure> </section> </chapter> - <chapter id="vwt_faq" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/vwt_faq.xml" xreflabel="vwt_faq"> <?dbhtml filename="vwt_faq.html"?> <title>FAQ</title> <section id="question_1"> <title>What should I do if Visual Page Editor does not start under Linux?</title> - + <para> The <property moreinfo="none">Visual Page Editor</property> requires the library libstdc++.so.5. This library is contained in the compat-libstdc++-33.i386 package.</para> - + <itemizedlist> <listitem> <para>To install this package on Fedora Core or Red Hat Enterprise Linux run the following command:</para> <programlisting format="linespecific" role="JAVA"><![CDATA[yum install compat-libstdc++-33.i386 ]]></programlisting> - </listitem> - + </listitem> + <listitem> <para>On any other rpm based distributions download libstdc++.so.5 and run the following command:</para> <programlisting format="linespecific" role="JAVA"><![CDATA[rpm -Uvh compat-libstdc++-33.i386 ]]></programlisting> </listitem> - + <listitem> <para>On Debian based distributives run the following command: </para> <programlisting format="linespecific" role="JAVA"><![CDATA[apt-get install compat-libstdc++-33.i386 ]]></programlisting> - </listitem> + </listitem> </itemizedlist> - + <para> In case you have the library installed and you still have issue with starting the <property moreinfo="none">Visual Page Editor</property> then close all browser views/editors and leave one <property moreinfo="none">Visual Page Editor</property> open and restart eclipse. This should force a load of the right XULRunner viewer.</para> - <para> If it doesn't help and you use Fedora Core Linux and Eclipse Version: 3.4.1,the issue can be produced because libswt-xulrunner-gtk-3449.so file doesn't present - in eclipse-swt-3.4.1-5.fc10.x86_64.rpm/eclipse/plugins/org.eclipse.swt.gtk.linux.x86_64_3.4.1.v3449c.jar.To add this file to eclipse you should: - </para> - <itemizedlist> - <listitem> - <para>Decompress eclipse/plugins/org.eclipse.swt.gtk.linux.x86_3.4.1.v3449c.jar form eclipse-SDK-3.4.1-linux-gtk-x86_64.tar.gz</para> - </listitem> - <listitem> - <para>Copy <property moreinfo="none">libswt-xulrunner-gtk-3449.so</property> file to your Fedora Eclipse location. </para> - </listitem> - - <listitem> - <para>Open the file eclipse.ini,which can be found in your Fedora Eclipse location and add the following line: </para> - <programlisting format="linespecific" role="JAVA"><![CDATA[-Dswt.library.path=/usr/lib/eclipse -]]></programlisting><para>,where <code>/usr/lib/eclipse</code> is the path to your eclipse folder.</para> - </listitem> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added"> If it doesn't help and you use Fedora Core Linux and Eclipse Version: 3.4.1,the issue can be produced because libswt-xulrunner-gtk-3449.so file doesn't present + in eclipse-swt-3.4.1-5.fc10.x86_64.rpm/eclipse/plugins/org.eclipse.swt.gtk.linux.x86_64_3.4.1.v3449c.jar.To add this file to eclipse you should: + </diffmk:wrapper></para> + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Decompress eclipse/plugins/org.eclipse.swt.gtk.linux.x86_3.4.1.v3449c.jar form eclipse-SDK-3.4.1-linux-gtk-x86_64.tar.gz</diffmk:wrapper></para> + </listitem> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Copy </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">libswt-xulrunner-gtk-3449.so</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> file to your Fedora Eclipse location. </diffmk:wrapper></para> + </listitem> + + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Open the file eclipse.ini,which can be found in your Fedora Eclipse location and add the following line: </diffmk:wrapper></para> + <programlisting diffmk:change="added" format="linespecific" role="JAVA"><diffmk:wrapper diffmk:change="added"><![CDATA[-Dswt.library.path=/usr/lib/eclipse +]]></diffmk:wrapper></programlisting><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">,where </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added">/usr/lib/eclipse</diffmk:wrapper></code><diffmk:wrapper diffmk:change="added"> is the path to your eclipse folder.</diffmk:wrapper></para> + </listitem> </itemizedlist> </section> - + <section id="question_2"> <title>How do I change the auto-formating preferences for the Visual Page Editor?</title> @@ -4809,18 +5138,18 @@ </section> </chapter> - -<chapter id="conclusion" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/conclusion.xml" xreflabel="conclusion"> + +<chapter diffmk:change="added" id="conclusion" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/conclusion.xml" xreflabel="conclusion"> <?dbhtml filename="conclusion.html"?> - <title>Conclusion</title> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Conclusion</diffmk:wrapper></title> - <para>On the whole, this document should guide you to those parts of <property moreinfo="none">JBoss - Tools</property> which you specifically need to develop Web Applications. It covers + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">On the whole, this document should guide you to those parts of </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss + Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> which you specifically need to develop Web Applications. It covers different aspects of visual components such as editors, views, etc. for browsing, - representing and editing web resources you are working with.</para> - - <para>If there's anything we didn't cover or you can't figure - out, please feel free to visit our <ulink url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=258">JBoss Developer Studio Users Forum</ulink> or <ulink url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201">JBoss Tools Users Forum</ulink> to ask questions. There we are also looking for - your suggestions and comments.</para> + representing and editing web resources you are working with.</diffmk:wrapper></para> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">If there's anything we didn't cover or you can't figure + out, please feel free to visit our </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=258"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio Users Forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> or </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201"><diffmk:wrapper diffmk:change="added">JBoss Tools Users Forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> to ask questions. There we are also looking for + your suggestions and comments.</diffmk:wrapper></para> </chapter> </book>

15 years, 4 months

1
0
0 / 0

JBoss Tools SVN: r17325 - trunk/jsf/docs/jsf_tools_tutorial/en.

by jbosstools-commits＠lists.jboss.org

Author: ochikvina Date: 2009-08-27 08:24:18 -0400 (Thu, 27 Aug 2009) New Revision: 17325 Modified: trunk/jsf/docs/jsf_tools_tutorial/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-810 - new master_output.xml is added; Modified: trunk/jsf/docs/jsf_tools_tutorial/en/master_output.xml =================================================================== --- trunk/jsf/docs/jsf_tools_tutorial/en/master_output.xml 2009-08-27 12:23:23 UTC (rev 17324) +++ trunk/jsf/docs/jsf_tools_tutorial/en/master_output.xml 2009-08-27 12:24:18 UTC (rev 17325) @@ -27,13 +27,13 @@ <bookinfo> <title>JSF Tools Tutorial</title> - <corpauthor> - <inlinemediaobject> - <imageobject role="fo"> - <imagedata fileref="images/jbosstools_logo.png" format="PNG"></imagedata> + <corpauthor diffmk:change="added"> + <inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added" role="fo"> + <imagedata diffmk:change="added" fileref="images/jbosstools_logo.png" format="PNG"></imagedata> </imageobject> - <imageobject role="html"> - <imagedata></imagedata> + <imageobject diffmk:change="added" role="html"> + <imagedata diffmk:change="added"></imagedata> </imageobject> </inlinemediaobject> </corpauthor>

15 years, 4 months

1
0
0 / 0

JBoss Tools SVN: r17324 - trunk/jsf/docs/jsf_tools_ref_guide/en.

by jbosstools-commits＠lists.jboss.org

Author: ochikvina Date: 2009-08-27 08:23:23 -0400 (Thu, 27 Aug 2009) New Revision: 17324 Modified: trunk/jsf/docs/jsf_tools_ref_guide/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-810 - new master_output.xml is added; Modified: trunk/jsf/docs/jsf_tools_ref_guide/en/master_output.xml =================================================================== --- trunk/jsf/docs/jsf_tools_ref_guide/en/master_output.xml 2009-08-27 12:18:42 UTC (rev 17323) +++ trunk/jsf/docs/jsf_tools_ref_guide/en/master_output.xml 2009-08-27 12:23:23 UTC (rev 17324) @@ -6,6 +6,7 @@ <!ENTITY introduction SYSTEM "modules/introduction.xml"> <!ENTITY jsf_support SYSTEM "modules/jsf_support.xml"> <!ENTITY projects SYSTEM "modules/projects.xml"> +<!ENTITY webxml_editor SYSTEM "modules/webxml_editor.xml"> <!ENTITY jsf_config_file SYSTEM "modules/jsf_config_file.xml"> <!ENTITY managed_beans SYSTEM "modules/managed_beans.xml"> <!ENTITY creation_and_registration SYSTEM "modules/creation_and_registration.xml"> @@ -28,13 +29,13 @@ ]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff"> <bookinfo> <title>JSF Tools Reference Guide</title> - <corpauthor> - <inlinemediaobject> - <imageobject role="fo"> - <imagedata fileref="images/jbosstools_logo.png" format="PNG"></imagedata> + <corpauthor diffmk:change="added"> + <inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added" role="fo"> + <imagedata diffmk:change="added" fileref="images/jbosstools_logo.png" format="PNG"></imagedata> </imageobject> - <imageobject role="html"> - <imagedata></imagedata> + <imageobject diffmk:change="added" role="html"> + <imagedata diffmk:change="added"></imagedata> </imageobject> </inlinemediaobject> </corpauthor> @@ -476,9 +477,9 @@ </chapter> -<chapter id="projects" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/jsf_tools_ref_guide/en/modules/projects.xml"> +<chapter diffmk:change="added" id="projects" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/jsf_tools_ref_guide/en/modules/projects.xml"> <?dbhtml filename="projects.html"?> - <chapterinfo> + <chapterinfo diffmk:change="added"> <keywordset> <keyword>JBoss Developer Studio</keyword> <keyword>Eclipse</keyword> @@ -489,7 +490,7 @@ </chapterinfo> <title>Projects</title> - <para>To take an advantage of JSF firstly you should perform one of the next steps:</para> + <para><diffmk:wrapper diffmk:change="changed">To take an advantage of JSF firstly you should perform one of the next steps:</diffmk:wrapper></para> <itemizedlist> <listitem> @@ -499,24 +500,24 @@ <para>Import (open) existing JSF projects</para> </listitem> <listitem> - <para>Add JSF capability to any existing Eclipse project</para> + <para><diffmk:wrapper diffmk:change="changed">Add JSF capability to any existing Eclipse project</diffmk:wrapper></para> </listitem> <listitem> - <para>Import and add JSF capability to any existing project created outside - Eclipse.</para> + <para><diffmk:wrapper diffmk:change="changed">Import and add JSF capability to any existing project created outside + Eclipse.</diffmk:wrapper></para> </listitem> </itemizedlist> - <para>In this section we're going to stop on each of them in detail.</para> + <para><diffmk:wrapper diffmk:change="changed">In this section we're going to stop on each of them in detail.</diffmk:wrapper></para> <section id="new_jsf_project"> <title>Creating a New JSF Project</title> - <para>If you want your project to already contain all JSF libraries, tag libraries + <para><diffmk:wrapper diffmk:change="changed">If you want your project to already contain all JSF libraries, tag libraries and JSF configuration file, just organize a new brand JSF project. It is - possible to do this easily with the help of the special wizard. To get it, select<emphasis> - <property moreinfo="none"> File > New > Project > JBoos Tools - Web > JSF > JSF Project</property> + possible to do this easily with the help of the special wizard. To get it, select</diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed"> File > New > Project > JBoos Tools + Web > JSF > JSF Project</diffmk:wrapper></property> </emphasis> and click <emphasis> <property moreinfo="none">Next</property>.</emphasis></para> @@ -529,11 +530,11 @@ </mediaobject> </figure> - <para>On the next form you'll be prompted to enter <property moreinfo="none">Project - Name</property> and select a location for the project or just leave - a default path.</para> - <para>Here, JSF Version also allows you to select which JSF implementation to - use.</para> + <para><diffmk:wrapper diffmk:change="changed">On the next form you'll be prompted to enter </diffmk:wrapper><property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Project + Name</diffmk:wrapper></property><diffmk:wrapper diffmk:change="changed"> and select a location for the project or just leave + a default path.</diffmk:wrapper></para> + <para><diffmk:wrapper diffmk:change="changed">Here, JSF Version also allows you to select which JSF implementation to + use.</diffmk:wrapper></para> <figure float="0"> <title>Creating a New JSF Project</title> <mediaobject> @@ -543,10 +544,10 @@ </mediaobject> </figure> - <para>There is a number of predefined project templates that are flexible and easily + <para><diffmk:wrapper diffmk:change="changed">There is a number of predefined project templates that are flexible and easily customizable. Thus you can pick a different template on which the projects Importing Existing should be based on. Almost all templates come in two - variations: with jsf libraries and without ones.</para> + variations: with jsf libraries and without ones.</diffmk:wrapper></para> <figure float="0"> <title>Choosing JSF Templates</title> <mediaobject> @@ -556,7 +557,7 @@ </mediaobject> </figure> - <para>The table below provides description for each possible JSF template.</para> + <para><diffmk:wrapper diffmk:change="changed">The table below provides description for each possible JSF template.</diffmk:wrapper></para> <table> <title>JSF Project Templates</title> <tgroup cols="2"> @@ -588,8 +589,8 @@ </entry> <entry> - <para>This template will create a standard Web - project structure with all JSF capabilities</para> + <para><diffmk:wrapper diffmk:change="changed">This template will create a standard Web + project structure with all JSF capabilities</diffmk:wrapper></para> </entry> </row> @@ -603,9 +604,9 @@ </entry> <entry> - <para>This template will create a standard Web + <para><diffmk:wrapper diffmk:change="changed">This template will create a standard Web project structure but will also include a sample - application that is ready to run</para> + application that is ready to run</diffmk:wrapper></para> </entry> </row> @@ -619,11 +620,11 @@ </entry> <entry> - <para>Some servers already provide jsf libs and + <para><diffmk:wrapper diffmk:change="changed">Some servers already provide jsf libs and you take risk of getting conflicting libraries while deploying your project. To avoid such conflicts, use a template without libs if you have - a server with its own jsf libraries</para> + a server with its own jsf libraries</diffmk:wrapper></para> </entry> </row> @@ -632,33 +633,30 @@ </table> -  + <para>On the next screen select what <emphasis> <property moreinfo="none">Servlet version</property> - </emphasis> to use and whether to register this application with JBoss AS - (or other server) for running and testing your application.</para> + </emphasis><diffmk:wrapper diffmk:change="changed"> to use and whether to register this application with JBoss AS + (or other server) for running and testing your application.</diffmk:wrapper></para> <para>The <emphasis> <property moreinfo="none">Context Path</property> - </emphasis> is the name under which the application will be deployed.</para> + </emphasis><diffmk:wrapper diffmk:change="changed"> is the name under which the application will be deployed.</diffmk:wrapper></para> <para>The <emphasis> <property moreinfo="none">Runtime</property> - </emphasis> value tells Eclipse where to find Web libraries in order to + </emphasis><diffmk:wrapper diffmk:change="changed"> value tells Eclipse where to find Web libraries in order to build (compile) the project. It is not possible to finish project creation - without selecting Runtime. If you don't have any values, select <emphasis> + without selecting Runtime. If you don't have any values, select </diffmk:wrapper><emphasis> <property moreinfo="none">New...</property> </emphasis> to add new Runtime.</para> <para>The <emphasis> <property moreinfo="none">Target Server</property> - </emphasis> allows you specifying whether to deploy the application. The + </emphasis><diffmk:wrapper diffmk:change="changed"> allows you specifying whether to deploy the application. The Target Server corresponds to the Runtime value selected above. If you - don't want to deploy the application, uncheck this value.</para> + don't want to deploy the application, uncheck this value.</diffmk:wrapper></para> <figure float="0"> <title>Registering the Project on Server</title> <mediaobject> @@ -668,8 +666,8 @@ </mediaobject> </figure> - <para>When you are all done, you should have the project that has been appeared in - the Package Explorer view:</para> + <para><diffmk:wrapper diffmk:change="changed">When you are all done, you should have the project that has been appeared in + the Package Explorer view:</diffmk:wrapper></para> <figure float="0"> <title>A New Project in the Package Explorer</title> <mediaobject> @@ -681,32 +679,32 @@ <para>At this point you can open <emphasis> <property moreinfo="none">faces-config.xml</property> - </emphasis> and start working on your application. There are a lot of + </emphasis><diffmk:wrapper diffmk:change="changed"> and start working on your application. There are a lot of features to develop JSF applications. We will describe the features - further.</para> + further.</diffmk:wrapper></para> </section> <section id="ImportingExsJSFProjWithAnyStr74447"> <title>Importing Existing JSF Projects with Any Structure</title> - <para>For detailed information on migration of JSF projects into a workspace see - <ulink url="../../Exadel-migration/html_single/index.html#jsf_struts">Migration - Guide</ulink>.</para> + <para><diffmk:wrapper diffmk:change="changed">For detailed information on migration of JSF projects into a workspace see + </diffmk:wrapper><ulink url="../../Exadel-migration/html_single/index.html#jsf_struts"><diffmk:wrapper diffmk:change="changed">Migration + Guide</diffmk:wrapper></ulink>.</para> </section> <section id="add_jsf_capability"> <title>Adding JSF Capability to Any Existing Eclipse Project</title> - <para>It's also possible to add <property moreinfo="none">JSF capability</property> (JSF + <para>It's also possible to add <property moreinfo="none">JSF capability</property><diffmk:wrapper diffmk:change="changed"> (JSF libraries, tag libraries) to any existing Eclipse project in your workspace. After that you'll be able to make use of such editors as JSF - configuration editor, JBoss Tools JSP editor and any others.</para> + configuration editor, JBoss Tools JSP editor and any others.</diffmk:wrapper></para> <para>Right click the project and select <emphasis> - <property moreinfo="none">JBoss Tools > Add JSF Capabilities</property>. </emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools > Add JSF Capabilities</diffmk:wrapper></property>. </emphasis><diffmk:wrapper diffmk:change="changed"> This will start the process of adding all necessary libraries, files to make - this a Web JSF project.</para> + this a Web JSF project.</diffmk:wrapper></para> <figure float="0"> <title>Adding JSF Capabilities</title> <mediaobject> @@ -726,31 +724,31 @@ </imageobject> </mediaobject> </figure> - <para>On the last form you can set the different folders for your project as well as - register this application with a servlet container.</para> + <para><diffmk:wrapper diffmk:change="changed">On the last form you can set the different folders for your project as well as + register this application with a servlet container.</diffmk:wrapper></para> <para>Make sure to select <emphasis> <property moreinfo="none">Add Libraries</property> - </emphasis> to add all required JSF related libraries to this - project.</para> + </emphasis><diffmk:wrapper diffmk:change="changed"> to add all required JSF related libraries to this + project.</diffmk:wrapper></para> <para>The <emphasis> <property moreinfo="none">Context Path</property> - </emphasis> is the name under which the application will be deployed.</para> + </emphasis><diffmk:wrapper diffmk:change="changed"> is the name under which the application will be deployed.</diffmk:wrapper></para> <para>The <emphasis> <property moreinfo="none">Runtime</property> - </emphasis> value tells Eclipse where to find Web libraries in order to + </emphasis><diffmk:wrapper diffmk:change="changed"> value tells Eclipse where to find Web libraries in order to build (compile) the project. It is not possible to finish project import - without selecting Runtime. If you don't have any values, select <emphasis> + without selecting Runtime. If you don't have any values, select </diffmk:wrapper><emphasis> <property moreinfo="none">New...</property> </emphasis> to add new Runtime.</para> <para>The <emphasis> <property moreinfo="none">Target Server</property> - </emphasis> allows you to specify whether to deploy the application. The + </emphasis><diffmk:wrapper diffmk:change="changed"> allows you to specify whether to deploy the application. The Target Server corresponds to the Runtime value selected above. If you - don't want to deploy the application, uncheck this value.</para> + don't want to deploy the application, uncheck this value.</diffmk:wrapper></para> <figure float="0"> <title>Project Folders</title> <mediaobject> @@ -759,20 +757,20 @@ </imageobject> </mediaobject> </figure> - <para>Once your project is imported you can see that JSF related libraries have been - added to your project: <emphasis> + <para><diffmk:wrapper diffmk:change="changed">Once your project is imported you can see that JSF related libraries have been + added to your project: </diffmk:wrapper><emphasis> <property moreinfo="none">jsf-api.jar</property> </emphasis> and <emphasis> <property moreinfo="none">jsf-impl.jar</property> </emphasis>.</para> <note> <title>Note:</title> - <para>Some application servers provide their own jsf implementation + <para><diffmk:wrapper diffmk:change="changed">Some application servers provide their own jsf implementation libraries. Thus, to avoid conflicts you should not add jsf libraries - while adding jsf capabilities.</para> + while adding jsf capabilities.</diffmk:wrapper></para> </note> - <para>You are now ready to work with JSF by creating a new JSF configuration - file:</para> + <para><diffmk:wrapper diffmk:change="changed">You are now ready to work with JSF by creating a new JSF configuration + file:</diffmk:wrapper></para> <figure float="0"> @@ -784,26 +782,26 @@ </mediaobject> </figure> - <para>Once the file has been created, it should be opened in a special <link linkend="jsf_config_file">Faces Config Editor</link>.</para> + <para><diffmk:wrapper diffmk:change="changed">Once the file has been created, it should be opened in a special </diffmk:wrapper><link linkend="jsf_config_file">Faces Config Editor</link>.</para> </section> <section id="AddingYourOwnProjectTemplates853"> <title>Adding Your Own Project Templates</title> - <para>Template is a set of files that is served as a basis to facilitate the + <para><diffmk:wrapper diffmk:change="changed">Template is a set of files that is served as a basis to facilitate the creation of a new project. Project templates provide content and structure - for a project.</para> - <para>There is a powerful templating capability for creating new and importing + for a project.</diffmk:wrapper></para> + <para><diffmk:wrapper diffmk:change="changed">There is a powerful templating capability for creating new and importing existing Struts and JSF projects. This templating facility has a variety of aspects to consider. But, let's start with the most straightforward case and consider the process of creating a template from your existing JSF - project.</para> + project.</diffmk:wrapper></para> - <para>Let's say you have a project that you want to use as the basis for a - new <property moreinfo="none">template</property>. Follow these steps to make a template out - of it:</para> + <para><diffmk:wrapper diffmk:change="changed">Let's say you have a project that you want to use as the basis for a + new </diffmk:wrapper><property moreinfo="none">template</property><diffmk:wrapper diffmk:change="changed">. Follow these steps to make a template out + of it:</diffmk:wrapper></para> <itemizedlist> <listitem> - <para>In the Web Projects view, right-click the project and select <emphasis> + <para><diffmk:wrapper diffmk:change="changed">In the Web Projects view, right-click the project and select </diffmk:wrapper><emphasis> <property moreinfo="none">JBoss Tools JSF > Save As Template</property> </emphasis></para> @@ -819,10 +817,10 @@ </figure> <itemizedlist> <listitem> - <para>In the first dialog box, you can choose a name for the + <para><diffmk:wrapper diffmk:change="changed">In the first dialog box, you can choose a name for the template (defaults to the project name) and confirm what run-time implementation of the project technology will be - used</para> + used</diffmk:wrapper></para> </listitem> </itemizedlist> @@ -840,10 +838,10 @@ <listitem> <para>Select <emphasis> <property moreinfo="none">Next</property> - </emphasis> and you will be sent to a dialog box with your + </emphasis><diffmk:wrapper diffmk:change="changed"> and you will be sent to a dialog box with your project structure displayed with check boxes. Here you can check only those parts and files in your project directory - that should be part of the template</para> + that should be part of the template</diffmk:wrapper></para> </listitem> </itemizedlist> <figure float="0"> @@ -856,28 +854,49 @@ </figure> <itemizedlist> <listitem> - <para>At this point, unless you want to designate some extra files + <para><diffmk:wrapper diffmk:change="changed">At this point, unless you want to designate some extra files as having Velocity template coding inside them, you should - click <emphasis> + click </diffmk:wrapper><emphasis> <property moreinfo="none">Finish</property> </emphasis>.</para> </listitem> </itemizedlist> - <para>That's it. Now, you can use this template with any new or imported + <para><diffmk:wrapper diffmk:change="changed">That's it. Now, you can use this template with any new or imported project that uses the same run-time implementation as the project you turned - into a template.</para> - <para>At this point, you have a fully configured project and now you can bring some - new logic to it starting from JSF configuration file.</para> + into a template.</diffmk:wrapper></para> + <para><diffmk:wrapper diffmk:change="changed">At this point, you have a fully configured project and now you can bring some + new logic to it starting from JSF configuration file.</diffmk:wrapper></para> </section> - <section> - <title>Relevant Resources Links</title> + <section diffmk:change="added"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Relevant Resources Links</diffmk:wrapper></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 JSF applications in our <ulink url="../../jsf/html_single/index.html">Visual Web Tools guide</ulink>.</para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">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 JSF applications in our </diffmk:wrapper><ulink diffmk:change="added" url="../../jsf/html_single/index.html"><diffmk:wrapper diffmk:change="added">Visual Web Tools guide</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> </section> </chapter> +<chapter diffmk:change="added" id="webxml_editor" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/jsf_tools_ref_guide/en/modules/webxml_editor.xml" xreflabel="webxml_editor"> + <?dbhtml filename="webxml_editor.html"?> + <chapterinfo diffmk:change="added"> + <keywordset diffmk:change="added"> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></keyword> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">JSF Tools</diffmk:wrapper></keyword> + </keywordset> + </chapterinfo> + + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Web.xml Editor</diffmk:wrapper></title> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">web.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> file inside the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">WEB-INF</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> 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.</diffmk:wrapper></para> + + <para diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> add the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">web.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> file to created JSF project automatically and provides a special editor for its editing. + See the Visual Web Tools guide that gives a descriptive information on the </diffmk:wrapper><ulink diffmk:change="added" url="../../jsf/html_single/index.html#GraphicalWebApplicationFileEditor"><diffmk:wrapper diffmk:change="added">web.xml editor</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> +</chapter> + <chapter id="jsf_config_file" role="updated" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_config_file.xml"> <?dbhtml filename="jsf_config_file.html"?> <chapterinfo>

15 years, 4 months

1
0
0 / 0

JBoss Tools SVN: r17323 - trunk/jmx/docs/reference/en.

by jbosstools-commits＠lists.jboss.org

Author: ochikvina Date: 2009-08-27 08:18:42 -0400 (Thu, 27 Aug 2009) New Revision: 17323 Modified: trunk/jmx/docs/reference/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-810 - new master_output.xml is added; Modified: trunk/jmx/docs/reference/en/master_output.xml =================================================================== --- trunk/jmx/docs/reference/en/master_output.xml 2009-08-27 12:16:27 UTC (rev 17322) +++ trunk/jmx/docs/reference/en/master_output.xml 2009-08-27 12:18:42 UTC (rev 17323) @@ -28,13 +28,13 @@ <bookinfo> <title>JMX Tools Reference Guide</title> - <corpauthor> - <inlinemediaobject> - <imageobject role="fo"> - <imagedata fileref="images/jbosstools_logo.png" format="PNG"></imagedata> + <corpauthor diffmk:change="added"> + <inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added" role="fo"> + <imagedata diffmk:change="added" fileref="images/jbosstools_logo.png" format="PNG"></imagedata> </imageobject> - <imageobject role="html"> - <imagedata></imagedata> + <imageobject diffmk:change="added" role="html"> + <imagedata diffmk:change="added"></imagedata> </imageobject> </inlinemediaobject> </corpauthor>

15 years, 4 months

1
0
0 / 0

JBoss Tools SVN: r17322 - trunk/hibernatetools/docs/reference/en.

by jbosstools-commits＠lists.jboss.org

Author: ochikvina Date: 2009-08-27 08:16:27 -0400 (Thu, 27 Aug 2009) New Revision: 17322 Modified: trunk/hibernatetools/docs/reference/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-810 - new master_output.xml is added; Modified: trunk/hibernatetools/docs/reference/en/master_output.xml =================================================================== --- trunk/hibernatetools/docs/reference/en/master_output.xml 2009-08-27 12:15:48 UTC (rev 17321) +++ trunk/hibernatetools/docs/reference/en/master_output.xml 2009-08-27 12:16:27 UTC (rev 17322) @@ -26,13 +26,13 @@ ]><book lang="en" xmlns:diffmk="http://diffmk.sf.net/ns/diff"> <bookinfo> <title>Hibernate Tools Reference Guide</title> - <corpauthor> - <inlinemediaobject> - <imageobject role="fo"> - <imagedata fileref="images/jbosstools_logo.png" format="PNG"></imagedata> + <corpauthor diffmk:change="added"> + <inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added" role="fo"> + <imagedata diffmk:change="added" fileref="images/jbosstools_logo.png" format="PNG"></imagedata> </imageobject> - <imageobject role="html"> - <imagedata></imagedata> + <imageobject diffmk:change="added" role="html"> + <imagedata diffmk:change="added"></imagedata> </imageobject> </inlinemediaobject> </corpauthor> @@ -326,10 +326,10 @@ <para>The meta model is the model used by Hibernate Core to perform its object relational mapping. The model includes information about tables, columns, classes, properties, components, values, collections etc. The API is in <literal moreinfo="none">org.hibernate.mapping</literal> - and its main entry point is the <literal moreinfo="none">Configuration</literal> class, the same class that is + and its main entry point is the <property diffmk:change="added" moreinfo="none">Configuration</property> class, the same class that is used to build a session factory.</para> - <para>The model represented by the <literal moreinfo="none">Configuration</literal> class can be build in many + <para>The model represented by the <property diffmk:change="added" moreinfo="none">Configuration</property> class can be build in many ways. The following list the currently supported ones in <property moreinfo="none">Hibernate Tools</property>. </para> <para> @@ -339,11 +339,9 @@ <property moreinfo="none">hbm.xml</property> </emphasis> files, requires a <emphasis> <property moreinfo="none">hibernate.cfg.xml</property> - </emphasis>. Named core in Eclipse and <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><configuration></literal> - </property> - </emphasis> in ant.</para> + </emphasis><diffmk:wrapper diffmk:change="added">. Named core in Eclipse and + </diffmk:wrapper><code diffmk:change="added"><configuration></code><diffmk:wrapper diffmk:change="added"> + in ant.</diffmk:wrapper></para> </listitem> <listitem> @@ -351,11 +349,9 @@ <property moreinfo="none">hbm.xml</property> </emphasis> and annotated classes, requires a <emphasis> <property moreinfo="none">hibernate.cfg.xml</property> - </emphasis>. Named annotations in Eclipse and <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><annotationconfiguration></literal> - </property> - </emphasis> in ant.</para> + </emphasis><diffmk:wrapper diffmk:change="added">. Named annotations in Eclipse and + </diffmk:wrapper><code diffmk:change="added"><annotationconfiguration></code><diffmk:wrapper diffmk:change="added"> + in ant.</diffmk:wrapper></para> </listitem> <listitem> @@ -363,22 +359,18 @@ <property moreinfo="none">hbm.xml</property> </emphasis> and annotated classes requires that the project has a <emphasis> <property moreinfo="none">META-INF/persistence.xml</property> - </emphasis> in its classpath. Named JPA in Eclipse and <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><jpaconfiguration></literal> - </property> - </emphasis> in ant.</para> + </emphasis><diffmk:wrapper diffmk:change="added"> in its classpath. Named JPA in Eclipse and + </diffmk:wrapper><code diffmk:change="added"><jpaconfiguration></code><diffmk:wrapper diffmk:change="added"> + in ant.</diffmk:wrapper></para> </listitem> <listitem> - <para>A JDBC configuration uses <property moreinfo="none">Hibernate Tools</property> reverse engineering + <para>A JDBC configuration uses <property moreinfo="none">Hibernate Tools</property><diffmk:wrapper diffmk:change="added"> reverse engineering and reads its mappings via JDBC metadata + additional reverse engineering files (reveng.xml). Automatically used in Eclipse when doing reverse engineering from JDBC and - named <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><jdbcconfiguration></literal> - </property> - </emphasis> in ant.</para> + named + </diffmk:wrapper><code diffmk:change="added"><jdbcconfiguration></code><diffmk:wrapper diffmk:change="added"> + in ant.</diffmk:wrapper></para> </listitem> </itemizedlist> </para> @@ -419,8 +411,8 @@ <section> <title>Exporters</title> - <para>Code generation is done in so called Exporters. An <literal moreinfo="none">Exporter</literal> is handed a - Hibernate Meta Model represented as a <literal moreinfo="none">Configuration</literal> instance and it is then + <para>Code generation is done in so called Exporters. An <code diffmk:change="added">Exporter</code> is handed a + Hibernate Meta Model represented as a <code diffmk:change="added">Configuration</code> instance and it is then the job of the exporter to generate a set of code artifacts.</para> <para>The tools provides a default set of Exporter's which can be used in both Ant and the @@ -522,7 +514,7 @@ </emphasis> file if you do not already have such one.</para> <para>Start the wizard by clicking <emphasis> - <property moreinfo="none">New > Other (Ctrl+N)</property> + <property moreinfo="none">New > Other (Ctrl+N)</property><diffmk:wrapper diffmk:change="added"> or on a web Seam project in Web Projects view </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added"> WebContent -> New -> File -> Hibernate Configuration 3.0</diffmk:wrapper></property> </emphasis>, then <emphasis> <property moreinfo="none">Hibernate > Hibernate Configuration File (cfg.xml)</property> </emphasis> and press <emphasis> @@ -567,7 +559,7 @@ </section> <section id="console_conf"> - <title>Creating a Hibernate Console Configuration</title> + <title><diffmk:wrapper diffmk:change="changed">Hibernate Console Configuration</diffmk:wrapper></title> <para>A Console configuration describes how the <property moreinfo="none">Hibernate plugin</property> should configure <property moreinfo="none">Hibernate</property> and what configuration files, including which @@ -575,7 +567,10 @@ query prototyping, reverse engineering and code generation. You can have multiple named console configurations. Normally you would just need one per project, but more is definitely possible if your project requires this.</para> - + <section diffmk:change="added" id="creat_console_conf"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Creating a Hibernate Console Configuration</diffmk:wrapper></title> + + <para>You create a console configuration by running the <property moreinfo="none">Console Configuration Wizard</property>, shown in the following screenshot. The same wizard will also be used if you are coming from the <emphasis> @@ -1050,7 +1045,184 @@ </mediaobject> </figure> - </section> + </section> + <section diffmk:change="added" id="modif_console_conf"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Modifying a Hibernate Console Configuration + </diffmk:wrapper></title> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">When you created a hibernate console configuration you can modify it in 2 ways: + </diffmk:wrapper></para> + + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">right click on the configuration in + </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Hibernate Configurations View->Edit Configuration + </diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Opening Edit Configuration Wizard</diffmk:wrapper></title> + + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/plugins/plugins_4_c.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added"> After clicking you will see the Edit Configuration Wizard that is similar to </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Create Console Configuration</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added">,described in </diffmk:wrapper><link diffmk:change="added" linkend="creat_console_conf"><diffmk:wrapper diffmk:change="added">Creating a Hibernate Console Configuration section</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added">. + </diffmk:wrapper></para> + </listitem> + <listitem diffmk:change="added"><para diffmk:change="added"><diffmk:wrapper diffmk:change="added">use Properties view for modifying some of Console Configuration properties.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Properties View</diffmk:wrapper></title> + + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/plugins/plugins_4_b.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The following table describes the available settings in the Properties view. Most properties are changeable by left click but some are not. + + </diffmk:wrapper><table diffmk:change="added"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Properties</diffmk:wrapper></title> + + <tgroup cols="3" diffmk:change="added"> + <colspec align="left" colnum="1" colwidth="1*" diffmk:change="added"></colspec> + + <colspec colnum="2" colwidth="3*" diffmk:change="added"></colspec> + + <colspec align="left" colnum="3" colwidth="1*" diffmk:change="added"></colspec> + + <thead diffmk:change="added"> + <row diffmk:change="added"> + <entry align="center" diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Property</diffmk:wrapper></para> + </entry> + + <entry align="center" diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Description</diffmk:wrapper></para> + </entry> + + <entry align="center" diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Is Changeable</diffmk:wrapper></para> + </entry> + </row> + </thead> + + <tbody diffmk:change="added"> + <row diffmk:change="added"> + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Additional mapping files </diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">List of additional mapping files that should be loaded. + </diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">False</diffmk:wrapper></para> + </entry> + </row> + <row diffmk:change="added"> + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Configuration file</diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Path to a hibernate.cfg.xml file</diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">False</diffmk:wrapper></para> + </entry> + </row> + <row diffmk:change="added"> + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Connection</diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">DTP provided connection that you can use instead of what is in cfg.xml and jpa + persistence.xml. It's possible to use either already configured hibernate or + JPA connection or specify a new one here.</diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">True</diffmk:wrapper></para> + </entry> + </row> + <row diffmk:change="added"> + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Name</diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The unique name of the console configuration</diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">True</diffmk:wrapper></para> + </entry> + </row> + <row diffmk:change="added"> + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Project</diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The name of a java project which classpath should be used in the console + configuration</diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">True</diffmk:wrapper></para> + </entry> + </row> + <row diffmk:change="added"> + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Properties file</diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Path to a hibernate.properties file</diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">False</diffmk:wrapper></para> + </entry> + </row> + <row diffmk:change="added"> + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Type</diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Choose between "CORE", "ANNOTATIONS" and + "JPA" according to the method of relational mapping you want to use. Note that the two latter requires running Eclipse IDE with + a JDK 5 runtime, otherwise you will get classloading and/or version errors.</diffmk:wrapper></para> + </entry> + + <entry diffmk:change="added"> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">True</diffmk:wrapper></para> + </entry> + </row> + + </tbody> + </tgroup> + </table> + + </para> + </listitem> + </itemizedlist> + </section> + + </section> + + <section id="refeng_codegen" role="updated"> <title>Reverse Engineering and Code Generation</title> @@ -1235,13 +1407,13 @@ </entry> <entry> - <para>A table that has a multi-column primary key a <composite-id> + <para><diffmk:wrapper diffmk:change="added">A table that has a multi-column primary key a <composite-id> mapping will always be created. If this option is enabled and there are matching foreign-keys each key column is still considered a 'basic' scalar (string, long, etc.) instead of a reference to an entity. If you disable this option a - <key-many-to-one> instead. Note: a <many-to-one> + </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added"><key-many-to-one></diffmk:wrapper></code><diffmk:wrapper diffmk:change="added"> instead. Note: a </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added"><many-to-one></diffmk:wrapper></code><diffmk:wrapper diffmk:change="added"> property is still created, but is simply marked as non-updatable and - non-insertable.</para> + non-insertable.</diffmk:wrapper></para> </entry> </row> @@ -1708,13 +1880,11 @@ <title>Java property/class completion</title> <para>Package, class, and field completion is enabled for relevant XML attributes. The - auto-completion detects its context and limits the completion for e.g. <emphasis> - <property moreinfo="none"><property></property> - </emphasis> and only shows the properties/fields available in the enclosing <emphasis> - <property moreinfo="none"><class></property> - </emphasis>, <emphasis> - <property moreinfo="none"><subclass></property> - </emphasis> etc. It is also possible to navigate from the <emphasis> + auto-completion detects its context and limits the completion for e.g. <code diffmk:change="added"><property></code><diffmk:wrapper diffmk:change="added"> and only shows the properties/fields available in the enclosing + </diffmk:wrapper><code diffmk:change="added"><class></code><diffmk:wrapper diffmk:change="added"> + , + </diffmk:wrapper><code diffmk:change="added"><subclass></code><diffmk:wrapper diffmk:change="added"> + etc. It is also possible to navigate from the </diffmk:wrapper><emphasis> <property moreinfo="none">hbm.xml</property> </emphasis> files to the relevant class/field in java code.</para> @@ -1790,9 +1960,7 @@ <para>In <emphasis> <property moreinfo="none">cfg.xml</property> - </emphasis> code completion for the value of <emphasis> - <property moreinfo="none"><property> name</property> - </emphasis> attributes is available.</para> + </emphasis> code completion for the value of <code diffmk:change="added"><property> name</code> attributes is available.</para> <figure float="0"> @@ -2177,7 +2345,7 @@ </emphasis><diffmk:wrapper diffmk:change="changed"> in the context menu for any entity (or any entity child node) will also open the HQL editor with the associated query. If you choose </diffmk:wrapper><emphasis> <property moreinfo="none">Hibernate Criteria Editor</property> - </emphasis><diffmk:wrapper diffmk:change="added"> in the context menu, it will open </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Hibernate Criteria Editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> with the associated cretaria.</diffmk:wrapper></para> + </emphasis><diffmk:wrapper diffmk:change="added"> in the context menu, it will open </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Hibernate Criteria Editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> with the associated criteria.</diffmk:wrapper></para> <figure float="0"> <title><diffmk:wrapper diffmk:change="changed">Generating Simple Queries</diffmk:wrapper></title> @@ -2269,7 +2437,7 @@ <section> <title>Properties View</title> - <para>As you can see on the figure, <property moreinfo="none">Properties view</property> shows the number of + <para><diffmk:wrapper diffmk:change="changed">As you can see on the figure,when clicking on class/entity </diffmk:wrapper><property moreinfo="none">Properties view</property> shows the number of query results as well as the time of executing.</para> <figure float="0"> @@ -2300,6 +2468,8 @@ </imageobject> </mediaobject> </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can also use </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Properties view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> when clicking on the configuration + itself in Hibernate Configuration View( </diffmk:wrapper><link diffmk:change="added" linkend="modif_console_conf"><diffmk:wrapper diffmk:change="added">Modifying a Hibernate Console Configuration section</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added">). </diffmk:wrapper></para> </section> </section> <section diffmk:change="added" id="jpa_annotations"> @@ -2605,11 +2775,9 @@ classpathref="toolslib" /> ]]></programlisting> - <para>This <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><taskdef></literal> - </property> - </emphasis> defines an Ant task called <emphasis> + <para><diffmk:wrapper diffmk:change="added">This + </diffmk:wrapper><code diffmk:change="added"><taskdef></code><diffmk:wrapper diffmk:change="added"> + defines an Ant task called </diffmk:wrapper><emphasis> <property moreinfo="none"> hibernatetool </property> </emphasis> which now can be used anywhere in your ant <emphasis> <property moreinfo="none">build.xml</property> @@ -2756,9 +2924,7 @@ <section> <title>Basic examples</title> - <para>The following example shows the most basic setup for generating pojo's via <emphasis> - <property moreinfo="none"><hbm2java></property> - </emphasis> from a normal <emphasis> + <para>The following example shows the most basic setup for generating pojo's via <code diffmk:change="added"><hbm2java></code> from a normal <emphasis> <property moreinfo="none"> <literal moreinfo="none">hibernate.cfg.xml</literal> </property>. </emphasis> The output will be put in the <emphasis> @@ -2776,11 +2942,8 @@ <para>The following example is similar, but now we are performing multiple exports from the - same configuration. We are exporting the schema via <emphasis> - <property moreinfo="none"><hbm2dll></property>, </emphasis> generates some DAO code via <emphasis> - <property moreinfo="none"><hbm2dao></property> - </emphasis> and finally runs a custom code generation via <emphasis> - <property moreinfo="none"><hbmtemplate></property>. </emphasis> This is again from a normal <emphasis> + same configuration. We are exporting the schema via <code diffmk:change="added"><hbm2dll></code><diffmk:wrapper diffmk:change="added">, generates some DAO code via </diffmk:wrapper><code diffmk:change="added"><hbm2dao></code><diffmk:wrapper diffmk:change="added"> + and finally runs a custom code generation via </diffmk:wrapper><code diffmk:change="added"><hbmtemplate></code><diffmk:wrapper diffmk:change="added">. This is again from a normal </diffmk:wrapper><emphasis> <property moreinfo="none">hibernate.cfg.xml</property> </emphasis> and the output is still put in the <emphasis> <property moreinfo="none"> @@ -2811,14 +2974,14 @@ <section> <title>Hibernate Configurations</title> - <para><literal moreinfo="none">Hibernatetool</literal> supports four different Hibernate configurations: A - standard Hibernate configuration <emphasis> - (<property moreinfo="none"><configuration></property>), </emphasis> Annotation based - configuration <emphasis> (<property moreinfo="none"><annotationconfiguration></property>), - </emphasis> JPA persistence based configuration <emphasis> - (<property moreinfo="none"><jpaconfiguration></property>) </emphasis> and a JDBC based - configuration <emphasis> (<property moreinfo="none"><jdbcconfiguration></property>) </emphasis> - for use when reverse engineering.</para> + <para><emphasis><diffmk:wrapper diffmk:change="added">Hibernatetool</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> supports four different Hibernate configurations: A + standard Hibernate configuration + (</diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added"><configuration></diffmk:wrapper></code><diffmk:wrapper diffmk:change="added">), Annotation based + configuration (</diffmk:wrapper><code diffmk:change="added"><annotationconfiguration></code><diffmk:wrapper diffmk:change="added">), + JPA persistence based configuration + (</diffmk:wrapper><code diffmk:change="added"><jpaconfiguration></code><diffmk:wrapper diffmk:change="added">) and a JDBC based + configuration (</diffmk:wrapper><code diffmk:change="added"><jdbcconfiguration></code><diffmk:wrapper diffmk:change="added">) + for use when reverse engineering.</diffmk:wrapper></para> <para>Each have in common that they are able to build up a Hibernate Configuration object from which a set of exporters can be run to generate various output. </para> @@ -2835,10 +2998,10 @@ <section> <title>Standard Hibernate Configuration (<configuration>)</title> - <para>A <emphasis> - <property moreinfo="none"><configuration></property> - </emphasis> is used to define a standard Hibernate configuration. A standard Hibernate - configuration reads the mappings from a <emphasis> + <para><diffmk:wrapper diffmk:change="added">A + </diffmk:wrapper><code diffmk:change="added"><configuration></code><diffmk:wrapper diffmk:change="added"> + is used to define a standard Hibernate configuration. A standard Hibernate + configuration reads the mappings from a </diffmk:wrapper><emphasis> <property moreinfo="none">cfg.xml</property> </emphasis> and/or a fileset.</para> @@ -2993,25 +3156,25 @@ <section> <title>Annotation based Configuration (<annotationconfiguration>)</title> - <para>An <emphasis> - <property moreinfo="none"><annotationconfiguration></property> - </emphasis> is used when you want to read the metamodel from EJB3/Hibernate Annotations - based POJO's.</para> + <para><diffmk:wrapper diffmk:change="added">An + </diffmk:wrapper><code diffmk:change="added"><annotationconfiguration></code><diffmk:wrapper diffmk:change="added"> + is used when you want to read the metamodel from EJB3/Hibernate Annotations + based POJO's.</diffmk:wrapper></para> <important> <title>Important:</title> - <para>To use it remember to put the jar files needed for using hibernate annotations in the - classpath of the <emphasis> - <property moreinfo="none"><taskdef></property>, </emphasis> i. e. - hibernate-annotations.jar and hibernate-commons-annotations.jar.</para> + <para><diffmk:wrapper diffmk:change="added">To use it remember to put the jar files needed for using hibernate annotations in the + classpath of the + </diffmk:wrapper><code diffmk:change="added"><taskdef></code><diffmk:wrapper diffmk:change="added">, i. e. + hibernate-annotations.jar and hibernate-commons-annotations.jar.</diffmk:wrapper></para> </important> - <para>The <emphasis> - <property moreinfo="none"><annotationconfiguration></property> - </emphasis> supports the same attributes as a <emphasis> - <property moreinfo="none"><configuration></property> - </emphasis> except that the configurationfile attribute is now required as that is from - where an <literal moreinfo="none">AnnotationConfiguration</literal> gets the list of classes/packages it + <para><diffmk:wrapper diffmk:change="added">The + </diffmk:wrapper><code diffmk:change="added"><annotationconfiguration></code><diffmk:wrapper diffmk:change="added"> + supports the same attributes as a + </diffmk:wrapper><code diffmk:change="added"><configuration></code><diffmk:wrapper diffmk:change="added"> + except that the configurationfile attribute is now required as that is from + where an </diffmk:wrapper><emphasis diffmk:change="added">AnnotationConfiguration</emphasis> gets the list of classes/packages it should load.</para> <para>Thus the minimal usage is:</para> @@ -3030,20 +3193,18 @@ <section> <title>JPA based configuration (<jpaconfiguration>)</title> - <para>A <emphasis> - <property moreinfo="none"><jpaconfiguration></property> - </emphasis> is used when you want to read the metamodel from JPA/Hibernate Annotation where + <para>A <code diffmk:change="added"><jpaconfiguration></code><diffmk:wrapper diffmk:change="added"> + is used when you want to read the metamodel from JPA/Hibernate Annotation where you want to use the auto-scan configuration as defined in the JPA spec (part of EJB3). In - other words, when you do not have a <emphasis> + other words, when you do not have a </diffmk:wrapper><emphasis> <property moreinfo="none">hibernate.cfg.xml</property>, </emphasis> but instead have a setup where you use a <emphasis> <property moreinfo="none">persistence.xml</property> </emphasis> packaged in a JPA compliant manner.</para> - <para>The <emphasis> - <property moreinfo="none"><jpaconfiguration></property> - </emphasis> will simply just try and auto-configure it self based on the available - classpath, e.g. look for <emphasis> + <para>The <code diffmk:change="added"><jpaconfiguration></code><diffmk:wrapper diffmk:change="added"> + will simply just try and auto-configure it self based on the available + classpath, e.g. look for </diffmk:wrapper><emphasis> <property moreinfo="none">META-INF/persistence.xml</property>. </emphasis></para> <para>The <emphasis> @@ -3053,12 +3214,9 @@ </emphasis> is specified it will automatically search for one and if a unique one is found, use it, but if multiple persistence units are available it will error.</para> - <para>To use a <emphasis> - <property moreinfo="none"><jpaconfiguration></property> - </emphasis> you will need to specify some additional jars from Hibernate EntityManager in - the <emphasis> - <property moreinfo="none"><taskdef></property> - </emphasis> of the hibernatetool. The following shows a full setup:</para> + <para>To use a <code diffmk:change="added"><jpaconfiguration></code><diffmk:wrapper diffmk:change="added"> + you will need to specify some additional jars from Hibernate EntityManager in + the </diffmk:wrapper><code diffmk:change="added"><taskdef></code> of the hibernatetool. The following shows a full setup:</para> <programlisting format="linespecific" role="XML"><![CDATA[<path id="ejb3toolslib"> <path refid="jpatoolslib"/>  @@ -3098,11 +3256,7 @@ <section> <title>JDBC Configuration for reverse engineering (<jdbcconfiguration>)</title> - <para>A <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><jdbcconfiguration></literal> - </property> - </emphasis> is used to perform reverse engineering of the database from a JDBC connection.</para> + <para>A <code diffmk:change="added"><jdbcconfiguration></code> is used to perform reverse engineering of the database from a JDBC connection.</para> <para>This configuration works by reading the connection properties either from <emphasis> <property moreinfo="none">hibernate.cfg.xml</property> @@ -3110,15 +3264,9 @@ <property moreinfo="none">hibernate.properties</property> </emphasis> with a fileset.</para> - <para>The <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><jdbcconfiguration></literal> - </property> - </emphasis> has the same attributes as a <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><configuration></literal> - </property> - </emphasis> plus the following additional attributes:</para> + <para>The <code diffmk:change="added"><jdbcconfiguration></code><diffmk:wrapper diffmk:change="added"> has the same attributes as a + </diffmk:wrapper><code diffmk:change="added"><configuration></code><diffmk:wrapper diffmk:change="added"> + plus the following additional attributes:</diffmk:wrapper></para> <programlisting format="linespecific" role="XML"><![CDATA[<jdbcconfiguration ... @@ -3188,12 +3336,11 @@ </entry> <entry> - <para>Name of a class that implements - org.hibernate.cfg.reveng.ReverseEngineeringStrategy. Used for setting up the - strategy the tools will use to control the reverse engineering, e.g. naming of + <para><diffmk:wrapper diffmk:change="changed">Name of a class that implements org.hibernate.cfg.reveng.ReverseEngineeringStrategy. + Used for setting up the strategy the tools will use to control the reverse engineering, e.g. naming of properties, which tables to include/exclude etc. Using a class instead of (or as addition to) a reveng.xml file gives you full programmatic control of the reverse - engineering.</para> + engineering.</diffmk:wrapper></para> </entry> <entry> @@ -3224,9 +3371,9 @@ </entry> <entry> - <para>If true, columns named VERSION or TIMESTAMP with appropriate types will be + <para><diffmk:wrapper diffmk:change="added">If true, columns named VERSION or TIMESTAMP with appropriate types will be mapped with the appropriate optimistic locking corresponding to - <version> or <timestamp>.</para> + </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added"><version></diffmk:wrapper></code><diffmk:wrapper diffmk:change="added"> or </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added"><timestamp></diffmk:wrapper></code><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> </entry> <entry> @@ -3242,13 +3389,9 @@ <section> <title>Example</title> - <para>Here is an example of using <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><jdbcconfiguration></literal> - </property> - </emphasis> to generate Hibernate xml mappings via <emphasis> - <property moreinfo="none"><hbm2hbmxml></property>.</emphasis> The connection settings here - is read from a <emphasis> + <para>Here is an example of using <code diffmk:change="added"><jdbcconfiguration></code><diffmk:wrapper diffmk:change="added"> to generate Hibernate xml mappings via + </diffmk:wrapper><code diffmk:change="added"><hbm2hbmxml></code><diffmk:wrapper diffmk:change="added">. The connection settings here + is read from a </diffmk:wrapper><emphasis> <property moreinfo="none"> hibernate.properties </property> </emphasis> file but could just as well have been read from a <emphasis> <property moreinfo="none">hibernate.cfg.xml</property>. </emphasis></para> @@ -3267,19 +3410,15 @@ <para>Exporters are the parts that do the actual job of converting the hibernate metamodel into various artifacts, mainly code. The following section describes the current supported set of - exporters in the <property moreinfo="none">Hibernate Tool</property> distribution. It is also possible for - userdefined exporters, that is done through the <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><hbmtemplate></literal> - </property> - </emphasis> exporter.</para> + exporters in the <property moreinfo="none">Hibernate Tool</property><diffmk:wrapper diffmk:change="added"> distribution. It is also possible for + userdefined exporters, that is done through the + </diffmk:wrapper><code diffmk:change="added"><hbmtemplate></code><diffmk:wrapper diffmk:change="added"> + exporter.</diffmk:wrapper></para> <section> <title>Database schema exporter (<hbm2ddl>)</title> - <para><emphasis> - <property moreinfo="none"><hbm2ddl></property> - </emphasis> lets you run schemaexport and schemaupdate which generates the appropriate SQL + <para><code diffmk:change="added"><hbm2ddl></code> lets you run schemaexport and schemaupdate which generates the appropriate SQL DDL and allow you to store the result in a file or export it directly to the database. Remember that if a custom naming strategy is needed it is placed on the configuration element.</para> @@ -3444,9 +3583,8 @@ <section> <title>Example</title> - <para>Basic example of using <emphasis> - <property moreinfo="none"><hbm2ddl></property>, </emphasis> which does not export to the - database but simply dumps the sql to a file named <emphasis> + <para>Basic example of using <code diffmk:change="added"><hbm2ddl></code><diffmk:wrapper diffmk:change="added">, which does not export to the + database but simply dumps the sql to a file named </diffmk:wrapper><emphasis> <property moreinfo="none">sql.ddl</property>. </emphasis></para> <programlisting format="linespecific" role="XML"><![CDATA[<hibernatetool destdir="${build.dir}/generated"> @@ -3457,11 +3595,9 @@ </section> <section> - <title>POJO java code exporter (<literal moreinfo="none"><hbm2java></literal>)</title> + <title><diffmk:wrapper diffmk:change="added">POJO java code exporter (<hbm2java>)</diffmk:wrapper></title> - <para><emphasis> - <property moreinfo="none"><hbm2java></property> - </emphasis> is a java codegenerator. Options for controlling whether JDK 5 syntax can be + <para><code diffmk:change="added"><hbm2java></code> is a java codegenerator. Options for controlling whether JDK 5 syntax can be used and whether the POJO should be annotated with EJB3/Hibernate Annotations.</para> <programlisting format="linespecific" role="XML"><![CDATA[<hbm2java @@ -3529,9 +3665,7 @@ <section> <title>Example</title> - <para>Basic example of using <emphasis> - <property moreinfo="none"><hbm2java></property> - </emphasis> to generate POJO's that utilize jdk5 constructs.</para> + <para>Basic example of using <code diffmk:change="added"><hbm2java></code> to generate POJO's that utilize jdk5 constructs.</para> <programlisting format="linespecific" role="XML"><![CDATA[<hibernatetool destdir="${build.dir}/generated"> <configuration configurationfile="hibernate.cfg.xml"/> @@ -3541,14 +3675,12 @@ </section> <section> - <title>Hibernate Mapping files exporter (<literal moreinfo="none"><hbm2hbmxml></literal>)</title> + <title><diffmk:wrapper diffmk:change="added">Hibernate Mapping files exporter (<hbm2hbmxml>)</diffmk:wrapper></title> - <para><emphasis> - <property moreinfo="none"><hbm2hbmxml></property> - </emphasis> generates a set of .hbm files. Intended to be used together with a <emphasis> - <property moreinfo="none"><jdbcconfiguration></property> - </emphasis> when performing reverse engineering, but can be used with any kind of - configuration. e.g. to convert from annotation based pojo's to <emphasis> + <para><code diffmk:change="added"><hbm2hbmxml></code><diffmk:wrapper diffmk:change="added"> generates a set of .hbm files. Intended to be used together with a + </diffmk:wrapper><code diffmk:change="added"><jdbcconfiguration></code><diffmk:wrapper diffmk:change="added"> + when performing reverse engineering, but can be used with any kind of + configuration. e.g. to convert from annotation based pojo's to </diffmk:wrapper><emphasis> <property moreinfo="none">hbm.xml</property>. </emphasis></para> <note> @@ -3562,23 +3694,17 @@ <section> <title>Example</title> - <para>Basic usage of <emphasis> - <property moreinfo="none"><hbm2hbmxml></property>. </emphasis></para> + <para>Basic usage of <code diffmk:change="added"><hbm2hbmxml></code>. </para> <programlisting format="linespecific" role="XML"><![CDATA[<hibernatetool destdir="${build.dir}/generated"> <configuration configurationfile="hibernate.cfg.xml"/> <hbm2hbmxml/> </hibernatetool>]]></programlisting> - <para><emphasis> - <property moreinfo="none"><hbm2hbmxml></property> - </emphasis> is normally used with a <emphasis> - <property moreinfo="none"><jdbcconfiguration></property> - </emphasis> like in the above example, but any other configuration can also be used to + <para><code diffmk:change="added"><hbm2hbmxml></code> is normally used with a <code diffmk:change="added"><jdbcconfiguration></code> like in the above example, but any other configuration can also be used to convert between the different ways of performing mappings. Here is an example of that, - using an <emphasis> - <property moreinfo="none"><annotationconfiguration></property> - </emphasis>.</para> + using an <code diffmk:change="added"><annotationconfiguration></code><diffmk:wrapper diffmk:change="added"> + .</diffmk:wrapper></para> <note> <title>Note:</title> @@ -3594,17 +3720,12 @@ </section> <section> - <title>Hibernate Configuration file exporter (<literal moreinfo="none"><hbm2cfgxml></literal>)</title> + <title><diffmk:wrapper diffmk:change="added">Hibernate Configuration file exporter (<hbm2cfgxml>)</diffmk:wrapper></title> - <para><emphasis> - <property moreinfo="none"><hbm2cfgxml></property> - </emphasis> generates a <emphasis> - <property moreinfo="none">hibernate.cfg.xml</property>. </emphasis> Intended to be used together with a <emphasis> - <property moreinfo="none"><jdbcconfiguration></property> - </emphasis> when performing reverse engineering, but it can be used with any kind of - configuration. The <emphasis> - <property moreinfo="none"><hbm2cfgxml></property> - </emphasis> will contain the properties used and adds mapping entries for each mapped class.</para> + <para><code diffmk:change="added"><hbm2cfgxml></code> generates a <emphasis> + <property moreinfo="none">hibernate.cfg.xml</property>. </emphasis> Intended to be used together with a <code diffmk:change="added"><jdbcconfiguration></code><diffmk:wrapper diffmk:change="added"> + when performing reverse engineering, but it can be used with any kind of + configuration. The </diffmk:wrapper><code diffmk:change="added"><hbm2cfgxml></code> will contain the properties used and adds mapping entries for each mapped class.</para> <programlisting format="linespecific" role="XML"><![CDATA[<hbm2cfgxml ejb3="true|false" @@ -3658,11 +3779,10 @@ </section> <section> - <title>Documentation exporter (<literal moreinfo="none"><hbm2doc></literal>)</title> + <title><diffmk:wrapper diffmk:change="added">Documentation exporter (<hbm2doc>)</diffmk:wrapper></title> - <para><emphasis> - <property moreinfo="none"><hbm2doc></property> - </emphasis> generates html documentation a'la javadoc for the database schema et.al.</para> + <para><code diffmk:change="added"><hbm2doc></code><diffmk:wrapper diffmk:change="added"> + generates html documentation a'la javadoc for the database schema et.al.</diffmk:wrapper></para> <programlisting format="linespecific" role="XML"><![CDATA[<hbm2doc/>]]></programlisting> </section> @@ -3670,9 +3790,7 @@ <section> <title>Query exporter (<query>)</title> - <para><emphasis> - <property moreinfo="none"><query></property> - </emphasis> is used to execute a HQL query statements and optionally sends the output to a + <para><code diffmk:change="added"><query></code> is used to execute a HQL query statements and optionally sends the output to a file. It can be used for verifying the mappings and for basic data extraction.</para> <programlisting format="linespecific" role="XML"><![CDATA[<query @@ -3690,9 +3808,7 @@ <section> <title>Examples</title> - <para>The simplest usage of <emphasis> - <property moreinfo="none"><query></property> - </emphasis> will just execute the query without dumping to a file. This can be used to + <para>The simplest usage of <code diffmk:change="added"><query></code> will just execute the query without dumping to a file. This can be used to verify that queries can actually be performed.</para> <programlisting format="linespecific" role="XML"><![CDATA[<hibernatetool> @@ -3700,9 +3816,8 @@ <query>from java.lang.Object</query> </hibernatetool>]]></programlisting> - <para>Multiple queries can be executed by nested <emphasis> - <property moreinfo="none"><hql></property> - </emphasis> elements. In this example we also let the output be dumped to <emphasis> + <para>Multiple queries can be executed by nested <code diffmk:change="added"><hql></code><diffmk:wrapper diffmk:change="added"> elements. + In this example we also let the output be dumped to </diffmk:wrapper><emphasis> <property moreinfo="none">queryresult.txt</property>. </emphasis></para> <note> @@ -3721,7 +3836,7 @@ </section> <section id="hbmtemplate"> - <title>Generic Hibernate metamodel exporter (<literal moreinfo="none"><hbmtemplate></literal>)</title> + <title><diffmk:wrapper diffmk:change="added">Generic Hibernate metamodel exporter (<hbmtemplate>)</diffmk:wrapper></title> <para>Generic exporter that can be controlled by a user provides a template or class.</para> @@ -3740,11 +3855,9 @@ <section> <title>Exporter via <hbmtemplate></title> - <para>The following is an example of reverse engineering via <emphasis> - <property moreinfo="none"><jdbcconfiguration></property> - </emphasis> and usage of a custom Exporter via the <emphasis> - <property moreinfo="none"><hbmtemplate></property> - </emphasis>.</para> + <para><diffmk:wrapper diffmk:change="added">The following is an example of reverse engineering via + </diffmk:wrapper><code diffmk:change="added"><jdbcconfiguration></code><diffmk:wrapper diffmk:change="added"> and usage of a custom Exporter via the + </diffmk:wrapper><code diffmk:change="added"><hbmtemplate></code>.</para> <programlisting format="linespecific" role="XML"><![CDATA[ <hibernatetool destdir="${destdir}"> <jdbcconfiguration @@ -3777,83 +3890,57 @@ <section> <title>Using properties to configure Exporters</title> - <para>Exporters can be controlled by user properties. The user properties are specified via <emphasis> - <property moreinfo="none"><property></property> - </emphasis> or <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><propertyset></literal> - </property> - </emphasis> and each exporter will have access to them directly in the templates and via - <property moreinfo="none">Exporter.setProperties()</property>.</para> + <para><diffmk:wrapper diffmk:change="added">Exporters can be controlled by user properties. The user properties are specified via + </diffmk:wrapper><code diffmk:change="added"><property></code><diffmk:wrapper diffmk:change="added"> + or + </diffmk:wrapper><code diffmk:change="added"><propertyset></code><diffmk:wrapper diffmk:change="added"> + and each exporter will have access to them directly in the templates and via + </diffmk:wrapper><property moreinfo="none">Exporter.setProperties()</property>.</para> <section> - <title><literal moreinfo="none"><property></literal> and - <literal moreinfo="none"><propertyset></literal></title> + <title><diffmk:wrapper diffmk:change="added"><property> and + <propertyset></diffmk:wrapper></title> - <para>The <emphasis> - <property moreinfo="none"><property></property> - </emphasis> allows you bind a string value to a key. The value will be available in the - templates via <emphasis> - <property moreinfo="none">$<key></property> - </emphasis>. The following example will assign the string value <emphasis> - <property moreinfo="none">"true"</property> - </emphasis> to the variable <emphasis> - <property moreinfo="none">$descriptors</property> - </emphasis>.</para> + <para>The <code diffmk:change="added"><property></code><diffmk:wrapper diffmk:change="added"> + allows you bind a string value to a key. The value will be available in the + templates via </diffmk:wrapper><code diffmk:change="added">$<key></code><diffmk:wrapper diffmk:change="added">. + The following example will assign the string value + </diffmk:wrapper><code diffmk:change="added">"true"</code><diffmk:wrapper diffmk:change="added"> + to the variable + </diffmk:wrapper><code diffmk:change="added">$descriptors</code><diffmk:wrapper diffmk:change="added"> + .</diffmk:wrapper></para> <programlisting format="linespecific" role="XML"><![CDATA[<property key="descriptors" value="true"/>]]></programlisting> - <para>Most times using <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><property></literal> - </property> - </emphasis> is enough for specifying the properties needed for the exporters. Still the ant - tools supports the notion of <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><propertyset></literal> - </property> - </emphasis> that is used for grouping a set of properties. More about the functionality of <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><propertyset></literal> - </property> - </emphasis> is explained in detail in the <ulink url="http://ant.apache.org/manual/">Ant + <para>Most times using <code diffmk:change="added"><property></code> is enough for specifying the properties needed for the exporters. Still the ant + tools supports the notion of <code diffmk:change="added"><propertyset></code> that is used for grouping a set of properties. More about the functionality of <code diffmk:change="added"><propertyset></code><diffmk:wrapper diffmk:change="added"> + is explained in detail in the </diffmk:wrapper><ulink url="http://ant.apache.org/manual/">Ant manual</ulink>.</para> </section> <section> <title>Getting access to user specific classes</title> - <para>If the templates need to access some user class it becomes possible by specifying a <emphasis> - <property moreinfo="none">"toolclass"</property> - </emphasis> in the properties.</para> + <para>If the templates need to access some user class it becomes possible by specifying a <code diffmk:change="added"><diffmk:wrapper diffmk:change="added"> + "toolclass"</diffmk:wrapper></code> in the properties.</para> <programlisting format="linespecific" role="XML"><![CDATA[<property key="hibernatetool.sometool.toolclass" value="x.y.z.NameOfToolClass"/> ]]></programlisting> - <para>Placing the above <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><property></literal> - </property> - </emphasis> tag in <emphasis> - <property moreinfo="none"> - <literal moreinfo="none"><hibernatetool></literal> - </property> - </emphasis> or inside any exporter will automatically create an instance of - <literal moreinfo="none">x.y.z.NameOfToolClass</literal> and it will be available in the templates as + <para>Placing the above <code diffmk:change="added"><property></code> tag in <code diffmk:change="added"><hibernatetool></code><diffmk:wrapper diffmk:change="added"> + or inside any exporter will automatically create an instance of + </diffmk:wrapper><literal moreinfo="none">x.y.z.NameOfToolClass</literal> and it will be available in the templates as <literal moreinfo="none">$sometool</literal>. This is useful to delegate logic and code generation to java code instead of placing such logic in the templates.</para> <section> <title>Example</title> - <para>Here is an example that uses <emphasis> - <property moreinfo="none"><hbmtemplate></property> - </emphasis> together with <emphasis> - <property moreinfo="none"><property></property> - </emphasis> which will be available to the templates/exporter. </para> + <para>Here is an example that uses <code diffmk:change="added"><hbmtemplate></code><diffmk:wrapper diffmk:change="added"> + together with </diffmk:wrapper><code diffmk:change="added"><property></code> which will be available to the templates/exporter. </para> <note> <title>Note:</title> - <para> This example actually simulates what <hbm2java> actually does.</para> + <para><diffmk:wrapper diffmk:change="added"> This example actually simulates what </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added"><hbm2java></diffmk:wrapper></code><diffmk:wrapper diffmk:change="added"> actually does.</diffmk:wrapper></para> </note> <programlisting format="linespecific" role="XML"><![CDATA[<hibernatetool destdir="${build.dir}/generated"> @@ -3877,12 +3964,9 @@ <chapter id="reverseengineering" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/hibernatetools/docs/reference/en/modules/reverseengineering.xml"> <title>Controlling reverse engineering</title> - <para>When using the <emphasis> - <property moreinfo="none"><jdbcconfiguration></property>, </emphasis> the ant task will read the + <para>When using the <code diffmk:change="added"><jdbcconfiguration></code><diffmk:wrapper diffmk:change="added">, the ant task will read the database metadata and thus will perform a reverse engineering of the database schema into a - normal Hibernate Configuration. It is from this object e.g. <emphasis> - <property moreinfo="none"><hbm2java></property> - </emphasis>can generate other artifacts such as <emphasis> + normal Hibernate Configuration. It is from this object e.g. </diffmk:wrapper><code diffmk:change="added"><hbm2java></code>can generate other artifacts such as <emphasis> <property moreinfo="none">.java</property> </emphasis>, <emphasis> <property moreinfo="none">.hbm.xml</property> @@ -3920,9 +4004,9 @@ <note> <title>Note:</title> - <para>Many databases are case-sensitive with their names and thus if you cannot make some - table match and you are sure it is not excluded by a <table-filter> then check - if the case matches; most databases stores table names in uppercase.</para> + <para><diffmk:wrapper diffmk:change="added">Many databases are case-sensitive with their names and thus if you cannot make some + table match and you are sure it is not excluded by a </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added"><table-filter></diffmk:wrapper></code><diffmk:wrapper diffmk:change="added"> then check + if the case matches; most databases stores table names in uppercase.</diffmk:wrapper></para> </note> <para>Below you can see an example of a <emphasis> @@ -3984,26 +4068,19 @@ <section> <title>Schema Selection (<schema-selection>)</title> - <para><emphasis> - <property moreinfo="none"><schema-selection></property> - </emphasis> is used to drive which schemas the reverse engineering will try and + <para><code diffmk:change="added"><schema-selection></code> is used to drive which schemas the reverse engineering will try and process.</para> - <para>By default the reverse engineering will read all schemas and then use <emphasis> - <property moreinfo="none"><table-filter></property> - </emphasis> to decide which tables get reverse engineered and which do not; this makes it - easy to get started but can be inefficient on databases with many schemas.</para> + <para>By default the reverse engineering will read all schemas and then use <code diffmk:change="added"><table-filter></code><diffmk:wrapper diffmk:change="added"> + to decide which tables get reverse engineered and which do not; this makes it + easy to get started but can be inefficient on databases with many schemas.</diffmk:wrapper></para> - <para>With <emphasis> - <property moreinfo="none"><schema-selection></property> - </emphasis> it is thus possible to limit the actual processed schemas and thus significantly - speed-up the reverse engineering. <emphasis> - <property moreinfo="none"><table-filter></property> - </emphasis> is still used to then decide which tables will be included/excluded.</para> + <para>With <code diffmk:change="added"><schema-selection></code> it is thus possible to limit the actual processed schemas and thus significantly + speed-up the reverse engineering. <code diffmk:change="added"><table-filter></code> is still used to then decide which tables will be included/excluded.</para> <note> <title>Note:</title> - <para>If no <literal moreinfo="none"><schema-selection></literal> is specified, the reverse + <para>If no <code diffmk:change="added"><schema-selection></code> is specified, the reverse engineering works as if all schemas should be processed. This is equal to: <![CDATA[<schema-selection/>]]>. Which in turn is equal to: <![CDATA[<schema-selection match-catalog=".*" match-schema=".*" match-table=".*"/>]]></para> @@ -4039,9 +4116,7 @@ <section id="type_map"> <title>Type mappings (<type-mapping>)</title> - <para>The <emphasis> - <property moreinfo="none"><type-mapping></property> - </emphasis> section specifies how the JDBC types found in the database should be mapped to + <para>The <code diffmk:change="added"><type-mapping></code> section specifies how the JDBC types found in the database should be mapped to Hibernate types. e.g. <emphasis> <property moreinfo="none">java.sql.Types.VARCHAR</property></emphasis> with a length of 1 should be mapped to the Hibernate type <emphasis> @@ -4233,11 +4308,10 @@ <section> <title>Table filters (<table-filter>)</title> - <para>The <emphasis> - <property moreinfo="none"><table-filter></property> - </emphasis> let you specify matching rules for performing general filtering/setup for + <para>The <code diffmk:change="added"><table-filter></code><diffmk:wrapper diffmk:change="added"> + let you specify matching rules for performing general filtering/setup for tables, e.g. let you include or exclude specific tables based on the schema or even a - specific prefix.</para> + specific prefix.</diffmk:wrapper></para> <programlisting format="linespecific" role="XML"><![CDATA[<table-filter match-catalog="catalog_matching_rule" @@ -4321,11 +4395,10 @@ <section id="tab_and_col"> <title>Specific table configuration (<table>)</title> - <para><emphasis> - <property moreinfo="none"><table></property> - </emphasis> allows you to provide explicit configuration on how a table should be reverse + <para><code diffmk:change="added"><table></code><diffmk:wrapper diffmk:change="added"> + allows you to provide explicit configuration on how a table should be reverse engineered. Amongst other things it allows controlling over the naming of a class for the - table, specifying which identifier generator should be used for the primary key etc.</para> + table, specifying which identifier generator should be used for the primary key etc.</diffmk:wrapper></para> <programlisting format="linespecific" role="XML"><![CDATA[<table catalog="catalog_name" @@ -4406,9 +4479,7 @@ <section> <title><primary-key></title> - <para>A <emphasis> - <property moreinfo="none"><primary-key></property> - </emphasis> allows you to define a primary-key for tables that don't have it + <para>A <code diffmk:change="added"><primary-key></code> allows you to define a primary-key for tables that don't have it defined in the database, and probably more importantly it allows you to define which identifier strategy should be used (even for already existing primary-key's).</para> @@ -4480,9 +4551,7 @@ <section> <title><column></title> - <para>With a <emphasis> - <property moreinfo="none"><column></property> - </emphasis> it is possible to explicitly name the resulting property for a column. It is + <para>With a <code diffmk:change="added"><column></code> it is possible to explicitly name the resulting property for a column. It is also possible to redefine what jdbc and/or Hibernate type a column should be processed as and finally it is possible to completely exclude a column from processing.</para> @@ -4571,11 +4640,10 @@ <section> <title><foreign-key></title> - <para>The <emphasis> - <property moreinfo="none"><foreign-key></property> - </emphasis> has two purposes. One for allowing to define foreign-keys in databases that + <para>The <code diffmk:change="added"><foreign-key></code><diffmk:wrapper diffmk:change="added"> + has two purposes. One for allowing to define foreign-keys in databases that does not support them or does not have them defined in their schema. Secondly, to allow - defining the name of the resulting properties (many-to-one, one-to-one and one-to-many's).</para> + defining the name of the resulting properties (many-to-one, one-to-one and one-to-many's).</diffmk:wrapper></para> <programlisting format="linespecific" role="XML"><![CDATA[<foreign-key constraint-name="foreignKeyName" @@ -4774,37 +4842,28 @@ <chapter id="codegen" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/hibernatetools/docs/reference/en/modules/codegen.xml"> <title>Controlling POJO code generation</title> - <para>When using <emphasis> - <property moreinfo="none"><hbm2java></property> - </emphasis> or the eclipse plugin to generate POJO java code you have the possibility to control - certain aspects of the code generation. This is primarily done with the <emphasis> - <property moreinfo="none"><meta></property> - </emphasis> tag in the mapping files. The following section describes the possible <emphasis> - <property moreinfo="none"><meta></property> - </emphasis> tags and their use.</para> + <para>When using <code diffmk:change="added"><hbm2java></code> or the eclipse plugin to generate POJO java code you have the possibility to control + certain aspects of the code generation. This is primarily done with the <code diffmk:change="added"><meta></code><diffmk:wrapper diffmk:change="added"> + tag in the mapping files. The following section describes the possible </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added"> + <meta> + </diffmk:wrapper></code> tags and their use.</para> <section> - <title>The <literal moreinfo="none"><meta></literal> attribute</title> + <title><diffmk:wrapper diffmk:change="added">The <meta> attribute</diffmk:wrapper></title> - <para>The <emphasis> - <property moreinfo="none"><meta></property> - </emphasis> tag is a simple way of annotating the <emphasis> + <para>The <code diffmk:change="added"><meta></code> tag is a simple way of annotating the <emphasis> <property moreinfo="none">hbm.xml</property> </emphasis> with information, so tools have a natural place to store/read information that is not directly related to the Hibernate core.</para> - <para>You can use the <emphasis> - <property moreinfo="none"><meta></property> - </emphasis> tag to e.g. tell <emphasis> - <property moreinfo="none"><hbm2java></property> - </emphasis> to only generate <emphasis> + <para>You can use the <code diffmk:change="added"><meta></code> tag to e.g. tell <code diffmk:change="added"><hbm2java></code><diffmk:wrapper diffmk:change="added"> + to only generate </diffmk:wrapper><emphasis> <property moreinfo="none">"protected"</property> </emphasis> setters, have classes always implement a certain set of interfaces or even have them extend a certain base class and even more.</para> - <para>The following example shows how to use various <emphasis> - <property moreinfo="none"><meta></property> - </emphasis> attributes and the resulting java code.</para> + <para>The following example shows how to use various <code diffmk:change="added"><meta></code><diffmk:wrapper diffmk:change="added"> + attributes and the resulting java code.</diffmk:wrapper></para> <programlisting format="linespecific" role="XML"><![CDATA[<class name="Person"> <meta attribute="class-description"> @@ -5030,52 +5089,49 @@ </tgroup> </table> - <para>Attributes declared via the <emphasis> - <property moreinfo="none"><meta></property> - </emphasis> tag are per default <emphasis> + <para>Attributes declared via the <code diffmk:change="added"><meta></code><diffmk:wrapper diffmk:change="added"> + tag are per default </diffmk:wrapper><emphasis> <property moreinfo="none">"inherited"</property> </emphasis> inside an <emphasis> <property moreinfo="none">hbm.xml</property> </emphasis> file.</para> <para>What does that mean? It means that if you e.g want to have all your classes implement - <literal moreinfo="none">IAuditable</literal> then you just add an <emphasis> <meta - attribute="implements">IAuditable</meta></emphasis> in the top of the <emphasis> + <property diffmk:change="added" moreinfo="none">IAuditable</property> then you just add an <code diffmk:change="added"> <meta + attribute="implements">IAuditable</meta></code> in the top of the <emphasis> <property moreinfo="none">hbm.xml</property> - </emphasis> file, just after <emphasis> - <property moreinfo="none"><hibernate-mapping></property>. </emphasis> Now all classes defined - in that <emphasis> + </emphasis> file, just after <code diffmk:change="added"><hibernate-mapping></code><diffmk:wrapper diffmk:change="added">. Now all classes defined + in that </diffmk:wrapper><emphasis> <property moreinfo="none">hbm.xml</property> - </emphasis> file will implement <literal moreinfo="none">IAuditable</literal>!</para> + </emphasis> file will implement <property diffmk:change="added" moreinfo="none">IAuditable</property>!</para> <note> <title>Note:</title> <para>This applies to <emphasis>all</emphasis> - <literal moreinfo="none"><meta></literal>-tags. Thus it can also e.g. be used to specify that + <code diffmk:change="added"><meta></code>-tags. Thus it can also e.g. be used to specify that all fields should be declare protected, instead of the default private. This is done by - adding <literal moreinfo="none"><meta - attribute="scope-field">protected</meta></literal> at e.g. just under - the <literal moreinfo="none"><class></literal> tag and all fields of that class will be + adding <code diffmk:change="added"><meta + attribute="scope-field">protected</meta></code> at e.g. just under + the <code diffmk:change="added"><class></code> tag and all fields of that class will be protected.</para> </note> - <para>To avoid having a <emphasis> - <property moreinfo="none"><meta></property> - </emphasis> tag inherited then you can simply specify <emphasis> inherit = "false"</emphasis> - for the attribute, e.g. <emphasis> <meta attribute = "scope-class" inherit = - "false">public abstract</meta></emphasis> will restrict the <emphasis> + <para>To avoid having a <code diffmk:change="added"><meta></code><diffmk:wrapper diffmk:change="added"> + tag inherited then you can simply specify </diffmk:wrapper><code diffmk:change="added"> inherit = "false"</code> + for the attribute, e.g. <code diffmk:change="added"> <meta attribute = "scope-class" inherit = + "false">public abstract</meta></code> will restrict the <emphasis> <property moreinfo="none">"class-scope"</property> </emphasis> to the current class, not the subclasses.</para> <section> <title>Recommendations</title> - <para>The following are some good practices when using <emphasis> - <property moreinfo="none"><meta></property> - </emphasis> attributes.</para> + <para><diffmk:wrapper diffmk:change="added">The following are some good practices when using + </diffmk:wrapper><code diffmk:change="added"><meta></code><diffmk:wrapper diffmk:change="added"> + attributes.</diffmk:wrapper></para> <section> - <title>Dangers of a class level <literal moreinfo="none">use-in-string and use-in-equals</literal> meta + <title>Dangers of a class level <property diffmk:change="added" moreinfo="none">use-in-string and use-in-equals</property> meta attributes when having bi-directional associations</title> <para>If we have two entities with a bi-directional association between them and define at @@ -5112,14 +5168,13 @@ </class> </hibernate-mapping>]]></programlisting> - <para>Then <emphasis> - <property moreinfo="none"><hbm2java></property> - </emphasis> will assume you want to include all properties and collections in the - <property moreinfo="none">toString()/equals()</property> methods and this can result in infinite + <para>Then <code diffmk:change="added"><hbm2java></code><diffmk:wrapper diffmk:change="added"> + will assume you want to include all properties and collections in the + </diffmk:wrapper><code diffmk:change="added">toString()/equals()</code> methods and this can result in infinite recursive calls.</para> <para>To remedy this you have to decide which side of the association will include the other - part (if at all) in the <property moreinfo="none">toString()/equals()</property> methods. Therefore it is + part (if at all) in the <code diffmk:change="added">toString()/equals()</code> methods. Therefore it is not a good practice to put at class scope such <emphasis> <property moreinfo="none">meta</property> </emphasis> attributes, unless you are defining a class without bi-directional @@ -5170,10 +5225,10 @@ </section> <section> - <title>Be aware of putting at class scope level <literal moreinfo="none"><meta></literal> - attribute <literal moreinfo="none">use-in-equals</literal></title> + <title><diffmk:wrapper diffmk:change="added">Be aware of putting at class scope level <meta> + attributeuse-in-equals</diffmk:wrapper></title> - <para>For <property moreinfo="none">equal()/hashCode()</property> method generation, you have to take into + <para>For <code diffmk:change="added">equal()/hashCode()</code> method generation, you have to take into account that the attributes that participate on such method definition, should take into account only attributes with business meaning (the name, social security number, etc, but no generated id's, for example).</para> @@ -5185,14 +5240,12 @@ set.</para> <para>Therefore automatically configuration of the generation of - <property moreinfo="none">equals()/hashCode()</property> methods specifying at class scope level the <emphasis> - <property moreinfo="none"><meta></property> - </emphasis> attribute <emphasis> + <property moreinfo="none">equals()/hashCode()</property> methods specifying at class scope level the <code diffmk:change="added"><meta></code> attribute <emphasis> <property moreinfo="none">use-in-equals</property> </emphasis> could be a dangerous decision that could produce non expected side-effect.</para> - <para><ulink url="http://www.hibernate.org/109.html">Here</ulink> you can get more in-depth + <para><ulink url="http://www.hibernate.org/109.html"><diffmk:wrapper diffmk:change="changed">On www.hibernate.org </diffmk:wrapper></ulink> you can get more in-depth explanation on the subject of <property moreinfo="none">equals()</property> and <property moreinfo="none">hashcode()</property>.</para> </section> @@ -5211,13 +5264,12 @@ <section> <title>Generate pre/post-conditions for methods</title> - <para>With a <emphasis> <meta attribute="class-code"></emphasis>, you can add - additional methods on a given class, nevertheless such <emphasis> - <property moreinfo="none"><meta></property> - </emphasis> attribute can not be used at a property scope level and <property moreinfo="none">Hibernate - Tools</property> does not provide such <emphasis> - <property moreinfo="none"><meta></property> - </emphasis> attributes.</para> + <para>With a <code diffmk:change="added"> <meta attribute="class-code"></code>, you can add + additional methods on a given class, nevertheless such <code diffmk:change="added"><meta></code><diffmk:wrapper diffmk:change="added"> + attribute can not be used at a property scope level and </diffmk:wrapper><property moreinfo="none">Hibernate + Tools</property> does not provide such <code diffmk:change="added"><diffmk:wrapper diffmk:change="added"> + ><meta> + </diffmk:wrapper></code> attributes.</para> <para>A possible solution for this is to modify the freemarker templates responsible for generating the POJO's. If you look inside <emphasis> @@ -5281,11 +5333,11 @@ <property moreinfo="none">.hbm.xml</property> </emphasis> file we define the <emphasis> <property moreinfo="none"><meta></property> - </emphasis> attributes: <literal moreinfo="none">pre-cond</literal> or <literal moreinfo="none">post-cond</literal>, their + </emphasis> attributes: <code diffmk:change="added">pre-cond</code> or <code diffmk:change="added">post-cond</code>, their contents will be generated into the body of the relevant <literal moreinfo="none">set</literal> method.</para> - <para>As an example let us add a pre-condition for property <literal moreinfo="none">name</literal> + <para>As an example let us add a pre-condition for property <code diffmk:change="added">name</code> preventing no <property moreinfo="none">Person</property> can have an empty name. Hence we have to modify the <emphasis> <property moreinfo="none">Person.hbm.xml</property> @@ -5308,8 +5360,8 @@ <note> <title>Note:</title> - <para>I) To escape the & symbol we put &amp;. You can use - <![CDATA[]]> instead.</para> + <para><diffmk:wrapper diffmk:change="added">I) To escape the & symbol we put &amp;. You can use + </diffmk:wrapper><code diffmk:change="added"><diffmk:wrapper diffmk:change="added"> <![CDATA[]]></diffmk:wrapper></code><diffmk:wrapper diffmk:change="added"> instead.</diffmk:wrapper></para> <para>II) Note that we are referring to "firstName" directly and this is the parameter name not the actual field name. If you want to refer the field you have to use "this.firstName" instead. </para> @@ -5318,9 +5370,8 @@ <para>Finally we have to generate the <emphasis> <property moreinfo="none">Person.java</property> </emphasis> class, for this we can use both Eclipse and Ant as long as you remember to set - or fill in the templatepath setting. For Ant we configure <emphasis> - <property moreinfo="none"><hibernatetool></property> - </emphasis> task via <literal moreinfo="none">the templatepath</literal> attribute as in:</para> + or fill in the templatepath setting. For Ant we configure <code diffmk:change="added"><hibernatetool></code><diffmk:wrapper diffmk:change="added"> + task via </diffmk:wrapper><literal moreinfo="none">the templatepath</literal> attribute as in:</para> <programlisting format="linespecific" role="XML"><![CDATA[ <target name="hbm2java"> @@ -5341,9 +5392,8 @@ </hibernatetool> </target>]]></programlisting> - <para>Invoking the target <emphasis> - <property moreinfo="none"><hbm2java></property> - </emphasis> will generate on the <emphasis> + <para>Invoking the target <code diffmk:change="added"><hbm2java></code><diffmk:wrapper diffmk:change="added"> + will generate on the </diffmk:wrapper><emphasis> <property moreinfo="none">${hbm2java.dest.dir}</property> </emphasis> the file <emphasis> <property moreinfo="none">Person.java</property>

15 years, 4 months

1
0
0 / 0

JBoss Tools SVN: r17321 - trunk/jbpm/docs/reference/en.

by jbosstools-commits＠lists.jboss.org

Author: ochikvina Date: 2009-08-27 08:15:48 -0400 (Thu, 27 Aug 2009) New Revision: 17321 Modified: trunk/jbpm/docs/reference/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-810 - new master_output.xml is added; Modified: trunk/jbpm/docs/reference/en/master_output.xml =================================================================== --- trunk/jbpm/docs/reference/en/master_output.xml 2009-08-27 12:07:20 UTC (rev 17320) +++ trunk/jbpm/docs/reference/en/master_output.xml 2009-08-27 12:15:48 UTC (rev 17321) @@ -26,13 +26,13 @@ ]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff"> <bookinfo> <title>jBPM Tools Reference Guide</title> - <corpauthor> - <inlinemediaobject> - <imageobject role="fo"> - <imagedata fileref="images/jbosstools_logo.png" format="PNG"></imagedata> + <corpauthor diffmk:change="added"> + <inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added" role="fo"> + <imagedata diffmk:change="added" fileref="images/jbosstools_logo.png" format="PNG"></imagedata> </imageobject> - <imageobject role="html"> - <imagedata></imagedata> + <imageobject diffmk:change="added" role="html"> + <imagedata diffmk:change="added"></imagedata> </imageobject> </inlinemediaobject> </corpauthor> @@ -180,13 +180,13 @@ <row> <entry> - <link linkend="the_views">A large range of special views, including:</link> + <link diffmk:change="added" linkend="the_views"><diffmk:wrapper diffmk:change="added">A large range of special views, including:</diffmk:wrapper></link> </entry> - <entry></entry> + <entry diffmk:change="added"></entry> </row> - <row> - <entry> + <row diffmk:change="added"> + <entry diffmk:change="added"> <link linkend="source_mode">Support of XML code view</link> </entry> <entry>Shows the corresponding XML that's generated automatically in the Source view @@ -202,14 +202,14 @@ <row> <entry> - <link linkend="jbpm_gpd_editor">The jBPM Graphical Process Designer editor</link> + <link diffmk:change="added" linkend="jbpm_gpd_editor"><diffmk:wrapper diffmk:change="added">The jBPM Graphical Process Designer editor</diffmk:wrapper></link> </entry> - <entry>The plugin is used for designing the workflow.</entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">The plugin is used for designing the workflow.</diffmk:wrapper></entry> </row> - <row> - <entry>Interaction with all of the J2EE based integration technologies including Web Services, + <row diffmk:change="added"> + <entry diffmk:change="added">Interaction with all of the J2EE based integration technologies including Web Services, Java Messaging, J2EE Connectors, JBDC, EJBs.</entry> <entry>Enables implementation, provides better functionality and flexibility.</entry> </row>

15 years, 4 months

1
0
0 / 0

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

jbosstools-commits August 2009