Author: smumford Date: 2010-11-03 03:38:52 -0400 (Wed, 03 Nov 2010) New Revision: 4914 Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/5.1.0_Release_Notes.ent epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/5.1.0_Release_Notes.xml epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Author_Group.xml epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Book_Info.xml epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Common_Content/Conventions.xml epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Common_Content/Legal_Notice.xml epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Revision_History.xml Log: JBEPP-603: Added 5.1.0 specific content to Release Notes Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/5.1.0_Release_Notes.ent =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/5.1.0_Release_Notes.ent 2010-11-03 07:06:11 UTC (rev 4913) +++ epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/5.1.0_Release_Notes.ent 2010-11-03 07:38:52 UTC (rev 4914) @@ -1,4 +1,6 @@ <!ENTITY HOLDER "Red Hat, Inc"> <!ENTITY YEAR "2010"> <!ENTITY PRODUCT "JBoss Enterprise Portal Platform"> -<!ENTITY VERSION "5.1"> +<!ENTITY VERSION_MAJOR "5"> +<!ENTITY VERSION_MINOR "5.1"> +<!ENTITY VERSION_MICRO "5.1.0"> \ No newline at end of file Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/5.1.0_Release_Notes.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/5.1.0_Release_Notes.xml 2010-11-03 07:06:11 UTC (rev 4913) +++ epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/5.1.0_Release_Notes.xml 2010-11-03 07:38:52 UTC (rev 4914) @@ -1,218 +1,335 @@ <?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "5.1.0_Release_Notes.ent"> +%BOOK_ENTITIES; ]> -<article id="JBEPP_Release_Notes"> +<article> <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <section id="sect-Release_Notes-Introduction"> + <section id="sect-Release_Notes-Introduction"> <title>Introduction</title> - <para> - &PRODUCT; offers an intuitive, easy to manage user interface and a proven core infrastructure to enable organizations to quickly build dynamic web sites in a highly reusable way. By bringing the principals of Open Choice to the presentation layer, &PRODUCT; &VERSION; maximizes existing skills and technology investments. + <para> + &PRODUCT; offers an intuitive, easy to manage user interface and a proven core infrastructure to enable organizations to quickly build dynamic web sites in a highly reusable way. By bringing the principals of Open Choice to the presentation layer, &PRODUCT; &VERSION_MAJOR; maximizes existing skills and technology investments. </para> - <para> - By integrating proven open source frameworks such as JBoss Seam, Hibernate, Tomcat and JBoss Cache &PRODUCT; takes advantage of innovations in the open source community. As well, &PRODUCT; version &VERSION; is fully tested and supported by Red Hat, and is certified to work on many leading enterprise hardware and software products. + <para> + By integrating proven open source frameworks such as JBoss Seam, Hibernate, Tomcat and JBoss Cache &PRODUCT; takes advantage of innovations in the open source community. As well, &PRODUCT; version &VERSION_MICRO; is fully tested and supported by Red Hat, and is certified to work on many leading enterprise hardware and software products. </para> + </section> -<!-- <section> - <title>New Features</title> - <variablelist> + <section id="sect-Release_Notes-New_Features_and_Components"> + <title>New Features and Components</title> + <variablelist id="vari-Release_Notes-New_Features_and_Components-New_Features"> + <title>New Features</title> + <varlistentry> + <term>Site Publisher extension</term> + <listitem> + <para> + The &PRODUCT; &VERSION_MINOR; stream includes an optional web content authoring system add-on called Site Publisher. + </para> + <para> + Refer to <xref linkend="sect-Release_Notes-Site_Publisher"/> for a brief overview of this extension. + </para> + </listitem> + </varlistentry> - </variablelist> - </section> --> + </variablelist> + <variablelist id="vari-Release_Notes-New_Features_and_Components-Component_Upgrades_in_VERSION_MICRO"> + <title><emphasis role="bold">Component Upgrades in &VERSION_MICRO;</emphasis></title> + <varlistentry> + <term>WSRP</term> + <listitem> + <para> + The WSRP component has been upgraded to version 2.0. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>JBoss Cache</term> + <listitem> + <para> + The JBoss Cache component has been upgraded to version 3.2.6. + </para> - <section id="sect-Release_Notes-Architecture_of_PRODUCT_VERSION"> + </listitem> + + </varlistentry> + + </variablelist> + + </section> + + <section id="sect-Release_Notes-Component_Versions"> <title>Component Versions</title> - <para> - This section details the versions of the components which create the JBoss Enterprise Portal Platform 5.1. + <para> + This section details the versions of the components in JBoss Enterprise Portal Platform 5.1.0. </para> - <table> + <table id="tabl-Release_Notes-Component_Versions-JBoss_Enterprise_Portal_Platform_Component_Versions"> <title>JBoss Enterprise Portal Platform Component Versions</title> - <tgroup cols="2"> - <thead> - <row> - <entry> - Component - </entry> - <entry> - Version - </entry> - </row> - </thead> - <tbody> - <row> - <entry> - JBoss Enterprise Application Platform - </entry> - <entry> - 5.0.1-GA - </entry> - </row> - <row> - <entry> - JBoss Cache - </entry> - <entry> - 3.2.6 - </entry> - </row> - <row> - <entry> - GateIn Common - </entry> - <entry> - 2.0.3-GA - </entry> - </row> - <row> - <entry> - GateIn WCI - </entry> - <entry> - 2.0.2-GA - </entry> - </row> - <row> - <entry> - GateIn PC - </entry> - <entry> - 2.2.0-CR01 - </entry> - </row> - <row> - <entry> - GateIn WSRP - </entry> - <entry> - 2.0.0-Beta05 - </entry> - </row> - <row> - <entry> - GateIn MOP - </entry> - <entry> - 1.0.3-GA - </entry> - </row> - <row> - <entry> - GateIn SSO - </entry> - <entry> - 1.0.0-epp - </entry> - </row> - <row> - <entry> - PicketLink IDM - </entry> - <entry> - 1.1.6.GA - </entry> - </row> - <row> - <entry> - eXo JCR - </entry> - <entry> - 1.12.5-GA - </entry> - </row> - <row> - <entry> - eXo Kernel - </entry> - <entry> - 2.2.5-GA - </entry> - </row> - <row> - <entry> - Portlet Bridge - </entry> - <entry> - 2.1.0-CR01 - </entry> - </row> - <row> - <entry> - Chromattic - </entry> - <entry> - 1.0.3 - </entry> - </row> - <row> - <entry> - Apache Shindig - </entry> - <entry> - 1.0-r790473-Patch04 - </entry> - </row> - </tbody> - </tgroup> - </table> - </section> + <tgroup cols="2"> + <thead> + <row> + <entry> + Component + </entry> + <entry> + Version + </entry> - <section id="sect-Release_Notes-Certified_Environments"> + </row> + + </thead> + <tbody> + <row> + <entry> + JBoss Enterprise Application Platform + </entry> + <entry> + 5.0.1-GA + </entry> + + </row> + <row> + <entry> + JBoss Cache + </entry> + <entry> + 3.2.6 + </entry> + + </row> + <row> + <entry> + GateIn Common + </entry> + <entry> + 2.0.3-GA + </entry> + + </row> + <row> + <entry> + GateIn WCI + </entry> + <entry> + 2.0.2-GA + </entry> + + </row> + <row> + <entry> + GateIn PC + </entry> + <entry> + 2.2.0-CR01 + </entry> + + </row> + <row> + <entry> + GateIn WSRP + </entry> + <entry> + 2.0.0-Beta05 + </entry> + + </row> + <row> + <entry> + GateIn MOP + </entry> + <entry> + 1.0.3-GA + </entry> + + </row> + <row> + <entry> + GateIn SSO + </entry> + <entry> + 1.0.0-epp + </entry> + + </row> + <row> + <entry> + PicketLink IDM + </entry> + <entry> + 1.1.6.GA + </entry> + + </row> + <row> + <entry> + eXo JCR + </entry> + <entry> + 1.12.5-GA + </entry> + + </row> + <row> + <entry> + eXo Kernel + </entry> + <entry> + 2.2.5-GA + </entry> + + </row> + <row> + <entry> + Portlet Bridge + </entry> + <entry> + 2.1.0-CR01 + </entry> + + </row> + <row> + <entry> + Chromattic + </entry> + <entry> + 1.0.3 + </entry> + + </row> + <row> + <entry> + Apache Shindig + </entry> + <entry> + 1.0-r790473-Patch04 + </entry> + + </row> + + </tbody> + + </tgroup> + + </table> + + </section> + + <section id="sect-Release_Notes-Installation"> <title>Installation</title> - <para> - The JBoss Enterprise Portal Platform Installation Guide contains details of software and hardware requirements as well as detailed installation instructions. + <para> + The JBoss Enterprise Portal Platform Installation Guide contains details of software and hardware requirements as well as detailed installation instructions. </para> - <para> + <para> The Installation Guide can be found online at <ulink type="http" url="http://docs.redhat.com/docs/">http://docs.redhat.com/do...;. </para> + </section> - - <section id="Issues-fixed-in-this-release"> - <title> - Issues fixed in this release - </title> -<!-- Commented out for current release. Retaining the text to be reused in future release drafts. --> - <warning> - <title>Draft</title> - <para> - These entries are drafts. They have been drawn from comments and associated JIRAs from the list at: - <ulink type="http" url="https://jira.jboss.org/secure/IssueNavigator.jspa?mode=hide&...;. - </para> - <para> - <emphasis role="bold">They are likely not technically correct at the moment</emphasis>, but they will serve as a basis and will be corrected in subsequent iterations after technical and QE reviews. - </para> - </warning> - <para> + + <section id="sect-Release_Notes-Issues_fixed_in_this_release"> + <title> Issues fixed in this release </title> + <para> Following is a list of issues fixed in this release: </para> - <variablelist> + <!-- Commented out for current release. Retaining the text to be reused in future release drafts. --> + <warning> + <title>Draft Content!</title> + <para> + These entries are drafts. + </para> + <para> + <emphasis role="bold">They are likely not technically correct at the moment</emphasis>, but they will serve as a basis and will be corrected in subsequent iterations after technical and QE reviews. + </para> + + </warning> + <variablelist> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-513"></ulink>... + <listitem> + <para> + A bug was found that caused site navigation to be disordered after a non-administrator deleted a page in Navigation Management. + </para> + <para> + This was caused by a problem with filtering and syncronization of nodes in the <literal>UITree</literal> object. + </para> + <para> + A new object (<literal>UIFilterTree</literal>) has been added to the code, which allows for node navigation persistence. This resolves the issue. + </para> + </listitem> + </varlistentry> <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-XYZ"></ulink>... - <listitem> - <para> - JIRA description. - </para> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-508" /></term> + <listitem> + <para> + A naming duplication in pre-packaged "Hello World" portlet examples would cause an exception when both of the portlet examples were deployed. This issues has been resolved by renaming the <replaceable>Original_name</replaceable> portlet to <replaceable>New_name</replaceable>. + </para> + <para> + Refer to the source commit logs in the above JIRA for specific code changes in this fix. + </para> + <important> + <title><emphasis role="bold">DOC NOTE:</emphasis></title> + <para> + This JIRA, although slated for fix in EPP 5.1.0.ER04, was still open at the time of writing this Release Note. + </para> + </important> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-546"></ulink>... + <listitem> <para> - Refer to the source commit logs in the above JIRA for specific code changes in this fix. + A bug was found that affected the selection of users to add to a group. User selections made on the first page of the user list were lost when navigating to subsequent pages of the list. </para> - </listitem> + <para> + The relevant code has been refined and now user selections are persistent across pages. Refer to the source commit logs in the above JIRA for specific code changes in this fix. + </para> + <important> + <title><emphasis role="bold">DOC NOTE:</emphasis></title> + <para> + This JIRA, although slated for fix in EPP 5.1.0.ER04, was still open at the time of writing this Release Note. + </para> + </important> + </listitem> </varlistentry> - + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-579"></ulink>... + <listitem> + <para> + A <emphasis role="bold">NullPointerException</emphasis> would be encountered if no <filename>navigation.xml</filename> file had been created for an LDAP user. A change to code in <filename>UIUserToolBarDashboardPortlet.gtmpl</filename> has corrected this issue by including a clause for this circumstance. + </para> + <important> + <title><emphasis role="bold">DOC NOTE:</emphasis></title> + <para> + This JIRA, although slated for fix in EPP 5.1.0.ER04, was still open at the time of writing this Release Note. + </para> + </important> + </listitem> + </varlistentry> </variablelist> + <important> + <title><emphasis role="bold">DOCS NOTE:</emphasis></title> + <para> + Do the <ulink type="http" url="https://jira.jboss.org/browse/JBEPP/component/12312983">... Requirements</ulink> and <ulink type="http" url="https://jira.jboss.org/browse/JBEPP/component/12313444">SP Integration</ulink> JIRAs need Release Notes? + </para> + <para> + All the <emphasis role="bold">EPP51-###</emphasis> JIRAs seem to pertain to features in SP, which will be documented elsewhere (although probably not as Release Notes). + </para> + </important> </section> - - <section id="sect-Release_Notes-_Known_Issues_with_this_release_"> + + <section id="sect-Release_Notes-_Known_Issues_with_this_release_"> <title> Known Issues with this release </title> - <section id="sect-Release_Notes-_Known_Issues_with_this_release_-General_Known_Issues"> + <section id="sect-Release_Notes-_Known_Issues_with_this_release_-General_Known_Issues"> <title>General Known Issues</title> - <para> - A list of general issues in this release can be found at: - </para> - <para> - <ulink type="http" url="https://jira.jboss.org/secure/IssueNavigator.jspa?mode=hide&... - </para> + <para> + A list of general issues in this release can be found at: + </para> + <para> + <ulink type="http" url="https://jira.jboss.org/secure/IssueNavigator.jspa?mode=hide&... /> + </para> + </section> - -<!-- <section> + +<!-- <section> <title>Security Issues</title> <variablelist> <varlistentry> @@ -227,138 +344,158 @@ </listitem> </varlistentry> </variablelist> - </section>--> + </section> --> + </section> + + <section id="sect-Release_Notes-Migration_from_Enterprise_Portal_Platform_4.3"> + <title>Migration from Enterprise Portal Platform 4.3</title> + <para> + &PRODUCT; &VERSION_MAJOR; is based upon an entirely new core architecture and is not backwards compatible with &PRODUCT; 4.3. + </para> + <para> + As a value added part of an enterprise subscription the JBoss Portal team is working to develop a set of migration utilities (which may take the form of documentation, guides and/or scripts) to assist customers in migration. We intend to release these utilities in a future revision of &PRODUCT; &VERSION_MAJOR;. + </para> + <para> + For customers seeking to begin a migration prior to the availability of any Red Hat provided migration utilities, please contact Red Hat JBoss Support for migration advice. Red Hat JBoss support will be the main communication channel for migration knowledge as it is developed. + </para> + <para> + Red Hat JBoss Customer Support can be accessed <ulink type="http" url="https://www.redhat.com/apps/support/">here</ulink>;. + </para> </section> + + <section id="sect-Release_Notes-Site_Publisher"> + <title>Site Publisher</title> + <para> + Site Publisher provides many additional features for organizations looking to enable line of business resources to directly manage sites, pages and content within the context of the portal versus through integration with an external web content management system. + </para> + <para> + This add-on is available for download from the <ulink type="http" url="https://support.redhat.com/jbossnetwork/restricted/softwareDeta... Hat Customer Support Portal</ulink>. + </para> + <para> + Documentation for this extension is available at <ulink type="http" url="http://docs.redhat.com/docs/en-US/JBoss_Site_Publisher/5/html/U... + </para> - <section> - <title>Migration from Enterprise Portal Platform 4.3</title> - <para> - Enterprise Portal Platform 5 is based upon an entirely new core architecture and is not backwards compatible with Enterprise Portal Platform 4.3. - </para> - <para> - As a value added part of an enterprise subscription the JBoss Portal team is working to develop a set of migration utilities (which may take the form of documentation, guides and/or scripts) to assist customers in migration. We intend to release these utilities in a future revision of JBoss Enterprise Portal Platform 5.x. - </para> - <para> - For customers seeking to begin a migration prior to the availability of any Red Hat provided migration utilities, please contact Red Hat JBoss Support for migration advice. Red Hat JBoss support will be the main communication channel for migration knowledge as it is developed. - </para> - <para> - Red Hat JBoss Customer Support can be accessed <ulink type="http" url="https://www.redhat.com/apps/support/">here</ulink>;. - </para> </section> - - <section> - <title>Site Publisher</title> - <para> - The &PRODUCT; 5.1.0 release includes an optional web content authoring system add-on called Site Publisher. This add-on is available for download from the <ulink type="http" url="https://support.redhat.com/jbossnetwork/restricted/softwareDeta... Hat Customer Support Portal</ulink>. - </para> - <para> - Site Publisher provides many additional features for organizations looking to enable line of business resources to directly manage sites, pages and content within the context of the portal versus through integration with an external web content management system. - </para> - <para> - Information about this extension is available at <ulink type="http" url="http://docs.redhat.com/docs/en-US/index.html"></ulin... - </para> - </section> - - <section id="sect-Release_Notes-_Documentation_"> + + <section id="sect-Release_Notes-_Documentation_"> <title> Documentation </title> - <para> - Visit <ulink type="http" url="http://docs.redhat.com/docs/en-US/index.html">http://do... for further documentation regarding &PRODUCT;. + <para> + Visit <ulink type="http" url="http://docs.redhat.com/docs/en-US/index.html">http://do... for further documentation regarding &PRODUCT;. </para> - <para> + <para> This documentation includes: </para> - <para> + <para> <variablelist> <varlistentry> <term>Installation Guide</term> - <listitem> + <listitem> <para> This document explains how to install and verify the installation of &PRODUCT; using different installation methods. </para> + </listitem> + </varlistentry> - <varlistentry> + <varlistentry> <term>User Guide</term> - <listitem> + <listitem> <para> This document provides an easy to follow guide to the functions and options available in &PRODUCT;. It is intended to be accessible and useful to both experienced and novice portal users. </para> + </listitem> + </varlistentry> - <varlistentry> + <varlistentry> <term>Reference Guide</term> - <listitem> + <listitem> <para> This is a high-level usage document. It deals with more advanced topics than the Installation and User guides, adding new content or taking concepts discussed in the earlier documents further. It aims to provide supporting documentation for advanced users of &PRODUCT;. Its primary focus is on advanced use of the product and it assumes an intermediate or advanced knowledge of the technology and terms. </para> </listitem> + </varlistentry> + </variablelist> + </para> - <para> + <para> The online documentation will be updated as necessary so be sure to check the site regularly, especially when a new version of &PRODUCT; is released. </para> + </section> - - <section id="sect-Release_Notes-Product_Support_and_License_Website_Links"> + + <section id="sect-Release_Notes-_Product_Support_and_License_Website_Links_"> <title> Product Support and License Website Links </title> - <formalpara> + <formalpara id="form-Release_Notes-_Product_Support_and_License_Website_Links_-Red_Hat_JBoss_Customer_Support"> <title>Red Hat JBoss Customer Support</title> - <para> - <ulink type="http" url="https://access.redhat.com/home "></ulink> - </para> + <para> + <ulink type="http" url="https://access.redhat.com/home " /> + </para> + </formalpara> - <formalpara> + <formalpara id="form-Release_Notes-_Product_Support_and_License_Website_Links_-JBoss_Customer_Suport_Portal_Downloads"> <title>JBoss Customer Suport Portal Downloads</title> - <para> - <ulink type="http" url="https://access.redhat.com/jbossnetwork/restricted/listSoftware.... - </para> + <para> + <ulink type="http" url="https://access.redhat.com/jbossnetwork/restricted/listSoftware.... /> + </para> + </formalpara> - <formalpara> + <formalpara id="form-Release_Notes-_Product_Support_and_License_Website_Links_-Support_Processes"> <title>Support Processes</title> - <para> - <ulink url="https://access.redhat.com/support/policy/support_process.html&q... + <para> + <ulink url="https://access.redhat.com/support/policy/support_process.html&q... /> </para> + </formalpara> - <formalpara> + <formalpara id="form-Release_Notes-_Product_Support_and_License_Website_Links_-_Production_Support_Scope_of_Coverage_"> <title> Production Support Scope of Coverage </title> - <para> - <ulink url="https://access.redhat.com/support/offerings/production/soc.html... + <para> + <ulink url="https://access.redhat.com/support/offerings/production/soc.html... /> </para> + </formalpara> - <formalpara> + <formalpara id="form-Release_Notes-_Product_Support_and_License_Website_Links_-_Production_Support_Service_Level_Agreement_"> <title> Production Support Service Level Agreement </title> - <para> - <ulink url="https://access.redhat.com/support/offerings/production/sla.html... + <para> + <ulink url="https://access.redhat.com/support/offerings/production/sla.html... /> </para> + </formalpara> - <formalpara> + <formalpara id="form-Release_Notes-_Product_Support_and_License_Website_Links_-_Developer_Support_Scope_of_Coverage"> <title> Developer Support Scope of Coverage</title> - <para> - <ulink url="https://access.redhat.com/support/offerings/developer/soc.html&... + <para> + <ulink url="https://access.redhat.com/support/offerings/developer/soc.html&... /> </para> + </formalpara> - <formalpara> + <formalpara id="form-Release_Notes-_Product_Support_and_License_Website_Links_-_Developer_Support_Service_Level_Agreement"> <title> Developer Support Service Level Agreement</title> - <para> - <ulink url="https://access.redhat.com/support/offerings/developer/sla.html&... + <para> + <ulink url="https://access.redhat.com/support/offerings/developer/sla.html&... /> </para> + </formalpara> - <formalpara> + <formalpara id="form-Release_Notes-_Product_Support_and_License_Website_Links_-_Product_Update_and_Support_Policy"> <title> Product Update and Support Policy</title> - <para> - <ulink url="https://access.redhat.com/support/policy/updates/jboss_notes/&q... + <para> + <ulink url="https://access.redhat.com/support/policy/updates/jboss_notes/&q... /> </para> + </formalpara> - <formalpara> + <formalpara id="form-Release_Notes-_Product_Support_and_License_Website_Links_-_JBoss_End_User_License_Agreement"> <title> JBoss End User License Agreement</title> - <para> - <ulink url="http://www.redhat.com/licenses/jboss_eula.html"></ul... + <para> + <ulink url="http://www.redhat.com/licenses/jboss_eula.html" /> </para> + </formalpara> + </section> + + <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> +</article> - <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -</article> Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Author_Group.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Author_Group.xml 2010-11-03 07:06:11 UTC (rev 4913) +++ epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Author_Group.xml 2010-11-03 07:38:52 UTC (rev 4914) @@ -1,26 +1,32 @@ <?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 "5.1.0_Release_Notes.ent"> +%BOOK_ENTITIES; ]> <authorgroup> <author> <firstname>Jason</firstname> - <surname>Andersen</surname> - <email&gt;janderse(a)redhat.com&lt;/email&gt; + <surname>Andersen</surname> + <email&gt;janderse(a)redhat.com&lt;/email&gt; + </author> - <author> + <author> <firstname>Luc</firstname> - <surname>Texier</surname> - <email&gt;ltexier(a)redhat.com&lt;/email&gt; + <surname>Texier</surname> + <email&gt;ltexier(a)redhat.com&lt;/email&gt; + </author> - <author> + <author> <firstname>Thomas</firstname> - <surname>Heute</surname> - <email&gt;theute(a)redhat.com&lt;/email&gt; + <surname>Heute</surname> + <email&gt;theute(a)redhat.com&lt;/email&gt; + </author> - <author> + <author> <firstname>Scott</firstname> - <surname>Mumford</surname> - <email&gt;smumford(a)redhat.com&lt;/email&gt; + <surname>Mumford</surname> + <email&gt;smumford(a)redhat.com&lt;/email&gt; + </author> </authorgroup> Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Book_Info.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Book_Info.xml 2010-11-03 07:06:11 UTC (rev 4913) +++ epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Book_Info.xml 2010-11-03 07:38:52 UTC (rev 4914) @@ -1,32 +1,38 @@ <?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" [ +<!DOCTYPE articleinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "5.1.0_Release_Notes.ent"> +%BOOK_ENTITIES; ]> -<articleinfo id="arti-Release_Notes-Release_Notes"> +<articleinfo id="arti-5.1.0_Release_Notes-a5.1.0_Release_Notes"> <title>5.1.0 Release Notes</title> - <subtitle>For use with JBoss Enterprise Portal Platform 5.1.0</subtitle> - <edition>1</edition> - <pubsnumber>1.0</pubsnumber> - <productname>JBoss Enterprise Portal Platform</productname> - <productnumber>5</productnumber> - <abstract> + <subtitle>For use with JBoss Enterprise Portal Platform 5.1.0</subtitle> + <edition>1</edition> + <pubsnumber>1.0</pubsnumber> + <productname>JBoss Enterprise Portal Platform</productname> + <productnumber>5</productnumber> + <abstract> <para> These release notes contain important information related to JBoss Enterprise Portal Platform 5.1.0 that may not be currently available in the Product Manuals. You should read these Release Notes in their entirety before installing JBoss Enterprise Portal Platform 5.1.0. </para> + </abstract> - <isbn>N/A</isbn> - <corpauthor> + <isbn>N/A</isbn> + <corpauthor> <inlinemediaobject> <imageobject> <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG" /> </imageobject> + </inlinemediaobject> + </corpauthor> - <copyright> + <copyright> <year>&YEAR;</year> - <holder>&HOLDER;</holder> + <holder>&HOLDER;</holder> + </copyright> - <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> </articleinfo> Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Common_Content/Conventions.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Common_Content/Conventions.xml 2010-11-03 07:06:11 UTC (rev 4913) +++ epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Common_Content/Conventions.xml 2010-11-03 07:38:52 UTC (rev 4914) @@ -1,121 +1,130 @@ <?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 "5.1.0_Release_Notes.ent"> +%BOOK_ENTITIES; ]> -<section id="sect-User_Guide-Document_Conventions"> +<section id="sect-5.1.0_Release_Notes-Document_Conventions"> <title>Document Conventions</title> - <para> + <para> This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information. </para> - <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 id="sect-User_Guide-Document_Conventions-Typographic_Conventions"> + <section id="sect-5.1.0_Release_Notes-Document_Conventions-Typographic_Conventions"> <title>Typographic Conventions</title> - <para> + <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> + <para> <literal>Mono-spaced Bold</literal> </para> - <para> + <para> Used to highlight system input, including shell commands, file names and paths. Also used to highlight keycaps and key combinations. For example: </para> - <blockquote> + <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> + <para> The above includes a file name, a shell command and a keycap, all presented in mono-spaced bold and all distinguishable thanks to context. </para> - <para> + <para> Key combinations can be distinguished from keycaps by the hyphen connecting each part of a key combination. For example: </para> - <blockquote> + <blockquote> <para> Press <keycap>Enter</keycap> to execute the command. </para> - <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> + <para> The first paragraph highlights the particular keycap to press. The second highlights two key combinations (each a set of three keycaps with each set pressed simultaneously). </para> - <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> + <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> + <para> <application>Proportional Bold</application> </para> - <para> + <para> This denotes words or phrases encountered on a system, including application names; dialog box text; labeled buttons; check-box and radio button labels; menu titles and sub-menu titles. For example: </para> - <blockquote> + <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> + <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&hellip;</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> + <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> + <para> Note the <guimenu>&gt;</guimenu> shorthand used to indicate traversal through a menu and its sub-menus. This avoids difficult-to-follow phrasing such as 'Select <guimenuitem>Mouse</guimenuitem> from the <guimenu>Preferences</guimenu> sub-menu in the <guimenu>System</guimenu> menu of the main menu bar'. </para> - <para> + <para> <command><replaceable>Mono-spaced Bold Italic</replaceable></command> or <application><replaceable>Proportional Bold Italic</replaceable></application> </para> - <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> + <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> + <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> + <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> + <para> Note the words in bold italics above &mdash; 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> + <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> + <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 id="sect-User_Guide-Document_Conventions-Pull_quote_Conventions"> + <section id="sect-5.1.0_Release_Notes-Document_Conventions-Pull_quote_Conventions"> <title>Pull-quote Conventions</title> - <para> + <para> Terminal output and source code listings are set off visually from the surrounding text. </para> - <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> + <para> Source-code listings are also set in <computeroutput>mono-spaced roman</computeroutput> but add syntax highlighting as follows: </para> - + <programlisting language="Java">package org.jboss.book.jca.ex1; import javax.naming.InitialContext; @@ -136,32 +145,38 @@ } } </programlisting> + </section> - <section id="sect-User_Guide-Document_Conventions-Notes_and_Warnings"> + <section id="sect-5.1.0_Release_Notes-Document_Conventions-Notes_and_Warnings"> <title>Notes and Warnings</title> - <para> + <para> Finally, we use three visual styles to draw attention to information that might otherwise be overlooked. </para> - <note> + <note> <title>Note</title> - <para> + <para> Notes are tips, shortcuts or alternative approaches 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> + <important> <title>Important</title> - <para> + <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 a box labeled 'Important' won't cause data loss but may cause irritation and frustration. </para> + </important> - <warning> + <warning> <title>Warning</title> - <para> + <para> Warnings should not be ignored. Ignoring warnings will most likely cause data loss. </para> + </warning> + </section> + </section> Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Common_Content/Legal_Notice.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Common_Content/Legal_Notice.xml 2010-11-03 07:06:11 UTC (rev 4913) +++ epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Common_Content/Legal_Notice.xml 2010-11-03 07:38:52 UTC (rev 4914) @@ -1,28 +1,32 @@ <?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 "5.1.0_Release_Notes.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> + <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. </para> - <para> + <para> <trademark class="registered">Linux</trademark> is the registered trademark of Linus Torvalds in the United States and other countries. </para> - <para> + <para> All other trademarks are the property of their respective owners. </para> - <para> + <para> <address> <street>1801 Varsity Drive</street> - <city>Raleigh</city>, <state>NC</state> <postcode>27606-2072</postcode> <country>USA</country> - <phone>Phone: +1 919 754 3700</phone> - <phone>Phone: 888 733 4281</phone> - <fax>Fax: +1 919 754 3701</fax> - <pob>PO Box 13588</pob> <city>Research Triangle Park</city>, <state>NC</state> <postcode>27709</postcode> <country>USA</country> + <city>Raleigh</city>, <state>NC</state> <postcode>27606-2072</postcode> <country>USA</country> + <phone>Phone: +1 919 754 3700</phone> + <phone>Phone: 888 733 4281</phone> + <fax>Fax: +1 919 754 3701</fax> + <pob>PO Box 13588</pob> <city>Research Triangle Park</city>, <state>NC</state> <postcode>27709</postcode> <country>USA</country> + </address> + </para> </legalnotice> Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Revision_History.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Revision_History.xml 2010-11-03 07:06:11 UTC (rev 4913) +++ epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Revision_History.xml 2010-11-03 07:38:52 UTC (rev 4914) @@ -1,19 +1,22 @@ <?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 "5.1.0_Release_Notes.ent"> +%BOOK_ENTITIES; ]> -<appendix id="appe-Release_Notes-Revision_History"> +<appendix id="appe-5.1.0_Release_Notes-Revision_History"> <title>Revision History</title> - <simpara> + <simpara> <revhistory> <revision> <revnumber>1-1.0</revnumber> - <date>Tues Oct 26 2010</date> - <author> + <date>Tues Oct 26 2010</date> + <author> <firstname>Scott</firstname> - <surname>Mumford</surname> - <email&gt;smumford(a)redhat.com&lt;/email&gt; + <surname>Mumford</surname> + <email&gt;smumford(a)redhat.com&lt;/email&gt; + </author> -<!-- <author> + <!-- <author> <firstname>Luc</firstname> <surname>Texier</surname> <email&gt;ltexier(a)redhat.com&lt;/email&gt; @@ -22,14 +25,18 @@ <firstname>Thomas</firstname> <surname>Heute</surname> <email&gt;theute(a)redhat.com&lt;/email&gt; - </author> --> - <revdescription> + </author> --> <revdescription> <simplelist> <member>Release Notes created for Enterprise Portal Platform 5.1.0 release.</member> + </simplelist> + </revdescription> + </revision> + </revhistory> + </simpara> </appendix>