BUILDING

To build with maven 2.x (http://maven.apache.org/):

  mvn install
  
The jars will be compiled and installed in your local Maven repository
  
To build with ant (http://ant.apache.org/):

  # run a basic build
  ant -f build/build.xml

  # run test tests
  ant -f build/build.xml test

  # perform a complete build, jars and javadocs will be copied to 'dist' folder
  ant -f build/build.xml dist
  
  # produce a distributable zip
  ant -f build/build.xml zip

  # clean
  ant -f build/build.xml clean

  # delete downloaded dependencies
  ant -f build/build.xml clean-downloads

Note: To build with XML Security support, set the ABDERA_XMLSECURITY environment
variable to "yes" prior to running the ant build

To build with Eclipse (http://www.eclipse.org).  

There are two methods depending on whether or not you're comfortable with Maven

With Maven:
  Check out java/trunk, and from java/trunk run "mvn eclipse:eclipse".  Then
  import each project.  If you have the SVN checkout as a project in Maven, 
  you'll need an Eclipse 3.2 to import these projects without an error 
  regarding "overlapping projects'.  The alternative is to run
  "mvn -Declipse.workspace=/path/to/workspace eclipse:eclipse", which
  will set up a project where the source files are linked to the actual
  location.

  You'll also need to have a buid path variable for "M2_REPO" defined to match 
  your local repository (~/.m2/repository). You can do this manually, or by 
  running "mvn -Declipse.workspace=<path-to-eclipse-workspace> eclipse:add-maven-repo" 

Without Maven:
  From within eclipse, check out each of the following
  as projects.  Do not worry about the project type for now:
  
     * /java/trunk/build              project name: build
     * /java/trunk/core               project name: core
     * /java/trunk/dependencies       project name: dependencies
     * /java/trunk/docs               project name: docs
     * /java/trunk/extensions         project name: extensions
     * /java/trunk/examples           project name: examples
     * /java/trunk/parser             project name: parser
     * /java/trunk/server             project name: server
     * /java/trunk/security           project name: security
     * /java/branches/snell_sandbox   project name: snell_sandbox
  
    From the eclipse workspace root, invoke:
      ant -f build/build.xml init
  
    Then, from the eclipse workspace root, invoke
      ant -f snell_sandbox/eclipse/setupeclipse.xml
  
    This will copy all of the necessary eclipse project files over to
    the appropriate projects in the eclipse workspace.  Restart your
    eclipse workbench and all of your projects should be ready to go.
  
    Note: the security module will contain compile errors due to missing
    XML Security jars.  To build and use that module, you'll need to
    download the Apache XML Security and the Bouncy Castle Crypto
    implementation.