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/11/15 14:18:04 UTC

svn commit: r1714451 - in /myfaces/tobago/trunk/src/site: apt/api.apt apt/download.apt apt/index.apt apt/migration-3.0.apt apt/new-3.0.apt site.xml

Author: lofwyr
Date: Sun Nov 15 13:18:04 2015
New Revision: 1714451

URL: http://svn.apache.org/viewvc?rev=1714451&view=rev
Log:
release 3.0.0-alpha-1

Added:
    myfaces/tobago/trunk/src/site/apt/new-3.0.apt
Modified:
    myfaces/tobago/trunk/src/site/apt/api.apt
    myfaces/tobago/trunk/src/site/apt/download.apt
    myfaces/tobago/trunk/src/site/apt/index.apt
    myfaces/tobago/trunk/src/site/apt/migration-3.0.apt
    myfaces/tobago/trunk/src/site/site.xml

Modified: myfaces/tobago/trunk/src/site/apt/api.apt
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/src/site/apt/api.apt?rev=1714451&r1=1714450&r2=1714451&view=diff
==============================================================================
--- myfaces/tobago/trunk/src/site/apt/api.apt (original)
+++ myfaces/tobago/trunk/src/site/apt/api.apt Sun Nov 15 13:18:04 2015
@@ -24,6 +24,9 @@ Tobago API Documentation
 *---------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
 || Version      || JavaDoc API Documentation                                                    || Tag Library Documentation (TLD)                                                                                                        |
 *---------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+| 3.0.0-alpha-1 | {{{./doc/3.0.0-alpha-1/api/index.html}3.0.0-alpha-1 API Documentation}}       | {{{./doc/3.0.0-alpha-1/tld/index.html}3.0.0-alpha-1 TLD Documentation}} \                                                               |
+|               |                                                                               |                                                                                                                                         |
+*---------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
 | 2.0.8         | {{{./doc/2.0.8/api/index.html}2.0.8 API Documentation}}                       | {{{./doc/2.0.8/tld/index.html}2.0.8 TLD Documentation}} \                                                                               |
 |               |                                                                               |                                                                                                                                         |
 *---------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+

Modified: myfaces/tobago/trunk/src/site/apt/download.apt
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/src/site/apt/download.apt?rev=1714451&r1=1714450&r2=1714451&view=diff
==============================================================================
--- myfaces/tobago/trunk/src/site/apt/download.apt (original)
+++ myfaces/tobago/trunk/src/site/apt/download.apt Sun Nov 15 13:18:04 2015
@@ -33,6 +33,30 @@ Download MyFaces Tobago
   created using GNU tar extensions. Thus they must be untarred with a GNU compatible
   version of tar.
 
+MyFaces Tobago 3.0.0-alpha-1 Distribution
+
+    Release notes can be found in
+    {{{https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310273&version=12325880}Jira}}.
+
+*-------------------------+--------+---------+----------+-----------+
+|                         | Typ    | Mirrors | Checksum | Signature |
+*-------------------------+--------+---------+----------+-----------+
+| MyFaces Tobago          | tar.gz | {{{http://www.apache.org/dyn/closer.lua/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-dist.tar.gz} myfaces-tobago-3.0.0-alpha-1-dist.tar.gz}}             | {{{https://www.apache.org/dist/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-dist.tar.gz.sha256} myfaces-tobago-3.0.0-alpha-1-dist.tar.gz.sha256}}\             | {{{https://www.apache.org/dist/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-dist.tar.gz.asc} myfaces-tobago-3.0.0-alpha-1-dist.tar.gz.asc}} |
+|                         |        |                                                                                                                                           | {{{https://www.apache.org/dist/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-dist.tar.gz.md5}    myfaces-tobago-3.0.0-alpha-1-dist.tar.gz.md5}}                 | |
+*-------------------------+--------+---------+----------+-----------+
+| MyFaces Tobago          | zip    | {{{http://www.apache.org/dyn/closer.lua/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-dist.zip} myfaces-tobago-3.0.0-alpha-1-dist.zip}}                   | {{{https://www.apache.org/dist/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-dist.zip.sha256} myfaces-tobago-3.0.0-alpha-1-dist.zip.sha256}}\                   | {{{https://www.apache.org/dist/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-dist.zip.asc} myfaces-tobago-3.0.0-alpha-1-dist.zip.asc}} |
+|                         |        |                                                                                                                                           | {{{https://www.apache.org/dist/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-dist.zip.md5}    myfaces-tobago-3.0.0-alpha-1-dist.zip.md5}}                       | |
+*-------------------------+--------+---------+----------+-----------+
+| MyFaces Tobago Source   | zip    | {{{http://www.apache.org/dyn/closer.lua/myfaces/source/myfaces-tobago-3.0.0-alpha-1-source-release.zip} myfaces-tobago-3.0.0-alpha-1-source-release.zip}} | {{{https://www.apache.org/dist/myfaces/source/myfaces-tobago-3.0.0-alpha-1-source-release.zip.sha256} myfaces-tobago-3.0.0-alpha-1-source-release.zip.sha256}}\ | {{{https://www.apache.org/dist/myfaces/source/myfaces-tobago-3.0.0-alpha-1-source-release.zip.asc} myfaces-tobago-3.0.0-alpha-1-source-release.zip.asc}} |
+|                         |        |                                                                                                                                           | {{{https://www.apache.org/dist/myfaces/source/myfaces-tobago-3.0.0-alpha-1-source-release.zip.md5}    myfaces-tobago-3.0.0-alpha-1-source-release.zip.md5}}     | |
+*-------------------------+--------+---------+----------+-----------+
+| MyFaces Tobago Example  | tar.gz | {{{http://www.apache.org/dyn/closer.lua/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-example.tar.gz} myfaces-tobago-3.0.0-alpha-1-example.tar.gz}}       | {{{https://www.apache.org/dist/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-example.tar.gz.sha256} myfaces-tobago-3.0.0-alpha-1-example.tar.gz.sha256}}\       | {{{https://www.apache.org/dist/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-example.tar.gz.asc} myfaces-tobago-3.0.0-alpha-1-example.tar.gz.asc}} |
+|                         |        |                                                                                                                                           | {{{https://www.apache.org/dist/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-example.tar.gz.md5}    myfaces-tobago-3.0.0-alpha-1-example.tar.gz.md5}}           | |
+*-------------------------+--------+---------+----------+-----------+
+| MyFaces Tobago Example  | zip    | {{{http://www.apache.org/dyn/closer.lua/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-example.zip} myfaces-tobago-3.0.0-alpha-1-example.zip}}             | {{{https://www.apache.org/dist/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-example.zip.sha256} myfaces-tobago-3.0.0-alpha-1-example.zip.sha256}}\             | {{{https://www.apache.org/dist/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-example.zip.asc} myfaces-tobago-3.0.0-alpha-1-example.zip.asc}} |
+|                         |        |                                                                                                                                           | {{{https://www.apache.org/dist/myfaces/binaries/myfaces-tobago-3.0.0-alpha-1-example.zip.md5}    myfaces-tobago-3.0.0-alpha-1-example.zip.md5}}                 | |
+*-------------------------+--------+---------+----------+-----------+
+
 MyFaces Tobago 2.0.8 Distribution
 
     Release notes can be found in

Modified: myfaces/tobago/trunk/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/src/site/apt/index.apt?rev=1714451&r1=1714450&r2=1714451&view=diff
==============================================================================
--- myfaces/tobago/trunk/src/site/apt/index.apt (original)
+++ myfaces/tobago/trunk/src/site/apt/index.apt Sun Nov 15 13:18:04 2015
@@ -47,6 +47,18 @@ Apache Tobago
 
 News
 
+* November 11, 2015 - MyFaces Tobago 3.0.0-alpha-1 Released
+
+      The MyFaces Tobago component library in version 3.0.0-alpha-1 has been released.
+
+      Release notes can be found in
+      {{{http://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310273&styleName=Html&version=12325880}Jira}}.
+
+      See section: {{{./new-3.0.html} What's new in Tobago 3.0?}}
+
+      \ {}
+      ~~ hack for a bit space
+
 * July 16, 2015 - MyFaces Tobago 1.0.42 Released
 
       The MyFaces Tobago component library in version 1.0.42 has been released.

Modified: myfaces/tobago/trunk/src/site/apt/migration-3.0.apt
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/src/site/apt/migration-3.0.apt?rev=1714451&r1=1714450&r2=1714451&view=diff
==============================================================================
--- myfaces/tobago/trunk/src/site/apt/migration-3.0.apt (original)
+++ myfaces/tobago/trunk/src/site/apt/migration-3.0.apt Sun Nov 15 13:18:04 2015
@@ -24,7 +24,68 @@ Migration from Tobago 2.0 to 3.0 (work i
   CSS: box-sizing: changed from content-box to border-box
 
   tc:time -> tc:date
-  You need to set the <<<f:convertDateTime type="time">>> inside the <<<tc:date>>>.
+  You need to set the <<<\<f:convertDateTime type="time"\>>>> inside the <<<\<tc:date\>>>>.
 
   ActionListenerImpl: Class is no longer present, you should use a JSF 2 exception handler instead.
 
+  Replace all <<<\<tc:cell\>>>> with <<<\<tc:panel\>>>>
+
+  If you have own renderer classes: The API of
+
+* replacing tx with tc
+
+    <tx:in label="a" fieldId="b" id="c" />
+
+    will be transformed to this
+
+    <tc:in label="a" id="b or c" />  (if b is set use b otherwise use c)
+
+    There is a little conflict between the "label" attribute used in the JSF spec. and the Tobago tx: label:
+    Tobago means it should be displayed, and JSF spec. means that this should be used to display messages.
+    In most cases there is no issue for that. But for the case that the application need a message label, but
+    should not be displayed we need a new attribute:
+
+    (preliminary) "labelPosition" or "labelLayout" with value "none"
+    With this attribute we may advise the renderer also the position of the label.
+    Or, using an attribute "renderLable"...
+
+* Removing tc:cell tag, please use tc:panel instead, if needed.
+
+  - simplify (flowLayout, flexLayout, segmentLayout):
+
+    <tc:flowLayout>
+      ... content ...
+    </tc:flowLayout>
+
+    instead of
+
+    <tc:panel>
+      <f:facet name="layout">
+        <tc:flowLayout/>
+      </f:facet>
+      ... content ...
+    </tc:panel>
+
+* No longer supported
+
+    Because of the changed layout model (no longer on the server, but with browser CSS) there a some
+    classes, methods and parameters removed.
+
+
+    * AbstractUIPage.getActionPosition()
+
+    * AbstractUIPage.setActionPosition()
+
+    * class Box
+
+    * class Dimension
+
+    * class Position
+
+    * ClientProperties.pageWidth
+
+    * ClientProperties.pageHeight
+
+    * tc:gridLayoutConstraint -> tc:style
+
+* if using tc:page with the attributes state, width, height: remove the attributes

Added: myfaces/tobago/trunk/src/site/apt/new-3.0.apt
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/src/site/apt/new-3.0.apt?rev=1714451&view=auto
==============================================================================
--- myfaces/tobago/trunk/src/site/apt/new-3.0.apt (added)
+++ myfaces/tobago/trunk/src/site/apt/new-3.0.apt Sun Nov 15 13:18:04 2015
@@ -0,0 +1,69 @@
+ ~~ 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.
+
+ ------
+ What's new in Tobago 3.0 (currently alpha state)?
+ ------
+
+{What's new in Tobago 3.0 (currently alpha state)?}
+
+    In November 2015 the first alpha version of 3.0.0 has been released.
+    Here was a quick overview over the features and changes made in the last time
+    to release this major revision.
+
+    Tobago 3.0.0 contains several entries in {{{http://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310273&styleName=Html&version=12325880}Jira}}
+    and most of them are exclusive in this version.
+
+    Please take also a look at the {{{./migration-3.0.html}Migration from Tobago 2.0 to 3.0}} guide.
+
+Overview and History
+
+    Until Tobago 2.0 the layout was computed on the server, to make advanced features available for
+    comfortable web application.
+
+    With CSS3 and HTML5 it is possible these days, to make good layout managers
+    implemented in the browser. Tobago
+
+New Features and Enhancements
+
+* Bootstrap
+
+    The base theme that comes with Tobago is changes from plain CSS to Twitters Bootstrap.
+    So, you applications have the advantage of modern HTML5 web applications, with
+    less coding.
+
+* New Layout Managers
+
+    * Segment Layout (uses the 12 columns layout from Bootstrap)
+
+    * Flex Layout (CSS3)
+
+    You may replace the <<<GridLayout>>> from Tobago 2.0 with <<<FlexLayout>>>.
+
+    * Flow Layout
+
+    * The new layout managers, have be written be bit more concised: Using as container instead of a facet.
+
+* tx library
+
+    * the tx library no longer needed
+
+    * label is integrated in the tc library.
+
+    * results in a more intuitive API
+
+    * rich variations of positioning the label with new attribute labelLayout
+
+Internal Refactoring

Modified: myfaces/tobago/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/src/site/site.xml?rev=1714451&r1=1714450&r2=1714451&view=diff
==============================================================================
--- myfaces/tobago/trunk/src/site/site.xml (original)
+++ myfaces/tobago/trunk/src/site/site.xml Sun Nov 15 13:18:04 2015
@@ -52,11 +52,12 @@
     <menu name="Documentation">
       <item name="Getting Started" href="http://myfaces.apache.org/tobago/getting-started.html"/>
       <item name="Compatibility" href="http://myfaces.apache.org/tobago/compatibility.html"/>
+      <item name="New in Tobago 3.0 (alpha)" href="http://myfaces.apache.org/tobago/new-3.0.html"/>
       <item name="New in Tobago 2.0" href="http://myfaces.apache.org/tobago/new-2.0.html"/>
       <item name="Guide to Tobago" href="http://myfaces.apache.org/tobago/guide.html"/>
-      <item name="Migration to 1.5" href="http://myfaces.apache.org/tobago/migration-1.5.html"/>
-      <item name="Migration to 2.0" href="http://myfaces.apache.org/tobago/migration-2.0.html"/>
       <item name="Migration to 3.0 (alpha)" href="http://myfaces.apache.org/tobago/migration-3.0.html"/>
+      <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" />