
Installing UNIX Interactive Tools 4.3.1:

  1.	There are five main configuration files in UIT 4.3.1:
	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
	e.	.uitrc.hpterm  - hpterm configuration file

	When  uit/uitps/uitview  are  started, they  search  a  file  named
	.uitrc.TERM   first   in   the  home  directory  and  then  in  the
	$(prefix)/lib directory (usually /usr/local/lib) (see Makefile).
	(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 five 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 if you want to
	overwrite de default configuration file.

  2.	Configure the Makefile. You must specify  the  system  library  you
	want to use for terminal handling: termcap or terminfo.
	a. if you choose termcap:
		- append -DUSE_TERMCAP to SYSCFLAGS (for most systems  this
		  is the default). Remove -DUSE_TERMINFO if it is there.
		- uncomment the  SYSLDFLAGS  line  containing  the  termcap
		  library for that system (there are two SYSLDFLAGS  lines,
		  one for termcap and another for terminfo; see the comment
		  at the end of each one).
	b. if you choose terminfo:
		- append -DUSE_TERMINFO to SYSCFLAGS. Remove  -DUSE_TERMCAP
		  if it is there.
		- uncomment the  SYSLDFLAGS  line  containing  the terminfo
		  library for that system (there are two SYSLDFLAGS  lines,
		  one for termcap and another for terminfo; see the comment
		  at the end of each one).

  3.	Compile the sources. The Makefile is configured for Linux  but  you
	can very simply configure it for  ULTRIX, HP-UX, DEC OSF/1 or other
	UNIX systems. Just read it.
	    a) compiling UIT 4.3.1 for Linux:
		- 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 can copy the file /usr/local/lib/.uitrc.TERM  in your
		  home directory to overwrite the defaults.
		  If your terminal supports standard  ANSI  color sequences,
		  set AnsiColorSequences to ON  in the  [Setup]  section  of
		  .uitrc.TERM. Otherwise, AnsiColorSequences should be OFF.

	    b) compiling UIT 4.3.1 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.1 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
			SYSCFLAGS = -DHAVE_CONST
		- 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 can copy the file /usr/local/lib/.uitrc.TERM  in your
		  home directory to overwrite the defaults.
		  If your terminal supports standard  ANSI  color sequences,
		  set AnsiColorSequences to ON  in the  [Setup]  section  of
		  .uitrc.TERM. Otherwise, AnsiColorSequences should be OFF.

  4.	Make the directories  /mnt/fd0  and  /mnt/fd1  (for mounting floppy
	disks with uitmount (an auto-mount script). This is for  Linux,  on
	other systems might be different.

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

  6.	If you are using termcap and your system has a huge  termcap  data-
	base, copy the descriptions of your terminal(s) in a file  and  put
	that file into your home directory. After  that, set  your  TERMCAP
	environment variable to point to it. If your login name is mike and
	the file  you  have  just  created  is  .termcap, you  must  append
	something like this to your .profile :

	TERMCAP=/home/mike/.termcap

	This will speed up UIT at startup.

	If you are using terminfo, don't bother.

  7.	In  order  to  be  able  to  read the Info documentation you should
	append  the  uit.dir  file  (found 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'.

  8.	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
