
======================================================
                    The MASH Toolkit
======================================================


University of California, Berkeley
MASH Research Group
mash-developers@mash.cs.berkeley.edu

This directory contains a binary distribution of MASH,
the UCB multimedia networking shell.  For more
information, consult the on-line documentation in
http://www-mash.cs.berkeley.edu/mash/.


Installation: 
------------- 

The Windows installation comes as a .ZIP file. You will
need WinZip or a similar utility to unzip this file.
This will create a directory called `mash'. Under that
directory, you will find a setup program:
setup.bat. Switch to that directory and run the
program. This will start up the setup utility.

Under Unix, you must run the setup.sh program in order
to install MASH. You must start setup.sh from the
directory where setup.sh was unpacked. i.e.

    > cd <untar-dir>/mash-5.0b1
    > ./setup.sh

Under Unix, the Setup program is an X-based application,
so you must start your X server before you can run
setup.sh

The Setup utility will guide you through the rest of the
installation process. You can pick and choose individual
components to install, if you wish. The Setup utility
has not been completely and thoroughly debugged to iron
out every single error. Your mileage may vary.

The MASH distribution comes with a plugin for Netscape
and Microsoft Internet Explorer. The plugin has been
tested under Linux, FreeBSD, Windows NT and IRIX. It has
been tested only with NEtscape Communicator 4.0 and
Microsoft Internet Explorer 4.0.

To test the plugin once it has been installed, restart
your browser and point it at
file://<your-mash-directory>/lib/mash-test.html.



Installing MASH manually:
-------------------------

You will need the following directory structure for your
mash installation

	<mash-install-dir>/bin
	<mash-install-dir>/lib
	<mash-install-dir>/lib/setup
	<mash-install-dir>/as

Copy the files from the tarred distribution into the
corresponding directories in your installation. On UNIX,
the mash executable has the name mash-VERSION, where
VERSION is the current mash version. Create a symlink
from mash-VERSION to mash in <mash-install-dir>/bin.

Create symlinks (on UNIX) or copy (on Windows)
lib/npmplug.* to the appropriate place in your browser
directory or home directory. Consult your browser's help
pages for plugins for more information.

Edit the lib/prefs-mplug file and replace all
occurrences of $MASH_HOME with <mash-install-dir>.

Edit your initialization scripts
(.cshrc/.tcshrc/.profile/autoexec.bat) to create an
environment variable MASH_HOME which should point to
<mash-install-dir>. On Windows, you might also want to
create a HOME environment variable.
