README.TXT for NewMatcher
=========================

This program is NOT a silver bullet to find out the EXACT list of
unused files. Please use this with CARE and CAUTION. This tool is 
intended to reduce the burden of manually checking up  ALL files
in a directory to figure which are UNUSED. This tool reduces the
number of files to be checked to the ones that are output from the
tool.

USAGE:

1) Go through INSTALL.TXT

2) Open setEnv.bat and set the paths as mentioned.

3) Open a command prompt window. Run setEnv.bat.

4) Now Run java -version. This must output a 1.4 version or higher.

5) Run java tools.NewMatcher <the_directory_name>.

6) IT IS IMPORTANT TO GIVE THE TOP MOST DIRECTORY OF YOUR PROJECT
TO GET BETTER RESULTS. For example, do NOT give d:\projects\TJX\ESR\Web\auth\
for JSPs. Instead, you must give d:\projects\TJX\ESR\ so that all 
cross references get covered.

7) This tool takes a LOOOOOOOOONGGGGGGGGGGGGGGGGGGG time to complete
depending on the number of files present in the directory. Be patient!

8) Contact chsurya@rediffmail.com or vajha@lycos.com in case of problems.

9) For better results:

for(int i=0;i <2/3 ;i ++) {
	Run NewMatcher. After each run, inspect the 
	file list output, after you're sure that a file isn't being 
	referenced, delete it. After u're done with all the files, run the
	tool again.
}

DISCLAIMER: THE AUTHORS OF THIS TOOL ARE NO WAY RESPONSIBLE IF YOU
DELETE A FILE WHICH IS SHOWN IN THE OUTPUT WITHOUT CHECKING IT UP. :-)

INSTALL.TXT for NewMatcher
==========================

The following are the pre-requisite softwares to run NewMatcher:

0) Windows O/S.
[This has been tested with Windows 2000 Professional.]

1) jdk1.4
[This has been tested with build 1.4.1_01-b01 downloaded from sun.]

2) log4j
[We've tested this with log4j1.2.1.jar.]