Author: vsukhov Date: 2008-02-07 13:36:49 -0500 (Thu, 07 Feb 2008) New Revision: 5926 Added: trunk/docs/userguide/en/src/main/resources/images/orderinListClass.png trunk/docs/userguide/en/src/main/resources/images/orderinListStyle.png Modified: trunk/docs/userguide/en/src/main/docbook/included/actionparam.xml trunk/docs/userguide/en/src/main/docbook/included/ajaxListener.xml trunk/docs/userguide/en/src/main/docbook/included/calendar.xml trunk/docs/userguide/en/src/main/docbook/included/changeExpandListener.xml trunk/docs/userguide/en/src/main/docbook/included/comboBox.xml trunk/docs/userguide/en/src/main/docbook/included/commandButton.xml trunk/docs/userguide/en/src/main/docbook/included/commandLink.xml trunk/docs/userguide/en/src/main/docbook/included/componentControl.xml trunk/docs/userguide/en/src/main/docbook/included/contextMenu.xml trunk/docs/userguide/en/src/main/docbook/included/dataGrid.xml trunk/docs/userguide/en/src/main/docbook/included/dataList.xml trunk/docs/userguide/en/src/main/docbook/included/datascroller.xml trunk/docs/userguide/en/src/main/docbook/included/dragIndicator.xml trunk/docs/userguide/en/src/main/docbook/included/dragListener.desc.xml trunk/docs/userguide/en/src/main/docbook/included/dragListener.xml trunk/docs/userguide/en/src/main/docbook/included/draggable.xml trunk/docs/userguide/en/src/main/docbook/included/dropListener.desc.xml trunk/docs/userguide/en/src/main/docbook/included/dropListener.xml trunk/docs/userguide/en/src/main/docbook/included/effect.xml trunk/docs/userguide/en/src/main/docbook/included/form.xml trunk/docs/userguide/en/src/main/docbook/included/gmap.xml trunk/docs/userguide/en/src/main/docbook/included/htmlCommandLink.xml trunk/docs/userguide/en/src/main/docbook/included/insert.xml trunk/docs/userguide/en/src/main/docbook/included/jQuery.xml trunk/docs/userguide/en/src/main/docbook/included/jsFunction.xml trunk/docs/userguide/en/src/main/docbook/included/keepAlive.xml trunk/docs/userguide/en/src/main/docbook/included/listShuttle.xml trunk/docs/userguide/en/src/main/docbook/included/loadBundle.xml trunk/docs/userguide/en/src/main/docbook/included/loadScript.desc.xml trunk/docs/userguide/en/src/main/docbook/included/loadScript.xml trunk/docs/userguide/en/src/main/docbook/included/loadStyle.desc.xml trunk/docs/userguide/en/src/main/docbook/included/loadStyle.xml trunk/docs/userguide/en/src/main/docbook/included/log.xml trunk/docs/userguide/en/src/main/docbook/included/mediaOutput.xml trunk/docs/userguide/en/src/main/docbook/included/message.xml trunk/docs/userguide/en/src/main/docbook/included/messages.xml trunk/docs/userguide/en/src/main/docbook/included/modalPanel.xml trunk/docs/userguide/en/src/main/docbook/included/nodeSelectListener.desc.xml trunk/docs/userguide/en/src/main/docbook/included/nodeSelectListener.xml trunk/docs/userguide/en/src/main/docbook/included/orderingList.xml trunk/docs/userguide/en/src/main/docbook/included/outputPanel.xml trunk/docs/userguide/en/src/main/docbook/included/page.xml trunk/docs/userguide/en/src/main/docbook/included/panelMenu.xml trunk/docs/userguide/en/src/main/docbook/included/portlet.xml trunk/docs/userguide/en/src/main/docbook/included/push.desc.xml trunk/docs/userguide/en/src/main/docbook/included/push.xml trunk/docs/userguide/en/src/main/docbook/included/region.xml trunk/docs/userguide/en/src/main/docbook/included/repeat.xml trunk/docs/userguide/en/src/main/docbook/included/scrollableDataTable.xml trunk/docs/userguide/en/src/main/docbook/included/separator.xml trunk/docs/userguide/en/src/main/docbook/included/simpleTogglePanel.xml trunk/docs/userguide/en/src/main/docbook/included/status.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/toolBar.xml trunk/docs/userguide/en/src/main/docbook/included/toolTip.xml trunk/docs/userguide/en/src/main/docbook/master.xml trunk/docs/userguide/en/src/main/resources/images/mpClass.png trunk/docs/userguide/en/src/main/resources/images/togglePanelClass.png trunk/docs/userguide/en/src/main/resources/images/togglePanelStyle.png trunk/docs/userguide/en/src/main/resources/images/toolBarClass.png trunk/docs/userguide/en/src/main/resources/images/toolBarStyle.png trunk/docs/userguide/pom.xml Log: RF-2167 Relevant resource- valueChangeListener--done links. RF-2059 Done links in guide to framework. RF-2086 Errors in components section--put right. RF-904 Added documentation for comboBox component Modified: trunk/docs/userguide/en/src/main/docbook/included/actionparam.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/actionparam.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/actionparam.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -62,7 +62,7 @@ <para><emphasis role="bold"> <property>&lt;a4j:actionParam&gt;</property> </emphasis>has a <emphasis><property>&quot;noEscape&quot;</property></emphasis> attribute. If it is set to - <property>&quot;true&quot;</property>, the <emphasis><property>&quot;value&quot;</property></emphasis> evaluates as a JavaScript code. </para> + <property>&quot;true&quot;</property>, the <emphasis><property>&quot;value&quot;</property></emphasis> is evaluated as a JavaScript code. </para> <emphasis role="bold">Example:</emphasis> <programlisting role="XML"><![CDATA[... <script> Modified: trunk/docs/userguide/en/src/main/docbook/included/ajaxListener.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/ajaxListener.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/ajaxListener.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -76,7 +76,7 @@ Ajax Listener is not invoked for non-Ajax request and when RichFaces works in "Ajax Request generates Non-Ajax Response" mode. Therefore, ajax Listener invocation is a good indicator that Ajax response is going to be processed. Attribute <emphasis><property>&quot;type&quot;</property></emphasis> described in the following <link linkend="ajaxListener"> chapter</link>. It defines the fully qualified Java class name for listener.This class implements org.ajax4jsf.framework.ajax.ajaxListener -interface. You can access to the source of the event (Ajax component) using event.getSource() call. + <ulink url="http://labs.jboss.com/file-access/default/members/jbossrichface...;. You can access to the source of the event (Ajax component) using event.getSource() call. </para> </section> @@ -114,7 +114,9 @@ <title>Relevant resources links</title> <para> Some additional information about usage of component can be found - <ulink url="http://livedemo.exadel.com/richfaces-demo/richfaces/ajaxListene...;. + <ulink url="http://livedemo.exadel.com/richfaces-demo/richfaces/ajaxListene... + <para> + More information about <emphasis role="bold"><property>&lt;f:valueChangeListener&gt;</property></emphasis> can be found <ulink url=" http://java.sun.com/javaee/javaserverfaces/1.1_01/docs/tlddocs/f/valueCha...;. </para> </section> Modified: trunk/docs/userguide/en/src/main/docbook/included/calendar.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/calendar.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/calendar.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -408,7 +408,8 @@ <property>RICH_CALENDAR_CLEAN_LABEL</property>, <property>RICH_CALENDAR_CANCEL_LABEL </property> there. </para> - <para>You could also pack <property>org.richfaces.renderkit.calendar</property> resource bundle with your JARs defining the same properties.</para> + <para>You could also pack <property>org.richfaces.renderkit.calendar</property> <ulink url="http://labs.jboss.com/file-access/default/members/jbossrichface... + >resource</ulink> bundle with your JARs defining the same properties.</para> </section> <section> Modified: trunk/docs/userguide/en/src/main/docbook/included/changeExpandListener.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/changeExpandListener.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/changeExpandListener.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -72,7 +72,7 @@ </para> <para> Attribute <emphasis><property>&quot;type&quot;</property></emphasis> defines the fully qualified Java class name for the listener. -This class should implement org.richfaces.event.NodeExpandedListener interface. + This class should implement org.richfaces.event.NodeExpandedListener <ulink url="http://labs.jboss.com/file-access/default/members/jbossrichface...;. </para> <para> Modified: trunk/docs/userguide/en/src/main/docbook/included/comboBox.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/comboBox.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/comboBox.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -79,24 +79,28 @@ </itemizedlist> </para> <para> - There are two ways to get values for the popup list of suggestions: + There are two ways to get values for the popup list of suggestions:</para> <itemizedlist> - <listitem>Using the <emphasis><property>&quot;suggestionValues&quot;</property></emphasis> attribute, that defines the suggestion collection - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"> -<![CDATA[... + <listitem> + Using the <emphasis><property>&quot;suggestionValues&quot;</property></emphasis> attribute, that defines the suggestion collection + </listitem> + </itemizedlist> + <para> + <emphasis role="bold">Example:</emphasis> + </para> +<programlisting role="XML"><![CDATA[... <rich:comboBox value="#{bean.state}" valueChangeListener="#{bean.selectionChanged}" suggestionValues="#{bean.suggestions}" /> -...]]></programlisting> - </listitem> - <listitem>Using the <emphasis role="bold"><property>&lt;f:selectItem /&gt;</property></emphasis> or <emphasis role="bold"> +...]]></programlisting> + <itemizedlist> + <listitem> + Using the <emphasis role="bold"><property>&lt;f:selectItem /&gt;</property></emphasis> or <emphasis role="bold"> <property>&lt;f:selectItems /&gt;</property></emphasis> components - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"> -<![CDATA[... + </listitem> + </itemizedlist> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <rich:comboBox value="#{bean.state}" valueChangeListener="#{bean.selectionChanged}"> <f:selectItems value="#{bean.selectItems}"/> <f:selectItem itemValue="Oregon"/> @@ -105,9 +109,7 @@ <f:selectItem itemValue="South Carolina"/> </rich:comboBox> ...]]></programlisting> - </listitem> - </itemizedlist> - Popup list content loads at page render time. No additional requests could be performed on the popup calling. + <para> Popup list content loads at page render time. No additional requests could be performed on the popup calling. </para> <para> The <emphasis><property> &quot;value&quot;</property></emphasis> attribute stores value from input after submit. @@ -173,11 +175,11 @@ <entry></entry> </row> <row> - <entry>Enable()</entry> + <entry>enable()</entry> <entry></entry> </row> <row> - <entry>Disable()</entry> + <entry>disable()</entry> <entry></entry> </row>` </tbody> @@ -232,14 +234,14 @@ <para>On the screenshot there are classes names that define styles for component elements.</para> - <figure> + <!--figure> <title>Classes names</title> <mediaobject> <imageobject> <imagedata fileref=""/> </imageobject> </mediaobject> - </figure> + </figure--> <table> <title>Classes names that define </title> Modified: trunk/docs/userguide/en/src/main/docbook/included/commandButton.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/commandButton.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/commandButton.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -53,11 +53,11 @@ <section> <title>Key attributes and ways of usage</title> <para><emphasis role="bold"><property>&lt;a4j:commandButton&gt;</property></emphasis> is used in the same way as <emphasis role="bold"><property>&lt;h:commandButton&gt;</property></emphasis>, but with definition of the area that is updated after the response comes back from the server.</para> - <para>This definition of the component provides a link, a click on the link causes an Ajax form submit on the server, <property>&quot;action1&quot;</property> method performance, and rendering of the component with <property>&quot;someData&quot;</property> id after the response comes back from the server.</para> + <para>This definition of the component provides a link, a click on the link causes an Ajax form submit on the server, <property>action1</property> method performance, and rendering of the component with <property>someData</property> id after the response comes back from the server.</para> <para>The component <emphasis role="bold"><property>&lt;a4j:commandButton&gt;</property></emphasis> placed on a page generates the following HTML code:</para> <programlisting role="JAVA"><![CDATA[<input type="submit" onclick="A4J.AJAX.Submit(...request parameters);return false;" value="sort"/> ]]></programlisting> - <para>Hence, the utility method <property>&quot;A4J.AJAX.Submit&quot;</property> is called on a click, the method performs Ajax request as the <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> component</para> + <para>Hence, the utility method <property>A4J.AJAX.Submit</property> is called on a click, the method performs Ajax request as the <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> component</para> <note> <title>Note:</title> <para>AJAX support is built in and it&apos;s not necessary to add nested <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> to the component.</para> Modified: trunk/docs/userguide/en/src/main/docbook/included/commandLink.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/commandLink.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/commandLink.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -55,8 +55,8 @@ <title>Key attributes and ways of usage</title> <para><emphasis role="bold"><property>&lt;a4j:commandLink&gt;</property></emphasis> is used in the same way as <emphasis role="bold"><property>&lt;h:commandLink&gt;</property></emphasis>, but with definition of the area that is updated after the response comes back from the server.</para> <para>This definition of the component provides a link, and a click on the link causes an Ajax form - submit on the server, <property>&quot;action1&quot;</property> method performance, and rendering of the component - with <property>&quot;someData&quot;</property> id after the response comes back from the server.</para> + submit on the server, <property>action1</property> method performance, and rendering of the component + with <property>someData</property> id after the response comes back from the server.</para> <para>The component <emphasis role="bold"><property>&lt;a4j:commandLink&gt;</property></emphasis> placed on a page generates the following HTML code:</para> <programlisting role="XML"><![CDATA[<a href="#" onclick="A4J.AJAX.Submit(?"request parameters"); return @@ -65,13 +65,13 @@ <span style="color: black;">Link Value</span> </a> ]]></programlisting> - <para>Hence, the utility method &quot;A4J.AJAX.Submit&quot; is called on a click, the method performs Ajax request as the <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> component</para> + <para>Hence, the utility method <property>A4J.AJAX.Submit</property> is called on a click, the method performs Ajax request as the <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> component</para> <note> <title>Note:</title> <para>AJAX support is built in and it&apos;s not necessary to add nested <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> to the component.</para> </note> <para>Common JSF navigation could be performed after Ajax submit and partial rendering, but Navigation Case must be defined as <emphasis role="bold"><property>&lt;redirect/&gt;</property></emphasis> in order to avoid problems with some browsers.</para> - <para>As any Core Ajax component sending Ajax requests and processing server responses <emphasis role="bold"><property>&lt;a4j:commandLink&gt;</property></emphasis> has all attributes described above (see <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> chapter) that provide the required behavior of requests sending (delay, limitation of submit area and rendering, etc.)</para> + <para>As any Core Ajax component sending Ajax requests and processing server responses <emphasis role="bold"><property>&lt;a4j:commandLink&gt;</property></emphasis> has all attributes described above (see <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> <link linkend="support">chapter</link>) that provide the required behavior of requests sending (delay, limitation of submit area and rendering, etc.)</para> </section> <section> Modified: trunk/docs/userguide/en/src/main/docbook/included/componentControl.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/componentControl.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/componentControl.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -212,7 +212,10 @@ url="http://livedemo.exadel.com/richfaces-demo/richfaces/componentCo... <property>&lt;rich:componentControl&gt;</property> - </emphasis> usage and sources for the given example. </para> + </emphasis> usage and sources for the given example. </para> + <para> + <ulink url="http://java.sun.com/javaee/javaserverfaces/1.1_01/docs/tlddocs/... you can found some additional information about <emphasis role="bold"><property>&lt;f:param&gt;</property></emphasis> component. + </para> </section> </section> Modified: trunk/docs/userguide/en/src/main/docbook/included/contextMenu.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/contextMenu.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/contextMenu.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -552,7 +552,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-menu-item{ -font-style:italic; + font-style:italic; } ...]]></programlisting> @@ -578,7 +578,7 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ - font-weight:bold; + font-weight:bold; } ...]]></programlisting> <para>The <emphasis><property>&quot;rowClasses&quot;</property></emphasis> attribute for <emphasis role="bold" Modified: trunk/docs/userguide/en/src/main/docbook/included/dataGrid.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/dataGrid.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/dataGrid.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -226,7 +226,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-table-footercell{ -color:#ff7800; + color:#ff7800; } ...]]></programlisting> @@ -252,7 +252,7 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ -font-style:italic; + font-style:italic; } ...]]></programlisting> <para>The <emphasis><property>&quot;columnClasses&quot;</property></emphasis> attribute for <emphasis role="bold" Modified: trunk/docs/userguide/en/src/main/docbook/included/dataList.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/dataList.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/dataList.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -234,7 +234,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-list-item{ -font-style:italic; + font-style:italic; } ...]]></programlisting> @@ -260,7 +260,7 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ -background-color:#ffead9; + background-color:#ffead9; } ...]]></programlisting> <para>The <emphasis><property>&quot;styleClass&quot;</property></emphasis> attribute for <emphasis role="bold" Modified: trunk/docs/userguide/en/src/main/docbook/included/datascroller.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/datascroller.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/datascroller.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -164,8 +164,7 @@ </emphasis> and <emphasis> <property>&quot;pagesVar&quot;</property> </emphasis> attributes provide an ability to show the current page and the number of pages in - the datascroller. These attributes are used for definition the names of variables, that will - be used in the facet with name<emphasis> + the datascroller. These attributes are used for definition the names of variables, that is used in the facet with name<emphasis> <property>&quot;pages&quot;.</property> </emphasis> An example can be found below: </para> <para> Modified: trunk/docs/userguide/en/src/main/docbook/included/dragIndicator.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/dragIndicator.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/dragIndicator.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -79,7 +79,7 @@ <section> <title>Details of Usage</title> <para> In the simplest way the component could be defined empty - in that case a default - indicator will be shown like this: </para> + indicator is shown like this: </para> <figure> <title>Simplest <emphasis role="bold"><property>&lt;rich:dragIndicator&gt;</property></emphasis> </title> <mediaobject> @@ -161,13 +161,13 @@ <itemizedlist> <listitem>reject</listitem> </itemizedlist> - <para>Parameter will be set instead of {marker} into indicator when a draggable element is + <para>Parameter is set instead of {marker} into indicator when a draggable element is positioned over drop zone that doesn&apos;t accept this type of elements </para> <itemizedlist> <listitem>default</listitem> </itemizedlist> - <para>Parameter will be set instead of {marker} into indicator when a draggable element is + <para>Parameter is set instead of {marker} into indicator when a draggable element is positioned over all the rest of page elements</para> </section> Modified: trunk/docs/userguide/en/src/main/docbook/included/dragListener.desc.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/dragListener.desc.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/dragListener.desc.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -9,7 +9,7 @@ <section> <title>Description</title> <para>The <emphasis role="bold"><property>&lt;rich:dragListener&gt;</property></emphasis> - represents an action listener method that will be notified after a drag operation. + represents an action listener method that is notified after a drag operation. </para> </section> Modified: trunk/docs/userguide/en/src/main/docbook/included/dragListener.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/dragListener.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/dragListener.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -73,7 +73,7 @@ </para> <para> Attribute <emphasis><property>&quot;type&quot;</property></emphasis> defines the fully qualified Java class name for a listener. -This class should implement org.richfaces.event.DragListener interface. + This class should implement org.richfaces.event.DragListener <ulink url="http://labs.jboss.com/file-access/default/members/jbossrichface...;. </para> <para> Modified: trunk/docs/userguide/en/src/main/docbook/included/draggable.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/draggable.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/draggable.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -94,7 +94,7 @@ <emphasis role="bold"><property>&lt;rich:dragIndicator&gt;</property></emphasis> component id is defined for this drag area. If it isn&apos;t defined drag area creates a default indicator for drag operation. Additional information on <emphasis role="bold"> <property>&lt;rich:dragIndicator&gt;</property> - </emphasis>and its usage with a drag, could be found on the following chapter<ulink url="ch06s04.html"> + </emphasis>and its usage with a drag, could be found on the following chapter <ulink url="ch06s04.html"> dragIndicator</ulink>.</para> <para>Thus, it&apos;s necessary only to define the following:</para> <para><emphasis role="bold">Example:</emphasis></para> Modified: trunk/docs/userguide/en/src/main/docbook/included/dropListener.desc.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/dropListener.desc.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/dropListener.desc.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -9,7 +9,7 @@ <section> <title>Description</title> <para>The <emphasis role="bold"><property>&lt;rich:dropListener&gt;</property></emphasis> - represents an action listener method that will be notified after a drop operation. + represents an action listener method that is notified after a drop operation. </para> </section> Modified: trunk/docs/userguide/en/src/main/docbook/included/dropListener.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/dropListener.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/dropListener.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -73,7 +73,7 @@ </para> <para> Attribute <emphasis><property>&quot;type&quot;</property></emphasis> defines the fully qualified Java class name for the listener. -This class should implement org.richfaces.event.DropListener interface. + This class should implement org.richfaces.event.DropListener <ulink url="http://labs.jboss.com/file-access/default/members/jbossrichface...;. </para> <para> Modified: trunk/docs/userguide/en/src/main/docbook/included/effect.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/effect.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/effect.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -144,7 +144,7 @@ <para> <emphasis> <property>&quot;for&quot;</property> - </emphasis> attribute defines the id of the component or html tag, the effect will be attached + </emphasis> attribute defines the id of the component or html tag, the effect is attached to. Richfaces converts the <emphasis> <property>&quot;for&quot;</property> </emphasis> attribute value to the client id of the component if such component is found. If Modified: trunk/docs/userguide/en/src/main/docbook/included/form.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/form.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/form.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -34,7 +34,14 @@ <section> <title>Creating on a page</title> <para>Component definition on a page is similar to definition of the original component from JSF HTML library. </para> - <programlisting role="XML"><![CDATA[<a4j:form value="value" action="action"/> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[<a4j:form> + <h:panelGrid> + <h:commandButton value="Button" action="#{userBean.nameItMark}" /> + </h:panelGrid> +</a4j:form> ]]></programlisting> </section> <section> Modified: trunk/docs/userguide/en/src/main/docbook/included/gmap.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/gmap.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/gmap.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -205,7 +205,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-gmap{ -font-style:italic; + font-style:italic; } ...]]></programlisting> @@ -231,7 +231,7 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ -font-weight:bold; + font-weight:bold; } ...]]></programlisting> <para>The <emphasis><property>&quot;styleClass&quot;</property></emphasis> attribute for <emphasis role="bold" Modified: trunk/docs/userguide/en/src/main/docbook/included/htmlCommandLink.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/htmlCommandLink.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/htmlCommandLink.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -74,7 +74,7 @@ <property>&lt;a4j:htmlCommandLink&gt;</property> </emphasis>works as standard <emphasis role="bold"> <property>&lt;h:commandLink&gt;</property> - </emphasis>, but here hidden fields required for correct functionality are rendered before the first downloading of a page, though it doesn't happen if its attribute isn't set to &quot;false&quot;.</para> + </emphasis>, but here hidden fields required for correct functionality are rendered before the first downloading of a page, though it doesn't happen if its attribute isn't set to <property>&quot;false&quot;</property>.</para> </section> <section> @@ -83,5 +83,8 @@ <ulink url="http://livedemo.exadel.com/richfaces-demo/richfaces/htmlCommand... you can found some additional information for <emphasis role="bold" </para> + <para> + <ulink url="http://java.sun.com/javaee/javaserverfaces/1.1_01/docs/tlddocs/... you can found some additional information about <emphasis role="bold"><property>&lt;f:param&gt;</property></emphasis> component. + </para> </section> </chapter> Modified: trunk/docs/userguide/en/src/main/docbook/included/insert.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/insert.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/insert.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -89,7 +89,7 @@ <para>If <emphasis> <property>&quot;highlight&quot;</property> </emphasis> attribute is defined and <ulink url="https://jhighlight.dev.java.net/"> - JHighlight</ulink> open source library is in the classpath, the text from the file will be + JHighlight</ulink> open source library is in the classpath, the text from the file is formated and colorized.</para> <para>An example is placed below.</para> <para> Modified: trunk/docs/userguide/en/src/main/docbook/included/jQuery.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/jQuery.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/jQuery.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -302,7 +302,7 @@ <para><emphasis role="bold"> <property>&lt;rich:jQuery&gt;</property> </emphasis> adds styles and behavior to the DOM object dynamically. This means if you replace - something on a page during an Ajax response, the applied artifacts will be overwritten. But you + something on a page during an Ajax response, the applied artifacts is overwritten. But you are allowed to apply them again after the Ajax response is complete.</para> <para>Usually, it could be done with reRendering the <emphasis role="bold"> <property>&lt;rich:jQuery&gt;</property> Modified: trunk/docs/userguide/en/src/main/docbook/included/jsFunction.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/jsFunction.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/jsFunction.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -49,8 +49,8 @@ <a4j:jsFunction data="#{bean.someProperty}" name="callScript" oncomplete="myScript(data.subProperty1, data.subProperty2)"/> ...]]> </programlisting> - <para> The script <emphasis><property>&quot;myScript&quot;</property></emphasis> will be called after - <property>bean.someProperty</property> data will be returned from server(e.g. It&apos;ll + <para> The script <emphasis><property>&quot;myScript&quot;</property></emphasis> is called after + <property>bean.someProperty</property> data is returned from server(e.g. It&apos;ll be object with two subproperties). </para> </section> <section> @@ -68,7 +68,7 @@ <section> <title>Key attributes and ways of usage</title> <para> As the component uses Ajax request to get data from server - it has all common Ajax - Action attributes. Hence, &quot;action&quot; and<emphasis><property> &quot;actionListener&quot; </property></emphasis>can be invoked, and reRendering some parts of + Action attributes. Hence, <emphasis><property>&quot;action&quot;</property></emphasis> and<emphasis><property> &quot;actionListener&quot; </property></emphasis>can be invoked, and reRendering some parts of the page fired after calling function. </para> <para> When using the <emphasis role="bold"> <property>&lt;a4j:jsFunction&gt;</property> @@ -116,5 +116,8 @@ <para> <ulink url="http://livedemo.exadel.com/richfaces-demo/richfaces/jsFunction.... you can see the example of <emphasis role="bold" + <para> + <ulink url="http://java.sun.com/javaee/javaserverfaces/1.1_01/docs/tlddocs/... you can found some additional information about <emphasis role="bold"><property>&lt;f:param&gt;</property></emphasis> component. + </para> </section> </chapter> Modified: trunk/docs/userguide/en/src/main/docbook/included/keepAlive.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/keepAlive.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/keepAlive.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -54,7 +54,7 @@ <section> <title>Key attributes and ways of usage</title> <para> - If a managed bean is declared with <property>&apos;request&apos;</property> scope in the configuration file with the help of <property>&apos;managed-bean-scope&apos;</property> tag then the life-time of + If a managed bean is declared with <property>request</property> scope in the configuration file with the help of <property>managed-bean-scope</property> tag then the life-time of this bean instance is valid only for the current request. Any attempts to make a reference to the bean instance after the request end will throw in Illegal Argument Exception by the server. To avoid these kinds of Exception, component Modified: trunk/docs/userguide/en/src/main/docbook/included/listShuttle.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/listShuttle.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/listShuttle.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -1092,7 +1092,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-shuttle-source-row-active{ -background-color:#FFE4B5; + background-color:#FFE4B5; } ...]]></programlisting> @@ -1118,7 +1118,7 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ -font-style:italic; + font-style:italic; } ...]]></programlisting> <para>The <emphasis><property>&quot;rowClasses&quot;</property></emphasis> attribute for <emphasis role="bold" Modified: trunk/docs/userguide/en/src/main/docbook/included/loadBundle.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/loadBundle.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/loadBundle.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -88,5 +88,11 @@ <ulink url="http://livedemo.exadel.com/richfaces-demo/richfaces/bundle.jsf?... you can found some additional information for <emphasis role="bold" </para> + <para> + <ulink url="http://java.sun.com/javaee/javaserverfaces/1.1_01/docs/tlddocs/... you can found some additional information about <emphasis role="bold"><property>&lt;f:loadBundle&gt;</property></emphasis> component. + </para> + <para> + <ulink url="http://java.sun.com/javaee/javaserverfaces/1.1_01/docs/tlddocs/... you can found some additional information about <emphasis role="bold"><property>&lt;f:view&gt;</property></emphasis> component. + </para> </section> </chapter> \ No newline at end of file Modified: trunk/docs/userguide/en/src/main/docbook/included/loadScript.desc.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/loadScript.desc.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/loadScript.desc.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -10,8 +10,7 @@ <title>Description</title> <para> - Inserts script links to the head element. Render the value of the component as the value of - the <emphasis><property>&quot;src&quot;</property></emphasis> attribute, after passing it to the getResourceURL() method of the ViewHandler for this application, and passing the result through the encodeResourceURL() method of the ExternalContext. + Inserts script links to the head element. Render the value of the component , after passing it to the getResourceURL() method of the ViewHandler for this application, and passing the result through the encodeResourceURL() method of the ExternalContext. </para> </section> </root> \ No newline at end of file Modified: trunk/docs/userguide/en/src/main/docbook/included/loadScript.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/loadScript.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/loadScript.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -55,13 +55,14 @@ <section> <title>Key attributes and ways of usage</title> <para> - As it was mentioned <link linkend="loadScript">above</link> this component returns its value passing it to the + As it was mentioned <link linkend="loadScript">above</link> this component returns its value as the value of + the <emphasis><property>&quot;src&quot;</property></emphasis> attribute passing it to the getResourceUR() method of the ViewHandler for this application, and passing the result through the encodeResourceURL() method of the ExternalContext. </para> <para> - It means that the Context will be inserts automatically to the link. And calls - like <property>resource://</property> will be properly handled. + It means that the Context is inserts automatically to the link. And calls + like <property>resource://</property> is properly handled. </para> <para> Except this - you may be free to put your script links right from the child Modified: trunk/docs/userguide/en/src/main/docbook/included/loadStyle.desc.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/loadStyle.desc.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/loadStyle.desc.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -9,8 +9,7 @@ <title>Description</title> <para> - The component Inserts stylesheet links to the head element. Render the value of the component as the value of - the <emphasis><property>&quot;src&quot;</property></emphasis> attribute, after passing it to the getResourceURL() method of the ViewHandler for this application, and passing the result through the encodeResourceURL() method of the ExternalContext. + The component Inserts stylesheet links to the head element. Render the value of the component, after passing it to the getResourceURL() method of the ViewHandler for this application, and passing the result through the encodeResourceURL() method of the ExternalContext. </para> </section> </chapter> \ No newline at end of file Modified: trunk/docs/userguide/en/src/main/docbook/included/loadStyle.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/loadStyle.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/loadStyle.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -55,13 +55,14 @@ <section> <title>Key attributes and ways of usage</title> <para> - As it was mentioned <link linkend="loadStyle">above</link> this component returns its value passing it to the + As it was mentioned <link linkend="loadStyle">above</link> this component returns its value as the value of + the <emphasis><property>&quot;src&quot;</property></emphasis> attribute passing it to the getResourceUR() method of the ViewHandler for this application, and passing the result via the encodeResourceURL() method of the ExternalContext. </para> <para> - It means that the Context will be inserts automatically to the link. And calls - like <property>resource://</property> will be properly handled. + It means that the Context is inserted automatically to the link. And calls + like <property>resource://</property> is properly handled. </para> <para> Except this - you may be free to put your stylesheet links right from the child Modified: trunk/docs/userguide/en/src/main/docbook/included/log.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/log.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/log.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -33,7 +33,7 @@ <section> <title>Creating on a page</title> - <para>To use the component, it&apos;s necessary to place the following string on a page:</para><programlisting role="XML"><![CDATA[<a4j:log/>]]></programlisting> + <para>To use the component, it&apos;s necessary to place the following string on a page:</para><programlisting role="XML"><![CDATA[<a4j:log popup="false" level="ALL" style="width: 800px; height: 300px;"></a4j:log>]]></programlisting> <para>Then, in order to open a log window, press &quot;CTRL+SHIFT+L&quot; on a page with the component.</para> </section> <section> @@ -68,7 +68,7 @@ <para>The component defined this way is decoded on a page as <emphasis role="bold"><property>&lt;div&gt;</property></emphasis> inside a page, where all the information beginning with informational message is generated.</para> <note> <title>Note:</title> - <para><emphasis role="bold">&lt;a4j:log&gt;</emphasis> is getting renewed automatically after execution of Ajax requests. Don't renew <emphasis role="bold">&lt;a4j:log&gt;</emphasis> by using reRender!</para> + <para><emphasis role="bold"><property>&lt;a4j:log&gt;</property></emphasis> is getting renewed automatically after execution of Ajax requests. Don't renew <emphasis role="bold"><property>&lt;a4j:log&gt;</property></emphasis> by using reRender!</para> </note> </section> Modified: trunk/docs/userguide/en/src/main/docbook/included/mediaOutput.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/mediaOutput.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/mediaOutput.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -32,7 +32,7 @@ <section> <title>Creating on a page</title> - <para>To use the component it&apos;s necessary to define it on a page and set Java methods for data keeping and data transmission to output stream. </para> + <para>Component definition on a page for graphical data output</para> <para> @@ -44,28 +44,7 @@ mimeType="image/jpeg"/> ... ]]></programlisting> -<para>Here is the content of paintData that is a bean containing output data</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> -<programlisting role="JAVA"><![CDATA[package demo; - -public class PaintData implements Serializable{ - private static final long serialVersionUID = 1L; - Integer width=100; - Integer weight=50; -... -]]></programlisting> -<para>The Paint method of the paintBean class is a method transmitting graphical data into output stream.</para> - - <para> - <emphasis role="bold">Example:</emphasis> - </para> -<programlisting role="JAVA"><![CDATA[public void paint(OutputStream out, Object data) throws IOException{ - <!--...Some code that puts binary data to "out" Stream--> - } -]]></programlisting> </section> <section> <title>Dynamical creation of a component from Java code</title> @@ -81,6 +60,28 @@ </section> <section> <title>Key attributes and ways of usage</title> + <para>To use the component it&apos;s necessary to define it on a page and set Java methods for data keeping and data transmission to output stream. </para> + <para>Here is the content of paintData that is a bean containing output data</para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="JAVA"><![CDATA[package demo; + +public class PaintData implements Serializable{ + private static final long serialVersionUID = 1L; + Integer width=100; + Integer weight=50; +... +]]></programlisting> + <para>The Paint method of the paintBean class is a method transmitting graphical data into output stream.</para> + + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="JAVA"><![CDATA[public void paint(OutputStream out, Object data) throws IOException{ + <!--...Some code that puts binary data to "out" Stream--> + } +]]></programlisting> <para>As it was shown in the example above there are two main components:</para> <itemizedlist> <listitem> Modified: trunk/docs/userguide/en/src/main/docbook/included/message.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/message.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/message.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -197,7 +197,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-message-label{ -font-style:italic + font-style:italic } ...]]></programlisting> @@ -223,7 +223,7 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ -font-weight:bold; + font-weight:bold; } ...]]></programlisting> <para>The <emphasis><property>&quot;styleClass&quot;</property></emphasis> attribute for <emphasis role="bold" Modified: trunk/docs/userguide/en/src/main/docbook/included/messages.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/messages.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/messages.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -194,7 +194,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-messages-label{ -font-style:italic; + font-style:italic; } ...]]></programlisting> @@ -220,7 +220,7 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ -color:red; + color:red; } ...]]></programlisting> Modified: trunk/docs/userguide/en/src/main/docbook/included/modalPanel.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/modalPanel.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/modalPanel.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -265,7 +265,7 @@ ...]]></programlisting> <para> Here, if you open modal dialog window using current link and after submits data then - modalPanel destination and height on new loaded page will be restored. </para> + modalPanel destination and height on new loaded page is restored. </para> <para>if you need the content of the modalPanel to be submitted - you need to remember two important rules: </para> <itemizedlist> <listitem>modalPanel must have its own form if it has form elements (input or/and command @@ -595,7 +595,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-mpnl-mask-div{ -background-color:#ffead9; + background-color:#fae6b0; } ...]]></programlisting> @@ -621,7 +621,7 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ -font-style:italic; + font-style:italic; } ...]]></programlisting> <para>The <emphasis><property>&quot;headerClass&quot;</property></emphasis> attribute for <emphasis role="bold" Modified: trunk/docs/userguide/en/src/main/docbook/included/nodeSelectListener.desc.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/nodeSelectListener.desc.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/nodeSelectListener.desc.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -9,7 +9,7 @@ <section> <title>Description</title> <para>The <emphasis role="bold"><property>&lt;rich:nodeSelectListener&gt;</property></emphasis> - represents an action listener method that will be notified after selection of a node. + represents an action listener method that is notified after selection of a node. </para> </section> Modified: trunk/docs/userguide/en/src/main/docbook/included/nodeSelectListener.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/nodeSelectListener.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/nodeSelectListener.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -72,7 +72,7 @@ </para> <para> Attribute <emphasis><property>&quot;type&quot;</property></emphasis> defines the fully qualified Java class name for listener. -This class should implement org.richfaces.event.NodeSelectedListener interface. + This class should implement org.richfaces.event.NodeSelectedListener <ulink url="http://labs.jboss.com/file-access/default/members/jbossrichface...;. </para> <para> Modified: trunk/docs/userguide/en/src/main/docbook/included/orderingList.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/orderingList.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/orderingList.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -117,7 +117,7 @@ below after submitting the form the current collection is placed in the object's property and then <emphasis role="bold"> <property>&lt;rich:dataTable&gt;</property> - </emphasis> with selected items will be shown. </para> + </emphasis> with selected items is shown. </para> <para> <emphasis role="bold">Example:</emphasis> @@ -898,7 +898,7 @@ </figure> - <table> + <table id="OrderLC"> <title>Classes names that define a list representation</title> <tgroup cols="2"> <thead> @@ -1118,15 +1118,68 @@ </tgroup> </table> <para>In order to redefine styles for all <emphasis role="bold"> - <property>&lt;rich:orderingList&gt;</property> - </emphasis> components on a page using CSS, it's enough to create classes with the same - names and define necessary properties in them. </para> - <para>To change styles of particular <emphasis role="bold"> - <property>&lt;rich:orderingList&gt;</property> - </emphasis> components, define your own style classes in the corresponding <emphasis - role="bold"> - <property>&lt;rich:orderingList&gt;</property> - </emphasis> component attributes.</para> + <property>&lt;rich:orderingList&gt;</property> + </emphasis> components on a page using CSS, it&apos;s enough to create classes with the + same names (possible classes could be found in the tables <link linkend="OrderLC"> above</link>) and define necessary properties in them. </para> + + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="CSS"><![CDATA[... +.rich-ordering-list-table-header-cell{ + font-weight:bold; +} +...]]></programlisting> + + <para>This is a result:</para> + + <figure> + <title>Redefinition styles with predefined classes</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/orderinListClass.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>In the example the font weight for header text was changed.</para> + + <para>Also it’s possible to change styles of particular <emphasis role="bold" + ><property>&lt;rich:orderingList&gt;</property></emphasis> component. In this case you should create own style classes and use them in corresponding <emphasis role="bold" + ><property>&lt;rich:orderingList&gt;</property></emphasis> <property>styleClass</property> attributes. An example is placed below:</para> + + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="CSS"><![CDATA[... +.myClass{ + font-style:italic; +} +...]]></programlisting> + <para>The <emphasis><property>&quot;rowClasses&quot;</property></emphasis> attribute for <emphasis role="bold" + ><property>&lt;rich:orderingList&gt;</property></emphasis> is defined as it’s shown in the example below:</para> + + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="CSS"><![CDATA[<rich:orderingList ... rowClasses="myClass"/> +]]></programlisting> + + <para>This is a result:</para> + + <figure> + <title>Redefinition styles with own classes and styleClass attributes</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/orderinListStyle.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>As it could be seen on the picture above, the font style for rows was changed.</para> + + + </section> <section> Modified: trunk/docs/userguide/en/src/main/docbook/included/outputPanel.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/outputPanel.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/outputPanel.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -42,9 +42,13 @@ <para> <emphasis role="bold">Example:</emphasis> </para> - <programlisting role="XML"><![CDATA[<a4j:outputPanel> -<!--...Some Content Inside--> -</a4j:outputPanel> + <programlisting role="XML"><![CDATA[ <a4j:outputPanel> + <h:form> + <h:outputText value="Some text"/> + <h:inputText id="text1" label="text1" value="#{rsBean.text1}"> + </h:inputText> + </h:form> + </a4j:outputPanel> ]]></programlisting> </section> <section> @@ -60,7 +64,7 @@ </section> <section> <title>Key attributes and ways of usage</title> - <para><emphasis role="bold"><property>&lt;a4j:outPanel&gt;</property></emphasis> allows marking of a page area, which is updated on Ajax response. Anyway, <emphasis role="bold"> + <para><emphasis role="bold"><property>&lt;a4j:outputPanel&gt;</property></emphasis> allows marking of a page area, which is updated on Ajax response. Anyway, <emphasis role="bold"> <property>&lt;a4j:outputPanel&gt;</property> </emphasis> usage is optional, as in RichFaces it&apos;s possible to indicate any existing component id on a component view in order to define updating areas. @@ -99,10 +103,10 @@ none </listitem> </itemizedlist> - <para>If layout=&quot;block&quot; is chosen, the component is rendered as a pair of opening and closing <emphasis role="bold"><property>&lt;div&gt;</property></emphasis> tag, to which it&apos;s possible to apply any available style attributes available for block tags. </para> - <para>Layout=&quot;none&quot; helps to avoid an unnecessary tag round a context that could or couldn&apos;t be rendered according to the defined <emphasis><property>&quot;rendered&quot;</property></emphasis> attribute conditions. If an inner context isn’t rendered, <emphasis role="bold"> + <para>If <emphasis><property> &quot;layout&quot; </property></emphasis>=<property>&quot;block&quot;</property> is chosen, the component is rendered as a pair of opening and closing <emphasis role="bold"><property>&lt;div&gt;</property></emphasis> tag, to which it&apos;s possible to apply any available style attributes available for block tags. </para> + <para><emphasis><property> &quot;layout&quot; </property></emphasis>=<property>&quot;none&quot;</property> helps to avoid an unnecessary tag round a context that could or couldn&apos;t be rendered according to the defined <emphasis><property>&quot;rendered&quot;</property></emphasis> attribute conditions. If an inner context isn’t rendered, <emphasis role="bold"> <property>&lt;a4j:outputPanel&gt;</property> - </emphasis> is rendered as a <emphasis role="bold"><property>&lt;span&gt;</property></emphasis> tag with the id equal to an id of a child component and &quot;display:none&quot; style. If a child component is rendered, <emphasis role="bold"> + </emphasis> is rendered as a <emphasis role="bold"><property>&lt;span&gt;</property></emphasis> tag with the id equal to an id of a child component and <property>display:none</property> style. If a child component is rendered, <emphasis role="bold"> <property>&lt;a4j:outputPanel&gt;</property> </emphasis> doesn&apos;t present at all in a final code.</para> <para><emphasis role="bold">Example:</emphasis></para> @@ -117,12 +121,15 @@ <para>As you see, the code is very similar to the one shown above, but <emphasis ><property>&quot;reRender &quot;</property></emphasis> attribute refers directly to the updating panelGrid and not to the framing outputPanel, and it&apos;s more semantically correct.</para> <para><emphasis role="bold"><property>&lt;a4j:outPanel&gt;</property></emphasis> should be used for non-JSF component part framing, which is to be updated on Ajax response, as RichFaces specifies the list of updating areas as a list of an existing JSF component. </para> <para>On default non-JSF context isn&apos;t saved in a component tree, but is rendered anew every time. To accelerate the processing speed and Ajax response input speed, RichFaces saves non-JSF context in a component tree on default. This option could be canceled by<emphasis><property> &quot;keepTransient&quot; </property></emphasis>attribute that cancels transient flag forced setting for child components. This flag setting keeps the current value set by child components.</para> - <para>Note: In JSF 1.1 implementation and lower, where non-JSF context should be framed with the &quot;f:verbatim&quot; attribute, <emphasis role="bold"> + <note> + <title>Note:</title> + <para>In JSF 1.1 implementation and lower, where non-JSF context should be framed with the <emphasis role="bold"><property>&lt;f:verbatim&gt;</property></emphasis> component, <emphasis role="bold"> <property>&lt;a4j:outputPanel&gt;</property> - </emphasis> doesn&apos;t improve this JSF implementation option in any way, so you still have to use this tag where it&apos;s necessary without RichFaces usage. </para> - <para>RichFaces allows setting Ajax responses rendering directly basing on component tree nodes without referring to the JSP (XHTML) page code. It could be defined by selfRendered attribute setting to <emphasis > + </emphasis> doesn&apos;t improve this JSF implementation option in any way, so you still have to use this tag where it&apos;s necessary without RichFaces usage. </para> + </note> + <para>RichFaces allows setting Ajax responses rendering directly basing on component tree nodes without referring to the JSP (XHTML) page code. It could be defined by selfRendered attribute setting to <property>&quot;true&quot;</property> - </emphasis> + on <emphasis role="bold"> <property>&lt;a4j:region&gt;</property> </emphasis> and could help considerably speed up a response output. However, if a transient flag is kept as it is, this rapid processing could cause missing of transient components that present on view and don’t come into a component tree. Hence, for any particular case you could choose a way for you application optimization: speed up processing or redundant memory for keeping tree part earlier defined a transient. </para> Modified: trunk/docs/userguide/en/src/main/docbook/included/page.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/page.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/page.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -38,27 +38,14 @@ </emphasis></para> <programlisting role="XML"><![CDATA[<f:view> <a4j:page> - <f:facet name="head"> - <!--...Head Content here--> - </f:facet> + <f:facet name="head"> + <!--...Head Content here--> + </f:facet> <!--...Page Content here--> </a4j:page> </f:view> ]]></programlisting> - <para>This structure is rendered as:</para> - - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[<HTML> - <HEAD> - <!--...Head Content here--> - </HEAD> -<body > - <!--...Page Content Here--> -</body> -</HTML>]]></programlisting> - </section> + </section> <section> <title>Dynamical creation of a component from Java code</title> @@ -75,15 +62,53 @@ <title>Key attributes and ways of usage</title> <para>The component is mostly used to solve the following problem with MyFaces for erlier Ajax4jsf versions: in MyFaces <emphasis role="bold"> <property>&lt;f:view&gt;</property> - </emphasis> doesn&apos;t get control over the &quot;<emphasis > + </emphasis> doesn&apos;t get control over the <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"> + 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 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<emphasis><property> &quot;contentType&quot; </property></emphasis>definition.</para> - </section> + <para>The component is rendered as a full HTML page template as it is shown in the <link linkend="exampl">example</link>. The + <property>head</property> + section is defined with the help of the corresponding <emphasis><property>&quot;head&quot;</property></emphasis> facet. + + You do not need to use <emphasis><property>&quot;body&quot;</property></emphasis> facet in order to define first <property>body</property> section. + The second and more <property>body</property> sections is defined with the help of the corresponding <emphasis><property>&quot;body&quot;</property></emphasis> facet. + + </para> + <para> + The attribute <emphasis><property>&quot;format&quot;</property></emphasis> defines page layout format for encoding DOCTYPE. + </para> + <para> + The attribute <emphasis><property>&quot;pageTitle&quot;</property></emphasis> is rendered as <property>title</property> section. + </para> + + + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[<a4j:page format="xhtml" pageTitle="myPage"> + <f:facet name="head"> + <!--Head Content here--> + </f:facet> + <!--Page Content Here--> +</a4j:page> +]]></programlisting> + <para>This structure is rendered as:</para> + + <para id="exampl"> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html> + <head> + <title>myPage</title> + <!--Head Content here--> + </head> + <body> + <!--Page Content Here--> + </body> +</html>]]></programlisting> + </section> <section> <title>Relevant resources links</title> Modified: trunk/docs/userguide/en/src/main/docbook/included/panelMenu.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/panelMenu.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/panelMenu.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -279,7 +279,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-pmenu-group-self-label{ -font-style:italic; + font-style:italic; } ...]]></programlisting> @@ -305,7 +305,7 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ -background-color:#ffead9; + background-color:#ffead9; } ...]]></programlisting> <para>The <emphasis><property>&quot;hoveredItemClass&quot;</property></emphasis> attribute for <emphasis role="bold" Modified: trunk/docs/userguide/en/src/main/docbook/included/portlet.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/portlet.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/portlet.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -50,7 +50,7 @@ <section> <title>Key attributes and ways of usage</title> <para> Portal page can include some instances of the same portlet but clientId of elements - should be different for each window. In that case &apos;namespace&apos; is used for + should be different for each window. In that case <property>namespace</property> is used for each portlet. The <emphasis role="bold"> <property>&lt;a4j:portlet&gt;</property> </emphasis> implemets NaimingContainer interface and adds namespace to all componets on a Modified: trunk/docs/userguide/en/src/main/docbook/included/push.desc.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/push.desc.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/push.desc.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -4,6 +4,16 @@ <title>Description</title> <para>The <emphasis role="bold"> <property>&lt;a4j:push&gt;</property> - </emphasis>periodically perform Ajax request to server, to simulate 'push' data.</para> + </emphasis>periodically perform Ajax request to server, to simulate 'push' data.</para> + <para>The main difference between <emphasis role="bold"> + <property>&lt;a4j:push&gt;</property> + </emphasis> and <emphasis role="bold"> + <property>&lt;a4j:poll&gt;</property> + </emphasis> components is that <emphasis role="bold"> + <property>&lt;a4j:push&gt;</property> + </emphasis> + makes request to minimal code only (not to JSF tree) in order to check the presence of messages in the queue. + If the message exists the complete request is performed. The component doesn't poll registered beans + but registers EventListener which receives messages about events.</para> </section> </root> \ No newline at end of file Modified: trunk/docs/userguide/en/src/main/docbook/included/push.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/push.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/push.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -49,12 +49,7 @@ <title>Key attributes and ways of usage</title> <para>The <emphasis role="bold"> <property>&lt;a4j:push&gt;</property> - </emphasis> implements reverse Ajax technique. The component makes requests to minimal code - (not to JSF tree) in order to check presence of messages in a queue. If a message exists, a - complete request is performed. <emphasis role="bold"> - <property>&lt;a4j:push&gt;</property> - </emphasis> registers <property>EventListener</property> in the bean, - which receives messages about an event presence.</para> + </emphasis> implements reverse Ajax technique. </para> <para>The bean, for example, could be subscribed to Java Messaging Service (<ulink url="http://java.sun.com/products/jms/">JMS</ulink>) topic or it could be implemented as @@ -68,7 +63,7 @@ </emphasis> component corresponds to an anisochronous model, but not to pools as for <emphasis role="bold"> <property>&lt;a4j:poll&gt;</property> - </emphasis> component. See the simplest example below:</para> + </emphasis> <link linkend="poll">component</link>. See the simplest example below:</para> <para> <emphasis role="bold">Example:</emphasis> Modified: trunk/docs/userguide/en/src/main/docbook/included/region.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/region.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/region.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -34,9 +34,11 @@ <section> <title>Creating on a page</title> <para>Here is an example of the region decoding on a page. </para> - <programlisting role="XML"><![CDATA[<a4j:region> - <!--..Some content that will be decoded on server after Ajax request.--> -</a4j:region>]]></programlisting> + <programlisting role="XML"><![CDATA[ <a4j:region> + <h:inputText value="#{userBean.name}"> + <a4j:support event="onkeyup" reRender="outname" /> + </h:inputText> + </a4j:region>]]></programlisting> </section> <section> <title>Dynamical creation of a component from Java code</title> @@ -52,12 +54,12 @@ </section> <section> <title>Key attributes and ways of usage</title> - <para>The region is a component used for manipulation with components sent to the server. It sets particular processing parameters for an area on the server, i.e. the region deals with data input on the server and has no direct impact on output. To read more on the components responsible for out, see <emphasis><property>&quot;reference&quot;</property></emphasis> + <para>The region is a component used for manipulation with components sent to the server. It sets particular processing parameters for an area on the server, i.e. the region deals with data input on the server and has no direct impact on output. To read more on the components responsible for out, see &quot;reference&quot; <ulink url="http://java.sun.com/javaee/javaserverfaces/reference/index.html...;. </para> <para>The region marks an area page that is decoded on the server. In most cases it is not necessary to use the region, as ViewRoot is a default region. This component helps to reduce data quantity processed by the server, but the region doesn&apos;t influence on the standard submission rules. It means that:<itemizedlist> <listitem> The area that is to be submitted onto the server should be embedded in <emphasis role="bold"> -<property>&lt;h:form/a4j:form&gt;</property> + <property>&lt;h:form&gt;</property>/<property>&lt;a4j:form&gt;</property> </emphasis> component. </listitem> <listitem> @@ -85,7 +87,7 @@ <!--..Some content that will be decoded on server after Ajax request.--> </a4j:region >]]></programlisting> <para>Therefore, the external region is decoded for the &quot;link1&quot; and the internal one is decoded for the &quot;link2&quot;.</para> - <para>RichFaces allows setting Ajax responses rendering directly basing on component tree nodes without referring to the JSP (XHTML) page code. It could be defined by<emphasis><property> &quot;selfRendered&quot; </property></emphasis>attribute setting to <emphasis><property>&quot;true&quot;</property></emphasis> on <emphasis role="bold"> + <para>RichFaces allows setting Ajax responses rendering directly basing on component tree nodes without referring to the JSP (XHTML) page code. It could be defined by<emphasis><property> &quot;selfRendered&quot; </property></emphasis>attribute setting to <property>&quot;true&quot;</property> on <emphasis role="bold"> <property>&lt;a4j:region&gt;</property> </emphasis> and could help considerably speed up a response output. However, this rapid processing could cause missing of transient components that present on view and don&apos;t come into a component tree as well as omitting of <emphasis role="bold"> <property>&lt;a4j:outputPanel&gt;</property> @@ -100,7 +102,7 @@ <para>The processing could be also accelerated if a region decoded for the processing passes straight away into Encode. But to update some data out of the region or on another region, use the <emphasis > <property>&quot;renderRegionOnly&quot;</property> </emphasis> -attribute set to <emphasis><property>&quot;false&quot;</property></emphasis> (&quot;true on default&quot;) to change this behaviour.</para> + attribute set to <property>&quot;false&quot;</property> (<property>&quot;true&quot;</property> on default) to change this behaviour.</para> <para><emphasis role="bold">Example:</emphasis></para> <programlisting role="XML"><![CDATA[<a4j:region renderRegionOnly="true"> <a4j:commandLink reRender="someID2" value="Link1" id="link1"/> @@ -115,7 +117,7 @@ <para>This example shows that one of the regions is decoded when a link is used inside. Nevertheless, if after processing the &quot;link1&quot; is clicked, the first region passes into Encode as a root region and encode performance time is reduced. This optimization doesn&apos;t allow data update out of the - region and should be implemented very carefully. The data out of the region described with<emphasis><property> &quot;renderRegionOnly&quot;</property></emphasis>=&quot;false&quot; is updated successfully.</para> + region and should be implemented very carefully. The data out of the region described with<emphasis><property> &quot;renderRegionOnly&quot;</property></emphasis>=<property>&quot;false&quot;</property> is updated successfully.</para> </section> <section> <title>Relevant resources links</title> Modified: trunk/docs/userguide/en/src/main/docbook/included/repeat.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/repeat.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/repeat.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -33,15 +33,15 @@ <section> <title>Creating on a page</title> - <para>The component definition on a page is the same as for the <emphasis > - <property>&quot;facelets&quot;</property> - </emphasis> component:</para> + <para>The component definition on a page is the same as for the + <property>facelets</property> + component:</para> <programlisting role="XML"><![CDATA[<a4j:repeat id="detail" value="#{bean.props}" var="detail"> <h:outputText value="#{detail.someProperty}"/> </a4j:repeat>]]></programlisting> - <para>The output is generated according to a collection contained in <emphasis > - <property>&quot;bean.props&quot;</property> - </emphasis> with the <emphasis><property>&quot;detail&quot;</property></emphasis> key passed to child components.</para> + <para>The output is generated according to a collection contained in + <property>bean.props</property> + with the <property>detail</property> key passed to child components.</para> </section> <section> <title>Dynamical creation of a component from Java code</title> @@ -78,29 +78,29 @@ ... ]]></programlisting> - <para>Thus, a list with a table structure from <emphasis > - <property>&quot;bean.props&quot;</property> - </emphasis> is output.</para> + <para>Thus, a list with a table structure from + <property>bean.props</property> + is output.</para> <para>In the above-mentioned example the component <emphasis role="bold"> <property>&lt;a4j:poll&gt;</property> - </emphasis> sends Ajax requests every second, calling the <emphasis > - <property>&quot;action&quot;</property> - </emphasis> method of the <emphasis > - <property>&quot;repeater&quot;</property> - </emphasis> bean. + </emphasis> sends Ajax requests every second, calling the + <property>action</property> + method of the + <property>repeater</property> + bean. </para> <note> <title>Note:</title> <para>The <emphasis role="bold"> <property>&lt;a4j:repeater&gt;</property> - </emphasis> component is defined as fully updated, but really updated there are only the row keys which rowKeys includes into the set <emphasis > - <property>&quot;ajaxRowSet&quot;</property> - </emphasis> defined in the <emphasis > + </emphasis> component is defined as fully updated, but really updated there are only the row keys which rowKeys includes into the set + <property>ajaxRowSet</property> + defined in the <emphasis > <property>&quot;ajaxKeys&quot;</property> </emphasis> attribute </para> - <para>The set could be defined during the action method processing using data on a model from the property <emphasis > - <property>&quot;repeater.myRepeat&quot;</property> - </emphasis></para> + <para>The set could be defined during the action method processing using data on a model from the property + <property>repeater.myRepeat</property> + </para> </note> <para>One more benefit of this component is absence of strictly defined markup as JSF HTML DataTable and TOMAHAWK DataTable has, hence the components could be used more flexibly anywhere where it&apos;s necessary to output the results of selection from some collection.</para> <para>The next example shows collection output as a plain HTML list</para> Modified: trunk/docs/userguide/en/src/main/docbook/included/scrollableDataTable.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/scrollableDataTable.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/scrollableDataTable.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -76,10 +76,10 @@ or collapse the columns through JS API on the client side. You can define the number of the fixed columns from the left side using attribute <emphasis> <property>&quot;frozenColCount&quot;</property> - </emphasis> that will not be scrolled via horizontal scroll. </para> + </emphasis> that is not scrolled via horizontal scroll. </para> <para> There is possibility to increase component performance using attribute <emphasis> <property>&quot;hideWhenScrolling&quot;</property> - </emphasis>. If attribute value is 'true' data will be hidden during scrolling. </para> + </emphasis>. If attribute value is 'true' data is hidden during scrolling. </para> <para> It's possible to select the whole row with onclick on the row or some set of rows. Selection is optional and availability of such feature is defined on the component. There are @@ -95,10 +95,10 @@ <listitem>Collapse(columnId) - Performs the collapse action for the column with the corresponding id</listitem> </itemizedlist> It's possible to sort the table content after clicks on the header. The - feature is optional. Every column should be pointed to the comparator method that will be used + feature is optional. Every column should be pointed to the comparator method that is used for sorting the table. In case the <property>&lt;rich:scrollableDataTable&gt;</property> is already sorted by some column - and the header of this column has been clicked again - the sorting will be reversed. </para> + and the header of this column has been clicked again - the sorting is reversed. </para> <para> <emphasis role="bold">The typical variant of using:</emphasis> @@ -134,7 +134,7 @@ <para>In the following example when you submits the form current collection of objects selected by you is placed in the object's property. Then on complete action the <emphasis role="bold"> <property>&lt;rich:modalPanel&gt;</property> - </emphasis> with selected data will be shown.</para> + </emphasis> with selected data is shown.</para> <para> <emphasis role="bold">Example:</emphasis> </para> @@ -582,7 +582,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-sdt-header-cell{ -font-style:italic; + font-style:italic; } ...]]></programlisting> @@ -608,7 +608,7 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ -background-color:#ffead9; + background-color:#ffead9; } ...]]></programlisting> <para>The <emphasis><property>&quot;selectedClass&quot;</property></emphasis> attribute for <emphasis role="bold" Modified: trunk/docs/userguide/en/src/main/docbook/included/separator.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/separator.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/separator.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -158,7 +158,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-separator{ -background-color:#ff7700; + background-color:#ff7700; } ...]]></programlisting> @@ -184,7 +184,7 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ -background-color:#ffead9; + background-color:#ffead9; } ...]]></programlisting> <para>The <emphasis><property>&quot;styleClass&quot;</property></emphasis> attribute for <emphasis role="bold" Modified: trunk/docs/userguide/en/src/main/docbook/included/simpleTogglePanel.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/simpleTogglePanel.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/simpleTogglePanel.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -316,7 +316,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-stglpanel-header{ -font-style:italic; + font-style:italic; } ...]]></programlisting> @@ -342,7 +342,7 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ -background-color:#ffead9; + background-color:#ffead9; } ...]]></programlisting> <para>The <emphasis><property>&quot;bodyClass&quot;</property></emphasis> attribute for <emphasis role="bold" Modified: trunk/docs/userguide/en/src/main/docbook/included/status.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/status.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/status.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -45,7 +45,7 @@ </itemizedlist> <itemizedlist> <listitem> - With &quot;Start&quot;/&quot;Stop&quot; facets definition: + With <emphasis ><property>&quot;Start&quot;/&quot;Stop&quot;</property></emphasis > facets definition: <programlisting role="XML"><![CDATA[<a4j:status for="stat2"> <f:facet name="start"> <h:graphicImage value="ajax_process.png" /> @@ -81,7 +81,7 @@ </emphasis> component. Here <emphasis > <property>&quot;for&quot;</property> </emphasis> -attribute should point at an Ajax container (<emphasis role="bold"><property>&lt;a4j:region&gt;</property></emphasis>) &quot;id&quot;, which requests are tracked by a component. + attribute should point at an Ajax container (<emphasis role="bold"><property>&lt;a4j:region&gt;</property></emphasis>) <property>id</property>, which requests are tracked by a component. </listitem> </itemizedlist><itemizedlist> <listitem> @@ -90,24 +90,24 @@ </emphasis> attribute obtained by any RichFaces library action component. The attribute should point at the <emphasis role="bold"> <property>&lt;a4j:status&gt;</property> - </emphasis> component &quot;id&quot;. Then this <emphasis role="bold"> +</emphasis> component <property>id</property>. Then this <emphasis role="bold"> <property>&lt;a4j:status&gt;</property> </emphasis> component shows the status for the request fired from this action component. </listitem> </itemizedlist></para> <para>The component creates two <emphasis role="bold"><property>&lt;span&gt;</property></emphasis> or <emphasis role="bold"><property>&lt;div&gt;</property></emphasis> - elements depending on attribute "layout" + elements depending on attribute <emphasis><property>&quot;layout&quot;</property></emphasis> with content defined for each status, one of the elements (start) is initially hidden. At the beginning of an Ajax request, elements state is inversed, hence the second element is shown and the first is hidden. At the end of a response processing, elements display states return to its initial values.</para> <para><emphasis role="bold">Example:</emphasis> </para> <programlisting role="XML"><![CDATA[<a4j:status startText="Started" stopText="stopped" />]]></programlisting> - <para>is decoded on a page as:</para><programlisting role="XML"><![CDATA[<span id="j_id20:status.start" style="display: none"> + <para>The code shown in the example above is decoded on a page as:</para><programlisting role="XML"><![CDATA[<span id="j_id20:status.start" style="display: none"> Started </span> <span id="j_id20:status.stop"> Stopped </span>]]></programlisting> - <para>And after the generation of an Ajax response is changed to:</para> + <para>and after the generation of an Ajax response is changed to:</para> <programlisting role="XML"><![CDATA[<span id="j_id20:status.start"> Started </span> @@ -117,7 +117,7 @@ <para>There is a possibility to group a <emphasis role="bold"><property>&lt;a4j:status&gt;</property></emphasis> elements content into <emphasis role="bold"><property>&lt;div&gt;</property></emphasis> elements, instead of <emphasis role="bold"><property>&lt;span&gt;</property></emphasis>. To use it, just redefine the <emphasis > <property>&quot;layout&quot;</property> </emphasis> -attribute from &quot;inline&quot;(default) to &quot;block&quot;.</para> + attribute from <property>&quot;inline&quot;</property>(default) to <property>&quot;block&quot;</property>.</para> </section> <section> <title>Relevant resources links</title> Modified: trunk/docs/userguide/en/src/main/docbook/included/support.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/support.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/support.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -44,7 +44,7 @@ </h:inputText> <h:outputText id="repeater" value="#{bean.text}"/>]]></programlisting> <para>On every keyup event generated by an input field, a form is submitted on the server with the help of Ajax and - on a response coming from the server, element with <emphasis><property>&quot;repeater&quot;</property></emphasis> id, founded in a DOM tree is + on a response coming from the server, element with <property>repeater</property> id, founded in a DOM tree is redrawn according to a new data from the response.</para> </section> <section> @@ -74,7 +74,7 @@ <programlisting role="XML"><![CDATA[ <input onkeyup="A4J.AJAX.Submit( Some request parameters )"/> ]]></programlisting> - <para>As you see from the code, the &quot;onkeyup&quot; + <para>As you see from the code, the <property>onkeyup</property> event calls a utility RichFaces method that submit a form creating a special marks for a filter informing that it is an Ajax request. Thus, any supports quantity could be added to every component, the supports define component behavior on these events. </para> <note> <para>The components: <emphasis role="bold"><property>&lt;a4j:commandLink&gt;</property></emphasis>, <emphasis role="bold"><property>&lt;a4j:commandButton&gt;</property></emphasis>, <emphasis role="bold"> @@ -112,7 +112,7 @@ </h:inputText> <h:inputText value="#{person.middleName}"/> </form>]]></programlisting> - <para>In this example the request contains only the input component causes the request generation, not all the components contained on a form, because of &quot;ajaxSingle=true&quot; usage. </para> + <para>In this example the request contains only the input component causes the request generation, not all the components contained on a form, because of <emphasis><property>&quot;ajaxSingle&quot;</property></emphasis>=<property>&quot;true&quot;</property> usage. </para> <para><emphasis role="bold">Example 2:</emphasis></para> <programlisting role="XML"><![CDATA[<h:form> <a4j:outputPanel ajaxRendered="true"> @@ -123,7 +123,7 @@ </h:inputText> <h:outputText value="#{person.name}" id="test"/> </form>]]></programlisting> - <para>In this example the component &quot;h:messages&quot; is always updated (as it capturing all Ajax requests, located in ajaxRendered <emphasis role="bold"><property>&lt;a4j:outputPanel&gt;</property></emphasis>), except the case when a response is sent from the input component from the example. On sending this component marks that updating area is limited to the defined in it components, it means that on its usage with<emphasis><property> &quot;limitToList&quot;</property></emphasis>=&quot;true&quot; the only component updated is the one with &quot;d&quot;=&quot;test&quot;.</para> + <para>In this example the component <emphasis role="bold"><property>&lt;h:messages&gt;</property></emphasis> is always updated (as it capturing all Ajax requests, located in ajaxRendered <emphasis role="bold"><property>&lt;a4j:outputPanel&gt;</property></emphasis>), except the case when a response is sent from the input component from the example. On sending this component marks that updating area is limited to the defined in it components, it means that on its usage with<emphasis><property> &quot;limitToList&quot;</property></emphasis>=<property>&quot;true&quot;</property> the only component updated is the one with <emphasis><property>&quot;id&quot;</property></emphasis>=<property>&quot;test&quot;</property>.</para> <itemizedlist> <listitem> <emphasis role="bold">Limitation of requests frequency and updates quantity after the responses. </emphasis> Modified: trunk/docs/userguide/en/src/main/docbook/included/togglePanel.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/togglePanel.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/togglePanel.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -179,7 +179,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-toggle-panel{ -font-weight:bold; + font-style:italic; } ...]]></programlisting> @@ -194,7 +194,7 @@ </mediaobject> </figure> - <para>In the example the font weight for output text was changed.</para> + <para>In the example the font style for output text was changed.</para> <para>Also it’s possible to change styles of particular <emphasis role="bold" @@ -205,7 +205,7 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ -background-color:#ffead9; + background-color:#bed6f8; } ...]]></programlisting> <para>The <emphasis><property>&quot;styleClass&quot;</property></emphasis> attribute for <emphasis role="bold" Modified: trunk/docs/userguide/en/src/main/docbook/included/toolBar.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/toolBar.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/toolBar.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -220,7 +220,7 @@ </para> <programlisting role="CSS"><![CDATA[... .rich-toolbar-item{ -background-color:#ffead9; + font-weight:bold; } ...]]></programlisting> @@ -235,7 +235,7 @@ </mediaobject> </figure> - <para>In the example background color for <property>&lt;rich:toolBar&gt;</property> was changed.</para> + <para>In the example font weight for items was changed.</para> <para>Also it’s possible to change styles of particular <emphasis role="bold" @@ -246,7 +246,8 @@ </para> <programlisting role="CSS"><![CDATA[... .myClass{ -font-style:italic; + font-style:italic; + font-weight:bold; } ...]]></programlisting> <para>The <emphasis><property>&quot;styleClass&quot;</property></emphasis> attribute for <emphasis role="bold" @@ -269,7 +270,7 @@ </mediaobject> </figure> - <para>As it could be seen on the picture above,the font style for items was changed.</para> + <para>As it could be seen on the picture above,the font style and the font weight for items was changed.</para> Modified: trunk/docs/userguide/en/src/main/docbook/included/toolTip.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/toolTip.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/included/toolTip.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -110,7 +110,7 @@ </mediaobject> </figure> <para> -And after <property>toolTip</property> loaded it will be changed to next one: +And after <property>toolTip</property> loaded it is changed to next one: </para> <figure> <title>&lt;rich:toolTip&gt; component with loaded content</title> Modified: trunk/docs/userguide/en/src/main/docbook/master.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/master.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/en/src/main/docbook/master.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -52,8 +52,8 @@ <!ENTITY orderingList_table SYSTEM "../../../target/generated/orderingList.xml"> <!ENTITY componentControl_table SYSTEM "../../../target/generated/componentControl.xml"> <!ENTITY columns_table SYSTEM "../../../target/generated/columns.xml"> +<!ENTITY comboBox_table SYSTEM "../../../target/generated/comboBox.xml"> - <!ENTITY coreComponents_table SYSTEM "../../../target/generated/a4j.xml"> ]> @@ -86,6 +86,7 @@ --> &coreComponents_table; &calendar_table; +&comboBox_table; &componentControl_table; &contextMenu_table; &dataFilterSlider_table; Modified: trunk/docs/userguide/en/src/main/resources/images/mpClass.png =================================================================== (Binary files differ) Added: trunk/docs/userguide/en/src/main/resources/images/orderinListClass.png =================================================================== (Binary files differ) Property changes on: trunk/docs/userguide/en/src/main/resources/images/orderinListClass.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/docs/userguide/en/src/main/resources/images/orderinListStyle.png =================================================================== (Binary files differ) Property changes on: trunk/docs/userguide/en/src/main/resources/images/orderinListStyle.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Modified: trunk/docs/userguide/en/src/main/resources/images/togglePanelClass.png =================================================================== (Binary files differ) Modified: trunk/docs/userguide/en/src/main/resources/images/togglePanelStyle.png =================================================================== (Binary files differ) Modified: trunk/docs/userguide/en/src/main/resources/images/toolBarClass.png =================================================================== (Binary files differ) Modified: trunk/docs/userguide/en/src/main/resources/images/toolBarStyle.png =================================================================== (Binary files differ) Modified: trunk/docs/userguide/pom.xml =================================================================== --- trunk/docs/userguide/pom.xml 2008-02-07 18:30:34 UTC (rev 5925) +++ trunk/docs/userguide/pom.xml 2008-02-07 18:36:49 UTC (rev 5926) @@ -1,743 +1,755 @@ -<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> - <parent> - <artifactId>docs</artifactId> - <groupId>org.richfaces</groupId> - <version>3.2.0-SNAPSHOT</version> - </parent> - <modelVersion>4.0.0</modelVersion> - <groupId>org.richfaces.docs</groupId> - <artifactId>userguide</artifactId> - <packaging>pom</packaging> - <version>3.2.0-SNAPSHOT</version> - <name>User guide</name> - <description>RichFaces user guide</description> - <pluginRepositories> - <pluginRepository> - <releases> - <enabled>true</enabled> - </releases> - <snapshots> - <enabled>false</enabled> - <updatePolicy>never</updatePolicy> - </snapshots> - <id>repository.jboss.com</id> - <name>Jboss Repository for Maven</name> - <url>http://repository.jboss.com/maven2/</url> - <layout>default</layout> - </pluginRepository> - </pluginRepositories> - <build> - <pluginManagement> - <plugins> - <plugin> - <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-dependency-plugin</artifactId> - <executions> - <execution> - <id>unpack</id> - <phase>generate-resources</phase> - <goals> - <goal>unpack</goal> - </goals> - <configuration> - <artifactItems> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId>core</artifactId> - <version> - ${project.version} - </version> - </artifactItem> - - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - calendar - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - columns - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - componentControl - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - - - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - contextMenu - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - - - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - dataFilterSlider - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - datascroller - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - dataTable - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - drag-drop - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - dropdown-menu - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId>effect</artifactId> - <version> - ${project.version} - </version> - </artifactItem> - - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId>gmap</artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - virtualEarth - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - inputnumber-slider - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - inputnumber-spinner - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - insert - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - - - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - jQuery - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - listShuttle - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - menu-components - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId>message</artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - panelmenu - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - modal-panel - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - orderingList - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId>paint2D</artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId>panel</artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - panelbar - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - scrollableDataTable - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - simpleTogglePanel - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - separator - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId>spacer</artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - suggestionbox - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - tabPanel - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId> - togglePanel - </artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId>toolBar</artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId>tooltip</artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId>tree</artifactId> - <version> - ${project.version} - </version> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId>treeModel</artifactId> - <version> - ${project.version} - </version> - </artifactItem> - - <artifactItem> - <groupId> - org.richfaces.docs.xslt - </groupId> - <artifactId> - ${translation} - </artifactId> - <version> - ${project.version} - </version> - <type>jar</type> - <overWrite>true</overWrite> - <outputDirectory> - ${project.build.directory}/xslt - </outputDirectory> - </artifactItem> - <artifactItem> - <groupId> - org.richfaces.ui - </groupId> - <artifactId>jQuery</artifactId> - <version> - ${project.version} - </version> - </artifactItem> - </artifactItems> - <outputDirectory> - ${project.build.directory}/library - </outputDirectory> - <overWriteReleases> - false - </overWriteReleases> - <overWriteSnapshots> - true - </overWriteSnapshots> - </configuration> - </execution> - </executions> - </plugin> - <plugin> - <groupId>org.codehaus.mojo</groupId> - <artifactId>xml-maven-plugin</artifactId> - <executions> - <execution> - <id>transformTld</id> - <phase>process-resources</phase> - <goals> - <goal>transform</goal> - </goals> - </execution> - </executions> - <dependencies> - <dependency> - <groupId>net.sf.saxon</groupId> - <artifactId>saxon</artifactId> - <version>8.7</version> - </dependency> - <dependency> - <groupId>org.apache.xmlgraphics</groupId> - <artifactId>fop</artifactId> - <version>0.94</version> - </dependency> - </dependencies> - <configuration> - <transformationSets> - <transformationSet> - <dir> - ${project.build.directory}/library/META-INF - </dir> - <includes> - <include>*.tld</include> - </includes> - <excludes> - <exclude>a4j.*</exclude> - </excludes> - <outputDir> - ${project.build.directory}/generated/ - </outputDir> - <stylesheet> - ${project.build.directory}/xslt/xslt/f.xsl - </stylesheet> - <fileMappers> - <fileMapper implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper"> - <targetExtension> - xml - </targetExtension> - </fileMapper> - </fileMappers> - <parameters> - <parameter> - <name>lang</name> - <value> - ..${file.separator}..${file.separator}..${file.separator}src${file.separator}main${file.separator}docbook - </value> - </parameter> - <parameter> - <name>title</name> - <value>${project.name}</value> - </parameter> - <parameter> - <name>separator</name> - <value>${file.separator}</value> - </parameter> - <parameter> - <name>prefix</name> - <value>rich</value> - </parameter> - </parameters> - </transformationSet> - <transformationSet> - <dir> - ${project.build.directory}/library/META-INF - </dir> - <includes> - <include>a4j.*</include> - </includes> - <excludes> - <exclude>*.xml</exclude> - </excludes> - <outputDir> - ${project.build.directory}/generated/ - </outputDir> - <stylesheet> - ${project.build.directory}/xslt/xslt/f.xsl - </stylesheet> - <fileMappers> - <fileMapper implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper"> - <targetExtension> - xml - </targetExtension> - </fileMapper> - </fileMappers> - <parameters> - <parameter> - <name>lang</name> - <value> - ..${file.separator}..${file.separator}..${file.separator}src${file.separator}main${file.separator}docbook - </value> - </parameter> - <parameter> - <name>title</name> - <value>${project.name}</value> - </parameter> - <parameter> - <name>separator</name> - <value>${file.separator}</value> - </parameter> - <parameter> - <name>prefix</name> - <value>a4j</value> - </parameter> - </parameters> - </transformationSet> - </transformationSets> - </configuration> - </plugin> - - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.0.0</version> - <!-- - <executions> - <execution> - <id>generate</id> - <goals> - <goal>generate</goal> - </goals> - </execution> - <execution> - <id>resources</id> - <goals> - <goal>resources</goal> - </goals> - </execution> - </executions> - --> - <dependencies> - <dependency> - <groupId>org.richfaces.docs.xslt</groupId> - <artifactId>${translation}</artifactId> - <version>${project.version}</version> - <type>jar</type> - </dependency> - <dependency> - <groupId>org.apache.xmlgraphics</groupId> - <artifactId>fop</artifactId> - <version>0.94</version> - </dependency> - </dependencies> - <configuration> - <sourceDirectory> - ${basedir}/src/main/docbook - </sourceDirectory> - <imageResource> - <directory> - ${basedir}/src/main/resources - </directory> - </imageResource> - <cssResource> - <directory> - ${basedir}/src/main/resources - </directory> - </cssResource> - <sourceDocumentName> - master.xml - </sourceDocumentName> - <formats> - - <format> - <formatName>pdf</formatName> - <stylesheetResource> - /xslt/fopdf.xsl - </stylesheetResource> - <finalName> - richfaces_reference.pdf - </finalName> - <imagePathSettingRequired> - true - </imagePathSettingRequired> - </format> - <format> - <formatName>html</formatName> - <stylesheetResource> - /xslt/html_chunk.xsl - </stylesheetResource> - <finalName>index.html</finalName> - <imageCopyingRequired> - true - </imageCopyingRequired> - <imagePathSettingRequired> - false - </imagePathSettingRequired> - </format> - - <format> - <formatName>html_single</formatName> - <stylesheetResource> - /xslt/html.xsl - </stylesheetResource> - <imageCopyingRequired> - true - </imageCopyingRequired> - <imagePathSettingRequired> - false - </imagePathSettingRequired> - <finalName> - index.html - </finalName> - - </format> - </formats> - <xincludeSupported>true</xincludeSupported> - <options> - <xincludeSupported>true</xincludeSupported> - <useRelativeImageUris> - true - </useRelativeImageUris> - <xmlTransformerType> - saxon - </xmlTransformerType> - <!-- - <transformerParameters> - <property> - <name>custom.titlepage.img</name> - <value> - ${basedir}/src/main/resources/shared/images/hibernate_logo_a.png - </value> - </property> - </transformerParameters> - --> - <docbookVersion>1.72.0</docbookVersion> - </options> - </configuration> - - </plugin> - </plugins> - </pluginManagement> - </build> - - <!-- report plugin is currently hosed - <reporting> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugin</groupId> - <artifactId>jboss-docbook-plugin</artifactId> - </plugin> - </plugins> - </reporting> - --> - <properties> - <masterTranslation>en</masterTranslation> - </properties> - - <modules> - <module>en</module> - </modules> - +<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> + <parent> + <artifactId>docs</artifactId> + <groupId>org.richfaces</groupId> + <version>3.2.0-SNAPSHOT</version> + </parent> + <modelVersion>4.0.0</modelVersion> + <groupId>org.richfaces.docs</groupId> + <artifactId>userguide</artifactId> + <packaging>pom</packaging> + <version>3.2.0-SNAPSHOT</version> + <name>User guide</name> + <description>RichFaces user guide</description> + <pluginRepositories> + <pluginRepository> + <releases> + <enabled>true</enabled> + </releases> + <snapshots> + <enabled>false</enabled> + <updatePolicy>never</updatePolicy> + </snapshots> + <id>repository.jboss.com</id> + <name>Jboss Repository for Maven</name> + <url>http://repository.jboss.com/maven2/</url> + <layout>default</layout> + </pluginRepository> + </pluginRepositories> + <build> + <pluginManagement> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-dependency-plugin</artifactId> + <executions> + <execution> + <id>unpack</id> + <phase>generate-resources</phase> + <goals> + <goal>unpack</goal> + </goals> + <configuration> + <artifactItems> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId>core</artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + calendar + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + columns + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + comboBox + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + componentControl + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + contextMenu + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + dataFilterSlider + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + datascroller + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + dataTable + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + drag-drop + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + dropdown-menu + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId>effect</artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId>gmap</artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + virtualEarth + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + inputnumber-slider + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + inputnumber-spinner + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + insert + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + jQuery + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + listShuttle + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + menu-components + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId>message</artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + panelmenu + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + modal-panel + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + orderingList + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId>paint2D</artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId>panel</artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + panelbar + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + scrollableDataTable + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + simpleTogglePanel + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + separator + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId>spacer</artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + suggestionbox + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + tabPanel + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId> + togglePanel + </artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId>toolBar</artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId>tooltip</artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId>tree</artifactId> + <version> + ${project.version} + </version> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId>treeModel</artifactId> + <version> + ${project.version} + </version> + </artifactItem> + + <artifactItem> + <groupId> + org.richfaces.docs.xslt + </groupId> + <artifactId> + ${translation} + </artifactId> + <version> + ${project.version} + </version> + <type>jar</type> + <overWrite>true</overWrite> + <outputDirectory> + ${project.build.directory}/xslt + </outputDirectory> + </artifactItem> + <artifactItem> + <groupId> + org.richfaces.ui + </groupId> + <artifactId>jQuery</artifactId> + <version> + ${project.version} + </version> + </artifactItem> + </artifactItems> + <outputDirectory> + ${project.build.directory}/library + </outputDirectory> + <overWriteReleases> + false + </overWriteReleases> + <overWriteSnapshots> + true + </overWriteSnapshots> + </configuration> + </execution> + </executions> + </plugin> + <plugin> + <groupId>org.codehaus.mojo</groupId> + <artifactId>xml-maven-plugin</artifactId> + <executions> + <execution> + <id>transformTld</id> + <phase>process-resources</phase> + <goals> + <goal>transform</goal> + </goals> + </execution> + </executions> + <dependencies> + <dependency> + <groupId>net.sf.saxon</groupId> + <artifactId>saxon</artifactId> + <version>8.7</version> + </dependency> + <dependency> + <groupId>org.apache.xmlgraphics</groupId> + <artifactId>fop</artifactId> + <version>0.94</version> + </dependency> + </dependencies> + <configuration> + <transformationSets> + <transformationSet> + <dir> + ${project.build.directory}/library/META-INF + </dir> + <includes> + <include>*.tld</include> + </includes> + <excludes> + <exclude>a4j.*</exclude> + </excludes> + <outputDir> + ${project.build.directory}/generated/ + </outputDir> + <stylesheet> + ${project.build.directory}/xslt/xslt/f.xsl + </stylesheet> + <fileMappers> + <fileMapper implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper"> + <targetExtension> + xml + </targetExtension> + </fileMapper> + </fileMappers> + <parameters> + <parameter> + <name>lang</name> + <value> + ..${file.separator}..${file.separator}..${file.separator}src${file.separator}main${file.separator}docbook + </value> + </parameter> + <parameter> + <name>title</name> + <value>${project.name}</value> + </parameter> + <parameter> + <name>separator</name> + <value>${file.separator}</value> + </parameter> + <parameter> + <name>prefix</name> + <value>rich</value> + </parameter> + </parameters> + </transformationSet> + <transformationSet> + <dir> + ${project.build.directory}/library/META-INF + </dir> + <includes> + <include>a4j.*</include> + </includes> + <excludes> + <exclude>*.xml</exclude> + </excludes> + <outputDir> + ${project.build.directory}/generated/ + </outputDir> + <stylesheet> + ${project.build.directory}/xslt/xslt/f.xsl + </stylesheet> + <fileMappers> + <fileMapper implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper"> + <targetExtension> + xml + </targetExtension> + </fileMapper> + </fileMappers> + <parameters> + <parameter> + <name>lang</name> + <value> + ..${file.separator}..${file.separator}..${file.separator}src${file.separator}main${file.separator}docbook + </value> + </parameter> + <parameter> + <name>title</name> + <value>${project.name}</value> + </parameter> + <parameter> + <name>separator</name> + <value>${file.separator}</value> + </parameter> + <parameter> + <name>prefix</name> + <value>a4j</value> + </parameter> + </parameters> + </transformationSet> + </transformationSets> + </configuration> + </plugin> + + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.0.0</version> + <!-- + <executions> + <execution> + <id>generate</id> + <goals> + <goal>generate</goal> + </goals> + </execution> + <execution> + <id>resources</id> + <goals> + <goal>resources</goal> + </goals> + </execution> + </executions> + --> + <dependencies> + <dependency> + <groupId>org.richfaces.docs.xslt</groupId> + <artifactId>${translation}</artifactId> + <version>${project.version}</version> + <type>jar</type> + </dependency> + <dependency> + <groupId>org.apache.xmlgraphics</groupId> + <artifactId>fop</artifactId> + <version>0.94</version> + </dependency> + </dependencies> + <configuration> + <sourceDirectory> + ${basedir}/src/main/docbook + </sourceDirectory> + <imageResource> + <directory> + ${basedir}/src/main/resources + </directory> + </imageResource> + <cssResource> + <directory> + ${basedir}/src/main/resources + </directory> + </cssResource> + <sourceDocumentName> + master.xml + </sourceDocumentName> + <formats> + + <format> + <formatName>pdf</formatName> + <stylesheetResource> + /xslt/fopdf.xsl + </stylesheetResource> + <finalName> + richfaces_reference.pdf + </finalName> + <imagePathSettingRequired> + true + </imagePathSettingRequired> + </format> + <format> + <formatName>html</formatName> + <stylesheetResource> + /xslt/html_chunk.xsl + </stylesheetResource> + <finalName>index.html</finalName> + <imageCopyingRequired> + true + </imageCopyingRequired> + <imagePathSettingRequired> + false + </imagePathSettingRequired> + </format> + + <format> + <formatName>html_single</formatName> + <stylesheetResource> + /xslt/html.xsl + </stylesheetResource> + <imageCopyingRequired> + true + </imageCopyingRequired> + <imagePathSettingRequired> + false + </imagePathSettingRequired> + <finalName> + index.html + </finalName> + + </format> + </formats> + <xincludeSupported>true</xincludeSupported> + <options> + <xincludeSupported>true</xincludeSupported> + <useRelativeImageUris> + true + </useRelativeImageUris> + <xmlTransformerType> + saxon + </xmlTransformerType> + <!-- + <transformerParameters> + <property> + <name>custom.titlepage.img</name> + <value> + ${basedir}/src/main/resources/shared/images/hibernate_logo_a.png + </value> + </property> + </transformerParameters> + --> + <docbookVersion>1.72.0</docbookVersion> + </options> + </configuration> + + </plugin> + </plugins> + </pluginManagement> + </build> + + <!-- report plugin is currently hosed + <reporting> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugin</groupId> + <artifactId>jboss-docbook-plugin</artifactId> + </plugin> + </plugins> + </reporting> + --> + <properties> + <masterTranslation>en</masterTranslation> + </properties> + + <modules> + <module>en</module> + </modules> + </project> \ No newline at end of file