Installation notes for UnixTree & WinTree

--------------------------------------------------------------------------
Unix installations:

The Unix packages are all distributed as compressed tar files.
To install any of these packages, do the following:

1.	Pick a directory to install UnixTree in.
	We recommend /usr/local/xt if you are installing this
	program for everyone, otherwise use ~/xt for your personal copy.

2.	Execute the following commands:

	Note: in the following commands,
	<download-dir>		refers to the directory you downloaded the
				install package into.
	<install-package>	refers to the file you downloaded.
	<install-dir>		refers to the directory you wish to install in.

	$ uncompress <install-package>.Z
	$ mkdir -p <install-dir>
	$ cd <install-dir>
	$ tar xvf <download-dir>/<install-package>

3.	Add the install directory to your path to make it accessable:

	$ PATH=$PATH:<install-dir>	export PATH

	You can do this automatically each time you (or everyone) logs in
	by adding that line to either your personal ~/.profile file or
	to the system-wide /etc/profile file.

4.	To access the xt man page, you need to add the xt man directory to
	your MANPATH.  There are two man directories, one for systems whose
	man program supports "man" format files (like Solaris and HP/ux), and
	one for other systems whose man program supports "cat" format files.

	For Unix systems which support "man" format pages, use the command:

		$ MANPATH=$MANPATH:<install-dir>/man export MANPATH

	For other Unix systems, use the command:

		$ MANPATH=$MANPATH:<install-dir>/catman export MANPATH

	This command, like the previous PATH addition, can be added to your
	~/.profile or /etc/profile files.

	After this, the command "man xt" will display the man page for "xt".

	You can also just view the file <install-dir>/catman/man1/xt.1
	using any viewer such as "more" or with an editor such as "vi".

5.	Linux users: If you are using the Linux X-Window system, set the
	environment variable XTTERM to "xterm-c" to access color in your
	xterm window.

Also, for Linux users, there is an RPM file which can be used instead of
the standard TAR file.  Just use the command "rpm -Uhv <package>.rpm".

For SVR4 systems there are PKGADD files which can be used instead of the
standard TAR files.  Just uncompress the appropriate file, and use the
command "pkgadd -d <package>.pkg".

--------------------------------------------------------------------------
Windows installations:

The Windows package is distributed as a "zip" file.  To use, just
pick a directory (or create one) and "unzip" the contents of the
file into it, using any of the available zip programs.

The program may be launched by "clicking" on its icon, but you will
not be able to pass any command-line arguments to it (such as the
directory you wish to log), but its default mode is to log the
entire drive.

Note that the WinTree program is still "under construction", and not
all the Unix-type machanisms map properly.  In particular, the "print"
mechanism only works in "print-to-file" mode.

--------------------------------------------------------------------------
Update notes:

If you are updating UnixTree or WinTree from version 2.2.x, you may
want to move your old user-specific files to the new ones.

The files which have changed are:

	old file	new file	description
	--------	------------	----------------
	~/.xtrc		~/.xt/xt.rc	configuration file
	~/.xtfc		~/.xt/xt.fc	file-color file
	~/.xths		~/.xt/xt.hst	history file

To do this, execute the following commands:

	$ mkdir ~/.xt
	$ mv ~/.xtrc ~/.xt/xt.rc	# to update the configuration file
	$ mv ~/.xtfc ~/.xt/xt.fc	# to update the file-color file
	$ mv ~/.xths ~/.xt/xt.hst	# to update the history file

--------------------------------------------------------------------------
Email comments to: UnixTree@nano-soft.com
UnixTree home: http://www.arkanda.net/utho
Don't leave $HOME without it!
