
Installing UNIX Interactive Tools 4.2a:

  1.	There are three main configuration files in UIT 4.2a:
	a.	.uitrc.console - Linux console configuration file
	b.	.uitrc.vt102   - vt102 configuration file
	c.	.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 shoud  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.2a 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 clean
			make dep
			make
			make man
			make info
		  and then copy the .uitrc.TERM file 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
		  .uitrc.TERM file in their home directory seting in the
		  [Setup] section LinuxConsole to  OFF (if  LinuxConsole is
		  OFF, ColorMonitor is ignored).

	    b) compiling UIT 4.2a 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.2a 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
		  does't have a statfs() system call)
			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 clean
			make
			make man
			make info

  3.	Copy  uit,  uitcmp,  uitps  and   uitview  somewhere  in  the  path
	(/usr/bin or /usr/local/bin).

  4.	Copy the uit.1 file in  /usr/man/preformat/cat1 (or  whatever  your
	manual utility main directory is), compressing it if necessary.
	uit.1  is the pre-formatted version of the manual page; the  manual
	page is available in un-formatted state and  its  name is  uit.man.
	Do a 'make man' if you want to re-format the  manual page. You  can
	do that only if you have the nroff utility installed on your system.

  5.	Change the uit.1  (or uit.1.gz)  file mode to 644 (make it readable
	for all the users).

  6.	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).

  7.	Read  the  .uitrc.TERM file to find out how to configure UIT 4.2a's
	colors, keys ...

  8.	Read the man page.

  9.	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).


Good luck !
						Tudor & Andi

---------------------------------------------------------------------------
Please send bug reports to tudor@ulise.cs.pub.ro
