Author: tromanovich Date: 2008-05-26 10:54:15 -0400 (Mon, 26 May 2008) New Revision: 8319 Modified: trunk/as/docs/reference/en/modules/perspective.xml trunk/as/docs/reference/en/modules/runtimes_servers.xml trunk/hibernatetools/docs/reference/en/modules/ant.xml trunk/hibernatetools/docs/reference/en/modules/codegen.xml trunk/hibernatetools/docs/reference/en/modules/codegenarchitecture.xml trunk/hibernatetools/docs/reference/en/modules/plugins.xml trunk/hibernatetools/docs/reference/en/modules/reverseengineering.xml trunk/hibernatetools/docs/reference/en/modules/setup.xml trunk/jbpm/docs/reference/en/modules/jboss_jbpm_runtime_installation.xml trunk/jsf/docs/userguide/en/modules/palette.xml trunk/struts/docs/struts_tools_ref_guide/en/modules/introduction.xml trunk/struts/docs/struts_tools_tutorial/en/modules/coding_files.xml Log: http://jira.jboss.com/jira/browse/JBDS-224 - Special text paragraphs framing Verified and updated <note>, <important>, and <tip> boxes for all guides (titles were added, some titles were changed). Modified: trunk/as/docs/reference/en/modules/perspective.xml =================================================================== --- trunk/as/docs/reference/en/modules/perspective.xml 2008-05-26 14:26:57 UTC (rev 8318) +++ trunk/as/docs/reference/en/modules/perspective.xml 2008-05-26 14:54:15 UTC (rev 8319) @@ -401,6 +401,7 @@ </figure> <note> + <title>Note:</title> <para>You are assumed to be familiar with XPath. If not, we highly suggested that you look through an appropriate manual or tutorial on the topic.</para> </note> @@ -495,11 +496,11 @@ </mediaobject> </figure> - <note> + <tip> <title>Tip:</title> <para>Notice, when you type the fields autocomplete to help you locate exactly what xpath you&apos;re looking for.</para> - </note> + </tip> <para>Then, on the other hand, if your desired field is the text of an element <emphasis>&lt;description&gt;</emphasis>, your <emphasis> Modified: trunk/as/docs/reference/en/modules/runtimes_servers.xml =================================================================== --- trunk/as/docs/reference/en/modules/runtimes_servers.xml 2008-05-26 14:26:57 UTC (rev 8318) +++ trunk/as/docs/reference/en/modules/runtimes_servers.xml 2008-05-26 14:54:15 UTC (rev 8319) @@ -75,7 +75,10 @@ means that scanning for auto-deployment is suspended while files are being copied to the deployment location and resumed when the copy is completed.</para> - <note><para>Currently we recommend you to use a fully supported JBoss 4.2 server adapter.</para></note> + <note> + <title>Note:</title> + <para>Currently we recommend you to use a fully supported JBoss 4.2 server adapter.</para> + </note> <para>You&apos;ll also note a Deploy-Only Runtime type. This type provides no classpath for WTP projects. It is used solely by its server type for the purpose of setting up a Modified: trunk/hibernatetools/docs/reference/en/modules/ant.xml =================================================================== --- trunk/hibernatetools/docs/reference/en/modules/ant.xml 2008-05-26 14:26:57 UTC (rev 8318) +++ trunk/hibernatetools/docs/reference/en/modules/ant.xml 2008-05-26 14:54:15 UTC (rev 8319) @@ -20,6 +20,7 @@ of eclipse.</para> <note> + <title>Note:</title> <para>There might be incompatibilities with respect to the Hibernate3.jar bundled with the tools and your own jar. Thus to avoid any confusion it is recommended to use the hibernate3.jar and hibernate-annotations.jar bundled with the tools when you want to use the @@ -270,6 +271,7 @@ which a set of exporters can be run to generate various output. </para> <note> + <title>Note:</title> <para>Output can be anything, e.g. specific files, statements execution against a database, error reporting or anything else that can be done in java code.</para> </note> @@ -413,7 +415,7 @@ </emphasis> and fileset is used instead. </para> <note> - <title>Tip:</title> + <title>Note:</title> <para> Hibernate will still read any global <emphasis> <property>hibernate.properties</property> </emphasis> available in the classpath, but the specified properties file here will @@ -443,13 +445,13 @@ </emphasis> is used when you want to read the metamodel from EJB3/Hibernate Annotations based POJO's.</para> - <note> - <title>Tip:</title> + <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>&lt;taskdef&gt;</property>, </emphasis> i. e. hibernate-annotations.jar and hibernate-commons-annotations.jar.</para> - </note> + </important> <para>The <emphasis> <property>&lt;annotationconfiguration&gt;</property> @@ -533,6 +535,7 @@ <note> + <title>Note:</title> <para>ejb3configuration was the name used in previous versions. It still works but will emit a warning telling you to use <literal>jpaconfiguration</literal> instead.</para> </note> @@ -996,6 +999,7 @@ <property>hbm.xml</property>. </emphasis></para> <note> + <title>Note:</title> <para>Not every possible mapping transformation is possible/implemented (contributions welcome) so some hand editing might be necessary.</para> </note> @@ -1024,6 +1028,7 @@ </emphasis>.</para> <note> + <title>Note:</title> <para>Not all conversions are implemented (contributions welcome), so some hand editing might be necessary.</para> </note> @@ -1148,7 +1153,7 @@ <property>queryresult.txt</property>. </emphasis></para> <note> - <title>Tip:</title> + <title>Note:</title> <para> Currently the dump is simply a call to toString on each element.</para> </note> @@ -1174,6 +1179,7 @@ />]]></programlisting> <note> + <title>Note:</title> <para>Previous versions of the tools used Velocity. We are now using Freemarker which provides us much better exception and error handling.</para> </note> @@ -1296,7 +1302,7 @@ <property>&lt;property&gt;</property> </emphasis> which will be available to the templates/exporter. </para> <note> - <title>Tip:</title> + <title>Note:</title> <para> This example actually simulates what &lt;hbm2java&gt; actually does.</para> </note> Modified: trunk/hibernatetools/docs/reference/en/modules/codegen.xml =================================================================== --- trunk/hibernatetools/docs/reference/en/modules/codegen.xml 2008-05-26 14:26:57 UTC (rev 8318) +++ trunk/hibernatetools/docs/reference/en/modules/codegen.xml 2008-05-26 14:54:15 UTC (rev 8319) @@ -277,6 +277,7 @@ </emphasis> file will implement <literal>IAuditable</literal>!</para> <note> + <title>Note:</title> <para>This applies to <emphasis>all</emphasis> <literal>&lt;meta&gt;</literal>-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 @@ -530,6 +531,7 @@ </hibernate-mapping>]]></programlisting> <note> + <title>Note:</title> <para>I) To escape the &amp; symbol we put &amp;amp;. You can use &lt;![CDATA[]]&gt; instead.</para> <para>II) Note that we are referring to "firstName" directly and this is the parameter Modified: trunk/hibernatetools/docs/reference/en/modules/codegenarchitecture.xml =================================================================== --- trunk/hibernatetools/docs/reference/en/modules/codegenarchitecture.xml 2008-05-26 14:26:57 UTC (rev 8318) +++ trunk/hibernatetools/docs/reference/en/modules/codegenarchitecture.xml 2008-05-26 14:54:15 UTC (rev 8319) @@ -74,6 +74,7 @@ facilities of <property>Hibernate Tools</property>. </para> <note> + <title>Note:</title> <para>No matter which Hibernate Configuration type you are using <property>Hibernate Tools</property> supports them.</para> </note> Modified: trunk/hibernatetools/docs/reference/en/modules/plugins.xml =================================================================== --- trunk/hibernatetools/docs/reference/en/modules/plugins.xml 2008-05-26 14:26:57 UTC (rev 8318) +++ trunk/hibernatetools/docs/reference/en/modules/plugins.xml 2008-05-26 14:54:15 UTC (rev 8319) @@ -17,6 +17,7 @@ can take advantage of while using the tools within Eclipse.</para> <note> + <title>Note:</title> <para>Please note that these tools do not try to hide any functionality of <property>Hibernate</property>. The tools make working with <property>Hibernate</property> easier, but you are still encouraged/required to read the <ulink @@ -113,6 +114,7 @@ </figure> <note> + <title>Note:</title> <para>The contents in the combo boxes for the JDBC driver class and JDBC URL change automatically, depending on the Dialect and actual driver you have chosen.</para> </note> @@ -153,6 +155,7 @@ </emphasis>.</para> <note> + <title>Note:</title> <para>The wizard will look at the current selection in the IDE and try and auto-detect the settings which you then can just approve or modify to suit your needs.</para> </note> @@ -565,12 +568,12 @@ <property>New_Generation</property> </emphasis> will be used.</para> - <note> + <tip> <title>Tip:</title> <para>The &quot;At least one exporter option must be selected&quot; is just a warning stating that for this launch to work you need to select an exporter on the Exporter tab. When an exporter has been selected the warning will disappear.</para> - </note> + </tip> <para>The dialog also have the standard tabs <emphasis> <property>Refresh</property> @@ -1046,6 +1049,7 @@ <para>For java completion and navigation to work the file needs to reside inside an Eclipse Java project, otherwise no completion will occur.</para> <note> + <title>Note:</title> <para>Java completion does not require a Hibernate console configuration to be used.</para> </note> </section> @@ -1070,6 +1074,7 @@ </figure> <important> + <title>Important:</title> <para>Table/Column completion requires a proper configured hibernate console configuration and this configuration should be the default for the project where the <emphasis> <property>hbm.xml</property> @@ -1083,6 +1088,7 @@ table/column names in the background.</para> <note> + <title>Note:</title> <para>Currently it is not recommended to use this feature on large databases since it does not fetch the information iteratively. It will be improved in future versions.</para> </note> @@ -1165,6 +1171,7 @@ default naming rules are not applicable.</para> <note> + <title>Note:</title> <para> Not all the features of the <emphasis> <property>.reveng.xml </property> </emphasis> file are exposed or fully implemented in the editor, but the main functionality @@ -1520,6 +1527,7 @@ <note> + <title>Note:</title> <para>HQL queries are executed by default using <literal>list()</literal> thus without any limit of the size of the output the query could return a large result set. You might run out of memory. To avoid this you can put a value in the Max results field to reduce the Modified: trunk/hibernatetools/docs/reference/en/modules/reverseengineering.xml =================================================================== --- trunk/hibernatetools/docs/reference/en/modules/reverseengineering.xml 2008-05-26 14:26:57 UTC (rev 8318) +++ trunk/hibernatetools/docs/reference/en/modules/reverseengineering.xml 2008-05-26 14:54:15 UTC (rev 8319) @@ -44,6 +44,7 @@ specialized editor.</para> <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 &lt;table-filter&gt; then check if the case matches; most databases stores table names in uppercase.</para> @@ -121,6 +122,7 @@ </emphasis> is still used to then decide which tables will be included/excluded.</para> <note> + <title>Note:</title> <para>If no <literal>&lt;schema-selection&gt;</literal> 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: @@ -694,10 +696,8 @@ </emphasis> 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 and one-to-many's).</para> - - <para>Note:</para> - - <programlisting role="XML"><![CDATA[<foreign-key + + <para><programlisting role="XML"><![CDATA[<foreign-key constraint-name="foreignKeyName" foreign-catalog="catalogName" foreign-schema="schemaName" @@ -710,8 +710,7 @@ <set property="aCollectionName" exclude="true|false"/> - </foreign-key>]]></programlisting> - + </foreign-key>]]></programlisting></para> <table frame="topbot"> <title>Foreign-key attributes</title> Modified: trunk/hibernatetools/docs/reference/en/modules/setup.xml =================================================================== --- trunk/hibernatetools/docs/reference/en/modules/setup.xml 2008-05-26 14:26:57 UTC (rev 8318) +++ trunk/hibernatetools/docs/reference/en/modules/setup.xml 2008-05-26 14:54:15 UTC (rev 8319) @@ -42,6 +42,7 @@ -clean</property>.</emphasis> Using the updatesite does not require any additional steps.</para> <note> + <title>Note:</title> <para>If you need more basic instructions on installing plugins and general usage of eclipse then check out <ulink url="https://eclipse-tutorial.dev.java.net/" Modified: trunk/jbpm/docs/reference/en/modules/jboss_jbpm_runtime_installation.xml =================================================================== --- trunk/jbpm/docs/reference/en/modules/jboss_jbpm_runtime_installation.xml 2008-05-26 14:26:57 UTC (rev 8318) +++ trunk/jbpm/docs/reference/en/modules/jboss_jbpm_runtime_installation.xml 2008-05-26 14:54:15 UTC (rev 8319) @@ -20,6 +20,7 @@ either when you create a jBPM project or by using the jBPM preference pages.</para> <note> + <title>Note:</title> <para>Try to avoid using spaces in the names of installation folders. It can provoke problems in some situations with Sun-based VMs.</para> </note> Modified: trunk/jsf/docs/userguide/en/modules/palette.xml =================================================================== --- trunk/jsf/docs/userguide/en/modules/palette.xml 2008-05-26 14:26:57 UTC (rev 8318) +++ trunk/jsf/docs/userguide/en/modules/palette.xml 2008-05-26 14:54:15 UTC (rev 8319) @@ -427,7 +427,7 @@ </figure> <tip> - <title>Tipe:</title> + <title>Tip:</title> <para>if you place the cursor over any tag, a balloon hint is shown with all the <emphasis role="italic"> <property>&quot;tag&quot;</property> @@ -570,7 +570,8 @@ <property>RichFaces</property> </emphasis> component framework. RichFaces and Ajax4jsf in JBoss Tools Palette always exist, this palette is not dynamic and is not changed from file to file. JBoss Tools - Palette supports only the last version of the RichFaces components. <tip> + Palette supports only the last version of the RichFaces components. + <tip> <title>Tip:</title> <para>If you&apos;d like to know the last version of RichFaces component framework see <ulink url="http://labs.jboss.com/jbossrichfaces/">JBoss Modified: trunk/struts/docs/struts_tools_ref_guide/en/modules/introduction.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en/modules/introduction.xml 2008-05-26 14:26:57 UTC (rev 8318) +++ trunk/struts/docs/struts_tools_ref_guide/en/modules/introduction.xml 2008-05-26 14:54:15 UTC (rev 8319) @@ -18,6 +18,7 @@ for creating Struts resources that enhances the process of building high-quality web applications.</para> <note> + <title>Note:</title> <para>Note that JBoss Tools support the Struts 1.1, 1.2.x versions.</para> </note> Modified: trunk/struts/docs/struts_tools_tutorial/en/modules/coding_files.xml =================================================================== --- trunk/struts/docs/struts_tools_tutorial/en/modules/coding_files.xml 2008-05-26 14:26:57 UTC (rev 8318) +++ trunk/struts/docs/struts_tools_tutorial/en/modules/coding_files.xml 2008-05-26 14:54:15 UTC (rev 8319) @@ -239,7 +239,8 @@ <property>Struts Form</property> </emphasis> library, select <emphasis> <property>text</property> - </emphasis>, and drag it onto the box <note> + </emphasis>, and drag it onto the box + <note> <title>Note:</title> <para>By default there are only four groups on the JBoss Tools Palette. If you wish to make some group visible click the <emphasis>