Author: smukhina Date: 2007-09-03 10:28:26 -0400 (Mon, 03 Sep 2007) New Revision: 2715 Modified: trunk/docs/userguide/en/src/main/docbook/included/calendar.desc.xml trunk/docs/userguide/en/src/main/docbook/included/dataFilterSlider.desc.xml trunk/docs/userguide/en/src/main/docbook/included/dragSupport.xml trunk/docs/userguide/en/src/main/docbook/included/gmap.desc.xml trunk/docs/userguide/en/src/main/docbook/included/include.xml trunk/docs/userguide/en/src/main/docbook/included/inputNumberSlider.desc.xml trunk/docs/userguide/en/src/main/docbook/included/inputNumberSlider.xml trunk/docs/userguide/en/src/main/docbook/included/inputNumberSpinner.xml trunk/docs/userguide/en/src/main/docbook/included/insert.xml trunk/docs/userguide/en/src/main/docbook/included/loadBundle.xml trunk/docs/userguide/en/src/main/docbook/included/message.xml trunk/docs/userguide/en/src/main/docbook/included/page.xml trunk/docs/userguide/en/src/main/docbook/included/panel.xml trunk/docs/userguide/en/src/main/docbook/included/panelBar.xml trunk/docs/userguide/en/src/main/docbook/included/panelBarItem.xml trunk/docs/userguide/en/src/main/docbook/included/panelMenu.desc.xml trunk/docs/userguide/en/src/main/docbook/included/panelMenu.xml trunk/docs/userguide/en/src/main/docbook/included/panelMenuGroup.xml trunk/docs/userguide/en/src/main/docbook/included/panelMenuItem.xml trunk/docs/userguide/en/src/main/docbook/included/suggestionBox.xml trunk/docs/userguide/en/src/main/docbook/included/support.xml trunk/docs/userguide/en/src/main/docbook/included/togglePanel.xml trunk/docs/userguide/en/src/main/docbook/included/tooltip.xml Log: http://jira.jboss.com/jira/browse/RF-398 Modified: trunk/docs/userguide/en/src/main/docbook/included/calendar.desc.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/calendar.desc.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/calendar.desc.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -9,7 +9,7 @@ <title>Description</title> <para>The <emphasis role="bold"> <property>&lt;rich:calendar&gt;</property> - </emphasis> component is used for creating monthly calendar elements on the page.</para> + </emphasis> component is used for creating monthly calendar elements on a page.</para> <mediaobject> <imageobject> Modified: trunk/docs/userguide/en/src/main/docbook/included/dataFilterSlider.desc.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/dataFilterSlider.desc.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/dataFilterSlider.desc.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -23,7 +23,7 @@ <listitem>Filter any UIData based component in dependency on its child&apos;s values</listitem> <listitem>Fully skinnable control and input elements</listitem> <listitem>Optional value text field with an attribute-managed position</listitem> - <listitem>Optional disablement of the component on the page</listitem> + <listitem>Optional disablement of the component on a page</listitem> <listitem>Optional ToolTip to display the current value while a handle is dragged</listitem> <listitem>Dragged state is stable after the mouse moves</listitem> <listitem>Optional manual input possible if a text input field is present</listitem> Modified: trunk/docs/userguide/en/src/main/docbook/included/dragSupport.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/dragSupport.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/dragSupport.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -187,7 +187,7 @@ <listitem>ondragexit</listitem> </itemizedlist> - <para>Developers can use their own custom JavaScript functions to handle these events.</para> + <para>You can use your own custom JavaScript functions to handle these events.</para> </section> Modified: trunk/docs/userguide/en/src/main/docbook/included/gmap.desc.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/gmap.desc.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/gmap.desc.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -22,7 +22,7 @@ <itemizedlist> <listitem>Presents all the Google <property>map</property> functionality</listitem> <listitem>Highly customizable via attributes</listitem> - <listitem>No developers JavaScript writing needed to use on the pages</listitem> + <listitem>No developers JavaScript writing needed to use on a pages</listitem> </itemizedlist> </section> </section> Modified: trunk/docs/userguide/en/src/main/docbook/included/include.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/include.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/include.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -43,7 +43,7 @@ </h:panelGroup> ]]></programlisting> <para>For navigation inside a page defined in viewId any components responsible for Ajax requests to the server generation are used.</para> -<para>For example, the following component on the page &quot;/pages/include/first.xhtml&quot;</para> +<para>For example, the following component on a page &quot;/pages/include/first.xhtml&quot;</para> <para> <emphasis role="bold">Example:</emphasis> Modified: trunk/docs/userguide/en/src/main/docbook/included/inputNumberSlider.desc.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/inputNumberSlider.desc.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/inputNumberSlider.desc.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -25,7 +25,7 @@ <itemizedlist> <listitem>Fully skinnable control and input elements</listitem> <listitem>Optional value text field with an attribute-managed position</listitem> - <listitem>Optional disablement of the component on the page</listitem> + <listitem>Optional disablement of the component on a page</listitem> <listitem>Optional ToolTip to display the current value while a handle is dragged</listitem> <listitem>Dragged state is stable after the mouse moves</listitem> <listitem>Optional manual input possible if a text input field is present</listitem> Modified: trunk/docs/userguide/en/src/main/docbook/included/inputNumberSlider.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/inputNumberSlider.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/inputNumberSlider.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -245,7 +245,7 @@ <para> <emphasis role="bold">Example:</emphasis> </para> - <para>CSS code piece used on the page:</para> + <para>CSS code piece used on a page:</para> <para> <emphasis role="bold">Example:</emphasis> Modified: trunk/docs/userguide/en/src/main/docbook/included/inputNumberSpinner.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/inputNumberSpinner.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/inputNumberSpinner.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -244,7 +244,7 @@ <para> <emphasis role="bold">Example:</emphasis> </para> - <para>CSS code piece used on the page:</para> + <para>CSS code piece used on a page:</para> <para> <emphasis role="bold">Example:</emphasis> Modified: trunk/docs/userguide/en/src/main/docbook/included/insert.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/insert.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/insert.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -55,7 +55,7 @@ <section> <title>Creating the Component with a Page Tag</title> - <para>To create the simplest variant on the page use the following syntax:</para> + <para>To create the simplest variant on a page use the following syntax:</para> <para> Modified: trunk/docs/userguide/en/src/main/docbook/included/loadBundle.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/loadBundle.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/loadBundle.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -68,7 +68,7 @@ </emphasis> are unavailable. Instead of <emphasis role="bold"><property>&lt;f:loadBundle&gt;</property> - </emphasis> that might be located anywhere on the page, the + </emphasis> that might be located anywhere on a page, the <emphasis role="bold"><property>&lt;a4j:loadBundle&gt;</property> </emphasis> should be declared inside the Modified: trunk/docs/userguide/en/src/main/docbook/included/message.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/message.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/message.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -129,7 +129,7 @@ <para>To redefine appearance of all <emphasis role="bold"> <property>&lt;rich:message&gt;</property> </emphasis> components, you may define the properties of the predefined style classes in the - common CSS style sheet used on the page (there are no skin parameters and predefined values + common CSS style sheet used on a page (there are no skin parameters and predefined values by default to make it compatible with the standard message component). </para> </section> Modified: trunk/docs/userguide/en/src/main/docbook/included/page.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/page.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/page.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -79,7 +79,7 @@ <property>RENDER_RESPONSE</property> </emphasis>&quot; phase, thus Ajax can&apos;t get control and make a response also. To avoid this problem it was necessary to use <emphasis role="bold"> <property>&lt;a4j:page&gt;</property> - </emphasis> on the page round the Ajax updatable area. In the last versions of both frameworks the problem is successfully fixed and no <emphasis role="bold"><property>&lt;a4j:page&gt;</property></emphasis> usage is required.</para> + </emphasis> on a page round the Ajax updatable area. In the last versions of both frameworks the problem is successfully fixed and no <emphasis role="bold"><property>&lt;a4j:page&gt;</property></emphasis> usage is required.</para> <para>The component is rendered as a full HTML page template (it was shown in the example). The &quot;<emphasis > <property>head</property> </emphasis>&quot; section is defined with the help of the corresponding facet with the name=&quot;head&quot; and also there is an attribute with the same name for contentType definition.</para> Modified: trunk/docs/userguide/en/src/main/docbook/included/panel.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/panel.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/panel.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -303,7 +303,7 @@ <para> <emphasis role="bold">Example:</emphasis> </para> - <para>CSS code piece used on the page:</para> + <para>CSS code piece used on a page:</para> <para> <emphasis role="bold">Example:</emphasis> Modified: trunk/docs/userguide/en/src/main/docbook/included/panelBar.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/panelBar.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/panelBar.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -166,7 +166,7 @@ </tbody> </tgroup> </table> - <para>CSS code piece used on the page:</para> + <para>CSS code piece used on a page:</para> <para> <emphasis role="bold">Example:</emphasis> Modified: trunk/docs/userguide/en/src/main/docbook/included/panelBarItem.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/panelBarItem.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/panelBarItem.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -217,7 +217,7 @@ <para> <emphasis role="bold">Example:</emphasis> </para> - <para>CSS code piece used on the page:</para> + <para>CSS code piece used on a page:</para> <para> <emphasis role="bold">Example:</emphasis> Modified: trunk/docs/userguide/en/src/main/docbook/included/panelMenu.desc.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/panelMenu.desc.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/panelMenu.desc.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -9,7 +9,7 @@ <title>Description</title> <para>The <emphasis role="bold"> <property>&lt;rich:panelMenu&gt;</property> - </emphasis> component is used to define an inline vertical menu on the page.</para> + </emphasis> component is used to define an inline vertical menu on a page.</para> <mediaobject> <imageobject> Modified: trunk/docs/userguide/en/src/main/docbook/included/panelMenu.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/panelMenu.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/panelMenu.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -55,7 +55,7 @@ <section> <title>Creating the Component with a Page Tag</title> - <para>To create the simplest variant on the page use the following syntax:</para> + <para>To create the simplest variant on a page use the following syntax:</para> <para> Modified: trunk/docs/userguide/en/src/main/docbook/included/panelMenuGroup.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/panelMenuGroup.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/panelMenuGroup.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -55,7 +55,7 @@ <section> <title>Creating the Component with a Page Tag</title> - <para>To create the simplest variant on the page use the following syntax:</para> + <para>To create the simplest variant on a page use the following syntax:</para> <para> Modified: trunk/docs/userguide/en/src/main/docbook/included/panelMenuItem.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/panelMenuItem.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/panelMenuItem.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -55,7 +55,7 @@ <section> <title>Creating the Component with a Page Tag</title> - <para>To create the simplest variant on the page use the following syntax:</para> + <para>To create the simplest variant on a page use the following syntax:</para> <para> Modified: trunk/docs/userguide/en/src/main/docbook/included/suggestionBox.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/suggestionBox.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/suggestionBox.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -133,7 +133,7 @@ </rich:suggestionbox> ... ]]></programlisting> - <para>It looks on the page in the following way:</para> + <para>It looks on a page in the following way:</para> <figure> <title>SuggestionBox with tooltip window</title> <mediaobject> @@ -222,7 +222,7 @@ ]]></programlisting> - <para>It looks on the page in the following way:</para> + <para>It looks on a page in the following way:</para> <figure> <title>SuggestionBox with empty list</title> Modified: trunk/docs/userguide/en/src/main/docbook/included/support.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/support.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/support.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -66,7 +66,7 @@ <a4j:support event="onkeyup" reRender="repeater"/> </h:inputText> ]]></programlisting> -<para>Is decoded on the page as:</para> +<para>Is decoded on a page as:</para> <para> <emphasis role="bold">Example:</emphasis> Modified: trunk/docs/userguide/en/src/main/docbook/included/togglePanel.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/togglePanel.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/togglePanel.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -60,7 +60,7 @@ ... </rich:togglePanel> ... - <!--//Set of the toggleControls somewhere on the page.--> + <!--//Set of the toggleControls somewhere on a page.--> ... ]]></programlisting> </section> Modified: trunk/docs/userguide/en/src/main/docbook/included/tooltip.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/tooltip.xml 2007-09-03 14:12:29 UTC (rev 2714) +++ trunk/docs/userguide/en/src/main/docbook/included/tooltip.xml 2007-09-03 14:28:26 UTC (rev 2715) @@ -72,13 +72,13 @@ <title>Details of Usage</title> <para> <property>Tooltip</property> main area is a simple rectangle area with any information inside. The content may be defined via -&quot;value&quot; attribute as text or through any nested content. In case if both defined - value displayed as text and nested content +&quot;value&quot; attribute as text or via any nested content. When both are defined, the value is displayed as text and nested content after the text. <property>Tooltip</property> stretches if the content more than the <property>tooltip</property> sizes. </para> <para> -There is possibility to define a facet with name &quot;defaultContent&quot;. This facet provides default content to be -displayed while main content loaded to the page in Ajax mode. Thus after <property>tooltip</property> called in Ajax mode - it -appeared with the content defined in the facet and after loading complete content changes to loaded one. +There is possibility to define a facet with the name &quot;defaultContent&quot;. This facet provides the default content to +display while the main content is loaded to a page in an Ajax mode. Thus when <property>tooltip</property> called in an Ajax mode, it +appears with the content defined in the facet and when loading is completed, the content is changed to a loaded one. </para> <para> Here is an example: @@ -121,45 +121,44 @@ </mediaobject> </figure> <para> -By default, <property>tooltip</property> appears smart positioned. But as you can see from the previous example - developer -can define appearance direction through the corresponding attribute &quot;direction&quot;. And also it's possible to define vertical and horizontal -offsets relatively to mouse position. +By default, <property>tooltip</property> appears smart positioned. But as you can see from the previous example, you +can define an appearance direction via the corresponding attribute &quot;direction&quot;. And also it's possible to define vertical and horizontal +offsets relatively to a mouse position. </para> <para> -<property>Tooltip</property> appears attached to the corner dependent on <emphasis><property>&quot;direction&quot;</property></emphasis> attribute. By default it is positioned bottom-right. -<property>Tooltip</property> activation occurs after defined event (default=mouseover) on the parent component taking into consideration -&quot;delay&quot; attribute (default=0) or after calling JS API function doShow(). <property>Tooltip</property> deactivation occurs after mouseout event -on the parent component (except mouse hovered the <property>tooltip</property> itself) or after calling JS API function doHide(). +<property>Tooltip</property> appears attached to the corner dependent on the <emphasis><property>&quot;direction&quot;</property></emphasis> attribute. By default it is positioned bottom-right. +<property>Tooltip</property> activation occurs after a defined event (default=mouseover) on the parent component takes into consideration +the &quot;delay&quot; attribute (default=0) or after calling JS API function doShow(). <property>Tooltip</property> deactivation occurs after mouseout event on the parent component (excepting the situation when the mouse is hovered onto the <property>tooltip</property> itself) or after calling JS API function doHide(). </para> <note> <title>Note:</title> -It is recommended to define parent component "id" for correct <property>tooltip</property> work. +It is recommended to define parent component "id" for correction of <property>tooltip</property> work. </note> <para> -The <emphasis><property>&quot;mode&quot;</property></emphasis> attribute is provided to developer to control the way of data loading to <property>tooltip</property> and has following values: +The <emphasis><property>&quot;mode&quot;</property></emphasis> attribute is provided you to control the way of data loading to <property>tooltip</property>. It has following values: <itemizedlist> <listitem>Client</listitem> <listitem>Ajax</listitem> </itemizedlist> </para> <para> -In client mode <property>tooltip</property> content is rendered once on server and could be reRendered only through external submit. -In Ajax mode <property>tooltip</property> content will be requested from server every activation. +In a client mode, <property>tooltip</property> content is rendered once on the server and could be reRendered only via external submit. +In an Ajax mode, <property>tooltip</property> content is requested from server every activation. </para> <para> -Special JS API is provided to control of component behaviour: +Special JS API is provided to control the component behaviour: <itemizedlist> - <listitem>doShow() - Show corresponding tooltip</listitem> - <listitem>doHide() - Hide corresponding tooltip</listitem> - <listitem>doEnable() - Enable corresponding tooltip</listitem> - <listitem>doDisable() - Disable corresponding tooltip</listitem> + <listitem>doShow() - Shows the corresponding tooltip</listitem> + <listitem>doHide() - Hides the corresponding tooltip</listitem> + <listitem>doEnable() - Enables the corresponding tooltip</listitem> + <listitem>doDisable() - Disables the corresponding tooltip</listitem> </itemizedlist> </para> <para> -Disabled <property>tooltip</property> will be rendered to the page as usual but JS that responds for its activation will be -disabled until doEnable() will called. +Disabled <property>tooltip</property> is rendered to a page as usual but JS that responds for its activation is +disabled until doEnable() is called. </para> <para> Moreover, to add some JavaScript effects, client events defined on it are used: @@ -177,11 +176,11 @@ <para> Special: <itemizedlist> - <listitem>onshow - Called after the tooltip called (some element overed) but before its requesting + <listitem>onshow - Called after the tooltip is called (some element hovered) but before its request </listitem> - <listitem>oncomplete - Called just after the tooltip shown + <listitem>oncomplete - Called just after the tooltip is shown </listitem> - <listitem>onhide - Called after the tooltip hidden + <listitem>onhide - Called after the tooltip is hidden </listitem> </itemizedlist> </para> @@ -189,13 +188,13 @@ <section> <title>Look-and-Feel Customization</title> - <para>For skinnability implementation the components use a <emphasis><property>style class redefinition method</property></emphasis>. + <para>For skinnability implementation the components, use a <emphasis><property>style class redefinition method</property></emphasis>. </para> <para>Default style classes are mapped on <emphasis><property>skin parameters</property>.</emphasis></para> <para>To redefine appearance of all <property>tooltip</property> at once, there are two ways:</para> <itemizedlist> - <listitem>to redefine corresponding skin parameters</listitem> + <listitem>to redefine the corresponding skin parameters</listitem> <listitem>to add to your style sheets style classes used by a <property>tooltip</property></listitem> </itemizedlist> @@ -240,10 +239,10 @@ <section> <title>Definition custom style classes</title> <para> - <property>Tooltip</property> provides one class &quot;rich-tool-tip&quot; which applies to wrapper element <emphasis><property>&quot;span&quot;</property></emphasis> or &quot;div&quot; + <property>Tooltip</property> provides one class &quot;rich-tool-tip&quot; which applies to a wrapper element <emphasis><property>&quot;span&quot;</property></emphasis> or &quot;div&quot; dependently to <property>tooltip</property> layout. In order to redefine style for all <property>tooltips</property> - on the page with using CSS it's enough to create classes with this name and define in it necessary properties. - To change style peculiarities of the particular <property>tooltips</property>, define your own style classes in the corresponding + on a page with using CSS it's enough to create classes with this name and define in it necessary properties. + To change style peculiarities of a particular <property>tooltips</property>, define your own style classes in the corresponding <property>tooltips</property> attributes. </para> </section>