$Created:  Nov. 11, 1999 -- Ping-Wen Chen
$Revised:  Jan. 25, 2000 -- Ping-Wen Chen
$Revised:  Jan. 28, 2000 -- Weiqun Li
$Revised:  Feb. 21, 2000 -- Ping-Wen Chen

1. IC Compiler (a code generator)

  - Command: icc.exe (DOS mode command. 
             It can be found in the folder "ic manager".)

  - Input:  (a) ic.dat 
            (b) C files for actions (one file for each action) 
                In the example, they are: dclick.c, sclick.c
            (c) customized out_msg.c, predicat.c, inter_mm.c, out_ic.c,
                func_var.c (or use provided template files: outmsg.tpl,
                predicat.tpl., inter_mm.tpl, out_ic.tpl, func_var.tpl)

  - Output: (a) app.h, fuzzy.h, db_def.h,
            (b) ic_func2.c, ic_func3.c, actions.c, do_predicate.c

  - See http://www.cs.pitt.edu/~jung/IC_Compiler/README.ICC.html 
    for the details.

  - All C files for actions will be copied into actions.c.

  - Output files of IC Compiler are all application-dependent.
    They will be integrated (that is, compiled) with IC Manager (see below). 
    (IC Manager is application-independent.)

  - If there is any input file modified, you must run icc.exe again
    in order to get the most updated output files.





2. IC Manager (the kernel of the Active Index system)

  - Folder "ic manager" 

  - Application independent.

  - See http://www.cs.pitt.edu/~jung/IC_Manager/README.ICM.html for the details.
    But this document is for UNIX version and a little bit obsolete.

  - Using VC++, Make a project by including those files in your working folder.
    actions.c  cgienv.c  do_predicate.c  fuzzy.c  ic_func2.c  ic_func3.c
    ic_functions.c  ic_manager.c  ic_state.c   icm.c  util.c
    app.h  event_mesg.h  fuzzy.h  ic.h  mm.h  prototype.h 

  - Complie this project, you get a executable file, in the example, it is 
    "ic_mng.exe". NOTE: YOU DON'T NEED MODIFY ANY FILE. 

  - At the run time, it will read *.in files,(in the example, test.in) each of 
    which defines the behavior of an ic type.  An ic is an instance of an ic type.
 
  - Use CGI mechanism of the WWW to trigger the kernel.
    There are several steps to finish this mechanism:
    * Install a Personal Web Server on your PC. If your PC suports windows98,
      Control Panel --> Add/Remove Program --> "Windows Setup" tab 
      --> "Internet Tools" in Components selection list
      --> "Details" botton --> "Personal Web Server"
      Start--> Programs --> Internet Explore --> Personal Web Server 
      --> Personal Web Manager

    * Start Personal Web Manager and define your virtual Directories in "Advanced" 
      Option. You virtual Directory is the folder you copy and icc all the ic manager
      files, and where the CGI executable file and *.in, *.ic files stored.

    * Define a html page to trigger the CGI program and test your IC manager.
      the sample is "index.html"

  - Note this is not the latest version of the kernel and the wrapper.
    But, it should be enough for your exercise. 


3. Whenever you modify the *.in and ic.dat files, you need redo step 1 and 2.


4. Taoml Interpreter

  - Taoml interpreter is included in icm.zip.

  - Folder "taoml interperter" 

  - PC version

  - See http://www.cs.pitt.edu/~jung/IC_Taoml/README.ICT.html for the details.

  - icm.cgi.exe is the executable file of the Taoml interpreter.