Added psb_sizeof to the docs. Changed README to mention gcc 4.2.0.

Changelog

@@ -1,7 +1,10 @@
 Changelog. A lot less detailed than usual, at least for past
 history. 
 
-2007/05/15: Merged in various fixes coming from tests on SP5 and HP-Itanium.
+2007/05/15: Defined psb_sizeof.
+
+2007/05/15: Merged in various fixes coming from tests on SP5 and
+	    HP-Itanium.	 
 
 2007/04/08: Changed the implementation of psb_sp_getrow & friends.  
 

README

@@ -16,18 +16,15 @@ other compiler/operating systems please let us know.
 
 LINUX:
 
-There finally exist a GNU Fortran 95 implementation: we are using the
+On Linux we work with the GCC compiler; note that we require version
-development snapshots from GCC 3.5.0, later 4.1 and 4.2  since July
+4.2.0 (or later) as it contains support for ALLOCATABLEs (as specified
-2004, and it appears  to work. The 4.2 version of GNU compilers is now
+in TR15581). 
-our reference platform; the official 4.2.0 release is due pretty
-soon. It now includes  support for ALLOCATABLES. 
-
 
 The Lahey version we got access to (6.0 and 6.1) seems to suffer from
 spurious extra copies problem; this is most apparent in the matrix
 build process.  
 
-For the Intel compilers, we recommend moving to version 9; previous
+For the Intel compilers, we recommend version 9.1; previous
 versions of the library have been compiled with version 7 and 8 of
 ifort. 
 
@@ -85,7 +82,7 @@ prerequisites (see also SERIAL below):
    This is not necessary to compile our library, but the test program
    in test/Fileread assumes you have it installed.  
 
-5. For our preconditioners we include interfaces to the following
+5. For the multilevel  preconditioners we include interfaces to the following
    software  packages:
    --  SuperLU 3.0        http://crd.lbl.gov/~xiaoye/SuperLU/
    --  UMFPACK 4.4        http://www.cise.ufl.edu/research/sparse/umfpack/ 
@@ -102,12 +99,13 @@ SERIAL: We now provide an (experimental) option to run in serial
 	mode. This has only been tested with GCC but it should work
 	with the others as well. In serial mode you don't need the
 	prereqs 1 and 2 above, and you need to use the -serialmpi
-	Make.inc. BEWARE: we only provide a minimal set of fake mpi
+	Make.inc. BEWARE: we only provide a VERY minimal set of fake mpi
 	routines that is known to work with our codes; specifically, we
-	do not handle a process doing send/receives to itself, and we
+	do not handle a process doing send/receives to itself, neither
-	don't handle user defined data types. 
+	do we handle user defined data types. 
 
 TODO:
+Fix all reamining bugs. Bugs? We dont' have any ! ;-)
 
 The PSBLAS team. 
 

docs/pdf/precs.tex

@@ -33,7 +33,7 @@ module  \verb|psb_prec_mod|.
 \item[prec] 
 Scope: {\bf local} \\
 Type: {\bf required}\\
-Specified as: a pronditioner data structure \precdata.
+Specified as: a preconditioner data structure \precdata.
 \item[ptype] the type of preconditioner. 
 Scope: {\bf global} \\
 Type: {\bf required}\\

docs/pdf/toolsrout.tex

@@ -1142,12 +1142,47 @@ An integer value; 0 means no error has been detected.
 \item When \verb|append=.true.|  the output arrays are reallocated as
   necessary;
 \item The row and column indices are returned in the local numbering
-  scheme; if the global numbering is desired, the user may emply the
+  scheme; if the global numbering is desired, the user may employ the
   \verb|psb_loc_to_glob| routine on the output.
 \end{enumerate}
 
 
 
+
+
+\subroutine{psb\_sizeof}{Memory occupation}
+
+This function computes the memory occupation of a PSBLAS object.
+
+
+\syntax{psb\_sizeof}{a}
+\syntax*{psb\_sizeof}{desc\_a}
+\syntax*{psb\_sizeof}{prec}
+
+\begin{description}
+\item[\bf On Entry]
+\item[a] A sparse matrix
+$A$. \\ 
+Scope: {\bf local} \\
+Type: {\bf required}\\
+Specified as: a structured data of type \spdata.
+\item[desc\_a] Communication descriptor.\\
+Scope: {\bf local} \\
+Type: {\bf required}\\
+Specified as: a structured data of type \descdata.
+\item[prec] 
+Scope: {\bf local} \\
+Type: {\bf required}\\
+Specified as: a preconditioner data structure \precdata.
+\item[\bf On Return] 
+\item[Function value] The memory occupation of the object specified in
+  the calling sequence, in bytes.\\
+Scope: {\bf local} \\
+Returned  as: an integer number.
+\end{description}
+
+
+
 %%% Local Variables: 
 %%% mode: latex
 %%% TeX-master: "userguide"