BIAC XML header tools README

Syam Gadde (gadde@biac.duke.edu), June 2003

=========
COMPILING
=========

To compile the programs in this directory, you will need GNU make,
and some subset of the following libraries installed:
	gdome2 (DOM implementation in C)
	glib (required by gdome2)
	libxml2
	libz
	libiconv
	libintl/gettext
Additional support for BIRN XML files requires:
	libxslt
Alternatively, experimental support using:
	xerces-C
	Pathan
instead of libxml2/gdome2 is also available, but depends on some
bug fixes that aren't yet in the current distributions of xerces-C
or Pathan.  Contact Syam Gadde <gadde@biac.duke.edu> to get these
patches and instructions on how to build with xerces-C/Pathan.

Compiling on Windows
--------------------

See README-WIN32.txt.

Compiling on Linux
------------------

On a typical RedHat Linux installation, you will need to install the
following RPMs from your favorite mirror site:
	glib
	glib-devel
	libxml2
	libxml2-devel
	zlib
	libgdome2
	libgdome2-devel

To enable DICOM support, you will need to compile and install DCMTK from:
	http://dicom.offis.de/dcmtk.php.en
and add the "--with-dcmtk=/my/dcmtk/install/dir" option when running the
./configure script below.
Remember, for DCMTK, you will need to do a
	make install
	make install-lib
	make install-include
to get it to install everything.

To enable MINC support, you will need to compile and install the MINC
and NetCDF libraries from:
	ftp://ftp.bic.mni.mcgill.ca/pub/minc/
and add the "--with-minc=/my/minc/install/dir" and
"--with-netcdf=/my/netcdf/install/dir" options when running the ./configure
script below.

In the source directory, run
  sh ./configure    [<== add configure options here]
then
  gmake

If the script doesn't automatically find glib, libxml2, or gdome,
DCMTK, or other libraries, run "sh ./configure --help" for the
options you can use to specify the installation directories for
these libraries.

You may also compile in a separate directory, if you'd rather not
clutter up the source directory.  Merely create a new compile
directory and run the configure script from there.  Example:

  mkdir /my/compile/dir
  cd /my/compile/dir
  sh /my/source/dir/configure    [<== add configure options here]
  gmake

Compiling on other UNIX-like systems
------------------------------------

The directions for compiling under Linux apply to most UNIX-like
systems, also.  Pay special heed to the configuration options
that let you specify the location of required libraries (like
libxml2, libgdome2, glib), in case they are in non-standard places.
If Perl is not installed on your system, install it.


