====== JAsCo command line tools installation ======

The JAsCo Eclipse plugin has reached a mature stage right now, so we highly recommend to employ this IDE for JAsCo development. 

===== Installation Instructions for JAsCo kernel 0.8+ =====


   - Unzip the jasco zip file to <installdir>
   - Add <installdir>/bin to PATH environment variable *
   - Add <installdir>/jasco.jar to CLASSPATH environment variable
   - Add <installdir>/jasco-libs.jar to CLASSPATH environment variable
   - Add <JAVA_HOME>/lib/tools.jar to CLASSPATH environment variable (only required for HotSwap 1)
   - Run setup.bat or setup.sh in <installdir>
   - JAsCo is configured. 

===== SOME HINTS: =====


    * make sure the java bin directory is in your PATH environment variable, so javac and java have to be executable from the prompt!
    * Don't use spaces in directory names (e.g. not good: /var/test/my documents/JAsCo), JAsCo does not cope well with spaces.
    * Make sure . (the current directory) is in your classpath! 

===== Use the scheme below to test the JAsCo Tool-suite (requires Java 1.5): =====

   - Browse to the <installdir> where you installed the JAsCo Tool-suite and go to the examples/Tutorial1 folder
   - Compile the tracing.asp aspect by executing following command: **CompileAspect tracing.asp**
   - Compile the TracingConnector.con connector by executing following command: **CompileConnector TracingConnectors.con**
   - Browse to the <installdir>/examples/Tutorial1/Generated and execute following command: **java -javaagent:<installdir/jasco.jar> test.Main2**
   - A visual application pops up and its execution is traced by the basic.asp aspect. 


===== Use the scheme below to test the JAsCo Tool-suite (non Java 1.5): =====

   - Browse to the <installdir> where you installed the JAsCo Tool-suite and go to the examples/Tutorial1 folder
   - Compile the tracing.asp aspect by executing following command: **CompileAspect tracing.asp**
   - Compile the TracingConnector.con connector by executing following command: **CompileConnector TracingConnectors.con**
   - Transform the Juggler-bean by executing following command: **TransformBean sunw.demo.juggler.Juggler**
   - Browse to the <installdir>/examples/Tutorial1/Generated and execute following command: **java test.Main2**
   - A visual application pops up and its execution is traced by the basic.asp aspect. 

===== Testing support for adaptive programming by traversal connectors (since version 0.2.0) : =====


   - Browse to the <installdir> where you installed the JAsCo Tool-suite and go to the examples/Tutorial2 folder
   - Compile the TestTraversal.trv traversal-connector by executing following command: **CompileTraversal TestTraversal.trv**
   - Browse to the <installdir>/examples/Tutorial2/Generated and execute following command: **java test.trav.example.Example**
   - The traversal as specified by the traversal connector TestTraversal.trv is invoked.