<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN"
"http://www.docbook.org/xml/4.3CR3/docbookx.dtd" [
	<!ENTITY intro SYSTEM "modules/intro.xml">
	<!ENTITY scope SYSTEM "modules/scope.xml">
	<!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">
	
	<!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 actionparam SYSTEM "included/actionparam.xml">
	<!ENTITY immediate SYSTEM "included/immediate.xml">
	
	
	<!ENTITY fileUploadListener SYSTEM "included/fileUploadListener.xml">
	<!ENTITY myfaces SYSTEM "included/myfaces.xml">
	<!ENTITY seamMultipartFilter SYSTEM "included/seamMultipartFilter.xml">
	

	<!ENTITY dataTableAjax SYSTEM "included/dataTableAjax.xml">
	
]>
<book>
	<bookinfo>
		<title>RichFaces Migration Guide</title>
		<author>
			<firstname>Gleb</firstname>
			<surname>Galkin</surname>
			<email>ggalkin@exadel.com</email>
		</author>   
		<copyright>
			<year>2008</year>
			<holder>Red Hat</holder>
		</copyright>
<abstract>
   <title/>
       <para>
           <ulink url="../pdf/richfaces_migration_guide.pdf">PDF version</ulink>
       </para>
</abstract>

	</bookinfo>
	
	<toc/>  

	&intro;
	&scope;
	&req;	  
	
	<chapter id="RichFacesMigrationIssues31to32" xreflabel="RichFacesMigrationIssues31to32">
		<?dbhtml filename="RichFacesMigrationIssues31to32.html"?>
		<chapterinfo>
			<keywordset>
				<keyword>RichFaces</keyword>
				<keyword>Migration Guide</keyword>
			</keywordset>
		</chapterinfo>
		<title>The RichFaces Migration Issues 3.1.x - 3.2.0</title>

		<para>
			This chapter includes only those issues that concern migration from from 3.1.x versions to 3.2.0. 
			Issues, related to the new components and other problems are not covered here. 
			However, <ulink url="http://jira.jboss.com/jira/browse/RF">Jira</ulink> contains all issues 
			and if you can not find your case there, please, feel free to report it.   
		</para>
		<section id="MostImportant31to32">
			<?dbhtml filename="MostImportant31to32.html"?>
			<sectioninfo>
				<keywordset>
					<keyword>important</keyword>
					<keyword>issues</keyword>
				</keywordset>
			</sectioninfo>
			<title>Most important issues</title>
			<para>
				Migrating to <property>RichFaces 3.2.0</property> you can encounter 
				with malfunction of the components caused by a number of reasons. 
				However, most of the problems can be positively solved. 
				This section covers the most significant issues you can potentially encounter, providing ways to handle the cases. 
			</para>
			&i18n;
			&menuJSF;
			&binding;
			&explicitId;
			&resource;
		</section>

		<section id="PreviousVersions31to32">
			<?dbhtml filename="PreviousVersions31to32.html"?>
			<sectioninfo>
				<keywordset>
					<keyword>upgrade</keyword>
					<keyword>previous</keyword>
					<keyword>version</keyword>
				</keywordset>
			</sectioninfo>
			<title>Issues with upgrading from previous versions</title>
			<para>This section covers issues you can encounter upgrading to <property>RichFaces 3.2.0</property>   from previous versions.</para>
			&calendarDate;
			&datascrollerPaired;
			&datascrollerFor;
			&ajaxSingleFacets;
			&actionparam;
			&immediate;
		</section>

		<section id="ThirdPartyFrameworks31to32">
			<?dbhtml filename="ThirdPartyFrameworks31to32.html"?>
			<sectioninfo>
				<keywordset>
					<keyword>third</keyword>
					<keyword>party</keyword>
					<keyword>frameworks</keyword>
				</keywordset>
			</sectioninfo>
			<title>Issues with compatibility with third party frameworks</title>
			<para>This section covers issues related to compatibility with third party frameworks. </para>
			&fileUploadListener;
			&myfaces;
			&seamMultipartFilter;
		</section>
	</chapter>
	
	<chapter id="RichFacesMigrationIssues32to33" xreflabel="RichFacesMigrationIssues32to33">
		<?dbhtml filename="RichFacesMigrationIssues32to33.html"?>
		<chapterinfo>
			<keywordset>
				<keyword>RichFaces</keyword>
				<keyword>Migration Guide</keyword>
			</keywordset>
		</chapterinfo>
		<title>The RichFaces Migration Issues 3.2.x - 3.3.0</title>
		<para>
			This chapter includes only those issues that concern migration from from 3.2.x versions to 3.3.0. 
			Issues, that are related to the new components and other problems are not covered here. 
			However, <ulink url="http://jira.jboss.com/jira/browse/RF">Jira</ulink> contains all issues 
			and if you can not find your case there, please, feel free to report it.   
		</para>


&dataTableAjax;
	</chapter>
</book>
