You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@velocity.apache.org by wg...@apache.org on 2005/07/18 00:12:28 UTC
svn commit: r219402 - in /jakarta/velocity/core/trunk/xdocs: build.xml
docs/anakia.xml index.xml
Author: wglass
Date: Sun Jul 17 15:12:28 2005
New Revision: 219402
URL: http://svn.apache.org/viewcvs?rev=219402&view=rev
Log:
fixed bad links, spacing
Modified:
jakarta/velocity/core/trunk/xdocs/build.xml
jakarta/velocity/core/trunk/xdocs/docs/anakia.xml
jakarta/velocity/core/trunk/xdocs/index.xml
Modified: jakarta/velocity/core/trunk/xdocs/build.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/core/trunk/xdocs/build.xml?rev=219402&r1=219401&r2=219402&view=diff
==============================================================================
--- jakarta/velocity/core/trunk/xdocs/build.xml (original)
+++ jakarta/velocity/core/trunk/xdocs/build.xml Sun Jul 17 15:12:28 2005
@@ -36,7 +36,7 @@
jakarta-velocity
/build - contains build scripts
/bin - where the built jars / classes will go
- /src - sourcecode for Velocity, Anakia, and Texen
+ /src - source for Velocity, Anakia, and Texen
/docs - documentation in HTML form
/docs/api - Javadocs for Velocity source
/examples - example/demonstration code
@@ -86,8 +86,7 @@
</p>
<p>
-Note that to build any of the specific build targets, as detailed in
-the <a href="docs/developer-guide.html">developers guide</a>, simply add
+Note that to build any of the specific build targets simply add
the target name to the command line. For example, to build the Javadoc
API documentation :
</p>
@@ -96,6 +95,99 @@
ant javadocs
]]></source>
+
+<p>Some of the most useful targets are:
+</p>
+
+<ul>
+ <li>
+ <b><code>jar</code></b> builds the complete Velocity jar in the
+ <code>bin</code> directory. This jar will be called 'velocity-X.jar',
+ where 'X' is the current version number. This jar does not include
+ necessary dependencies for Velocity. If you use this
+ target, you must get the Collections component jar from Jakarta Commons and add
+ to your CLASSPATH (or WEB-INF/lib).
+ If you wish to use the built-in logging or template conversion,
+ you must include the appropriate jars in your CLASSPATH or
+ webapp's WEB-INF/lib.
+ For convenience, you can use the <code>jar-dep</code> target to build
+ a jar with ORO, Logkit and Commons Collections included.
+ </li>
+ <li>
+ <b><code>jar-dep</code></b> builds the complete Velocity jar in
+ the <code>bin</code> directory, including necessary
+ support for logging from the
+ <a href="http://jakarta.apache.org/avalon/logkit/index.html">Jakarta
+ Avalon Logkit</a> package, critical configuration support from the
+ <a href="http://jakarta.apache.org/commons/">Jakarta Commons</a>
+ and the necesary support for WebMacro
+ template conversion using the
+ <a href="http://jakarta.apache.org/oro/index.html">Jakarta ORO</a>
+ package.
+ </li>
+ <li>
+ <b><code>jar-core</code></b> builds a slimmer Velocity jar in the
+ <code>bin</code> directory, called 'velocity-core-X.jar'. This jar
+ contains the core Velocity functionality, and doesn't include example
+ and utility things like Anakia, Texen or the VelocityServlet support
+ baseclass. It has the same external dependency requirements as the
+ regular <code>jar</code> target.
+ </li>
+ <li>
+ <b><code>jar-util</code></b> builds a utility Velocity jar in the
+ <code>bin</code> directory, called 'velocity-util-X.jar'. This jar
+ contains utility code, specifically Anakia, Texen, and the WebMacro
+ template conversion utility. It has the same external dependency requirements as the
+ regular <code>jar</code> target.
+ </li>
+ <li>
+ <b><code>jar-J2EE</code></b> builds a complete jar, like the 'jar' target,
+ that includes any components that require J2EE support. Currently, this
+ includes only org.apache.velocity.runtime.resource.loader.DataSourceResourceLoader.
+ As usual, it is placed in the <code>bin</code> directory, called
+ 'velocity-j2ee-X.jar'. NOTE : if you wish to use this build target, you
+ must place (or link) a copy of j2ee.jar into the build/lib directory.
+ We do not provide it as part of the distribution. A good source is
+ http://java.sun.com/. It has the same external dependency requirements as the
+ regular <code>jar</code> target.
+ </li>
+ <li>
+ <b><code>jar-J2EE-dep</code></b> build a complete jar with J2EE support
+ and includes logging support from the Jakarta Avalon Logkit and
+ regexp support fromt the Jakarta ORO package. See the notes on the
+ <code>jar-dep</code> target, above.
+ </li>
+ <li>
+ <b><code>examples</code></b> builds the example code in the example programs
+ found in the <code>examples</code> directory. This build target will
+ also build the forumdemo example project.
+ </li>
+ <li>
+ <b><code>docs</code></b> builds these docs in the <code>docs</code> directory
+ using Velocity's <a href="anakia.html">Anakia</a> XML transformation tool.
+ Allowing you to use
+ Velocity templates in place of stylesheets
+ - give it a try!
+ </li>
+ <li>
+ <b><code>jar-src</code></b> bundles all the Velocity source code into a single
+ jar, placed in the <code>bin</code> directory.
+ </li>
+ <li>
+ <b><code>javadocs</code></b> builds the Javadoc class documentation in the
+ <code>docs/api</code> directory
+ </li>
+ <li>
+ <b><code>test</code></b> (after jar) will test Velocity against it's testbed
+ suite of test routines
+ </li>
+ <li>
+ <b><code>help</code></b> lists the build targets that are available.
+ </li>
+</ul>
+
+
+
<p>
Velocity should build 'out of the box', independent of your classpath.
If you get an error building Velocity, try a different nightly build (as
@@ -172,8 +264,7 @@
<p>
Note that the number of tests may vary from those shown above, but if
-you see 'OK' after the tests are run, all is well. Now it's time to use
-Velocity.
+you see 'OK' after the tests are run, all is well.
</p>
</section>
Modified: jakarta/velocity/core/trunk/xdocs/docs/anakia.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/core/trunk/xdocs/docs/anakia.xml?rev=219402&r1=219401&r2=219402&view=diff
==============================================================================
--- jakarta/velocity/core/trunk/xdocs/docs/anakia.xml (original)
+++ jakarta/velocity/core/trunk/xdocs/docs/anakia.xml Sun Jul 17 15:12:28 2005
@@ -97,7 +97,7 @@
<section name="Installation/Example">
<p>
Before reviewing the jakarta-velocity/examples/anakia directory,
- you must <a href="install.html">build Velocity</a>.
+ you must <a href="../install.html">build Velocity</a>.
</p>
<p>
After building Velocity, <code>cd</code> into the
Modified: jakarta/velocity/core/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/core/trunk/xdocs/index.xml?rev=219402&r1=219401&r2=219402&view=diff
==============================================================================
--- jakarta/velocity/core/trunk/xdocs/index.xml (original)
+++ jakarta/velocity/core/trunk/xdocs/index.xml Sun Jul 17 15:12:28 2005
@@ -76,7 +76,7 @@
<p>
These are meant to provide easy access to the actual project source control tree.
As this is our live development workspace, there are no guarantees as to
-what you will find there,although we do our best to maintain a buildable
+what you will find there, although we do our best to maintain a buildable
source tree. If you are looking for the stable supported release, please
use the current release of Velocity.
</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org