From do-not-reply at jboss.org Mon May  3 06:44:15 2010
Content-Type: multipart/mixed; boundary="===============0614130312115713618=="
MIME-Version: 1.0
From: do-not-reply at jboss.org
To: gatein-commits at lists.jboss.org
Subject: [gatein-commits] gatein SVN: r2932 - in
 portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US:
 modules and 2 other directories.
Date: Mon, 03 May 2010 06:44:15 -0400
Message-ID: <201005031044.o43AiFt5021886@svn01.web.mwc.hst.phx2.redhat.com>

--===============0614130312115713618==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: thomas.heute(a)jboss.com
Date: 2010-05-03 06:44:14 -0400 (Mon, 03 May 2010)
New Revision: 2932

Removed:
   portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Referen=
ce_Guide/en-US/modules/PortalDevelopment/AjaxLoadingMaskLayerDeactivation.x=
ml
   portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Referen=
ce_Guide/en-US/modules/PortalDevelopment/UploadComponent.xml
Modified:
   portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Referen=
ce_Guide/en-US/Reference_Guide.xml
   portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Referen=
ce_Guide/en-US/modules/Introduction.xml
   portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Referen=
ce_Guide/en-US/modules/PortalDevelopment.xml
   portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Referen=
ce_Guide/en-US/modules/PortalDevelopment/DefaultPortalNavigationConfigurati=
on.xml
   portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Referen=
ce_Guide/en-US/modules/PortalDevelopment/Skinning.xml
   portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Referen=
ce_Guide/en-US/modules/PortletDevelopment/PortletBridge/configuration.xml
   portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Referen=
ce_Guide/en-US/modules/PortletDevelopment/PortletBridge/gettingstarted.xml
Log:
JBEPP-276: Reference Guide
Minor fixes
Portlet Bridge review
Removed some WebUI chapters


Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_=
Reference_Guide/en-US/Reference_Guide.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/Reference_Guide.xml	2010-05-03 09:24:25 UTC (rev 2931)
+++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/Reference_Guide.xml	2010-05-03 10:44:14 UTC (rev 2932)
@@ -14,6 +14,5 @@
 	<xi:include href=3D"modules/WSRP.xml" xmlns:xi=3D"http://www.w3.org/2001/=
XInclude" />
 	<xi:include href=3D"modules/Advanced.xml" xmlns:xi=3D"http://www.w3.org/2=
001/XInclude" />
 	<xi:include href=3D"Revision_History.xml" xmlns:xi=3D"http://www.w3.org/2=
001/XInclude" />
-	<index />
 </book>
 =


Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_=
Reference_Guide/en-US/modules/Introduction.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/Introduction.xml	2010-05-03 09:24:25 UTC (rev 2931)
+++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/Introduction.xml	2010-05-03 10:44:14 UTC (rev 2932)
@@ -6,7 +6,7 @@
 <chapter id=3D"chap-Reference_Guide-Introduction">
 	<title>Introduction</title>
 	<para>
-		&PRODUCT; is the merge of two mature Java projects; JBoss Portal and eXo=
 Portal. This new community project takes the best of both offerings and in=
corporates them into a single portal framework. The aim is to provide an in=
tuitive user-friendly portal, and a framework to address the needs of today=
's Web 2.0 applications.
+		GateIn on which is based &PRODUCT; is the merge of two mature Java proje=
cts; JBoss Portal and eXo Portal. This new community project takes the best=
 of both offerings and incorporates them into a single portal framework. Th=
e aim is to provide an intuitive user-friendly portal, and a framework to a=
ddress the needs of today's Web 2.0 applications.
 	</para>
 	<mediaobject>
 		<imageobject role=3D"html">

Deleted: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_R=
eference_Guide/en-US/modules/PortalDevelopment/AjaxLoadingMaskLayerDeactiva=
tion.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortalDevelopment/AjaxLoadingMaskLayerDeactivation.=
xml	2010-05-03 09:24:25 UTC (rev 2931)
+++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortalDevelopment/AjaxLoadingMaskLayerDeactivation.=
xml	2010-05-03 10:44:14 UTC (rev 2932)
@@ -1,98 +0,0 @@
-<?xml version=3D'1.0' encoding=3D'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 "Reference_Guide.ent">
-%BOOK_ENTITIES;
-]>
-<chapter id=3D"chap-Reference_Guide-Deactivation_of_the_Ajax_Loading_Mask_=
Layer_">
-	<title>Deactivation of the Ajax Loading Mask Layer </title>
-	<!--  	<section id=3D"sect-Reference_Guide-Deactivation_of_the_Ajax_Loadi=
ng_Mask_Layer_-Overview">
-		<title>Overview</title>
-		<para>
-			In this article, you will learn:
-		</para>
-		<itemizedlist>
-			<listitem>
-				<para>
-					Purpose of ajax-loading mask.
-				</para>
-			</listitem>
-			<listitem>
-				<para>
-					How to deactivate ajax-loading mask.
-				</para>
-			</listitem>
-			<listitem>
-				<para>
-					Synchronous / Asynchronous issue.
-				</para>
-			</listitem>
-		</itemizedlist>
-	</section>   -->
-	<section id=3D"sect-Reference_Guide-Deactivation_of_the_Ajax_Loading_Mask=
_Layer_-Purpose">
-		<title>Purpose</title>
-		<para>
-			The loading mask layer is deployed after an ajax-call. Its purpose is t=
o block the GUI in order to prevent further user actions until the the ajax=
-request has been completed.
-		</para>
-		<para>
-			However, the mask layer may need to be deactivated in instances where t=
he portal requires user instructions before previous instructions have been=
 carried out.
-		</para>
-		<procedure id=3D"proc-Reference_Guide-Purpose-How_to_Deactivate_the_Ajax=
_Loading_Mask">
-			<title>How to Deactivate the Ajax-Loading Mask</title>
-			<step>
-				<para>
-					Generate a script to make an asynchronous ajax-call. Use the <literal=
>uicomponent.doAsync()</literal> method rather than the <literal>uicomponen=
t.event()</literal> method.
-				</para>
-				<para>
-					For example:
-				</para>
-				=

-<programlisting>&lt;a href=3D"&lt;%=3Duicomponent.doAsync(action, beanId, =
params)%&gt;" alt=3D""&gt;Asynchronous&lt;/a&gt;
-</programlisting>
-			</step>
-			<step>
-				<para>
-					The <literal>doAsync()</literal> method automatically adds the follow=
ing new parameter into the parameters list; <literal>asyncparam =3D new Par=
ameter(AJAX ASYNC,"true"); (AJAX ASYNC =3D=3D "ajax async")</literal>
-				</para>
-				<para>
-					This request is asynchronous and the ajax-loading mask will not deplo=
yed.
-				</para>
-				<note>
-				<title>Asynchronous Requests Using <literal>uicomponent.event()</liter=
al></title>
-					<para>
-						An asynchronous request can still be made using the <literal>uicompo=
nent.event()</literal>. When using this method, however, the <literal>async=
param</literal> must be added manually.
-					</para>
-				</note>
-			</step>
-		</procedure>
-		=

-		<para>
-			The GUI will be blocked to ensure a user can only request one action at=
 a time and while the request seems to be synchronous, all ajax requests ar=
e, in fact, always asynchronous. For further information refer to <xref lin=
kend=3D"sect-Reference_Guide-Deactivation_of_the_Ajax_Loading_Mask_Layer_-S=
ynchronous_issue" />.
-		</para>
-	</section>
-	=

-	<section id=3D"sect-Reference_Guide-Deactivation_of_the_Ajax_Loading_Mask=
_Layer_-Synchronous_issue">
-		<title>Synchronous issue</title>
-		<para>
-			Most web browsers support ajax requests in two modes: <emphasis>Synchro=
nous</emphasis> and <emphasis>Asynchronous</emphasis>. This mode is specifi=
ed with a boolean <literal>bAsync</literal> parameter.
-		</para>
-		=

-<programlisting>var bAsync =3D false; // Synchronous
-request.open(instance.method, instance.url, bAsync);
-</programlisting>
-		<para>
-			However, in order to work with browsers that do not support <emphasis>S=
ynchronous</emphasis> requests, <literal>bAsync</literal> is set to always =
be true (Ajax request will always be asynchronous).
-		</para>
-		<!--  		=

-<programlisting>var bAsync =3D false; // Synchronous
-request.open(instance.method, instance.url, bAsync); // Firefox will not e=
xecute
-</programlisting>
-		<para>
-			So =

-		</para>   -->
-<programlisting>// Asynchronous request
-request.open(instance.method, instance.url, true);
-</programlisting>
-	</section>
-
-</chapter>
-

Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_=
Reference_Guide/en-US/modules/PortalDevelopment/DefaultPortalNavigationConf=
iguration.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortalDevelopment/DefaultPortalNavigationConfigurat=
ion.xml	2010-05-03 09:24:25 UTC (rev 2931)
+++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortalDevelopment/DefaultPortalNavigationConfigurat=
ion.xml	2010-05-03 10:44:14 UTC (rev 2932)
@@ -262,7 +262,6 @@
 				<listitem>
 					<para>
 						Porlet instances can be associated with <literal>portlet-preferences=
</literal> that override the ones defined in <filename>portlet.xml</filenam=
e> of the portlet application <literal>war</literal>.
-			 (TODO: clarify which file in which war).
 					</para>
 					=

 <programlisting role=3D"XML">&lt;?xml version=3D"1.0" encoding=3D"ISO-8859=
-1"?&gt;

Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_=
Reference_Guide/en-US/modules/PortalDevelopment/Skinning.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortalDevelopment/Skinning.xml	2010-05-03 09:24:25 =
UTC (rev 2931)
+++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortalDevelopment/Skinning.xml	2010-05-03 10:44:14 =
UTC (rev 2932)
@@ -30,7 +30,7 @@
 				<term>Window Styles</term>
 				<listitem>
 					<para>
-						The CSS styles associated with the porlet window decorators. The win=
dow decorators contain the control buttons and boarders surrounding each po=
rtlet. Individual portlets can have their own window decorator selected, or=
 be rendered without one.
+						The CSS styles associated with the porlet window decorators. The win=
dow decorators contain the control buttons and borders surrounding each por=
tlet. Individual portlets can have their own window decorator selected, or =
be rendered without one.
 					</para>
 				</listitem>
 			</varlistentry>
@@ -170,7 +170,7 @@
 				&PRODUCT; automatically discovers web archives that contain a file des=
criptor for skins (<filename>WEB-INF/gatein-resources.xml</filename>). This=
 file is reponsible for specifying the portal, portlet and window decorator=
s to be deployed into the skin service.
 			</para>
 			<para>
-				The full schema can be found in the lib directory: 			<filename>exo.po=
rtal.component.portal.jar/gatein_resources_1_0.xsd</filename>.
+				The full schema can be found at: <ulink type=3D"http" url=3D"http://ww=
w.gatein.org/xml/ns/gatein_resources_1_0"/>.
 			</para>
 =

 			<para>

Deleted: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_R=
eference_Guide/en-US/modules/PortalDevelopment/UploadComponent.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortalDevelopment/UploadComponent.xml	2010-05-03 09=
:24:25 UTC (rev 2931)
+++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortalDevelopment/UploadComponent.xml	2010-05-03 10=
:44:14 UTC (rev 2932)
@@ -1,155 +0,0 @@
-<?xml version=3D'1.0' encoding=3D'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 "Reference_Guide.ent">
-%BOOK_ENTITIES;
-]>
-<chapter id=3D"chap-Reference_Guide-Upload_Component">
-	<title>Upload Component</title>
-	<!--  	<section id=3D"sect-Reference_Guide-Upload_Component-Overview">
-		<title>Overview</title>
-		<para>
-			In this article, you will learn how to :
-		</para>
-		<itemizedlist>
-			<listitem>
-				<para>
-					configure the Upload service
-				</para>
-			</listitem>
-			<listitem>
-				<para>
-					add a default upload size limit
-				</para>
-			</listitem>
-			<listitem>
-				<para>
-					use the Upload component in your application, with a specific upload =
size limit
-				</para>
-			</listitem>
-			<listitem>
-				<para>
-					clean the service when the upload finishes
-				</para>
-			</listitem>
-		</itemizedlist>
-	</section>   -->
-	<section id=3D"sect-Reference_Guide-Upload_Component-Upload_Service">
-		<title>Upload Service</title>
-		<para>
-			This service is defined by the class: <literal>org.exoplatform.upload.U=
ploadService</literal>;
-		</para>
-		<para>
-			This can be configured with the following xml code:
-		</para>
-		=

-<programlisting role=3D"XML">&lt;component&gt;
-   &lt;type&gt;org.exoplatform.upload.UploadService&lt;/type&gt;
-     &lt;init-params&gt;
-       &lt;value-param&gt;
-        &lt;name&gt;upload.limit.size&lt;/name&gt;
-        &lt;description&gt;Maximum size of the file to upload in MB&lt;/de=
scription&gt;
-        &lt;value&gt;10&lt;/value&gt;
-      &lt;/value-param&gt;
-    &lt;/init-params&gt;  =

-  &lt;/component&gt;
-</programlisting>
-		<para>
-			This code allows for a default upload size limit for the service to be =
configured. The value unit is in MegaBytes.
-		</para>
-		<para>
-			This limit will be used by default by all applications if no applicatio=
n-specific limit is set. Setting a different limit for applications is disc=
ussed in a later section.
-		</para>
-		<para>
-			If the value is set at <parameter>0</parameter> the upload size is unli=
mited.
-		</para>
-		<procedure id=3D"proc-Reference_Guide-Upload_Service-How_to_use_the_uplo=
ad_component">
-			<title>How to use the upload component</title>
-			<step>
-				<para>
-					Create an object type <literal>org.exoplatform.webui.form.UIFormUploa=
dInput</literal>.
-				</para>
-				<para>
-					Two constructors are available for this:
-				</para>
-				=

-<programlisting>public UIFormUploadInput(String name, String bindingExpres=
sion)
-</programlisting>
-				<para>
-					or:
-				</para>
-				=

-<programlisting>public UIFormUploadInput(String name, String bindingExpres=
sion, int limit)
-</programlisting>
-				<para>
-					This is an example using the second form :
-				</para>
-				=

-<programlisting role=3D"JAVA">PortletRequestContext pcontext =3D (PortletR=
equestContext)WebuiRequestContext.getCurrentInstance();
-PortletPreferences portletPref =3D pcontext.getRequest().getPreferences();
-int limitMB =3D Integer.parseInt(portletPref.getValue("uploadFileSizeLimit=
MB", "").trim());
-UIFormUploadInput uiInput =3D new UIFormUploadInput("upload", "upload", li=
mitMB);
-</programlisting>
-			</step>
-			<step>
-				<para>
-					To obtain the limit from the <literal>xml</literal> configuration, th=
is piece of code can be added to the either <filename>portlet.xml</filename=
> or <filename>portlet-preferences.xml</filename> :
-				</para>
-				=

-<programlisting role=3D"XML">&lt;preference&gt;
-  &lt;name&gt;uploadFileSizeLimitMB&lt;/name&gt;
-  &lt;value&gt;30&lt;/value&gt;
-  &lt;read-only&gt;false&lt;/read-only&gt;
-&lt;/preference&gt;
-</programlisting>
-				<para>
-					Again, a <parameter>0</parameter> value means an unlimited upload siz=
e, and the value unit is set in MegaBytes.
-				</para>
-			</step>
-			<step>
-				<para>
-					Use the <literal>getUploadDataAsStream()</literal> method to get the =
uploaded data:
-				</para>
-				=

-<programlisting role=3D"JAVA">UIFormUploadInput input =3D (UIFormUploadInp=
ut)uiForm.getUIInput("upload");
-InputStream inputStream =3D input.getUploadDataAsStream();
-...
-jcrData.setValue(inputStream);
-</programlisting>
-			</step>
-			<step>
-				<para>
-					The upload service stores a temporary file on the file system during =
the upload process. When the upload is finished, the service must be cleane=
d in order to:
-				</para>
-				<orderedlist numeration=3D"arabic">
-					<listitem>
-						<para>
-							Delete the temporary file and...
-						</para>
-					</listitem>
-					<listitem>
-						<para>
-							Delete the classes used for the upload.
-						</para>
-					</listitem>
-				</orderedlist>
-				<para>
-					Use the <literal>removeUpload()</literal> method defined in the uploa=
d service to purge the file:
-				</para>
-				=

-<programlisting role=3D"JAVA">UploadService uploadService =3D uiForm.getAp=
plicationComponent(UploadService.class) ;
-UIFormUploadInput uiChild =3D uiForm.getChild(UIFormUploadInput.class) ;
-uploadService.removeUpload(uiChild.getUploadId()) ;
-</programlisting>
-				<note>
-					<title>Saving the uploaded file</title>
-					<para>
-						Ensure the file is saved <emphasis role=3D"bold">before</emphasis> t=
he service is cleaned.
-					</para>
-				</note>
-			</step>
-		</procedure>
-
-	</section>
-
-</chapter>
-

Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_=
Reference_Guide/en-US/modules/PortalDevelopment.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortalDevelopment.xml	2010-05-03 09:24:25 UTC (rev =
2931)
+++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortalDevelopment.xml	2010-05-03 10:44:14 UTC (rev =
2932)
@@ -1,6 +1,6 @@
 <?xml version=3D'1.0' encoding=3D'utf-8' ?>
 <!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oas=
is-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Reference_Guide.ent">
+<!ENTITY % BOOK_ENTITIES SYSTEM "../Reference_Guide.ent">
 %BOOK_ENTITIES;
 ]>
 <part id=3D"part-Reference_Guide-Portal_Development">
@@ -14,8 +14,6 @@
 	<xi:include href=3D"PortalDevelopment/RTLFramework.xml" xmlns:xi=3D"http:=
//www.w3.org/2001/XInclude" />
 	<xi:include href=3D"PortalDevelopment/XMLResourceBundles.xml" xmlns:xi=3D=
"http://www.w3.org/2001/XInclude" />
 	<xi:include href=3D"PortalDevelopment/JavascriptInterApplicationCommunica=
tion.xml" xmlns:xi=3D"http://www.w3.org/2001/XInclude" />
-	<xi:include href=3D"PortalDevelopment/UploadComponent.xml" xmlns:xi=3D"ht=
tp://www.w3.org/2001/XInclude" />
-	<xi:include href=3D"PortalDevelopment/AjaxLoadingMaskLayerDeactivation.xm=
l" xmlns:xi=3D"http://www.w3.org/2001/XInclude" />
 	<xi:include href=3D"PortalDevelopment/JavascriptConfiguration.xml" xmlns:=
xi=3D"http://www.w3.org/2001/XInclude" />
 </part>
 =


Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_=
Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/configuratio=
n.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortletDevelopment/PortletBridge/configuration.xml	=
2010-05-03 09:24:25 UTC (rev 2931)
+++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortletDevelopment/PortletBridge/configuration.xml	=
2010-05-03 10:44:14 UTC (rev 2932)
@@ -305,7 +305,7 @@
 			<section id=3D"sect-Reference_Guide-Sending_and_Receiving_Events-Config=
uration">
 				<title>Configuration</title>
 				<para>
-					Just like with any portlet 2.0 event consumer and receiver, you must =
define them in the portlet.xml. To see a working example, checkout the Seam=
 Booking Demo portlet. <ulink url=3D"http://anonsvn.jboss.org/repos/portlet=
bridge/tags/2.0.0.CR1/examples/seam/booking/" />
+					Just like with any portlet 2.0 event consumer and receiver, you must =
define them in the portlet.xml. To see a working example, checkout the Seam=
 Booking Demo portlet. <ulink url=3D"http://anonsvn.jboss.org/repos/portlet=
bridge/tags/2.0.0.FINAL/examples/seam/booking/" />
 				</para>
 				<para>
 					You must also define the following init params in your portlet.xml.
@@ -358,7 +358,7 @@
 					Public Render Parameters (or PRPs) are one of the most powerful and s=
imple Portlet 2.0 features. Several portlets (JSF or not) can share the sam=
e render parameters. This feature can be use to present a cohesive UI to th=
e user across all portlets on the page (i.e. using an employee ID to displa=
y relative data).
 				</para>
 				<para>
-					The bridge maps a render parameter to a backing bean using settings i=
n your faces-config.xml and portlet.xml. A clear and working example can be=
 found in the Seam Booking Demo portlet. <ulink url=3D"http://anonsvn.jboss=
.org/repos/portletbridge/tags/2.0.0.CR1/examples/seam/booking/" />
+					The bridge maps a render parameter to a backing bean using settings i=
n your faces-config.xml and portlet.xml. A clear and working example can be=
 found in the Seam Booking Demo portlet. <ulink url=3D"http://anonsvn.jboss=
.org/repos/portletbridge/tags/2.0.0.FINAL/examples/seam/booking/" />
 				</para>
 				<para>
 					You must define the following init params in your portlet.xml.

Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_=
Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/gettingstart=
ed.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortletDevelopment/PortletBridge/gettingstarted.xml=
	2010-05-03 09:24:25 UTC (rev 2931)
+++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Refere=
nce_Guide/en-US/modules/PortletDevelopment/PortletBridge/gettingstarted.xml=
	2010-05-03 10:44:14 UTC (rev 2932)
@@ -48,7 +48,7 @@
 			The JBoss Portlet Bridge currently supports JBoss Portal, GateIn, JSF 1=
.2, JBoss Seam, and JBoss Richfaces. There are configurations that apply to=
 supporting each framework. See section <xref linkend=3D"sect-Reference_Gui=
de-Bridge_Configuration" /> for instructions.
 		</para>
 		<para>
-			The JBoss Portlet Bridge project is also actively developing extensions=
, and to differentiate from just another "project" that has boring ol' "ext=
ensions" we coined the term "Bridgelets" - because what would a project wit=
h Java and JSF be without having "*let" on the end of it? Not very cool in =
my opinion ;) With that said, in this current release we decided to bring a=
ll of our bridgelets into the impl code base since they are critical in mos=
t JSF portlet applications. Now it only takes a single line of configuratio=
n to utilize these features.
+			The JBoss Portlet Bridge project is also actively developing extensions=
 called "Bridgelets". In this current release we decided to bring all of ou=
r bridgelets into the impl code base since they are critical in most JSF po=
rtlet applications. Now it only takes a single line of configuration to uti=
lize these features.
 		</para>
 		<section id=3D"sect-Reference_Guide-Bridge_Frameworks_and_Extensions-Sea=
m_Bridgelets">
 			<title>Seam Bridgelets</title>
@@ -73,57 +73,6 @@
         &lt;param-value&gt;true&lt;/param-value&gt;
     &lt;/context-param&gt;
 </programlisting>
-			<para>
-				<!--   <table frame=3D'all'>
-         <title>Available Bridgelets</title>
-         <tgroup cols=3D'5' align=3D'left' colsep=3D'1' rowsep=3D'1'>
-            <colspec colname=3D'c1'/>
-            <colspec colname=3D'c2'/>
-            <colspec colname=3D'c3'/>
-            <colspec colnum=3D'5' colname=3D'c5'/>
-            <thead>
-               <row>
-                  <entry align=3D"center">Bridgelet</entry>
-                  <entry namest=3D"c2" nameend=3D"c5" align=3D"center">Com=
mand</entry>
-               </row>
-            </thead>
-            <tbody>
-             <row class=3D"table-odd" style=3D"background-color:#D6DEE0;bo=
rder:1px solid #E1E9EB;color:#334558;">
-                  <entry align=3D"left">Single Sign On</entry>
-                  <entry namest=3D"c2" nameend=3D"c5" align=3D"left">
-                     <para>By inlcuding the following dependency in your w=
eb pom, you will automatically have SSO
-                     between Jboss Portal and your Seam application.
-                     <programlisting><![CDATA[
-<dependency>
-   <groupId>org.jboss.portletbridge.extensions.seam</groupId>
-   <artifactId>PortalIdentity</artifactId>
-   <version>2.0.0.BETA</version>
-</dependency>]]>
-                  </programlisting></para>
-                  </entry>
-               </row>
-               <row class=3D"table-even" style=3D"background-color:#D6DEE0=
;border:1px solid #E1E9EB;color:#334558;">
-                  <entry align=3D"left">RichFaces Javascript Compatibility=
</entry>
-                  <entry namest=3D"c2" nameend=3D"c5" align=3D"left">
-                     <para>Richfaces does not account for multiple compone=
nts on the same portal page by default. This bridgelet
-                        renders all RichFaces component javascript to be p=
ortal friendly.
-                     <programlisting><![CDATA[
-<dependency>
-   <groupId>org.jboss.portletbridge.extensions.richfaces</groupId>
-   <artifactId>PortalResourceBuilder</artifactId>
-   <version>2.0.0.BETA</version>
-</dependency>]]>
-                  </programlisting> </para>
-                  </entry>
-               </row>
-            </tbody>
-         </tgroup>
-      </table>  -->
-				<note>
-					<para>
-						Don't forget that the bridge is still in Beta and so are any extensi=
ons. If you would like to contribute to any part of this project, we encour=
age you to be active on the <ulink url=3D"http://www.jboss.com/index.html?m=
odule=3Dbb&amp;op=3Dviewforum&amp;f=3D273">user forum</ulink> and bring iss=
ues/enhancements to attention.
-					</para>
-				</note>
 			</para>
 		</section>
 =

@@ -132,18 +81,11 @@
 	<section id=3D"sect-Reference_Guide-Getting_started_with_JBoss_Portlet_Br=
idge-Before_you_start">
 		<title>Before you start</title>
 		<para>
-			Current version and compatibilty information can be easily located on t=
he <ulink url=3D"http://www.jboss.org/community/wiki/JBossPortletBridge">JB=
PB wiki</ulink>. Ensure you are using compatible versions of all integrated=
 frameworks before you begin.
-		</para>
+			The embedded version in the &PRODUCT; is made to be compatible with the=
 JSF implementation, portal and application server that compose the product=
. You will find the binaries embedded in <literal>jboss-epp-5.0/portletbrid=
ge</literal>
+ 		</para>
 		<para>
-			JBoss Portal and GateIn provides it's latest distribution included in J=
Boss Application Server. All of the guesswork has been eliminated so that y=
ou can unzip and run the Portal with a few clicks. <ulink url=3D"http://jbo=
ss.org/gatein/downloads.html">Get the latest here</ulink> (ensure you choos=
e the Portal + JBoss AS link)
+			You can run a provided archetype <xref linkend=3D"sect-Reference_Guide-=
Getting_started_with_JBoss_Portlet_Bridge-Maven_Archetypes" /> and deploy t=
he generated war in a few easy steps. This will also give you an empty proj=
ect to play around with or start from scratch.
 		</para>
-		<para>
-			Next, all that's left is to download the <ulink url=3D"http://www.jboss=
.org/portletbridge/download/">JBoss Portlet Bridge distribution</ulink> and=
 cofigure your portlet to use the bridge. Or, you can run a provided archet=
ype <xref linkend=3D"sect-Reference_Guide-Getting_started_with_JBoss_Portle=
t_Bridge-Maven_Archetypes" /> and deploy the generated war in a few easy st=
eps. This will also give you an empty project to play around with or start =
from scratch.
-		</para>
-		<!--  <para>
-         For system requirements and setting up your JBoss Portal environm=
ent see the
-         <ulink url=3D"http://docs.jboss.com/jbportal/v2.6.4/referenceGuid=
e/html_single/#supportedversions">reference guide</ulink>.
-      </para>  -->
 	</section>
 	=

 	<section id=3D"sect-Reference_Guide-Getting_started_with_JBoss_Portlet_Br=
idge-Maven_Archetypes">
@@ -177,10 +119,10 @@
 <programlisting>mvn archetype:generate
    -DarchetypeGroupId=3Dorg.jboss.portletbridge.archetypes
    -DarchetypeArtifactId=3D1.2-basic
-   -DarchetypeVersion=3D2.0.0.CR1
+   -DarchetypeVersion=3D2.0.0.FINAL
    -DgroupId=3Dorg.whatever.project
    -DartifactId=3Dmyprojectname
-   -DarchetypeRepository=3Dhttp://repository.jboss.org/maven2/
+   -DarchetypeRepository=3Dhttps://repository.jboss.org/nexus/content/grou=
ps/public/
 </programlisting>
 							</entry>
 						</row>
@@ -193,10 +135,10 @@
 <programlisting>mvn archetype:generate
    -DarchetypeGroupId=3Dorg.jboss.portletbridge.archetypes
    -DarchetypeArtifactId=3Drichfaces-basic
-   -DarchetypeVersion=3D2.0.0.CR1
+   -DarchetypeVersion=3D2.0.0.FINAL
    -DgroupId=3Dorg.whatever.project
    -DartifactId=3Dmyprojectname
-   -DarchetypeRepository=3Dhttp://repository.jboss.org/maven2/
+   -DarchetypeRepository=3Dhttps://repository.jboss.org/nexus/content/grou=
ps/public/
 </programlisting>
 							</entry>
 						</row>
@@ -209,10 +151,10 @@
 <programlisting>mvn archetype:generate
    -DarchetypeGroupId=3Dorg.jboss.portletbridge.archetypes
    -DarchetypeArtifactId=3Dseam-basic
-   -DarchetypeVersion=3D2.0.0.CR1
+   -DarchetypeVersion=3D2.0.0.FINAL
    -DgroupId=3Dorg.whatever.project
    -DartifactId=3Dseamproject
-   -DarchetypeRepository=3Dhttp://repository.jboss.org/maven2/
+   -DarchetypeRepository=3Dhttps://repository.jboss.org/nexus/content/grou=
ps/public/
 </programlisting>
 							</entry>
 						</row>


--===============0614130312115713618==--