[PATCH] Document OpenMP/MPI

[Richard Guenther]

Hi!

While the documentation beyond docs/ is in a rather bad shape, this adds a
paragraph to parallelism.html describing the new --mpi and --openmp modes.

Ok?

How is CodeSourcery planning to do releases in the future?  There is a lot
of old and inaccurate information in the toplevel INSTALL.* and README
files, also VERSION.LOG seems to be not up-to-date, likewise
src/Field/ToDo or the toplevel Ideas.  If it was my personal package, I'd
start ripping out those old files entirely (likewise the scripts/build*
files) and provide a README with requirements and pointers to the
documentation and a generic INSTALL (of course I'd drop all traces of the
word Windows there, too ;)).

Maybe someone of you can suggest how to proceed with all of the
information in these files?

Thanks,

Richard.


===== parallelism.html 1.1 vs edited =====
--- 1.1/r2/docs/parallelism.html        Mon May 13 17:47:21 2002
+++ edited/parallelism.html     Fri Jan  9 13:29:04 2004
@@ -1,4 +1,4 @@
-<h1>POOMA 2.3 parallel model</h1>
+<h1>POOMA post-2.4 parallel model</h1>

 <p>CONTEXT: In discussing the parallelism models that
 POOMA supports, the word `context' has a particular
@@ -40,6 +40,15 @@
 The 2.4 release should address these issues and permit
 a parallel model with multithreaded contexts that communicate
 with each other through messages.
+
+<p>After POOMA 2.4 two new models of parallelism are supported.  Namely
+use of OpenMP thread level parallelization, if supported by the compiler,
+and the use of an available MPI library such as MPICH or a vendor provided
+implementation.  Both models, MPI and OpenMP, may be combined simultaneously
+if the MPI implementation supports this kind of operation.  This is especially
+useful for clusters of SMP workstations.  Those new modes of operation can
+be specified by the --mpi and --openmp configure switches.
+

 <h3>CHEETAH overview:</h2>