build-from-source YAJUL uses Maven2 as a build tool, so the first step is to Download and install Maven2 . For Maven2 to work properly from the command line, the shell environment needs the following:
There are a few Java Enterprise API jars that are not currently available in the Maven repositories, so these need to be installed in the developers local respository before YAJUL will compile successfully with Maven2. The jars are located in the 'lib' directory, and you can install them into the local Maven repository using the 'install:install-file' goal:
mvn install:install-file -DgroupId=javax.jms -DartifactId=jms -Dversion=1.1 / -Dpackaging=jar -Dfile=./lib/javax.jms.jar mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta -Dversion=1.0.1B / -Dpackaging=jar -Dfile=./lib/jta.jar
These are some of the more frequently used Maven goals:
To build everything from scratch, run:
mvn clean package source:jar site
YAJUL comes with a .ipr project that will have everything set up for building and testing the YAJUL code. Simply check out the codebase with SVN and open up the .ipr file with IDEA 7.
Maven generates a project website from files in the 'src/site' directory. The files in the 'src/site/apt' directory are in the APT format , which is a bit like wiki text. These can be edited with any text editor.