Update docs for remote build.

docs/html/index.html

@@ -21,7 +21,7 @@ class="cmbx-10">Salvatore Filippone</span><br
 class="newline" /><span 
 class="cmbx-10">Alfredo Buttari  </span><br 
 class="newline" />Software version: 3.7.0.1<br 
-class="newline" />May 11th, 2021
+class="newline" />Feb 14th, 2022
                                                                   
 
                                                                   

docs/html/userhtml.html

@@ -21,7 +21,7 @@ class="cmbx-10">Salvatore Filippone</span><br
 class="newline" /><span 
 class="cmbx-10">Alfredo Buttari  </span><br 
 class="newline" />Software version: 3.7.0.1<br 
-class="newline" />May 11th, 2021
+class="newline" />Feb 14th, 2022
                                                                   
 
                                                                   

docs/html/userhtmlsu36.html

@@ -22,7 +22,7 @@ href="userhtmlsu32.html#userhtmlsu39.html" >up</a>] </p></div>
 
                                                                   
    <pre class="verbatim" id="verbatim-40">
-call&#x00A0;psb_spall(a,&#x00A0;desc_a,&#x00A0;info,&#x00A0;nnz)
+call&#x00A0;psb_spall(a,&#x00A0;desc_a,&#x00A0;info,&#x00A0;nnz,&#x00A0;buildmode)
 </pre>
 <!--l. 551--><p class="nopar" >
 <!--l. 553--><p class="indent" >
@@ -61,8 +61,25 @@ class="newline" />Type: <span
 class="cmbx-10">optional</span>.<br 
 class="newline" />Intent: <span 
 class="cmbx-10">in</span>.<br 
-class="newline" />Specified as: an integer value.</dd></dl>
-<!--l. 569--><p class="indent" >
+class="newline" />Specified as: an integer value.
+     </dd><dt class="description">
+<span 
+class="cmbx-10">buildmode</span> </dt><dd 
+class="description">Whether to keep track of matrix entries that do not belong to the
+     current process.<br 
+class="newline" />Scope: <span 
+class="cmbx-10">global</span>.<br 
+class="newline" />Type: <span 
+class="cmbx-10">optional</span>.<br 
+class="newline" />Intent: <span 
+class="cmbx-10">in</span>.<br 
+class="newline" />Specified                                                                                 as:
+     an integer value <span class="obeylines-h"><span class="verb"><span 
+class="cmtt-10">psb_matbld_noremote_</span></span></span>, <span class="obeylines-h"><span class="verb"><span 
+class="cmtt-10">psb_matbld_remote_</span></span></span>. Default:
+     <span class="obeylines-h"><span class="verb"><span 
+class="cmtt-10">psb_matbld_noremote_</span></span></span>.</dd></dl>
+<!--l. 576--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -82,6 +99,9 @@ href="userhtmlsu6.html#spdata"><span
 class="cmtt-10">psb</span><span 
 class="cmtt-10">_Tspmat</span><span 
 class="cmtt-10">_type</span></a>.
+                                                                  
+
+                                                                  
      </dd><dt class="description">
 <span 
 class="cmbx-10">info</span> </dt><dd 
@@ -93,14 +113,11 @@ class="cmbx-10">required </span><br
 class="newline" />Intent: <span 
 class="cmbx-10">out</span>.<br 
 class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
-<!--l. 582--><p class="noindent" ><span 
+<!--l. 589--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 
   class="enumerate" id="x47-84002x1">On exit from this routine the sparse matrix is in the build state.
-                                                                  
-
-                                                                  
      </li>
      <li 
   class="enumerate" id="x47-84004x2">The descriptor may be in either the build or assembled state.
@@ -117,12 +134,12 @@ class="cmmi-10">nnz  </span>in  the
                                                                   
 
                                                                   
-   <!--l. 598--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 605--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu40.html" >next</a>] [<a 
 href="userhtmlsu35.html" >prev</a>] [<a 
 href="userhtmlsu35.html#tailuserhtmlsu35.html" >prev-tail</a>] [<a 
 href="userhtmlsu36.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu39.html" >up</a>] </p></div>
-<!--l. 598--><p class="indent" >   <a 
+<!--l. 605--><p class="indent" >   <a 
  id="tailuserhtmlsu36.html"></a>  
 </body></html> 

docs/html/userhtmlsu37.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 599--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 606--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu41.html" >next</a>] [<a 
 href="userhtmlsu36.html" >prev</a>] [<a 
 href="userhtmlsu36.html#tailuserhtmlsu36.html" >prev-tail</a>] [<a 
@@ -25,8 +25,8 @@ href="userhtmlsu32.html#userhtmlsu40.html" >up</a>] </p></div>
 call&#x00A0;psb_spins(nz,&#x00A0;ia,&#x00A0;ja,&#x00A0;val,&#x00A0;a,&#x00A0;desc_a,&#x00A0;info&#x00A0;[,local])
 call&#x00A0;psb_spins(nr,&#x00A0;irw,&#x00A0;irp,&#x00A0;ja,&#x00A0;val,&#x00A0;a,&#x00A0;desc_a,&#x00A0;info&#x00A0;[,local])
 </pre>
-<!--l. 604--><p class="nopar" >
-<!--l. 606--><p class="indent" >
+<!--l. 611--><p class="nopar" >
+<!--l. 613--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -152,7 +152,7 @@ class="cmbx-10">optional</span>.<br
 class="newline" />Specified as: a logical value; default: <span class="obeylines-h"><span class="verb"><span 
 class="cmtt-10">.false.</span></span></span>.
      </dd></dl>
-<!--l. 666--><p class="indent" >
+<!--l. 673--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -203,7 +203,7 @@ class="cmbx-10">required </span><br
 class="newline" />Intent: <span 
 class="cmbx-10">out</span>.<br 
 class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
-<!--l. 685--><p class="noindent" ><span 
+<!--l. 692--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 
@@ -300,12 +300,12 @@ class="cmsy-10">-</span>1 should be one of the local indices, but are otherwise
                                                                   
 
                                                                   
-   <!--l. 724--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 731--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu41.html" >next</a>] [<a 
 href="userhtmlsu36.html" >prev</a>] [<a 
 href="userhtmlsu36.html#tailuserhtmlsu36.html" >prev-tail</a>] [<a 
 href="userhtmlsu37.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu40.html" >up</a>] </p></div>
-<!--l. 724--><p class="indent" >   <a 
+<!--l. 731--><p class="indent" >   <a 
  id="tailuserhtmlsu37.html"></a>  
 </body></html> 

docs/html/userhtmlsu38.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 724--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 731--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu42.html" >next</a>] [<a 
 href="userhtmlsu37.html" >prev</a>] [<a 
 href="userhtmlsu37.html#tailuserhtmlsu37.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu41.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-42">
 call&#x00A0;psb_spasb(a,&#x00A0;desc_a,&#x00A0;info,&#x00A0;afmt,&#x00A0;upd,&#x00A0;dupl,&#x00A0;mold)
 </pre>
-<!--l. 728--><p class="nopar" >
-<!--l. 730--><p class="indent" >
+<!--l. 735--><p class="nopar" >
+<!--l. 737--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -44,7 +44,7 @@ class="cmbx-10">local</span>.<br
 class="newline" />Type:<span 
 class="cmbx-10">required</span>.<br 
 class="newline" />Intent: <span 
-class="cmbx-10">in</span>.<br 
+class="cmbx-10">in/out</span>.<br 
 class="newline" />Specified as: a structured data of type <a 
 href="userhtmlsu5.html#descdata"><span 
 class="cmtt-10">psb</span><span 
@@ -106,7 +106,7 @@ class="cmtt-10">_T</span><span
 class="cmtt-10">_base</span><span 
 class="cmtt-10">_sparse</span><span 
 class="cmtt-10">_mat</span>.</dd></dl>
-<!--l. 761--><p class="indent" >
+<!--l. 768--><p class="indent" >
                                                                   
 
                                                                   
@@ -140,7 +140,7 @@ class="cmbx-10">required </span><br
 class="newline" />Intent: <span 
 class="cmbx-10">out</span>.<br 
 class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
-<!--l. 775--><p class="noindent" ><span 
+<!--l. 782--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 
@@ -168,19 +168,28 @@ class="cmtt-10">psb_spins</span></span></span>
      </li>
      <li 
   class="enumerate" id="x49-86012x6">On exit from this routine the matrix is in the assembled state, and thus
-     is suitable for the computational routines.</li></ol>
+     is suitable for the computational routines;
+     </li>
+     <li 
+  class="enumerate" id="x49-86014x7">If the <span class="obeylines-h"><span class="verb"><span 
+class="cmtt-10">buildmode=psb_matbld_remote_</span></span></span> value was specified at allocation
+     time,  contributions  defined  on  the  current  process  but  belonging  to  a
+     remote process will be handled accordingly. This is most likely to occur
+     in finite element applications, with <span class="obeylines-h"><span class="verb"><span 
+class="cmtt-10">dupl=psb_dupl_add_</span></span></span>; note that the
+     descriptor will be updated, and there will be a runtime overhead.</li></ol>
                                                                   
 
                                                                   
                                                                   
 
                                                                   
-   <!--l. 832--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 845--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu42.html" >next</a>] [<a 
 href="userhtmlsu37.html" >prev</a>] [<a 
 href="userhtmlsu37.html#tailuserhtmlsu37.html" >prev-tail</a>] [<a 
 href="userhtmlsu38.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu41.html" >up</a>] </p></div>
-<!--l. 832--><p class="indent" >   <a 
+<!--l. 845--><p class="indent" >   <a 
  id="tailuserhtmlsu38.html"></a>  
 </body></html> 

docs/html/userhtmlsu39.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 832--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 845--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu43.html" >next</a>] [<a 
 href="userhtmlsu38.html" >prev</a>] [<a 
 href="userhtmlsu38.html#tailuserhtmlsu38.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu42.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-43">
 call&#x00A0;psb_spfree(a,&#x00A0;desc_a,&#x00A0;info)
 </pre>
-<!--l. 836--><p class="nopar" >
-<!--l. 838--><p class="indent" >
+<!--l. 849--><p class="nopar" >
+<!--l. 851--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -65,7 +65,7 @@ href="userhtmlsu5.html#descdata"><span
 class="cmtt-10">psb</span><span 
 class="cmtt-10">_desc</span><span 
 class="cmtt-10">_type</span></a>.</dd></dl>
-<!--l. 853--><p class="indent" >
+<!--l. 866--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -87,12 +87,12 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
                                                                   
 
                                                                   
-   <!--l. 868--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 881--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu43.html" >next</a>] [<a 
 href="userhtmlsu38.html" >prev</a>] [<a 
 href="userhtmlsu38.html#tailuserhtmlsu38.html" >prev-tail</a>] [<a 
 href="userhtmlsu39.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu42.html" >up</a>] </p></div>
-<!--l. 868--><p class="indent" >   <a 
+<!--l. 881--><p class="indent" >   <a 
  id="tailuserhtmlsu39.html"></a>  
 </body></html> 

docs/html/userhtmlsu40.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 869--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 882--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu44.html" >next</a>] [<a 
 href="userhtmlsu39.html" >prev</a>] [<a 
 href="userhtmlsu39.html#tailuserhtmlsu39.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu43.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-44">
 call&#x00A0;psb_sprn(a,&#x00A0;decsc_a,&#x00A0;info,&#x00A0;clear)
 </pre>
-<!--l. 873--><p class="nopar" >
-<!--l. 875--><p class="indent" >
+<!--l. 886--><p class="nopar" >
+<!--l. 888--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -76,7 +76,7 @@ class="cmbx-10">optional</span>.<br
 class="newline" />Intent: <span 
 class="cmbx-10">in</span>.<br 
 class="newline" />Default: true.</dd></dl>
-<!--l. 895--><p class="indent" >
+<!--l. 908--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -92,7 +92,7 @@ class="cmbx-10">required </span><br
 class="newline" />Intent: <span 
 class="cmbx-10">out</span>.<br 
 class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
-<!--l. 903--><p class="noindent" ><span 
+<!--l. 916--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 
@@ -103,12 +103,12 @@ class="cmbx-12">Notes</span>
                                                                   
 
                                                                   
-   <!--l. 956--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 969--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu44.html" >next</a>] [<a 
 href="userhtmlsu39.html" >prev</a>] [<a 
 href="userhtmlsu39.html#tailuserhtmlsu39.html" >prev-tail</a>] [<a 
 href="userhtmlsu40.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu43.html" >up</a>] </p></div>
-<!--l. 956--><p class="indent" >   <a 
+<!--l. 969--><p class="indent" >   <a 
  id="tailuserhtmlsu40.html"></a>  
 </body></html> 

docs/html/userhtmlsu41.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 956--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 969--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu45.html" >next</a>] [<a 
 href="userhtmlsu40.html" >prev</a>] [<a 
 href="userhtmlsu40.html#tailuserhtmlsu40.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu44.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-45">
 call&#x00A0;psb_geall(x,&#x00A0;desc_a,&#x00A0;info,&#x00A0;n,&#x00A0;lb)
 </pre>
-<!--l. 961--><p class="nopar" >
-<!--l. 963--><p class="indent" >
+<!--l. 974--><p class="nopar" >
+<!--l. 976--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -78,7 +78,7 @@ class="cmbx-10">in</span>.<br
 class="newline" />Specified as: Integer scalar, default 1. It is not a valid argument if <span 
 class="cmmi-10">x </span>is a
      rank-1 array.</dd></dl>
-<!--l. 985--><p class="indent" >
+<!--l. 998--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -121,12 +121,12 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
                                                                   
 
                                                                   
-   <!--l. 1004--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1017--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu45.html" >next</a>] [<a 
 href="userhtmlsu40.html" >prev</a>] [<a 
 href="userhtmlsu40.html#tailuserhtmlsu40.html" >prev-tail</a>] [<a 
 href="userhtmlsu41.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu44.html" >up</a>] </p></div>
-<!--l. 1004--><p class="indent" >   <a 
+<!--l. 1017--><p class="indent" >   <a 
  id="tailuserhtmlsu41.html"></a>  
 </body></html> 

docs/html/userhtmlsu42.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1004--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1017--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu46.html" >next</a>] [<a 
 href="userhtmlsu41.html" >prev</a>] [<a 
 href="userhtmlsu41.html#tailuserhtmlsu41.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu45.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-46">
 call&#x00A0;psb_geins(m,&#x00A0;irw,&#x00A0;val,&#x00A0;x,&#x00A0;desc_a,&#x00A0;info&#x00A0;[,dupl,local])
 </pre>
-<!--l. 1009--><p class="nopar" >
-<!--l. 1011--><p class="indent" >
+<!--l. 1022--><p class="nopar" >
+<!--l. 1024--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -118,7 +118,7 @@ class="cmbx-10">optional</span>.<br
 class="newline" />Specified as: a logical value; default: <span class="obeylines-h"><span class="verb"><span 
 class="cmtt-10">.false.</span></span></span>.
      </dd></dl>
-<!--l. 1051--><p class="indent" >
+<!--l. 1064--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -152,7 +152,7 @@ class="cmbx-10">required </span><br
 class="newline" />Intent: <span 
 class="cmbx-10">out</span>.<br 
 class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
-<!--l. 1066--><p class="noindent" ><span 
+<!--l. 1079--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 
@@ -167,12 +167,12 @@ class="cmbx-12">Notes</span>
                                                                   
 
                                                                   
-   <!--l. 1077--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1090--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu46.html" >next</a>] [<a 
 href="userhtmlsu41.html" >prev</a>] [<a 
 href="userhtmlsu41.html#tailuserhtmlsu41.html" >prev-tail</a>] [<a 
 href="userhtmlsu42.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu45.html" >up</a>] </p></div>
-<!--l. 1077--><p class="indent" >   <a 
+<!--l. 1090--><p class="indent" >   <a 
  id="tailuserhtmlsu42.html"></a>  
 </body></html> 

docs/html/userhtmlsu43.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1077--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1090--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu47.html" >next</a>] [<a 
 href="userhtmlsu42.html" >prev</a>] [<a 
 href="userhtmlsu42.html#tailuserhtmlsu42.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu46.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-47">
 call&#x00A0;psb_geasb(x,&#x00A0;desc_a,&#x00A0;info,&#x00A0;mold)
 </pre>
-<!--l. 1082--><p class="nopar" >
-<!--l. 1084--><p class="indent" >
+<!--l. 1095--><p class="nopar" >
+<!--l. 1097--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -75,7 +75,7 @@ class="cmtt-10">psb</span><span
 class="cmtt-10">_T</span><span 
 class="cmtt-10">_vect</span><span 
 class="cmtt-10">_type</span></a>.</dd></dl>
-<!--l. 1100--><p class="indent" >
+<!--l. 1113--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -112,12 +112,12 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
                                                                   
 
                                                                   
-<!--l. 1117--><div class="crosslinks"><p class="noindent">[<a 
+<!--l. 1130--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu47.html" >next</a>] [<a 
 href="userhtmlsu42.html" >prev</a>] [<a 
 href="userhtmlsu42.html#tailuserhtmlsu42.html" >prev-tail</a>] [<a 
 href="userhtmlsu43.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu46.html" >up</a>] </p></div>
-<!--l. 1117--><p class="indent" >   <a 
+<!--l. 1130--><p class="indent" >   <a 
  id="tailuserhtmlsu43.html"></a>  
 </body></html> 

docs/html/userhtmlsu44.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1117--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1130--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu48.html" >next</a>] [<a 
 href="userhtmlsu43.html" >prev</a>] [<a 
 href="userhtmlsu43.html#tailuserhtmlsu43.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu47.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-48">
 call&#x00A0;psb_gefree(x,&#x00A0;desc_a,&#x00A0;info)
 </pre>
-<!--l. 1122--><p class="nopar" >
-<!--l. 1124--><p class="indent" >
+<!--l. 1135--><p class="nopar" >
+<!--l. 1137--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -69,7 +69,7 @@ class="cmtt-10">psb</span><span
 class="cmtt-10">_desc</span><span 
 class="cmtt-10">_type</span></a>.<br 
 class="newline" /></dd></dl>
-<!--l. 1142--><p class="indent" >
+<!--l. 1155--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -91,12 +91,12 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
                                                                   
 
                                                                   
-   <!--l. 1155--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1168--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu48.html" >next</a>] [<a 
 href="userhtmlsu43.html" >prev</a>] [<a 
 href="userhtmlsu43.html#tailuserhtmlsu43.html" >prev-tail</a>] [<a 
 href="userhtmlsu44.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu47.html" >up</a>] </p></div>
-<!--l. 1155--><p class="indent" >   <a 
+<!--l. 1168--><p class="indent" >   <a 
  id="tailuserhtmlsu44.html"></a>  
 </body></html> 

docs/html/userhtmlsu45.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1156--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1169--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu49.html" >next</a>] [<a 
 href="userhtmlsu44.html" >prev</a>] [<a 
 href="userhtmlsu44.html#tailuserhtmlsu44.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu48.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-49">
 call&#x00A0;psb_gelp(trans,&#x00A0;iperm,&#x00A0;x,&#x00A0;info)
 </pre>
-<!--l. 1161--><p class="nopar" >
-<!--l. 1163--><p class="indent" >
+<!--l. 1174--><p class="nopar" >
+<!--l. 1176--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -76,7 +76,7 @@ class="newline" />Intent: <span
 class="cmbx-10">inout</span>.<br 
 class="newline" />Specified as: a one or two dimensional array.<br 
 class="newline" /></dd></dl>
-<!--l. 1183--><p class="indent" >
+<!--l. 1196--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -98,12 +98,12 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
                                                                   
 
                                                                   
-   <!--l. 1196--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1209--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu49.html" >next</a>] [<a 
 href="userhtmlsu44.html" >prev</a>] [<a 
 href="userhtmlsu44.html#tailuserhtmlsu44.html" >prev-tail</a>] [<a 
 href="userhtmlsu45.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu48.html" >up</a>] </p></div>
-<!--l. 1196--><p class="indent" >   <a 
+<!--l. 1209--><p class="indent" >   <a 
  id="tailuserhtmlsu45.html"></a>  
 </body></html> 

docs/html/userhtmlsu46.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1197--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1210--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu50.html" >next</a>] [<a 
 href="userhtmlsu45.html" >prev</a>] [<a 
 href="userhtmlsu45.html#tailuserhtmlsu45.html" >prev-tail</a>] [<a 
@@ -25,8 +25,8 @@ href="userhtmlsu32.html#userhtmlsu49.html" >up</a>] </p></div>
 call&#x00A0;psb_glob_to_loc(x,&#x00A0;y,&#x00A0;desc_a,&#x00A0;info,&#x00A0;iact,owned)
 call&#x00A0;psb_glob_to_loc(x,&#x00A0;desc_a,&#x00A0;info,&#x00A0;iact,owned)
 </pre>
-<!--l. 1203--><p class="nopar" >
-<!--l. 1205--><p class="indent" >
+<!--l. 1216--><p class="nopar" >
+<!--l. 1218--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -88,7 +88,7 @@ class="newline" />Intent: <span
 class="cmbx-10">in</span>.<br 
 class="newline" />If  true,  then  only  indices  strictly  owned  by  the  current  process  are
      considered valid, if false then halo indices are also accepted. Default: false.</dd></dl>
-<!--l. 1233--><p class="indent" >
+<!--l. 1246--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -134,7 +134,7 @@ class="cmbx-10">required </span><br
 class="newline" />Intent: <span 
 class="cmbx-10">out</span>.<br 
 class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
-<!--l. 1255--><p class="noindent" ><span 
+<!--l. 1268--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 
@@ -151,12 +151,12 @@ class="cmtt-10">I</span></span></span>gnore means that the negative output is th
                                                                   
 
                                                                   
-   <!--l. 1264--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1277--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu50.html" >next</a>] [<a 
 href="userhtmlsu45.html" >prev</a>] [<a 
 href="userhtmlsu45.html#tailuserhtmlsu45.html" >prev-tail</a>] [<a 
 href="userhtmlsu46.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu49.html" >up</a>] </p></div>
-<!--l. 1264--><p class="indent" >   <a 
+<!--l. 1277--><p class="indent" >   <a 
  id="tailuserhtmlsu46.html"></a>  
 </body></html> 

docs/html/userhtmlsu47.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1265--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1278--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu51.html" >next</a>] [<a 
 href="userhtmlsu46.html" >prev</a>] [<a 
 href="userhtmlsu46.html#tailuserhtmlsu46.html" >prev-tail</a>] [<a 
@@ -25,8 +25,8 @@ href="userhtmlsu32.html#userhtmlsu50.html" >up</a>] </p></div>
 call&#x00A0;psb_loc_to_glob(x,&#x00A0;y,&#x00A0;desc_a,&#x00A0;info,&#x00A0;iact)
 call&#x00A0;psb_loc_to_glob(x,&#x00A0;desc_a,&#x00A0;info,&#x00A0;iact)
 </pre>
-<!--l. 1271--><p class="nopar" >
-<!--l. 1273--><p class="indent" >
+<!--l. 1284--><p class="nopar" >
+<!--l. 1286--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -77,7 +77,7 @@ class="cmtt-10">I</span></span></span>gnore, <span class="obeylines-h"><span cla
 class="cmtt-10">W</span></span></span>arning or <span class="obeylines-h"><span class="verb"><span 
 class="cmtt-10">A</span></span></span>bort, default <span class="obeylines-h"><span class="verb"><span 
 class="cmtt-10">I</span></span></span>gnore.</dd></dl>
-<!--l. 1294--><p class="indent" >
+<!--l. 1307--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -129,12 +129,12 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
                                                                   
 
                                                                   
-   <!--l. 1321--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1334--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu51.html" >next</a>] [<a 
 href="userhtmlsu46.html" >prev</a>] [<a 
 href="userhtmlsu46.html#tailuserhtmlsu46.html" >prev-tail</a>] [<a 
 href="userhtmlsu47.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu50.html" >up</a>] </p></div>
-<!--l. 1321--><p class="indent" >   <a 
+<!--l. 1334--><p class="indent" >   <a 
  id="tailuserhtmlsu47.html"></a>  
 </body></html> 

docs/html/userhtmlsu48.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1321--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1334--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu52.html" >next</a>] [<a 
 href="userhtmlsu47.html" >prev</a>] [<a 
 href="userhtmlsu47.html#tailuserhtmlsu47.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu51.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-52">
 call&#x00A0;psb_is_owned(x,&#x00A0;desc_a)
 </pre>
-<!--l. 1326--><p class="nopar" >
-<!--l. 1328--><p class="indent" >
+<!--l. 1339--><p class="nopar" >
+<!--l. 1341--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -62,7 +62,7 @@ href="userhtmlsu5.html#descdata"><span
 class="cmtt-10">psb</span><span 
 class="cmtt-10">_desc</span><span 
 class="cmtt-10">_type</span></a>.</dd></dl>
-<!--l. 1343--><p class="indent" >
+<!--l. 1356--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -79,7 +79,7 @@ class="cmbx-10">required</span><br
 class="newline" />Intent: <span 
 class="cmbx-10">out</span>.<br 
 class="newline" /></dd></dl>
-<!--l. 1353--><p class="noindent" ><span 
+<!--l. 1366--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 
@@ -92,12 +92,12 @@ class="cmtt-10">.true.</span></span></span> value for an index that is strictly
                                                                   
 
                                                                   
-   <!--l. 1361--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1374--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu52.html" >next</a>] [<a 
 href="userhtmlsu47.html" >prev</a>] [<a 
 href="userhtmlsu47.html#tailuserhtmlsu47.html" >prev-tail</a>] [<a 
 href="userhtmlsu48.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu51.html" >up</a>] </p></div>
-<!--l. 1361--><p class="indent" >   <a 
+<!--l. 1374--><p class="indent" >   <a 
  id="tailuserhtmlsu48.html"></a>  
 </body></html> 

docs/html/userhtmlsu49.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1361--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1374--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu53.html" >next</a>] [<a 
 href="userhtmlsu48.html" >prev</a>] [<a 
 href="userhtmlsu48.html#tailuserhtmlsu48.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu52.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-53">
 call&#x00A0;psb_owned_index(y,&#x00A0;x,&#x00A0;desc_a,&#x00A0;info)
 </pre>
-<!--l. 1366--><p class="nopar" >
-<!--l. 1368--><p class="indent" >
+<!--l. 1379--><p class="nopar" >
+<!--l. 1381--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -76,7 +76,7 @@ class="cmtt-10">I</span></span></span>gnore, <span class="obeylines-h"><span cla
 class="cmtt-10">W</span></span></span>arning or <span class="obeylines-h"><span class="verb"><span 
 class="cmtt-10">A</span></span></span>bort, default <span class="obeylines-h"><span class="verb"><span 
 class="cmtt-10">I</span></span></span>gnore.</dd></dl>
-<!--l. 1389--><p class="indent" >
+<!--l. 1402--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -107,7 +107,7 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
                                                                   
 
                                                                   
-<!--l. 1405--><p class="noindent" ><span 
+<!--l. 1418--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 
@@ -120,12 +120,12 @@ class="cmtt-10">.true.</span></span></span> value for those indices that are str
                                                                   
 
                                                                   
-   <!--l. 1413--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1426--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu53.html" >next</a>] [<a 
 href="userhtmlsu48.html" >prev</a>] [<a 
 href="userhtmlsu48.html#tailuserhtmlsu48.html" >prev-tail</a>] [<a 
 href="userhtmlsu49.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu52.html" >up</a>] </p></div>
-<!--l. 1413--><p class="indent" >   <a 
+<!--l. 1426--><p class="indent" >   <a 
  id="tailuserhtmlsu49.html"></a>  
 </body></html> 

docs/html/userhtmlsu50.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1413--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1426--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu54.html" >next</a>] [<a 
 href="userhtmlsu49.html" >prev</a>] [<a 
 href="userhtmlsu49.html#tailuserhtmlsu49.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu53.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-54">
 call&#x00A0;psb_is_local(x,&#x00A0;desc_a)
 </pre>
-<!--l. 1418--><p class="nopar" >
-<!--l. 1420--><p class="indent" >
+<!--l. 1431--><p class="nopar" >
+<!--l. 1433--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -62,7 +62,7 @@ href="userhtmlsu5.html#descdata"><span
 class="cmtt-10">psb</span><span 
 class="cmtt-10">_desc</span><span 
 class="cmtt-10">_type</span></a>.</dd></dl>
-<!--l. 1435--><p class="indent" >
+<!--l. 1448--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -79,7 +79,7 @@ class="cmbx-10">required</span><br
 class="newline" />Intent: <span 
 class="cmbx-10">out</span>.<br 
 class="newline" /></dd></dl>
-<!--l. 1445--><p class="noindent" ><span 
+<!--l. 1458--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 
@@ -92,12 +92,12 @@ class="cmtt-10">.true.</span></span></span> value for an index that is local to
                                                                   
 
                                                                   
-   <!--l. 1452--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1465--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu54.html" >next</a>] [<a 
 href="userhtmlsu49.html" >prev</a>] [<a 
 href="userhtmlsu49.html#tailuserhtmlsu49.html" >prev-tail</a>] [<a 
 href="userhtmlsu50.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu53.html" >up</a>] </p></div>
-<!--l. 1452--><p class="indent" >   <a 
+<!--l. 1465--><p class="indent" >   <a 
  id="tailuserhtmlsu50.html"></a>  
 </body></html> 

docs/html/userhtmlsu51.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1452--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1465--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu55.html" >next</a>] [<a 
 href="userhtmlsu50.html" >prev</a>] [<a 
 href="userhtmlsu50.html#tailuserhtmlsu50.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu54.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-55">
 call&#x00A0;psb_local_index(y,&#x00A0;x,&#x00A0;desc_a,&#x00A0;info)
 </pre>
-<!--l. 1457--><p class="nopar" >
-<!--l. 1459--><p class="indent" >
+<!--l. 1470--><p class="nopar" >
+<!--l. 1472--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -76,7 +76,7 @@ class="cmtt-10">I</span></span></span>gnore, <span class="obeylines-h"><span cla
 class="cmtt-10">W</span></span></span>arning or <span class="obeylines-h"><span class="verb"><span 
 class="cmtt-10">A</span></span></span>bort, default <span class="obeylines-h"><span class="verb"><span 
 class="cmtt-10">I</span></span></span>gnore.</dd></dl>
-<!--l. 1480--><p class="indent" >
+<!--l. 1493--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -107,7 +107,7 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
                                                                   
 
                                                                   
-<!--l. 1496--><p class="noindent" ><span 
+<!--l. 1509--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 
@@ -120,12 +120,12 @@ class="cmtt-10">.true.</span></span></span> value for those indices that are loc
                                                                   
 
                                                                   
-   <!--l. 1508--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1521--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu55.html" >next</a>] [<a 
 href="userhtmlsu50.html" >prev</a>] [<a 
 href="userhtmlsu50.html#tailuserhtmlsu50.html" >prev-tail</a>] [<a 
 href="userhtmlsu51.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu54.html" >up</a>] </p></div>
-<!--l. 1508--><p class="indent" >   <a 
+<!--l. 1521--><p class="indent" >   <a 
  id="tailuserhtmlsu51.html"></a>  
 </body></html> 

docs/html/userhtmlsu52.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1509--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1522--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu56.html" >next</a>] [<a 
 href="userhtmlsu51.html" >prev</a>] [<a 
 href="userhtmlsu51.html#tailuserhtmlsu51.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu55.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-56">
 call&#x00A0;psb_get_boundary(bndel,&#x00A0;desc,&#x00A0;info)
 </pre>
-<!--l. 1514--><p class="nopar" >
-<!--l. 1516--><p class="indent" >
+<!--l. 1527--><p class="nopar" >
+<!--l. 1529--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -49,7 +49,7 @@ href="userhtmlsu5.html#descdata"><span
 class="cmtt-10">psb</span><span 
 class="cmtt-10">_desc</span><span 
 class="cmtt-10">_type</span></a>.</dd></dl>
-<!--l. 1526--><p class="indent" >
+<!--l. 1539--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -78,7 +78,7 @@ class="cmbx-10">required </span><br
 class="newline" />Intent: <span 
 class="cmbx-10">out</span>.<br 
 class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
-<!--l. 1542--><p class="noindent" ><span 
+<!--l. 1555--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 
@@ -96,12 +96,12 @@ class="cmtt-10">bndel</span></span></span> will  be  exactly  equal  to  the  nu
                                                                   
 
                                                                   
-   <!--l. 1551--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1564--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu56.html" >next</a>] [<a 
 href="userhtmlsu51.html" >prev</a>] [<a 
 href="userhtmlsu51.html#tailuserhtmlsu51.html" >prev-tail</a>] [<a 
 href="userhtmlsu52.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu55.html" >up</a>] </p></div>
-<!--l. 1551--><p class="indent" >   <a 
+<!--l. 1564--><p class="indent" >   <a 
  id="tailuserhtmlsu52.html"></a>  
 </body></html> 

docs/html/userhtmlsu53.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1552--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1565--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlse7.html" >next</a>] [<a 
 href="userhtmlsu52.html" >prev</a>] [<a 
 href="userhtmlsu52.html#tailuserhtmlsu52.html" >prev-tail</a>] [<a 
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu56.html" >up</a>] </p></div>
    <pre class="verbatim" id="verbatim-57">
 call&#x00A0;psb_get_overlap(ovrel,&#x00A0;desc,&#x00A0;info)
 </pre>
-<!--l. 1557--><p class="nopar" >
-<!--l. 1559--><p class="indent" >
+<!--l. 1570--><p class="nopar" >
+<!--l. 1572--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -49,7 +49,7 @@ href="userhtmlsu5.html#descdata"><span
 class="cmtt-10">psb</span><span 
 class="cmtt-10">_desc</span><span 
 class="cmtt-10">_type</span></a>.</dd></dl>
-<!--l. 1569--><p class="indent" >
+<!--l. 1582--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -78,7 +78,7 @@ class="cmbx-10">required </span><br
 class="newline" />Intent: <span 
 class="cmbx-10">out</span>.<br 
 class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
-<!--l. 1585--><p class="noindent" ><span 
+<!--l. 1598--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 
@@ -95,12 +95,12 @@ class="cmtt-10">ovrel</span></span></span> will be exactly equal to the number o
                                                                   
 
                                                                   
-   <!--l. 1595--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1608--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlse7.html" >next</a>] [<a 
 href="userhtmlsu52.html" >prev</a>] [<a 
 href="userhtmlsu52.html#tailuserhtmlsu52.html" >prev-tail</a>] [<a 
 href="userhtmlsu53.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu56.html" >up</a>] </p></div>
-<!--l. 1595--><p class="indent" >   <a 
+<!--l. 1608--><p class="indent" >   <a 
  id="tailuserhtmlsu53.html"></a>  
 </body></html> 

docs/html/userhtmlsu54.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1596--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1609--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu57.html" >next</a>] [<a 
 href="userhtmlsu53.html" >prev</a>] [<a 
 href="userhtmlsu53.html#tailuserhtmlsu53.html" >prev-tail</a>] [<a 
@@ -25,8 +25,8 @@ href="userhtmlsu32.html#userhtmlse7.html" >up</a>] </p></div>
 call&#x00A0;psb_sp_getrow(row,&#x00A0;a,&#x00A0;nz,&#x00A0;ia,&#x00A0;ja,&#x00A0;val,&#x00A0;info,&#x00A0;&amp;
 &#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&amp;&#x00A0;append,&#x00A0;nzin,&#x00A0;lrw)
 </pre>
-<!--l. 1602--><p class="nopar" >
-<!--l. 1604--><p class="indent" >
+<!--l. 1615--><p class="nopar" >
+<!--l. 1617--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -103,7 +103,7 @@ class="cmmi-10">row</span>.
                                                                   
 
                                                                   
-<!--l. 1644--><p class="indent" >
+<!--l. 1657--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -166,7 +166,7 @@ class="cmbx-10">required </span><br
 class="newline" />Intent: <span 
 class="cmbx-10">out</span>.<br 
 class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
-<!--l. 1673--><p class="noindent" ><span 
+<!--l. 1686--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 
@@ -198,12 +198,12 @@ class="cmtt-10">psb_loc_to_glob</span></span></span> routine on the output.</li>
                                                                   
 
                                                                   
-   <!--l. 1689--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1702--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu57.html" >next</a>] [<a 
 href="userhtmlsu53.html" >prev</a>] [<a 
 href="userhtmlsu53.html#tailuserhtmlsu53.html" >prev-tail</a>] [<a 
 href="userhtmlsu54.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlse7.html" >up</a>] </p></div>
-<!--l. 1689--><p class="indent" >   <a 
+<!--l. 1702--><p class="indent" >   <a 
  id="tailuserhtmlsu54.html"></a>  
 </body></html> 

docs/html/userhtmlsu55.html

@@ -10,7 +10,7 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1689--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1702--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu58.html" >next</a>] [<a 
 href="userhtmlsu54.html" >prev</a>] [<a 
 href="userhtmlsu54.html#tailuserhtmlsu54.html" >prev-tail</a>] [<a 
@@ -18,7 +18,7 @@ href="userhtmlsu52.html#tailuserhtmlsu55.html">tail</a>] [<a
 href="userhtmlsu32.html#userhtmlsu57.html" >up</a>] </p></div>
    <h4 class="subsectionHead"><span class="titlemark">6.26   </span> <a 
  id="x66-1030006.26"></a>psb_sizeof &#8212; Memory occupation</h4>
-<!--l. 1692--><p class="noindent" >This function computes the memory occupation of a PSBLAS object.
+<!--l. 1705--><p class="noindent" >This function computes the memory occupation of a PSBLAS object.
                                                                   
 
                                                                   
@@ -27,8 +27,8 @@ isz&#x00A0;=&#x00A0;psb_sizeof(a)
 isz&#x00A0;=&#x00A0;psb_sizeof(desc_a)
 isz&#x00A0;=&#x00A0;psb_sizeof(prec)
 </pre>
-<!--l. 1699--><p class="nopar" >
-<!--l. 1701--><p class="indent" >
+<!--l. 1712--><p class="nopar" >
+<!--l. 1714--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">Type:</span> </dt><dd 
@@ -102,12 +102,12 @@ class="cmtt-10">integer(psb_long_int_k_)</span></span></span> number.</dd></dl>
                                                                   
 
                                                                   
-   <!--l. 1728--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1741--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu58.html" >next</a>] [<a 
 href="userhtmlsu54.html" >prev</a>] [<a 
 href="userhtmlsu54.html#tailuserhtmlsu54.html" >prev-tail</a>] [<a 
 href="userhtmlsu55.html" >front</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu57.html" >up</a>] </p></div>
-<!--l. 1728--><p class="indent" >   <a 
+<!--l. 1741--><p class="indent" >   <a 
  id="tailuserhtmlsu55.html"></a>  
 </body></html> 

docs/html/userhtmlsu56.html

@@ -10,20 +10,20 @@
 <link rel="stylesheet" type="text/css" href="userhtml.css"> 
 </head><body 
 >
-   <!--l. 1728--><div class="crosslinks"><p class="noindent">[<a 
+   <!--l. 1741--><div class="crosslinks"><p class="noindent">[<a 
 href="userhtmlsu55.html" >prev</a>] [<a 
 href="userhtmlsu55.html#tailuserhtmlsu55.html" >prev-tail</a>] [<a 
 href="userhtmlsu53.html#tailuserhtmlsu56.html">tail</a>] [<a 
 href="userhtmlsu32.html#userhtmlsu58.html" >up</a>] </p></div>
    <h4 class="subsectionHead"><span class="titlemark">6.27   </span> <a 
  id="x67-1040006.27"></a>Sorting utilities &#8212; </h4>
-<!--l. 1731--><p class="noindent" ><span 
+<!--l. 1744--><p class="noindent" ><span 
 class="cmbx-12">psb</span><span 
 class="cmbx-12">_msort &#8212; Sorting by the Merge-sort algorithm</span>
-<!--l. 1734--><p class="noindent" ><span 
+<!--l. 1747--><p class="noindent" ><span 
 class="cmbx-12">psb</span><span 
 class="cmbx-12">_qsort &#8212; Sorting by the Quicksort algorithm</span>
-<!--l. 1737--><p class="noindent" ><span 
+<!--l. 1750--><p class="noindent" ><span 
 class="cmbx-12">psb</span><span 
 class="cmbx-12">_hsort &#8212; Sorting by the Heapsort algorithm</span>
                                                                   
@@ -34,8 +34,8 @@ call&#x00A0;psb_msort(x,ix,dir,flag)
 call&#x00A0;psb_qsort(x,ix,dir,flag)
 call&#x00A0;psb_hsort(x,ix,dir,flag)
 </pre>
-<!--l. 1742--><p class="nopar" >
-<!--l. 1744--><p class="indent" >   These serial routines sort a sequence <span 
+<!--l. 1755--><p class="nopar" >
+<!--l. 1757--><p class="indent" >   These serial routines sort a sequence <span 
 class="cmmi-10">X </span>into ascending or descending order. The
 argument meaning is identical for the three calls; the only difference is the algorithm
 used to accomplish the task (see Usage Notes below).
@@ -102,7 +102,7 @@ class="cmtt-10">psb_sort_keep_idx_</span></span></span>;
      default <span class="obeylines-h"><span class="verb"><span 
 class="cmtt-10">psb_sort_ovw_idx_</span></span></span>.
      </dd></dl>
-<!--l. 1774--><p class="indent" >
+<!--l. 1787--><p class="indent" >
      <dl class="description"><dt class="description">
 <span 
 class="cmbx-10">On Return</span> </dt><dd 
@@ -126,7 +126,7 @@ class="cmbx-10">Optional </span><br
 class="newline" />An integer array of rank 1, whose entries are moved to the same position
      as the corresponding entries in <span 
 class="cmmi-10">x</span>.</dd></dl>
-<!--l. 1785--><p class="noindent" ><span 
+<!--l. 1798--><p class="noindent" ><span 
 class="cmbx-12">Notes</span>
      <ol  class="enumerate1" >
      <li 

docs/src/toolsrout.tex

@@ -547,7 +547,7 @@ An integer value; 0 means no error has been detected.
 \clearpage\subsection{psb\_spall --- Allocates a sparse matrix}
 
 \begin{verbatim}
-call psb_spall(a, desc_a, info, nnz)
+call psb_spall(a, desc_a, info, nnz, buildmode)
 \end{verbatim}
 
 \begin{description}
@@ -564,6 +564,13 @@ Scope: {\bf global}.\\
 Type: {\bf optional}.\\
 Intent: {\bf in}.\\
 Specified as: an integer value. 
+\item[buildmode] Whether to keep track of matrix entries that do not
+  belong to the current process.\\ 
+Scope: {\bf global}.\\
+Type: {\bf optional}.\\
+Intent: {\bf in}.\\
+Specified as: an integer value \verb|psb_matbld_noremote_|,
+\verb|psb_matbld_remote_|.  Default:  \verb|psb_matbld_noremote_|.
 \end{description}
 
 \begin{description}
@@ -733,7 +740,7 @@ call psb_spasb(a, desc_a, info, afmt, upd, dupl, mold)
 \item[desc\_a] the communication descriptor.\\
 Scope:{\bf local}.\\
 Type:{\bf required}.\\
-Intent: {\bf in}.\\
+Intent: {\bf in/out}.\\
 Specified as: a structured data of type \descdata.
 \item[afmt] the storage format for the sparse matrix.\\
 Scope: {\bf local}.\\
@@ -787,7 +794,13 @@ An integer value; 0 means no error has been detected.
 \item The output storage format need not be the same on all
   processes; 
 \item On exit from this routine the matrix is in the assembled state,
-  and thus is suitable for the computational routines. 
+  and thus is suitable for the computational routines;
+\item If the \verb|buildmode=psb_matbld_remote_| value was specified
+  at allocation time, contributions defined on the current process but
+  belonging to a remote process will be handled accordingly. This is
+  most likely to occur in finite element applications, with
+  \verb|dupl=psb_dupl_add_|; note that the descriptor will be updated,
+  and there will be a runtime overhead. 
 \end{enumerate}
 
 

docs/src/userguide.tex

@@ -109,7 +109,7 @@
 \vspace*{\stretch{1}}
 \noindent\hspace*{\centeroffset}\makebox[0pt][l]{\begin{minipage}{\textwidth}
 \flushright
-{\Huge\bfseries PSBLAS 3.7.0.1 User's guide
+{\Huge\bfseries PSBLAS 3.7.0.2 User's guide
 }
 \noindent\rule[-1ex]{\textwidth}{5pt}\\[2.5ex]
 \hfill\emph{\Large A reference guide for the Parallel Sparse BLAS library}
@@ -130,7 +130,7 @@
 {\bfseries 
 by Salvatore Filippone\\
 and Alfredo Buttari}\\ 
-May 11th, 2021
+Feb 14th, 2022
 \end{minipage}}
 }
 %\addtolength{\textwidth}{\centeroffset}

docs/src/userhtml.tex

@@ -96,7 +96,7 @@
 %\today
 Software version: 3.7.0.1\\
 %\today
-May 11th, 2021
+Feb 14th, 2022
 \cleardoublepage
 \begingroup
   \renewcommand*{\thepage}{toc}