INSTALLING SML.NET SUPPORT FOR VISUAL STUDIO .NET
------------------------------------------------

REQUIREMENTS:

Some edition of Visual Studio 2002 or 2003 (version 7.0 or 7.1) 
that includes C++ support; the .NET Framework and and .NET Framework
SDK V1.0 or V1.1.

To install SML.NET for Visual Studio, simply run the executable

.\install.exe

You may need to re-login to your machine (or even reboot) for the
installation to take effect, because it sets an environment variable.

To uninstall, run

.\uninstall.bat

or just

.\install.exe /u



CHECKING INSTALLATION HAS SUCCEEDED
-----------------------------------

Opening an existing Solution
----------------------------
Opening the existing Visual Studio solution included in the distribution:

.\vs\demo\Life\Demo.sln

You should be able to build the solution out of the box.  To run the
solution, you must first manually set the startup project to be the C#
"Client" project.  For some reason, VS assumes that the startup
project is the SML.NET "Server" project, which is a dll that cannot be
run. One way to set the startup project: in the Solution Explorer
Window, right-click on the "Client Project" and select "Set as Startup
Project".

After building the project and editing file Server.sml for the first
time, you should be able to use Intellisense on SML identifiers, set
breakpoints, etc.  SML code should appear in colour. If not, something
went wrong with the installation.

Creating a new Project (and Solution)
-------------------------------------

Start Visual Studio .NET 
Choose New -> Project ...
In the dialog box, open folder "SML.NET Projects"
In the window, double-click on the "SML.NET Application Icon"
This should create a new project.
Now select View -> Solution Explorer
You should see a window with an SML project 
(the icon says its a C++ project)
Open the <ProjectName>.sml file
If it appears with coloured syntax all is well.

You should be able to build and run the project, though the application does nothing.

IF YOU HAVE PROBLEMS AND REALLY, REALLY KNOW WHAT YOU ARE DOING
---------------------------------------------------------------

The installer may fail because it cannot locate a tool it requires, so
we have included the source code for it.  Should you need to fix the
installer, the SML.NET source code for install.exe may be found in
.\vs\install.sml and .\vs\RegTools.sml.

After editing the installer, you can rebuild it as follows.
cd vs
..\bin\smlnet @install.smlnet

The executable is placed in the root directory of the distribution (not in .\vs).
It *must* reside in this directory to work correctly.



