=====================================================================
===                             AMADEUS                           ===
===                        Java Source Viewer                     ===
===                                                               ===
===                         Amadeus-Jasovi-5                      ===
===                        vers. beta  140305                     ===
=====================================================================

GENERAL
Amadeus-Jasovi-5 enables to get quick overviews of typical Java (1.5 
or less) sources. 
It is a version of Amadeus with a combined function "File + Input java"  
which performs the following steps:
      File + Read text
      Select all
      Base + Set base to Java5
      Tools + Sketchify 

The viewer is constructed using a software converter building tool, 
being currently under development by Natalia Tomassova. 

The source JavaCC-grammar (Java1.5.zip):
https://javacc.dev.java.net/servlets/ProjectDocumentList?folderID=110
/**
* Grammar to parse Java version 1.5
* @author Sreenivasa Viswanadha - Simplified and enhanced for 1.5
*/
---------------------------------------------------------------------

USAGE
is free. Unzip AmadeusJSN into a folder (...). 
In text file ...\AmadeusJSN\class\Amadeus.properties correct
   paths to AmadeusJSN (three lines) 

Run 
   ...\AmadeusJSN\class> java Amadeus

Select File + Input java.

The sketch commented by dot indicates inclusion into { }. 
See also Help + Program

Click mouse right button to open/close a sketch (click near the left
upper corner of the sketch).
Double click mouse right button to open/close all sketches at the 
pointed level. 
See also Help + Actions.

The underlying conversion model can be viewed by File + Import 
   ...\AmadeusJSN\models\Java5Model.html
---------------------------------------------------------------------

RESTRICTIONS
are all related to source code comments.

1. A new keyword "kommentaar" is introduced. So Java sources containing
the identifier "kommentaar" can not be viewed. In this case use Jasovi 
instead of Jasovi-5, or perform the steps listed in section GENERAL, but   
     Base + Set base to Java (instead of Java5).

2. Line-end comments which follow "}" in the line will fade out:
    class A {
        ...
    } // A (will dismiss)   

3. Only regular comments are allowed. A regular comment may occur as 
compilation unit member (~ class), class member (~ method), 
or method/statement member (~ statement, but not directly after "if( )", 
"for( )" etc.). 
Examples of irregular comments:
   x = x + d/* in expression */ - 100;

   void method() /* in method head */ { ... }
   
   switch(x){/* outside case or default */ case 1: ... }

                                regular would be:
   while (t) // while-body     |  while (t) { // while-body  
         process(x);           |       process(x);
                                  }  
Irregular comments cause syntax errors, usually something like
    Encountered "kommentaar" ...

To view the source code without comments perform the steps listed 
in section GENERAL, but before Tools + Sketchify assign "-" to the 
outer sketch (press Ctrl+Home and type minus).
--------------------------------------------------------------------


WARNING

It is an incomplete version of Amadeus. So many other functions may 
fail.

=====================================================================
===  Jüri Kiho                                      kiho@cs.ut.ee ===
===  University of Tartu                                  Estonia ===
=====================================================================