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 2017/01/11 14:06:06 UTC

svn commit: r1778292 - in /myfaces/tobago/trunk: src/site/ src/site/apt/ tobago-example/tobago-example-demo/src/main/webapp/ tobago-example/tobago-example-demo/src/main/webapp/content/10-intro/50-migration/98-migration/ tobago-example/tobago-example-de...

Author: lofwyr
Date: Wed Jan 11 14:06:06 2017
New Revision: 1778292

URL: http://svn.apache.org/viewvc?rev=1778292&view=rev
Log:
demo improved
* move migration guides to demo
* minor fixes
[developed by hnoeth]

Removed:
    myfaces/tobago/trunk/src/site/apt/migration-1.5.apt
    myfaces/tobago/trunk/src/site/apt/migration-2.0.apt
Modified:
    myfaces/tobago/trunk/src/site/apt/new-2.0.apt
    myfaces/tobago/trunk/src/site/site.xml
    myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/10-intro/50-migration/98-migration/migration20.xhtml
    myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/10-intro/50-migration/99-migration/migration15.xhtml
    myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/20-component/020-output/45-figure/figure.xhtml
    myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/20-component/020-output/output.xhtml
    myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/init.xhtml

Modified: myfaces/tobago/trunk/src/site/apt/new-2.0.apt
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/src/site/apt/new-2.0.apt?rev=1778292&r1=1778291&r2=1778292&view=diff
==============================================================================
--- myfaces/tobago/trunk/src/site/apt/new-2.0.apt (original)
+++ myfaces/tobago/trunk/src/site/apt/new-2.0.apt Wed Jan 11 14:06:06 2017
@@ -26,7 +26,7 @@
     Tobago 2.0.0 contains 184 entries in {{{http://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310273&styleName=Html&version=12321253}Jira}}
     and most of them are exclusive in this version.
 
-    Please take also a look at the {{{./migration-2.0.html}Migration from Tobago 1.5 to 2.0}} guide.
+    Please take also a look at the {{{http://www.irian.biz/tobago-example-demo/faces/content/10-intro/50-migration/98-migration/migration20.xhtml}Migration from Tobago 1.5 to 2.0}} guide.
 
 Enhancements
 

Modified: myfaces/tobago/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/src/site/site.xml?rev=1778292&r1=1778291&r2=1778292&view=diff
==============================================================================
--- myfaces/tobago/trunk/src/site/site.xml (original)
+++ myfaces/tobago/trunk/src/site/site.xml Wed Jan 11 14:06:06 2017
@@ -57,8 +57,6 @@
       <item name="Guide to Tobago" href="http://myfaces.apache.org/tobago/guide.html"/>
       <item name="Test Tobago 3.0 Demo" href="http://myfaces.apache.org/tobago/howto-test.html"/>
       <item name="Migration to 3.0" href="http://www.irian.biz/tobago-example-demo/faces/content/10-intro/50-migration/97-migration/migration30.xhtml"/>
-      <item name="Migration to 2.0" href="http://myfaces.apache.org/tobago/migration-2.0.html"/>
-      <item name="Migration to 1.5" href="http://myfaces.apache.org/tobago/migration-1.5.html"/>
       <item name="Roadmap" href="http://myfaces.apache.org/tobago/roadmap.html" />
       <item name="Theme Handling" href="http://myfaces.apache.org/tobago/themes.html" />
       <item name="FAQ" href="http://myfaces.apache.org/tobago/faq.html" />

Modified: myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/10-intro/50-migration/98-migration/migration20.xhtml
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/10-intro/50-migration/98-migration/migration20.xhtml?rev=1778292&r1=1778291&r2=1778292&view=diff
==============================================================================
--- myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/10-intro/50-migration/98-migration/migration20.xhtml (original)
+++ myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/10-intro/50-migration/98-migration/migration20.xhtml Wed Jan 11 14:06:06 2017
@@ -22,12 +22,171 @@
                 xmlns:tc="http://myfaces.apache.org/tobago/component"
                 xmlns:ui="http://java.sun.com/jsf/facelets">
   <ui:param name="title" value="#{demoBundle.migration20}"/>
-
   <tc:section label="Migration from Tobago 1.5 to 2.0">
+    <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>
 
-    <!-- todo -->
-    TODO: move from here: http://myfaces.apache.org/tobago/migration-2.0.html
+    <tc:section label="Artifacts (JAR-Files)">
+      <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>.jar</li>
+        <li>tobago-facelets-&lt;version>.jar</li>
+      </ul>
+    </tc:section>
 
-  </tc:section>
+    <tc:section label="CSP">
+      <p>Tobago supports Content Security Policy (CSP) to prevent cross-site scripting (XSS) and related attacks. It is
+        specified by W3C. 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>
+
+      <b>Warning:</b>
+      <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>
+
+      <b>Configuration</b>
+      <p>To add sites to the CSP headers, add <code class="language-markup">&lt;directive></code> tags to
+        <code class="language-markup">&lt;content-security-policy></code> in the <code>tobago-config.xml</code>.</p>
+      <p>To turn off CSP, add an empty <code class="language-markup">&lt;content-security-policy mode="off"></code>
+        tag in the configuration. For development, you may also use mode="report-only", which sets the appropriate
+        header.</p>
+    </tc:section>
+
+    <tc:section label="Clickjacking">
+      <p>By default, it no longer possible to use a Tobago application in an HTML frame or iframe. This is to protect
+        against <tc:link label="Clickjacking" link="https://www.owasp.org/index.php/Clickjacking"/>. To disable this
+        feature consult the <code>tobago-config.xml</code> and set
+        <code class="language-markup">&lt;prevent-frame-attacks>false&lt;/prevent-frame-attacks></code>.</p>
+    </tc:section>
+
+    <tc:section label="Java-API">
+      <p>The class
+        <code>org.apache.myfaces.tobago.model.TreeState</code> 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 <code>org.apache.myfaces.tobago.component.UIFileInput</code> has been renamed to
+        <code>org.apache.myfaces.tobago.component.UIFile</code>.</p>
+    </tc:section>
+
+    <tc:section label="Renderer classes">
+      <p>The set of existing renderers has been repacked from
+        <code>org.apache.myfaces.tobago.renderkit.html.scarborough.standard.tag</code> to
+        <code>org.apache.myfaces.tobago.renderkit.html.standard.standard.tag</code>.</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>
+    </tc:section>
+
+    <tc:section label="Facelets">
+      <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. <code>jsf-facelets-1.1.14.jar</code>) from the library.</li>
+        <li>Remove <code class="language-markup">&lt;view-handler></code>
+          <code class="language-markup">org.apache.myfaces.tobago.internal.application.ViewHandlerImpl</code>
+          <code class="language-markup">&lt;/view-handler></code> from the <code>faces-config.xml</code> file.
+        </li>
+        <li>Remove the parameter <code>javax.faces.DISABLE_FACELET_JSF_VIEWHANDLER</code> from the <code>web.xml</code>
+          file.
+        </li>
+        <li>Remove or replace the <code>facelets.*</code> entries from the <code>web.xml</code> file.</li>
+        <li>Rename all JSTL declarations from <code>xmlns:c="http://java.sun.com/jstl/core"</code> to
+          <code>xmlns:c="http://java.sun.com/jsp/jstl/core"</code> in the Facelets.
+        </li>
+        <li>Ensure the version of the faces-config tag in the <code>faces-config.xml</code> is at least 2.0.</li>
+      </ul>
+    </tc:section>
+
+    <tc:section label="Deprecated">
+      <p>There are also @Deprecated annotations in the code and some logging warning when using deprecated code via the
+        Deprecation 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>
+    </tc:section>
+
+    <tc:section label="Internal">
+      <p>The package <code>org.apache.myfaces.tobago.internal</code> contains classes that should not be used directly
+        in an application. This classes may change in minor revisions without announcement. Classes in the package
+        <code>org.apache.myfaces.tobago.renderkit</code> are handled in the same manner.</p>
+    </tc:section>
+
+    <tc:section label="Tag Library">
+      <p>The main changes in the tag library are that the deprecated facets "resizeAction" and "menupopup" has been
+        removed.</p>
+    </tc:section>
 
+    <tc:section label="Suggest">
+      <p>Please use the new <code class="language-markup">&lt;tc:suggest></code> tag instead of using the inline
+        attribute inside of <code class="language-markup">&lt;tc:in></code>.</p>
+      <pre><code class="language-markup">deprecated:
+&lt;tc:in suggestMethod="\#{bean.method}"/>
+
+replacement:
+&lt;tc:in>
+  &lt;tc:suggest suggestMethod="\#{bean.method}"/>
+&lt;/tc:in></code></pre>
+      <pre><code class="language-markup">deprecated:
+&lt;tx:in suggestMethod="\#{bean.method}"/>
+
+replacement:
+&lt;tx:in>
+  &lt;tc:suggest suggestMethod="\#{bean.method}"/>
+&lt;/tx:in></code></pre>
+    </tc:section>
+
+    <tc:section label="Tree">
+      <ul>
+        <li>The Tree now extends a UIData.</li>
+        <li>The <code class="language-markup">&lt;tc:treeData></code> tag shouldn't longer be used.</li>
+        <li>The <code class="language-markup">&lt;tc:treeNode></code> has no longer the attributes: "selected",
+          "expanded", "marked", "treeMarkedListener", "treeExpansionListener"
+        </li>
+        <li>The class <code>org.apache.myfaces.tobago.model.TreeState</code> is no longer deprecated, but the
+          functionality has slightly been changed.
+        </li>
+      </ul>
+    </tc:section>
+
+    <tc:section label="Date/Time">
+      <p>The date and time input controls have been refactored. The old (deprecated) functionality can be activated via
+        <code>tobago-config.xml</code>.</p>
+      <p>If using the new: <code class="language-markup">&lt;tc:date></code> can do the job of
+        <code class="language-markup">&lt;tc:time></code>. You only need to set the
+        <code class="language-markup">&lt;f:convertDateTime type="time"></code> inside the
+        <code class="language-markup">&lt;tc:date></code>.</p>
+    </tc:section>
+
+    <tc:section label="ToolBar with dropDownMenu facet">
+      <p>Usually you need to set <code>omit="true"</code> in the
+        <code class="language-markup">&lt;tc:toolBarCommand></code>, to avoid a submit.</p>
+    </tc:section>
+
+    <tc:section label="Configuration">
+      <p>To define an own theme, please use now a file <code>tobago-config.xml</code> instead of
+        <code>tobago-theme.xml</code>. The content of <code>tobago-theme.xml</code> is a subset of the
+        <code>tobago-config.xml</code>, you have only to change the root node.</p>
+      <p>Please use the
+        <tc:link label="tobago-config-2.0.xsd" link="https://myfaces.apache.org/tobago/tobago-config-2.0.xsd"/>
+        to validate the configuration.</p>
+    </tc:section>
+
+    <tc:section label="JavaScript">
+      <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>
+    </tc:section>
+
+    <tc:section label="CSS">
+      <p>The class <code class="language-css">tobago-sheet-outer</code> is renamed to
+        <code class="language-css">tobago-sheet</code>.<br/>
+        The class <code class="language-css">tobago-sheet-headerSpacerOuter</code> is renamed to
+        <code class="language-css">tobago-sheet-headerResize</code>.<br/>
+        The class <code class="language-css">tobago-sheet-headerSpacer</code> is no longer needed.<br/>
+        The class <code class="language-css">tobago-sheet-headerSpacer-markup-resizable</code> is no longer needed.</p>
+    </tc:section>
+
+    <tc:section label="Internal">
+      <p>The facet name of the picker popup is now named "popup" instead of "pickerPopup".</p>
+    </tc:section>
+  </tc:section>
 </ui:composition>

Modified: myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/10-intro/50-migration/99-migration/migration15.xhtml
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/10-intro/50-migration/99-migration/migration15.xhtml?rev=1778292&r1=1778291&r2=1778292&view=diff
==============================================================================
--- myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/10-intro/50-migration/99-migration/migration15.xhtml (original)
+++ myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/10-intro/50-migration/99-migration/migration15.xhtml Wed Jan 11 14:06:06 2017
@@ -22,13 +22,208 @@
                 xmlns:tc="http://myfaces.apache.org/tobago/component"
                 xmlns:ui="http://java.sun.com/jsf/facelets">
   <ui:param name="title" value="#{demoBundle.migration15}"/>
-
   <tc:section label="Migration from Tobago 1.0 to 1.5">
+    <p>Tobago 1.5 has a lot of changes compared to Tobago 1.0.</p>
+    <p>The good news: Most of these changes are made internally in Tobago. If you use Tobago, you don't have to change
+      too much.</p>
+    <p>The amount of things you have to change in your application depends on how do you use it. On the Tobago Tag
+      Library are very few changes made. On the Tobago Java Classes and the Themes are more changes. Here you can see
+      which changes has been made.</p>
 
-    <!-- todo -->
+    <tc:section label="Deprecated">
+      <p>There are also <code>@Deprecated</code> annotations in the code and some logging warning when using deprecated
+        code via the Deprecation logging category. Before 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 <code>internal</code> 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>
+    </tc:section>
 
-    TODO: move from here: http://myfaces.apache.org/tobago/migration-1.5.html
+    <tc:section label="Internal">
+      <p>The new <code>internal</code> package contains classes that should not be used directly in an application. This
+        classes may change in minor revisions without announcement. Classes in the <code>renderkit</code> package a
+        handled in the same manner.</p>
+    </tc:section>
 
-  </tc:section>
+    <tc:section label="Tag Library">
+      <p>The main changes in the tag library are</p>
+      <tc:segmentLayout extraSmall="6;6">
+        <tc:panel><b>deprecated</b></tc:panel>
+        <tc:panel><b>replacement</b></tc:panel>
+        <tc:panel><code class="language-markup">&lt;tc:menuCheckbox></code></tc:panel>
+        <tc:panel><code class="language-markup">&lt;tx:menuCheckbox></code></tc:panel>
+        <tc:panel><code class="language-markup">&lt;tc:menuItem></code></tc:panel>
+        <tc:panel><code class="language-markup">&lt;tc:menuCommand></code></tc:panel>
+        <tc:panel><code class="language-markup">&lt;tc:message></code></tc:panel>
+        <tc:panel><code class="language-markup">&lt;tc:messages></code></tc:panel>
+      </tc:segmentLayout>
+      <p>In <code class="language-markup">&lt;tc:sheet></code> the default for <code>rows</code> has been changed from
+        100 to 0, which means "unlimited".</p>
+      <p>For JSP and the <code>tx:</code> library all <code>id</code> attributes have to be renamed to
+        <code>fieldId</code>. This is to adjust the JSP library to the Facelet library.</p>
+      <p>The tree tag <code class="language-markup">&lt;tc:tree></code> has changed comprehensive. Please check the
+        documentation and demo examples.</p>
+      <p>The <code>type</code> attribute of commands has been removed. It is no longer needed, when using
+        <code>action</code>, <code>onclick</code> or <code>link</code>.</p>
+    </tc:section>
+
+    <tc:section label="Layout Manager">
+      <p>On of the basic changes in Tobago 1.5 is the reimplementation of the layout manager. The usage if it, has only
+        been changed a bit. The most important is that the constraints will be set with the
+        <code class="language-markup">&lt;tc:gridLayoutConstraint></code> tag. The
+        <code class="language-markup">&lt;tc:cell></code> tag is deprecated now. Spans can be set directly into the
+        component with the <code class="language-markup">&lt;tc:gridLayoutConstraint></code> tag.</p>
+      <p>The keyword "fixed" has been renamed to "auto".</p>
+    </tc:section>
+
+    <tc:section label="UIComponent Classes">
+      <p>Some of the UIComponent classes has been renamed or restructured, to get a consistent naming schema. The used
+        UIComponents where generated and have super classes with an "Abstract" as prefix. All getters and setters are
+        generated in the UIComponent classes. The following code will not work in 1.5
+        <code>uiComponent.getAttributes().remove("attributeName")</code>. Please set the value to null.</p>
+      <p>old name: <code>org.apache.myfaces.tobago.component.UISelectOne</code><br/>
+        new name: <code>org.apache.myfaces.tobago.internal.component.AbstractUISelectOneBase</code></p>
+    </tc:section>
+
+    <tc:section label="Naming Container">
+      <p>UITab is now a naming container, so you may have to change ids of AJAX calls in your application.</p>
+    </tc:section>
 
+    <tc:section label="Other API Classes">
+      <p>The class <code>org.apache.myfaces.tobago.OnComponentCreated</code> is moved to
+        <code>org.apache.myfaces.tobago.component.OnComponentCreated</code>.<br/>
+        The class <code>org.apache.myfaces.tobago.component.ComponentUtil</code> is moved to
+        <code>org.apache.myfaces.tobago.util.ComponentUtils</code>.<br/>
+        The class <code>org.apache.myfaces.tobago.renderkit.RenderUtil</code> is moved to
+        <code>org.apache.myfaces.tobago.renderkit.util.RenderUtils</code>.<br/>
+        The class <code>org.apache.myfaces.tobago.renderkit.html.HtmlRendererUtil</code> is renamed to
+        <code>org.apache.myfaces.tobago.renderkit.html.util.HtmlRendererUtils</code>.</p>
+    </tc:section>
+
+    <tc:section label="Themes and CSS">
+      <p>Note: This effects your application only, when you've written your own theme, or using this classes in a
+        separate style file.</p>
+      <p>The basic changes in CSS are:</p>
+      <ul>
+        <li>Using CSS 2.1 compliant content box model instead of <i>Quirks mode</i> border box model.</li>
+        <li>Changed HTML structure for some components.</li>
+      </ul>
+      <p>The CSS class name schema has been revised. See the JavaDoc of the <code>Classes</code> class to check the
+        naming schema.</p>
+      <tc:segmentLayout extraSmall="6;6">
+        <tc:panel><b>old name</b></tc:panel>
+        <tc:panel><b>new name</b></tc:panel>
+        <tc:panel><code>tobago-[tagName]-default</code></tc:panel>
+        <tc:panel><code>tobago-[tagName]</code></tc:panel>
+        <tc:panel><code>tobago-[tagName]-error</code></tc:panel>
+        <tc:panel><code>tobago-[tagName]-markup-error</code></tc:panel>
+        <tc:panel><code>tobago-[tagName]-required</code></tc:panel>
+        <tc:panel><code>tobago-[tagName]-markup-required</code></tc:panel>
+        <tc:panel><code>tobago-[tagName]-readonly</code></tc:panel>
+        <tc:panel><code>tobago-[tagName]-markup-readonly</code></tc:panel>
+        <tc:panel><code>tobago-[tagName]-disabled</code></tc:panel>
+        <tc:panel><code>tobago-[tagName]-markup-disabled</code></tc:panel>
+        <tc:panel><code>tree-junction</code></tc:panel>
+        <tc:panel><code>tobago-treeNode-junction</code></tc:panel>
+        <tc:panel><code>tree-*</code></tc:panel>
+        <tc:panel><code>tobago-treeNode-*</code></tc:panel>
+        <tc:panel><code>tobago-input-picker</code></tc:panel>
+        <tc:panel><code>tobago-datePicker-icon</code></tc:panel>
+        <tc:panel><code>tobago-popup-iframe</code></tc:panel>
+        <tc:panel><code>tobago-popup-ie6bugfix</code></tc:panel>
+        <tc:panel><code>tobago-textArea-*</code></tc:panel>
+        <tc:panel><code>tobago-textarea-*</code></tc:panel>
+        <tc:panel><code>tobago-progress-color1-*</code></tc:panel>
+        <tc:panel><code>tobago-progress-value-*</code></tc:panel>
+      </tc:segmentLayout>
+      <p>The class <code>tobago-progress-color2-*</code> is deleted.</p>
+    </tc:section>
+
+    <tc:section label="JavaScript">
+      <p>The JavaScript API has been refactored. Most application do not use the Tobago JavaScript API directly. But if
+        it does, you have to apply some changes.</p>
+      <p>The most important things, is the additional first parameter on the submitting functions to compute the
+        position of the action element.</p>
+      <p>If you are using <code>submitAction()</code> in the old code, you have to add the action element or just
+        <code>null</code>. If you are using <code>submitAction2()</code> in the old code, you have to rename it to
+        <code>submitAction()</code>.</p>
+      <tc:flexLayout rows="auto;auto">
+        <tc:flexLayout columns="1;1;1">
+          <tc:panel><p>added first parameter and put all parameters after the second to an options map</p></tc:panel>
+          <tc:panel><p><code>submitAction()</code></p></tc:panel>
+          <tc:panel/>
+        </tc:flexLayout>
+        <tc:flexLayout columns="1;1;1">
+          <tc:panel><p>renamed</p></tc:panel>
+          <tc:panel><p><code>submitAction2()</code></p></tc:panel>
+          <tc:panel><p><code>submitAction()</code></p></tc:panel>
+        </tc:flexLayout>
+        <tc:flexLayout columns="1;1;1">
+          <tc:panel><p>added first parameter</p></tc:panel>
+          <tc:panel><p><code>openPopupWithAction()</code></p></tc:panel>
+          <tc:panel/>
+        </tc:flexLayout>
+        <tc:flexLayout columns="1;1;1">
+          <tc:panel><p>renamed</p></tc:panel>
+          <tc:panel><p><code>openPopupWithAction2()</code></p></tc:panel>
+          <tc:panel><p><code>openPopupWithAction()</code></p></tc:panel>
+        </tc:flexLayout>
+        <tc:flexLayout columns="1;1;1">
+          <tc:panel><p>added first parameter</p></tc:panel>
+          <tc:panel><p><code>reloadComponent()</code></p></tc:panel>
+          <tc:panel/>
+        </tc:flexLayout>
+        <tc:flexLayout columns="1;1;1">
+          <tc:panel><p>renamed</p></tc:panel>
+          <tc:panel><p><code>reloadComponent2()</code></p></tc:panel>
+          <tc:panel><p><code>reloadComponent()</code></p></tc:panel>
+        </tc:flexLayout>
+        <tc:flexLayout columns="1;1;1">
+          <tc:panel><p>added first parameter</p></tc:panel>
+          <tc:panel><p><code>Updater.update()</code></p></tc:panel>
+          <tc:panel/>
+        </tc:flexLayout>
+        <tc:flexLayout columns="1;1;1">
+          <tc:panel><p>renamed</p></tc:panel>
+          <tc:panel><p><code>Updater.update2()</code></p></tc:panel>
+          <tc:panel><p><code>Updater.update()</code></p></tc:panel>
+        </tc:flexLayout>
+        <tc:flexLayout columns="1;1;1">
+          <tc:panel><p>added first parameter</p></tc:panel>
+          <tc:panel><p><code>Sheet.reloadWithAction()</code></p></tc:panel>
+          <tc:panel/>
+        </tc:flexLayout>
+        <tc:flexLayout columns="1;1;1">
+          <tc:panel><p>renamed</p></tc:panel>
+          <tc:panel><p><code>Sheet.reloadWithAction2()</code></p></tc:panel>
+          <tc:panel><p><code>Sheet.reloadWithAction()</code></p></tc:panel>
+        </tc:flexLayout>
+        <tc:flexLayout columns="1;1;1">
+          <tc:panel><p>added first parameter</p></tc:panel>
+          <tc:panel><p><code>TabGroup.reloadWithAction()</code></p></tc:panel>
+          <tc:panel/>
+        </tc:flexLayout>
+        <tc:flexLayout columns="1;1;1;">
+          <tc:panel><p>renamed</p></tc:panel>
+          <tc:panel><p><code>TabGroup.reloadWithAction2()</code></p></tc:panel>
+          <tc:panel><p><code>TabGroup.reloadWithAction()</code></p></tc:panel>
+        </tc:flexLayout>
+      </tc:flexLayout>
+    </tc:section>
+
+    <tc:section label="Configuration">
+      <p>To define an own theme, please use now a file <code>tobago-config.xml</code> instead of
+        <code>tobago-theme.xml</code>.
+        The content of <code>tobago-theme.xml</code> is a subset of the <code>tobago-config.xml</code>, you have only to
+        change the root node.</p>
+      <p>Please use the
+        <tc:link label="tobago-config-1.5.xsd" link="https://myfaces.apache.org/tobago/tobago-config-1.5.xsd"/> to
+        validate the configuration.</p>
+    </tc:section>
+
+    <tc:section label="Own Components and Renderers">
+      <p>The renderers must now declared inside the <code>faces-config.xml</code>.</p>
+      <p>For the Tobago classes, this will be generated at compile time from annotations like in e. g.
+        <code>org.apache.myfaces.tobago.internal.taglib.component.BoxTagDeclaration</code>.</p>
+    </tc:section>
+  </tc:section>
 </ui:composition>

Modified: myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/20-component/020-output/45-figure/figure.xhtml
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/20-component/020-output/45-figure/figure.xhtml?rev=1778292&r1=1778291&r2=1778292&view=diff
==============================================================================
--- myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/20-component/020-output/45-figure/figure.xhtml (original)
+++ myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/20-component/020-output/45-figure/figure.xhtml Wed Jan 11 14:06:06 2017
@@ -33,7 +33,7 @@
   &lt;tc:image value="image/alps.png"/>
 &lt;/tc:figure></code></pre>
     <tc:figure label="Picture of the alps.">
-      <tc:image value="image/alps.png"/>
+      <tc:image value="#{request.contextPath}/image/alps.png"/>
     </tc:figure>
   </tc:section>
 
@@ -42,7 +42,7 @@
       In this example the word 'tobago' is colored red.</p>
     <tc:figure>
       <f:facet name="label">The <span style="color: red">tobago</span> logo.</f:facet>
-      <tc:image id="image" value="image/tobago_head.png"/>
+      <tc:image id="image" value="#{request.contextPath}/image/tobago_head.png"/>
     </tc:figure>
   </tc:section>
 </ui:composition>

Modified: myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/20-component/020-output/output.xhtml
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/20-component/020-output/output.xhtml?rev=1778292&r1=1778291&r2=1778292&view=diff
==============================================================================
--- myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/20-component/020-output/output.xhtml (original)
+++ myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/content/20-component/020-output/output.xhtml Wed Jan 11 14:06:06 2017
@@ -42,7 +42,7 @@
 
   <tc:section label="#{demoBundle.image}">
     <pre><code class="language-markup">&lt;tc:image value="image/tobago_head.png"/></code></pre>
-    <tc:image value="image/tobago_head.png"/>
+    <tc:image value="/image/tobago_head.png"/>
   </tc:section>
 
   <tc:section label="#{demoBundle.progress}">

Modified: myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/init.xhtml
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/init.xhtml?rev=1778292&r1=1778291&r2=1778292&view=diff
==============================================================================
--- myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/init.xhtml (original)
+++ myfaces/tobago/trunk/tobago-example/tobago-example-demo/src/main/webapp/init.xhtml Wed Jan 11 14:06:06 2017
@@ -20,7 +20,7 @@
 <f:view locale="#{clientConfigController.locale}"
         xmlns:f="http://java.sun.com/jsf/core"
         xmlns:tc="http://myfaces.apache.org/tobago/component">
-  <tc:page applicationIcon="icon/favicon.ico" label="#{demoBundle.pageTitle}" id="page">
+  <tc:page applicationIcon="#{request.contextPath}/icon/favicon.ico" label="#{demoBundle.pageTitle}" id="page">
 
     <!-- this event will forward to the first node of the navitation menu after loading -->
     <tc:event event="load" action="#{navigationState.gotoFirst}"/>