Building VisualVM
=================

For convenience we've provided make targets that automatically
download, extract and build the source code for VisualVM.

Building requires a bootstrap JDK and an appropriate version of
NetBeans.  Currently, we support the use of IcedTea6 as packaged with
most GNU/Linux distributions.

See ./configure --help if you need to override the defaults.

$ ./autogen.sh
$ ./configure --prefix=<visualvm install location>
$ make
$ make install

The default version is currently 1.2.2.  Supported versions
are:

* 1.2.2 with NetBeans 6.8
* 1.3 with NetBeans 6.9
* 1.3.1 with NetBeans Platform 6.9.1
* 1.3.2 with NetBeans Platform 6.9.1

To build with a version other than the default, specify
--with-visualvm-version=x where x is the version.

VisualVM is installed in the specified prefix as with normal packages.
To achieve the effect previously used when VisualVM was integrated
into IcedTea, just use a prefix equal to the JDK's location.

Build Modification Options
==========================

The build process may be modified by passing the following options
to configure:

* --with-netbeans-home: Specifies the path to the NetBeans installation
  to use to build.  Defaults to /usr/share/netbeans.
* --with-jdk-home: Specifies teh path to the JDK to use to build.
  The first of:

  * /usr/lib/jvm/java-openjdk
  * /usr/lib/jvm/icedtea6
  * /usr/lib/jvm/java-6-openjdk
  * /usr/lib/jvm/openjdk
  * /usr/lib/jvm/java-icedtea

  which is found to be present is used by default.
* --with-netbeans-profiler-zip: The path to the appropriate NetBeans
  profiler zip file to avoid downloading it.
* --with-visualvm-zip: The path to the appropriate VisualVM zip file
  to avoid downloading it.
* --with-visualvm-version: Specify the version of VisualVM to build
  from those supported.  The default is 1.2.2.