From: Alex Gough <alex@earth.li>
Date: Mon, 6 Jun 2011 04:07:57 +0000 (+0100)
Subject: Update documentation for release 0.04
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=d0b9c593d9e74305424e8d307a073f7fe61766a0;p=libparallel-mpi-simple-perl.git

Update documentation for release 0.04
---

diff --git a/Changes b/Changes
index 42b068c..7ad5aff 100644
--- 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 03e953f..58dfa05 100644
--- 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 296cc57..eecfebe 100644
--- 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 1e80d4b..0291144 100644
--- 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 */