Release Notes: WinMPICH 0.9 (alpha)

This is the DLL version of MPICH for Windows NT (Shared Memory only).
This was built using Microsoft Visual C++ 4.0 and is not guaranteed
to work with any other compiler.  Also, only the debug version
is supplied here.  The release version has not been made or tested.
In another ZIP file, the static library version of MPICH is
delivered.  For best results (preserving long file names), WinZip
should be used.  If PKUNZIP is used, long file names will not be
preserved and any attempt to remake this project will most likely
fail.


Assumptions:
1.	You have Microsoft Visual C++ 4.0.  This is what we used.
	We make no guarantees that this code or libraries will
	work with any other compiler.
2.	You know some Windows NT programming basics.  For instance,
	the difference between a DLL and static libraries should
	be known.  The fact that the DLL must be in a directory
	included in the path or in the same directory as the
	executable that uses it.  You must link with winmpich.lib
	in order to use the winmpich.dll.
3.	You will only be using the debug version of these
	libraries (that is all that is provided).  This will make
	it easier to debug your own code by being able to figure
	out whether the problem is in the provided libraries or
	in the user code.
4.	You have an Intel based computer running Windows NT
	3.51 or later.  I have tested this DLL on Windows NT
	4.0 Beta a little but not extensively.
5.	You have a copy of WinZip for Windows NT/95.  It is the
	only one we have found that preserved long file names.
	We have long file names for some source files.  If they
	aren't preserved, you probably will not be able to
	rebuild the DLLs or libraries.

In this, you will find several directories:

winmpich/
	bin/
	debug/
	include/
	lib/
	mpid/
		queue/
	src/
		c++/
		coll/
		context/
		dmpi/
		env/
		profile/
		pt2pt/
		topol/
		util/

winmpich/bin contains the actual DLL.
winmpich/debug contains winmpich.lib that was made.
winmpich/include contains header files
winmpich/lib contains the library that was made (copied from winmpich/debug)
winmpich/mpid contains the shared memory device code for Windows NT
winmpich/mpid/queue contains code for a threadsafe queue used in the device
winmpich/src contains the directories for the MPICH source
winmpich/src/c++ contains C++ code (not used in this implementation)
winmpich/src/coll contains code for collections
winmpich/src/context contains code for MPICH contexts
winmpich/src/dmpi contains MPICH dmpi code
winmpich/src/env contains MPICH env code
winmpich/src/profile contains MPICH profile code
winmpich/src/pt2pt contains point-to-point code
winmpich/src/topol contains topology code
winmpich/src/util contains utility code

In the winmpich/ directory, there are three files.  Two of those
are noteworthy.  First, winmpich.mak is the make file.  There should
be *no* editting of this file.  Microsoft Visual C++ 4.0 will make
edits for you.  Second, winmpich.mdp is the workspace file.
If there is need to work with winmpich directly, use MSVC++ 4.0
to "open workspace" and select this file.  You should be able
to make debug versions of this easily from MSVC++ 4.0.  The
release mode has not been configured the same as the debug mode
and cannot be immediately built with the proper settings.
The release mode is probably not hard to build if the settings
are correct but due to time constraints, we have not set them
up.

We have successfully tested many of the test programs delivered
with mpich-1.0.12.tar.Z from Argonne National Labs.  Some of this
source may be included with the static library version and it
should be simple to use the DLL instead.

Please report any bugs to
shane@erc.msstate.edu
boris@cs.msstate.edu
