====== Dependencies ======

XMLEye includes recent copies of the open source [[http://www.infonode.net/index.html?itp|InfoNode Tabbed Panel]] and [[http://www.jgoodies.com/downloads/libraries.html|JGoodies Looks]] libraries, so you won't have to get them on your own. You can always replace the JARs included with the very latest copies, but I cannot guarantee that they will work.

You will need JUnit 3.X, Apache Ant 1.7.0 or later and a JDK 6.0-compliant virtual machine with support for Swing, though. You can use OpenJDK if you want. Under Ubuntu Gutsy, you can run:

<code>
sudo aptitude install icedtea-java7-jdk ant junit
</code>

You can also use the ''openjdk-6-jdk'' package or the Sun JRE if you like.

====== Getting the source ======

As usual, the most recent copy can be obtained directly from the Subversion repository in the forge:

<code>
svn checkout https://forja.rediris.es/svn/csl2-xmleye/XMLEye/trunk xmleye
</code>

It is structured as an Eclipse project. I recommend the [[http://subclipse.tigris.org/|Subclipse]] plugin, which integrates Subversion into Eclipse.

====== Ant Makefile structure ======

There's a few targets we can use. By default, ''run'' is used. The most useful ones are:

  * **clean**: cleans up the source tree from temporary files.
  * **compile**:  compiles XMLEye.
  * **dist**: creates a prepackaged distribution, after compiling the source and making sure all test cases pass. See [[Using A Prepackaged Distribution]] for details.
  * **docs**: extracts  Javadoc HTML documentation from the source files.
  * **run**: compiles and runs XMLEye.
  * **test**: runs all unit test cases.

====== Installing XMLEye after compilation ======

Though you can run XMLEye in place using the ''run'' target, I recommend you use the ''dist'' target and install the prepackaged distribution ''dist/xmleye.tar.bz'' as indicated [[Using A Prepackaged Distribution|here]].