Update documentation for release 0.04

diff --git a/Changes b/Changes
index 42b068c0e84dc1825254e46e9a6c1d2ff3ec0d8a..7ad5aff15a4490defd88490cc1955140aecb6af5 100644 (file)
--- a/Changes
+++ b/Changes
@@ -2,4 +2,5 @@ Revision history for Perl extension Parallel::MPI::Simple.
 
 0.01  Thu Nov  1 22:46:27 2001
        - original version, played with by self, not for release.
-
+0.04  2011-06-06
+        - Fixes to find things when mpicc available, might quieten bugs

diff --git a/INSTALL b/INSTALL
index 03e953f7de96d9b98c7f1731f51b79b2a7bfd00d..58dfa05804b378f1b08d17a59f5758d9bf07e869 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -1,6 +1,14 @@
 This module tries to compile itself with "-lmpi", some systems require
 additional compiler flags when building and linking MPI applications.
 
+If mpicc is present, this module tries to use `mpicc -compile-info` and
+`mpicc -link-info` to work out how to compile and link itself.  You may
+need to make sure that mpicc is in your path for this to work during
+installation.
+
+You may need to ensure that an appropriate daemon is running before
+using mpirun/mpiexec.  mpich2 requires that mpd is running.
+
 If `make && make test` doesn't work, try specifying CCFLAGS and
 LDFLAGS and LIBS correctly and re-run Makefile.PL.
 
@@ -13,4 +21,5 @@ ExtUtils::MakeMaker manpage for more details.
 SGI    - IRIX64 6.5 IP30 -  2 nodes
 SGI    - IRIX64 6.5 IP27 - 16 nodes
 CRAY   - 2.0.5.55 unicosmk CRAY T3E
-FreeBSD        - FreeBSD4.4 w/lam
\ No newline at end of file
+FreeBSD        - FreeBSD4.4 w/lam
+Linux  - Debian with mpich2

diff --git a/Simple.pm b/Simple.pm
index 296cc57f6cd53fe4e4fcc70b330e36c13665f8d9..eecfebe2ae8b8c43e5d0d4a1d5a10546a3553c58 100644 (file)
--- a/Simple.pm
+++ b/Simple.pm
@@ -6,7 +6,7 @@ use vars qw(@ISA $VERSION);
 use Storable qw(nfreeze thaw);
 
 @ISA = qw(DynaLoader);
-$VERSION = '0.03';
+$VERSION = '0.04';
 
 bootstrap Parallel::MPI::Simple;
 
@@ -49,6 +49,11 @@ sub import {
  }
  MPI_Finalise();
 
+=head1 COMPILING AND RUNNING
+
+Please view the README file in the module tarball if you are having
+trouble compiling or running this module.
+
 =head1 INTRODUCTION
 
 Perl is not a strongly typed language, Perl does not enforce data
@@ -84,6 +89,9 @@ exits cleanly, ready to run another day.
 These processes are all copies of the I<same> perl script and are invoked
 using: C<mpirun -np [number of nodes] perl script.pl> .
 
+Remember you may need to start a daemon before mpirun will work, for
+C<mpich> this is often as easy as running: C<mpd &>.
+
 =head1 Starting and Stopping a process
 
 A process must formally enter and leave the MPI pool by calling these
@@ -519,13 +527,15 @@ use of little other than C<MPI_Init>, C<MPI_Send>, C<MPI_Recv>,
 C<MPI_COMM_WORLD>, C<MPI_Barrier>, C<MPI_Comm_size>, C<MPI_Comm_rank>
 and C<MPI_Finalize>.
 
+Please send bugs to github: L<https://github.com/quidity/p5-parallel-mpi-simple/issues>
+
 =head1 AUTHOR
 
-  Alex Gough (alex@rcon.org)
+  Alex Gough (alex@earth.li)
 
 =head1 COPYRIGHT
 
-  This module is copyright (c) Alex Gough, 2001.
+  This module is copyright (c) Alex Gough, 2001,2011.
 
   You may use and redistribute this software under the Artistic License as
   supplied with Perl.

diff --git a/Simple.xs b/Simple.xs
index 1e80d4be70bebc45b08c7a35fcc270c23f83f3ba..02911444356773ed6865e02f0e7ac897cb2e782c 100644 (file)
--- a/Simple.xs
+++ b/Simple.xs
@@ -2,8 +2,8 @@
 #include "perl.h"
 #include "XSUB.h"
 
-/* This file really made by Inline::C.  If you want to submit patches
- could you contact me (alex@rcon.org) and I'll send you that version */
+/* The Inline::C source for this is available in the __DATA__ section
+   of Simple.pm */
 
 #include <mpi.h> 
 #define GATHER_TAG 11001 /* used to be unlikely to upset other sends */