
Installing UNIX Interactive Tools 4.3:

  1.	There are three main configuration files in UIT 4.3:
	a.	.uitrc.console - Linux console configuration file
	b.	.uitrc.vt100   - vt100 configuration file
	c.	.uitrc.vt102   - vt102 configuration file (same as vt100)
	d.	.uitrc.xterm   - xterm configuration file (X window system)

	When  uit/uitps/uitview  are  started, they  search  a  file  named
	.uitrc.TERM in the user's home directory. TERM is the value of your
	'TERM'  environment  variable,   e.g.  vt102.  If  TERM=vt102  your
	configuration file should  be  .uitrc.vt102 . The  package contains
	three predefined configuration  files  but,  if  you  are  using  a
	different terminal type then you can easy  create  a  configuration
	file for it  renaming / modifying  one  of  them.  Put  a  suitable
	configuration file in your home directory.

  2.	Compile the sources. The Makefile is configured for Linux  but  you
	can very simply configure it for ULTRIX or other UNIX systems. Just
	read it.
	    a) compiling UIT 4.3 for Linux:
		- if you are not using SLACKWARE Linux 1.2.0.* you need  to
		  comment out  the  definition  of  the  function  yywrap()
		  in the file termcap.l. This is due to the fact  that with
		  older versions of flex yywrap() was already defined.
		  Starting with SLACKWARE Linux 1.2.0 flex  doesn't  define
		  yywrap() anymore so I had to do it  myself  in  order  to
		  get UIT correctly compiled (linked). Not my fault :-)
		- if you want to use UIT at the console just do
			make
			make man	// don't bother if it fails
			make info	// don't bother if it fails
			make install
		  'make install' installs uit by default in  the  directory
		  /usr/local/*  (* =  bin  lib  man  info).  Just  edit the
		  Makefile and change the value of the "prefix" variable if
		  you want to install uit in a different place.
		  You should have /usr/local/bin in your PATH variable  and
		  /usr/local/man in your MANPATH variable (or any  directo-
		  ry choosed instead of them in the Makefile).
		  You should  copy the file  /usr/local/lib/.uitrc.TERM  in
		  your home directory.
		  If your monitor is monochrome, in the [Setup] section  of
		  .uitrc.TERM set ColorMonitor to OFF.

		- for those users running UIT with  a  b/w  tty,  copy  the
		  file .uitrc.TERM  in  their home directory setting in the
		  [Setup] section LinuxConsole to  OFF (if  LinuxConsole is
		  OFF, ColorMonitor is ignored).

	    b) compiling UIT 4.3 for other Unix systems:
		- if your C compiler supports the  'const'  keyword, define
		  HAVE_CONST.
		- if your system supports the statfs() system  call  define
		  HAVE_STATFS (optional, UIT 4.3 works fine without it).
		  If UIT fails to compile, just  forget  about  HAVE_STATFS
		  (undefine it and try again).
		- an example: (this should be in the Makefile for a  system
		  with  a compiler  that  supports  the 'const' keyword but
		  doesn't have a statfs() system call)
			SYSTEM    = UNIX
			SYSCONFIG = -DHAVE_CONST
		- if your system use terminfo instead of termcap  (System V
		  i.e.) you must copy the .uittermcap  file  in  your  home
		  directory,  modifying  it  to  suit  your  terminal  type
		  (.uittermcap is a termcap like database).
		- older versions of the lex utility may require  additional
		  configuration options: %a, %e, %n, %p, %k ... etc. If lex
		  fails to generate the termcap.c file  from  termcap.l try
		  to configure it consulting the lex manual page.
		- to compile just do
			make
			make man	// don't bother if it fails
			make info	// don't bother if it fails
			make install
		  'make install' installs uit by default in  the  directory
		  /usr/local/* (* =  bin  lib  man  info).  Just  edit  the
		  Makefile and change the value of the "prefix" variable if
		  you want to install uit in a different place.
		  You should have /usr/local/bin in your PATH  variable and
		  /usr/local/man in your MANPATH variable (or any  directo-
		  ry choosed instead of them in the Makefile).
		  You should  copy the  file  /usr/local/lib/.uitrc.TERM in
		  your home directory. Edit the files .uitrc.TERM  and  set
		  the variable LinuxConsole to OFF in the [Setup] section.

  3.	Make the directories /mnt/fd0 and /mnt/fd1.

  4.	Replace    '/home'   in    the    ^Wh    key    description    with 
	/home/user_home_directory_name. (This is not really  important, but
	users can reach very fast their home directory this way). root home
	directory is /root in the SLACKWARE 1.2.0 distribution.

  5.	Read  the  .uitrc.TERM file to find out how to configure  UIT 4.3's
	colors, keys ...

  6.	Install the Info documentation. Append  the  uit.dir  file  in  the
	package to the file /usr/info/dir (this works for  Linux; on  other
	systems the main Info directory could be different). This is  *NOT*
	done by 'make install'.

  7.	Read the man page or the info documentation.



Good luck !
						Tudor & Andi

---------------------------------------------------------------------------
Please send bug reports to 

tudor@ulise.cs.pub.ro		or to
tudor@habarnam.cs.pub.ro
