[Tapestry Wiki] Trivial Update of "BuildingTapestry" by BobHarner

[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 "BuildingTapestry" page has been changed by BobHarner.
http://wiki.apache.org/tapestry/BuildingTapestry?action=diff&rev1=37&rev2=38

--------------------------------------------------

+ || WARNING: This page applies to an older version of Tapestry. Current information is at [[http://tapestry.apache.org/]] ||
+ 
  ## page was renamed from BuildingTapestry31
  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.
  
@@ -26, +28 @@

  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 (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 (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).
- 
- In addition, after building the site the first time, you can use the '''live-site''' target.  This is very powerful ... it starts up Jetty and Cocoon and runs the Tapestry site '''live!'''.  You can access the live site via http://localhost:8888.
- 
- When you make changes to source XML files (including site.xml and tabs.xml), you execute (in a new window) '''ant copy-documentation-to-composite''', at which point, the changes will be visible to the live site.  This makes it very, very quick and easy to make small changes and see them almost immediately
- 

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