psblas3:

README
 docs/html/index.html
 docs/html/userhtml.html
 docs/psblas-3.0.pdf
 docs/src/userguide.tex
 docs/src/userhtml.tex

Updated README and date on users' guide.

README

@@ -1,8 +1,8 @@
-This directory contains  the PSBLAS library, version 3.0-pre-release.
+This directory contains  the PSBLAS library, version 3.0-beta. 
 
-WARNING: This is higly experimental, unstable, and almost undocumented.  
+This version is still experimental, to some extent, but has already
-	 Do not count on anything to remain unchanged by the time 3.0
+undergone  quite a bit of testing; the documentation has been updated,
-	 really comes out. 
+although it probably still contains some inconsistencies. 
 
 This version requires a working Fortran 2003 compiler; we do not use
 all of the language features (specifically, so far we did not employ
@@ -10,27 +10,23 @@ FINAL subroutines), but the features we use were sufficient in
 identifying bugs in ALL compilers we tried (all the bugs have been
 reported and mostly fixed by the respective vendors). 
 
-Notes: This code is confirmed to work with the following compilers 
-       (as well as newer versions):
-       NAGware 5.2 and subsequent;
-       XLF 13.1;
-       GNU 4.6.1;  
-       Cray CCE 7.4.4;
-       All these are recognized by the configure script. 
-       If you find it working with other compilers, please let us
-       know. 
-       The Intel compiler up to version 12.1 fails. 
 
-       The "undocumented" in the warning above refers to the
+
-       internals; the new internals have been completely overhauled,
+The new   have been completely overhauled, and in many cases
-       and in many cases rewritten; they now enable a much
+rewritten; they now enable a much better interfacing with user-defined
-       better interfacing with user-defined storage formats. If the
+storage formats. If the user is only interested in the predefined
-       user is only interested in the predefined formats, then the
+formats, then the user's guide should be sufficient; what is somewhat
-       user's guide should be sufficient; what is lacking is
+lacking is documentation on how to add to the library, i.e. a
-       documentation on how to add to the library. This will come. 
+developers' guide; stay tuned. 
 
 
  
+The architecture of the Fortran 2003 sparse BLAS is described in 
+S. Filippone, A. Buttari:
+Object-Oriented Techniques for Sparse Matrix Computations in Fortran
+2003, 
+ACM Trans. on Math. Software, 2012, to appear
+
 Version 1.0 of the library was described in:
 S. Filippone, M. Colajanni
 PSBLAS: A library for parallel linear algebra computation on sparse matrices
@@ -46,22 +42,24 @@ DOCUMENTATION
 
 See docs/psblas-3.0.pdf; an HTML version of the same document is
 available in docs/html. 
-Please consult the sample programs, especially test/pargen/ppde.f90. 
+Please consult the sample programs, especially 
+test/pargen/ppde[23]d.f90
+
 
 
 OTHER SOFTWARE CREDITS 
 
-We include our modified implementation of some of the Sparker (serial
+We originally included a modified implementation of some of the
-sparse BLAS)  material,  e.g. Jagged diagonal, plus a number of
+Sparker (serial sparse BLAS)  material; this has been completely
-extensions of our own design. The original file spblas.f can be
+rewritten, way beyond the intention(s) and responsibilities of the
-downloaded from matisa.cc.rl.ac.uk; of course any bugs in our
+original developers. 
-implementation are our own to fix.  The main reference for the serial
+The main reference for the serial sparse BLAS is: 
-sparse BLAS is: 
 Duff, I., Marrone, M., Radicati, G., and Vittoli, C.
 Level 3 basic linear algebra subprograms for sparse matrices: a user 
 level interface
 ACM Trans. Math. Softw., 23(3), 379-401, 1997.
 
+
 INSTALLING
 
 To compile and run our software you will need the following
@@ -76,7 +74,10 @@ prerequisites (see also SERIAL below):
 3. We have had good results with  the METIS library, from 
    http://www-users.cs.umn.edu/~karypis/metis/metis/main.html 
    This is optional; it is  used in the util and test/fileread
-   directories but only if you define the HAVE_METIS directive.
+   directories but only if you specify --with-metis.
+
+4. If you have the AMD package of Davis, Duff and Amestoy, you can
+   specify  --with-amd (see ./configure --help for more details). 
 
 The configure script will generate a Make.inc file suitable for
 building the library.  
@@ -105,6 +106,39 @@ If you specify --prefix=/path you can do make install and the
 libraries will be installed under /path/lib, while the module files
 will be installed under /path/include.
 
+SERIAL
+
+Configuring with --enable-serial will provide a fake MPI stub library
+that enables running in pure serial mode; no MPI installation is
+needed in this case (but note that the fake MPI stubs are only
+guaranteed to cover what we use internally, it's not a complete
+replacement). 
+
+EXPERIMENTAL
+
+We have an experimental flag --long-integers that will enable having
+8-byte integer data, allowing an index space larger than 2G; some
+small cases have been tested but it's a far cry from full reliance. 
+
+
+COMPILER NOTES.
+Notes: This code is confirmed to work with the following compilers (or
+later versions thereof): 
+       NAGware 5.2;
+       XLF 13.1;
+       GNU 4.6.1;  
+       Cray CCE 7.4.4/8.0.1;
+
+They are all recognized by the configure script. 
+
+To make the script work with the Cray CCE environment, it is
+recommended to use the following:
+./configure FC=ftn F77=ftn CC=cc
+with both Cray and GNU lower-level compilers. 
+
+The Intel compiler up to version 12.1 fails due to a bug in the
+handlind of generic interfaces. 
+
 
 KNOWN ISSUES.
 

docs/html/index.html

@@ -58,7 +58,7 @@ University of Rome ``Tor Vergata'', Italy
 <BR>
 Software version: 3.0-beta
 <BR>
-December 15th, 2011
+March 1, 2012.
 
          <BR><HR>
 <!--Table of Child-Links-->

docs/html/userhtml.html

@@ -58,7 +58,7 @@ University of Rome ``Tor Vergata'', Italy
 <BR>
 Software version: 3.0-beta
 <BR>
-December 15th, 2011
+March 1, 2012.
 
          <BR><HR>
 <!--Table of Child-Links-->

docs/src/userguide.tex

@@ -103,7 +103,7 @@
 by Salvatore Filippone\\
 and Alfredo Buttari}\\ 
 University of Rome ``Tor Vergata''.\\[3ex]
-December 15th, 2011.
+March 1, 2012
 \end{minipage}}
 
 %\addtolength{\textwidth}{\centeroffset}

docs/src/userhtml.tex

@@ -88,7 +88,7 @@
 %\today
 Software version: 3.0-beta\\
 %\today
-December 15th, 2011
+March 1, 2012.
 \cleardoublepage
 \begingroup
   \renewcommand*{\thepage}{toc}