===========================================================
                     The Mash Toolkit
===========================================================

Open Mash Consortium
<http://www.openmash.org/>

This directory contains a binary distribution of Mash, the
multimedia networking shell.  For more information, see our
website at <http://www.openmash.org/>.


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

If you are reading this file, you must have already
successfully downloaded and unzipped/untarred this Mash
distribution.

To install Mash on Unix, make sure X Windows is running
first.  Mash and its Setup program are X Windows
applications.  Run the Setup program like this:

    cd mash-5*
    setup

To install Mash on Windows, run the Setup program by
opening the folder named "mash" and double-clicking the
batch file named "setup".

The Setup program will guide you through the rest of the
installation process.  If you wish, you can pick and choose
individual components to install.  The Setup program has
not been tested exhaustively to iron out every possible
configuration.  Your mileage may vary.

The Mash distribution comes with a plug-in for Netscape and
Internet Explorer.  The plug-in has been tested under
FreeBSD, Linux, and Windows NT.  It has been tested only
with Netscape Communicator 4.0 and Microsoft Internet
Explorer 4.0.

WARNING:  The plug-in has not been tested recently.  Use
with extreme caution.

To test the plug-in 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 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 symbolic link from
mash-VERSION to mash in <mash-install-dir>/bin.

Create symbolic links (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 on plug-ins 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
should also create a HOME environment variable.
