
REQUIREMENTS
~~~~~~~~~~~~

- JDK1.4+ (official build uses Sun's build 1.4.2_10-b03, mixed mode)
- Apache ANT 1.5+ (official build uses v1.6.5)
- Apache Xalan (official build uses v2.7.0)
- Apache FOP (official build uses v0.20.5)
- DocBook DTD (official build uses v4.4)
- DocBook XSL stylesheets (offical build uses v1.69.1)
- A local installation of perl (http://www.perl.com/download.csp)

DocBook DTD is available from www.docbook.org. DocBook XSL stylesheets are
available from http://sourceforge.net/projects/docbook.

BUILDING EMMA DOCS
~~~~~~~~~~~~~~~~~~

- Because the libs required by the build are too large to keep in CVS they
  need to be installed externally. In the directory containing build.xml
  create a file "build.properties" specifying the necessary locations, for
  example:

# -------------------------------------
xalan.home = /xalan-j_2_7_0
fop.home = /fop-0.20.5
docbook.home = /docbook-4.4
docbook.xsl.home = /docbook-xsl-1.69.1
# -------------------------------------
# end of file

- Install the distribution of Perl for your platform

- Make the following FOP-related jars available on your ant classpath
  (by copying to ANT_HOME/lib, or configuring in your IDE):
  - FOP jar
  - avalon jar distributed with FOP
  - batik jar distributed with FOP

- From the directory containing build.xml, execute:

>ant

- After a successful build, EMMA user doc distribution (the "docs" folder of
  the release file distribution) will be located in
  ${basedir}/${dist.dir}/docs, which defaults to ./dist/docs


- To remove all generated build artifacts and reset the build to a clean
  state, execute:

>ant clean

 __________________________________________________________________________
       Copyright (C) 2003-2006 Vlad Roubtsov. All rights reserved.

 This program and the accompanying materials are made available under
 the terms of the Common Public License v1.0 which accompanies this
 distribution, and is available at http://www.eclipse.org/legal/cpl-v10.html
