DESCRIPTION

This is a pre-1.0 release of MUTT(tm) Lite, a Multi-User Trivial Terminal
client that provides Winsock access to MU* hosts.

As the name implies, it is not intended to be a full-featured client nor
does it attempt to compete with more established clients such as TF.  I
hope to release MUTT(tm) Elite down the road, which will support many of
the features that the Lite version lacks.

While MUTT(tm) is freeware, I am not releasing it to the public domain.
It may be freely distributed, provided that the distributed zip file is
not modified nor is it bundled with anything else.


MUTT(tm) Lite supports the following features:


        Multiple character connections with an MDI presentation.

        Separate send and receive windows with dialogue logging.

        Drag&Drop support for sending files and command-streams.

        User-definable hotkeys, including cursor key definitions.

        Limited scripting support with triggers, functions & variables.

        Trigger-based popup windows, prompts, sound and MPLAYER support.

        Separate event logging and command recording for each session.

        URL Support for launching from Web Browsers


Note: I banged this together in a few weeks in my spare time - the
script parser is _not_ robust - follow the syntax and you should be
fine.  Use the enclosed sample scripts as templates.

Have fun! - Bob Free



INSTALLATION

These instructions assume that you have correctly installed
Windows and Winsock, have acquired MUTT_xxx.ZIP and are a reasonably
sophisticated Windows user: you can unzip files, read/edit text files,
execute Windows programs, use telnet and know how to connect to a mud.


To install, unzip MUTT_01J.ZIP (with the -d option) into a 
into a suitable directory; eg. \bin\mutt.  You can get a copy 
of PKUNZIP 2.04g from:

ftp://ftp.graphcomp.com/pub/msw/dos/utils/pkz204g.exe.

The contents of the zip'd archive are:

        MUTT_01K.TXT    This file
        MUTT_LIT.EXE    The MUTT(tm) Lite executable
        MUTT_LIT.WRI    Documentation and help file
        DORANS.TXT      A list of MUDs

        SCRIPTS\
        SCRIPTS.TXT     A description of the following script files:
        GENERIC.MUT     Will connect to most muds
        SIMPLE.MUT      A simple example script file
        DEBUG.MUTT      Tests script file support
        LP.MUT          Connects to most LP muds
        DIKU.MUT        Connects to most DIKU muds
        TINY.MUT        Connects to most TINY muds
        TINYMUTT.MUT    Another TINY mud script file
        MEDIEVIA.MUT    Connects to Medievia
        AA.MUT          Connects to Ancient Anguish
        RANGER.MUT      A special AA example script file

        SOUNDS\
        ZING.WAV        Sample sound file
        BOING.WAV       Sample sound file
        RIBBIT.WAV      Sample sound file


You can find additional script files at:
ftp://www.graphcomp.com/msw/mutt/scripts.

Note: graphcomp's FTP server is not a unix server -
if you get odd directory listings from your FTP client, try changing
your connection settings, or use a non-GUI ftp client.


After unzipping the MUTT file, read the MUTT_LIT.WRI file using
Microsoft Write.  This provides information on customizing MUTT.

You can also find additional online MUTT help at:
http://www.graphcomp.com/msw/mutt/help.html.


To play .WAV files, you will need a sound card and a player, and then
associate .WAV file types to that player.  You can FTP a .WAV player 
from ftp://ftp.graphcomp.com/pub/msw/inet/players/wplny12a.zip

To use the "exec" command (used to play .WAV files) on Win3.0, you will 
need to put a copy of SHELL.DLL in your Windows directory.  This is 
available at ftp://ftp.graphcomp.com/pub/msw/mutt/shell.exe



RUNNING MUTT(tm) LITE

Once you've unzip'd the MUTT_xxx file, all you have to do is run 
MUTT_LIT.EXE from PROGMAN or File Manager.  A MUTT.INI file will 
automatically be installed in your Windows directory with default 
settings enabled.  These settings can be modified by using a text 
editor like Notepad.

Once you've started up MUTT(tm) Lite, choose "Open" in the Files
menu and fill in your character name, the IP address and port number
of your mud.  The DORANS.TXT file lists a number of available MUDs.

Selecting "OK" will connect you to the mud, much like a telnet
client.

Alternately, Lite can automatically log onto a MUD for you.  Select 
one of the provided scripts, such as GENERIC.MUT, and enter your 
character password, along with the other fields.  Picking OK will 
assume that you are using an existing mud character and will log 
you in; picking "New" will attempt to create a new character on the 
mud for you.


Once connected, just type in the lower command window; the mud
response will appear in the upper display window.

When done, just close the window.


Good luck! - Bob Free



CHANGES SINCE 0.1J
======================================================================

1. Fixed a problem involving Compuserve/Spry/Twinsock winsocks.

2. Fixed "break"; it now disables triggers.

3. Fixed "findstr" and "equstr"; they now work when both parameters are variables.

4. Removed size limit from "send".

5. Added multi-threaded support (even on Win3.x) to allow outgoing commands 
while receiving incoming spams.

6. Improved Cut&Paste handling from the display window. <ctl-v> pastes 
selected text to commandline; <ctl-x> replaces commandline.

7. Added a "pause" mode that temporarily prevents the display window from 
scrolling while it has focus.  You can toggle this on and off via <ctl-s>.
A green bar indicates pause is off; red indicates that pause is on.

8. Added a ";beep( number )" command which can be used to play sounds.  If the 
number is positive, it plays a standard Windows sound; if negative, it beeps 
that many times.  If you have a sound card, 16=STOP, 32=QUESTION, 
48=EXCLAMATION and 64=ASTERISK.

9. Added an "exec" command that runs programs or launches registered documents 
(.BMP, .WAV, .AVI, etc.).  Usage: exec( "notepad", "c:\autoexec.bat" );
or just exec( "zing.wav" ); if .WAV is associated with a player.
Needs SHELL.DLL.  I also recommend getting the latest WPLANY to play .WAV 
files: ftp://ftp.graphcomp.com/pub/msw/inet/players/wplnt12a.zip
Lite now comes with some sample .WAV files.

10. Changed "log" so that you can have a separate log file for each session.
This is independent of the Open/Close Log menu option - which opens a single 
log for all sessions.

11. Added a "rec" command that works like "log", except that it only records 
your commands - great for recording paths and creating send files.

12. Added program arguments to support URL launching.
