==========================
       DynamicJava
==========================

o Introduction
--------------

    For details about DynamicJava see the HTML documentation in the docs
    directory or on the web:

        http://koala.ilog.fr/koala/djava/index.html

    The latest version of DynamicJava can be found at this location.

o Platform
----------

    DynamicJava requires the JDK 1.2 or newer installed on your system.

o Installation
--------------

    Unix and Windows:
        Type: jar xfv DynamicJava.zip

o Running the interpreter
-------------------------

    Unix and Windows:
        Type: java -jar djava.jar [options] [file] on the command-line
        See the HTML documentation (docs/index.html) for more details.

    If you launch the application without parameter, a message should
    be displayed:

        Reading from standard input

    You can now type a (Dynamic)Java expression, for example:

        1 + 2;

    Press the return key twice to evaluate the expression.

    After a while (a lot of classes are loaded the first time an
    expression is evaluated) the result should appear:

        => 3

o Running the GUI
-----------------

    Unix:
        Type: java -jar djgui.jar

    Windows:
        Double click on djgui.jar from the Windows Explorer.

o Building DynamicJava from the source
--------------------------------------

    DynamicJava can be compiled with the JDK 1.2, with a command like
    (the current directory must be sources/):

         javac koala/dynamicjava/interpreter/Main.java

    The java source files contained in sources/koala/dynamicjava/parser
    were generated with JavaCC 1.1 (but it also works with 1.0) from the
    'grammar.jj' file contained in this directory.
    Removes all Java source files from sources/koala/dynamicjava/parser
    before running JavaCC.

    To compile the example GUI type:
    javac -classpath ../djava.jar koala/dynamicjava/gui/Main.java

o Comments, suggestions, bug reports
------------------------------------

    sillion@ilog.fr

--
