Author: artdaw Date: 2008-04-17 11:46:50 -0400 (Thu, 17 Apr 2008) New Revision: 7899 Added: 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/menuJSF.xml trunk/docs/migrationguide/en/src/main/docbook/included/resource.xml Modified: trunk/docs/migrationguide/en/src/main/docbook/included/i18n.xml trunk/docs/migrationguide/en/src/main/docbook/master.xml trunk/docs/migrationguide/en/src/main/docbook/modules/scope.xml Log: http://jira.jboss.com/jira/browse/RF-3048 - new sections were added Added: trunk/docs/migrationguide/en/src/main/docbook/included/binding.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/binding.xml (rev 0) +++ trunk/docs/migrationguide/en/src/main/docbook/included/binding.xml 2008-04-17 15:46:50 UTC (rev 7899) @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="binding"> + <sectioninfo> + <keywordset> + <keyword>binding</keyword> + <keyword>JSP</keyword> + </keywordset> + </sectioninfo> + <title>Binding problem in JSP</title> + <section> + <title>Description</title> + <para> + Binding does not work for all components in JSP. + It is impossible to use <emphasis><property>&quot;binding&quot;</property></emphasis> attribute for + RichFaces components. Wrong class-name is used in TLD generated from XML configuration files. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2918 ">Jira</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> + Just using binding attribute. +</para> + </section> + <section> + <title>Causes</title> + <para> + There was <code>&lt;classname&gt;java.lang.String&lt;/classname&gt;</code> instead of <code>&lt;classname&gt;javax.faces.component.UIComponent&lt;/classname&gt;</code> in configuration files. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + The decision is to use <property>Facelets</property> upgrade to <ulink url=" http://www.jboss.org/jbossrichfaces/downloads/">RichFaces 3.2.0 SP1</ulink> + </para> + </section> + +</section> \ No newline at end of file Added: trunk/docs/migrationguide/en/src/main/docbook/included/explicitId.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/explicitId.xml (rev 0) +++ trunk/docs/migrationguide/en/src/main/docbook/included/explicitId.xml 2008-04-17 15:46:50 UTC (rev 7899) @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="explicitId"> + <sectioninfo> + <keywordset> + <keyword>explicit</keyword> + <keyword>id</keyword> + </keywordset> + </sectioninfo> + <title>Ajax requests in JSF 1.2</title> + <section> + <title>Description</title> + <para> + Ajax requests stop to work without any errors shown when intensive Ajax traffic is expected. No error or other diagnostic presents. + </para> + </section> + <section> + <title>How to reproduce</title> + <para> + Do not define an <property>id</property> for Ajax command component. + </para> + <programlisting role="XML"><![CDATA[... + <h:form> + <h:panelGrid columns="2"> + <h:inputText id="myinput" value="#{userBean.name}"> + <a4j:support event="onkeyup" reRender="outtext" /> + </h:inputText> + <h:outputText id="outtext" value="#{userBean.name}" /> + </h:panelGrid> + </h:form> +...]]></programlisting> + </section> + <section> + <title>Causes</title> + <para> + This is a specific of the dynamic id generation of the JSF 1.2 implementation. + In case of simultaneous request processing, the id of the command component becomes <property>out-of-sync</property> + with id of the same component on the page. After that any Ajax requests from the component with old id just do not process. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + You should define the <property>id</property> for the command component and parent namespace components + (<emphasis role="bold"><property>&lt;h:form&gt;</property></emphasis>, + <emphasis role="bold"><property>&lt;f:subview&gt;</property></emphasis>, + <emphasis role="bold"><property>&lt;h:dataTable&gt;</property></emphasis> and so on) explicitly. + As soon as this is a core JSF 1.2 functionality, the problem cannot be solved on the <property>RichFaces</property> level. + </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-17 15:30:42 UTC (rev 7898) +++ trunk/docs/migrationguide/en/src/main/docbook/included/i18n.xml 2008-04-17 15:46:50 UTC (rev 7899) @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8"?> -<section> +<section id="i18n"> <sectioninfo> <keywordset> <keyword>i18n</keyword> @@ -38,7 +38,7 @@ <option value="An Gajdov& aacute;">An Gajdov& aacute;</option> ... </select> -]]></programlisting> +...]]></programlisting> </section> <section> <title>Causes</title> @@ -50,7 +50,7 @@ <section> <title>Workarounds</title> <para> - The decision is to upgrade to <ulink url=" http://www.jboss.org/jbossrichfaces/downloads/">RichFaces 3.2.0 SP1</ulink> + The decision is to upgrade to <ulink url="http://www.jboss.org/jbossrichfaces/downloads/">RichFaces 3.2.0 SP1</ulink> </para> </section> Added: trunk/docs/migrationguide/en/src/main/docbook/included/menuJSF.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/menuJSF.xml (rev 0) +++ trunk/docs/migrationguide/en/src/main/docbook/included/menuJSF.xml 2008-04-17 15:46:50 UTC (rev 7899) @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section> + <sectioninfo> + <keywordset> + <keyword>JSF-RI-1.2_08</keyword> + <keyword></keyword> + </keywordset> + </sectioninfo> + <title>Menu components and JSF-RI-1.2_08</title> + <section> + <title>Description</title> + <para> + Menu components are not working with JSF-RI-1.2_08: + </para> + <itemizedlist> + <listitem> + <para> + The <emphasis role="bold"><property>&lt;rich:contextMenu&gt;</property></emphasis> component is not invoked by the right mouse click + </para> + </listitem> + <listitem> + <para> + The <emphasis role="bold"><property>&lt;rich:dropDownMenu&gt;</property></emphasis> component causes the exception with showing XHTML invalid output + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="https://javaserverfaces.dev.java.net/issues/show_bug.cgi?id=717 ">JavaServer Faces issues</ulink> + </para> + </listitem> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2637 ">Jira</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> + Having JSF-RI 1.2_08 and menu components on a page. + </para> + </section> + <section> + <title>Causes</title> + <para> + Critical bug in JSF-RI 1.2_08. Already fixed for the further released there. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + Downgrade to <ulink url="https://javaserverfaces.dev.java.net/servlets/ProjectDocumentLi... 1.2_07</ulink> + or use recent <ulink url="https://javaserverfaces.dev.java.net/servlets/ProjectDocumentLi... SNAPSHOT</ulink>. + </para> + </section> + +</section> \ No newline at end of file Added: trunk/docs/migrationguide/en/src/main/docbook/included/resource.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/resource.xml (rev 0) +++ trunk/docs/migrationguide/en/src/main/docbook/included/resource.xml 2008-04-17 15:46:50 UTC (rev 7899) @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="resource"> + <sectioninfo> + <keywordset> + <keyword>resource</keyword> + <keyword>skinning</keyword> + </keywordset> + </sectioninfo> + <title>Resources for standard skinning classes</title> + <section> + <title>Description</title> + <para> + When standard skinning classes or background images are inaccessible + &quot;Resource not registered : org.richfaces.renderkit.html.images.InputBackgroundImage&quot; (another name is possible) exception appears in server log. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2944 ">Jira</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>Usually reproduced after server restart when user refreshes page</para> + </section> + <section> + <title>Causes</title> + <para> + Resources for standard skinning classes haven&apos;t been registered during <property>RichFaces</property> library build + </para> + </section> + + <section> + <title>Workarounds</title> + <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> + <param-value>disable</param-value> +</context-param> +...]]></programlisting> +<para> + Add <ulink url="http://docs.google.com/View?docid=dqk93fg_3ggsznfz5">ME... to the application classpath. +</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-17 15:30:42 UTC (rev 7898) +++ trunk/docs/migrationguide/en/src/main/docbook/master.xml 2008-04-17 15:46:50 UTC (rev 7899) @@ -6,6 +6,10 @@ <!ENTITY req SYSTEM "modules/req.xml"> <!ENTITY i18n SYSTEM "included/i18n.xml"> + <!ENTITY menuJSF SYSTEM "included/menuJSF.xml"> + <!ENTITY binding SYSTEM "included/binding.xml"> + <!ENTITY explicitId SYSTEM "included/explicitId.xml"> + <!ENTITY resource SYSTEM "included/resource.xml"> ]> <book> <bookinfo> @@ -23,14 +27,37 @@ &req; <chapter role="NotInToc" id="RichFacesMigrationIssues" xreflabel="RichFacesMigrationIssues"> <?dbhtml filename="RichFacesMigrationIssues.html"?> - + <chapterinfo> + <keywordset> + <keyword>RichFaces</keyword> + <keyword>Migration Guide</keyword> + </keywordset> + </chapterinfo> <title>The RichFaces Migration Issues</title> + <para> This chapter includes only the issue with migration from previous versions to 3.2.0. 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> + <keywordset> + <keyword>important</keyword> + <keyword>issues</keyword> + </keywordset> + </sectioninfo> + <title>Most important</title> + &i18n; + &menuJSF; + &binding; + &explicitId; + &resource; + </section> + </chapter> </book> Modified: trunk/docs/migrationguide/en/src/main/docbook/modules/scope.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/modules/scope.xml 2008-04-17 15:30:42 UTC (rev 7898) +++ trunk/docs/migrationguide/en/src/main/docbook/modules/scope.xml 2008-04-17 15:46:50 UTC (rev 7899) @@ -27,7 +27,7 @@ </listitem> <listitem> <para> - Concepts related to Web or application servers configuration is beyond the scope of this document + Concepts related to Web or application servers configuration, JSF, JSF implementations are beyond the scope of this document </para> </listitem> </itemizedlist>