[Tapestry Wiki] Update of "BuildingTapestry" by NickWestgate

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Tapestry Wiki" for change notification.

The following page has been changed by NickWestgate:
http://wiki.apache.org/tapestry/BuildingTapestry

------------------------------------------------------------------------------
  ## page was renamed from BuildingTapestry31
- Tapestry 4.0 is now well into beta ... but there's the question of building it.
+ Tapestry 4.0 is now available as a packaged release... but for the brave and the foolhardy, there's the question of building it from source.
+ 
+ Check out the current trunk using:
+ {{{
+ svn co http://svn.apache.org/repos/asf/tapestry/tapestry4/trunk tapestry-trunk
+ }}}
  
  A set of Ant build files was created for HiveMind, called "HiveBuild".  They are designed to be reasonably reused; that's what Tapestry does.
  
- At this moment, Tapestry builds against HiveMind 1.1-beta-3. You will need to get HiveMind from http://jakarta.apache.org/site/downloads/downloads_hivemind.cgi
+ At this moment, Tapestry builds against HiveMind 1.1.1. You will need to get HiveMind from http://jakarta.apache.org/site/downloads/downloads_hivemind.cgi
  
- You also need Ant 1.6.2 and JDK 1.5.  You also need to download ant install Apache Forrest from http://xml.apache.org/forrest/ (latest from trunk, i.e. 0.8-dev, works fine).
+ You also need Ant 1.6.2 and JDK 1.5.  If you want to build the documentation, you also need to download and install Apache Forrest from http://xml.apache.org/forrest/ (latest from trunk, i.e. 0.8-dev, works fine).
  
- Build Tapestry ('''ant install''').  Ant will automatically download various dependencies from the Maven repository on ibiblio.  You might have to run it a couple of times, dependending on what it has to download (it has to stop after copying certain libraries into Ant's lib directory).
+ Before building Tapestry, you must tell Tapestry's build scripts where the HiveBuild scripts (from HiveMind are).
  
- Inside jakarta-tapestry/config create a build.properties file:
+ Inside tapestry-trunk/config create a build.properties file:
  {{{
  hivebuild.dir=c:/workspace/jakarta-hivemind/hivebuild
  }}}
  
  Adjust the path as necessary.  It must be the absolute path to the hivebuild directory.
  
- From the jakarta-tapestry directory, you should be able to build ('''ant install''').  Nearly all intermediate files (such as compiled class files) are copied into
+ From the tapestry-trunk directory, you should be able to build ('''ant install''').  Nearly all intermediate files (such as compiled class files) are copied into
- ''tempdir''/tapestry ... typically C:/WINDOWS/TEMP/tapestry.
+ ''tempdir''/tapestry ... typically C:/WINDOWS/TEMP/tapestry (or C:/Documents and Settings/Your``User``Name/Local Settings/Temp/tapestry). Ant will automatically download various dependencies from the Maven repository on ibiblio.  You might have to run it a couple of times, dependending on what it has to download (it has to stop after copying certain libraries into Ant's lib directory).
+ 
+ If it complains it can't download the hivemind libraries this is because the version you have needs a non-released version of hivemind. Check out hivemind from subversion and build it with Ant. Then copy the jars from target/ to the ext-package/lib folder under tapestry.
+ 
+ ''Note about building multiple versions on the same machine: ''
+ Build files are cached in the tapestry temp build directory. You may need to manually delete the temp directory before building a different version to prevent cross-contamination (e.g. weird compile errors). 
+ 
+ To build Tapestry without running the unit-tests, do '''ant -Dhivebuild.skip-tests=true install'''.
+ 
  
  After an install you can build documentation ('''ant site''').  This does three things:
   * Copies Forrest xdoc files (and etc.) to target/forrest-composite
-  * Runs Javadoc, clover and other reports, generating into ''tempdir''/tapestry/target/docs
+  * Runs Javadoc, clover and other reports, generating into ''tempdir''/tapestry/target/docs (It's necessary a clover license)
   * Runs Forrest, to create all the HTML files, which end up in ''tempdir''/tapestry/target/docs
  
  After building the site target the ''first time'', if you just change some xdoc documentation, you can use the target '''fast-site'''.  That skips the middle step, which is much faster (a few seconds for the copy, about a minute to run Forrest).

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
For additional commands, e-mail: dev-help@tapestry.apache.org