[richfaces-svn-commits] JBoss Rich Faces SVN: r16020 - in root/docs/trunk: Component_Development_Kit_Guide/en-US and 10 other directories.

Author: SeanRogers Date: 2009-11-26 22:27:33 -0500 (Thu, 26 Nov 2009) New Revision: 16020 Removed: root/docs/trunk/Component_Development_Kit_Guide/en-US/all-Component_Development_Kit_Guide.xml root/docs/trunk/Component_Reference/en-US/all-Component_Reference.xml root/docs/trunk/Developer_Guide/en-US/all-Developer_Guide.xml root/docs/trunk/Migration_Guide/en-US/all-Migration_Guide.xml Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Author_Group.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/Book_Info.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/Component_Development_Kit_Guide.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/Configuration.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/Creating_a_new_component.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/Creating_components_in_other_environments.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/Developer_sample.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/Introduction.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/Naming_conventions.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/Preface.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/Revision_History.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/Template_tags_reference.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/Unit_testing.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/Using_components_in_projects.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/fallback_content/Conventions.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/fallback_content/Feedback.xml root/docs/trunk/Component_Development_Kit_Guide/en-US/fallback_content/Legal_Notice.xml root/docs/trunk/Component_Development_Kit_Guide/pom.xml root/docs/trunk/Component_Reference/en-US/Actions.xml root/docs/trunk/Component_Reference/en-US/Author_Group.xml root/docs/trunk/Component_Reference/en-US/Book_Info.xml root/docs/trunk/Component_Reference/en-US/Common_Ajax_attributes.xml root/docs/trunk/Component_Reference/en-US/Common_features.xml root/docs/trunk/Component_Reference/en-US/Component_Reference.xml root/docs/trunk/Component_Reference/en-US/Containers.xml root/docs/trunk/Component_Reference/en-US/Drag_and_drop.xml root/docs/trunk/Component_Reference/en-US/Functionality_extension.xml root/docs/trunk/Component_Reference/en-US/Functions.xml root/docs/trunk/Component_Reference/en-US/Introduction.xml root/docs/trunk/Component_Reference/en-US/Layout_and_appearance.xml root/docs/trunk/Component_Reference/en-US/Menus_and_toolbars.xml root/docs/trunk/Component_Reference/en-US/Output_and_messages.xml root/docs/trunk/Component_Reference/en-US/Panels_and_containers.xml root/docs/trunk/Component_Reference/en-US/Portals.xml root/docs/trunk/Component_Reference/en-US/Preface.xml root/docs/trunk/Component_Reference/en-US/Processing_management.xml root/docs/trunk/Component_Reference/en-US/Resources.xml root/docs/trunk/Component_Reference/en-US/Revision_History.xml root/docs/trunk/Component_Reference/en-US/Rich_inputs.xml root/docs/trunk/Component_Reference/en-US/Tables_and_grids.xml root/docs/trunk/Component_Reference/en-US/Trees.xml root/docs/trunk/Component_Reference/en-US/Validation.xml root/docs/trunk/Component_Reference/en-US/fallback_content/Conventions.xml root/docs/trunk/Component_Reference/en-US/fallback_content/Feedback.xml root/docs/trunk/Component_Reference/en-US/fallback_content/Legal_Notice.xml root/docs/trunk/Component_Reference/pom.xml root/docs/trunk/Developer_Guide/en-US/Advanced_features.xml root/docs/trunk/Developer_Guide/en-US/Author_Group.xml root/docs/trunk/Developer_Guide/en-US/Basic_concepts.xml root/docs/trunk/Developer_Guide/en-US/Book_Info.xml root/docs/trunk/Developer_Guide/en-US/Developer_Guide.xml root/docs/trunk/Developer_Guide/en-US/Getting_started_with_RichFaces.xml root/docs/trunk/Developer_Guide/en-US/Introduction.xml root/docs/trunk/Developer_Guide/en-US/Preface.xml root/docs/trunk/Developer_Guide/en-US/Resources.xml root/docs/trunk/Developer_Guide/en-US/Revision_History.xml root/docs/trunk/Developer_Guide/en-US/RichFaces_overview.xml root/docs/trunk/Developer_Guide/en-US/Skinning_and_theming.xml root/docs/trunk/Developer_Guide/en-US/fallback_content/Conventions.xml root/docs/trunk/Developer_Guide/en-US/fallback_content/Feedback.xml root/docs/trunk/Developer_Guide/en-US/fallback_content/Legal_Notice.xml root/docs/trunk/Developer_Guide/pom.xml root/docs/trunk/Migration_Guide/en-US/Author_Group.xml root/docs/trunk/Migration_Guide/en-US/Book_Info.xml root/docs/trunk/Migration_Guide/en-US/Changes_and_new_features.xml root/docs/trunk/Migration_Guide/en-US/Introduction.xml root/docs/trunk/Migration_Guide/en-US/Migration_Guide.ent root/docs/trunk/Migration_Guide/en-US/Migration_Guide.xml root/docs/trunk/Migration_Guide/en-US/Preface.xml root/docs/trunk/Migration_Guide/en-US/Revision_History.xml root/docs/trunk/Migration_Guide/en-US/Upgrading.xml root/docs/trunk/Migration_Guide/en-US/fallback_content/Conventions.xml root/docs/trunk/Migration_Guide/en-US/fallback_content/Feedback.xml root/docs/trunk/Migration_Guide/en-US/fallback_content/Legal_Notice.xml root/docs/trunk/Migration_Guide/pom.xml Log: Added better support for Maven, no longer requires all-in-one files Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Author_Group.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Author_Group.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Author_Group.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <authorgroup> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Book_Info.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Book_Info.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Book_Info.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <bookinfo id="book-Component_Development_Kit_Guide-Component_Development_Kit_Guide"> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Component_Development_Kit_Guide.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Component_Development_Kit_Guide.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Component_Development_Kit_Guide.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <book status="draft"> @@ -15,6 +17,5 @@ <xi:include href="Naming_conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> <xi:include href="Template_tags_reference.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> - <index /> </book> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Configuration.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Configuration.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Configuration.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Development_Kit_Guide-Configuration"> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Creating_a_new_component.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Creating_a_new_component.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Creating_a_new_component.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Development_Kit_Guide-Creating_a_new_component"> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Creating_components_in_other_environments.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Creating_components_in_other_environments.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Creating_components_in_other_environments.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Development_Kit_Guide-Creating_components_in_other_environments"> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Developer_sample.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Developer_sample.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Developer_sample.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Development_Kit_Guide-Developer_sample"> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Introduction.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Introduction.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Introduction.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Development_Kit_Guide-Introduction"> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Naming_conventions.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Naming_conventions.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Naming_conventions.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <appendix id="appe-Component_Development_Kit_Guide-Naming_conventions"> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Preface.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Preface.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Preface.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <preface id="pref-Component_Development_Kit_Guide-Preface"> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Revision_History.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Revision_History.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Revision_History.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <appendix id="appe-Component_Development_Kit_Guide-Revision_History"> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Template_tags_reference.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Template_tags_reference.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Template_tags_reference.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <appendix id="appe-Component_Development_Kit_Guide-Template_tags_reference"> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Unit_testing.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Unit_testing.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Unit_testing.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Development_Kit_Guide-Unit_testing"> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/Using_components_in_projects.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/Using_components_in_projects.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/Using_components_in_projects.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Development_Kit_Guide-Using_components_in_projects"> Deleted: root/docs/trunk/Component_Development_Kit_Guide/en-US/all-Component_Development_Kit_Guide.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/all-Component_Development_Kit_Guide.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/all-Component_Development_Kit_Guide.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,180 +0,0 @@ -<?xml version="1.0" encoding="utf-8"?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> -<!ENTITY PRODUCT "RichFaces"> -<!ENTITY VERSION "4.0"> -<!ENTITY VERSION_LONG "4.0.0.ALPHA2"> -<!ENTITY BOOKID "Component_Development_Kit_Guide"> -<!ENTITY HOLDER "Red Hat"> -<!ENTITY YEAR "2009"> -]> -<book lang="en-US" status="draft"> - <bookinfo id="book-Component_Development_Kit_Guide-Component_Development_Kit_Guide" lang="en-US"> - <title>Component Development Kit Guide</title> - <subtitle>Developing custom components for use in RichFaces 4.0.0.ALPHA2<remark> (draft)</remark> - projects</subtitle> - <productname>RichFaces</productname> - <productnumber>4.0</productnumber> - <edition>0.1</edition> - <pubsnumber>0</pubsnumber> - <abstract> - <para>This book details how to use the RichFaces Component Development -Kit to create custom components for use with the RichFaces -4.0 framework.</para></abstract> - <corpauthor> - <inlinemediaobject> - <imageobject> - <imagedata fileref="./images/rf_logo.png" format="PNG" scalefit="1"/> - </imageobject> - <textobject> - <phrase>Logo</phrase> - </textobject> - </inlinemediaobject> - </corpauthor> - <copyright> - <year>2009</year> - <holder>Red Hat</holder> - </copyright> - <!-- FOR PUBLICAN --><legalnotice xml:base="Common_Content/Legal_Notice.xml"> - <para> - Copyright <trademark class="copyright"/> 2009 Red Hat This material may only be distributed subject to the terms and conditions set forth in the GNU Free Documentation License (GFDL), V1.2 or later (the latest version is presently available at <ulink url="http://www.gnu.org/licenses/fdl.txt">http://www.gnu.org...>). - </para> -</legalnotice> - <authorgroup lang="en-US"> - <author> - <firstname>Sean</firstname> - <surname>Rogers</surname> - <affiliation> - <orgname>Red Hat</orgname> - <orgdiv>Engineering Content Services</orgdiv> - </affiliation> - <email&gt;serogers(a)redhat.com&lt;/email&gt; - </author> -</authorgroup> - </bookinfo> - <!-- <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> --><chapter id="chap-Component_Development_Kit_Guide-Introduction" lang="en-US"> - <title>Introduction</title> - <para> - This is a test paragraph - </para> -</chapter> - <chapter id="chap-Component_Development_Kit_Guide-Configuration" lang="en-US"> - <title>Configuration</title> - <para> - This is a test paragraph - </para> -</chapter> - <chapter id="chap-Component_Development_Kit_Guide-Creating_a_new_component" lang="en-US"> - <title>Creating a new component</title> - <para> - This is a test paragraph - </para> - <section id="sect-Component_Development_Kit_Guide-Creating_a_new_component-Creating_a_project"> - <title>Creating a project</title> - <para> - Test of a section - </para> - </section> - - <section id="sect-Component_Development_Kit_Guide-Creating_a_new_component-Building_a_component_skeleton"> - <title>Building a component skeleton</title> - <para> - Test of a section - </para> - </section> - - <section id="sect-Component_Development_Kit_Guide-Creating_a_new_component-Creating_the_UI"> - <title>Creating the UI</title> - <para> - Test of a section - </para> - </section> - - <section id="sect-Component_Development_Kit_Guide-Creating_a_new_component-Registering_resources"> - <title>Registering resources</title> - <para> - Test of a section - </para> - </section> - - <section id="sect-Component_Development_Kit_Guide-Creating_a_new_component-Extending_the_UIInput_Class"> - <title>Extending the UIInput Class</title> - <para> - Test of a section - </para> - </section> - - <section id="sect-Component_Development_Kit_Guide-Creating_a_new_component-Configuring_the_component"> - <title>Configuring the component</title> - <para> - Test of a section - </para> - </section> - - <section id="sect-Component_Development_Kit_Guide-Creating_a_new_component-Tags_and_descriptors"> - <title>Tags and descriptors</title> - <para> - Test of a section - </para> - </section> - -</chapter> - <chapter id="chap-Component_Development_Kit_Guide-Using_components_in_projects" lang="en-US"> - <title>Using components in projects</title> - <para> - This is a test paragraph - </para> -</chapter> - <chapter id="chap-Component_Development_Kit_Guide-Developer_sample" lang="en-US"> - <title>Developer sample</title> - <para> - This is a test paragraph - </para> -</chapter> - <chapter id="chap-Component_Development_Kit_Guide-Unit_testing" lang="en-US"> - <title>Unit testing</title> - <para> - This is a test paragraph - </para> -</chapter> - <chapter id="chap-Component_Development_Kit_Guide-Creating_components_in_other_environments" lang="en-US"> - <title>Creating components in other environments</title> - <para> - Creating components in other environments - </para> -</chapter> - <appendix id="appe-Component_Development_Kit_Guide-Naming_conventions" lang="en-US"> - <title>Naming conventions</title> - <para> - This is a test paragraph - </para> -</appendix> - <appendix id="appe-Component_Development_Kit_Guide-Template_tags_reference" lang="en-US"> - <title>Template tags reference</title> - <para> - This is a test paragraph - </para> -</appendix> - <appendix id="appe-Component_Development_Kit_Guide-Revision_History" lang="en-US"> - <title>Revision History</title> - <simpara> - <revhistory> - <revision> - <revnumber>1.0</revnumber> - <date/> - <author> - <firstname/> - <surname/> - <email/> - </author> - <revdescription> - <simplelist> - <member/> - </simplelist> - </revdescription> - </revision> - </revhistory> - </simpara> -</appendix> - <index/> -</book> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/fallback_content/Conventions.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/fallback_content/Conventions.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/fallback_content/Conventions.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,7 +1,9 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -<!ENTITY % BOOK_ENTITIES SYSTEM "Common_Content.ent"> +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Development_Kit_Guide.ent"> %BOOK_ENTITIES; +<!ENTITY % BOOK_ENTITIES SYSTEM "../Common_Content.ent"> +%BOOK_ENTITIES; ]> <section> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/fallback_content/Feedback.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/fallback_content/Feedback.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/fallback_content/Feedback.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0'?> <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <section> Modified: root/docs/trunk/Component_Development_Kit_Guide/en-US/fallback_content/Legal_Notice.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/en-US/fallback_content/Legal_Notice.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/en-US/fallback_content/Legal_Notice.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Component_Development_Kit_Guide.ent"> +%BOOK_ENTITIES; ]> <legalnotice> Modified: root/docs/trunk/Component_Development_Kit_Guide/pom.xml =================================================================== --- root/docs/trunk/Component_Development_Kit_Guide/pom.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Development_Kit_Guide/pom.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,21 +1,172 @@ - -<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/xsd/maven-4.0.0.xsd"> +<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/xsd/maven-4.0.0.xsd"> + <modelVersion>4.0.0</modelVersion> - <groupId>org.jboss.jbossas</groupId> - <artifactId>RichFaces_Component_Development_Kit_Guide-${translation}</artifactId> - <version>1.0-SNAPSHOT</version> + <groupId>org.jboss.project</groupId> + <artifactId>${docname}-${translation}</artifactId> + <version>1.0</version> <packaging>jdocbook</packaging> - <!--<name>Platform User Guide (${translation})</name>--> - <name>${env.DOCNAME}(${translation})</name> + <name>${bookname}-(${translation})</name> + + <properties> + <translation>en-US</translation> + <docname>Component_Development_Kit_Guide</docname> + <bookname>Component Development Kit Guide</bookname> + </properties> + + <repositories> + <repository> + <id>repository.jboss.org</id> + <name>JBoss Repository</name> + <layout>default</layout> + <url>http://repository.jboss.org/maven2/</url> + <snapshots> + <enabled>false</enabled> + </snapshots> + </repository> + </repositories> + <pluginRepositories> + <pluginRepository> + <id>repository.jboss.org</id> + <name>JBoss Repository</name> + <layout>default</layout> + <url>http://repository.jboss.org/maven2/</url> + <snapshots> + <enabled>false</enabled> + </snapshots> + </pluginRepository> + </pluginRepositories> + + + <profiles> + + <!-- mvn compile --> + <profile> + <id>all</id> + <activation> + <activeByDefault>true</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${docname}.pdf</finalName> + </format> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>html_single</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + <!-- mvn compile -Phtml --> + <profile> + <id>html</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + <!-- mvn compile -Phtml-single --> + <profile> + <id>html-single</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>html_single</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + <!-- mvn compile -Ppdf --> + <profile> + <id>pdf</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${docname}.pdf</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + </profiles> + <build> <plugins> <plugin> <groupId>org.jboss.maven.plugins</groupId> <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.1.3-SNAPSHOT</version> + <version>2.2.0</version> <extensions>true</extensions> <dependencies> <dependency> @@ -31,291 +182,36 @@ </dependency> </dependencies> <configuration> - <!--minmemory>1024m</minmemory> - <maxmemory>1024m</maxmemory --> - <sourceDocumentName>all-${env.DOCNAME}.xml</sourceDocumentName> - <!--<sourceDocumentName>${env.DOCNAME}</sourceDocumentName>--> - <sourceDirectory>en-US</sourceDirectory> - <imageResource> - <directory>en-US</directory> - <includes> - <include>images/*</include> - </includes> - </imageResource> - <!--<cssResource> - <directory>src/main/css</directory> - </cssResource>--> - <formats> - <!--format> - <formatName>pdf</formatName> - <note: "main-pdf" changed name to "pdf.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0> - <stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${env.DOCNAME}.pdf</finalName> - </format--> - <!--<format> - <formatName>html</formatName>--> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <!--<stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format>--> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <!--<format> - <formatName>eclipse</formatName>--> - <!--note: "main-eclipse.xsl" changed name to "eclipse.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/main-eclipse.xsl</stylesheetResource>--> - <!--<stylesheetResource>classpath:/xslt/eclipse.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format>--> - </formats> - <options> - <xincludeSupported>true</xincludeSupported> - <xmlTransformerType>saxon</xmlTransformerType> - <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme --> - <!-- could also locate the docbook dependency and inspect its version... --> - <docbookVersion>1.72.0</docbookVersion> - <transformerParameters> - <property> - <name>javax.xml.parsers.DocumentBuilderFactory</name> - <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value> - </property> - <property> - <name>javax.xml.parsers.SAXParserFactory</name> - <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value> - </property> - <!--<javax.xml.parsers.DocumentBuilderFactory>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</javax.xml.parsers.DocumentBuilderFactory> - <javax.xml.parsers.SAXParserFactory>org.apache.xerces.jaxp.SAXParserFactoryImpl</javax.xml.parsers.SAXParserFactory> - <javax.xml.validation.SchemaFactory:http\://www.w3.org/2001/XMLSchema>o... - </transformerParameters> - </options> - </configuration> - </plugin> - </plugins> - </build> - <properties> - <translation>en-US</translation> - </properties> - <pluginRepositories> - <!--original repository--> - <pluginRepository> - <id>jboss</id> - <name>JBoss Plugin Repository</name> - <url>http://repository.jboss.org/maven2</url> - <layout>default</layout> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - <pluginRepository> - <id>jboss</id> - <name>JBoss Plugin Repository</name> - <url>http://repository.jboss.org/maven2</url> - <layout>default</layout> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - <pluginRepository> - <id>snapshots.jboss</id> - <name>JBoss Snapshots</name> - <url>http://snapshots.jboss.org/maven2</url> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - <pluginRepository> - <id>people.apache</id> - <name>People Apache plugin repository</name> - <url>http://people.apache.org/repo/m2-snapshot-repository</url> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - </pluginRepositories> - <profiles> + <sourceDocumentName>${docname}.xml</sourceDocumentName> + <sourceDirectory>.</sourceDirectory> + <imageResource> + <directory>${translation}</directory> + <includes> + <include>images/*</include> + </includes> + </imageResource> + <options> + <xincludeSupported>true</xincludeSupported> + <xmlTransformerType>saxon</xmlTransformerType> + <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme --> + <!-- could also locate the docbook dependency and inspect its version... --> + <docbookVersion>1.72.0</docbookVersion> + <transformerParameters> + <property> + <name>javax.xml.parsers.DocumentBuilderFactory</name> + <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value> + </property> + <property> + <name>javax.xml.parsers.SAXParserFactory</name> + <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value> + </property> + </transformerParameters> + </options> + </configuration> + </plugin> + + </plugins> + </build> - <profile> - <id>all</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>pdf</formatName> - <!--note: "main-pdf" changed name to "pdf.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${env.DOCNAME}.pdf</finalName> - </format> - <format> - <formatName>html</formatName> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>hudson</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>html</formatName> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>html</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>html</formatName> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>html_single</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>pdf</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>pdf</formatName> - <!--note: "main-pdf" changed name to "pdf.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${env.DOCNAME}.pdf</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - </profiles> </project> + Modified: root/docs/trunk/Component_Reference/en-US/Actions.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Actions.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Actions.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Actions"> Modified: root/docs/trunk/Component_Reference/en-US/Author_Group.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Author_Group.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Author_Group.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <authorgroup> Modified: root/docs/trunk/Component_Reference/en-US/Book_Info.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Book_Info.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Book_Info.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <bookinfo id="book-Component_Reference-Component_Reference"> Modified: root/docs/trunk/Component_Reference/en-US/Common_Ajax_attributes.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Common_Ajax_attributes.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Common_Ajax_attributes.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Common_Ajax_attributes"> Modified: root/docs/trunk/Component_Reference/en-US/Common_features.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Common_features.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Common_features.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Common_features"> Modified: root/docs/trunk/Component_Reference/en-US/Component_Reference.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Component_Reference.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Component_Reference.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <book status="draft"> @@ -31,6 +33,5 @@ <xi:include href="Functionality_extension.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> </part> <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> - <index /> </book> Modified: root/docs/trunk/Component_Reference/en-US/Containers.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Containers.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Containers.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Containers"> Modified: root/docs/trunk/Component_Reference/en-US/Drag_and_drop.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Drag_and_drop.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Drag_and_drop.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Drag_and_drop"> Modified: root/docs/trunk/Component_Reference/en-US/Functionality_extension.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Functionality_extension.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Functionality_extension.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Functionality_extension"> Modified: root/docs/trunk/Component_Reference/en-US/Functions.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Functions.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Functions.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Functions"> Modified: root/docs/trunk/Component_Reference/en-US/Introduction.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Introduction.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Introduction.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Introduction"> Modified: root/docs/trunk/Component_Reference/en-US/Layout_and_appearance.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Layout_and_appearance.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Layout_and_appearance.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Layout_and_appearance"> Modified: root/docs/trunk/Component_Reference/en-US/Menus_and_toolbars.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Menus_and_toolbars.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Menus_and_toolbars.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Menus_and_toolbars"> Modified: root/docs/trunk/Component_Reference/en-US/Output_and_messages.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Output_and_messages.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Output_and_messages.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Output_and_messages"> Modified: root/docs/trunk/Component_Reference/en-US/Panels_and_containers.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Panels_and_containers.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Panels_and_containers.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Panels_and_containers"> Modified: root/docs/trunk/Component_Reference/en-US/Portals.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Portals.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Portals.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Portals"> Modified: root/docs/trunk/Component_Reference/en-US/Preface.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Preface.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Preface.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <preface id="pref-Component_Reference-Preface"> Modified: root/docs/trunk/Component_Reference/en-US/Processing_management.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Processing_management.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Processing_management.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Processing_management"> Modified: root/docs/trunk/Component_Reference/en-US/Resources.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Resources.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Resources.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Resources"> Modified: root/docs/trunk/Component_Reference/en-US/Revision_History.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Revision_History.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Revision_History.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <appendix id="appe-Component_Reference-Revision_History"> Modified: root/docs/trunk/Component_Reference/en-US/Rich_inputs.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Rich_inputs.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Rich_inputs.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Rich_inputs"> Modified: root/docs/trunk/Component_Reference/en-US/Tables_and_grids.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Tables_and_grids.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Tables_and_grids.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Tables_and_grids"> Modified: root/docs/trunk/Component_Reference/en-US/Trees.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Trees.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Trees.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Trees"> Modified: root/docs/trunk/Component_Reference/en-US/Validation.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/Validation.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/Validation.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Component_Reference-Validation"> Deleted: root/docs/trunk/Component_Reference/en-US/all-Component_Reference.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/all-Component_Reference.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/all-Component_Reference.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,1534 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -]> - -<book status="draft"> - <bookinfo id="book-Component_Reference-Component_Reference" lang="en-US"> - <title>Component Reference</title> - <subtitle>A reference guide to the components of the RichFaces 4.0.0.ALPHA2<remark> (draft)</remark> - framework</subtitle> - <productname>RichFaces</productname> - <productnumber>4.0</productnumber> - <edition>0.1</edition> - <pubsnumber>0</pubsnumber> - <abstract> - <para>This book details each component in the RichFaces 4.0 framework, -including examples of their use in applications.</para></abstract> - <corpauthor> - <inlinemediaobject> - <imageobject> - <imagedata fileref="./images/rf_logo.png" format="PNG" scalefit="1" /> - </imageobject> - <textobject> - <phrase>Logo</phrase> - </textobject> - </inlinemediaobject> - </corpauthor> - <copyright> - <year>2009</year> - <holder>Red Hat</holder> - </copyright> - <!-- FOR PUBLICAN --> - <legalnotice xml:base="Common_Content/Legal_Notice.xml"> - <para> - Copyright <trademark class="copyright"></trademark> 2009 Red Hat This material may only be distributed subject to the terms and conditions set forth in the GNU Free Documentation License (GFDL), V1.2 or later (the latest version is presently available at <ulink url="http://www.gnu.org/licenses/fdl.txt">http://www.gnu.org...>). - </para> - </legalnotice> - <authorgroup lang="en-US"> - <author> - <firstname>Sean</firstname> - <surname>Rogers</surname> - <affiliation> - <orgname>Red Hat</orgname> - <orgdiv>Engineering Content Services</orgdiv> - </affiliation> - <email&gt;serogers(a)redhat.com&lt;/email&gt; - </author> - </authorgroup> - </bookinfo> - <!-- <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> --> - <chapter id="chap-Component_Reference-Introduction" lang="en-US"> - <title>Introduction</title> - <para> - This book is a guide to the various components available in the RichFaces 4.0 framework. It includes descriptions of the role of the components, details on how best to use them, coded examples of their use, and basic references of their properties and attributes. - </para> - <para> - For full in-depth references for all component classes and properties, refer to the <citetitle>API Reference</citetitle> available from the RichFaces website. - </para> - <section id="sect-Component_Reference-Introduction-Libraries"> - <title>Libraries</title> - <para> - The RichFaces framework as it now stands is made up of two tag libraries: the <classname>a4j</classname> library and the <classname>rich</classname> library. The <classname>a4j</classname> tag library represents Ajax4jsf, which provides page-level Ajax support with core Ajax components. This allows developers to make use of custom Ajax behavior with existing components. The <classname>rich</classname> tag library provides Ajax support at the component level instead, and includes ready-made, self-contained components. These components don&#39;t require additional configuration in order to send requests or update. - </para> - <note> - <title>Note</title> - <para> - All components in the <classname>a4j</classname> library feature built-in Ajax support, so it is unnecessary to add the <classname>&lt;a4j:ajax&gt;</classname> behavior. - </para> - </note> - </section> - - </chapter> - <chapter id="chap-Component_Reference-Common_Ajax_attributes" lang="en-US"> - <title>Common Ajax attributes</title> - <para> - The Ajax components in the <classname>a4j</classname> library share common attributes to perform similar functionality. Most RichFaces components in the <classname>rich</classname> library that feature built-in Ajax support share these common attributes as well. - </para> - <para> - Most attributes have default values, so they need not be explicitly set for the component to function in its default state. These attributes can be altered to customize the behavior of the component if necessary. - </para> - <section id="sect-Component_Reference-Common_Ajax_attributes-Rendering"> - <title>Rendering</title> - <section id="sect-Component_Reference-Rendering-render"> - <title><code>render</code></title> - <para> - The <code>render</code> attribute provides a reference to one or more areas on the page that need updating after an Ajax interaction. It uses the <code>UIComponent.findComponent()</code> algorithm to find the components in the component tree using their <code>id</code> attributes as a reference. Components can be referenced by their <code>id</code> attribute alone, or by a hierarchy of components&#39; <code>id</code> attributes to make locating components more efficient. <xref linkend="exam-Component_Reference-render-render_example" /> shows both ways of referencing components. Each command button will correctly render the referenced panel grids, but the second button locates the references more efficiently with explicit hierarchy paths. - </para> - <example id="exam-Component_Reference-render-render_example"> - <title>render example</title> - -<programlisting language="xml"> -&lt;h:form id="form1"&gt; - &lt;a4j:commandButton value="Basic reference" render="infoBlock, infoBlock2" /&gt; - &lt;a4j:commandButton value="Specific reference" render=":infoBlock,:sv:infoBlock2" /&gt; -&lt;/h:form&gt; - -&lt;h:panelGrid id="infoBlock"&gt; - ... -&lt;/h:panelGrid&gt; - -&lt;f:subview id="sv"&gt; - &lt;h:panelGrid id="infoBlock2"&gt; - ... - &lt;/h:panelGrid&gt; -&lt;/f:subview&gt; -</programlisting> - </example> - <para> - The value of the <code>render</code> attribute can also be an expression written using JavaServer Faces&#39; Expression Language (<acronym>EL</acronym>); this can either be a <type>Set</type>, <type>Collection</type>, <type>Array</type>, or <type>String</type>. - </para> - <important> - <title>Important</title> - <para> - A common problem with using <code>render</code> occurs when the referenced component has a <code>rendered</code> attribute. <acronym>JSF</acronym> does not mark the place in the browser&#39;s Document Object Model (<acronym>DOM</acronym>) where the rendered component would be placed in case the <code>rendered</code> attribute returns <literal>false</literal>. As such, when RichFaces sends the render code to the client, the page does not update as the place for the update is not known. - </para> - <para> - To work around this issue, wrap the component to be rendered in an <classname>&lt;a4j:outputPanel&gt;</classname> with <code>layout="none"</code>. The <classname>&lt;a4j:outputPanel&gt;</classname> will receive the update and render the component as required. - </para> - </important> - </section> - - <section id="sect-Component_Reference-Rendering-ajaxRendered"> - <title>ajaxRendered</title> - <para> - A component with <code>ajaxRendered="true"</code> will be re-rendered with <emphasis>every</emphasis> Ajax request, even when not referenced by the requesting component&#39;s <code>render</code> attribute. This can be useful for updating a status display or error message without explicitly requesting it. - </para> - <para> - Rendering of components in this way can be repressed by adding <code>limitRender="true"</code> to the requesting component, as described in <xref linkend="sect-Component_Reference-Rendering-limitRender" />. - </para> - </section> - - <section id="sect-Component_Reference-Rendering-limitRender"> - <title>limitRender</title> - <para> - A component with <code>limitRender="true"</code> specified will <emphasis>not</emphasis> cause components with <code>ajaxRendered="true"</code> to re-render, and only those components listed in the <code>render</code> attribute will be updated. This essentially overrides the <code>ajaxRendered</code> attribute in other components. - </para> - <para> - <xref linkend="exam-Component_Reference-data-Data_reference_example" /> describes two command buttons, a panel grid rendered by the buttons, and an output panel showing error messages. When the first button is clicked, the output panel is rendered even though it is not explicitly referenced with the <code>render</code> attribute. The second button, however, uses <code>limitRender="true"</code> to override the output panel&#39;s rendering and only render the panel grid. - </para> - <example id="exam-Component_Reference-limitRender-Rendering_example"> - <title>Rendering example</title> - -<programlisting language="XML"> -&lt;h:form id="form1"&gt; - &lt;a4j:commandButton value="Normal rendering" render="infoBlock" /&gt; - &lt;a4j:commandButton value="Limited rendering" render="infoBlock" limitRender="true" /&gt; -&lt;/h:form&gt; - -&lt;h:panelGrid id="infoBlock"&gt; - ... -&lt;/h:panelGrid&gt; - -&lt;a4j:outputPanel ajaxRendered="true"&gt; - &lt;h:messages /&gt; -&lt;/a4j:outputPanel&gt; -</programlisting> - </example> - </section> - - </section> - - <section id="sect-Component_Reference-Common_Ajax_attributes-Queuing_and_traffic_control"> - <title>Queuing and traffic control</title> - <section id="sect-Component_Reference-Queuing_and_traffic_control-queue"> - <title>queue</title> - <para> - The <code>queue</code> attribute defines the name of the queue that will be used to schedule upcoming Ajax requests. Typically RichFaces does not queue Ajax requests, so if events are produced simultaneously they will arrive at the server simultaneously. This can potentially lead to unpredictable results when the responses are returned. The <code>queue</code> attribute ensures that the requests are responded to in a set order. - </para> - <para> - A queue name is specified with the <code>queue</code> attribute, and each request added to the named queue is completed one at a time in the order they were sent. In addition, RichFaces intelligently removes similar requests produced by the same event from a queue to improve performance, protecting against unnecessary traffic flooding and - </para> - </section> - - <section id="sect-Component_Reference-Queuing_and_traffic_control-requestDelay"> - <title>requestDelay</title> - <para> - The <code>requestDelay</code> attribute specifies an amount of time in milliseconds for the request to wait in the queue before being sent to the server. If a similar request is added to the queue before the delay is over, the original request is removed from the queue and not sent. - </para> - </section> - - <section id="sect-Component_Reference-Queuing_and_traffic_control-ignoreDupResponses"> - <title>ignoreDupResponses</title> - <para> - When set to <literal>true</literal>, the <code>ignoreDupResponses</code> attribute causes responses from the server for the request to be ignored if there is another similar request in the queue. This avoids unnecessary updates on the client when another update is expected. The request is still processed on the server, but if another similar request has been queued then no updates are made on the client. - </para> - </section> - - </section> - - <section id="sect-Component_Reference-Common_Ajax_attributes-Data_processing"> - <title>Data processing</title> - <para> - RichFaces uses a form-based approach for sending Ajax requests. As such, each time a request is sent the data from the requesting component&#39;s parent <acronym>JSF</acronym> form is submitted along with the <acronym>XMLHTTPRequest</acronym> object. The form data contains values from the input element and auxiliary information such as state-saving data. - </para> - <section id="sect-Component_Reference-Data_processing-process"> - <title>process</title> - <para> - The <code>process</code> attribute allows <acronym>JSF</acronym> processing to be limited to defined components. To only process the requesting component, <code>process="@this"</code> can be used. - </para> - </section> - - <section id="sect-Component_Reference-Data_processing-immediate"> - <title>immediate</title> - <para> - If the <code>immediate</code> attribute is set to <literal>true</literal>, the default ActionListener is executed immediately during the Apply Request Values phase of the request processing lifecycle, rather than waitingfor the Invoke Application phase. This allows some data model values to be updated regardless of whether the Validation phase is successful or not. - </para> - </section> - - <section id="sect-Component_Reference-Data_processing-bypassUpdates"> - <title>bypassUpdates</title> - <para> - If the <code>bypassUpdates</code> attribute is set to <literal>true</literal>, the Update Model phase of the request processing lifecycle is bypassed. This is useful if user input needs to be validated but the model does not need to be updated. - </para> - </section> - - </section> - - <section id="sect-Component_Reference-Common_Ajax_attributes-Action_and_navigation"> - <title>Action and navigation</title> - <para> - The <code>action</code> and <code>actionListener</code> attributes can be used to invoke action methods and define action events. - </para> - <section id="sect-Component_Reference-Action_and_navigation-action"> - <title>action</title> - <para> - The <code>action</code> attribute is a method binding that points to the application action to be invoked. The method can be activated during the Apply Request Values phase or the Invoke Application phase of the request processing lifecycle. - </para> - <para> - The method specified in the <code>action</code> attribute must return <literal>null</literal> for an Ajax response with a partial page update. - </para> - </section> - - <section id="sect-Component_Reference-Action_and_navigation-actionListener"> - <title>actionListener</title> - <para> - The <code>actionListener</code> attribute is a method binding for <classname>ActionEvent</classname> methods with a return type of <literal>void</literal>. - </para> - </section> - - </section> - - <section id="sect-Component_Reference-Common_Ajax_attributes-Events_and_JavaScript_interactions"> - <title>Events and JavaScript interactions</title> - <para> - RichFaces allows for Ajax-enabled <acronym>JSF</acronym> applications to be developed without using any additional JavaScript code. However it is still possible to invoke custom JavaScript code through Ajax events. - </para> - <section id="sect-Component_Reference-Events_and_JavaScript_interactions-onsubmit"> - <title>onsubmit</title> - <para> - The <code>onsubmit</code> attribute will invoke the JavaScript code before the Ajax request is sent. The request is canceled if the JavaScript code defined for <code>onsubmit</code> returns <literal>false</literal>. - </para> - </section> - - <section id="sect-Component_Reference-Events_and_JavaScript_interactions-onclick"> - <title>onclick</title> - <para> - The <code>onclick</code> attribute functions similarly to the <code>onsubmit</code> attribute for those components that can be clicked, such as <classname>&lt;a4j:commandButton&gt;</classname> and <classname>&lt;a4j:commandLink&gt;</classname>. It invokes the defined JavaScript before the Ajax request, and the request will be canceled if the defined code returns <literal>false</literal>. - </para> - </section> - - <section id="sect-Component_Reference-Events_and_JavaScript_interactions-oncomplete"> - <title>oncomplete</title> - <para> - The <code>oncomplete</code> attribute invokes the JavaScript code after the Ajax response has been returned and the <acronym>DOM</acronym> tree of the browser has been updated. The code is registered for further invocation of the <acronym>XMLHTTP</acronym> request object before an Ajax request is sent. As such, using <acronym>JSF</acronym> Expression Language (<acronym>EL</acronym>) value binding means the code will not be changed during processing of the request on the server. Additionally the <code>oncomplete</code> attribute cannot use the <literal>this</literal> keyword as it will not point to the component from which the Ajax request was initiated. - </para> - </section> - - <section id="sect-Component_Reference-Events_and_JavaScript_interactions-onbegin"> - <title>onbegin</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Events_and_JavaScript_interactions-onsuccess"> - <title>onsuccess</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Events_and_JavaScript_interactions-onerror"> - <title>onerror</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Events_and_JavaScript_interactions-data"> - <title>data</title> - <para> - The <code>data</code> attribute allows the use of additional data during an Ajax call. <acronym>JSF</acronym> Expression Language (<acronym>EL</acronym>) can be used to reference the property of the managed bean, and its value will be serialized in JavaScript Object Notation (<acronym>JSON</acronym>) and returned to the client side. The property can then be referenced through the <code>data</code> variable in the event attribute definitions. Both primitive types and complex types such as arrays and collections can be serialized and used with <code>data</code>. - </para> - <example id="exam-Component_Reference-data-Data_reference_example"> - <title>Data reference example</title> - -<programlisting language="XML"> -&lt;a4j:commandButton value="Update" data="#{userBean.name}" oncomplete="showTheName(data.name)" /&gt; -</programlisting> - </example> - </section> - - </section> - - </chapter> - <chapter id="chap-Component_Reference-Rich_inputs" lang="en-US"> - <title>Rich inputs</title> - <para> - This chapter details rich components for user input and interaction. - </para> - <section id="sect-Component_Reference-Rich_inputs-richCalendar"> - <title>&lt;rich:Calendar&gt;</title> - <para> - The <classname>&lt;rich:calendar&gt;</classname> component allows the user to enter a date and time through an in-line or pop-up calendar. The pop-up calendar can navigate through months and years, and its look and feel can be highly customized. - </para> - <para> - The <classname>&lt;rich:calendar&gt;</classname> component supports two different ways of loading data through defining the <code>mode</code> attribute. When not specified, the component uses <literal>client</literal> mode, which loads an initial portion of data within a set date range. The range can be defined by using the <code>preloadDateRangeBegin</code> and <code>preloadDateRangeEnd</code> attributes. Additional data requests are not sent. Alternatively, with <code>mode="ajax"</code> the <classname>&lt;rich:calendar&gt;</classname> requests portions of data for rendering from a special data model. The data model can be defined through the <code>dataModel</code> attribute, which points to an object that implements the <classname>CalendarDataModel</classname> interface. If the <code>dataModel</code> attribute is not defined or has a value of <literal>null</literal>, the <literal>ajax</literal> mode functions the same as the <literal>client</literal> mode. - </para> - <para> - The <classname>&lt;rich:calendar&gt;</classname> component is presented as a pop-up by default, appearing as a text field with a button to expand the full pop-up calendar. Specifying <code>popup="false</code> will render the calendar in-line on the page instead, which displays the full calendar without the text field or display button. The appearance of the display button can be altered from the standard calendar icon by defining the <code>buttonIcon</code> and <code>buttonIconDisabled</code> attributes to replace the icon with a specified file, or by defining the <code>buttonLabel</code> attribute to display text on the button without an icon. If <code>buttonLabel</code> is specified then both <code>buttonIcon</code> and <code>buttonIconDisabled</code> attributes are ignored. The text field box can also be hidden by setting <code>showInput="false"</code>. - </para> - <para> - The position at which the pop-up calendar displays relative to the text field and button can be configured using the <code>jointPoint</code> and <code>direction</code> attributes. The <code>jointPoint</code> attribute refers to the corner of the text field and button with which the calendar will be aligned and the <code>direction</code> specifies which direction the pop-up calendar will span relative to the joint point. The default settings are <code>jointPoint="bottom-left"</code> and <code>direction="bottom-right"</code>, causing the pop-up calendar to align with the bottom-left corner of the text field and span to the bottom-right, underneath the text field and button. The diagram shows the joint points and directions that can be used. Alternatively, both <code>jointPoint</code> and <code>direction</code> can be set to <literal>auto</literal> to allow smart pop-up positioning. - </para> - <para> - The calendar features a <guibutton>Today</guibutton> button for locating today&#39;s date on the calendar. This can be set to three different values using the <code>todayControlMode</code> attribute: - </para> - <itemizedlist> - <listitem> - <para> - <literal>hidden</literal>, which does not display the button; - </para> - </listitem> - <listitem> - <para> - <literal>select</literal>, the default setting, which scrolls the calendar to the current month and selects today&#39;s date; and - </para> - </listitem> - <listitem> - <para> - <literal>scroll</literal>, which scrolls the calendar to the current month but does not select today&#39;s date. - </para> - </listitem> - </itemizedlist> - <para> - The <classname>&lt;rich:calendar&gt;</classname> component can additionally allow a time of day to be specified with the date. After selecting a date the option to set a time becomes available. The default time can be set with the <code>defaultTime</code> attribute. If the time is altered and a new date is selected, it will not reset unless <code>resetTimeOnDateSelect="true"</code> is specified. - </para> - <para> - There are several event handlers that are unique to the <classname>&lt;rich:calendar&gt;</classname> component. - </para> - <itemizedlist> - <listitem> - <para> - <code>ondateselect</code> is triggered when the date is selected by the user, before the update request is sent. - </para> - </listitem> - <listitem> - <para> - <code>ondateselected</code> is triggered after the date is selected by the user. - </para> - </listitem> - <listitem> - <para> - <code>oncurrentdateselect</code> is triggered when any of the year- or month-changing buttons are pressed, before the update request is sent. - </para> - </listitem> - <listitem> - <para> - <code>oncurrentdateselected</code> is triggered after any of the year- or month-changing buttons are pressed. - </para> - </listitem> - <listitem> - <para> - <code>ontimeselect</code> is triggered when the time is set by the user, before the update request is sent. - </para> - </listitem> - <listitem> - <para> - <code>ontimeselected</code> is triggered after the time has been set by the user. - </para> - </listitem> - </itemizedlist> - <para> - The entire calendar can be set as read-only with <code>readonly="true"</code>. This allows months and years to be browsed through with the arrow controls, but dates and times cannot be selected. - </para> - </section> - - <section id="sect-Component_Reference-Rich_inputs-richcolorPicker"> - <title>&lt;rich:colorPicker&gt;</title> - <para> - The <classname>&lt;rich:colorPicker&gt;</classname> component allows the selection of a color, either by picking the color from the spectrum, defining it through decimal or hexadecimal <acronym>RGB</acronym> (red-green-blue) values, or defining it through <acronym>HSB</acronym> (hue-saturation-brightness) values. The <classname>&lt;rich:colorPicker&gt;</classname> component can appear either in-line with a pop-up or flat, and the look and feel can be highly customized. - </para> - <para> - The <code>value</code> attribute stores the currently selected color. The <code>colorMode</code> attribute defines whether the <code>value</code> is saved as <literal>hex</literal> (hexadecimal) or <literal>rgb</literal> (red-green-blue). - </para> - <para> - The <classname>&lt;rich:colorPicker&gt;</classname> appears in-line by default, where the color picker spectrum is only shown once the component is clicked on. The component can appear "flat", where the whole color picker is shown, by setting <code>flat="true"</code>. - </para> - <para> - The <classname>&lt;rich:colorPicker&gt;</classname> component has the unique event handler <code>onbeforeshow</code>, which is triggered immediately before the color picker is opened. The <code>showEvent</code> attribute can be used to bind the opening of the color picker to a specific event; it is bound to the <code>onclick</code> event by default. - </para> - </section> - - <section id="sect-Component_Reference-Rich_inputs-richcomboBox"> - <title>&lt;rich:comboBox&gt;</title> - <para> - The <classname>&lt;rich:comboBox&gt;</classname> component is a typical combo-box with built-in Ajax capabilities. It supports client-side suggestions, browser-like selection, Seam entity converter support, and customization of the look and feel. - </para> - <para> - The <code>value</code> attribute stores the selected value for the combo-box. Suggestions shown in the drop-down list for the combo-box can be specified in one of two ways: - </para> - <itemizedlist> - <listitem> - <para> - Using the <code>suggestionValues</code> attribute, and defining a collection of suggestions: - </para> - <example id="exam-Component_Reference-richcomboBox-Defining_suggestion_values"> - <title>Defining suggestion values</title> - -<programlisting language="XML"> -&lt;rich:comboBox value="#{bean.state}" suggestionValues="#{bean.suggestions}" -</programlisting> - </example> - </listitem> - <listitem> - <para> - Using the JSF components <classname>&lt;f:selectItem /&gt;</classname> and <classname>&lt;f:selectItems /&gt;</classname> to define a list of items: - </para> - <example id="exam-Component_Reference-richcomboBox-Defining_list_items_for_richinplaceSelect"> - <title>Defining list items for &lt;rich:inplaceSelect&gt;</title> - -<programlisting language="XML"> -&lt;rich:comboBox value="#{bean.item}" valueChangeListener="#{bean.selectionChanged}" &gt; - &lt;f:selectItems value="#{bean.selectItems}" /&gt; - &lt;f.selectItem itemValue="Item 1" /&gt; - &lt;f.selectItem itemValue="Item 2" /&gt; - &lt;f.selectItem itemValue="Item 3" /&gt; - &lt;f.selectItem itemValue="Item 4" /&gt; -&lt;/rich:comboBox&gt; -</programlisting> - </example> - </listitem> - </itemizedlist> - <para> - Users can type into the combo-box&#39;s text field to enter a value, which also searches through the suggestion items in the drop-down box. By default, the first suggestion item is selected as the user types. This behavior can be deactivated by setting <code>selectFirstOnUpdate="false"</code>. Setting <code>directInputSuggestions="true"</code> causes the combo-box to fill the text field box with a matching suggestion as the user types. Alternatively, the text field can be disabled by setting <code>enableManualInput="false"</code>, which forces the users to pick from items in the drop-down box. - </para> - <para> - The <classname>&lt;rich:comboBox&gt;</classname> component has two unique event handlers: - </para> - <itemizedlist> - <listitem> - <para> - <code>onlistcall</code> triggers before the drop-down list is shown, allowing the operation to be canceled. - </para> - </listitem> - <listitem> - <para> - <code>onselect</code> triggers when a suggestion is selected from the drop-down list, before the update request is sent. - </para> - </listitem> - </itemizedlist> - </section> - - <section id="sect-Component_Reference-Rich_inputs-richeditor"> - <title>&lt;rich:editor&gt;</title> - <para> - The <classname>&lt;rich:editor&gt;</classname> component provides a fully-featured word processor. It features manageable global configurations, and support for Seam text, custom plug-ins, and a customized look and feel. The editor is fully based on the TinyMCE JavaScript editor control, supporting all TinyMCE&#39;s parameters, and is adapted for the <acronym>JSF</acronym> environment with some additional capabilities. - </para> - </section> - - <section id="sect-Component_Reference-Rich_inputs-richfileUpload"> - <title>&lt;rich:fileUpload&gt;</title> - <para> - The <classname>&lt;rich:fileUpload&gt;</classname> component allows the user to upload files to a server. It features multiple uploads, automatic uploads, progress bars, restrictions on file types and sizes to be uploaded, and an embedded flash module. - </para> - <para> - Files are uploaded to either the temporary folder (different for each operating system) or to <acronym>RAM</acronym> (random-access memory), depending on the value of the <code>createTempFile</code> parameter of the Ajax4jsf Filter section in the <filename>web.xml</filename> for the project. - </para> - <para> - Basic usage requires the <code>uploadData</code> attribute, pointing to the collection of uploaded files. - </para> - <example id="exam-Component_Reference-richfileUpload-Basic_usage_of_richfileUpload"> - <title>Basic usage of &lt;rich:fileUpload&gt;</title> - -<programlisting language="XML"> -&lt;rich:fileUpload uploadData="#{bean.data}" /&gt; -</programlisting> - </example> - <para> - The <code>fileUploadListener</code> attribute can be used to call a function on the server side after each file is uploaded. - </para> - <para> - The <code>immediateUpload</code> attribute can be set to <literal>true</literal> to upload files as soon as they are added to the list, rather than waiting for the user to press the <guibutton>Upload</guibutton>. The <code>autoclear</code> attribute can be set to <code>true</code> to automatically remove files from the list once they have been successfully uploaded. - </para> - <para> - The <classname>&lt;rich:fileUpload&gt;</classname> component can place restrictions on the files that can be uploaded. The <code>acceptedTypes</code> attribute restricts the file types to just those listed. The <code>maxFilesQuantity</code> attribute restricts the maximum number of files that can be uploaded. Size restrictions can be placed on individual files by setting the <code>maxRequestSize</code> parameter of the Ajax4jsf Filter section in the <filename>web.xml</filename> file for the project. - </para> - <para> - There are a number of event handlers specifc to the <classname>&lt;rich:fileUpload&gt;</classname> component: - </para> - <itemizedlist> - <listitem> - <para> - <code>onadd</code> is triggered before a file is added to the list. - </para> - </listitem> - <listitem> - <para> - <code>onupload</code> is triggered before a file is uploaded. - </para> - </listitem> - <listitem> - <para> - <code>onuploadcomplete</code> is triggered after all files in the list have finished uploading. - </para> - </listitem> - <listitem> - <para> - <code>onuploadcanceled</code> is triggered after an upload has been canceled. - </para> - </listitem> - <listitem> - <para> - <code>onerror</code> is triggered when an error occurs during the upload process. - </para> - </listitem> - </itemizedlist> - <para> - The <classname>&lt;rich:fileUpload&gt;</classname> component has an embedded Flash module that adds extra functionality. To enable the Flash module, set <code>allowFlash="true"</code>. The Flash module adds additional features to file selection, such as the ability to choose multiple files at once and the filtering of files by their type. Additionally, the Flash module provides a smoother animation of the progress bar during the upload process, as the progress polling is performed by Flash rather than Ajax. - </para> - <para> - The text labels used in the component can be completely customized. Labels for the various controls of the component can be set using <code>addControlLabel</code>, <code>clearAllControlLabel</code>, <code>clearControlLabel</code>, <code>stopEntryControlLabel</code>, and <code>uploadControlLabel</code>. The status label for the upload can be set using the <code>label</code> attribute and the following wildcards: - </para> - <itemizedlist> - <listitem> - <para> - <code>{B} {KB} {MB}</code>: the full size of the file to be uploaded, measured in bytes, kilobytes and megabytes respectively. - </para> - </listitem> - <listitem> - <para> - <code>{_B} {_KB} {_MB}</code>: the amount of data uploaded so far, measured in bytes, kilobytes and megabytes respectively. - </para> - </listitem> - <listitem> - <para> - <code>{ss} {mm} {hh}</code>: the elapsed time in seconds, minutes and hours respectively. - </para> - </listitem> - </itemizedlist> - </section> - - <section id="sect-Component_Reference-Rich_inputs-richinplaceInput"> - <title>&lt;rich:inplaceInput&gt;</title> - <para> - The <classname>&lt;rich:inplaceInput&gt;</classname> component allows information to be entered in-line in blocks of text, improving readability of the text. Changes can be rendered either in-line or for the whole block, and inputs can be focused with keyboard navigation. The component has three functional states: the "view" state, where the component displays its initial setting, such as "click to edit"; the "edit" state, where the user can input text; and the "changed" state, where the new value for the component has been confirmed but can be edited again if required. - </para> - <para> - When in the initial "view" state, the starting label can be set using the <code>defaultLabel</code> attribute, such as <code>defaultLabel="click to edit"</code>. - </para> - <para> - Basic usage requires the <code>value</code> attribute to point to the expression for the current value of the component. - </para> - <para> - By default, the event to switch the component to the "edit" state is a single mouse click. This can be changed using the <code>editEvent</code> attribute to specify a different event. When switching to "edit" mode, the existing text can be automatically highlighted to make editing easier by setting <code>selectOnEdit="true"</code>. - </para> - <para> - The user can confirm and save their input by pressing the <keycap>Enter</keycap> key or cancel by pressing the <keycap>Esc</keycap> key. Alternatively, buttons for confirming or canceling can be added to the component by setting <code>showControls="true"</code>. These buttons can be positioned using the <code>controlsHorizontalPosition</code> attribute with settings of <literal>left</literal>, <literal>right</literal>, or <literal>center</literal>, and the <code>controlsVerticalPosition</code> attribute with settings <literal>bottom</literal>, <literal>center</literal>, or <literal>top</literal>. The confirmation control icons can be altered using the <code>saveControlIcon</code> and <code>cancelControlIcon</code>. Further customization is possible through the use of facets. - </para> - <para> - There are several event handlers that are specific to the <classname>&lt;rich:inplaceInput&gt;</classname> component: - </para> - <itemizedlist> - <listitem> - <para> - <code>oneditactivation</code> is triggered before the "edit" state is activated. - </para> - </listitem> - <listitem> - <para> - <code>oneditactivated</code> is triggered after the "edit" state is activated. - </para> - </listitem> - <listitem> - <para> - <code>onviewactivation</code> is triggered before the "view" or "changed" state is activated. - </para> - </listitem> - <listitem> - <para> - <code>onviewactivated</code> is triggered after the "view" or "changed" state is activated. - </para> - </listitem> - </itemizedlist> - </section> - - <section id="sect-Component_Reference-Rich_inputs-richinplaceSelect"> - <title>&lt;rich:inplaceSelect&gt;</title> - <para> - The <classname>&lt;rich:inplaceSelect&gt;</classname> component is similar to the <classname>&lt;rich:inplaceInput&gt;</classname> component, but the uses a drop-down selection box to enter text instead of a regular text field. Changes can be rendered either in-line or for the whole block, and inputs can be focused with keyboard navigation. The component has three functional states: the "view" state, where the component displays its initial setting, such as "click to edit"; the "edit" state, where the user can select a value from a drop-down list; and the "changed" state, where the new value for the component has been confirmed but can be edited again if required. - </para> - <para> - When in the initial "view" state, the starting label can be set using the <code>defaultLabel</code> attribute, such as <code>defaultLabel="click to edit"</code>. - </para> - <para> - Basic usage requires the <code>value</code> attribute to point to the expression for the current value of the component and a list of items. The list of items can be defined using the JSF components <classname>&lt;f:selectItem/&gt;</classname> and <classname>&lt;f:selectItems/&gt;</classname>. - </para> - <example id="exam-Component_Reference-richinplaceSelect-Defining_list_items_for_richinplaceSelect"> - <title>Defining list items for &lt;rich:inplaceSelect&gt;</title> - -<programlisting language="XML"> -&lt;rich:inplaceSelect value="#{bean.inputValue}" defaultLabel="click to edit" &gt; - &lt;f:selectItems value="#{bean.selectItems}" /&gt; - &lt;f.selectItem itemValue="1" itemLabel="Item 1" /&gt; - &lt;f.selectItem itemValue="2" itemLabel="Item 2" /&gt; - &lt;f.selectItem itemValue="3" itemLabel="Item 3" /&gt; - &lt;f.selectItem itemValue="4" itemLabel="Item 4" /&gt; -&lt;/rich:comboBox&gt; -</programlisting> - </example> - <para> - By default, the event to switch the component to the "edit" state is a single mouse click. This can be changed using the <code>editEvent</code> attribute to specify a different event. When switching to "edit" mode, the drop-down list of possible values will automatically be displayed; this can be deactivated by setting <code>openOnEdit="false"</code>. - </para> - <para> - Once the user selects an option from the drop-down list, the item becomes the new value for the component and the state is switched to the "changed" state. Alternatively, buttons for confirming or canceling can be added to the component by setting <code>showControls="true"</code>. These buttons can be positioned using the <code>controlsHorizontalPosition</code> attribute with settings of <literal>left</literal>, <literal>right</literal>, or <literal>center</literal>, and the <code>controlsVerticalPosition</code> attribute with settings <literal>bottom</literal>, <literal>center</literal>, or <literal>top</literal>. The confirmation control icons can be altered using the <code>saveControlIcon</code> and <code>cancelControlIcon</code>. Further customization is possible through the use of facets. - </para> - <para> - There are several event handlers that are specific to the <classname>&lt;rich:inplaceSelect&gt;</classname> component: - </para> - <itemizedlist> - <listitem> - <para> - <code>oneditactivation</code> is triggered before the "edit" state is activated. - </para> - </listitem> - <listitem> - <para> - <code>oneditactivated</code> is triggered after the "edit" state is activated. - </para> - </listitem> - <listitem> - <para> - <code>onviewactivation</code> is triggered before the "view" or "changed" state is activated. - </para> - </listitem> - <listitem> - <para> - <code>onviewactivated</code> is triggered after the "view" or "changed" state is activated. - </para> - </listitem> - </itemizedlist> - </section> - - <section id="sect-Component_Reference-Rich_inputs-richinputNumberSlider"> - <title>&lt;rich:inputNumberSlider&gt;</title> - <para> - The <classname>&lt;rich:inputNumberSlider&gt;</classname> component provides a slider for changing numerical values. Optional features include a tool-tip to display the value while sliding, and a text field for typing the numerical value which can then be validated against the slider&#39;s range. - </para> - <para> - Basic use of the component with no attributes specified will render a slider with a minimum value of 0, a maximum of 100, and a gradient step of 1, together with a text field for typing the desired numerical value. The text field can be removed by setting <code>showInput="false"</code>, and the properties of the slider can be set with the attributes <code>minValue</code>, <code>maxValue</code>, and <code>step</code>. The slider is labeled with the minimum and maximum boundary values, and a tool-tip showing the current value is shown while sliding the slider; these items can be turned off by setting <code>showBoundaryValues="false"</code> and <code>showToolTip="false"</code> respectively. - </para> - <para> - Arrow controls can be added to either side of the slider to adjust the value incrementally by setting <code>showArrows="true"</code>. Clicking the arrows move the slider indicator in that direction by the gradient step, and clicking and holding the arrows moves the indicator continuously. The time delay for each step when updating continuously can be defined using the <code>delay</code> attribute. - </para> - </section> - - <section id="sect-Component_Reference-Rich_inputs-richinputNumberSpinner"> - <title>&lt;rich:inputNumberSpinner&gt;</title> - <para> - The <classname>&lt;rich:inputNumberSpinner&gt;</classname> component is a single-line input field with buttons to increase and decrease a numerical value. The value can be changed using the corresponding directional keys on a keyboard, or by typing into the field. - </para> - <para> - Basic use of the component with no attributes specified will render a number spinner with a minimum value of 1, a maximum value of 100, and a gradient step of 1. These default properties can be re-defined with the attributes <code>minValue</code>, <code>maxValue</code>, and <code>step</code> respectively. The starting value of the spinner is the minimum value unless otherwise specified with the <code>value</code> attribute. - </para> - <para> - When changing the value using the buttons, raising the value above the maximum or cause the spinner to restart at the minimum value. Likewise, when lowering below the minimum value the spinner will reset to the maximum value. This behavior can be deactivated by setting <code>cycled="false"</code>, which will cause the buttons to stop responding when the reach the maximum or minimum value. - </para> - <para> - The ability to change the value by typing into the text field can be disabled by setting <code>enableManualInput="false"</code>. - </para> - </section> - - <section id="sect-Component_Reference-Rich_inputs-richsuggestionBox"> - <title>&lt;rich:suggestionBox&gt;</title> - <para> - The <classname>&lt;rich:suggestionBox&gt;</classname> component adds a feature-rich drop-down list of suggestions to any text input component. - </para> - <para> - The <classname>&lt;rich:suggestionBox&gt;</classname> component needs the attributes defined for basic use: <code>for</code>, which identifies the component to attach the suggestion box to; <code>suggestionAction</code>, which defines the method for getting the collection of suggestion data; and <code>var</code>, which defines a collection name for access to the currently highlighted row. Typically the suggestions are presented as a list with one or more columns of suggestion data; the layout of these columns is defined inside the <classname>&lt;rich:suggestionBox&gt;</classname> tags using <classname>&lt;h:column&gt;</classname> and other <acronym>JSF</acronym> components. - </para> - <para> - For suggestion lists with multiple columns, the <code>fetchValue</code> attribute can be used to specify which column is used when selecting the value for the input component. - </para> - <para> - The <code>tokens</code> attribute can be used to define separator characters, which are used when multiple values need to be entered and a new suggestion made for each value. For example, <code>tokens=","</code> (a comma) will begin a new suggestion query each time a comma is typed. Multiple separators can be defined with spaces in between (<code>tokens=", . ; [ ]"</code>) or linking to a bean property that holds the collection of separator tokens. - </para> - <para> - The <code>minChars</code> attribute can be used to limit sending the Ajax request until a certain amount of characters has been entered. If the query returns no results, an appropriate message to display can be set with the <code>nothingLabel</code> attribute. - </para> - <para> - Instead of returning just one value from an object, the entire object can be returned to the client and handled appropriately. This is done by specifying <code>usingSuggestObjects="true"</code> and setting the <code>onobjectchange</code> attribute to a JavaScript method to handle the object, passing the <literal>suggestion</literal> object as a parameter. - </para> - </section> - - </chapter> - <chapter id="chap-Component_Reference-Panels_and_containers" lang="en-US"> - <title>Panels and containers</title> - <para> - This chapter details those components which act as panels and containers to hold groups of other components. - </para> - <section id="sect-Component_Reference-Panels_and_containers-a4jform"> - <title>&lt;a4j:form&gt;</title> - <para> - The <classname>&lt;a4j:form&gt;</classname> builds on the functionality of the JavaServer Faces (<acronym>JSF</acronym>) component <classname>&lt;h:form&gt;</classname>, adding Ajax capabilities to the form. - </para> - <note> - <title>Note</title> - <para> - The <acronym>JSF</acronym> component <classname>&lt;h:form&gt;</classname>, on which the <classname>&lt;a4j:form&gt;</classname> component is based, had an issue whereby the <classname>&lt;h:commandLink&gt;</classname> component could not be re-rendered without re-rendering the entire form. <classname>&lt;a4j:form&gt;</classname> and <classname>&lt;a4j:commandLink&gt;</classname> fix this issue. - </para> - </note> - <para> - The <classname>&lt;a4j:form&gt;</classname> component can add indirect Ajax support to non-Ajax components on the form by setting <code>ajaxSubmit="true"</code>. It then uses the standard Ajax component attributes and updates components specified with the <code>render</code> attribute. - </para> - <important> - <title>Important</title> - <para> - <classname>&lt;a4j:form&gt;</classname> should not use <code>ajaxSubmit="true"</code> if it contains other Ajax-capable components. - </para> - <para> - Additionally, due to security reasons the file upload form element cannot be indirectly made Ajax-capable with <classname>&lt;a4j:form&gt;</classname>. - </para> - </important> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-a4joutputPanel"> - <title>&lt;a4j:outputPanel&gt;</title> - <para> - The <classname>&lt;a4j:outputPanel&gt;</classname> component is used to group together components in to update them as a whole, rather than having to specify the components individually. - </para> - <para> - The <code>layout</code> attribute can be used to determine how the component is rendered in <acronym>HTML</acronym>: - </para> - <itemizedlist> - <listitem> - <para> - <code>layout="inline"</code> is the default behavior, which will render the component as a pair of <code>&lt;span&gt;</code> tags containing the child components. - </para> - </listitem> - <listitem> - <para> - <code>layout="block"</code> will render the component as a pair of <code>&lt;div&gt;</code> tags containing the child components, which will use any defined <code>&lt;div&gt;</code> element styles. - </para> - </listitem> - <listitem> - <para> - <code>layout="none"</code> will render the component as a pair of <code>&lt;span&gt;</code> tags with an identifier equal to that of a child component. If the child component is rendered then the <code>&lt;span&gt;</code> are not included, leaving no markup representing the <classname>&lt;a4j:outputPanel&gt;</classname> in <acronym>HTML</acronym>. - </para> - </listitem> - </itemizedlist> - <para> - Setting <code>ajaxRendered="true"</code> will cause the <classname>&lt;a4j:outputPanel&gt;</classname> to be updated with each Ajax response for the page, even when not listed explicitly by the requesting component. This can in turn be overridden by specific attributes on any requesting components. - </para> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-a4jregion"> - <title>&lt;a4j:region&gt;</title> - <para> - The <classname>&lt;a4j:region&gt;</classname> component specifies a part of the document object model (<acronym>DOM</acronym>) tree to be processed on the server. The processing includes data handling during decoding, conversion, validation, and model updating. When not using <classname>&lt;a4j:region&gt;</classname>, the entire view functions as a region. - </para> - <para> - The whole form is still submitted to the server, but only the specified region is processed. Regions can be nested, in which case only the immediate region of the component initiating the request will be processed. - </para> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-richmodalPanel"> - <title>&lt;rich:modalPanel&gt;</title> - <para> - The <classname>&lt;rich:modalPanel&gt;</classname> component provides a modal panel or window that blocks interaction with the rest of the application while active. It can be easily positioned on the screen, dragged to a new position by the user, and re-sized. - </para> - <important> - <title>Important</title> - <para> - The <classname>&lt;rich:modalPanel&gt;</classname> component should always be placed outside the original <classname>&lt;h:form&gt;</classname>, and must include its own <classname>&lt;h:form&gt;</classname> if performing submits. - </para> - </important> - <para> - By default, the modal panel can be both re-sized and re-positioned by the user. The minimum possible size for the panel can be set with the These abilities can be deactivated by setting <code>resizable</code> or <code>movable</code> to <literal>false</literal> as necessary. The state of the modal panel, including size and position on screen, can be maintained and restored after submitting and reloading by setting <code>keepVisualState="true"</code>. - </para> - <para> - If <code>showWhenRendered="true"</code> then the modal panel will display when the page is first loaded. - </para> - <example id="exam-Component_Reference-richmodalPanel-richmodalPanel_example"> - <title>&lt;rich:modalPanel&gt; example</title> - -<programlisting language="xml"> -&lt;a onclick="Richfaces.showModalPanel(&#39;pnl&#39;);" href="#"&gt;Show ModalPanel&lt;/a&gt; -&lt;a4j:form&gt; - &lt;rich:modalPanel id="pnl" &gt; - &lt;a onclick="Richfaces.hideModalPanel(&#39;pnl&#39;);" href="#"&gt;Hide ModalPanel&lt;/a&gt; - &lt;/rich:modalPanel&gt; -&lt;/a4j:form&gt; -</programlisting> - </example> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-richpanel"> - <title>&lt;rich:panel&gt;</title> - <para> - The <classname>&lt;rich:panel&gt;</classname> component is a bordered panel with an optional header. - </para> - <para> - No attributes need to be listed for basic usage. To add a header to the panel, use the <code>header</code> attribute to specify the text to appear in the header. Alternatively the header can be constructed using a header facet. - </para> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-richpanelBar"> - <title>&lt;rich:panelBar&gt;</title> - <para> - The <classname>&lt;rich:panelBar&gt;</classname> is a series of panels stacked on top of each other, each collapsed such that only the header of the panel is showing. When the header of a panel is clicked, it is expanded to show the content of the panel. Clicking on a different header will collapse the previous panel and epand the selected one. Another name for the component is "accordion". Each panel in contained in a <classname>&lt;rich:panelBar&gt;</classname> component is a <classname>&lt;rich:panelBarItem&gt;</classname> component. - </para> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-richpanelBarItem"> - <title>&lt;rich:panelBarItem&gt;</title> - <para> - The <classname>&lt;rich:panelBarItem&gt;</classname> component is a panel for use with the <classname>&lt;rich:panelBar&gt;</classname> component. - </para> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-richpanelMenu"> - <title>&lt;rich:panelMenu&gt;</title> - <para> - The <classname>&lt;rich:panelMenu&gt;</classname> component can be used in conjunction with <classname>&lt;rich:panelMenuItem&gt;</classname> and <classname>&lt;rich:panelMenuGroup&gt;</classname> to create an expanding, hierarchical menu. The <classname>&lt;rich:panelMenu&gt;</classname> component&#39;s appearance can be highly customized, and the hierarchy can stretch to any number of sub-levels. - </para> - <para> - The <code>selectedChild</code> attribute is used to point to the name of the currently selected menu item. - </para> - <para> - By default, the event to expand the menu is a mouse click. This can be changed by setting <code>event</code> to specify the preferred event. Several sub-menus can be expanded a once unless the <code>expandSingle</code> is set to <literal>true</literal>, which only allows one sub-menu at a time to be expanded. - </para> - <para> - The <code>mode</code> attribute defines the submission mode for normal menu items, and the <code>expandMode</code> attribute defines the submission mode for menu items that expand and collapse. The settings for these attributes apply to the entire menu unless a menu item defines its own individual <code>mode</code> or <code>expandMode</code>. The values for <code>mode</code> and <code>expandMode</code> are: - </para> - <itemizedlist> - <listitem> - <para> - <literal>server</literal>, the default setting, which submits the form normally and completely refreshes the page; - </para> - </listitem> - <listitem> - <para> - <literal>ajax</literal>, which performs an Ajax form submission, and re-renders elements specified with the <code>render</code> attribute; and - </para> - </listitem> - <listitem> - <para> - <literal>none</literal>, which causes the <code>action</code> and <code>actionListener</code> items to be ignored, and the behavior is fully defined by the nested components instead of responses from submissions. - </para> - </listitem> - </itemizedlist> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-richpanelMenuGroup"> - <title>&lt;rich:panelMenuGroup&gt;</title> - <para> - The <classname>&lt;rich:panelMenuGroup&gt;</classname> component defines a group of <classname>&lt;rich:panelMenuItem&gt;</classname> components inside a <classname>&lt;rich:panelMenu&gt;</classname>. - </para> - <para> - If the <code>expandMode</code> is unspecified, the submission behavior for the group is inherited from the parent <classname>&lt;rich:panelMenu&gt;</classname>. Otherwise, the <code>expandMode</code> setting is used instead of the parent&#39;s behavior. - </para> - <para> - Icons for menu items can be chosen from a set of standard icons. There are three attributes that relate to the different menu states that the icon represents: <code>iconExpanded</code>, <code>iconCollapsed</code>, and <code>iconDisabled</code>. The standard icons are shown in <xref linkend="figu-Component_Reference-richpanelMenuGroup-Standard_icons" />. - </para> - <figure id="figu-Component_Reference-richpanelMenuGroup-Standard_icons"> - <title>Standard icons</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/panelMenuGroupIcons.png" format="PNG" /> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-richpanelMenuItem"> - <title>&lt;rich:panelMenuItem&gt;</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-richsimpleTogglePanel"> - <title>&lt;rich:simpleTogglePanel&gt;</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-richtabPanel"> - <title>&lt;rich:tabPanel&gt;</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-richtab"> - <title>&lt;rich:tab&gt;</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-richtogglePanel"> - <title>&lt;rich:togglePanel&gt;</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Panels_and_containers-richtoggleControl"> - <title>&lt;rich:toggleControl&gt;</title> - <para> - Incomplete - </para> - </section> - - </chapter> - <chapter id="chap-Component_Reference-Tables_and_grids" lang="en-US"> - <title>Tables and grids</title> - <para> - Incomplete - </para> - <section id="sect-Component_Reference-Tables_and_grids-richcolumn"> - <title>rich:column</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Tables_and_grids-richcolumnGroup"> - <title>rich:columnGroup</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Tables_and_grids-richcolumns"> - <title>rich:columns</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Tables_and_grids-richdataFilterSlider"> - <title>rich:dataFilterSlider</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Tables_and_grids-richdataGrid"> - <title>rich:dataGrid</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Tables_and_grids-richdataScroller"> - <title>rich:dataScroller</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Tables_and_grids-richdataTable"> - <title>rich:dataTable</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Tables_and_grids-richextendedDataTable"> - <title>rich:extendedDataTable</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Tables_and_grids-richrepeat"> - <title>rich:repeat</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Tables_and_grids-richscrollableDataTable"> - <title>rich:scrollableDataTable</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Tables_and_grids-richsubTable"> - <title>rich:subTable</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Tables_and_grids-Table_filtering"> - <title>Table filtering</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Tables_and_grids-Table_sorting"> - <title>Table sorting</title> - <para> - Incomplete - </para> - </section> - - </chapter> - <chapter id="chap-Component_Reference-Lists_and_trees" lang="en-US"> - <title>Lists and trees</title> - <para> - Incomplete - </para> - <section id="sect-Component_Reference-Lists_and_trees-richdataDefinitionList"> - <title>rich:dataDefinitionList</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Lists_and_trees-richdataList"> - <title>rich:dataList</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Lists_and_trees-richdataOrderedList"> - <title>rich:dataOrderedList</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Lists_and_trees-richlistShuttle"> - <title>rich:listShuttle</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Lists_and_trees-richorderingList"> - <title>rich:orderingList</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Lists_and_trees-richpickList"> - <title>rich:pickList</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Lists_and_trees-richchangeExpandListener"> - <title>rich:changeExpandListener</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Lists_and_trees-richnodeSelectListener"> - <title>rich:nodeSelectListener</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Lists_and_trees-richrecursiveTreeNodesAdapter"> - <title>rich:recursiveTreeNodesAdapter</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Lists_and_trees-richtree"> - <title>rich:tree</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Lists_and_trees-richtreeNode"> - <title>rich:treeNode</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Lists_and_trees-richtreeNodesAdapter"> - <title>rich:treeNodesAdapter</title> - <para> - Incomplete - </para> - </section> - - </chapter> - <chapter id="chap-Component_Reference-Menus_and_toolbars" lang="en-US"> - <title>Menus and toolbars</title> - <para> - Incomplete - </para> - <section id="sect-Component_Reference-Menus_and_toolbars-richcontextMenu"> - <title>rich:contextMenu</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Menus_and_toolbars-richdropDownMenu"> - <title>rich:dropDownMenu</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Menus_and_toolbars-richmenuGroup"> - <title>rich:menuGroup</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Menus_and_toolbars-richmenuItem"> - <title>rich:menuItem</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Menus_and_toolbars-richmenuSeparator"> - <title>rich:menuSeparator</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Menus_and_toolbars-richtoolBar"> - <title>rich:toolBar</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Menus_and_toolbars-richtoolBarGroup"> - <title>rich:toolBarGroup</title> - <para> - Incomplete - </para> - </section> - - </chapter> - <chapter id="chap-Component_Reference-Messages" lang="en-US"> - <title>Messages</title> - <para> - Incomplete - </para> - <section id="sect-Component_Reference-Messages-richmessage"> - <title>rich:message</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Messages-richmessages"> - <title>rich:messages</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Messages-richprogressBar"> - <title>rich:progressBar</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Messages-richtoolTip"> - <title>rich:toolTip</title> - <para> - Incomplete - </para> - </section> - - </chapter> - <chapter id="chap-Component_Reference-Drag_and_drop" lang="en-US"> - <title>Drag and drop</title> - <para> - Incomplete - </para> - <section id="sect-Component_Reference-Drag_and_drop-richdragIndicator"> - <title>rich:dragIndicator</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Drag_and_drop-richdragSupport"> - <title>rich:dragSupport</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Drag_and_drop-richdropSupport"> - <title>rich:dropSupport</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Drag_and_drop-richdragListener"> - <title>rich:dragListener</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Drag_and_drop-richdropListener"> - <title>rich:dropListener</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Drag_and_drop-richdndParam"> - <title>rich:dndParam</title> - <para> - Incomplete - </para> - </section> - - </chapter> - <chapter id="chap-Component_Reference-Layout_and_appearance" lang="en-US"> - <title>Layout and appearance</title> - <para> - Incomplete - </para> - <section id="sect-Component_Reference-Layout_and_appearance-a4jloadStyle"> - <title>a4j:loadStyle</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Layout_and_appearance-richeffect"> - <title>rich:effect</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Layout_and_appearance-richjQuery"> - <title>rich:jQuery</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Layout_and_appearance-richseparator"> - <title>rich:separator</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Layout_and_appearance-richspacer"> - <title>rich:spacer</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Layout_and_appearance-richpage"> - <title>rich:page</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Layout_and_appearance-richlayout"> - <title>rich:layout</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Layout_and_appearance-richlayoutPanel"> - <title>rich:layoutPanel</title> - <para> - Incomplete - </para> - </section> - - </chapter> - <chapter id="chap-Component_Reference-Resource_handling" lang="en-US"> - <title>Resource handling</title> - <para> - Incomplete - </para> - <section id="sect-Component_Reference-Resource_handling-a4jloadBundle"> - <title>a4j:loadBundle</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Resource_handling-a4jkeepAlive"> - <title>a4j:keepAlive</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Resource_handling-a4jpoll"> - <title>a4j:poll</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Resource_handling-a4jpush"> - <title>a4j:push</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Resource_handling-a4jqueue"> - <title>a4j:queue</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Resource_handling-a4jstatus"> - <title>a4j:status</title> - <para> - Incomplete - </para> - </section> - - </chapter> - <chapter id="chap-Component_Reference-Validation" lang="en-US"> - <title>Validation</title> - <para> - Incomplete - </para> - <section id="sect-Component_Reference-Validation-richajaxValidator"> - <title>rich:ajaxValidator</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Validation-richgraphValidator"> - <title>rich:graphValidator</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Validation-richbeanValidator"> - <title>rich:beanValidator</title> - <para> - Incomplete - </para> - </section> - - </chapter> - <chapter id="chap-Component_Reference-Portals" lang="en-US"> - <title>Portals</title> - <para> - Incomplete - </para> - <section id="sect-Component_Reference-Portals-a4jportlet"> - <title>a4j:portlet</title> - <para> - Incomplete - </para> - </section> - - </chapter> - <chapter id="chap-Component_Reference-Functionality_extension" lang="en-US"> - <title>Functionality extension</title> - <para> - Incomplete - </para> - <section id="sect-Component_Reference-Functionality_extension-a4jactionParam"> - <title>a4j:actionParam</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Functionality_extension-a4jajax"> - <title>a4j:ajax</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Functionality_extension-a4jajaxListener"> - <title>a4j:ajaxListener</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Functionality_extension-a4jinclude"> - <title>a4j:include</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Functionality_extension-a4jjsFunction"> - <title>a4j:jsFunction</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Functionality_extension-a4jloadScript"> - <title>a4j:loadScript</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Functionality_extension-a4jlog"> - <title>a4j:log</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Functionality_extension-richcomponentControl"> - <title>rich:componentControl</title> - <para> - Incomplete - </para> - </section> - - </chapter> - <chapter id="chap-Component_Reference-Other_components" lang="en-US"> - <title>Other components</title> - <para> - Incomplete - </para> - <section id="sect-Component_Reference-Other_components-a4jmediaOutput"> - <title>a4j:mediaOutput</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Other_components-richhotkey"> - <title>rich:hotkey</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Other_components-richinsert"> - <title>rich:insert</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Other_components-richpaint2D"> - <title>rich:paint2D</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Other_components-richgmap"> - <title>rich:gmap</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Component_Reference-Other_components-richvirtualEarth"> - <title>rich:virtualEarth</title> - <para> - Incomplete - </para> - </section> - - </chapter> - <appendix id="appe-Component_Reference-Revision_History" lang="en-US"> - <title>Revision History</title> - <simpara> - <revhistory> - <revision> - <revnumber>1.0</revnumber> - <date></date> - <author> - <firstname></firstname> - <surname></surname> - <email></email> - </author> - <revdescription> - <simplelist> - <member></member> - </simplelist> - </revdescription> - </revision> - </revhistory> - </simpara> - </appendix> - <index /> - </book> - Modified: root/docs/trunk/Component_Reference/en-US/fallback_content/Conventions.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/fallback_content/Conventions.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/fallback_content/Conventions.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Component_Reference.ent"> +%BOOK_ENTITIES; ]> <section id="sect-Component_Reference-Document_Conventions"> Modified: root/docs/trunk/Component_Reference/en-US/fallback_content/Feedback.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/fallback_content/Feedback.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/fallback_content/Feedback.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Component_Reference.ent"> +%BOOK_ENTITIES; ]> <section id="sect-Component_Reference-We_Need_Feedback"> Modified: root/docs/trunk/Component_Reference/en-US/fallback_content/Legal_Notice.xml =================================================================== --- root/docs/trunk/Component_Reference/en-US/fallback_content/Legal_Notice.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/en-US/fallback_content/Legal_Notice.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Component_Reference.ent"> +%BOOK_ENTITIES; ]> <legalnotice> Modified: root/docs/trunk/Component_Reference/pom.xml =================================================================== --- root/docs/trunk/Component_Reference/pom.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Component_Reference/pom.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,21 +1,172 @@ - -<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/xsd/maven-4.0.0.xsd"> +<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/xsd/maven-4.0.0.xsd"> + <modelVersion>4.0.0</modelVersion> - <groupId>org.jboss.jbossas</groupId> - <artifactId>RichFaces_Component_Reference-${translation}</artifactId> - <version>1.0-SNAPSHOT</version> + <groupId>org.jboss.project</groupId> + <artifactId>${docname}-${translation}</artifactId> + <version>1.0</version> <packaging>jdocbook</packaging> - <!--<name>Platform User Guide (${translation})</name>--> - <name>${env.DOCNAME}(${translation})</name> + <name>${bookname}-(${translation})</name> + + <properties> + <translation>en-US</translation> + <docname>Component_Reference</docname> + <bookname>Component Reference</bookname> + </properties> + + <repositories> + <repository> + <id>repository.jboss.org</id> + <name>JBoss Repository</name> + <layout>default</layout> + <url>http://repository.jboss.org/maven2/</url> + <snapshots> + <enabled>false</enabled> + </snapshots> + </repository> + </repositories> + <pluginRepositories> + <pluginRepository> + <id>repository.jboss.org</id> + <name>JBoss Repository</name> + <layout>default</layout> + <url>http://repository.jboss.org/maven2/</url> + <snapshots> + <enabled>false</enabled> + </snapshots> + </pluginRepository> + </pluginRepositories> + + + <profiles> + + <!-- mvn compile --> + <profile> + <id>all</id> + <activation> + <activeByDefault>true</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${docname}.pdf</finalName> + </format> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>html_single</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + <!-- mvn compile -Phtml --> + <profile> + <id>html</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + <!-- mvn compile -Phtml-single --> + <profile> + <id>html-single</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>html_single</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + <!-- mvn compile -Ppdf --> + <profile> + <id>pdf</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${docname}.pdf</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + </profiles> + <build> <plugins> <plugin> <groupId>org.jboss.maven.plugins</groupId> <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.1.3-SNAPSHOT</version> + <version>2.2.0</version> <extensions>true</extensions> <dependencies> <dependency> @@ -31,291 +182,36 @@ </dependency> </dependencies> <configuration> - <!--minmemory>1024m</minmemory> - <maxmemory>1024m</maxmemory --> - <sourceDocumentName>all-${env.DOCNAME}.xml</sourceDocumentName> - <!--<sourceDocumentName>${env.DOCNAME}</sourceDocumentName>--> - <sourceDirectory>en-US</sourceDirectory> - <imageResource> - <directory>en-US</directory> - <includes> - <include>images/*</include> - </includes> - </imageResource> - <!--<cssResource> - <directory>src/main/css</directory> - </cssResource>--> - <formats> - <!--format> - <formatName>pdf</formatName> - <note: "main-pdf" changed name to "pdf.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0> - <stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${env.DOCNAME}.pdf</finalName> - </format--> - <!--<format> - <formatName>html</formatName>--> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <!--<stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format>--> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <!--<format> - <formatName>eclipse</formatName>--> - <!--note: "main-eclipse.xsl" changed name to "eclipse.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/main-eclipse.xsl</stylesheetResource>--> - <!--<stylesheetResource>classpath:/xslt/eclipse.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format>--> - </formats> - <options> - <xincludeSupported>true</xincludeSupported> - <xmlTransformerType>saxon</xmlTransformerType> - <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme --> - <!-- could also locate the docbook dependency and inspect its version... --> - <docbookVersion>1.72.0</docbookVersion> - <transformerParameters> - <property> - <name>javax.xml.parsers.DocumentBuilderFactory</name> - <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value> - </property> - <property> - <name>javax.xml.parsers.SAXParserFactory</name> - <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value> - </property> - <!--<javax.xml.parsers.DocumentBuilderFactory>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</javax.xml.parsers.DocumentBuilderFactory> - <javax.xml.parsers.SAXParserFactory>org.apache.xerces.jaxp.SAXParserFactoryImpl</javax.xml.parsers.SAXParserFactory> - <javax.xml.validation.SchemaFactory:http\://www.w3.org/2001/XMLSchema>o... - </transformerParameters> - </options> - </configuration> - </plugin> - </plugins> - </build> - <properties> - <translation>en-US</translation> - </properties> - <pluginRepositories> - <!--original repository--> - <pluginRepository> - <id>jboss</id> - <name>JBoss Plugin Repository</name> - <url>http://repository.jboss.org/maven2</url> - <layout>default</layout> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - <pluginRepository> - <id>jboss</id> - <name>JBoss Plugin Repository</name> - <url>http://repository.jboss.org/maven2</url> - <layout>default</layout> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - <pluginRepository> - <id>snapshots.jboss</id> - <name>JBoss Snapshots</name> - <url>http://snapshots.jboss.org/maven2</url> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - <pluginRepository> - <id>people.apache</id> - <name>People Apache plugin repository</name> - <url>http://people.apache.org/repo/m2-snapshot-repository</url> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - </pluginRepositories> - <profiles> + <sourceDocumentName>${docname}.xml</sourceDocumentName> + <sourceDirectory>.</sourceDirectory> + <imageResource> + <directory>${translation}</directory> + <includes> + <include>images/*</include> + </includes> + </imageResource> + <options> + <xincludeSupported>true</xincludeSupported> + <xmlTransformerType>saxon</xmlTransformerType> + <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme --> + <!-- could also locate the docbook dependency and inspect its version... --> + <docbookVersion>1.72.0</docbookVersion> + <transformerParameters> + <property> + <name>javax.xml.parsers.DocumentBuilderFactory</name> + <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value> + </property> + <property> + <name>javax.xml.parsers.SAXParserFactory</name> + <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value> + </property> + </transformerParameters> + </options> + </configuration> + </plugin> + + </plugins> + </build> - <profile> - <id>all</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>pdf</formatName> - <!--note: "main-pdf" changed name to "pdf.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${env.DOCNAME}.pdf</finalName> - </format> - <format> - <formatName>html</formatName> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>hudson</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>html</formatName> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>html</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>html</formatName> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>html_single</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>pdf</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>pdf</formatName> - <!--note: "main-pdf" changed name to "pdf.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${env.DOCNAME}.pdf</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - </profiles> </project> + Modified: root/docs/trunk/Developer_Guide/en-US/Advanced_features.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/Advanced_features.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/Advanced_features.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Developer_Guide-Advanced_features"> Modified: root/docs/trunk/Developer_Guide/en-US/Author_Group.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/Author_Group.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/Author_Group.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <authorgroup> Modified: root/docs/trunk/Developer_Guide/en-US/Basic_concepts.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/Basic_concepts.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/Basic_concepts.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Developer_Guide-Basic_concepts"> Modified: root/docs/trunk/Developer_Guide/en-US/Book_Info.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/Book_Info.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/Book_Info.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <bookinfo id="book-Developer_Guide-Developer_Guide"> Modified: root/docs/trunk/Developer_Guide/en-US/Developer_Guide.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/Developer_Guide.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/Developer_Guide.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <book status="draft"> @@ -13,6 +15,5 @@ <xi:include href="Skinning_and_theming.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> <xi:include href="Resources.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> - <index /> </book> Modified: root/docs/trunk/Developer_Guide/en-US/Getting_started_with_RichFaces.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/Getting_started_with_RichFaces.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/Getting_started_with_RichFaces.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Developer_Guide-Getting_started_with_RichFaces"> Modified: root/docs/trunk/Developer_Guide/en-US/Introduction.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/Introduction.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/Introduction.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Developer_Guide-Introduction"> Modified: root/docs/trunk/Developer_Guide/en-US/Preface.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/Preface.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/Preface.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <preface id="pref-Developer_Guide-Preface"> Modified: root/docs/trunk/Developer_Guide/en-US/Resources.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/Resources.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/Resources.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <appendix id="appe-Developer_Guide-Resources"> Modified: root/docs/trunk/Developer_Guide/en-US/Revision_History.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/Revision_History.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/Revision_History.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <appendix id="appe-Developer_Guide-Revision_History"> Modified: root/docs/trunk/Developer_Guide/en-US/RichFaces_overview.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/RichFaces_overview.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/RichFaces_overview.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Developer_Guide-RichFaces_overview"> Modified: root/docs/trunk/Developer_Guide/en-US/Skinning_and_theming.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/Skinning_and_theming.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/Skinning_and_theming.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <chapter id="chap-Developer_Guide-Skinning_and_theming"> Deleted: root/docs/trunk/Developer_Guide/en-US/all-Developer_Guide.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/all-Developer_Guide.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/all-Developer_Guide.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,323 +0,0 @@ -<?xml version="1.0" encoding="utf-8"?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -<!ENTITY % BOOK_ENTITIES SYSTEM "Developer_Guide.ent"> -<!ENTITY PRODUCT "RichFaces"> -<!ENTITY VERSION "4.0"> -<!ENTITY VERSION_LONG "4.0.0.ALPHA2"> -<!ENTITY BOOKID "Developer_Guide"> -<!ENTITY HOLDER "Red Hat"> -<!ENTITY YEAR "2009"> -]> -<book lang="en-US" status="draft"> - <bookinfo id="book-Developer_Guide-Developer_Guide" lang="en-US"> - <title>Developer Guide</title> - <subtitle>Developing projects using RichFaces 4.0.0.ALPHA2<remark> (draft)</remark> - </subtitle> - <productname>RichFaces</productname> - <productnumber>4.0</productnumber> - <edition>0.1</edition> - <pubsnumber>0</pubsnumber> - <abstract> - <para>This book is a comprehensive reference for getting started and -working with RichFaces 4.0. It includes details of the -architecture, the framework's use in different applications, -and skinning implementations.</para></abstract> - <corpauthor> - <inlinemediaobject> - <imageobject> - <imagedata fileref="./images/rf_logo.png" format="PNG" scalefit="1"/> - </imageobject> - <textobject> - <phrase>Logo</phrase> - </textobject> - </inlinemediaobject> - </corpauthor> - <copyright> - <year>2009</year> - <holder>Red Hat</holder> - </copyright> - <!-- FOR PUBLICAN --><legalnotice xml:base="Common_Content/Legal_Notice.xml"> - <para> - Copyright <trademark class="copyright"/> 2009 Red Hat This material may only be distributed subject to the terms and conditions set forth in the GNU Free Documentation License (GFDL), V1.2 or later (the latest version is presently available at <ulink url="http://www.gnu.org/licenses/fdl.txt">http://www.gnu.org...>). - </para> -</legalnotice> - <authorgroup lang="en-US"> - <author> - <firstname>Sean</firstname> - <surname>Rogers</surname> - <affiliation> - <orgname>Red Hat</orgname> - <orgdiv>Engineering Content Services</orgdiv> - </affiliation> - <email&gt;serogers(a)redhat.com&lt;/email&gt; - </author> -</authorgroup> - </bookinfo> - <!-- <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> --><chapter id="chap-Developer_Guide-Introduction" lang="en-US"> - <title>Introduction</title> - <para> - RichFaces is a rich component library for JavaServer Faces (<acronym>JSF</acronym>) built on the open-source Ajax4jsf framework. It allows easy integration of Ajax capabilities into enterprise application development without needing to use Javascript. - </para> -</chapter> - <chapter id="chap-Developer_Guide-Getting_started_with_RichFaces" lang="en-US"> - <title>Getting started with RichFaces</title> - <para> - Incomplete - </para> - <section id="sect-Developer_Guide-Getting_started_with_RichFaces-Technical_Requirements"> - <title>Technical Requirements</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Getting_started_with_RichFaces-Installing_RichFaces"> - <title>Installing RichFaces</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Getting_started_with_RichFaces-Configuration"> - <title>Configuration</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Getting_started_with_RichFaces-Creating_a_project"> - <title>Creating a project</title> - <para> - Incomplete - </para> - </section> - -</chapter> - <chapter id="chap-Developer_Guide-RichFaces_overview" lang="en-US"> - <title>RichFaces overview</title> - <para> - Incomplete - </para> - <section id="sect-Developer_Guide-RichFaces_overview-Architecture"> - <title>Architecture</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-RichFaces_overview-Technologies"> - <title>Technologies</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-RichFaces_overview-Differences_between_JSF_and_RichFaces_mechanisms"> - <title>Differences between <acronym>JSF</acronym> and RichFaces mechanisms</title> - <para> - JavaServer Faces (<acronym>JSF</acronym>) declares render and execute processes on the client side, while RichFaces declares server-side definitions of lists. - </para> - </section> - - <section id="sect-Developer_Guide-RichFaces_overview-Restrictions"> - <title>Restrictions</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-RichFaces_overview-Using_RichFaces_with_Maven"> - <title>Using RichFaces with Maven</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-RichFaces_overview-Using_RichFaces_in_existing_JSF_projects"> - <title>Using RichFaces in existing JSF projects</title> - <para> - Incomplete - </para> - </section> - -</chapter> - <chapter id="chap-Developer_Guide-Basic_concepts" lang="en-US"> - <title>Basic concepts</title> - <para> - This chapter covers the basic concepts for using RichFaces in conjunction with Ajax and JavaServer Faces. - </para> - <section id="sect-Developer_Guide-Basic_concepts-Sending_an_Ajax_request"> - <title>Sending an Ajax request</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Basic_concepts-Receiving_events_and_updates"> - <title>Receiving events and updates</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Basic_concepts-Ajax_attributes"> - <title>Ajax attributes</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Basic_concepts-Ajax_containers"> - <title>Ajax containers</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Basic_concepts-Component_overview"> - <title>Component overview</title> - <para> - Incomplete - </para> - </section> - -</chapter> - <chapter id="chap-Developer_Guide-Advanced_features" lang="en-US"> - <title>Advanced features</title> - <para> - Incomplete - </para> - <section id="sect-Developer_Guide-Advanced_features-Additions_to_JSF2"> - <title>Additions to JSF2</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Advanced_features-Performance_optimization"> - <title>Performance optimization</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Advanced_features-Traffic_control_and_queues"> - <title>Traffic control and queues</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Advanced_features-Validation"> - <title>Validation</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Advanced_features-Filters"> - <title>Filters</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Advanced_features-Scripts_and_styles"> - <title>Scripts and styles</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Advanced_features-Error_handling"> - <title>Error handling</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Advanced_features-Managing_states"> - <title>Managing states</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Advanced_features-User_roles"> - <title>User roles</title> - <para> - Incomplete - </para> - </section> - -</chapter> - <chapter id="chap-Developer_Guide-Skinning_and_theming" lang="en-US"> - <title>Skinning and theming</title> - <para> - Incomplete - </para> - <section id="sect-Developer_Guide-Skinning_and_theming-What_are_skins_and_themes"> - <title>What are skins and themes?</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Skinning_and_theming-Using_skins"> - <title>Using skins</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Skinning_and_theming-Customizing_skins"> - <title>Customizing skins</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Skinning_and_theming-Changing_skins_at_runtime"> - <title>Changing skins at runtime</title> - <para> - Incomplete - </para> - </section> - - <section id="sect-Developer_Guide-Skinning_and_theming-Extended_skinning"> - <title>Extended skinning</title> - <para> - Incomplete - </para> - </section> - -</chapter> - <appendix id="appe-Developer_Guide-Resources" lang="en-US"> - <title>Resources</title> - <para> - Incomplete - </para> -</appendix> - <appendix id="appe-Developer_Guide-Revision_History" lang="en-US"> - <title>Revision History</title> - <simpara> - <revhistory> - <revision> - <revnumber>1.0</revnumber> - <date/> - <author> - <firstname/> - <surname/> - <email/> - </author> - <revdescription> - <simplelist> - <member/> - </simplelist> - </revdescription> - </revision> - </revhistory> - </simpara> -</appendix> - <index/> -</book> Modified: root/docs/trunk/Developer_Guide/en-US/fallback_content/Conventions.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/fallback_content/Conventions.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/fallback_content/Conventions.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Developer_Guide.ent"> +%BOOK_ENTITIES; <!ENTITY % BOOK_ENTITIES SYSTEM "Common_Content.ent"> %BOOK_ENTITIES; ]> Modified: root/docs/trunk/Developer_Guide/en-US/fallback_content/Feedback.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/fallback_content/Feedback.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/fallback_content/Feedback.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0'?> <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <section> Modified: root/docs/trunk/Developer_Guide/en-US/fallback_content/Legal_Notice.xml =================================================================== --- root/docs/trunk/Developer_Guide/en-US/fallback_content/Legal_Notice.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/en-US/fallback_content/Legal_Notice.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,5 +1,7 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Developer_Guide.ent"> +%BOOK_ENTITIES; ]> <legalnotice> Modified: root/docs/trunk/Developer_Guide/pom.xml =================================================================== --- root/docs/trunk/Developer_Guide/pom.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Developer_Guide/pom.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,21 +1,172 @@ - -<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/xsd/maven-4.0.0.xsd"> +<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/xsd/maven-4.0.0.xsd"> + <modelVersion>4.0.0</modelVersion> - <groupId>org.jboss.jbossas</groupId> - <artifactId>RichFaces_Developer_Guide-${translation}</artifactId> - <version>1.0-SNAPSHOT</version> + <groupId>org.jboss.project</groupId> + <artifactId>${docname}-${translation}</artifactId> + <version>1.0</version> <packaging>jdocbook</packaging> - <!--<name>Platform User Guide (${translation})</name>--> - <name>${env.DOCNAME}(${translation})</name> + <name>${bookname}-(${translation})</name> + + <properties> + <translation>en-US</translation> + <docname>Developer_Guide</docname> + <bookname>Developer Guide</bookname> + </properties> + + <repositories> + <repository> + <id>repository.jboss.org</id> + <name>JBoss Repository</name> + <layout>default</layout> + <url>http://repository.jboss.org/maven2/</url> + <snapshots> + <enabled>false</enabled> + </snapshots> + </repository> + </repositories> + <pluginRepositories> + <pluginRepository> + <id>repository.jboss.org</id> + <name>JBoss Repository</name> + <layout>default</layout> + <url>http://repository.jboss.org/maven2/</url> + <snapshots> + <enabled>false</enabled> + </snapshots> + </pluginRepository> + </pluginRepositories> + + + <profiles> + + <!-- mvn compile --> + <profile> + <id>all</id> + <activation> + <activeByDefault>true</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${docname}.pdf</finalName> + </format> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>html_single</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + <!-- mvn compile -Phtml --> + <profile> + <id>html</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + <!-- mvn compile -Phtml-single --> + <profile> + <id>html-single</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>html_single</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + <!-- mvn compile -Ppdf --> + <profile> + <id>pdf</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${docname}.pdf</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + </profiles> + <build> <plugins> <plugin> <groupId>org.jboss.maven.plugins</groupId> <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.1.3-SNAPSHOT</version> + <version>2.2.0</version> <extensions>true</extensions> <dependencies> <dependency> @@ -31,291 +182,36 @@ </dependency> </dependencies> <configuration> - <!--minmemory>1024m</minmemory> - <maxmemory>1024m</maxmemory --> - <sourceDocumentName>all-${env.DOCNAME}.xml</sourceDocumentName> - <!--<sourceDocumentName>${env.DOCNAME}</sourceDocumentName>--> - <sourceDirectory>en-US</sourceDirectory> - <imageResource> - <directory>en-US</directory> - <includes> - <include>images/*</include> - </includes> - </imageResource> - <!--<cssResource> - <directory>src/main/css</directory> - </cssResource>--> - <formats> - <!--format> - <formatName>pdf</formatName> - <note: "main-pdf" changed name to "pdf.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0> - <stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${env.DOCNAME}.pdf</finalName> - </format--> - <!--<format> - <formatName>html</formatName>--> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <!--<stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format>--> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <!--<format> - <formatName>eclipse</formatName>--> - <!--note: "main-eclipse.xsl" changed name to "eclipse.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/main-eclipse.xsl</stylesheetResource>--> - <!--<stylesheetResource>classpath:/xslt/eclipse.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format>--> - </formats> - <options> - <xincludeSupported>true</xincludeSupported> - <xmlTransformerType>saxon</xmlTransformerType> - <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme --> - <!-- could also locate the docbook dependency and inspect its version... --> - <docbookVersion>1.72.0</docbookVersion> - <transformerParameters> - <property> - <name>javax.xml.parsers.DocumentBuilderFactory</name> - <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value> - </property> - <property> - <name>javax.xml.parsers.SAXParserFactory</name> - <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value> - </property> - <!--<javax.xml.parsers.DocumentBuilderFactory>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</javax.xml.parsers.DocumentBuilderFactory> - <javax.xml.parsers.SAXParserFactory>org.apache.xerces.jaxp.SAXParserFactoryImpl</javax.xml.parsers.SAXParserFactory> - <javax.xml.validation.SchemaFactory:http\://www.w3.org/2001/XMLSchema>o... - </transformerParameters> - </options> - </configuration> - </plugin> - </plugins> - </build> - <properties> - <translation>en-US</translation> - </properties> - <pluginRepositories> - <!--original repository--> - <pluginRepository> - <id>jboss</id> - <name>JBoss Plugin Repository</name> - <url>http://repository.jboss.org/maven2</url> - <layout>default</layout> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - <pluginRepository> - <id>jboss</id> - <name>JBoss Plugin Repository</name> - <url>http://repository.jboss.org/maven2</url> - <layout>default</layout> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - <pluginRepository> - <id>snapshots.jboss</id> - <name>JBoss Snapshots</name> - <url>http://snapshots.jboss.org/maven2</url> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - <pluginRepository> - <id>people.apache</id> - <name>People Apache plugin repository</name> - <url>http://people.apache.org/repo/m2-snapshot-repository</url> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - </pluginRepositories> - <profiles> + <sourceDocumentName>${docname}.xml</sourceDocumentName> + <sourceDirectory>.</sourceDirectory> + <imageResource> + <directory>${translation}</directory> + <includes> + <include>images/*</include> + </includes> + </imageResource> + <options> + <xincludeSupported>true</xincludeSupported> + <xmlTransformerType>saxon</xmlTransformerType> + <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme --> + <!-- could also locate the docbook dependency and inspect its version... --> + <docbookVersion>1.72.0</docbookVersion> + <transformerParameters> + <property> + <name>javax.xml.parsers.DocumentBuilderFactory</name> + <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value> + </property> + <property> + <name>javax.xml.parsers.SAXParserFactory</name> + <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value> + </property> + </transformerParameters> + </options> + </configuration> + </plugin> + + </plugins> + </build> - <profile> - <id>all</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>pdf</formatName> - <!--note: "main-pdf" changed name to "pdf.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${env.DOCNAME}.pdf</finalName> - </format> - <format> - <formatName>html</formatName> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>hudson</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>html</formatName> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>html</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>html</formatName> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>html_single</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>pdf</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>pdf</formatName> - <!--note: "main-pdf" changed name to "pdf.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${env.DOCNAME}.pdf</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - </profiles> </project> + Modified: root/docs/trunk/Migration_Guide/en-US/Author_Group.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/Author_Group.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/en-US/Author_Group.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,7 +1,8 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Migration_Guide.ent"> +%BOOK_ENTITIES; ]> - <authorgroup> <author> <firstname>Sean</firstname> Modified: root/docs/trunk/Migration_Guide/en-US/Book_Info.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/Book_Info.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/en-US/Book_Info.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,20 +1,23 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Migration_Guide.ent"> +%BOOK_ENTITIES; ]> - <bookinfo id="book-Migration_Guide-Migration_Guide"> <title>Migration Guide</title> <subtitle>Migrating existing projects to RichFaces &VERSION_LONG;<remark> (draft)</remark> </subtitle> <productname>RichFaces</productname> <productnumber>4.0</productnumber> - <edition>0.1</edition> + <edition>0</edition> <pubsnumber>0</pubsnumber> <abstract> - <para>This book details how to take an existing RichFaces project and + <para> +This book details how to take an existing RichFaces project and upgrade it for use with RichFaces &VERSION;. It covers changes in component usage and behaviors, as well as new framework features -which may affect existing RichFaces projects.</para> +which may affect existing RichFaces projects. +</para> </abstract> <corpauthor> <inlinemediaobject> @@ -30,14 +33,13 @@ <year>&YEAR;</year> <holder>&HOLDER;</holder> </copyright> - - <!--FOR PUBLICAN --> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Common_Content/Legal_Notice.xml"> - <!--FOR JDOCBOOK:--> - <xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"> - <xi:include href="fallback_content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - </xi:fallback> + <!-- FOR PUBLICAN --> + <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude"> + <!-- FOR JDOCBOOK: --> + <xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"> + <xi:include href="fallback_content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + </xi:fallback> </xi:include> - <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> + <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> </bookinfo> - + Modified: root/docs/trunk/Migration_Guide/en-US/Changes_and_new_features.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/Changes_and_new_features.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/en-US/Changes_and_new_features.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,7 +1,8 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Migration_Guide.ent"> +%BOOK_ENTITIES; ]> - <chapter id="chap-Migration_Guide-Changes_and_new_features"> <title>Changes and new features</title> <para> @@ -1054,7 +1055,7 @@ </listitem> <listitem> <para> - Yahoo!&#39;s best practices for high performance have been implemented. Refer to <ulink url="http://developer.yahoo.com/performance/">http://develop... for details on Yahoo!&#39;s guidelines. + Yahoo!'s best practices for high performance have been implemented. Refer to <ulink url="http://developer.yahoo.com/performance/">http://develop... for details on Yahoo!'s guidelines. </para> </listitem> </itemizedlist> @@ -1125,14 +1126,14 @@ </para> </section> - <!-- + <!-- <section> <title>&lt;a4j:jsFunction&gt;</title> <para> </para> </section> - --> + --> <section id="sect-Migration_Guide-Feature_changes-a4jlog"> <title>&lt;a4j:log&gt;</title> <para> @@ -1195,14 +1196,14 @@ </para> </section> - <!-- + <!-- <section> <title>&lt;a4j:region&gt;</title> <para> </para> </section> - --> + --> <section id="sect-Migration_Guide-Feature_changes-a4jstatus"> <title>&lt;a4j:status&gt;</title> <para> @@ -1270,7 +1271,7 @@ <para> Several new components and behaviors have been added to RichFaces &VERSION;, some of which replace the functionality of deprecated elements. For full details on how to use these new components and behaviors, refer to the <citetitle>Developer Guide</citetitle>. </para> - <!-- dataTable, dataLists, trees possibly included here as they may be consolidated --> + <!-- dataTable, dataLists, trees possibly included here as they may be consolidated --> <section id="sect-Migration_Guide-New_components_and_behaviors-a4jajax"> <title>&lt;a4j:ajax&gt;</title> <para> @@ -1284,7 +1285,7 @@ <section id="sect-Migration_Guide-New_components_and_behaviors-richbusyBehavior"> <title>&lt;rich:busyBehavior&gt;</title> <para> - <classname>&lt;rich:busyBehavior&gt;</classname> is used when heavy processing takes place to provide feedback to the user. It can be attached to a component&#39;s events to trigger appropriate messages. + <classname>&lt;rich:busyBehavior&gt;</classname> is used when heavy processing takes place to provide feedback to the user. It can be attached to a component's events to trigger appropriate messages. </para> </section> Modified: root/docs/trunk/Migration_Guide/en-US/Introduction.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/Introduction.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/en-US/Introduction.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,7 +1,8 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Migration_Guide.ent"> +%BOOK_ENTITIES; ]> - <chapter id="chap-Migration_Guide-Introduction"> <title>Introduction</title> <para> Modified: root/docs/trunk/Migration_Guide/en-US/Migration_Guide.ent =================================================================== --- root/docs/trunk/Migration_Guide/en-US/Migration_Guide.ent 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/en-US/Migration_Guide.ent 2009-11-27 03:27:33 UTC (rev 16020) @@ -2,5 +2,5 @@ <!ENTITY VERSION "4.0"> <!ENTITY VERSION_LONG "4.0.0.ALPHA2"> <!ENTITY BOOKID "Migration_Guide"> -<!ENTITY HOLDER "Red Hat"> +<!ENTITY HOLDER "Red Hat Inc."> <!ENTITY YEAR "2009"> Modified: root/docs/trunk/Migration_Guide/en-US/Migration_Guide.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/Migration_Guide.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/en-US/Migration_Guide.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,14 +1,14 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Migration_Guide.ent"> +%BOOK_ENTITIES; ]> - <book status="draft"> - <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> - <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> - <xi:include href="Introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> - <xi:include href="Upgrading.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> - <xi:include href="Changes_and_new_features.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> - <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> - <index /> + <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Upgrading.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Changes_and_new_features.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> </book> Modified: root/docs/trunk/Migration_Guide/en-US/Preface.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/Preface.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/en-US/Preface.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,22 +1,22 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Migration_Guide.ent"> +%BOOK_ENTITIES; ]> - <preface id="pref-Migration_Guide-Preface"> <title>Preface</title> - <!--FOR JDOCBOOK--> + <!-- FOR JDOCBOOK --> <xi:include href="Common_Content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude"> - <!--FOR PUBLICAN--> + <!-- FOR PUBLICAN --> <xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"> <xi:include href="fallback_content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> </xi:fallback> </xi:include> - - <!--PUBLICAN'S ORIGINAL XINCLUDES--> + <!-- PUBLICAN'S ORIGINAL XINCLUDES --> <xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude"> <xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"> <xi:include href="Common_Content/Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude"> - <!--FOR JDOCBOOK--> + <!-- FOR JDOCBOOK --> <xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"> <xi:include href="fallback_content/Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> </xi:fallback> Modified: root/docs/trunk/Migration_Guide/en-US/Revision_History.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/Revision_History.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/en-US/Revision_History.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,7 +1,8 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Migration_Guide.ent"> +%BOOK_ENTITIES; ]> - <appendix id="appe-Migration_Guide-Revision_History"> <title>Revision History</title> <simpara> Modified: root/docs/trunk/Migration_Guide/en-US/Upgrading.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/Upgrading.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/en-US/Upgrading.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,7 +1,8 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Migration_Guide.ent"> +%BOOK_ENTITIES; ]> - <chapter id="chap-Migration_Guide-Upgrading"> <title>Upgrading</title> <para> @@ -29,7 +30,7 @@ <step id="step-Migration_Guide-Installation-Install_libraries"> <title>Install libraries</title> <para> - Copy the following libraries from the RichFaces package to your application&#39;s <filename class="directory">WEB-INF/lib</filename> libraries directory: + Copy the following libraries from the RichFaces package to your application's <filename class="directory">WEB-INF/lib</filename> libraries directory: </para> <itemizedlist> <listitem> @@ -86,7 +87,7 @@ The namespace and library inclusions are the same as those for previous versions of RichFaces. </para> <para> - The RichFaces namespaces need to be declared in the project&#39;s XHTML pages. + The RichFaces namespaces need to be declared in the project's XHTML pages. </para> <programlisting role="XML"> Deleted: root/docs/trunk/Migration_Guide/en-US/all-Migration_Guide.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/all-Migration_Guide.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/en-US/all-Migration_Guide.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,1727 +0,0 @@ -<?xml version="1.0" encoding="utf-8"?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -<!ENTITY % BOOK_ENTITIES SYSTEM "Migration_Guide.ent"> -<!ENTITY PRODUCT "RichFaces"> -<!ENTITY VERSION "4.0"> -<!ENTITY VERSION_LONG "4.0.0.ALPHA2"> -<!ENTITY BOOKID "Migration_Guide"> -<!ENTITY HOLDER "Red Hat"> -<!ENTITY YEAR "2009"> -]> -<book lang="en-US" status="draft"> - <bookinfo id="book-Migration_Guide-Migration_Guide" lang="en-US"> - <title>Migration Guide</title> - <subtitle>Migrating existing projects to RichFaces 4.0.0.ALPHA2<remark> (draft)</remark> - </subtitle> - <productname>RichFaces</productname> - <productnumber>4.0</productnumber> - <edition>0.1</edition> - <pubsnumber>0</pubsnumber> - <abstract> - <para>This book details how to take an existing RichFaces project and -upgrade it for use with RichFaces 4.0. It covers changes in -component usage and behaviors, as well as new framework features -which may affect existing RichFaces projects.</para></abstract> - <corpauthor> - <inlinemediaobject> - <imageobject> - <imagedata fileref="./images/rf_logo.png" format="PNG" scalefit="1"/> - </imageobject> - <textobject> - <phrase>Logo</phrase> - </textobject> - </inlinemediaobject> - </corpauthor> - <copyright> - <year>2009</year> - <holder>Red Hat</holder> - </copyright> - <!-- FOR PUBLICAN --><legalnotice xml:base="Common_Content/Legal_Notice.xml"> - <para> - Copyright <trademark class="copyright"/> 2009 Red Hat This material may only be distributed subject to the terms and conditions set forth in the GNU Free Documentation License (GFDL), V1.2 or later (the latest version is presently available at <ulink url="http://www.gnu.org/licenses/fdl.txt">http://www.gnu.org...>). - </para> -</legalnotice> - <authorgroup lang="en-US"> - <author> - <firstname>Sean</firstname> - <surname>Rogers</surname> - <affiliation> - <orgname>Red Hat</orgname> - <orgdiv>Engineering Content Services</orgdiv> - </affiliation> - <email&gt;serogers(a)redhat.com&lt;/email&gt; - </author> -</authorgroup> - </bookinfo> - <preface id="pref-Migration_Guide-Preface" lang="en-US"> - <title>Preface</title> - <!-- FOR JDOCBOOK --><section xml:base="Common_Content/Conventions.xml"> - <title>Document Conventions</title> - <para> - This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information. - </para> - <para> - In PDF and paper editions, this manual uses typefaces drawn from the <ulink url="https://fedorahosted.org/liberation-fonts/">Liberation Fonts</ulink> set. The Liberation Fonts set is also used in HTML editions if the set is installed on your system. If not, alternative but equivalent typefaces are displayed. Note: Red Hat Enterprise Linux 5 and later includes the Liberation Fonts set by default. - </para> - <section> - <title>Typographic Conventions</title> - <para> - Four typographic conventions are used to call attention to specific words and phrases. These conventions, and the circumstances they apply to, are as follows. - </para> - <para> - <literal>Mono-spaced Bold</literal> - </para> - <para> - Used to highlight system input, including shell commands, file names and paths. Also used to highlight key caps and key-combinations. For example: - </para> - <blockquote> - <para> - To see the contents of the file <filename>my_next_bestselling_novel</filename> in your current working directory, enter the <command>cat my_next_bestselling_novel</command> command at the shell prompt and press <keycap>Enter</keycap> to execute the command. - </para> - </blockquote> - <para> - The above includes a file name, a shell command and a key cap, all presented in Mono-spaced Bold and all distinguishable thanks to context. - </para> - <para> - Key-combinations can be distinguished from key caps by the hyphen connecting each part of a key-combination. For example: - </para> - <blockquote> - <para> - Press <keycap>Enter</keycap> to execute the command. - </para> - <para> - Press <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F1</keycap></keycombo> to switch to the first virtual terminal. Press <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F7</keycap></keycombo> to return to your X-Windows session. - </para> - </blockquote> - <para> - The first sentence highlights the particular key cap to press. The second highlights two sets of three key caps, each set pressed simultaneously. - </para> - <para> - If source code is discussed, class names, methods, functions, variable names and returned values mentioned within a paragraph will be presented as above, in <literal>Mono-spaced Bold</literal>. For example: - </para> - <blockquote> - <para> - File-related classes include <classname>filesystem</classname> for file systems, <classname>file</classname> for files, and <classname>dir</classname> for directories. Each class has its own associated set of permissions. - </para> - </blockquote> - <para> - <application>Proportional Bold</application> - </para> - <para> - This denotes words or phrases encountered on a system, including application names; dialogue box text; labelled buttons; check-box and radio button labels; menu titles and sub-menu titles. For example: - </para> - <blockquote> - <para> - Choose <guimenu>System &gt; Preferences &gt; Mouse</guimenu> from the main menu bar to launch <application>Mouse Preferences</application>. In the <guilabel>Buttons</guilabel> tab, click the <guilabel>Left-handed mouse</guilabel> check box and click <guibutton>Close</guibutton> to switch the primary mouse button from the left to the right (making the mouse suitable for use in the left hand). - </para> - <para> - To insert a special character into a <application>gedit</application> file, choose <guimenu>Applications &gt; Accessories &gt; Character Map</guimenu> from the main menu bar. Next, choose <guimenu>Search &gt; Find…</guimenu> from the <application>Character Map</application> menu bar, type the name of the character in the <guilabel>Search</guilabel> field and click <guibutton>Next</guibutton>. The character you sought will be highlighted in the <guilabel>Character Table</guilabel>. Double-click this highlighted character to place it in the <guilabel>Text to copy</guilabel> field and then click the <guibutton>Copy</guibutton> button. Now switch back to your document and choose <guimenu>Edit &gt; Paste</guimenu> from the <application>gedit</application> menu bar. - </para> - </blockquote> - <para> - The above text includes application names; system-wide menu names and items; application-specific menu names; and buttons and text found within a GUI interface, all presented in Proportional Bold and all distinguishable by context. - </para> - <para> - Note the <guimenu>&gt;</guimenu> shorthand used to indicate traversal through a menu and its sub-menus. This is to avoid the difficult-to-follow 'Select <guimenuitem>Mouse</guimenuitem> from the <guimenu>Preferences</guimenu> sub-menu in the <guimenu>System</guimenu> menu of the main menu bar' approach. - </para> - <para> - <command><replaceable>Mono-spaced Bold Italic</replaceable></command> or <application><replaceable>Proportional Bold Italic</replaceable></application> - </para> - <para> - Whether Mono-spaced Bold or Proportional Bold, the addition of Italics indicates replaceable or variable text. Italics denotes text you do not input literally or displayed text that changes depending on circumstance. For example: - </para> - <blockquote> - <para> - To connect to a remote machine using ssh, type <command>ssh <replaceable&gt;username&lt;/replaceable&gt;(a)&lt;replaceable&gt;domain.name&lt;/replaceable&gt;&lt;/command&gt; at a shell prompt. If the remote machine is <filename>example.com</filename> and your username on that machine is john, type <command>ssh john(a)example.com&lt;/command&gt;. - </para> - <para> - The <command>mount -o remount <replaceable>file-system</replaceable></command> command remounts the named file system. For example, to remount the <filename>/home</filename> file system, the command is <command>mount -o remount /home</command>. - </para> - <para> - To see the version of a currently installed package, use the <command>rpm -q <replaceable>package</replaceable></command> command. It will return a result as follows: <command><replaceable>package-version-release</replaceable></command>. - </para> - </blockquote> - <para> - Note the words in bold italics above — username, domain.name, file-system, package, version and release. Each word is a placeholder, either for text you enter when issuing a command or for text displayed by the system. - </para> - <para> - Aside from standard usage for presenting the title of a work, italics denotes the first use of a new and important term. For example: - </para> - <blockquote> - <para> - When the Apache HTTP Server accepts requests, it dispatches child processes or threads to handle them. This group of child processes or threads is known as a <firstterm>server-pool</firstterm>. Under Apache HTTP Server 2.0, the responsibility for creating and maintaining these server-pools has been abstracted to a group of modules called <firstterm>Multi-Processing Modules</firstterm> (<firstterm>MPMs</firstterm>). Unlike other modules, only one module from the MPM group can be loaded by the Apache HTTP Server. - </para> - </blockquote> - </section> - - <section> - <title>Pull-quote Conventions</title> - <para> - Two, commonly multi-line, data types are set off visually from the surrounding text. - </para> - <para> - Output sent to a terminal is set in <computeroutput>Mono-spaced Roman</computeroutput> and presented thus: - </para> - -<screen> -books Desktop documentation drafts mss photos stuff svn -books_tests Desktop1 downloads images notes scripts svgs -</screen> - <para> - Source-code listings are also set in <computeroutput>Mono-spaced Roman</computeroutput> but are presented and highlighted as follows: - </para> - -<programlisting language="java"> -package org.jboss.book.jca.ex1; - -import javax.naming.InitialContext; - -public class ExClient -{ - public static void main(String args[]) - throws Exception - { - InitialContext iniCtx = new InitialContext(); - Object ref = iniCtx.lookup("EchoBean"); - EchoHome home = (EchoHome) ref; - Echo echo = home.create(); - - System.out.println("Created Echo"); - - System.out.println("Echo.echo('Hello') = " + echo.echo("Hello")); - } - -} -</programlisting> - </section> - - <section> - <title>Notes and Warnings</title> - <para> - Finally, we use three visual styles to draw attention to information that might otherwise be overlooked. - </para> - <note> - <title>Note</title> - <para> - A Note is a tip or shortcut or alternative approach to the task at hand. Ignoring a note should have no negative consequences, but you might miss out on a trick that makes your life easier. - </para> - </note> - <important> - <title>Important</title> - <para> - Important boxes detail things that are easily missed: configuration changes that only apply to the current session, or services that need restarting before an update will apply. Ignoring Important boxes won't cause data loss but may cause irritation and frustration. - </para> - </important> - <warning> - <title>Warning</title> - <para> - A Warning should not be ignored. Ignoring warnings will most likely cause data loss. - </para> - </warning> - </section> - -</section> - <!-- PUBLICAN'S ORIGINAL XINCLUDES --><section xml:base="Common_Content/Feedback.xml"> - <title>We Need Feedback!</title> - <indexterm> - <primary>feedback</primary> - <secondary>contact information for this manual</secondary> - </indexterm> - <para> - You should over ride this by creating your own local Feedback.xml file. - </para> -</section> - -</preface> - <chapter id="chap-Migration_Guide-Introduction" lang="en-US"> - <title>Introduction</title> - <para> - RichFaces 4.0 introduces many improvements and refinements to the already comprehensive RichFaces framework. Migrating your RichFaces projects to version 4.0 brings several advantages to your applications, including: - </para> - <itemizedlist> - <listitem> - <para> - complete integration with JavaServer Faces (<acronym>JSF</acronym>) 2.0, using new features and standardizing components; - </para> - </listitem> - <listitem> - <para> - performance improvements throughout the components and core features; - </para> - </listitem> - <listitem> - <para> - consistency throughout the framework, forming conventions and standards; and - </para> - </listitem> - <listitem> - <para> - simplification of project creation, build procedures, and application extension. - </para> - </listitem> - </itemizedlist> - <para> - This book guides you through the process of migrating to RichFaces 4.0, and highlights important changes that have been made to the framework and how they may affect your projects and applications. - </para> -</chapter> - <chapter id="chap-Migration_Guide-Upgrading" lang="en-US"> - <title>Upgrading</title> - <para> - Upgrading an existing project to use the RichFaces 4.0 framework only requires that the new libraries replace the old ones. For a complete installation guide for new projects, refer to the <citetitle>Developer Guide</citetitle>. - </para> - <section id="sect-Migration_Guide-Upgrading-Before_upgrading"> - <title>Before upgrading</title> - <para> - Ensure you make a back-up copy of any projects and settings before upgrading an existing RichFaces installation. - </para> - <para> - Check that the environment you are working in meets the RichFaces technical requirements listed in the <citetitle>Developer Guide</citetitle>. - </para> - </section> - - <section id="sect-Migration_Guide-Upgrading-Installation"> - <title>Installation</title> - <procedure> - <step id="step-Migration_Guide-Installation-Download_RichFaces_packages"> - <title>Download RichFaces packages</title> - <para> - If you have not already done so, download the RichFaces binaries from the RichFaces downloads page at <ulink url="http://www.jboss.org/richfaces/download.html">http://ww...;. - </para> - </step> - <step id="step-Migration_Guide-Installation-Install_libraries"> - <title>Install libraries</title> - <para> - Copy the following libraries from the RichFaces package to your application's <filename class="directory">WEB-INF/lib</filename> libraries directory: - </para> - <itemizedlist> - <listitem> - <para> - <filename class="libraryfile">richfaces-api</filename> - </para> - </listitem> - <listitem> - <para> - <filename class="libraryfile">richfaces-impl</filename> - </para> - </listitem> - <listitem> - <para> - <filename class="libraryfile">core-ui</filename> - </para> - </listitem> - </itemizedlist> - <para> - Existing projects should already contain the following libraries; if not, they will need to be included in the libraries directory as well: - </para> - <itemizedlist> - <listitem> - <para> - <filename class="libraryfile">commons-logging</filename> - </para> - </listitem> - <listitem> - <para> - <filename class="libraryfile">commons-beanutils</filename> - </para> - </listitem> - <listitem> - <para> - <filename class="libraryfile">slf4j-api</filename> - </para> - </listitem> - <listitem> - <para> - <filename class="libraryfile">slf4j-log4j12</filename> - </para> - </listitem> - </itemizedlist> - </step> - <step id="step-Migration_Guide-Installation-Set_up_Maven"> - <title>Set up Maven</title> - <para> - For existing projects, you should already have a Maven installation set up for RichFaces. If not, refer to the <citetitle>Developer Guide</citetitle> for how to set up Maven. - </para> - </step> - <step id="step-Migration_Guide-Installation-Namespace_and_taglib_declaration"> - <title>Namespace and taglib declaration</title> - <para> - The namespace and library inclusions are the same as those for previous versions of RichFaces. - </para> - <para> - The RichFaces namespaces need to be declared in the project's XHTML pages. - </para> - -<programlisting role="XML"> -&lt;ui:composition -xmlns:a4j="http://richfaces.org/a4j" -xmlns:rich="http://richfaces.org/rich"&gt; - ... -&lt;/ui:composition&gt; -</programlisting> - <para> - Also add the RichFaces libraries to the JSP pages using <code>taglib</code>. - </para> - -<programlisting role="XML"> -&lt;%@ taglib uri="http://richfaces.org/a4j" prefix="a4j"%&gt; -&lt;%@ taglib uri="http://richfaces.org/rich" prefix="rich"%&gt; -</programlisting> - <note> - <title>Note</title> - <para> - With RichFaces 4.0, it is no longer necessary to modify the <filename>web.xml</filename> and <filename>faces-config.xml</filename> files of a project to use the framework. - </para> - </note> - </step> - </procedure> - - </section> - -</chapter> - <chapter id="chap-Migration_Guide-Changes_and_new_features" lang="en-US"> - <title>Changes and new features</title> - <para> - There have been several changes made to the RichFaces framework for version 4.0 that may affect migrated projects. - </para> - <section id="sect-Migration_Guide-Changes_and_new_features-JSF_2_integration"> - <title>JSF 2 integration</title> - <para> - RichFaces 4.0 has full support for JavaServer Faces (<acronym>JSF</acronym>) 2. - </para> - </section> - - <section id="sect-Migration_Guide-Changes_and_new_features-Standardized_attributes"> - <title>Standardized attributes</title> - <para> - Several component and event attribute names have been changed from those used in previous versions of RichFaces. The names have been changed to be more consistent with attribute names used by JavaServer Faces 2, so as to provide standardized usage. Many of the name changes also provide more consistency and cleanliness within the framework itself. Other attributes have been deprecated in favor of consistent functionality. - </para> - <section id="sect-Migration_Guide-Standardized_attributes-Name_changes"> - <title>Name changes</title> - <para> - <xref linkend="tabl-Migration_Guide-Name_changes-Attribute_name_changes"/> lists attribute names that have been changed, and which components and events are affected. - </para> - <table id="tabl-Migration_Guide-Name_changes-Attribute_name_changes"> - <title>Attribute name changes</title> - <tgroup cols="3"> - <thead> - <row> - <entry> - Attribute details - </entry> - <entry> - Affected a4j components - </entry> - <entry> - Affected rich components - </entry> - </row> - </thead> - <tbody> - <row> - <entry> - <para> - <code>process</code> - </para> - <para> - Changed to <code>execute</code> in 4.0. - </para> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;a4j:ajax&gt;</classname> (was <classname>&lt;a4j:support&gt;</classname>) - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandButton&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandLink&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:form&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:jsFunction&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:poll&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:push&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;rich:calendar&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataFilterSlider&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataScroller&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dropSupport&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:menuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuGroup&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:progressBar&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:simpleTogglePanel&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:suggestionBox&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tab&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:toggleControl&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tree&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:treeNode&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry> - <para> - <code>reRender</code> - </para> - <para> - Changed to <code>render</code> in 4.0. - </para> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;a4j:ajax&gt;</classname> (was <classname>&lt;a4j:support&gt;</classname>) - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandButton&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandLink&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:form&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:jsFunction&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:poll&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:push&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;rich:ajaxValidator&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:calendar&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataFilterSlider&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataScroller&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataTable&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dragSupport&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dropSupport&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:extendedDataTable&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:menuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuGroup&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:progressBar&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:scrollableDataTable&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:simpleTogglePanel&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:suggestionBox&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tab&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tree&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:treeNode&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry> - <para> - <code>eventsQueue</code> - </para> - <para> - Changed to <code>queue</code> in 4.0. - </para> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;a4j:ajax&gt;</classname> (was <classname>&lt;a4j:support&gt;</classname>) - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandButton&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandLink&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:form&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:jsFunction&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:poll&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:push&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;rich:ajaxValidator&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:calendar&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataFilterSlider&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataScroller&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dragSupport&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dropSupport&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:menuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuGroup&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:progressBar&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:scrollableDataTable&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:simpleTogglePanel&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:suggestionBox&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tab&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:toggleControl&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tree&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry> - <para> - <code>limitToList</code> - </para> - <para> - Changed to <code>limitRender</code> in 4.0. - </para> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;a4j:ajax&gt;</classname> (was <classname>&lt;a4j:support&gt;</classname>) - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandButton&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandLink&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:form&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:jsFunction&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:poll&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:push&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;rich:ajaxValidator&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:calendar&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataFilterSlider&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataScroller&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dragSupport&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dropSupport&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:menuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuGroup&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:progressBar&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:scrollableDataTable&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:simpleTogglePanel&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:suggestionBox&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tab&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:toggleControl&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tree&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:treeNode&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry> - <para> - <code>onbeforedomupdate</code> - </para> - <para> - Changed to <code>onsuccess</code> in 4.0. - </para> - </entry> - <entry> - <para> - All components - </para> - </entry> - <entry> - <para> - All components - </para> - </entry> - </row> - </tbody> - </tgroup> - </table> - </section> - - <section id="sect-Migration_Guide-Standardized_attributes-Deprecated_attributes"> - <title>Deprecated attributes</title> - <para> - <xref linkend="tabl-Migration_Guide-Deprecated_attributes-Deprecated_attributes"/> lists attributes which have been deprecated in RichFaces 4.0, along with preferred ways to replicate their functionality. - </para> - <table id="tabl-Migration_Guide-Deprecated_attributes-Deprecated_attributes"> - <title>Deprecated attributes</title> - <tgroup cols="3"> - <thead> - <row> - <entry> - Attribute details - </entry> - <entry> - Affected a4j components - </entry> - <entry> - Affected rich components - </entry> - </row> - </thead> - <tbody> - <row> - <entry> - <para> - <code>ignoreDupResponses</code> - </para> - <para> - Deprecated. Functionality moved to <code>queue</code> in 4.0. - </para> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;a4j:ajax&gt;</classname> (was <classname>&lt;a4j:support&gt;</classname>) - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandButton&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandLink&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:form&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:jsFunction&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:poll&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:push&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:queue&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;rich:ajaxValidator&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:calendar&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataFilterSlider&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataScroller&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dragSupport&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dropSupport&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:menuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuGroup&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:progressBar&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:scrollableDataTable&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:simpleTogglePanel&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:suggestionBox&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tab&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:toggleControl&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tree&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:treeNode&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry> - <para> - <code>requestDelay</code> - </para> - <para> - Deprecated. Functionality moved to <code>queue</code> in 4.0. - </para> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;a4j:ajax&gt;</classname> (was <classname>&lt;a4j:support&gt;</classname>) - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandButton&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandLink&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:form&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:jsFunction&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:queue&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;rich:ajaxValidator&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:calendar&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataFilterSlider&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataScroller&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dragSupport&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dropSupport&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:menuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuGroup&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:scrollableDataTable&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:simpleTogglePanel&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:suggestionBox&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tab&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tree&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry> - <para> - <code>ajaxSingle</code> - </para> - <para> - Deprecated. Use <code>execute="@this"</code> in 4.0 instead. - </para> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;a4j:ajax&gt;</classname> (was <classname>&lt;a4j:support&gt;</classname>) - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandButton&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:commandLink&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:form&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:jsFunction&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:poll&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:push&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - <entry> - <itemizedlist> - <listitem> - <para> - <classname>&lt;rich:calendar&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataFilterSlider&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dataScroller&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:dropSupport&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:fileUpload&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:menuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuGroup&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:panelMenuItem&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:progressBar&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:simpleTogglePanel&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:suggestionBox&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tab&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:toggleControl&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:toolTip&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:tree&gt;</classname> - </para> - </listitem> - <listitem> - <para> - <classname>&lt;rich:treeNode&gt;</classname> - </para> - </listitem> - </itemizedlist> - </entry> - </row> - </tbody> - </tgroup> - </table> - </section> - - </section> - - <section id="sect-Migration_Guide-Changes_and_new_features-Performance"> - <title>Performance</title> - <para> - The RichFaces framework has been extensively refined to provide better performance for applications. This includes improvements to bandwidth requirements for generated markup, size and number of required resources for Javascript and Cascading Style Sheets (<acronym>CSS</acronym>), and other general performance improvements. - </para> - <section id="sect-Migration_Guide-Performance-Bandwidth_for_generated_markup"> - <title>Bandwidth for generated markup</title> - <para> - Several considerations have been made to improve the use of bandwidth when generating markup. - </para> - <itemizedlist> - <listitem> - <para> - <acronym>XHTML</acronym> markup has been simplified and streamlined using best practices, such as avoiding tables for layout. - </para> - </listitem> - <listitem> - <para> - Default attribute values are not rendered. - </para> - </listitem> - <listitem> - <para> - Javascript use has been simplified with shorter function names and only one proxy call per form. - </para> - </listitem> - <listitem> - <para> - Yahoo!'s best practices for high performance have been implemented. Refer to <ulink url="http://developer.yahoo.com/performance/">http://develop... for details on Yahoo!'s guidelines. - </para> - </listitem> - </itemizedlist> - </section> - - <section id="sect-Migration_Guide-Performance-Resource_requirements"> - <title>Resource requirements</title> - <para> - The three Javascript libraries previously used by the RichFaces framework have been consolidated and standardized into a single library for better performance. - </para> - <para> - Usage of Cascading Style Sheets (<acronym>CSS</acronym>) has been simplified, trimming out duplicate or otherwise unnecessary entries and better utilizing the cascading approach for style values. - </para> - </section> - - </section> - - <section id="sect-Migration_Guide-Changes_and_new_features-Feature_changes"> - <title>Feature changes</title> - <para> - Features have been altered or added to existing components and behaviors in the RichFaces 4.0 framework. Refer to the <citetitle>Developer Guide</citetitle> for full details on how to make use of any new features. - </para> - <section id="sect-Migration_Guide-Feature_changes-Server_side_process_and_render_mechanisms"> - <title>Server-side process and render mechanisms</title> - <para> - Some of the mechanisms for server-side processing and rendering have been altered. - </para> - <section id="sect-Migration_Guide-Server_side_process_and_render_mechanisms-Regions"> - <title>Regions</title> - <para> - It is now possible to define zones for processing on the server-side without specifying <code>execute</code> definitions for every component. The <code>execute="@region"</code> property can be used to process regions defined on the server side. - </para> - <important> - <title>Important</title> - <para> - This approach is different to that in <acronym>JSF 2</acronym>, which uses default values of <code>execute="@this"</code> and <code>render="@this"</code> if no other value is defined. - </para> - </important> - </section> - - <section id="sect-Migration_Guide-Server_side_process_and_render_mechanisms-execute"> - <title>execute</title> - <para> - The <code>execute</code> property has been extended to include the <literal>@region</literal> keyword, which facilitates the region rendering changes described in <xref linkend="sect-Migration_Guide-Server_side_process_and_render_mechanisms-Regions"/>. - </para> - </section> - - <section id="sect-Migration_Guide-Server_side_process_and_render_mechanisms-render"> - <title>render</title> - <para> - The <code>render</code> property can also be defined from the server side, using actions and listeners. - </para> - </section> - - </section> - - <section id="sect-Migration_Guide-Feature_changes-onbegin_event_attribute"> - <title>onbegin event attribute</title> - <para> - The <code>onbegin</code> attribute has been added to support <acronym>JSF</acronym> events with the type <literal>begin</literal>. - </para> - </section> - - <section id="sect-Migration_Guide-Feature_changes-a4jcommandButton_and_a4jcommandLink"> - <title>&lt;a4j:commandButton&gt; and &lt;a4j:commandLink&gt;</title> - <para> - Both the <classname>&lt;a4j:commandButton&gt;</classname> and <classname>&lt;a4j:commandLink&gt;</classname> use the <code>onclick</code> event attribute instead of the <code>onbegin</code> attribute. - </para> - </section> - - <!-- - <section> - <title>&lt;a4j:jsFunction&gt;</title> - <para> - - </para> - </section> - --> - <section id="sect-Migration_Guide-Feature_changes-a4jlog"> - <title>&lt;a4j:log&gt;</title> - <para> - The <classname>&lt;a4j:log&gt;</classname> behavior has had several features modified. - </para> - <itemizedlist> - <listitem> - <para> - It is now possible to switch levels on the client side. - </para> - </listitem> - <listitem> - <para> - The log can now be displayed inline with page markup, in a new browser window, or in the browser console. - </para> - </listitem> - <listitem> - <para> - An application context parameter can now be defined to log all application pages. - </para> - </listitem> - </itemizedlist> - </section> - - <section id="sect-Migration_Guide-Feature_changes-a4jmessage_and_a4jmessages"> - <title>&lt;a4j:message&gt; and &lt;a4j:messages&gt;</title> - <para> - Both the <classname>&lt;a4j:message&gt;</classname> and <classname>&lt;a4j:messages&gt;</classname> components can be automatically updated by any Ajax request, except those requests with <code>limitRender = true</code>. Attributes from previously-passed states are now cleared. - </para> - </section> - - <section id="sect-Migration_Guide-Feature_changes-a4joutputPanel"> - <title>&lt;a4j:outputPanel&gt;</title> - <para> - The <classname>&lt;a4j:outputPanel&gt;</classname> component has had several features modified. - </para> - <itemizedlist> - <listitem> - <para> - The default value for the <code>layout</code> attribute is now <literal>block</literal>. - </para> - </listitem> - <listitem> - <para> - The default value for the <code>ajaxRendered</code> attribute is now <literal>false</literal>. - </para> - </listitem> - <listitem> - <para> - If a child component is not to be rendered, a placeholder element will be included to preserve the layout. - </para> - </listitem> - </itemizedlist> - </section> - - <section id="sect-Migration_Guide-Feature_changes-a4jpush_and_a4jpoll"> - <title>&lt;a4j:push&gt; and &lt;a4j:poll&gt;</title> - <para> - Both the <classname>&lt;a4j:push&gt;</classname> and <classname>&lt;a4j:poll&gt;</classname> behaviors now raise a client-side event. For <classname>&lt;a4j:push&gt;</classname>, this is the <code>ondataavailable</code> event, while for <classname>&lt;a4j:poll&gt;</classname> it is the <code>ontimeevent</code>. - </para> - </section> - - <!-- - <section> - <title>&lt;a4j:region&gt;</title> - <para> - - </para> - </section> - --> - <section id="sect-Migration_Guide-Feature_changes-a4jstatus"> - <title>&lt;a4j:status&gt;</title> - <para> - In RichFaces 4.0, <classname>&lt;a4j:status&gt;</classname> has been implemented as a component rather than a behavior, as it should have a representation in the Document Object Model (<acronym>DOM</acronym>) tree. - </para> - <para> - The <classname>&lt;a4j:status&gt;</classname> component has had several other features modified. - </para> - <itemizedlist> - <listitem> - <para> - <classname>&lt;a4j:status&gt;</classname> no longer needs to be associated with a <classname>&lt;a4j:region&gt;</classname>. - </para> - </listitem> - <listitem> - <para> - <classname>&lt;a4j:status&gt;</classname> can now report request errors. An additional <code>errorText</code> attribute and <literal>error</literal> facet have been added to show if an error was raised when a request completed. - </para> - </listitem> - <listitem> - <para> - The event attributes now include <code>onstart</code>, <code>onstop</code>, <code>onerror</code>, and <code>onsuccess</code>. - </para> - </listitem> - <listitem> - <para> - Multiple statuses can be presented for the same view or form, or a separate status attached to each component. - </para> - </listitem> - </itemizedlist> - </section> - - <section id="sect-Migration_Guide-Feature_changes-richtogglePanel"> - <title>&lt;rich:togglePanel&gt;</title> - <para> - Incomplete. - </para> - </section> - - <section id="sect-Migration_Guide-Feature_changes-richtabPanel"> - <title>&lt;rich:tabPanel&gt;</title> - <para> - Incomplete. - </para> - </section> - - <section id="sect-Migration_Guide-Feature_changes-richtoolBar"> - <title>&lt;rich:toolBar&gt;</title> - <para> - Incomplete. - </para> - </section> - - <section id="sect-Migration_Guide-Feature_changes-richtoolTip"> - <title>&lt;rich:toolTip&gt;</title> - <para> - Incomplete. - </para> - </section> - - </section> - - <section id="sect-Migration_Guide-Changes_and_new_features-New_components_and_behaviors"> - <title>New components and behaviors</title> - <para> - Several new components and behaviors have been added to RichFaces 4.0, some of which replace the functionality of deprecated elements. For full details on how to use these new components and behaviors, refer to the <citetitle>Developer Guide</citetitle>. - </para> - <!-- dataTable, dataLists, trees possibly included here as they may be consolidated --> - <section id="sect-Migration_Guide-New_components_and_behaviors-a4jajax"> - <title>&lt;a4j:ajax&gt;</title> - <para> - The <classname>&lt;a4j:ajax&gt;</classname> behavior replaces the deprecated <classname>&lt;a4j:support&gt;</classname> behavior. - </para> - <para> - <classname>&lt;a4j:ajax&gt;</classname> uses <acronym>JSF 2</acronym>, and can be used to add Ajax capabilities to any non-Ajax <acronym>JSF</acronym> or RichFaces component. - </para> - </section> - - <section id="sect-Migration_Guide-New_components_and_behaviors-richbusyBehavior"> - <title>&lt;rich:busyBehavior&gt;</title> - <para> - <classname>&lt;rich:busyBehavior&gt;</classname> is used when heavy processing takes place to provide feedback to the user. It can be attached to a component's events to trigger appropriate messages. - </para> - </section> - - <section id="sect-Migration_Guide-New_components_and_behaviors-richpopupPanel"> - <title>&lt;rich:popupPanel&gt;</title> - <para> - Incomplete. - </para> - </section> - - </section> - - <section id="sect-Migration_Guide-Changes_and_new_features-Deprecated_components_and_behaviors"> - <title>Deprecated components and behaviors</title> - <para> - Some components and behaviors have been deprecated in RichFaces 4.0. For the most part these items have their functionality replicated by another component or behavior. - </para> - <section id="sect-Migration_Guide-Deprecated_components_and_behaviors-a4jpage"> - <title>&lt;a4j:page&gt;</title> - <para> - RichFaces 4.0 drops support for the <classname>&lt;a4j:page&gt;</classname> component. The component was previously used for solving incompatibility in the JavaServer Pages (<acronym>JSP</acronym>) environment with Apache MyFaces in early Ajax4jsf versions. - </para> - </section> - - <section id="sect-Migration_Guide-Deprecated_components_and_behaviors-a4jsupport"> - <title>&lt;a4j:support&gt;</title> - <para> - The <classname>&lt;a4j:support&gt;</classname> component had been deprecated and its functionality replaced by the <classname>&lt;a4j:ajax&gt;</classname> component. Refer to <xref linkend="sect-Migration_Guide-New_components_and_behaviors-a4jajax"/> for details. - </para> - </section> - - <section id="sect-Migration_Guide-Deprecated_components_and_behaviors-richmodalPanel"> - <title>&lt;rich:modalPanel&gt;</title> - <para> - Incomplete. - </para> - </section> - - </section> - -</chapter> - <appendix id="appe-Migration_Guide-Revision_History" lang="en-US"> - <title>Revision History</title> - <simpara> - <revhistory> - <revision> - <revnumber>0.1</revnumber> - <date>Tue Oct 20 2009</date> - <author> - <firstname>Sean</firstname> - <surname>Rogers</surname> - <email&gt;serogers(a)redhat.com&lt;/email&gt; - </author> - <revdescription> - <simplelist> - <member>Basic first draft</member> - </simplelist> - </revdescription> - </revision> - </revhistory> - </simpara> -</appendix> - <index/> -</book> Modified: root/docs/trunk/Migration_Guide/en-US/fallback_content/Conventions.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/fallback_content/Conventions.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/en-US/fallback_content/Conventions.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,10 +1,9 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -<!ENTITY % BOOK_ENTITIES SYSTEM "Common_Content.ent"> +<!ENTITY % BOOK_ENTITIES SYSTEM "../Migration_Guide.ent"> %BOOK_ENTITIES; ]> - -<section> +<section id="sect-Migration_Guide-Document_Conventions"> <title>Document Conventions</title> <para> This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information. @@ -12,7 +11,7 @@ <para> In PDF and paper editions, this manual uses typefaces drawn from the <ulink url="https://fedorahosted.org/liberation-fonts/">Liberation Fonts</ulink> set. The Liberation Fonts set is also used in HTML editions if the set is installed on your system. If not, alternative but equivalent typefaces are displayed. Note: Red Hat Enterprise Linux 5 and later includes the Liberation Fonts set by default. </para> - <section> + <section id="sect-Migration_Guide-Document_Conventions-Typographic_Conventions"> <title>Typographic Conventions</title> <para> Four typographic conventions are used to call attention to specific words and phrases. These conventions, and the circumstances they apply to, are as follows. @@ -71,7 +70,7 @@ The above text includes application names; system-wide menu names and items; application-specific menu names; and buttons and text found within a GUI interface, all presented in Proportional Bold and all distinguishable by context. </para> <para> - Note the <guimenu>&gt;</guimenu> shorthand used to indicate traversal through a menu and its sub-menus. This is to avoid the difficult-to-follow &#39;Select <guimenuitem>Mouse</guimenuitem> from the <guimenu>Preferences</guimenu> sub-menu in the <guimenu>System</guimenu> menu of the main menu bar&#39; approach. + Note the <guimenu>&gt;</guimenu> shorthand used to indicate traversal through a menu and its sub-menus. This is to avoid the difficult-to-follow 'Select <guimenuitem>Mouse</guimenuitem> from the <guimenu>Preferences</guimenu> sub-menu in the <guimenu>System</guimenu> menu of the main menu bar' approach. </para> <para> <command><replaceable>Mono-spaced Bold Italic</replaceable></command> or <application><replaceable>Proportional Bold Italic</replaceable></application> @@ -103,7 +102,7 @@ </blockquote> </section> - <section> + <section id="sect-Migration_Guide-Document_Conventions-Pull_quote_Conventions"> <title>Pull-quote Conventions</title> <para> Two, commonly multi-line, data types are set off visually from the surrounding text. @@ -137,14 +136,14 @@ System.out.println("Created Echo"); - System.out.println("Echo.echo(&#39;Hello&#39;) = " + echo.echo("Hello")); + System.out.println("Echo.echo('Hello') = " + echo.echo("Hello")); } } </programlisting> </section> - <section> + <section id="sect-Migration_Guide-Document_Conventions-Notes_and_Warnings"> <title>Notes and Warnings</title> <para> Finally, we use three visual styles to draw attention to information that might otherwise be overlooked. @@ -158,7 +157,7 @@ <important> <title>Important</title> <para> - Important boxes detail things that are easily missed: configuration changes that only apply to the current session, or services that need restarting before an update will apply. Ignoring Important boxes won&#39;t cause data loss but may cause irritation and frustration. + Important boxes detail things that are easily missed: configuration changes that only apply to the current session, or services that need restarting before an update will apply. Ignoring Important boxes won't cause data loss but may cause irritation and frustration. </para> </important> <warning> Modified: root/docs/trunk/Migration_Guide/en-US/fallback_content/Feedback.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/fallback_content/Feedback.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/en-US/fallback_content/Feedback.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,8 +1,9 @@ -<?xml version='1.0'?> +<?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Migration_Guide.ent"> +%BOOK_ENTITIES; ]> - -<section> +<section id="sect-Migration_Guide-We_Need_Feedback"> <title>We Need Feedback!</title> <indexterm> <primary>feedback</primary> @@ -12,7 +13,7 @@ If you find a typographical error in this manual, or if you have thought of a way to make this manual better, we would love to hear from you! Please submit a report in Bugzilla: <ulink url="http://bugzilla.redhat.com/bugzilla/">http://bugzilla.r... against the product <application>&PRODUCT;.</application> </para> <para> - When submitting a bug report, be sure to mention the manual&#39;s identifier: <citetitle>&BOOKID;</citetitle> + When submitting a bug report, be sure to mention the manual's identifier: <citetitle>&BOOKID;</citetitle> </para> <para> If you have a suggestion for improving the documentation, try to be as specific as possible when describing it. If you have found an error, please include the section number and some of the surrounding text so we can find it easily. Modified: root/docs/trunk/Migration_Guide/en-US/fallback_content/Legal_Notice.xml =================================================================== --- root/docs/trunk/Migration_Guide/en-US/fallback_content/Legal_Notice.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/en-US/fallback_content/Legal_Notice.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,16 +1,17 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Migration_Guide.ent"> +%BOOK_ENTITIES; ]> - <legalnotice> <para> Copyright <trademark class="copyright"></trademark> &YEAR; &HOLDER;. This material may only be distributed subject to the terms and conditions set forth in the Open Publication License, V1.0, (the latest version is presently available at <ulink url="http://www.opencontent.org/openpub/">http://www.opencon...>). </para> <para> - Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. + Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. </para> <para> - <trademark class="registered">Linux</trademark> is the registered trademark of Linus Torvalds in the United States and other countries. + <trademark class="registered">Linux</trademark> is the registered trademark of Linus Torvalds in the United States and other countries. </para> <para> All other trademarks are the property of their respective owners. Modified: root/docs/trunk/Migration_Guide/pom.xml =================================================================== --- root/docs/trunk/Migration_Guide/pom.xml 2009-11-27 01:46:45 UTC (rev 16019) +++ root/docs/trunk/Migration_Guide/pom.xml 2009-11-27 03:27:33 UTC (rev 16020) @@ -1,21 +1,172 @@ - -<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/xsd/maven-4.0.0.xsd"> +<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/xsd/maven-4.0.0.xsd"> + <modelVersion>4.0.0</modelVersion> - <groupId>org.jboss.jbossas</groupId> - <artifactId>RichFaces_Migration_Guide-${translation}</artifactId> - <version>1.0-SNAPSHOT</version> + <groupId>org.jboss.project</groupId> + <artifactId>${docname}-${translation}</artifactId> + <version>1.0</version> <packaging>jdocbook</packaging> - <!--<name>Platform User Guide (${translation})</name>--> - <name>${env.DOCNAME}(${translation})</name> + <name>${bookname}-(${translation})</name> + + <properties> + <translation>en-US</translation> + <docname>Migration_Guide</docname> + <bookname>Migration Guide</bookname> + </properties> + + <repositories> + <repository> + <id>repository.jboss.org</id> + <name>JBoss Repository</name> + <layout>default</layout> + <url>http://repository.jboss.org/maven2/</url> + <snapshots> + <enabled>false</enabled> + </snapshots> + </repository> + </repositories> + <pluginRepositories> + <pluginRepository> + <id>repository.jboss.org</id> + <name>JBoss Repository</name> + <layout>default</layout> + <url>http://repository.jboss.org/maven2/</url> + <snapshots> + <enabled>false</enabled> + </snapshots> + </pluginRepository> + </pluginRepositories> + + + <profiles> + + <!-- mvn compile --> + <profile> + <id>all</id> + <activation> + <activeByDefault>true</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${docname}.pdf</finalName> + </format> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>html_single</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + <!-- mvn compile -Phtml --> + <profile> + <id>html</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + <!-- mvn compile -Phtml-single --> + <profile> + <id>html-single</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>html_single</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + <!-- mvn compile -Ppdf --> + <profile> + <id>pdf</id> + <activation> + <activeByDefault>false</activeByDefault> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.2.0</version> + <extensions>true</extensions> + <configuration> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>${docname}.pdf</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </build> + </profile> + + </profiles> + <build> <plugins> <plugin> <groupId>org.jboss.maven.plugins</groupId> <artifactId>maven-jdocbook-plugin</artifactId> - <version>2.1.3-SNAPSHOT</version> + <version>2.2.0</version> <extensions>true</extensions> <dependencies> <dependency> @@ -31,291 +182,36 @@ </dependency> </dependencies> <configuration> - <!--minmemory>1024m</minmemory> - <maxmemory>1024m</maxmemory --> - <sourceDocumentName>all-${env.DOCNAME}.xml</sourceDocumentName> - <!--<sourceDocumentName>${env.DOCNAME}</sourceDocumentName>--> - <sourceDirectory>en-US</sourceDirectory> - <imageResource> - <directory>en-US</directory> - <includes> - <include>images/*</include> - </includes> - </imageResource> - <!--<cssResource> - <directory>src/main/css</directory> - </cssResource>--> - <formats> - <!--format> - <formatName>pdf</formatName> - <note: "main-pdf" changed name to "pdf.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0> - <stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${env.DOCNAME}.pdf</finalName> - </format--> - <!--<format> - <formatName>html</formatName>--> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <!--<stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format>--> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <!--<format> - <formatName>eclipse</formatName>--> - <!--note: "main-eclipse.xsl" changed name to "eclipse.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/main-eclipse.xsl</stylesheetResource>--> - <!--<stylesheetResource>classpath:/xslt/eclipse.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format>--> - </formats> - <options> - <xincludeSupported>true</xincludeSupported> - <xmlTransformerType>saxon</xmlTransformerType> - <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme --> - <!-- could also locate the docbook dependency and inspect its version... --> - <docbookVersion>1.72.0</docbookVersion> - <transformerParameters> - <property> - <name>javax.xml.parsers.DocumentBuilderFactory</name> - <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value> - </property> - <property> - <name>javax.xml.parsers.SAXParserFactory</name> - <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value> - </property> - <!--<javax.xml.parsers.DocumentBuilderFactory>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</javax.xml.parsers.DocumentBuilderFactory> - <javax.xml.parsers.SAXParserFactory>org.apache.xerces.jaxp.SAXParserFactoryImpl</javax.xml.parsers.SAXParserFactory> - <javax.xml.validation.SchemaFactory:http\://www.w3.org/2001/XMLSchema>o... - </transformerParameters> - </options> - </configuration> - </plugin> - </plugins> - </build> - <properties> - <translation>en-US</translation> - </properties> - <pluginRepositories> - <!--original repository--> - <pluginRepository> - <id>jboss</id> - <name>JBoss Plugin Repository</name> - <url>http://repository.jboss.org/maven2</url> - <layout>default</layout> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - <pluginRepository> - <id>jboss</id> - <name>JBoss Plugin Repository</name> - <url>http://repository.jboss.org/maven2</url> - <layout>default</layout> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - <pluginRepository> - <id>snapshots.jboss</id> - <name>JBoss Snapshots</name> - <url>http://snapshots.jboss.org/maven2</url> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - <pluginRepository> - <id>people.apache</id> - <name>People Apache plugin repository</name> - <url>http://people.apache.org/repo/m2-snapshot-repository</url> - <releases> - <enabled>true</enabled> - <updatePolicy>always</updatePolicy> - <checksumPolicy>warn</checksumPolicy> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - </pluginRepository> - </pluginRepositories> - <profiles> + <sourceDocumentName>${docname}.xml</sourceDocumentName> + <sourceDirectory>.</sourceDirectory> + <imageResource> + <directory>${translation}</directory> + <includes> + <include>images/*</include> + </includes> + </imageResource> + <options> + <xincludeSupported>true</xincludeSupported> + <xmlTransformerType>saxon</xmlTransformerType> + <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme --> + <!-- could also locate the docbook dependency and inspect its version... --> + <docbookVersion>1.72.0</docbookVersion> + <transformerParameters> + <property> + <name>javax.xml.parsers.DocumentBuilderFactory</name> + <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value> + </property> + <property> + <name>javax.xml.parsers.SAXParserFactory</name> + <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value> + </property> + </transformerParameters> + </options> + </configuration> + </plugin> + + </plugins> + </build> - <profile> - <id>all</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>pdf</formatName> - <!--note: "main-pdf" changed name to "pdf.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${env.DOCNAME}.pdf</finalName> - </format> - <format> - <formatName>html</formatName> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>hudson</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>html</formatName> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>html</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>html</formatName> - <!--note: "main-html" changed name to "xhtml.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>html_single</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>html_single</formatName> - <!--note: "nochunk-html.xsl" changed name to "xhtml-single.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> - <finalName>index.html</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - <profile> - <id>pdf</id> - <build> - <plugins> - <plugin> - <groupId>org.jboss.maven.plugins</groupId> - <artifactId>maven-jdocbook-plugin</artifactId> - <configuration> - <formats> - <format> - <formatName>pdf</formatName> - <!--note: "main-pdf" changed name to "pdf.xsl" between jbossorg-docbook-xslt - version 1.0.0 and version 1.1.0 --> - <!--<stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource>--> - <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> - <finalName>${env.DOCNAME}.pdf</finalName> - </format> - </formats> - </configuration> - </plugin> - </plugins> - </build> - </profile> - - </profiles> </project> +