Readme.html - tapestry4 - Git at Google

 <html>
 <!-- $Id$ -->
 <head>
 	<title>Tapestry: Java Web Components </title>
 <link rel="STYLESHEET" type="text/css" href="web/scripts/style_virtlib_pcIE55.css">
 </head>

 <body bgcolor="#839cd1" leftmargin="0" topmargin="0" marginwidth="0" marginheight="0">
 <table width="100%" border="0" cellspacing="0" cellpadding="0" bgcolor="white">
 	<tr>
 		<td height="5"><img height="1" src="web/images/spacer.gif" width="1" border="0"></td>
 	</tr>
 	<tr>
 		<td align="left" valign="top" height="20"><span class="release">Release @VERSION@</release></td>
 	</tr>
 	<tr bgcolor="#4b5887">
 		<td colspan="3" height="20"><img height="1" src="web/images/spacer.gif" width="1" border="0">
 		</td>
 	</tr>
 </table>

 <table width="100%" border="0" cellspacing="0" cellpadding="2">
 <tr>
 <td>

 <IMG height=44 src="web/images/ico_t.gif" width=44 align=absMiddle border=0>&nbsp;&nbsp;<IMG height=22 alt="" src="web/images/hd_tapestry.gif" width=100 align=absMiddle vspace=17 border=0>


 <p>Tapestry is a component based framework for creating sophisticated web applications.
 It's used with existing application servers, acting as a kind of "super servlet".
 The <a href="http://tapestry.sf.net">Tapestry Home Page</a>
 contains much more information about what Tapestry
 is, how to use it and why you can't live without it!

 <p>Tapestry is distributed as a single distribution, including source code, compiled frameworks,
 examples and documentation.

 <p>The JARs were created on
 @OS_NAME@ @OS_VERSION@
 using the
 @JAVA_VENDOR@ JDK @JAVA_VM_VERSION@
 compiler.

 <p>This product includes software developed by the Apache Software Foundation
 (<a href="http://www.apache.org/">http://www.apache.org/</a>).

 <P>
 <IMG height=12 src="web/images/dots_leftnav.gif" width=14>&nbsp;<A class=clsLeftNav href="#config">Configuration</A>
 <br>
 <IMG height=12 src="web/images/dots_leftnav.gif" width=14>&nbsp;<A class=clsLeftNav href="#doc">Documentation</A>
 <br>
 <IMG height=12 src="web/images/dots_leftnav.gif" width=14>&nbsp;<A class=clsLeftNav href="#jars">Third Party Jars</A>


 		<br><br>
 		.....................................................
 		<br><br>


 <a name="config"></a>
 <h2>Configuration</h2>

 <p>Tapestry is built using the
 <a href="http://jakarta.apache.org/ant">Ant</a> build tool, version 1.4 or better.
 You need to download and install Ant before running the Tapestry demonstrations.
 You will need to download the Ant optional JAR (which includes additional Ant tasks) and place
 it in your Ant <code>lib</code> folder.


 <p>
 Configuring and running the Virtual Library demo is very easy:
 <ul>
 <li><b>Download (if needed) a JDK 1.3 or newer JVM.  </b>
 <li><b>Download and configure <a href="http://jakarta.apache.org/ant">Ant</a>.</b>
 <li><b>Download <b><a href="http://www.jboss.org/binary.jsp">JBoss</a> 3.0.0</b>.  </b>
 	JBoss is an open-source application server, used to run the database and Enterprise JavaBeans in the Virtual Library.
 <em>The Virtual Library can only be
         auto-configured using the JBoss 3.0.0 distribution.</EM>
 <li><b>Create the file <code><i>Tapestry</i>/config/build.properties</code>.</b>
 		This file informs
         Tapestry where JBoss as been installed.
 		The directory contains a template file.
 		Set <code>jboss.dir</code> to the JBoss installation
 		directory, for example <i>C:/JBoss-3.0.0</i>.
 		<b>Note:</b> Use only forward slashes in this file name.

 <li><b>Execute the command: <code>ant -emacs configure run-jboss</code></b>
 <br>This will copy and configure the necessary files in the JBoss installation directory,
 then run the JBoss server, automatically deploying the Tapestry Tutorials and
 the Virtual Library demonstration.  (The <code>-emacs</code> option changes the
 Ant output format to be less verbose).
 </ul>

 <p>Congratulations, you can now run the
 <a href="http://localhost/tutorial">Tapestry Tutorials</a>
 or the
 <a href="http://localhost/vlib/app">Virtual Library</a>.


 <a name="doc"></a>
 <h2>Documentation</h2>

 <ul>
 	<li><A href="web/doc/Tutorial/Tutorial.html">Tapestry Tutorial</A>
 		    (HTML) -- A good introduction to what Tapestry is
 		and how to use it.
 	<li><A href="web/doc/api/overview-summary.html">Tapestry API</A> (Javadoc)

 	<li><A href="web/doc/DevelopersGuide/DevelopersGuide.html">Tapestry Developer's Guide</A> (HTML) -- main reference for designing and
         developing Tapestry applications</li>


 </ul>


 <a name="jars"></a>
 <h2>Third party JARs</h2>

 Tapestry requires some third party JARs when it is compiled, as well as
 at  runtime. These files are are included in the distribution.
 <p>
 <table border="0">

 	<tr bgcolor="black">
 		<th><font color="white">JAR file</font>
 		</th>
 		<th><font color="white">Version</font>
 		</th>
 		<th><font color="white">License</font>
 		</th>
 		<th><font color="white">Description</font>&lt;
 		</th>
 	</tr>

 	<tr valign="top">
 		<td>com.mortbay.jetty.jar
 		</td>

 		<td>4.0.4
 		</td>
 		<td><A href="LICENSE.Jetty.html">Jetty License</A>
 			<td>Jetty HTTP Servlet Server, see <a href="http://sourceforge.net/projects/jetty">
 			http://sourceforge.net/projects/jetty
 		</a>
 			</td>
 	</tr>
 	<tr valign="top" bgcolor="silver">
 		<td>ejb.jar
 		</td>

 		<td>from jBoss 2.2.2
 		</td>
 		<td>   LGPL</A>
 			<td>EJB 1.1 , copied from the
 	<a href="http://www.jboss.org">JBoss</a> distribution.
 <p>This library is required to compile Tapestry and
       to compile and run the demos and tutorials.</p>
 			</td>
 	</tr>


 	<tr valign="top">
 		<td>javax.servlet.jar
 		</td>

 		<td>2.3
 		</td>
 		<td><A href="LICENSE.javax.servlet.txt">Apache Software License, Version 1.1</A>
 			<td>Servlet API 2.3 reference implementation,
             distributed with Jetty
 			</td>
 	</tr>
 	<tr valign="top" bgcolor="silver">
 		<td>javax.xml.jaxp.jar
 		</td>

 		<td>1.1
 		</td>
 		<td><A href="LICENSE.javax.xml.html">Sun Binary Code License</A>
 		</td>
 		<td>Java API for XML Processing , distributed with Jetty
 		</td>
 	</tr>

 	<tr valign="top">
 		<td>jcommon-0.5.6.jar
 		</td>

 		<td>0.5.6
 		</td>
 		<td><A href="LICENSE.JFreeChart.txt">LGPL</A>
 		</td>
 		<td>Part of <a href="http://www.object-refinery.com/jfreechart/">JFreeChart</a>, used in the Workbench tutorial.
 		</td>
 	</tr>

 	<tr valign="top" bgcolor="silver">
 		<td>jfreechart-0.7.4.jar
 		</td>

 		<td>0.7.4
 		</td>
 		<td><A href="LICENSE.JFreeChart.txt">LGPL</A>
 		</td>
 		<td>Part of <a href="http://www.object-refinery.com/jfreechart/">JFreeChart</a>, used in the Workbench tutorial.
 		</td>
 	</tr>


 	<tr valign="top">
 		<td>junit.jar</td>

 		<td>3.7</td>
 		<td><a href="http://oss.software.ibm.com/developerworks/opensource/license10.html">IBM Public License</a>
 		</td>
 		<td>
 		JUnit
 		Testing Framework, see
 		<a href="http://www.junit.org">www.junit.org</a>

 		</td>
 	</tr>

 	<tr valign="top" bgcolor="silver">
 		<td>log4j-core.jar
 		</td>
 		<td>1.1.3
 		</td>
 		<td><A href="LICENSE.log4j.txt">Apache Software License, Version 1.1</A></A>
 			<td>Logging Toolkit, logging toolkit used by Tapestry framework classes.
 	More information at the <a href="http://jakarta.apache.org/log4j">log4j home page</a>.
 			</td>
 	</tr>


 	<tr valign="top">
 		<td>mckoidb.jar</td>
 		<td>0.92 beta</td>
 		<td>GPL</td>
 		<td><A href="http://mckoi.com/database/">McKoi
             SQL Database</A>, Java SQL Database used for the Virtual Library demonstration.
 		</td>
 	</tr>

 	<tr valign="top" bgcolor="silver">
 		<td>org.apache.crimson.jar
 		</td>
 		<td>1.1
 		</td>
 		<td><A href="LICENSE.javax.xml.html">Sun Binary Code License</A>
 		</td>
 		<td> Sun XML Parser, Distributed with Jetty
 		</td>
 	</tr>

 	<tr bgcolor="black">
 		<td colspan="5" height=1><IMG src="web/images/spacer.gif"></td>
 	</tr>
 </table>


 		<br><br>
 		.....................................................
 		<br><br>

 <p>Tapestry is an open source project, hosted on the <a href="http://sf.net/project/?group_id=4754">SourceForge</a> and licensed
 under the <A href="License.html">GNU Lesser General Public License</A>.</p></td></tr></table>


 <table width="100%" border="0" cellspacing="0" cellpadding="0">
 	<tr bgcolor="#8e9cd1">
 		<td>&nbsp;</td>
 	</tr>
 	<tr bgcolor="#4b5887">
 		<td height="47">
 			<table width="790" border="0" cellspacing="0" cellpadding="0">
 				<tr>
 					<td width="359">&nbsp;</td>
 					<td><a href="http://sf.net/projects/tapestry"><IMG src="http://sourceforge.net/sflogo.php?group_id=4754" width="88" height="31" border="0" alt="SourceForge Logo"></a>
 					</td>
 				</tr>
 			</table>
 		</td>
 	</tr>
 	<tr bgcolor="#333333">
 		<td height="65">
 			<table width="724" border="0" cellspacing="0" cellpadding="3" bgcolor="#000000">
 				<tr height="65">
 					<td width="654" align="right" valign="bottom" class="clsFooter">©2000-2002 Howard Lewis Ship.
 					All rights reserved.</td>
 					<td width="70">&nbsp;</td>
 				</tr>
 			</table>
 		</td>
 	</tr>
 	<tr bgcolor="#333333">
 		<td>
 			<table width="724" border="0" cellspacing="0" cellpadding="3" bgcolor="#000000">
 				<tr height="65">
 					<td height="200" width="654">&nbsp;</td>
 					<td width="70">&nbsp;</td>
 				</tr>
 			</table>
 		</td>
 	</tr>
 </table>


 </body>

 </html>
	<html>
	<!-- $Id$ -->
	<head>
	<title>Tapestry: Java Web Components </title>
	<link rel="STYLESHEET" type="text/css" href="web/scripts/style_virtlib_pcIE55.css">
	</head>

	<body bgcolor="#839cd1" leftmargin="0" topmargin="0" marginwidth="0" marginheight="0">
	<table width="100%" border="0" cellspacing="0" cellpadding="0" bgcolor="white">
	<tr>
	<td height="5"><img height="1" src="web/images/spacer.gif" width="1" border="0"></td>
	</tr>
	<tr>
	<td align="left" valign="top" height="20"><span class="release">Release @VERSION@</release></td>
	</tr>
	<tr bgcolor="#4b5887">
	<td colspan="3" height="20"><img height="1" src="web/images/spacer.gif" width="1" border="0">
	</td>
	</tr>
	</table>

	<table width="100%" border="0" cellspacing="0" cellpadding="2">
	<tr>
	<td>

	<IMG height=44 src="web/images/ico_t.gif" width=44 align=absMiddle border=0>  <IMG height=22 alt="" src="web/images/hd_tapestry.gif" width=100 align=absMiddle vspace=17 border=0>


	<p>Tapestry is a component based framework for creating sophisticated web applications.
	It's used with existing application servers, acting as a kind of "super servlet".
	The <a href="http://tapestry.sf.net">Tapestry Home Page</a>
	contains much more information about what Tapestry
	is, how to use it and why you can't live without it!

	<p>Tapestry is distributed as a single distribution, including source code, compiled frameworks,
	examples and documentation.

	<p>The JARs were created on
	@OS_NAME@ @OS_VERSION@
	using the
	@JAVA_VENDOR@ JDK @JAVA_VM_VERSION@
	compiler.

	<p>This product includes software developed by the Apache Software Foundation
	(<a href="http://www.apache.org/">http://www.apache.org/</a>).

	<P>
	<IMG height=12 src="web/images/dots_leftnav.gif" width=14> <A class=clsLeftNav href="#config">Configuration</A>
	<br>
	<IMG height=12 src="web/images/dots_leftnav.gif" width=14> <A class=clsLeftNav href="#doc">Documentation</A>
	<br>
	<IMG height=12 src="web/images/dots_leftnav.gif" width=14> <A class=clsLeftNav href="#jars">Third Party Jars</A>



	<br><br>
	.....................................................
	<br><br>


	<a name="config"></a>
	<h2>Configuration</h2>

	<p>Tapestry is built using the
	<a href="http://jakarta.apache.org/ant">Ant</a> build tool, version 1.4 or better.
	You need to download and install Ant before running the Tapestry demonstrations.
	You will need to download the Ant optional JAR (which includes additional Ant tasks) and place
	it in your Ant <code>lib</code> folder.


	<p>
	Configuring and running the Virtual Library demo is very easy:
	<ul>
	<li><b>Download (if needed) a JDK 1.3 or newer JVM. </b>
	<li><b>Download and configure <a href="http://jakarta.apache.org/ant">Ant</a>.</b>
	<li><b>Download <b><a href="http://www.jboss.org/binary.jsp">JBoss</a> 3.0.0</b>. </b>
	JBoss is an open-source application server, used to run the database and Enterprise JavaBeans in the Virtual Library.
	<em>The Virtual Library can only be
	auto-configured using the JBoss 3.0.0 distribution.</EM>
	<li><b>Create the file <code><i>Tapestry</i>/config/build.properties</code>.</b>
	This file informs
	Tapestry where JBoss as been installed.
	The directory contains a template file.
	Set <code>jboss.dir</code> to the JBoss installation
	directory, for example <i>C:/JBoss-3.0.0</i>.
	<b>Note:</b> Use only forward slashes in this file name.

	<li><b>Execute the command: <code>ant -emacs configure run-jboss</code></b>
	<br>This will copy and configure the necessary files in the JBoss installation directory,
	then run the JBoss server, automatically deploying the Tapestry Tutorials and
	the Virtual Library demonstration. (The <code>-emacs</code> option changes the
	Ant output format to be less verbose).
	</ul>

	<p>Congratulations, you can now run the
	<a href="http://localhost/tutorial">Tapestry Tutorials</a>
	or the
	<a href="http://localhost/vlib/app">Virtual Library</a>.


	<a name="doc"></a>
	<h2>Documentation</h2>

	<ul>
	<li><A href="web/doc/Tutorial/Tutorial.html">Tapestry Tutorial</A>
	(HTML) -- A good introduction to what Tapestry is
	and how to use it.
	<li><A href="web/doc/api/overview-summary.html">Tapestry API</A> (Javadoc)

	<li><A href="web/doc/DevelopersGuide/DevelopersGuide.html">Tapestry Developer's Guide</A> (HTML) -- main reference for designing and
	developing Tapestry applications</li>


	</ul>


	<a name="jars"></a>
	<h2>Third party JARs</h2>

	Tapestry requires some third party JARs when it is compiled, as well as
	at runtime. These files are are included in the distribution.
	<p>
	<table border="0">

	<tr bgcolor="black">
	<th><font color="white">JAR file</font>
	</th>
	<th><font color="white">Version</font>
	</th>
	<th><font color="white">License</font>
	</th>
	<th><font color="white">Description</font><
	</th>
	</tr>

	<tr valign="top">
	<td>com.mortbay.jetty.jar
	</td>

	<td>4.0.4
	</td>
	<td><A href="LICENSE.Jetty.html">Jetty License</A>
	<td>Jetty HTTP Servlet Server, see <a href="http://sourceforge.net/projects/jetty">
	http://sourceforge.net/projects/jetty
	</a>
	</td>
	</tr>
	<tr valign="top" bgcolor="silver">
	<td>ejb.jar
	</td>

	<td>from jBoss 2.2.2
	</td>
	<td> LGPL</A>
	<td>EJB 1.1 , copied from the
	<a href="http://www.jboss.org">JBoss</a> distribution.
	<p>This library is required to compile Tapestry and
	to compile and run the demos and tutorials.</p>
	</td>
	</tr>


	<tr valign="top">
	<td>javax.servlet.jar
	</td>

	<td>2.3
	</td>
	<td><A href="LICENSE.javax.servlet.txt">Apache Software License, Version 1.1</A>
	<td>Servlet API 2.3 reference implementation,
	distributed with Jetty
	</td>
	</tr>
	<tr valign="top" bgcolor="silver">
	<td>javax.xml.jaxp.jar
	</td>

	<td>1.1
	</td>
	<td><A href="LICENSE.javax.xml.html">Sun Binary Code License</A>
	</td>
	<td>Java API for XML Processing , distributed with Jetty
	</td>
	</tr>

	<tr valign="top">
	<td>jcommon-0.5.6.jar
	</td>

	<td>0.5.6
	</td>
	<td><A href="LICENSE.JFreeChart.txt">LGPL</A>
	</td>
	<td>Part of <a href="http://www.object-refinery.com/jfreechart/">JFreeChart</a>, used in the Workbench tutorial.
	</td>
	</tr>

	<tr valign="top" bgcolor="silver">
	<td>jfreechart-0.7.4.jar
	</td>

	<td>0.7.4
	</td>
	<td><A href="LICENSE.JFreeChart.txt">LGPL</A>
	</td>
	<td>Part of <a href="http://www.object-refinery.com/jfreechart/">JFreeChart</a>, used in the Workbench tutorial.
	</td>
	</tr>


	<tr valign="top">
	<td>junit.jar</td>

	<td>3.7</td>
	<td><a href="http://oss.software.ibm.com/developerworks/opensource/license10.html">IBM Public License</a>
	</td>
	<td>
	JUnit
	Testing Framework, see
	<a href="http://www.junit.org">www.junit.org</a>

	</td>
	</tr>

	<tr valign="top" bgcolor="silver">
	<td>log4j-core.jar
	</td>
	<td>1.1.3
	</td>
	<td><A href="LICENSE.log4j.txt">Apache Software License, Version 1.1</A></A>
	<td>Logging Toolkit, logging toolkit used by Tapestry framework classes.
	More information at the <a href="http://jakarta.apache.org/log4j">log4j home page</a>.
	</td>
	</tr>


	<tr valign="top">
	<td>mckoidb.jar</td>
	<td>0.92 beta</td>
	<td>GPL</td>
	<td><A href="http://mckoi.com/database/">McKoi
	SQL Database</A>, Java SQL Database used for the Virtual Library demonstration.
	</td>
	</tr>

	<tr valign="top" bgcolor="silver">
	<td>org.apache.crimson.jar
	</td>
	<td>1.1
	</td>
	<td><A href="LICENSE.javax.xml.html">Sun Binary Code License</A>
	</td>
	<td> Sun XML Parser, Distributed with Jetty
	</td>
	</tr>

	<tr bgcolor="black">
	<td colspan="5" height=1><IMG src="web/images/spacer.gif"></td>
	</tr>
	</table>


	<br><br>
	.....................................................
	<br><br>

	<p>Tapestry is an open source project, hosted on the <a href="http://sf.net/project/?group_id=4754">SourceForge</a> and licensed
	under the <A href="License.html">GNU Lesser General Public License</A>.</p></td></tr></table>


	<table width="100%" border="0" cellspacing="0" cellpadding="0">
	<tr bgcolor="#8e9cd1">
	<td> </td>
	</tr>
	<tr bgcolor="#4b5887">
	<td height="47">
	<table width="790" border="0" cellspacing="0" cellpadding="0">
	<tr>
	<td width="359"> </td>
	<td><a href="http://sf.net/projects/tapestry"><IMG src="http://sourceforge.net/sflogo.php?group_id=4754" width="88" height="31" border="0" alt="SourceForge Logo"></a>
	</td>
	</tr>
	</table>
	</td>
	</tr>
	<tr bgcolor="#333333">
	<td height="65">
	<table width="724" border="0" cellspacing="0" cellpadding="3" bgcolor="#000000">
	<tr height="65">
	<td width="654" align="right" valign="bottom" class="clsFooter">©2000-2002 Howard Lewis Ship.
	All rights reserved.</td>
	<td width="70"> </td>
	</tr>
	</table>
	</td>
	</tr>
	<tr bgcolor="#333333">
	<td>
	<table width="724" border="0" cellspacing="0" cellpadding="3" bgcolor="#000000">
	<tr height="65">
	<td height="200" width="654"> </td>
	<td width="70"> </td>
	</tr>
	</table>
	</td>
	</tr>
	</table>


	</body>

	</html>