PROJECT: Merlin 3.0
====================================================================

DESCRIPTION: 
------------

This directory contains the merlin system installation and related 
resources.

  /merlin
    /bin
    /config
    /ext
    /repository
    /system
    README.TXT
    LICENSE.TXT
  /plugins
    avalon-meta-plugin-1.2-SNAPSHOT.jar
    merlin-plugin-1.2.jar


Installing Merlin.
------------------

To use Merlin command line support or the Merlin NT Service
you will need to define the MERLIN_HOME environment
variable for your system and include MERLIN_HOME/bin in
your system path.  The MERLIN_HOME environment variable
should point to the merlin directory.

Under Lunix you can do this as follows:

  $ echo '
  > # set location of merlin
  > export MERLIN_HOME=/opt/merlin
  > # include it in the path
  > export PATH=$PATH:$MERLIN_HOME/bin
  > ' >> ~/.bash_profile
  $ source ~/.bash_profile

Under Windows you can set environment variables by selecting the 
Environment Tab from the System Control Panel.

To confirm that you %MERLIN_HOME% variable is correct, you
should open a new command window and invoke the Merlin
CLI application.

Under DOS:

  $ merlin -version

Under Lunix:

  $ merlin.sh -version

The installation of Merlin is now complete, however, two plugins are
provided with the installation supporting merlin development under the 
Maven platform.  These plugins should be placed in the Maven plugin 
directory (%MAVEN_HOME%\plugins).

  %MAVEN_HOME%\plugins\avalon-meta-plugin-1.2-SNAPSHOT.jar
  %MAVEN_HOME%\plugins\merlin-plugin-1.1-SNAPSHOT.jar

Please note that if you are upgrading an existing installation you must
delete the following two directories:

  %MAVEN_HOME%\plugins\merlin-plugin-* 
  %MAVEN_HOME%\plugins\avalon-meta-plugin-*

Replace the existing avalon-mweta and merlin plugin jar files with the supplied
versions.  Finally, delete all *.cache files in the Maven plugin directory.

You now have everything in place to start using the Merlin Tutorial or 
building you own components.  If you have any problems, please subscribe
and post a message to users@avalon.apache.org.