Author: craigmcc
Date: Sat Aug 27 20:29:01 2005
New Revision: 263806
URL: http://svn.apache.org/viewcvs?rev=263806&view=rev
Log:
Add "Building Shale From Source" instructions to the release notes document
that is packaged into each distribution. The nightly builds are now
packaged exactly this way, providing a combined source+binary release.
Modified:
struts/shale/trunk/build.xml
struts/shale/trunk/docs/release-notes-1.0.0.html
Modified: struts/shale/trunk/build.xml
URL:
http://svn.apache.org/viewcvs/struts/shale/trunk/build.xml?rev=263806&r1=263805&r2=263806&view=diff
==============================================================================
--- struts/shale/trunk/build.xml (original)
+++ struts/shale/trunk/build.xml Sat Aug 27 20:29:01 2005
@@ -582,7 +582,7 @@
<delete dir="${dist.dir}"/>
</target>
- <target name="release" depends="clean-release"
+ <target name="release" depends="clean-release,dist"
description="Construct release artifacts">
<echo message="---------- Create Release Artifacts For Version
${project.version} ----------"/>
@@ -600,6 +600,8 @@
file="build.xml"/>
<copy todir="${target.dir}"
file="build.properties.sample"/>
+ <copy todir="${target.dir}"
+ file="default.properties"/>
<copy todir="${target.dir}">
<fileset dir="core-library"
includes="*.txt"/>
Modified: struts/shale/trunk/docs/release-notes-1.0.0.html
URL:
http://svn.apache.org/viewcvs/struts/shale/trunk/docs/release-notes-1.0.0.html?rev=263806&r1=263805&r2=263806&view=diff
==============================================================================
--- struts/shale/trunk/docs/release-notes-1.0.0.html (original)
+++ struts/shale/trunk/docs/release-notes-1.0.0.html Sat Aug 27 20:29:01 2005
@@ -38,6 +38,7 @@
<li><a href="#Using">Using Shale In Your Applications</a></li>
<li><a href="#Changes">Changes From Previous Releases</a></li>
<li><a href="#Known">Known Issues In This Release</a></li>
+ <li><a href="#Building">Building Shale From Source</a></li>
</ul>
<a name="Introduction"></a>
@@ -424,6 +425,68 @@
<h3>6.0 Known Issues In This Release</h3>
<p>FIXME</p>
+
+ <a name="Building"></a>
+ <h3>6.0 Building Shale From Source</h3>
+
+ <p>The Shale distribution includes all of the source code for Shale,
+ plus build scripts to reconstruct the release from scratch. In order
+ to build Shale, you must perform the following steps:</p>
+ <ul>
+ <li>Acquire a copy of a <a href="http://java.sun.com/j2se/";>Java
+ Development Kit</a> (Version 1.4 or later), and install it according
+ to the provided documentation.</li>
+ <li>Acquire a copy of <a href="http://ant.apache.org/";>Apache Ant</a>
+ (version 1.6.3 or later), and install it according to the
+ provided documentation.</li>
+ <li>If you wish to build Shale against the JavaServer Faces reference
+ implementation, <a href="http://java.sun.com/j2ee/javaserverfaces/";>
+ acquire a copy</a> (Version 1.1_01) and install it according to
+ the provided documentation.</li>
+ <li>Acquire a copy of a
+ <a
href="http://cvs.apache.org/builds/struts/nightly/sandbox/tiles-core/";>
+ nightly build</a> of Standalone Tiles, and unpack it into a convenient
+ directory.</li>
+ <li>Acquire a Shale distribution (nightly build or release), and unpack
+ it into a convenient directory.</li>
+ <li>In the top-level directory of the unpacked Shale distribution, copy
+ the file <code>build.properties.sample</code> to
<code>build.properties</code>,
+ and customize the property values it contains. Pay particular
attention
+ to the following values:
+ <ul>
+ <li><code>jsfri.dir</code> - If you downloaded and installed the
+ JavaServer Faces Reference implementation, set this property
+ to the fully qualified pathname of the directory into which
+ you installed the distribution.
+ <li><code>tiles.dir</code> - Set this property to the fully qualified
+ pathname of the directory into which you unpacked standalone
Tiles.</li>
+ <li><code>jsf.home</code> - If you are using the JSF Reference
+ Implementation, set this property to the same value you set
+ <code>jsfri.dir</code> to. Otherwise, comment out the default
+ entry and uncomment the following line to enable MyFaces use.</li>
+ <li><code>jsf-api.jar</code> - IF you are using MyFaces, comment out
+ the default value and uncomment the following line.</li>
+ <li><code>jsf-impl.jar</code> - If you are using MyFaces, comment out
+ the default value and uncomment the following line.</li>
+ </ul></li>
+ <li>In the top-level directory of the unpacked Shale distribution, execute
+ the following Ant commands to set up external dependencies:
+ <ul>
+ <li><code>ant download-dependencies</code> - to download freely
available
+ external dependencies.</li>
+ <li><code>ant copy-tiles</code> - to load the Standalone Tiles nightly
+ build artifacts.</li>
+ <li><code>ant copy-jsf-ri</code> - if you are using the JSF RI, load
+ the appropriate artifacts.</li>
+ </ul></li>
+ <li>In the top-level directory of the unpacked Shale distribution, execute
+ the command <code>ant clean release</code> to completely rebuild the
+ entire distribution from source.</li>
+ <li>In addition, each of the major source subdirectories has a properly
+ configured <code>build.xml</code> file, so you can rebuild just that
+ subdirectory if desired.</li>
+ </ul>
+
</body>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
