psblas3:

Fixed docs and README.

docs/src/Makefile

@@ -138,7 +138,7 @@ PDF      = $(join $(BASEFILE),.pdf)
 PS       = $(join $(BASEFILE),.ps)
 GXS      = $(join $(BASEFILE),.gxs)
 GLX      = $(join $(BASEFILE),.glx)
-TARGETPDF= ../psblas-2.3.1.pdf
+TARGETPDF= ../psblas-3.0.pdf
 BASEHTML = $(patsubst %.tex,%,$(HTMLFILE))
 HTML     = $(join $(HTMLFILE),.html)
 HTMLDIR  = ../html

docs/src/penv.tex

@@ -6,7 +6,7 @@
 \addcontentsline{toc}{subsection}{psb\_init}
 
 \begin{verbatim}
-call psb_init(icontxt, np)
+call psb_init(icontxt, np, basectxt, ids)
 \end{verbatim}
 
 This subroutine initializes the PSBLAS parallel environment, defining
@@ -19,14 +19,31 @@ Scope: {\bf global}.\\
 Type: {\bf optional}.\\
 Intent: {\bf in}.\\
 Specified as: an integer value. \
-Default: use all available processes provided by the underlying
-parallel environment.
+Default: use all available processes.
+\item[basectxt] the initial communication context. The new context
+  will be defined from the processes participating in the initial one.\\
+  Scope: {\bf global}.\\
+Type: {\bf optional}.\\
+Intent: {\bf in}.\\
+Specified as: an integer value. \
+Default: use MPI\_COMM\_WORLD.
+\item[ids] Identities of the processes to use for the new context; the
+  argument is ignored when \verb|np| is not specified. This allows the
+  processes in the new environment to be in an order different from the
+  original one.\\
+  Scope: {\bf global}.\\
+Type: {\bf optional}.\\
+Intent: {\bf in}.\\
+Specified as: an integer array. \
+Default: use the indices $(0\dots np-1)$.  
 \end{description}
 
 \begin{description}
 \item[\bf On Return]
 \item[icontxt] the communication context identifying the virtual
-  parallel machine.\\
+  parallel machine. Note that this is always a duplicate of
+  \verb|basectxt|, so that library communications are completely
+  separated from other communication operations.\\
 Scope: {\bf global}.\\
 Type: {\bf required}.\\
 Intent: {\bf out}.\\
@@ -38,7 +55,7 @@ Specified as: an integer variable.
 \begin{enumerate}
 \item A call to this routine must precede any other PSBLAS call. 
 \item It is an error to specify a value for $np$ greater than the
-  number of processes available in the underlying parallel execution
+  number of processes available in the underlying base parallel
   environment. 
 \end{enumerate}
 

docs/src/userguide.tex

@@ -24,7 +24,7 @@
 \relax
 \pdfcompresslevel=0             %-- 0 = none, 9 = best
 \pdfinfo{                       %-- Info dictionary of PDF output  /Author (Alfredo Buttari)
-  /Title (Parallel Sparse BLAS V. 2.3.1)
+  /Title (Parallel Sparse BLAS V. 3.0-beta)
   /Subject (Parallel Sparse Basic Linear Algebra Subroutines)
   /Keywords (Computer Science Linear Algebra Fluid Dynamics Parallel Linux MPI PSBLAS Iterative Solvers Preconditioners)
   /Creator (pdfLaTeX)
@@ -77,7 +77,7 @@
 
 \begin{document}
 
-\pdfbookmark{PSBLAS-v2.3.1 User's Guide}{title}
+\pdfbookmark{PSBLAS-v3.0-beta User's Guide}{title}
 
 \newlength{\centeroffset}
 \setlength{\centeroffset}{-0.5\oddsidemargin}
@@ -87,7 +87,7 @@
 \vspace*{\stretch{1}}
 \noindent\hspace*{\centeroffset}\makebox[0pt][l]{\begin{minipage}{\textwidth}
 \flushright
-{\Huge\bfseries PSBLAS 2.3.1 User's guide
+{\Huge\bfseries PSBLAS 3.0-beta User's guide
 }
 \noindent\rule[-1ex]{\textwidth}{5pt}\\[2.5ex]
 \hfill\emph{\Large A reference guide for the Parallel Sparse BLAS library}
@@ -100,7 +100,7 @@
 by Salvatore Filippone\\
 and Alfredo Buttari}\\ 
 University of Rome ``Tor Vergata''.\\[3ex]
-September 30th, 2008.
+May 15th, 2010.
 \end{minipage}}
 
 %\addtolength{\textwidth}{\centeroffset}

docs/src/userhtml.tex

@@ -23,7 +23,7 @@
 % \relax
 % \pdfcompresslevel=0             %-- 0 = none, 9 = best
 % \pdfinfo{                       %-- Info dictionary of PDF output  /Author (Alfredo Buttari)
-%   /Title (Parallel Sparse BLAS V. 2.3.1)
+%   /Title (Parallel Sparse BLAS V. 3.0)
 %   /Subject (Parallel Sparse Basic Linear Algebra Subroutines)
 %   /Keywords (Computer Science Linear Algebra Fluid Dynamics Parallel Linux MPI PSBLAS Iterative Solvers Preconditioners)
 %   /Creator (pdfLaTeX)
@@ -83,9 +83,9 @@
  University of Rome ``Tor Vergata'', Italy\\[2ex]
 %\\[10ex]
 %\today
-Software version: 2.3.1\\
+Software version: 3.0-beta\\
 %\today
-September 30th, 2008
+May 15th, 2010
 \cleardoublepage
 \begingroup
   \renewcommand*{\thepage}{toc}