[richfaces-svn-commits] JBoss Rich Faces SVN: r7955 - in trunk/docs/migrationguide/en/src/main/docbook: included and 1 other directory.

Author: artdaw Date: 2008-04-19 10:44:52 -0400 (Sat, 19 Apr 2008) New Revision: 7955 Added: trunk/docs/migrationguide/en/src/main/docbook/included/ajaxSingleFacets.xml trunk/docs/migrationguide/en/src/main/docbook/included/calendarDate.xml trunk/docs/migrationguide/en/src/main/docbook/included/datascrollerFor.xml trunk/docs/migrationguide/en/src/main/docbook/included/datascrollerPaired.xml trunk/docs/migrationguide/en/src/main/docbook/included/fileUploadListener.xml trunk/docs/migrationguide/en/src/main/docbook/included/myfaces.xml trunk/docs/migrationguide/en/src/main/docbook/included/seamMultipartFilter.xml Modified: trunk/docs/migrationguide/en/src/main/docbook/included/binding.xml trunk/docs/migrationguide/en/src/main/docbook/included/explicitId.xml trunk/docs/migrationguide/en/src/main/docbook/included/i18n.xml trunk/docs/migrationguide/en/src/main/docbook/included/menuJSF.xml trunk/docs/migrationguide/en/src/main/docbook/included/resource.xml trunk/docs/migrationguide/en/src/main/docbook/master.xml Log: http://jira.jboss.com/jira/browse/RF-3048 - All sections were added according to doc attached Added: trunk/docs/migrationguide/en/src/main/docbook/included/ajaxSingleFacets.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/ajaxSingleFacets.xml (rev 0) +++ trunk/docs/migrationguide/en/src/main/docbook/included/ajaxSingleFacets.xml 2008-04-19 14:44:52 UTC (rev 7955) @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="ajaxSingleFacets"> + <?dbhtml filename="ajaxSingleFacets.html"?> + <sectioninfo> + <keywordset> + <keyword>ajaxSingle</keyword> + <keyword>facet</keyword> + <keyword>static</keyword> + </keywordset> + </sectioninfo> + <title>The ajaxSingle/region components in facets of &lt;h:dataTable&gt;</title> + <section> + <title>Description</title> + <para> + The <property>RichFaces</property> components that have + <emphasis><property>&quot;ajaxSingle&quot;</property></emphasis> = &quot;true&quot; will not work in + <emphasis><property>&quot;header&quot;</property></emphasis> or <emphasis><property>&quot;footer&quot;</property></emphasis> facets + of <emphasis role="bold"><property>&lt;h:dataTable&gt;</property></emphasis>, e.g. + <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> won't scroll. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2696">Jira</uli... + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>How to reproduce</title> + <para> + Just add the following code. The <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> component will not work: + </para> + <programlisting role="XML"><![CDATA[... +<h:dataTable> + <f:facet name="header"> + <rich:datascroller ajaxSingle="true"/> + </f:facet> + ... +</h:dataTable> +...]]></programlisting> + </section> + <section> + <title>Causes</title> + <para> + The ajaxSingle/region requires <code>invokeOnComponent()</code> to work properly. For more details, please, + see <ulink url="https://javaserverfaces.dev.java.net/issues/show_bug.cgi?id=718... Faces issues reporting</ulink> page. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + Use <emphasis role="bold"><property>&lt;rich:dataTable&gt;</property></emphasis> component. + </para> + </section> +</section> \ No newline at end of file Modified: trunk/docs/migrationguide/en/src/main/docbook/included/binding.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/binding.xml 2008-04-19 13:36:58 UTC (rev 7954) +++ trunk/docs/migrationguide/en/src/main/docbook/included/binding.xml 2008-04-19 14:44:52 UTC (rev 7955) @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> <section id="binding"> + <?dbhtml filename="binding.html"?> <sectioninfo> <keywordset> <keyword>binding</keyword> Added: trunk/docs/migrationguide/en/src/main/docbook/included/calendarDate.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/calendarDate.xml (rev 0) +++ trunk/docs/migrationguide/en/src/main/docbook/included/calendarDate.xml 2008-04-19 14:44:52 UTC (rev 7955) @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="calendarDate"> + <?dbhtml filename="calendarDate.html"?> + <sectioninfo> + <keywordset> + <keyword>calendar</keyword> + <keyword>date</keyword> + <keyword>ondateselected</keyword> + </keywordset> + </sectioninfo> + <title>&lt;rich:calendar&gt; and &quot;ondateselected&quot; event problem</title> + <section> + <title>Description</title> + <para> + The <emphasis role="bold"><property>&lt;rich:calendar&gt;</property></emphasis> date selected event is fired before input update. + </para> + <para> + After <property>time</property> and <property>apply</property> elements have been added to calendar + <emphasis><property>&quot;ondateselected&quot;</property></emphasis> gets fired after date selected but before updated in input. + Now we have three events instead of one. But it causes compatibility problem because this event was used by customers to save selected value via Ajax. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... Forum</ulink> + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>How to reproduce</title> + <para> + Put <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> inside <emphasis role="bold"><property>&lt;rich:calendar&gt;</property></emphasis>. + If the <emphasis><property>&quot;event&quot;</property></emphasis> property is &quot;ondateselected&quot; + previous value of the <emphasis role="bold"><property>&lt;rich:calendar&gt;</property></emphasis> is stored after selection. + </para> + </section> + <section> + <title>Causes</title> + <para> + Events firing sequence was changed. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + You need <emphasis><property>&quot;onchanged&quot;</property></emphasis> event is fired after any change which causes input to be updated, both date and time. + </para> + <para> + Notice, that + </para> + <itemizedlist> + <listitem> + <para> + <emphasis><property>&quot;ondateselected&quot;</property></emphasis> event is fired after date is selected in popup + </para> + </listitem> + <listitem> + <para> + <emphasis><property>&quot;ontimechanged&quot;</property></emphasis> event is fired after new time is selected. + </para> + </listitem> + </itemizedlist> + </section> +</section> \ No newline at end of file Added: trunk/docs/migrationguide/en/src/main/docbook/included/datascrollerFor.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/datascrollerFor.xml (rev 0) +++ trunk/docs/migrationguide/en/src/main/docbook/included/datascrollerFor.xml 2008-04-19 14:44:52 UTC (rev 7955) @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="datascrollerFor"> + <?dbhtml filename="datascrollerFor.html"?> + <sectioninfo> + <keywordset> + <keyword>datascroller</keyword> + <keyword>for</keyword> + <keyword>static</keyword> + </keywordset> + </sectioninfo> + <title>Static <emphasis>&quot;for&quot;</emphasis> attribute in &lt;rich:datascroller&gt;</title> + <section> + <title>Description</title> + <para> + The <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> component&apos;s + <emphasis><property>&quot;for&quot;</property></emphasis> attribute doesn&apos;t allow EL expressions in 3.2.0.GA. + </para> + <para> + Custom tags exploiting the ability of the <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> to have dynamic + <emphasis><property>&quot;for&quot;</property></emphasis> attribute doesn&apos;t work. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2923">Jira</uli... + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>How to reproduce</title> + <para> + Just add the following code, that will not work: + </para> + <programlisting role="XML"><![CDATA[... +<rich:datascroller for="#{bean.property}"/> +...]]></programlisting> + </section> + <section> + <title>Causes</title> + <para> + Please, see <ulink url="http://jira.jboss.com/jira/browse/RF-1133">Jira</uli... + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + None for no + </para> + </section> +</section> \ No newline at end of file Added: trunk/docs/migrationguide/en/src/main/docbook/included/datascrollerPaired.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/datascrollerPaired.xml (rev 0) +++ trunk/docs/migrationguide/en/src/main/docbook/included/datascrollerPaired.xml 2008-04-19 14:44:52 UTC (rev 7955) @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="datascrollerPaired"> + <?dbhtml filename="datascrollerPaired.html"?> + <sectioninfo> + <keywordset> + <keyword>datascroller</keyword> + <keyword>paired</keyword> + <keyword>page</keyword> + </keywordset> + </sectioninfo> + <title>Paired &lt;rich:datascroller&gt; components aren&apos;t work</title> + <section> + <title>Description</title> + <para> + Two <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> components bound to the same table aren&apos;t synchronized. + Storing data component in session-scoped beans no more saves <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> state. + It is a common pattern to have 2 <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> components: + the first in header, the second in footer. The first will not work. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2970">Jira</uli... + </para> + </listitem> + <listitem> + <para> + <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... Forum</ulink> + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>How to reproduce</title> + <para> + Add 2 <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> components to any table. + </para> + </section> + <section> + <title>Causes</title> + <para> + The <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> component is now responsible for managing data table&apos;s scroll state. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + The decision is to use <emphasis><property>&quot;page&quot;</property></emphasis> attribute and bind it to the same property for all + <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> components. + </para> + </section> + +</section> \ No newline at end of file Modified: trunk/docs/migrationguide/en/src/main/docbook/included/explicitId.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/explicitId.xml 2008-04-19 13:36:58 UTC (rev 7954) +++ trunk/docs/migrationguide/en/src/main/docbook/included/explicitId.xml 2008-04-19 14:44:52 UTC (rev 7955) @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> <section id="explicitId"> + <?dbhtml filename="explicitId.html"?> <sectioninfo> <keywordset> <keyword>explicit</keyword> Added: trunk/docs/migrationguide/en/src/main/docbook/included/fileUploadListener.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/fileUploadListener.xml (rev 0) +++ trunk/docs/migrationguide/en/src/main/docbook/included/fileUploadListener.xml 2008-04-19 14:44:52 UTC (rev 7955) @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="fileUploadListener"> + <?dbhtml filename="fileUploadListener.html"?> + <sectioninfo> + <keywordset> + <keyword>fileUpload</keyword> + <keyword>listener</keyword> + </keywordset> + </sectioninfo> + <title><emphasis>&quot;fileUploadListener&quot;</emphasis> with MyFaces or JSF-RI 1.2_04</title> + <section> + <title>Description</title> + <para> + The <emphasis><property>&quot;fileUploadListener&quot;</property></emphasis>(UploadEvent event) is not invoked + when <property>MyFaces</property> or <property>JSF-RI 1.2_04</property> is used. But file is uploaded successfully. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2935">Jira(for MyFaces)</ulink> + </para> + </listitem> + <listitem> + <para> + <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... Forum</ulink> + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>How to reproduce</title> + <para> + <property>MyFaces</property> or <property>JSF-RI 1.2_04</property> with default configuration + </para> + </section> + <section> + <title>Causes</title> + <para> + In case <property>MyFaces</property> <code>org.apache.myfaces.CHECK_EXTENSIONS_FILTER</code> parameter is set to &quot;true&quot;. + This parameter checks if the extensions-filter has been properly configured. + </para> + <para> + Why using <property>JSF-RI 1.2_04</property> causes the problem is not yet examined. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + To avoid generation of errors from <property>MyFaces</property> in case of invalid filter configuration + you could set up the following parameters in <property>web.xml</property>: + </para> + <programlisting role="XML"><![CDATA[... +<context-param> + <param-name>org.apache.myfaces.CHECK_EXTENSIONS_FILTER</param-name> + <param-value>false</param-value> +</context-param> +...]]></programlisting> + <para> + In case of JSF 1.2_04, upgrading to <ulink url="https://javaserverfaces.dev.java.net/servlets/ProjectDocumentLi... 1.2_07</ulink> + (last stable version) works. + </para> + </section> +</section> \ No newline at end of file Modified: trunk/docs/migrationguide/en/src/main/docbook/included/i18n.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/i18n.xml 2008-04-19 13:36:58 UTC (rev 7954) +++ trunk/docs/migrationguide/en/src/main/docbook/included/i18n.xml 2008-04-19 14:44:52 UTC (rev 7955) @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> <section id="i18n"> + <?dbhtml filename="i18n.html"?> <sectioninfo> <keywordset> <keyword>i18n</keyword> @@ -18,7 +19,7 @@ <itemizedlist> <listitem> <para> - <ulink url="http://jira.jboss.com/jira/browse/RF-2962 ">Jira</ulink> + <ulink url="http://jira.jboss.com/jira/browse/RF-2962">Jira</uli... </para> </listitem> <listitem> Modified: trunk/docs/migrationguide/en/src/main/docbook/included/menuJSF.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/menuJSF.xml 2008-04-19 13:36:58 UTC (rev 7954) +++ trunk/docs/migrationguide/en/src/main/docbook/included/menuJSF.xml 2008-04-19 14:44:52 UTC (rev 7955) @@ -3,7 +3,7 @@ <sectioninfo> <keywordset> <keyword>JSF-RI-1.2_08</keyword> - <keyword></keyword> + <keyword>menu</keyword> </keywordset> </sectioninfo> <title>Menu components and JSF-RI-1.2_08</title> Added: trunk/docs/migrationguide/en/src/main/docbook/included/myfaces.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/myfaces.xml (rev 0) +++ trunk/docs/migrationguide/en/src/main/docbook/included/myfaces.xml 2008-04-19 14:44:52 UTC (rev 7955) @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="myfaces"> + <?dbhtml filename="myfaces.html"?> + <sectioninfo> + <keywordset> + <keyword>MyFaces</keyword> + <keyword>RichFaces</keyword> + <keyword>WebLogic</keyword> + </keywordset> + </sectioninfo> + <title>RichFaces 3.2.0 with MyFaces 1.2.2 on WebLogic 10 MP1</title> + <section> + <title>Description</title> + <para> + If you try to use <property>RichFaces 3.2.0</property> with <property>MyFaces 1.2.2</property> on a + <property>WebLogic 10 MP1</property> server the following error appears: + </para> + <programlisting role="JAVA"><![CDATA[java.lang.IllegalStateException: Servlet response already use stream, Writer not possible +...]]></programlisting> + + + <para> + The same project works on <property>Tomcat 6.016</property>, <property>Tomcat 5.5.25</property> + <property>WebLogic 10MP1</property> with <property>RichFaces 3.1.4</property>. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... Forum</ulink> + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>How to reproduce</title> + <para> + Use the environment mentioned above. + </para> + </section> + <section> + <title>Causes</title> + <para> + Unknown. Possible problem with <property>MyFaces</property> on <property>WebLogic 10MP1</property>. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + Switching to <ulink url="https://javaserverfaces.dev.java.net/servlets/ProjectDocumentLi... 1.2_07</ulink> + fix the problem (see forum post) + </para> + </section> +</section> \ No newline at end of file Modified: trunk/docs/migrationguide/en/src/main/docbook/included/resource.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/resource.xml 2008-04-19 13:36:58 UTC (rev 7954) +++ trunk/docs/migrationguide/en/src/main/docbook/included/resource.xml 2008-04-19 14:44:52 UTC (rev 7955) @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> <section id="resource"> + <?dbhtml filename="resource.html"?> <sectioninfo> <keywordset> <keyword>resource</keyword> @@ -43,8 +44,8 @@ <section> <title>Workarounds</title> <para> - Switch off standard skinning classes by setting initial parameter in <property>web.xml</property> - </para>: + Switch off standard skinning classes by setting initial parameter in <property>web.xml</property>: + </para> <programlisting role="XML"><![CDATA[... <context-param> <param-name>org.richfaces.CONTROL_SKINNING_CLASSES</param-name> Added: trunk/docs/migrationguide/en/src/main/docbook/included/seamMultipartFilter.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/seamMultipartFilter.xml (rev 0) +++ trunk/docs/migrationguide/en/src/main/docbook/included/seamMultipartFilter.xml 2008-04-19 14:44:52 UTC (rev 7955) @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="seamMultipartFilter"> + <?dbhtml filename="seamMultipartFilter.html"?> + <sectioninfo> + <keywordset> + <keyword>rich:fileUpload</keyword> + <keyword>Seam</keyword> + <keyword>multi-part</keyword> + <keyword>filter</keyword> + </keywordset> + </sectioninfo> + <title>&lt;rich:fileUpload&gt; with Seam multi-part filter</title> + <section> + <title>Description</title> + <para> + The <emphasis role="bold"><property>&lt;rich:fileUpload&gt;</property></emphasis> component does not work with <property>Seam</property> multi-part filter. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... Forum</ulink> + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>How to reproduce</title> + <para> + Use the <emphasis role="bold"><property>&lt;rich:fileUpload&gt;</property></emphasis> component and <property>Seam</property> multi-part filter at the same time. + </para> + </section> + <section> + <title>Causes</title> + <para> + Lack of specification on the <property>Servlet</property> level does not allow to use stuff doing the same thing. One of them should be turned off. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + Turn the <property>Seam</property> multi-part filter off. + </para> + </section> +</section> \ No newline at end of file Modified: trunk/docs/migrationguide/en/src/main/docbook/master.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/master.xml 2008-04-19 13:36:58 UTC (rev 7954) +++ trunk/docs/migrationguide/en/src/main/docbook/master.xml 2008-04-19 14:44:52 UTC (rev 7955) @@ -10,6 +10,15 @@ <!ENTITY binding SYSTEM "included/binding.xml"> <!ENTITY explicitId SYSTEM "included/explicitId.xml"> <!ENTITY resource SYSTEM "included/resource.xml"> + + <!ENTITY calendarDate SYSTEM "included/calendarDate.xml"> + <!ENTITY datascrollerPaired SYSTEM "included/datascrollerPaired.xml"> + <!ENTITY datascrollerFor SYSTEM "included/datascrollerFor.xml"> + <!ENTITY ajaxSingleFacets SYSTEM "included/ajaxSingleFacets.xml"> + + <!ENTITY fileUploadListener SYSTEM "included/fileUploadListener.xml"> + <!ENTITY myfaces SYSTEM "included/myfaces.xml"> + <!ENTITY seamMultipartFilter SYSTEM "included/seamMultipartFilter.xml"> ]> <book> <bookinfo> @@ -40,7 +49,7 @@ Issues with new components and other problems are not included. The <ulink url="http://jira.jboss.com/jira/browse/RF">Jira</ulink> contains everything. </para> - + <section id="MostImportant"> <?dbhtml filename="MostImportant.html"?> <sectioninfo> @@ -50,14 +59,45 @@ </keywordset> </sectioninfo> <title>Most important</title> - + + &i18n; + &menuJSF; + &binding; + &explicitId; + &resource; + </section> - &i18n; - &menuJSF; - &binding; - &explicitId; - &resource; + <section id="PreviousVersions"> + <?dbhtml filename="PreviousVersions.html"?> + <sectioninfo> + <keywordset> + <keyword>upgrade</keyword> + <keyword>previous</keyword> + <keyword>version</keyword> + </keywordset> + </sectioninfo> + <title>Issues with upgrading from previous versions</title> + + &calendarDate; + &datascrollerPaired; + &datascrollerFor; + &ajaxSingleFacets; </section> - + + <section id="ThirdPartyFrameworks"> + <?dbhtml filename="ThirdPartyFrameworks.html"?> + <sectioninfo> + <keywordset> + <keyword>third</keyword> + <keyword>party</keyword> + <keyword>frameworks</keyword> + </keywordset> + </sectioninfo> + <title>Issues with compatibility with third party frameworks</title> + + &fileUploadListener; + &myfaces; + &seamMultipartFilter; + </section> </chapter> </book>