				GUI install manual

										
1.Overview

This document explains how to install GUI, and its execution environment.Before
installing, read "2. Environment for installation" to confirm the system to be
used and set up the required environment.

The actual installation procedure is described in "3. Method for installation".

2.Environment for installation

Confirmed to run on following environments in execution and installation.

(1) hardware
	(a) machine
		Sun sparcStatiion 10
	(b) memory
		more than 32MB
	(c) harddisk
		more than 40MB

(2) software
	(a) OS
		SunOS 4.1.3
	(b) C compiler
		gcc-2.6.2
	(c) KLIC(KLIC is IFS)
		more than version1.7
	(d) OSF/Motif
		v1.2
	(e) environment of Japanese
		Needs following either gcc library or header file,
		when installs GUI that use knowlede source(rule,type)to 
		include Japanese.
		
		* library
			libfl.a
		* header file
			euc.h

3. Method for installation

(0) installation of KLIC
    KLIC must be installation before installation of HELIC-II.

(1) Modification of Makefile

    Modifies following Variable Environment 'gui/src' in Makefile.

  (a) Modification of Flex

     (i) If there is flex library(libfl.a),must be modify as follows.

	Flex = exist

     (ii) If there is not flex library(libfl.a),must be modify as follows.

	Flex = nothing

  (b) Modification of LANG
      If there is flex library(libfl.a),does not modify as follows.

     (i) To use 2 byte characters for a rule and concept name, 
	 must be modify as follows.

	LANG = japanese

         Note that the following header file is required in make;

	euc.h

     (ii) Does not use 2 byte characters for a rule and concept name, 
	  must be modify as follows.
	
	LANG = english

(2) Execution of make

Changes current directory to 'gui/src',inputs as follows from shell.

	make 

When this command is executed,program is compiled and execution file is
generated under gui/bin.

(3) Modification of shell variable environment.

 (a) Modification of path

     GUI and translater call translater program in translating rule and type.

     This translater program is generated by executing 'make'.

     Therefore,must be set file path of this translater program to 'path'
     that is shell variable environment in .cshrc or .login.

     For example,there is this translater program under ~/gui/bin,
     add this file path to .cshrc or .login.

	Before modification :
		set path = (~/)

	After modification :
		set path = (~/ ~/gui/bin)

 (b) Modification of HELIC_HOST_NAME and HELIC_HOST_PORT

     GUI refer to variable environments(HELIC_HOST_NAME and HELIC_HOST_PORT)
     in execution.

     Meaning of this variable environments is as follows.


	HELIC_HOST_NAME
		Defines machine name of executing inference engine.
	        But does not need this modification,when specifies -hostname
		 in executing GUI .
		Refer to GUI operation manual.

	HELIC_HOST_PORT
		Defines socket port number that connects between inference 
		engine and Graphic user interface.
      
		If this variable environments isn't set,
		default is 9000.

     For example,defines as follows in .cshrc or .login.

	setenv HELIC_HOST_PORT 9012
	setenv HELIC_HOST_NAME ss122

4.simple example

Simple example is as follows.
"+" means that upper character of "+" is user's inputs.
Current directory in this example is "gui/data".

(1) Run GUI program.
	
	Please inputs following commands from shell.
	
	% cd gui/data
	  +++++++++++
	% guidbt &
	  ++++++++
	% gui
	  +++

(2) Set initial environment.
	(a) Please select 'Load' in top menu(label name:helicII).
	(b) Please select 'Command' in Loading Knowledge menu(labe name:
	    load).
	    Please select(double selection) 'cntrct.c'.
	    Please select 'Done'.
	(c) Please select 'Role' in top menu.
	    GUI program makes Role Assignment(label name:Role).
	    Please select 'System' for Prosecutor.
	    Please select 'System' for Defendant.
	    Please select 'Done'.
	(d) Back to top menu.
	    Please select 'Debate'.
	    GUI program makes Prosecutor window aand Defendant window.
	    Please select 'View' in Prosecutor window.
	    GUI program makes Veiw set menu(label name:View Set).
	    Please select 'View Candidate' in Veiw set menu.
	    GUI program makes Veiw candidate menu(label name:View Candidate).
	    Please select(double selection) 'prosecutor0' in Veiw 
	    candidate menu.
	    Back to View Set menu.
	    Please select 'Done'.
	    These operation means set of prosecutor view.
	    In the same way, execute these operation in Defendant window.
	    But different operation is that please select 'defendant0'
	    ,doesn't select 'prosecutor0'.

(3) Start debate.
	Please select 'Start' in Prosecutor window.
	When execution has fishished,GUI program makes debate end window
	(labe name:informing).
	If execution has fishished,Please select 'Ok' in debate end window.
	
(4) End GUI program.
	(1) Please select 'Quit' in Prosecutor window.
	(2) Please select 'Quit' in top menu.
