Get and install the needed software as outlined in Section 2.1, “Prerequisites”.
Make sure Ant is set up correctly.
Get the sources. Either download and unpack the
Jalopy source distribution which
contains the complete Jalopy sources. Or grab the needed modules directly from the
CVS tree.
Change to the directory where your Jalopy sources reside. You should find a
directory layout somewhat similar to the following (each directory represents a
module; the minimal needed modules are printed in bold):
..
ant/ The Ant Plug-in
build/ The Jalopy build system
console/
docu/ All documentation sources
eclipse/ The Eclipse Plug-in
jbuilder/ The JBuilder Plug-in
jdeveloper/ The JDeveloper Plug-in
jedit/ The jEdit Plug-in
main/ The core Jalopy sources
netbeans/ The NetBeans/Sun ONE Studio Plug-in
Change directory into /build
where the master build script
lurks.
Adjust the global build properties to match your installation. The build
system uses quite a few properties to control the build process and
specify additional needed resources. You can find and adjust these properties in the file
build.properties
.
Luckily you only have to change some common properties to get things running:
Common build properties
- DIR.DOCBOOK.XSL
Specifies the installation directory of the DocBook XSL Stylesheets package.
Note that you have to specify a protocol, e.g. file:///G:/XML/docbook-xsl-1.62.4
.
- DIR.DOCBOOK.DTD
Specifies the path where to find the DocBook XSL DTD.
You have to adjust the default path to match your installation.
- LIB.PATH.
<modulename>
Specifies additional library path(s) needed to build a certain module.
You have to adjust the default path(s) to match your installation.
- PACKAGE.PATH.
<libraryname>
Specifies the location to a directory containing the package-list file for a
given library. This is optional and only needed by Javadoc to resolve links to
documentation for externally referenced classes. Change the default path(s)
to match your installation.
Once everything is set up, you can start a build using ant target
where target
describes one of the main build targets (those with a
description, use ant -projecthelp
to display
the available targets). Just typing ant will build the Jalopy
core runtime distribution.
When a build is done, you can find the created distribution(s) in the
tmp~/dist
folder. The build system creates and stores all
intermediate files and subdirectories under the tmp~
directory.
If you make changes to the source code, just run Ant again; this will perform a
faster incremental rebuild of the target.