<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN"
"http://www.oasis-open.org/docbook/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 fileUploadListener SYSTEM "included/fileUploadListener.xml">
	<!ENTITY myfaces SYSTEM "included/myfaces.xml">
	<!ENTITY seamMultipartFilter SYSTEM "included/seamMultipartFilter.xml">
]>
<book>
	<bookinfo>
		<title>RichFaces Migration Guide</title>
		<copyright>
			<year>2008</year>
			<holder>Red Hat</holder>
		</copyright>
<abstract>
   <title/>
       <para>
           <ulink url="http://www.jboss.org/file-access/default/members/jbossrichfaces/freezone/docs/migrationguide/en/pdf/richfaces_migration_guide.pdf">PDF version</ulink>
       </para>
</abstract>

	</bookinfo>
	
	<toc/>  

	&intro;
	&scope;
	&req;	  
	
	<chapter 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 those issues that concern migration from the previous 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="MostImportant">
			<?dbhtml filename="MostImportant.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="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>
			<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;
		</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>
			<para>This section covers issues related to compatibility with third party frameworks. </para>
			&fileUploadListener;
			&myfaces;
			&seamMultipartFilter;
		</section>
	</chapter>
</book>
