Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 338834

Summary: [Documentation] Add documentation about RAP windowing system
Product: [RT] RAP Reporter: Beyhan Veliev <beyhan.veliev>
Component: DemoAssignee: Project Inbox <rap-inbox>
Status: RESOLVED WONTFIX QA Contact:
Severity: normal    
Priority: P3 CC: rsternberg
Version: unspecified   
Target Milestone: ---   
Hardware: PC   
OS: All   
Whiteboard:
Bug Depends on: 338544    
Bug Blocks:    
Attachments:
Description Flags
Version 1 none

Description Beyhan Veliev CLA 2011-03-03 12:03:39 EST 
Add documentation about RAP windowing system into:
* Eclipse help
* RAP project site
* RAP FAQs
RAP's windowing system affects:
* Launching RAP applications.
* RAP target definition
Comment 1 Beyhan Veliev CLA 2011-03-12 05:33:36 EST 
Created attachment 191042 [details]
Version 1

Extends RAP Eclipse documentation with information about RAP's windowing system.
Comment 2 Ralf Sternberg CLA 2011-03-16 19:51:54 EDT 
Proposed additions to the FAQ by Beyhan, can hopefully be reused later:

<h3>How to launch a RAP application with the window system platform filter</h3>
RAP defines its own <code>Window System</code> 
<a href="http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/misc/bundle_manifest.html">
plaform filter</a> since RAP 1.4 M6. As a consequence of this change, 
the window system <bold>must</bold> be set to <code>rap</code> to run a RAP application 
from now on. This can be done either by adding the Equinox parameter <code>-ws rap</code> 
or by setting the system property <code>osgi.ws=rap</code>. When starting from the Eclipse IDE, 
the launcher usually sets this parameter to <code>${target.ws}</code> by default. Therefore 
it is sufficient to set the <code>Windowing System</code> in your target platform 
to <code>rap</code>. This can be done in the "Environment" tab. If you install the RAP target 
from the RAP welcome page, the target's <code>Window System</code> is automatically set to 
<code>rap</code>. The RAP launcher displays a warning if the <code>Window System</code> is not
set to <code>rap</code>.

<h3>How to deploy a RAP application with the window system platform filter</h3>
<p>RAP defines its own <code>Window System</code> 
<a href="http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/misc/bundle_manifest.html">
plaform filter</a> since RAP 1.4 M6. As a consequence of this change, 
the window system must be set to <code>rap</code> to run a RAP application. 
Therefore, the <code>web.xml</code> must have the "-ws rap" command line parameter.
<pre>&lt;init-param&gt;
  &lt;param-name&gt;commandline&lt;/param-name&gt;
  &lt;param-value&gt;-ws rap&lt;/param-value&gt; 
&lt;/init-param&gt;</pre>
  </p>
Comment 3 Ralf Sternberg CLA 2013-06-05 12:59:11 EDT 
As the windowing system is obsolete (see bug 338544), this is not needed anymore.