You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by lo...@apache.org on 2015/01/14 13:44:04 UTC

svn commit: r1651640 - /myfaces/site/publish/tobago/migration-2.0.html

Author: lofwyr
Date: Wed Jan 14 12:44:04 2015
New Revision: 1651640

URL: http://svn.apache.org/r1651640
Log:
doc: dropDown with extra submit

Modified:
    myfaces/site/publish/tobago/migration-2.0.html

Modified: myfaces/site/publish/tobago/migration-2.0.html
URL: http://svn.apache.org/viewvc/myfaces/site/publish/tobago/migration-2.0.html?rev=1651640&r1=1651639&r2=1651640&view=diff
==============================================================================
--- myfaces/site/publish/tobago/migration-2.0.html (original)
+++ myfaces/site/publish/tobago/migration-2.0.html Wed Jan 14 12:44:04 2015
@@ -1,396 +1,353 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-<head>
-  <title>Tobago - Migration from Tobago 1.5 to 2.0</title>
-  <link rel="stylesheet" type="text/css" media="all" href="./css/maven-base.css"/>
-  <link rel="stylesheet" type="text/css" media="all" href="./css/maven-theme.css"/>
-  <link rel="stylesheet" type="text/css" media="print" href="./css/print.css"/>
-  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
-</head>
-<body>
-<div id="header">
-  <div id="top_menu">
-    <div id="top_menu_container">
 
 
-      <div class="date">
-        Last Published: 20 Dec 2014
-      </div>
-      <ul>
-        <li>
-          <a href="http://www.apache.org/">Apache</a>
-        </li>
-        <li>
-          <a href="../">MyFaces</a>
-        </li>
-        <li>
-          <a href="./">Tobago</a>
-        </li>
-        <li>
-          <a href="../download.html">Download</a>
-        </li>
-        <li>
-          <a href="mail-lists.html">Mailing Lists</a>
-        </li>
-      </ul>
-      <div class="clear"></div>
-    </div>
-    <!-- close top_menu_container -->
-  </div>
-  <!-- close top_menu -->
-  <div id="header_bottom">
-    <div id="logo_banner_container">
-      <div id="logo">
-        <a href="./">
 
-          <img src="images/tobagoLogo.png" alt=""/>
-
-        </a>
-      </div>
-      <div id="banner">
-        <a href="../">
-
-          <img src="img/banners/MyFaces_logo.jpg" alt=""/>
-
-        </a>
-      </div>
-      <div class="clear"></div>
-    </div>
-    <!-- close logo_banner_container -->
-  </div>
-  <!-- close header_bottom -->
-</div>
-<!-- close header -->
-<div id="main_container">
-  <div id="left_column">
-    <div class="left_menu_top">
-      <div class="left_menu_bottom">
-        <h5>Tobago</h5>
 
-        <div class="content">
-          <ul class="left_menu">
 
-            <li class="none">
-              <a href="index.html">Introduction</a>
-            </li>
-
-            <li class="none">
-              <a href="download.html">Download</a>
-            </li>
-
-            <li class="none">
-              <a href="demo.html">Demo</a>
-            </li>
-
-            <li class="none">
-              <a href="mail-lists.html">Mailing Lists</a>
-            </li>
-          </ul>
-        </div>
-        <!-- close content -->
-      </div>
-      <!-- close left_menu_bottom -->
-    </div>
-    <!-- close left_menu_top -->
-    <div class="left_menu_top">
-      <div class="left_menu_bottom">
-        <h5>Documentation</h5>
 
-        <div class="content">
-          <ul class="left_menu">
 
-            <li class="none">
-              <a href="getting-started.html">Getting Started</a>
-            </li>
-
-            <li class="none">
-              <a href="compatibility.html">Compatibility</a>
-            </li>
-
-            <li class="none">
-              <a href="new-2.0.html">New in Tobago 2.0</a>
-            </li>
-
-            <li class="none">
-              <a href="guide.html">Guide to Tobago</a>
-            </li>
-
-            <li class="none">
-              <a href="migration-1.5.html">Migration to 1.5</a>
-            </li>
-
-            <li class="none">
-              <a href="migration-2.0.html" class="selected">Migration to 2.0</a>
-            </li>
-
-            <li class="none">
-              <a href="migration-3.0.html">Migration to 3.0 (alpha)</a>
-            </li>
-
-            <li class="none">
-              <a href="roadmap.html">Roadmap</a>
-            </li>
-
-            <li class="none">
-              <a href="themes.html">Theme Handling</a>
-            </li>
-
-            <li class="none">
-              <a href="faq.html">FAQ</a>
-            </li>
-
-            <li class="none">
-              <a href="api.html">API Documentation</a>
-            </li>
-
-            <li class="none">
-              <a href="release-checklist.html">Release Checklist</a>
-            </li>
-          </ul>
-        </div>
-        <!-- close content -->
-      </div>
-      <!-- close left_menu_bottom -->
-    </div>
-    <!-- close left_menu_top -->
-    <div class="left_menu_top">
-      <div class="left_menu_bottom">
-        <h5>Project Documentation</h5>
 
-        <div class="content">
-          <ul class="left_menu">
 
 
-            <li class="collapsed">
-              <a href="project-info.html">Project Information</a>
-            </li>
 
 
-            <li class="collapsed">
-              <a href="project-reports.html">Project Reports</a>
-            </li>
-          </ul>
-        </div>
-        <!-- close content -->
-      </div>
-      <!-- close left_menu_bottom -->
-    </div>
-    <!-- close left_menu_top -->
-    <div class="left_menu_top">
-      <div class="left_menu_bottom">
-        <h5>Foundation</h5>
 
-        <div class="content">
-          <ul class="left_menu">
 
-            <li class="none">
-              <a href="http://apache.org/" class="externalLink">ASF<span/></a>
-            </li>
-
-            <li class="none">
-              <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsorship<span/></a>
-            </li>
-
-            <li class="none">
-              <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks<span/></a>
-            </li>
-
-            <li class="none">
-              <a href="http://www.apache.org/security/" class="externalLink">Security<span/></a>
-            </li>
-
-            <li class="none">
-              <a href="http://www.apache.org/licenses/" class="externalLink">License<span/></a>
-            </li>
-          </ul>
-        </div>
-        <!-- close content -->
-      </div>
-      <!-- close left_menu_bottom -->
-    </div>
-    <!-- close left_menu_top -->
-    <div id="powered_by">
-      <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
-        <img alt="Built by Maven" src="./img/banners/maven-feather.png"></img>
-      </a>
-    </div>
-    <!-- close powered_by -->
-    <div class="clear"></div>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <title>Tobago - Migration from Tobago 1.5 to 2.0</title>
+    <link rel="stylesheet" type="text/css" media="all" href="./css/maven-base.css"/>
+    <link rel="stylesheet" type="text/css" media="all" href="./css/maven-theme.css"/>
+    <link rel="stylesheet" type="text/css" media="print" href="./css/print.css"/>
+        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+      </head>
+  <body>
+  <div id="header">
+    <div id="top_menu">
+      <div id="top_menu_container">
+              
+  
+  
+  <div class="date">
+    Last Published: 14 Jan 2015
   </div>
-  <div id="body_column">
-    <div>
-      <!-- Licensed to the Apache Software Foundation (ASF) under one or more -->
-      <!-- contributor license agreements.  See the NOTICE file distributed with -->
-      <!-- this work for additional information regarding copyright ownership. -->
-      <!-- The ASF licenses this file to You 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. -->
-      <div class="section">
-        <h2>Migration from Tobago 1.5 to 2.0<a name="Migration_from_Tobago_1.5_to_2.0"></a></h2>
-
-        <p>Tobago 2.0 has some API changes compared to Tobago 1.5.</p>
-
-        <p>The most changes are in the tree API, which is more easy to use, but also more flexible.</p></div>
-      <div class="section">
-        <h2>Artifacts (JAR-Files)<a name="Artifacts_JAR-Files"></a></h2>
-
-        <p>The following JAR files are no longer needed. They have to be removed from the project (depends on your build
-          system).</p>
-        <ul>
-          <li>tobago-taglib-extension-&lt;version&gt;.jar</li>
-          <li>tobago-facelets-&lt;version&gt;.jar</li>
+            <ul>
+      <li>
+        <a href="http://www.apache.org/">Apache</a>
+    </li>
+                    <li>
+        <a href="../">MyFaces</a>
+    </li>
+                    <li>
+        <a href="./">Tobago</a>
+    </li>
+                    <li>
+        <a href="../download.html">Download</a>
+    </li>
+                    <li>
+        <a href="mail-lists.html">Mailing Lists</a>
+    </li>
         </ul>
-      </div>
-      <div class="section">
-        <h2>CSP<a name="CSP"></a></h2>
-
-        <p>Tobago supports Content Security Policy (CSP) to prevent cross-site scripting (XSS) and related attacks.
-          Specification link http://www.w3.org/TR/CSP/ In short: The HTML page doesn't contain any JavaScript or CSS
-          information. All allowed sources for JavaScript, CSS and other resources have to be declared in special
-          header. If you have own renderers or own JavaScript in your application, this code also needs to support CSP,
-          to use this feature.</p>
-
-        <div class="section">
-          <h3>Warning:<a name="Warning:"></a></h3>
-
-          <p>CSP requires a different handling of JavaScript and other resources. If you use own JavaScript in the HTML
-            page or including resources from other sites you may need to adapt your application, (or turn this feature
-            off).</p></div>
-        <div class="section">
-          <h3>Configuration<a name="Configuration"></a></h3>
-
-          <p>To add sites to the CSP headers, add <tt>&lt;directive&gt;</tt> tags to <tt>
-            &lt;content-security-policy&gt;</tt> in the <tt>tobago-config.xml</tt>.</p>
-
-          <p>To turn off CSP, add an empty <tt>&lt;content-security-policy mode=&quot;off&quot;&gt;</tt> tag in the
-            configuration. For development, you may also use mode=&quot;report-only&quot;, which sets the appropriate
-            header.</p></div>
-      </div>
-      <div class="section">
-        <h2>Java-API<a name="Java-API"></a></h2>
-
-        <p>The class org.apache.myfaces.tobago.model.TreeState which has been deprecated in 1.5.x is used in 2.0.x with
-          a changed API. Please check the occurrences.</p>
-
-        <p>Class <tt>org.apache.myfaces.tobago.component.UIFileInput</tt> has been renamed to <tt>org.apache.myfaces.tobago.component.UIFile</tt>.
-        </p></div>
-      <div class="section">
-        <h2>Renderer classes<a name="Renderer_classes"></a></h2>
-
-        <p>The set of existing renderers has been repacked from <tt>org.apache.myfaces.tobago.renderkit.html.scarborough.standard.tag</tt>
-          to <tt>org.apache.myfaces.tobago.renderkit.html.standard.standard.tag</tt>.</p>
-
-        <p>If you have an own theme with own renderer classes implemented, which are extending the Tobago renderer
-          classes, you will need to adapt the package name of the base classes.</p></div>
-      <div class="section">
-        <h2>Facelets<a name="Facelets"></a></h2>
-
-        <p>Tobago 2.0.x is using Facelets 2.0. When still using Facelets 1.1 in the current application, this must be
-          removed:</p>
-        <ul>
-          <li>Remove facelets JAR (e.g. <tt>jsf-facelets-1.1.14.jar</tt>) from the library.</li>
-          <li>Remove &lt;view-handler&gt;org.apache.myfaces.tobago.internal.application.ViewHandlerImpl&lt;/view-handler&gt;
-            from the faces-config.xml file.
-          </li>
-          <li>Remove the parameter <tt>javax.faces.DISABLE_FACELET_JSF_VIEWHANDLER</tt> from the <tt>web.xml</tt> file.
-          </li>
-          <li>Remove or replace the <tt>facelets.*</tt> entries from the <tt>web.xml</tt> file.</li>
-          <li>Rename all JSTL declarations from <tt>xmlns:c=&quot;http://java.sun.com/jstl/core&quot;</tt> to <tt>xmlns:c=&quot;http://java.sun.com/jsp/jstl/core&quot;</tt>
-            in the Facelets.
+        <div class="clear"></div>
+      </div> <!-- close top_menu_container -->
+    </div> <!-- close top_menu -->
+    <div id="header_bottom">
+    <div id="logo_banner_container">
+            <div id="logo">
+          <a href="./">
+    
+                                            <img src="images/tobagoLogo.png" alt="" />
+    
+            </a>
+        </div>
+              <div id="banner">
+          <a href="../">
+    
+                                            <img src="img/banners/MyFaces_logo.jpg" alt="" />
+    
+            </a>
+        </div>
+        <div class="clear"></div>
+    </div> <!-- close logo_banner_container -->
+    </div> <!-- close header_bottom -->
+  </div> <!-- close header -->
+    <div id="main_container">
+    <div id="left_column">
+             <div class="left_menu_top">
+    <div class="left_menu_bottom">
+        <h5>Tobago</h5>
+            <div class="content">
+    <ul class="left_menu">
+              
+    <li class="none">
+                    <a href="index.html">Introduction</a>
           </li>
-          <li>Ensure the version of the faces-config tag in the faces-config.xml is at least 2.0.</li>
-        </ul>
-      </div>
-      <div class="section">
-        <h2>Deprecated<a name="Deprecated"></a></h2>
-
-        <p>There are also <tt>@Deprecated</tt> annotations in the code and some logging warning when using deprecated
-          code via the <tt>Deprecation</tt> logging category. Before and after migrating you should check your
-          application about that.</p>
-
-        <p>For the migration phase you may add the tobago-deprecation.jar as dependency to your project. It contains
-          classes that has been moved (e. g. to the new internal package) or removed. So you can resolve any migration
-          steps step by step. It is not recommended to use the tobago-deprecation.jar for production.</p></div>
-      <div class="section">
-        <h2>Internal<a name="Internal"></a></h2>
-
-        <p>The package <tt>org.apache.myfaces.tobago.internal</tt> contains classes that should not be used directly in
-          an application. This classes may change in minor revisions without announcement. Classes in the package <tt>org.apache.myfaces.tobago.renderkit</tt>
-          are handled in the same manner.</p></div>
-      <div class="section">
-        <h2>Tag Library<a name="Tag_Library"></a></h2>
-
-        <p>The main changes in the tag library are that the deprecated facets &quot;resizeAction&quot; and &quot;menupopup&quot;
-          has been removed.</p></div>
-      <div class="section">
-        <h2>Tree<a name="Tree"></a></h2>
-        <ul>
-          <li>The Tree now extends a UIData.</li>
-          <li>The <tt>tc:treeData</tt> tag shouldn't longer be used.</li>
-          <li>The <tt>tc:treeNode</tt> has no longer the attributes: &quot;selected&quot;, &quot;expanded&quot;, &quot;marked&quot;,
-            &quot;treeMarkedListener&quot;, &quot;treeExpansionListener&quot;</li>
-          <li>The class <tt>org.apache.myfaces.tobago.model.TreeState</tt> is no longer deprecated, but the
-            functionality has slightly been changed.
+              
+    <li class="none">
+                    <a href="download.html">Download</a>
           </li>
-        </ul>
-      </div>
-      <div class="section">
-        <h2>Date/Time<a name="DateTime"></a></h2>
-
-        <p>The date and time input controls have been refactored. The old (deprecated) functionality can be activated
-          via <tt>tobago-config.xml</tt>.</p>
-
-        <p>If using the new: <tt>tc:date</tt> can do the job of <tt>tc:time</tt>. You only need to set the <tt>f:convertDateTime
-          type=&quot;time&quot;</tt> inside the <tt>tc:date</tt>.</p></div>
-      <div class="section">
-        <h2>Configuration<a name="Configuration"></a></h2>
-
-        <p>To define an own theme, please use now a file <tt>tobago-config.xml</tt> instead of <tt>tobago-theme.xml</tt>.
-          The content of <tt>tobago-theme.xml</tt> is a subset of the <tt>tobago-config.xml</tt>, you have only to
-          change the root node.</p>
-
-        <p>Please use the <a class="externalLink" href="http://myfaces.apache.org/tobago/tobago-config-2.0.xsd"><tt>tobago-config-2.0.xsd</tt></a>
-          to validate the configuration.</p></div>
-      <div class="section">
-        <h2>JavaScript<a name="JavaScript"></a></h2>
-
-        <p>Date/Time/Calendar components: The JavaScript for this components has been refactored. All method have now a
-          namespace and are using jQuery. JavaScript code has been removed from the renderers. For data the HTML5 data
-          attribute is used instead of directly coding it into the event handler, or using hidden input fields.</p>
-      </div>
-      <div class="section">
-        <h2>CSS<a name="CSS"></a></h2>
-
-        <p>The class <tt>tobago-sheet-outer</tt> is renamed to <tt>tobago-sheet</tt>. The class <tt>tobago-sheet-headerSpacerOuter</tt>
-          is renamed to <tt>tobago-sheet-headerResize</tt>. The class <tt>tobago-sheet-headerSpacer</tt> is no longer
-          needed. The class <tt>tobago-sheet-headerSpacer-markup-resizable</tt> is no longer needed.</p></div>
-      <div class="section">
-        <h2>Internal<a name="Internal"></a></h2>
-
-        <p>The facet name of the picker popup is now named &quot;popup&quot; instead of &quot;pickerPopup&quot;.</p>
+              
+    <li class="none">
+                    <a href="demo.html">Demo</a>
+          </li>
+              
+    <li class="none">
+                    <a href="mail-lists.html">Mailing Lists</a>
+          </li>
+          </ul>
+    </div><!-- close content -->
+        </div><!-- close left_menu_bottom -->
+    </div><!-- close left_menu_top -->
+      <div class="left_menu_top">
+    <div class="left_menu_bottom">
+        <h5>Documentation</h5>
+            <div class="content">
+    <ul class="left_menu">
+              
+    <li class="none">
+                    <a href="getting-started.html">Getting Started</a>
+          </li>
+              
+    <li class="none">
+                    <a href="compatibility.html">Compatibility</a>
+          </li>
+              
+    <li class="none">
+                    <a href="new-2.0.html">New in Tobago 2.0</a>
+          </li>
+              
+    <li class="none">
+                    <a href="guide.html">Guide to Tobago</a>
+          </li>
+              
+    <li class="none">
+                    <a href="migration-1.5.html">Migration to 1.5</a>
+          </li>
+              
+    <li class="none">
+                    <a href="migration-2.0.html" class="selected">Migration to 2.0</a>
+          </li>
+              
+    <li class="none">
+                    <a href="migration-3.0.html">Migration to 3.0 (alpha)</a>
+          </li>
+              
+    <li class="none">
+                    <a href="roadmap.html">Roadmap</a>
+          </li>
+              
+    <li class="none">
+                    <a href="themes.html">Theme Handling</a>
+          </li>
+              
+    <li class="none">
+                    <a href="faq.html">FAQ</a>
+          </li>
+              
+    <li class="none">
+                    <a href="api.html">API Documentation</a>
+          </li>
+              
+    <li class="none">
+                    <a href="release-checklist.html">Release Checklist</a>
+          </li>
+          </ul>
+    </div><!-- close content -->
+        </div><!-- close left_menu_bottom -->
+    </div><!-- close left_menu_top -->
+      <div class="left_menu_top">
+    <div class="left_menu_bottom">
+        <h5>Project Documentation</h5>
+            <div class="content">
+    <ul class="left_menu">
+              
+                
+              
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+              
+        <li class="collapsed">
+                    <a href="project-info.html">Project Information</a>
+                </li>
+              
+                
+              
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+              
+        <li class="collapsed">
+                    <a href="project-reports.html">Project Reports</a>
+                </li>
+          </ul>
+    </div><!-- close content -->
+        </div><!-- close left_menu_bottom -->
+    </div><!-- close left_menu_top -->
+      <div class="left_menu_top">
+    <div class="left_menu_bottom">
+        <h5>Foundation</h5>
+            <div class="content">
+    <ul class="left_menu">
+              
+    <li class="none">
+                    <a href="http://apache.org/" class="externalLink">ASF<span/></a>
+          </li>
+              
+    <li class="none">
+                    <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsorship<span/></a>
+          </li>
+              
+    <li class="none">
+                    <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks<span/></a>
+          </li>
+              
+    <li class="none">
+                    <a href="http://www.apache.org/security/" class="externalLink">Security<span/></a>
+          </li>
+              
+    <li class="none">
+                    <a href="http://www.apache.org/licenses/" class="externalLink">License<span/></a>
+          </li>
+          </ul>
+    </div><!-- close content -->
+        </div><!-- close left_menu_bottom -->
+    </div><!-- close left_menu_top -->
+           <div id="powered_by">
+                          <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+            <img alt="Built by Maven" src="./img/banners/maven-feather.png"></img>
+          </a>
+              </div> <!-- close powered_by -->
+  <div class="clear"></div>
+    </div>
+    <div id="body_column">
+      <div>
+      <!-- Licensed to the Apache Software Foundation (ASF) under one or more --><!-- contributor license agreements.  See the NOTICE file distributed with --><!-- this work for additional information regarding copyright ownership. --><!-- The ASF licenses this file to You 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. --><div class="section">
+<h2>Migration from Tobago 1.5 to 2.0<a name="Migration_from_Tobago_1.5_to_2.0"></a></h2>
+<p>Tobago 2.0 has some API changes compared to Tobago 1.5.</p>
+<p>The most changes are in the tree API, which is more easy to use, but also more flexible.</p></div>
+<div class="section">
+<h2>Artifacts (JAR-Files)<a name="Artifacts_JAR-Files"></a></h2>
+<p>The following JAR files are no longer needed. They have to be removed from the project (depends on your build system).</p>
+<ul>
+<li>tobago-taglib-extension-&lt;version&gt;.jar</li>
+<li>tobago-facelets-&lt;version&gt;.jar</li></ul></div>
+<div class="section">
+<h2>CSP<a name="CSP"></a></h2>
+<p>Tobago supports Content Security Policy (CSP) to prevent cross-site scripting (XSS) and related attacks. Specification link http://www.w3.org/TR/CSP/ In short: The HTML page doesn't contain any JavaScript or CSS information. All allowed sources for JavaScript, CSS and other resources have to be declared in special header. If you have own renderers or own JavaScript in your application, this code also needs to support CSP, to use this feature.</p>
+<div class="section">
+<h3>Warning:<a name="Warning:"></a></h3>
+<p>CSP requires a different handling of JavaScript and other resources. If you use own JavaScript in the HTML page or including resources from other sites you may need to adapt your application, (or turn this feature off).</p></div>
+<div class="section">
+<h3>Configuration<a name="Configuration"></a></h3>
+<p>To add sites to the CSP headers, add <tt>&lt;directive&gt;</tt> tags to <tt>&lt;content-security-policy&gt;</tt> in the <tt>tobago-config.xml</tt>.</p>
+<p>To turn off CSP, add an empty <tt>&lt;content-security-policy mode=&quot;off&quot;&gt;</tt> tag in the configuration. For development, you may also use mode=&quot;report-only&quot;, which sets the appropriate header.</p></div></div>
+<div class="section">
+<h2>Java-API<a name="Java-API"></a></h2>
+<p>The class org.apache.myfaces.tobago.model.TreeState which has been deprecated in 1.5.x is used in 2.0.x with a changed API. Please check the occurrences.</p>
+<p>Class <tt>org.apache.myfaces.tobago.component.UIFileInput</tt> has been renamed to <tt>org.apache.myfaces.tobago.component.UIFile</tt>.</p></div>
+<div class="section">
+<h2>Renderer classes<a name="Renderer_classes"></a></h2>
+<p>The set of existing renderers has been repacked from <tt>org.apache.myfaces.tobago.renderkit.html.scarborough.standard.tag</tt> to <tt>org.apache.myfaces.tobago.renderkit.html.standard.standard.tag</tt>.</p>
+<p>If you have an own theme with own renderer classes implemented, which are extending the Tobago renderer classes, you will need to adapt the package name of the base classes.</p></div>
+<div class="section">
+<h2>Facelets<a name="Facelets"></a></h2>
+<p>Tobago 2.0.x is using Facelets 2.0. When still using Facelets 1.1 in the current application, this must be removed:</p>
+<ul>
+<li>Remove facelets JAR (e.g. <tt>jsf-facelets-1.1.14.jar</tt>) from the library.</li>
+<li>Remove &lt;view-handler&gt;org.apache.myfaces.tobago.internal.application.ViewHandlerImpl&lt;/view-handler&gt; from the faces-config.xml file.</li>
+<li>Remove the parameter <tt>javax.faces.DISABLE_FACELET_JSF_VIEWHANDLER</tt> from the <tt>web.xml</tt> file.</li>
+<li>Remove or replace the <tt>facelets.*</tt> entries from the <tt>web.xml</tt> file.</li>
+<li>Rename all JSTL declarations from <tt>xmlns:c=&quot;http://java.sun.com/jstl/core&quot;</tt> to <tt>xmlns:c=&quot;http://java.sun.com/jsp/jstl/core&quot;</tt> in the Facelets.</li>
+<li>Ensure the version of the faces-config tag in the faces-config.xml is at least 2.0.</li></ul></div>
+<div class="section">
+<h2>Deprecated<a name="Deprecated"></a></h2>
+<p>There are also <tt>@Deprecated</tt> annotations in the code and some logging warning when using deprecated code via the <tt>Deprecation</tt> logging category. Before and after migrating you should check your application about that.</p>
+<p>For the migration phase you may add the tobago-deprecation.jar as dependency to your project. It contains classes that has been moved (e. g. to the new internal package) or removed. So you can resolve any migration steps step by step. It is not recommended to use the tobago-deprecation.jar for production.</p></div>
+<div class="section">
+<h2>Internal<a name="Internal"></a></h2>
+<p>The package <tt>org.apache.myfaces.tobago.internal</tt> contains classes that should not be used directly in an application. This classes may change in minor revisions without announcement. Classes in the package <tt>org.apache.myfaces.tobago.renderkit</tt> are handled in the same manner.</p></div>
+<div class="section">
+<h2>Tag Library<a name="Tag_Library"></a></h2>
+<p>The main changes in the tag library are that the deprecated facets &quot;resizeAction&quot; and &quot;menupopup&quot; has been removed.</p></div>
+<div class="section">
+<h2>Tree<a name="Tree"></a></h2>
+<ul>
+<li>The Tree now extends a UIData.</li>
+<li>The <tt>tc:treeData</tt> tag shouldn't longer be used.</li>
+<li>The <tt>tc:treeNode</tt> has no longer the attributes: &quot;selected&quot;, &quot;expanded&quot;, &quot;marked&quot;, &quot;treeMarkedListener&quot;, &quot;treeExpansionListener&quot;</li>
+<li>The class <tt>org.apache.myfaces.tobago.model.TreeState</tt> is no longer deprecated, but the functionality has slightly been changed.</li></ul></div>
+<div class="section">
+<h2>Date/Time<a name="DateTime"></a></h2>
+<p>The date and time input controls have been refactored. The old (deprecated) functionality can be activated via <tt>tobago-config.xml</tt>.</p>
+<p>If using the new: <tt>tc:date</tt> can do the job of <tt>tc:time</tt>. You only need to set the <tt>f:convertDateTime type=&quot;time&quot;</tt> inside the <tt>tc:date</tt>.</p></div>
+<div class="section">
+<h2>ToolBar with dropDownMenu facet<a name="ToolBar_with_dropDownMenu_facet"></a></h2>
+<p>Usually you need to set <tt>omit=&quot;true&quot;</tt> in the <tt>tc:toolBarCommand</tt>, to avoid a submit.</p></div>
+<div class="section">
+<h2>Configuration<a name="Configuration"></a></h2>
+<p>To define an own theme, please use now a file <tt>tobago-config.xml</tt> instead of <tt>tobago-theme.xml</tt>. The content of <tt>tobago-theme.xml</tt> is a subset of the <tt>tobago-config.xml</tt>, you have only to change the root node.</p>
+<p>Please use the <a class="externalLink" href="http://myfaces.apache.org/tobago/tobago-config-2.0.xsd"><tt>tobago-config-2.0.xsd</tt></a> to validate the configuration.</p></div>
+<div class="section">
+<h2>JavaScript<a name="JavaScript"></a></h2>
+<p>Date/Time/Calendar components: The JavaScript for this components has been refactored. All method have now a namespace and are using jQuery. JavaScript code has been removed from the renderers. For data the HTML5 data attribute is used instead of directly coding it into the event handler, or using hidden input fields.</p></div>
+<div class="section">
+<h2>CSS<a name="CSS"></a></h2>
+<p>The class <tt>tobago-sheet-outer</tt> is renamed to <tt>tobago-sheet</tt>. The class <tt>tobago-sheet-headerSpacerOuter</tt> is renamed to <tt>tobago-sheet-headerResize</tt>. The class <tt>tobago-sheet-headerSpacer</tt> is no longer needed. The class <tt>tobago-sheet-headerSpacer-markup-resizable</tt> is no longer needed.</p></div>
+<div class="section">
+<h2>Internal<a name="Internal"></a></h2>
+<p>The facet name of the picker popup is now named &quot;popup&quot; instead of &quot;pickerPopup&quot;.</p></div>
       </div>
     </div>
-  </div>
-  <div class="clear"></div>
-</div>
-<!-- close main container -->
-<div id="footer">
-  <div class="copyright">
-    &#169;
-    2002-2014
-    Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License,
-    Version 2.0</a>.<br/>
-    Apache MyFaces, Apache Tobago, Apache, the Apache feather logo, and the Apache MyFaces project logos are trademarks
-    of The Apache Software Foundation.
-  </div>
-  <!-- close copyright -->
-</div>
-<!-- close footer -->
-</body>
+    <div class="clear"></div>
+    </div> <!-- close main container -->
+    <div id="footer">
+      <div class="copyright">
+      &#169;  
+          2002-2015
+       Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>
+       Apache MyFaces, Apache Tobago, Apache, the Apache feather logo, and the Apache MyFaces project logos are trademarks of The Apache Software Foundation.
+      </div><!-- close copyright -->
+    </div><!-- close footer -->
+  </body>
 </html>