TclRobots - INSTALL


Installation:

	Edit the Makefile.  Three defines are all that you need to specify, in 
	case the default values are not correct for your site.

	WISH_EXEC - the full path of your wish interpreter
	BIN_DIR   - the directory to install tclrobots
	MAN_DIR   - the directory to install the tclrobots man page

	'make install'      will use sed(1) to copy and configure tclrobots.
	'make install-man'  will copy the man page to the destination man dir.


Problems?

	If you have a broken system, you might have to install TclRobots 
	manually.  Here's how:

	1. Make a copy of tclrobots.tcl to tclrobots:

		cp tclrobots.tcl tclrobots
	
	2. Edit the name of your wish interpreter.  You'll need to 
	   modify lines 3 and 5, changing from /usr/local/bin/wish
	   to the full path of your wish.  

		vi tclrobots
		emacs tclrobots
		(whatever)

	3. Make tclrobots executable:
		
		chmod +x tclrobots

	4. Copy tclrobots to a bin directory:

		cp tclrobots /to/where/ever/you/put/executables

	5. Copy the man page also:

		cp tclrobots.man /to/where/ever/you/put/man6/pages/tclrobots.6
	


Runtime problems?

	The most common problem in running TclRobots is when your X server 
	is insecure.  TclRobots will complain that it can't start or
	send to a remote interpreter.  

	Tk's "send" command is used extensively in TclRobots for communication
	from the main program to the individual robot interpreters.  Send
	requires that your X server not be enabled for "xhost" style access.

	If you run "xhost", and it reports other than:

		$ xhost
		access control enabled, only authorized clients can connect

	then you will have to do one of two things: configure your
	X server for "xauth" style security, or recompile your wish interpreter
	for "TK_NO_SECURITY".  Using xauth is the preferred method.

	There are several helper guides for using "xauth":

		ftp://ftp.aud.alcatel.com/tcl/docs/Xauthority.gz
		http://ce-toolkit.crd.ge.com/tkxauth/

	Or ask an X11 expert at your site.  Or (heaven forbid), read the
	man pages for X, Xserver, and xauth.

	Recompiling wish is another option, but has side effects of making
	your X server more open to attacks.  If you must, then edit the
	Makefile in your tk4.0 directory:

		#SECURITY_FLAGS =
		SECURITY_FLAGS = -DTK_NO_SECURITY

	and recompile wish.


	TclRobots version 2.0 requires Tcl 7.4 and Tk 4.0.  Earlier versions
	won't work.

	TclRobots uses some Unix features, and thus probably won't work
	on the Tcl 7.5/Tk 4.1 ports to Windows NT or Macintosh.


If you still have problems, mail to me or post a message to
comp.lang.tcl with a thorough description of your problem.


Tom Poindexter
tpoindex@nyx.net

