You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tapestry.apache.org by jk...@apache.org on 2006/12/19 23:23:00 UTC
svn commit: r488832 - in /tapestry/tapestry4/trunk: pom.xml
src/site/apt/download.apt src/site/site.xml src/site/xdoc/download.xml
src/site/xdoc/usersguide/upgrade4.0.xml
Author: jkuhnert
Date: Tue Dec 19 14:23:00 2006
New Revision: 488832
URL: http://svn.apache.org/viewvc?view=rev&rev=488832
Log:
Updated download page.
Started beginnings of an upgrade guide for Tapestry 4.0 -> Tapestry 4.1 .
Added:
tapestry/tapestry4/trunk/src/site/xdoc/download.xml (with props)
tapestry/tapestry4/trunk/src/site/xdoc/usersguide/upgrade4.0.xml (with props)
Removed:
tapestry/tapestry4/trunk/src/site/apt/download.apt
Modified:
tapestry/tapestry4/trunk/pom.xml
tapestry/tapestry4/trunk/src/site/site.xml
Modified: tapestry/tapestry4/trunk/pom.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/pom.xml?view=diff&rev=488832&r1=488831&r2=488832
==============================================================================
--- tapestry/tapestry4/trunk/pom.xml (original)
+++ tapestry/tapestry4/trunk/pom.xml Tue Dec 19 14:23:00 2006
@@ -293,7 +293,7 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
- <version>2.0-SNAPSHOT</version>
+ <version>2.0-alpha-1-SNAPSHOT</version>
<inherited>true</inherited>
</plugin>
<plugin>
@@ -305,27 +305,32 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-deploy-plugin</artifactId>
- <version>2.2</version>
+ <version>2.3-SNAPSHOT</version>
+ <inherited>true</inherited>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<version>2.3-SNAPSHOT</version>
+ <inherited>true</inherited>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-clean-plugin</artifactId>
<version>2.1.1-SNAPSHOT</version>
+ <inherited>true</inherited>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>2.2-SNAPSHOT</version>
+ <inherited>true</inherited>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-site-plugin</artifactId>
<version>2.0-SNAPSHOT</version>
+ <inherited>true</inherited>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
@@ -359,21 +364,6 @@
<version>2.2-SNAPSHOT</version>
<inherited>true</inherited>
</plugin>
- <plugin>
- <groupId>org.apache.maven.plugins</groupId>
- <artifactId>maven-gpg-plugin</artifactId>
- <version>1.0-alpha-2-SNAPSHOT</version>
- <inherited>true</inherited>
- <executions>
- <execution>
- <id>sign-artifacts</id>
- <phase>verify</phase>
- <goals>
- <goal>sign</goal>
- </goals>
- </execution>
- </executions>
- </plugin>
</plugins>
</pluginManagement>
</build>
@@ -456,6 +446,7 @@
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-site-plugin</artifactId>
<version>2.0-SNAPSHOT</version>
+ <inherited>true</inherited>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
Modified: tapestry/tapestry4/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/site.xml?view=diff&rev=488832&r1=488831&r2=488832
==============================================================================
--- tapestry/tapestry4/trunk/src/site/site.xml (original)
+++ tapestry/tapestry4/trunk/src/site/site.xml Tue Dec 19 14:23:00 2006
@@ -71,6 +71,7 @@
<item name="Configuration" href="/usersguide/configuration.html" />
<item name="Shared Properties" href="/usersguide/properties.html" />
<item name="Upgrading from 3.0" href="/usersguide/upgrade.html" />
+ <item name="Upgrading from 4.0" href="/usersguide/upgrade4.0.html" />
<item name="Specification DTD" href="/usersguide/spec.html" />
<item name="Script Template DTD" href="/usersguide/script.html" />
</item>
Added: tapestry/tapestry4/trunk/src/site/xdoc/download.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/download.xml?view=auto&rev=488832
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/download.xml (added)
+++ tapestry/tapestry4/trunk/src/site/xdoc/download.xml Tue Dec 19 14:23:00 2006
@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Copyright 2004, 2005 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.
+-->
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN"
+ "http://maven.apache.org/dtd/xdoc_1_0.dtd">
+<document>
+ <properties>
+ <title>Download Tapestry 4.1</title>
+ </properties>
+ <body>
+
+<section name="Download Tapestry 4.1">
+ If you are looking for the official binary/source distributions of Tapestry 4.1.1, they can be downloaded
+ <a href="http://tapestry.apache.org/download.html">here.</a>
+
+ <p>
+ <a href="http://tapestry.apache.org/download.html">Download official distribution</a>
+ </p>
+</section>
+
+<section name="Snapshot builds">
+ <p>
+ The Tapestry snapshot builds are currently available via the ibiblio maven2 and apache.org snapshot
+ repositories. To download the current 4.1.2-SNAPSHOT release you shouldn't need to change your pom settings at
+ all, other than including the right artifacts to download Tapestry.
+ </p>
+
+ <p>
+ In order to download the snapshot release versions of Tapestry you will need to add the following repository
+ to your project's pom <em>(if not already present)</em>:
+ </p>
+
+<source xml:space="preserve"><![CDATA[
+http://people.apache.org/repo/m2-snapshot-repository/
+]]></source>
+
+ <span class="warn">
+ <strong>Warning:</strong>
+ <p>
+ Anything released to the snapshot repositories will be under active development and should not be considered stable.
+ </p>
+ </span>
+
+ <subsection name="POM Configuration">
+ <p>To add this repository to your own projects pom.xml you will need a section that looks like:</p>
+
+<source xml:space="preserve"><![CDATA[
+<repositories>
+ <repository>
+ <id>apache.snapshots</id>
+ <url>http://people.apache.org/repo/m2-snapshot-repository</url>
+ </repository>
+</repositories>
+]]></source>
+
+ <p>
+ The dependency inclusion rules should be easy once you have the snapshot repository installed, here is
+ an example of adding just the framework and annotation modules:
+ </p>
+
+<source xml:space="preserve"><![CDATA[
+<dependency>
+ <groupId>org.apache.tapestry</groupId>
+ <artifactId>tapestry-framework</artifactId>
+ <version>4.1.2-SNAPSHOT</version>
+</dependency>
+<dependency>
+ <groupId>org.apache.tapestry</groupId>
+ <artifactId>tapestry-annotations</artifactId>
+ <version>4.1.2-SNAPSHOT</version>
+</dependency>
+<dependency>
+ <groupId>org.apache.tapestry</groupId>
+ <artifactId>tapestry-contrib</artifactId>
+ <version>4.1.2-SNAPSHOT</version>
+</dependency>
+]]></source>
+
+ </subsection>
+
+ <p>
+ Tapestry is distributed under the <a href="http://tapestry.apache.org/license.html">Apache License, version 2.0</a>.
+ </p>
+
+</section>
+
+ </body>
+</document>
Propchange: tapestry/tapestry4/trunk/src/site/xdoc/download.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: tapestry/tapestry4/trunk/src/site/xdoc/usersguide/upgrade4.0.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/usersguide/upgrade4.0.xml?view=auto&rev=488832
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/usersguide/upgrade4.0.xml (added)
+++ tapestry/tapestry4/trunk/src/site/xdoc/usersguide/upgrade4.0.xml Tue Dec 19 14:23:00 2006
@@ -0,0 +1,174 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Copyright 2004, 2005 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.
+-->
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN"
+ "http://maven.apache.org/dtd/xdoc_1_0.dtd">
+<document>
+<properties>
+ <title>Upgrading from 4.0</title>
+</properties>
+<body>
+ <navbar />
+ <section name="Upgrading from 4.0">
+ <p>
+ There have been a large number of bug general bug fixes made in Tapestry 4.1, as well as a large amount of work
+ in the area of "ajax" support in the core framework.
+ </p>
+ <p>
+ This guide will attempt to highlight some of the key changes that might affect people trying to upgrade from <strong>4.0.X</strong>
+ to the current <strong>4.1.X</strong> version.
+ </p>
+ </section>
+
+ <section name="Javascript">
+ <p>
+ One of the largest changes to come about has been the general strategy in dealing with javascript inclusions as well
+ as bundling of the <a href="http://dojotoolkit.org">Dojo</a> javascript toolkit directly in Tapestry. More about these
+ packaging changes can be found in the <a href="../javascript/index.html">javascript guide</a>.
+ </p>
+
+ <ul>
+ <li>
+ <strong>Javascript includes -</strong> The inclusion of dojo now happens automatically if you are using the <a href="../components/general/shell.html">Shell</a> component,
+ and is in general required for Tapestry to function properly in many circumstances. If don't currently use / can't use the
+ <a href="../components/general/shell.html">Shell</a> component the same logic is also encapsulated in the
+ <a href="../components/general/scriptincludes.html">ScriptIncludes</a> component. Both components provide a variety of options
+ allowing for client side debugging / level of debug statements / whether to use the built in dojo provided or a custom build of your own / etc..
+ </li>
+
+ <li>
+ <strong>form.events removed -</strong> A good majority of the core Tapestry javascript includes have either been modified or entirely replaced
+ with new versions that are slightly easier to manage using <a href="http://dojotoolkit.org">Dojo's</a> dynamic module inclusion capability.
+ <em>Almost</em>
+ all of the changes are backwards compatible and include new deprecation warning messages when you call one of the old Tapestry javascript
+ functions. The new javascript API's are also heavily documented, which you can browse <a href="../javascript/index.html">here</a>.
+
+ <br/><br/>
+
+ There is one change that is unfortunately not backwards compatible with these javascript changes, specifically dealing with the old
+ Form.js javascript functions and how they interact with client side events for the <a href="../components/form/form.html">Form</a>
+ component. Tapestry used to modify the client side DOM <code><form></code> element by attaching a <code>form.events</code> property
+ to the object. This is no longer the case. Tapestry doesn't modify any of the DOM elements or client side events on your page anymore. While
+ this change has resulted in much easier form handling abilities on the client side it has come with a price of breaking anyone previously
+ relying on this functionality.
+ </li>
+
+ <li>
+ <strong>onload and <a href="../components/general/script.html">Script</a> templates -</strong> In previous versions of the framework
+ Tapestry would try to ensure that javascript was written to the document body in such a way that the various sections of
+ a <a href="../components/general/script.html">Script</a> template were written out at the correct points in the document to match the
+ various sections of your template. This has now been modified slightly to use <a href="http://dojotoolkit.org">Dojo's</a> event handling
+ facilities to control this behaviour.
+
+ <br/><br/>
+
+ <strong>Example Javascript Template:</strong>
+<source xml:space="preserve"><![CDATA[
+<script>
+<input-symbol key="component" required="yes"/>
+<let key="formObject">
+ document.${component.form.name}
+</let>
+<let key="componentObject">
+ ${formObject}.${component.name}
+</let>
+
+<body>
+function setFocus() {
+ var inputField = ${componentObject};
+ if (inputField.type != "hidden") {
+ if (inputField.disabled != true) {
+ inputField.focus();
+ }
+ } else {
+ window.alert('InputFocus.script cannot set focus on a hidden field');
+ }
+}
+</body>
+<initialization>
+ setFocus();
+</initialization>
+</script>
+]]></source>
+
+ <p>
+ In previous versions of the framework the template above would be rendered out as html looking somewhat like:
+ </p>
+<p><strong>Previous Tapestry 4.0.X generated output:</strong></p>
+<source xml:space="preserve"><![CDATA[
+<html>
+<head><title>Sample</title></head>
+
+<body>
+<script type="text/javascript">
+function setFocus() {
+ var inputField = ${componentObject};
+ if (inputField.type != "hidden") {
+ if (inputField.disabled != true) {
+ inputField.focus();
+ }
+ } else {
+ window.alert('InputFocus.script cannot set focus on a hidden field');
+ }
+}
+</script>
+
+<p>Hello! This is my sample page.</p>
+
+<script type="text/javascript">
+setFocus();
+</script>
+</body>
+</html>
+]]></source>
+
+ <p>With the changes made this section would now be rendered as:</p>
+<p><strong>New Tapestry 4.1.X generated output:</strong></p>
+<source xml:space="preserve"><![CDATA[
+<html>
+<head><title>Sample</title></head>
+
+<body>
+<script type="text/javascript">
+function setFocus() {
+ var inputField = ${componentObject};
+ if (inputField.type != "hidden") {
+ if (inputField.disabled != true) {
+ inputField.focus();
+ }
+ } else {
+ window.alert('InputFocus.script cannot set focus on a hidden field');
+ }
+}
+</script>
+
+<p>Hello! This is my sample page.</p>
+
+<script type="text/javascript">
+dojo.addOnLoad(function(){
+setFocus();
+});
+</script>
+</body>
+</html>
+]]></source>
+
+ </li>
+ </ul>
+ </section>
+
+</body>
+</document>
\ No newline at end of file
Propchange: tapestry/tapestry4/trunk/src/site/xdoc/usersguide/upgrade4.0.xml
------------------------------------------------------------------------------
svn:eol-style = native