<?xml version="1.0"?>
<!--
Copyright 2004 The Apache Software Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
  <properties>
    <title>About Apache Portals JSF Bridge</title>
    <authors>
      <person name="David Le Strat" email="dlestrat@apache.org"/>
    </authors>
  </properties>
  <body>
    <section name="About Apache Portals JSF Bridge">
      <p>
        The JSF Bridge allows <a href="http://java.sun.com/j2ee/javaserverfaces/">Java Server Faces</a> to be run
        as <a href="http://www.jcp.org/en/jsr/detail?id=168">JSR-168</a> compliant Portlets with very little change
        made to the JSF application.
      </p>
      <p>
        Existing or new JSF Applications can be transparently deployed as Portlet Application or
        Web Application.<br/>
      </p>
      <p>
        For examples of how to use the JSF bridge, please go to the 
        <a href="/multiproject/jsf-demo/index.html">JSF Portlet Demo</a> application which J2's JSF Portlet Bridge.
      </p>
      <p>
        J2's portlet bridge provides a generic JSF portlet that can be extended by your custom application or configured
        in <i>portlet.xml</i> in order to run a JSF application.
      </p>
      <p>
        The <i>&lt;init-param&gt;</i> element of the <i>portlet.xml</i> can be configured to support multiple view when using
        <i>org.apache.portals.bridges.jsf.FacesPortlet</i> as a portlet class.
      </p>
      <p>
      <table>
  		<tr> 
		    <th>&lt;init-param&gt;</th>
		    <th>Description</th>
		</tr>
        <tr> 
            <td>ViewPage</td>
            <td>The default page in view mode.</td>
        </tr>
        <tr> 
            <td>EditPage</td>
            <td>The default page in edit mode.</td>
        </tr>
        <tr> 
            <td>HelpPage</td>
            <td>The default page in help mode.</td>
        </tr>
        <tr> 
            <td>CustomPage</td>
            <td>The default page in custom mode.</td>
        </tr>
	  </table>
      </p>
    </section>
  </body>
</document>