Author: hlship
Date: Thu May 4 10:11:38 2006
New Revision: 399775
URL: http://svn.apache.org/viewcvs?rev=399775&view=rev
Log:
Start building documentation.
Added:
tapestry/tapestry5/tapestry-core/trunk/src/site/
tapestry/tapestry5/tapestry-core/trunk/src/site/apt/
tapestry/tapestry5/tapestry-core/trunk/src/site/apt/index.apt
tapestry/tapestry5/tapestry-core/trunk/src/site/apt/upgrade.apt
tapestry/tapestry5/tapestry-core/trunk/src/site/resources/
tapestry/tapestry5/tapestry-core/trunk/src/site/resources/images/
tapestry/tapestry5/tapestry-core/trunk/src/site/resources/images/asf_logo_wide.gif
(with props)
tapestry/tapestry5/tapestry-core/trunk/src/site/site.xml
Modified:
tapestry/tapestry5/tapestry-core/trunk/pom.xml
Modified: tapestry/tapestry5/tapestry-core/trunk/pom.xml
URL:
http://svn.apache.org/viewcvs/tapestry/tapestry5/tapestry-core/trunk/pom.xml?rev=399775&r1=399774&r2=399775&view=diff
==============================================================================
--- tapestry/tapestry5/tapestry-core/trunk/pom.xml (original)
+++ tapestry/tapestry5/tapestry-core/trunk/pom.xml Thu May 4 10:11:38 2006
@@ -6,6 +6,7 @@
<artifactId>tapestry-core</artifactId>
<packaging>jar</packaging>
<version>5.0.0</version>
+ <!-- This should change to tapestry-project -->
<parent>
<groupId>com.javaforge.tapestry</groupId>
<artifactId>common</artifactId>
Added: tapestry/tapestry5/tapestry-core/trunk/src/site/apt/index.apt
URL:
http://svn.apache.org/viewcvs/tapestry/tapestry5/tapestry-core/trunk/src/site/apt/index.apt?rev=399775&view=auto
==============================================================================
--- tapestry/tapestry5/tapestry-core/trunk/src/site/apt/index.apt (added)
+++ tapestry/tapestry5/tapestry-core/trunk/src/site/apt/index.apt Thu May 4
10:11:38 2006
@@ -0,0 +1,43 @@
+ ----
+ tapestry-core
+ ----
+
+Description
+
+ The core module of Tapestry provides the interfaces and annocations that
form the Tapestry API.
+ It also includes the core implementations and and internal code.
+
+Public vs. Internal
+
+ An issue plaguing previous versions of Tapestry was the lack of a clear
deliniator
+ between private, internal APIs and public, external APIs. The fact that
your code would extend
+ from base objects but that many of the methods on those base objects were
"off limits"
+ further confused the issue. This has been identified as a key factor in the
+ "steep learning curve of Tapestry" myth.
+
+ With the clean slate of Tapestry 5, we are being much more ruthless about
internal vs. external.
+
+ First of all, anything inside the org.apache.tapestry.internal package
+ is <<internal>>. It is part of the implementation of Tapestry. It is the
man behind the curtain.
+ You should not ever need to directly use this code. It is a <<bad idea>> to
do so, because
+ internal code may <<change from one release to the next>> without concern
for backwards
+ compatibility.
+
+Backwards Compatibility
+
+ Tapestry has been plagued by backwards compatibility problems with every
major release. Tapestry 5
+ does not even attempt to be backards compatible to Tapestry 4. Instead, it
lays the ground work for
+ true backwards compatibility going forwards.
+
+ Tapestry 5's API is based almost entirely on <annotations>. You will
annotate classes to indicate that
+ they are components, you will annotate fields to allow Tapestry to maintain
their state or to allow Tapestry
+ to inject resources, and you will annotate methods to tell Tapestry when and
if a method should be invoked.
+
+ Tapestry will adapt to your classes. It will call your methods, passing in
values via method parameters.
+ Instead of the rigidness of a fixed interface to implement, Tapestry will
simply adapt to your classes, using
+ the hints provided by the annotations.
+
+ Because of this, Tapestry will be able to change internally to a great
degree without it affecting any
+ of the application code <you> write. This should finally crack the backwards
compatibility nut, allowing you to have
+ great assurance that you can upgrade to future releases of Tapestry without
breaking your existing applications.
+
\ No newline at end of file
Added: tapestry/tapestry5/tapestry-core/trunk/src/site/apt/upgrade.apt
URL:
http://svn.apache.org/viewcvs/tapestry/tapestry5/tapestry-core/trunk/src/site/apt/upgrade.apt?rev=399775&view=auto
==============================================================================
--- tapestry/tapestry5/tapestry-core/trunk/src/site/apt/upgrade.apt (added)
+++ tapestry/tapestry5/tapestry-core/trunk/src/site/apt/upgrade.apt Thu May 4
10:11:38 2006
@@ -0,0 +1,16 @@
+ ----
+ Upgrading from Tapestry 4 to Tapestry 5
+ ----
+
+Upgrading from Tapestry 4 to Tapestry 5
+
+ There is no simple, direct upgrade path from Tapestry 4 to Tapestry 5.
+
+ Tapestry 5 represents a completely new code base. Although it maintains the
<spirit> of
+ Tapestry 4, it is also a quantum leap ahead of Tapestry 4.
+
+ A lot of the familiar aspects of Tapestry are completely different between
the two releases.
+ In other cases, core concepts remain, but the details, names, and
implementations
+ have changed.
+
+ More to come ...
\ No newline at end of file
Added:
tapestry/tapestry5/tapestry-core/trunk/src/site/resources/images/asf_logo_wide.gif
URL:
http://svn.apache.org/viewcvs/tapestry/tapestry5/tapestry-core/trunk/src/site/resources/images/asf_logo_wide.gif?rev=399775&view=auto
==============================================================================
Binary file - no diff available.
Propchange:
tapestry/tapestry5/tapestry-core/trunk/src/site/resources/images/asf_logo_wide.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: tapestry/tapestry5/tapestry-core/trunk/src/site/site.xml
URL:
http://svn.apache.org/viewcvs/tapestry/tapestry5/tapestry-core/trunk/src/site/site.xml?rev=399775&view=auto
==============================================================================
--- tapestry/tapestry5/tapestry-core/trunk/src/site/site.xml (added)
+++ tapestry/tapestry5/tapestry-core/trunk/src/site/site.xml Thu May 4
10:11:38 2006
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<project name="Tapestry Core">
+ <bannerLeft>
+ <name>Tapestry</name>
+ <href>http://tapestry.apache.org/</href>
+ </bannerLeft>
+ <bannerRight>
+ <name>Apache</name>
+ <href>http://www.apache.org</href>
+ <src>images/asf_logo_wide.gif</src>
+ </bannerRight>
+ <body>
+ <links>
+ <item name="Apache" href="http://www.apache.org/"/>
+ </links>
+ <menu name="Tapestry Core">
+ <item name="Introduction" href="index.html"/>
+ <item name="Upgrade from Tapestry 4" href="upgrade.html"/>
+ </menu> ${reports} </body>
+</project>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
