GridSolve on Microsoft Windows
===================================

Visual C: Native GridSolve clients (for the GridRPC C API and for
Matlab 2006a only) have been built on Windows machine using the
Microsoft Visual C compiler (VC 6.0).  GridSolve agent, proxy, server
and other GridSolve clients and have not been built using this
compiler at present. 

Cygwin: It is possible to build most of GridSolve (aagent, server,
proxy, clients [C, Fortran, GridRPC, NetSolve]) on a Windows machine
using an Linux-like environment such as Cygwin using the standard
build instructions.  The Matlab client will not build automatically
under Cygwin because of problems linking the Matlab dynamic libraries
with the Cygwin created GridSolve libraries.


Using the Windows binary distribution
==========================================

GridSolve is currently distributed with a Windows binary package
(built using Microsoft Visual C) that contains the GridRPC clients and
the Matlab client and some testing code.  This is mainly done to
enable a Matlab user to get access to GridSolve without having to
compile GridSolve themselves.

To demonstrate the Matlab client.
 - Add gridsolve_install_dir/matlab to the Matlab path
 - Start Matlab, set the GridSolve agent, locate and run some Matlab
   tests.
   >> gs_putenv('GRIDSOLVE_AGENT=gridsolve.cs.utk.edu')
   >> cd 'gridsolve_install_dir/testing/matlab'
   >> totaltest
   >> return_test
   >> demosc1
   >> demosc2
   >> cd mandelbrot
   >> mandelbrot_gui
   >> cd ..
   >> cd myquad
   >> myquad
   >> cd ..
   >> exit


Building GridSolve with Microsoft VC
===================================

To build the Windows native client, the VC project files are generated
using the CMake build tool.
 - Download and install CMake from
   http://www.cmake.org/HTML/Index.html
 - Generate a VC project using CMake, and set
     Where is the source: gridsolve_source_dir
     Where to build the binaries: gridsolve_source_dir\windows_build 
     Verify the default install directory: Program Files/GridSolve
   The location of Matlab should be detected by CMake.
 - In VC, load and compile the generated project.  You may need to use
   the INSTALL target in order to distribute it.  The default INSTALL
   directory will be in "Program Files/GridSolve"