Refs trac:1399.

Syntax and grammar in README.WINDOWS and update refs in README.

This commit was SVN r20055.

The following Trac tickets were found above:
  Ticket 1399 --> https://svn.open-mpi.org/trac/ompi/ticket/1399

README

@@ -167,7 +167,6 @@ General notes
   reasons, mainly because it is part of our acronyms and internal API
   functionc calls.
 
-***** NEEDS UPDATE
 - The run-time systems that are currently supported are:
   - rsh / ssh
   - LoadLeveler
@@ -177,9 +176,8 @@ General notes
   - XGrid
   - Cray XT-3 and XT-4
   - Sun Grid Engine (SGE) 6.1, 6.2 and open source Grid Engine
-  - Windows CCP (Windows server 2003 and 2008)
+  - Microsoft Windows CCP (Microsoft Windows server 2003 and 2008)
 
-***** NEEDS UPDATE
 - Systems that have been tested are:
   - Linux (various flavors/distros), 32 bit, with gcc, and Sun Studio 12
   - Linux (various flavors/distros), 64 bit (x86), with gcc, Absoft,
@@ -191,9 +189,11 @@ General notes
 
   (*) Be sure to read the Compiler Notes, below.
 
-***** NEEDS UPDATE
 - Other systems have been lightly (but not fully tested):
   - Other 64 bit platforms (e.g., Linux on PPC64)
+  - Microsoft Windows CCP (Microsoft Windows server 2003 and 2008);
+    more testing and support is expected later in the Open MPI v1.3.x
+    series.
 
 Compiler Notes
 --------------

README.WINDOWS

@@ -1,41 +1,60 @@
-The actual version of Open MPI compile and run under Windows. The simplest
-way to get access to a windows distribution is to download one from the
-download section on the Open MPI web site (http://www.open-mpi.org) or to
-check it out via SVN (information on the above mentioned web-site).
+2 December 2008
+---------------
 
-The rest of the document is divided on 3. The first and second sections are  
-for easy setup, based on some files we distribute (32 and 64 bits versions). 
-The third one is only for advanced users, who want to deeply dig into the software.
+This version of Open MPI compiles and runs under Microsoft Windows.
+It has received limited testing compared to other POSIX-like
+environments, but it does seem to work.
 
+You can download an Open MPI tarball from the main web site
+(http://www.open-mpi.org) or check out a developer copy via Subversion
+(more information about SVN checkout available on the Open MPI web
+site).
+
+The rest of the document is divided on 3 sections.  The first and
+second sections are for "easy" setup, based on some files that are
+distributed in Open MPI (32 and 64 bits versions).  The third section
+is only for advanced users or developers who want to deeply dig into
+the software.
+
+============================================================================
 
 First approach: Using CMake 
-(CMake support will be available in trunk and Open MPI 1.3.x)
 
-1. Download the latest version of CMake (at least 2.4)
+NOTE: CMake support will be available in on the Open MPI development
+trunk and at some point in the Open MPI 1.3.x series (it is not
+available in Open MPI v1.3.0).
+
+1. Download the latest version of CMake (at least v2.4).
 
 2. In the CMake GUI, add the source path and build path of Open MPI
-   (out of source build is recommended)
+   (out of source build is recommended).
 
-3. Then configure, and after the first time configuration, all available
-   options will show up in the CMake GUI, select required ones.
+3. Then configure, and after the first time configuration, all
+   available options will show up in the CMake GUI.  Select the
+   options that you require.
 
-4. Run configure again and then generate, all Windows solution files
+4. Run configure again to generate all Windows solution files; they
    will be generated in build path.
 
-5. Go to build directory, open the generated Windows solution file,
-   and compile.
+5. Go to the build directory, open the generated Windows solution
+   file, and compile.
 
-Second approach: Simple and strait-forward
+----------------------------------------------------------------------------
 
-Step 1: untar in the root directory of the Open MPI distribution one of our tgz
-        file from contrib/platform/win32/
+Second approach: Simple and straightforward
+
+Step 1: Untar the contrib/platform/win32/ompi-static.tgz tarball in
+        the root directory of the Open MPI distribution.
+
+Step 2: Go in the ompi/datatype subdirectory in the Open MPI
+        distribution and copy the following:
 
-Step 2: go in ompi/datatype and copy
         datatype_pack.c   to datatype_pack_checksum.c
         datatype_unpack.c to datatype_unpack_checksum.c
         
-Step 3: Add the following to ompi/tools/ompi_info/ompi_info.h after you
-        change the relevant information inside (replace everything between @).
+Step 3: Add the following to ompi/tools/ompi_info/ompi_info.h and
+        change the relevant information inside (i.e., replace
+        everything between @'s).
 
 #define OMPI_CONFIGURE_USER "@USER_NAME@"
 #define OMPI_CONFIGURE_HOST "@HOST_NAME@"
@@ -57,33 +76,43 @@ Step 3: Add the following to ompi/tools/ompi_info/ompi_info.h after you
 #define OMPI_F90_ABSOLUTE "none"
 #define OMPI_F90_BUILD_SIZE "small"
 
-Step 4: Open the Open MPI project (.sln file) from the root directory of the distribution
-Step 5: Choose which version you want to build (from the project manager)
-Step 6: Add the build directory to your PATH
-Step *: Have fun ...
-Step *+1: If you have any problems, find any bugs please feel free to report to
-          users@open-mpi.org
+Step 4: Open the Open MPI project (.sln file) from the root directory
+        of the distribution.
 
-Third approach: Confirmed users
+Step 5: Choose which version you want to build (from the project
+        manager).
 
-The rest of this document is only for confirmed developers, who has spare
-time or an urgent necessity to compile their own windows version.
+Step 6: Add the build directory to your PATH.
+
+----------------------------------------------------------------------------
+
+Third approach: Advanced users
+
+The rest of this document is only for advanced users / developers;
+i.e., those who has spare time or an urgent necessity to compile their
+own Windows version of Open MPI.
+
+Compiling Open MPI natively on Windows requires several tools.  Of
+course, one need the Microsoft Visual Studio for their C/C++ compiler
+as well as for the ml (assembler compiler) and the link utilities.
+But the current version require some GNU tools as well.  Here is the
+list of such tools:
 
-Compiling Open MPI natively on Windows require several tools. Of course
-one need the Microsoft Visual Studio for their C/C++ compiler as well as
-for the ml (assembler compiler) and the link utilities. But the current
-version require some GNU tools as well. Here is the list of such tools:
 1. Download any Unix for Windows environment. I have successfully used
-  cygwin and minGW.
+   cygwin and minGW.
+
 2. Make the default shell ash.exe (install it if it's not installed by
-  default) as it will highly decrease the configuration and compilation
-  time.
-3. Download a very recent libtool (I'm using the pre 2.0 from their CVS HEAD).
+   default) as it will highly decrease the configuration and
+   compilation time.
 
-Now you should be set. The most difficult part is done. Just use your favorite
-shell to get a window, go in the ompi directory and ... do like in any
-UNIX environments: configure and make.
+3. Download a very recent Gnu Libtool (e.g., Libtool 2.2.6).
 
-All questions, complaints and requests about the Windows port should be sent 
-by email to bosilca at open-mpi dot org and fan at hlrs dot de.
+Now you should be set. The most difficult part is done. Just use your
+favorite shell to get a window, go in the Open MPi directory and do
+like in any UNIX environments: configure, make, and make install.
 
+----------------------------------------------------------------------------
+
+If you have any problems, find any bugs please feel free to report
+them to Open MPI user's mailing list (see
+http://www.open-mpi.org/community/lists/ompi.php).