*** empty log message ***

docs/pdf/methods.tex

@@ -56,7 +56,8 @@ Scope: {\bf global} \\
 Type: {\bf optional}\\
 Default: $itmax = 1000$.\\
 Specified as: an integer variable $itmax \ge 1$.
-\item[itrace] If $>0$  print out a convergence message every $itrace$ iterations.\\
+\item[itrace] If $>0$  print out an informational message about
+  convergence  every $itrace$ iterations.\\ 
 Scope: {\bf global} \\
 Type: {\bf optional}\\
 \item[istop]  An integer specifying the stopping criterion.\\
@@ -132,7 +133,8 @@ Scope: {\bf global} \\
 Type: {\bf optional}\\
 Default: $itmax = 1000$.\\
 Specified as: an integer variable $itmax \ge 1$.
-\item[itrace]  If $>0$  print out a convergence message every $itrace$ iterations.\\
+\item[itrace]  If $>0$  print out an informational message about
+  convergence  every $itrace$ iterations.\\ 
 Scope: {\bf global} \\
 Type: {\bf optional}\\
 \item[istop]  An integer specifying the stopping criterion.\\
@@ -208,7 +210,8 @@ Scope: {\bf global} \\
 Type: {\bf optional}\\
 Default: $itmax = 1000$.\\
 Specified as: an integer variable $itmax \ge 1$.
-\item[itrace] If $>0$  print out a convergence message every $itrace$ iterations.\\
+\item[itrace] If $>0$  print out an informational message about
+  convergence  every $itrace$ iterations.\\ 
 Scope: {\bf global} \\
 Type: {\bf optional}\\
 \item[istop]  An integer specifying the stopping criterion.\\
@@ -285,7 +288,8 @@ Scope: {\bf global} \\
 Type: {\bf optional}\\
 Default: $itmax = 1000$.\\
 Specified as: an integer variable $itmax \ge 1$.
-\item[itrace]  If $>0$  print out a convergence message every $itrace$ iterations.\\
+\item[itrace]  If $>0$  print out an informational message about
+  convergence  every $itrace$ iterations.\\ 
 Scope: {\bf global} \\
 Type: {\bf optional}\\
 \item[istop]  An integer specifying the stopping criterion.\\
@@ -362,7 +366,8 @@ Scope: {\bf global} \\
 Type: {\bf optional}\\
 Default: $itmax = 1000$.\\
 Specified as: an integer variable $itmax \ge 1$.
-\item[itrace]  If $>0$  print out a convergence message every $itrace$ iterations.\\
+\item[itrace]  If $>0$  print out an informational message about
+  convergence  every $itrace$ iterations.\\ 
 Scope: {\bf global} \\
 Type: {\bf optional}\\
 \item[irst]  An integer specifying the restarting iteration.\\
@@ -442,7 +447,8 @@ Scope: {\bf global} \\
 Type: {\bf optional}\\
 Default: $itmax = 1000$.\\
 Specified as: an integer variable $itmax \ge 1$.
-\item[itrace]  If $>0$  print out a convergence message every $itrace$ iterations.\\
+\item[itrace]  If $>0$  print out an informational message about
+  convergence  every $itrace$ iterations.\\ 
 Scope: {\bf global} \\
 Type: {\bf optional}\\
 \item[irst]  An integer specifying the restart iteration.\\

docs/pdf/precs.tex

@@ -66,7 +66,7 @@ $ptype$ string as follows\footnote{The string is case-insensitive}:
   case the user may specify additional flags through the integer
   vector \verb|ir| as follows:
 \begin{description}
-\item[$iv(1)$] Number of overlap levels, an integer $novr>0$, default
+\item[$iv(1)$] Number of overlap levels, an integer $novr>=0$, default
   $novr=1$.  
 \item[$iv(2)$] Restriction operator, legal values: \verb|psb_halo_|,
   \verb|psb_none_|; default: \verb|psb_halo_|

docs/pdf/toolsrout.tex

@@ -104,7 +104,7 @@ Specified as: an integer array of length $nz$.
 
 \begin{description}
 \item[\bf On Return]
-\item[desc\_a] the communication descriptor to be freed.\\
+\item[desc\_a] the updated communication descriptor.\\
 Scope:{\bf local}.\\
 Type:{\bf required}.\\
 Specified as: a structured data of type \descdata.
@@ -283,10 +283,7 @@ Specified as: a structured data of type \descdata.
 \item[nnz] the number of nonzeroes in the local part of the assembled matrix.\\
 Scope: {\bf global}.\\
 Type: {\bf optional}.\\
-Specified as: an integer value. Note: a good estimate for the number
+Specified as: an integer value. 
-of nonzeroes in the assembled matrix may substantially improve
-performance in the matrix build phase, as it will reduce or eliminate
-the need for multiple data allocation.
 \end{description}
 
 \begin{description}
@@ -305,6 +302,10 @@ Specified as: an integer variable.
 \item On exit from this routine the sparse matrix  is in the build
   state.
 \item The descriptor may be in either the build or assembled state.
+\item Providing a good estimate for the number of nonzeroes $nnz$ in
+  the assembled matrix may substantially improve performance in the
+  matrix build phase, as it will reduce or eliminate the need for
+  multiple data allocations. 
 \end{enumerate}
 
 
@@ -370,7 +371,7 @@ Type: {\bf required}\\
 \item On entry to this routine the sparse matrix may be in either the
   build or update state. 
 \item If the descriptor is in the build state, then the sparse matrix
-  ought also be in the buld state; the action of the routine is to
+  ought also be in the build state; the action of the routine is to
   (implicitly) call \verb|psb_cdins| to add entries to the sparsity
   pattern;
 \item If the descriptor is in the assembled state, then any entries in