Skip to content
git mirror of
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



See the web site

Installing the build tools

The Maxent build system is based on Jakarta Ant, which is a Java
building tool originally developed for the Jakarta Tomcat project but
now used in many other Apache projects and extended by many

Ant is a little but very handy tool that uses a build file written in
XML (build.xml) as building instructions. For more information refer
to "".

The only thing that you have to make sure of is that the "JAVA_HOME"
environment property is set to match the top level directory
containing the JVM you want to use. For example:

C:\> set JAVA_HOME=C:\jdk1.2.2

or on Unix:

% setenv JAVA_HOME /usr/local/java
> JAVA_HOME=/usr/java; export JAVA_HOME
  (ksh, bash)

That's it!

Building instructions

Ok, let's build the code. First, make sure your current working
directory is where the build.xml file is located. Then type

  ./ (unix)

if everything is right and all the required packages are visible, this
action will generate a file called "maxent-${version}.jar" in the
"./build" directory. Note, that if you do further development,
compilation time is reduced since Ant is able to detect which files
have changed an to recompile them at need.

If something went wrong, go to the FAQ section below.

Also, you'll note that reusing a single JVM instance for each task, increases
tremendously the performance of the whole build system, compared to other
tools (i.e. make or shell scripts) where a new JVM is started for each task.

Build targets

The build system is not only responsible for compiling Maxent into a jar
file, but is also responsible for creating the HTML documentation in
the form of javadocs.

These are the meaningful targets for this build file:

 - package [default] -> creates ./build/maxent.jar
 - compile -> compiles the source code
 - javadoc -> generates the API documentation in ./build/javadocs
 - clean -> restores the distribution to its original and clean state

For example, to build the Java API documentation, type javadoc

To learn the details of what each target does, read the build.xml file.  It is
quite understandable.

Bug Reports

Please report bugs at the bug section of the Maxent sourceforge site:

Also, you can report bugs by sending mail to Jason Baldridge at

Special Note

This README and the directory structure and the build system for this
project were taken directly from the JDOM project. Many thanks to
Jason Hunter and Brett McLaughlin for creating a very elegant way of
working with XML in Java.  See for more details.
Something went wrong with that request. Please try again.