TACLE 1.2.1 SOURCE RELEASE README
---------------------------------
2/07/06

--IMPORTANT--: These instructions are relevant ONLY if you are
downloading the source code of TACLE (file tacle_x_y_z_src.zip) and
trying to build and install the plug-in from source code. You can
ignore these instructions if you

1) Want to download and install the binary-only distribution of TACLE
(file tacle_x_y_z.zip), and you do not care about the source code

or 

2) Want to download the source code in order to understand how TACLE
works, without recompiling the plug-in code. Of course, in this case
you should download and install the binary-only distribution (file
tacle_x_y_z.zip).


Installation Instructions 
-------------------------

1) Download file tacle_1_2_1_src.zip. The zip file contains two
directories: 

TACLE - this an Eclipse project that contains the source code
for the TACLE plug-in, as well as several examples

tacle_summary - this is the Java 1.4 library summary information
needed by TACLE

2) Unzip tacle_1_2_1_src.zip 

3) Import the TACLE source code into your current Eclipse workspace

3.1) Click "File\Import". In the "Import" popup select the "Existing
Project into Workspace" option.

3.2) In the "Project contents" box type or browse the TACLE folder
that you unzipped: e.g. C:\foo\bar\TACLE

3.3) Press "Finish"

3.4) You should see the TACLE project in the package explorer,
together with your other existing projects. 

4) To run the plug-in, you need to install the summary information
from the tacle_summary directory. By default, the summary directory is
expected to be C:\tacle_summary. This is easily done by copying the
tacle_summary directory from the unzipped file onto drive C:.  If it
is not possible or desirable for directory tacle_summary to reside on
C:\, the user will have to change the value of field dataPath in class
tacle.internal.rta.data.DataReader to the new absolute path for the
summary directory. This is a temporary implementation; in the future,
a more flexible solution will be implemented. 

5) You may now test and build TACLE as you would any other Plug-in
Development project. For some examples of TACLE usage, look at
tacle.example.popups.actions. To run a simple example, run the plug-in
(e.g., Run/Run As/Run-time Workbench in Eclipse 3.0), right-click on a
method (does not have to be a main method) in some project, and choose
one of "HelloTacle", "HelloTacleJob", and "ContructCallGraph".

6) After testing and validating that the plug-in was compiled and
built successfully, you can consider deploying it in some Eclipse
installation. The steps for deployment are as follows:

6.1) Right click on the Tacle project in the package navigator frame, 
select the "Export" option.

6.2) In the "Export" popup window select "Deployable plug-ins and 
fragments" then click next.

6.3) In the "Export Plug-ins and Fragments" popup ensure that the 
edu.ohio-state.cse.presto.tacle(X.Y.Z) is selected. In the "File name" 
text box enter the desired destination of the zip and click "Finish".

NOTE: You may desire to couple the summary and the newly created plug-in,
and if this is the case you will need to UNcomment the following
code from the tacle/src/tacle/internal/rta/data/DataReader.java (before 
you build and deploy the plug-in):

/*		
	try {
		this.dataPath = Platform.asLocalURL(Platform.find(b, new Path("summary"))).getPath();
	} catch (IOException ioe) {
		System.out.println(ioe.getMessage());
		//ioe.printStackTrace();
		// if summary not found, plugin exits in a rather abrupt way, for now
		throw new RuntimeException("Exiting...");
	}
*/


and place a copy of the tacle_summary folder renamed "summary" into the 
plugins/edu.ohio-state.cse.presto.tacle(X.Y.Z) folder.