From 827934adae02f0671f2100b89a978a94cc65b2bf Mon Sep 17 00:00:00 2001 From: Salvatore Filippone Date: Fri, 15 Apr 2022 11:58:31 +0200 Subject: [PATCH] Update docs. Bump 3.8 version. --- base/modules/psb_const_mod.F90 | 4 ++-- docs/html/index.html | 4 ++-- docs/html/userhtml.html | 4 ++-- docs/html/userhtmlsu36.html | 5 +++-- docs/html/userhtmlsu37.html | 22 +++++++++--------- docs/html/userhtmlsu38.html | 25 +++++++++++---------- docs/html/userhtmlsu39.html | 12 +++++----- docs/html/userhtmlsu40.html | 14 ++++++------ docs/html/userhtmlsu41.html | 23 ++++++++++++------- docs/html/userhtmlsu42.html | 14 ++++++------ docs/html/userhtmlsu43.html | 33 ++++++++++++++++++++++----- docs/html/userhtmlsu44.html | 12 +++++----- docs/html/userhtmlsu45.html | 12 +++++----- docs/html/userhtmlsu46.html | 14 ++++++------ docs/html/userhtmlsu47.html | 12 +++++----- docs/html/userhtmlsu48.html | 14 ++++++------ docs/html/userhtmlsu49.html | 14 ++++++------ docs/html/userhtmlsu50.html | 14 ++++++------ docs/html/userhtmlsu51.html | 14 ++++++------ docs/html/userhtmlsu52.html | 14 ++++++------ docs/html/userhtmlsu53.html | 14 ++++++------ docs/html/userhtmlsu54.html | 14 ++++++------ docs/html/userhtmlsu55.html | 12 +++++----- docs/html/userhtmlsu56.html | 16 ++++++------- docs/html/userhtmlsu83.html | 32 ++++++++++++++++++++++++++ docs/html/userhtmlsu84.html | 2 +- docs/html/userhtmlsu85.html | 2 +- docs/html/userhtmlsu86.html | 2 +- docs/html/userhtmlsu87.html | 2 +- docs/html/userhtmlsu88.html | 2 +- docs/html/userhtmlsu89.html | 2 +- docs/src/Makefile | 2 +- docs/src/toolsrout.tex | 41 ++++++++++++++++++++++++++-------- docs/src/userguide.tex | 8 +++---- docs/src/userhtml.tex | 4 ++-- 35 files changed, 261 insertions(+), 174 deletions(-) diff --git a/base/modules/psb_const_mod.F90 b/base/modules/psb_const_mod.F90 index 85833a49..cc29f049 100644 --- a/base/modules/psb_const_mod.F90 +++ b/base/modules/psb_const_mod.F90 @@ -136,9 +136,9 @@ module psb_const_mod ! ! Version ! - character(len=*), parameter :: psb_version_string_ = "3.7.0" + character(len=*), parameter :: psb_version_string_ = "3.8.0" integer(psb_ipk_), parameter :: psb_version_major_ = 3 - integer(psb_ipk_), parameter :: psb_version_minor_ = 7 + integer(psb_ipk_), parameter :: psb_version_minor_ = 8 integer(psb_ipk_), parameter :: psb_patchlevel_ = 0 ! diff --git a/docs/html/index.html b/docs/html/index.html index ece52ac5..c4f777e4 100644 --- a/docs/html/index.html +++ b/docs/html/index.html @@ -20,8 +20,8 @@ class="newline" /> Salvatore Filippone
Alfredo Buttari
Software version: 3.7.0.1
Feb 14th, 2022 +class="newline" />Software version: 3.8.0
May 1st, 2022 diff --git a/docs/html/userhtml.html b/docs/html/userhtml.html index ece52ac5..c4f777e4 100644 --- a/docs/html/userhtml.html +++ b/docs/html/userhtml.html @@ -20,8 +20,8 @@ class="newline" /> Salvatore Filippone
Alfredo Buttari
Software version: 3.7.0.1
Feb 14th, 2022 +class="newline" />Software version: 3.8.0
May 1st, 2022 diff --git a/docs/html/userhtmlsu36.html b/docs/html/userhtmlsu36.html index 93be49b1..1f4bc96c 100644 --- a/docs/html/userhtmlsu36.html +++ b/docs/html/userhtmlsu36.html @@ -145,8 +145,9 @@ class="cmmi-10">nnz in the multiple) data reallocations;
  • Using psb_matbld_remote_ will cause an overhead at assembly time;
    • + class="enumerate" id="x47-84008x4">Using psb_matbld_remote_ is likely to cause a runtime overhead at + assembly time; diff --git a/docs/html/userhtmlsu37.html b/docs/html/userhtmlsu37.html index e59a77e4..725a67ca 100644 --- a/docs/html/userhtmlsu37.html +++ b/docs/html/userhtmlsu37.html @@ -234,14 +234,11 @@ class="cmmi-10">,ja(i),val(i), for i = 1i = 1,…,nz; these triples should - belong to the current process, i.e. ia(i) should be one of the local indices, - but are otherwise arbitrary; +class="cmmi-10">,nz; these triples are + arbitrary;
  • In CSR format the coefficients to be inserted for each input row -1 should be one of the local indices, but are otherwise call, according to the application needs;
  • Any coefficients from matrix rows not owned by the calling process are - silently ignored; + class="enumerate" id="x48-85018x9">Coefficients from matrix rows not owned by the calling process are + treated according to the value of buildmode specified at allocation time; if + buildmode was chosen as psb_matbld_remote_ the library will keep track + of them, otherwise they are silently ignored; @@ -300,12 +302,12 @@ class="cmsy-10">-1 should be one of the local indices, but are otherwise -

    [

    [next] [prev] [prev-tail] [front] [up]

    -

    diff --git a/docs/html/userhtmlsu38.html b/docs/html/userhtmlsu38.html index 46962f0b..0b03af51 100644 --- a/docs/html/userhtmlsu38.html +++ b/docs/html/userhtmlsu38.html @@ -10,7 +10,7 @@ -

    [

    [next] [prev] [prev-tail] [up] 

    -call psb_spasb(a, desc_a, info, afmt, upd,  mold)
+call psb_spasb(a, desc_a, info [, afmt, upd,  mold])
    -

    -

    +

    +

    Type:
    _T_base_sparse_mat.
    -

    +

    On Return
    required
    Intent: out.
    An integer value; 0 means no error has been detected.
    -

    Notes

    1. psb_spins class="enumerate" id="x49-86014x7">If the 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 dupl=psb_dupl_add_; note that the - descriptor will be updated, and there will be a runtime overhead.
    + remote process will be handled accordingly. This is most likely to occur in + finite element applications, with dupl=psb_dupl_add_; it is necessary to + check for possible updates needed in the descriptor, hence there will be a + runtime overhead.
    • -

    [

    [next] [prev] [prev-tail] [front] [up]

    -

    diff --git a/docs/html/userhtmlsu39.html b/docs/html/userhtmlsu39.html index 158ffce3..71b070cd 100644 --- a/docs/html/userhtmlsu39.html +++ b/docs/html/userhtmlsu39.html @@ -10,7 +10,7 @@ -

    [

    [next] [prev] [prev-tail] [up] 

     call psb_spfree(a, desc_a, info)
    -

    -

    +

    +

    Type:
    psb_desc_type.
    -

    +

    On Return
    An integer value; 0 means no error has been detected.

    [

    [next] [prev] [prev-tail] [front] [up]

    -

    diff --git a/docs/html/userhtmlsu40.html b/docs/html/userhtmlsu40.html index f66b2654..7485edd3 100644 --- a/docs/html/userhtmlsu40.html +++ b/docs/html/userhtmlsu40.html @@ -10,7 +10,7 @@ -

    [

    [next] [prev] [prev-tail] [up] 

     call psb_sprn(a, decsc_a, info, clear)
    -

    -

    +

    +

    Type:
    optional.
    Intent: in.
    Default: true.
    -

    +

    On Return
    required
    Intent: out.
    An integer value; 0 means no error has been detected.
    -

    Notes

    1. Notes -

      [

      [next] [prev] [prev-tail] [front] [up]

      -

      diff --git a/docs/html/userhtmlsu41.html b/docs/html/userhtmlsu41.html index 40f88253..afed2c40 100644 --- a/docs/html/userhtmlsu41.html +++ b/docs/html/userhtmlsu41.html @@ -10,7 +10,7 @@ -

      [

      [next] [prev] [prev-tail] [up] 

       call psb_geall(x, desc_a, info[, dupl, bldmode, n, lb])
      -

      -

      +

      +

      Type:
      Intent: in.
      Specified as: integer, possible values: psb_dupl_ovwrt_, psb_dupl_add_, +class="cmtt-10">psb_dupl_add_; psb_dupl_err_. +class="cmtt-10">psb_dupl_err_ has no effect.
      buildmode
      psb_matbld_noremote_, psb_matbld_remote_. Default: psb_matbld_noremote_.
      -

      +

      On Return
      required
      Intent: out.
      An integer value; 0 means no error has been detected.
      +

      Notes +

        +
      1. Using psb_matbld_remote_ is likely to cause a runtime overhead at + assembly time;
      -

      [

      [next] [prev] [prev-tail] [front] [up]

      -

      diff --git a/docs/html/userhtmlsu42.html b/docs/html/userhtmlsu42.html index 30779ef4..eef5ec20 100644 --- a/docs/html/userhtmlsu42.html +++ b/docs/html/userhtmlsu42.html @@ -10,7 +10,7 @@ -

      [

      [next] [prev] [prev-tail] [up] 

       call psb_geins(m, irw, val, x, desc_a, info [,local])
      -

      -

      +

      +

      Type:
      optional.
      Specified as: a logical value; default: .false..
      -

      +

      @@ -139,7 +139,7 @@ class="cmbx-10">required
      Intent: out.
      An integer value; 0 means no error has been detected. -

      Notes

      1. Notes -

        [

        [next] [prev] [prev-tail] [front] [up]

        -

        diff --git a/docs/html/userhtmlsu43.html b/docs/html/userhtmlsu43.html index e0e237a6..1d25af7b 100644 --- a/docs/html/userhtmlsu43.html +++ b/docs/html/userhtmlsu43.html @@ -10,7 +10,7 @@ -

        [

        [next] [prev] [prev-tail] [up] 

         call psb_geasb(x, desc_a, info, mold)
        -

        -

        +

        +

        Type:
        psb_T_vect_type.
        -

        +

        On Return
        required
        Intent: out.
        An integer value; 0 means no error has been detected.
        +

        Notes -

        [ +

      2. On entry to this routine the descriptor must be in the assembled state, + i.e. psb_cdasb must already have been called. +
        3. +
      3. If the 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 dupl=psb_dupl_add_.
      + + + + + + +

      [next] [prev] [prev-tail] [front] [up]

      -

      diff --git a/docs/html/userhtmlsu44.html b/docs/html/userhtmlsu44.html index 1353f60a..c385f927 100644 --- a/docs/html/userhtmlsu44.html +++ b/docs/html/userhtmlsu44.html @@ -10,7 +10,7 @@ -

      [

      [next] [prev] [prev-tail] [up] 

       call psb_gefree(x, desc_a, info)
      -

      -

      +

      +

      Type:
      psb_desc_type.
      -

      +

      On Return
      An integer value; 0 means no error has been detected.

      [

      [next] [prev] [prev-tail] [front] [up]

      -

      diff --git a/docs/html/userhtmlsu45.html b/docs/html/userhtmlsu45.html index 7ed46b09..ae3994d0 100644 --- a/docs/html/userhtmlsu45.html +++ b/docs/html/userhtmlsu45.html @@ -10,7 +10,7 @@ -

      [

      [next] [prev] [prev-tail] [up] 

       call psb_gelp(trans, iperm, x, info)
      -

      -

      +

      +

      Type:
      Intent: inout.
      Specified as: a one or two dimensional array.
      -

      +

      On Return
      An integer value; 0 means no error has been detected.

      [

      [next] [prev] [prev-tail] [front] [up]

      -

      diff --git a/docs/html/userhtmlsu46.html b/docs/html/userhtmlsu46.html index 933b5fab..ebe9591e 100644 --- a/docs/html/userhtmlsu46.html +++ b/docs/html/userhtmlsu46.html @@ -10,7 +10,7 @@ -

      [

      [next] [prev] [prev-tail] [up]

      call psb_glob_to_loc(x, y, desc_a, info, iact,owned) call psb_glob_to_loc(x, desc_a, info, iact,owned) -

      -

      +

      +

      Type:
      Intent: in.
      If true, then only indices strictly owned by the current process are considered valid, if false then halo indices are also accepted. Default: false.
      -

      +

      On Return
      required
      Intent: out.
      An integer value; 0 means no error has been detected.
      -

      Notes

      1. Ignore means that the negative output is th -

        [

        [next] [prev] [prev-tail] [front] [up]

        -

        diff --git a/docs/html/userhtmlsu47.html b/docs/html/userhtmlsu47.html index 7a34bae5..c222519b 100644 --- a/docs/html/userhtmlsu47.html +++ b/docs/html/userhtmlsu47.html @@ -10,7 +10,7 @@ -

        [

        [next] [prev] [prev-tail] [up]

        call psb_loc_to_glob(x, y, desc_a, info, iact) call psb_loc_to_glob(x, desc_a, info, iact) -

        -

        +

        +

        Type:
        Ignore, Warning or Abort, default Ignore.
        -

        +

        On Return
        An integer value; 0 means no error has been detected.

        [

        [next] [prev] [prev-tail] [front] [up]

        -

        diff --git a/docs/html/userhtmlsu48.html b/docs/html/userhtmlsu48.html index 0d2a0959..78911fdc 100644 --- a/docs/html/userhtmlsu48.html +++ b/docs/html/userhtmlsu48.html @@ -10,7 +10,7 @@ -

        [

        [next] [prev] [prev-tail] [up] 

         call psb_is_owned(x, desc_a)
        -

        -

        +

        +

        Type:
        psb_desc_type.
        -

        +

        On Return
        required
        Intent: out.
        -

        Notes

        1. .true. value for an index that is strictly -

          [

          [next] [prev] [prev-tail] [front] [up]

          -

          diff --git a/docs/html/userhtmlsu49.html b/docs/html/userhtmlsu49.html index 2b440146..76f09994 100644 --- a/docs/html/userhtmlsu49.html +++ b/docs/html/userhtmlsu49.html @@ -10,7 +10,7 @@ -

          [

          [next] [prev] [prev-tail] [up] 

           call psb_owned_index(y, x, desc_a, info)
          -

          -

          +

          +

          Type:
          Ignore, Warning or Abort, default Ignore.
          -

          +

          On Return
          An integer value; 0 means no error has been detected.

          Notes

          1. .true. value for those indices that are str -

            [

            [next] [prev] [prev-tail] [front] [up]

            -

            diff --git a/docs/html/userhtmlsu50.html b/docs/html/userhtmlsu50.html index 61677030..408b557e 100644 --- a/docs/html/userhtmlsu50.html +++ b/docs/html/userhtmlsu50.html @@ -10,7 +10,7 @@ -

            [

            [next] [prev] [prev-tail] [up] 

             call psb_is_local(x, desc_a)
            -

            -

            +

            +

            Type:
            psb_desc_type.
            -

            +

            On Return
            required
            Intent: out.
            -

            Notes

            1. .true. value for an index that is local to -

              [

              [next] [prev] [prev-tail] [front] [up]

              -

              diff --git a/docs/html/userhtmlsu51.html b/docs/html/userhtmlsu51.html index 2bbbbba9..3b9a80ca 100644 --- a/docs/html/userhtmlsu51.html +++ b/docs/html/userhtmlsu51.html @@ -10,7 +10,7 @@ -

              [

              [next] [prev] [prev-tail] [up] 

               call psb_local_index(y, x, desc_a, info)
              -

              -

              +

              +

              Type:
              Ignore, Warning or Abort, default Ignore.
              -

              +

              On Return
              An integer value; 0 means no error has been detected.

              Notes

              1. .true. value for those indices that are loc -

                [

                [next] [prev] [prev-tail] [front] [up]

                -

                diff --git a/docs/html/userhtmlsu52.html b/docs/html/userhtmlsu52.html index 2eac7163..6826dfc5 100644 --- a/docs/html/userhtmlsu52.html +++ b/docs/html/userhtmlsu52.html @@ -10,7 +10,7 @@ -

                [

                [next] [prev] [prev-tail] [up] 

                 call psb_get_boundary(bndel, desc, info)
                -

                -

                +

                +

                Type:
                psb_desc_type.
                -

                +

                On Return
                required
                Intent: out.
                An integer value; 0 means no error has been detected.
                -

                Notes

                1. bndel will be exactly equal to the nu -

                  [

                  [next] [prev] [prev-tail] [front] [up]

                  -

                  diff --git a/docs/html/userhtmlsu53.html b/docs/html/userhtmlsu53.html index 52f5837a..10ce7017 100644 --- a/docs/html/userhtmlsu53.html +++ b/docs/html/userhtmlsu53.html @@ -10,7 +10,7 @@ -

                  [

                  [next] [prev] [prev-tail] [up] 

                   call psb_get_overlap(ovrel, desc, info)
                  -

                  -

                  +

                  +

                  Type:
                  psb_desc_type.
                  -

                  +

                  On Return
                  required
                  Intent: out.
                  An integer value; 0 means no error has been detected.
                  -

                  Notes

                  1. ovrel will be exactly equal to the number o -

                    [

                    [next] [prev] [prev-tail] [front] [up]

                    -

                    diff --git a/docs/html/userhtmlsu54.html b/docs/html/userhtmlsu54.html index 4de7e149..a4cf2538 100644 --- a/docs/html/userhtmlsu54.html +++ b/docs/html/userhtmlsu54.html @@ -10,7 +10,7 @@ -

                    [

                    [next] [prev] [prev-tail] [up]

                    call psb_sp_getrow(row, a, nz, ia, ja, val, info, &               & append, nzin, lrw) -

                    -

                    +

                    +

                    Type:
                    row. -

                    +

                    On Return
                    required
                    Intent: out.
                    An integer value; 0 means no error has been detected.
                    -

                    Notes

                    1. psb_loc_to_glob routine on the output.
                      2. -

                      [

                      [next] [prev] [prev-tail] [front] [up]

                      -

                      diff --git a/docs/html/userhtmlsu55.html b/docs/html/userhtmlsu55.html index 0a612d50..0b438e9c 100644 --- a/docs/html/userhtmlsu55.html +++ b/docs/html/userhtmlsu55.html @@ -10,7 +10,7 @@ -

                      [

                      [next] [prev] [prev-tail] [tail] [up]

                      6.26 psb_sizeof — Memory occupation

                      -

                      This function computes the memory occupation of a PSBLAS object. +

                      This function computes the memory occupation of a PSBLAS object. @@ -27,8 +27,8 @@ isz = psb_sizeof(a) isz = psb_sizeof(desc_a) isz = psb_sizeof(prec) -

                      -

                      +

                      +

                      Type:
                      integer(psb_long_int_k_) number.
                      -

                      [

                      [next] [prev] [prev-tail] [front] [up]

                      -

                      diff --git a/docs/html/userhtmlsu56.html b/docs/html/userhtmlsu56.html index afd46917..26ab17eb 100644 --- a/docs/html/userhtmlsu56.html +++ b/docs/html/userhtmlsu56.html @@ -10,20 +10,20 @@ -

                      [

                      [prev] [prev-tail] [tail] [up]

                      6.27 Sorting utilities —

                      -

                      psb_msort — Sorting by the Merge-sort algorithm -

                      psb_qsort — Sorting by the Quicksort algorithm -

                      psb_hsort — Sorting by the Heapsort algorithm @@ -34,8 +34,8 @@ call psb_msort(x,ix,dir,flag) call psb_qsort(x,ix,dir,flag) call psb_hsort(x,ix,dir,flag) -

                      -

                      These serial routines sort a sequence

                      +

                      These serial routines sort a sequence X 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_; default psb_sort_ovw_idx_.

                    -

                    +

                    On Return
                    Optional
                    An integer array of rank 1, whose entries are moved to the same position as the corresponding entries in x.
                    -

                    Notes

                    1. Error code.
                      Type: required
                      An integer value; 0 means no error has been detected. +

                      Notes +

                      If this function is called on a vector v on a distributed communicator only the +local part is written in output. To get a single MatrixMarket file with the whole +vector when appropriate, e.g. for debugging purposes, one could gather the whole +vector on a single rank and then write it. Consider the following example for a double +precision vector +

                      +

                      +

                      +real(psb_dpk_), allocatable :: vglobal(:)
+call psb_gather(vglobal,v,desc,info)
+if (iam == psb_root_) then
+call mm_array_write(vglobal,vtitle,info,filename)
+end if
+call deallocate(vglobal, stat=info)
+
                      +

                      +

                      To simplify this procedure in C, there is a utility function +

                      +

                      +

                      +psb_i_t psb_c_<s,d,c,z>global_vec_write(vh,cdh);
+
                      +

                      +

                      that produces exactly this result. diff --git a/docs/html/userhtmlsu84.html b/docs/html/userhtmlsu84.html index 62b02748..1d11ee20 100644 --- a/docs/html/userhtmlsu84.html +++ b/docs/html/userhtmlsu84.html @@ -19,7 +19,7 @@ href="userhtmlsu86.html#userhtmlsu87.html" >up]

                    - 
                    +   
                     call prec%init(icontxt,ptype, info)
 
                    
 
                    
diff --git a/docs/html/userhtmlsu85.html b/docs/html/userhtmlsu85.html
index 4722c8a9..11f1d918 100644
--- a/docs/html/userhtmlsu85.html
+++ b/docs/html/userhtmlsu85.html
@@ -21,7 +21,7 @@ href="userhtmlsu86.html#userhtmlsu89.html" >up]
                    - 
                    +   
                     call prec%build(a, desc_a, info[,amold,vmold,imold])
 
                    
 
                    
diff --git a/docs/html/userhtmlsu86.html b/docs/html/userhtmlsu86.html
index 0c95a467..c5b9290d 100644
--- a/docs/html/userhtmlsu86.html
+++ b/docs/html/userhtmlsu86.html
@@ -21,7 +21,7 @@ href="userhtmlsu86.html#userhtmlse11.html" >up]
                  - 
                  +   
                   call prec%apply(x,y,desc_a,info,trans,work)
 call prec%apply(x,desc_a,info,trans)
 
                  
diff --git a/docs/html/userhtmlsu87.html b/docs/html/userhtmlsu87.html
index f01712c8..9f1267c1 100644
--- a/docs/html/userhtmlsu87.html
+++ b/docs/html/userhtmlsu87.html
@@ -21,7 +21,7 @@ href="userhtmlsu86.html#userhtmlsu90.html" >up]
                  - 
                  +   
                   call prec%descr(info)
 call prec%descr(info,iout, root)
 
                  
diff --git a/docs/html/userhtmlsu88.html b/docs/html/userhtmlsu88.html
index 1eee47e7..820fa752 100644
--- a/docs/html/userhtmlsu88.html
+++ b/docs/html/userhtmlsu88.html
@@ -20,7 +20,7 @@ href="userhtmlsu86.html#userhtmlli2.html" >up]
                - 
                +   
                 call  prec%clone(precout,info)
 
                
 
                
diff --git a/docs/html/userhtmlsu89.html b/docs/html/userhtmlsu89.html
index a5193184..8149e2e8 100644
--- a/docs/html/userhtmlsu89.html
+++ b/docs/html/userhtmlsu89.html
@@ -20,7 +20,7 @@ href="userhtmlsu86.html# " >up]
                - 
                +   
                 call prec%free(info)
 
                
 
                
diff --git a/docs/src/Makefile b/docs/src/Makefile
index 198d2321..e6ee0c5e 100644
--- a/docs/src/Makefile
+++ b/docs/src/Makefile
@@ -139,7 +139,7 @@ PDF      = $(join $(BASEFILE),.pdf)
 PS       = $(join $(BASEFILE),.ps)
 GXS      = $(join $(BASEFILE),.gxs)
 GLX      = $(join $(BASEFILE),.glx)
-TARGETPDF= ../psblas-3.7.pdf
+TARGETPDF= ../psblas-3.8.pdf
 BASEHTML = $(patsubst %.tex,%,$(HTMLFILE))
 HTML     = $(join $(BASEHTML),.html)
 HTMLDIR  = ../html
diff --git a/docs/src/toolsrout.tex b/docs/src/toolsrout.tex
index 5c1a6c8f..191aff7f 100644
--- a/docs/src/toolsrout.tex
+++ b/docs/src/toolsrout.tex
@@ -601,7 +601,7 @@ An integer value; 0 means no error has been detected.
   the assembled matrix may substantially improve performance in the
   matrix build phase, as it will reduce or eliminate the need for
   (potentially multiple) data reallocations;
-\item Using \verb|psb_matbld_remote_| will cause an overhead at
+\item Using \verb|psb_matbld_remote_| is likely to cause  a runtime  overhead at
   assembly time;
 \end{enumerate}
 
@@ -712,8 +712,7 @@ An integer value; 0 means no error has been detected.
 \item The input data can be passed in either COO or CSR formats;
 \item In COO format the coefficients to be inserted are represented by
   the ordered   triples $ia(i),ja(i),val(i)$, for $i=1,\dots,nz$;
-  these triples  should belong to the current process, i.e. $ia(i)$
-  should be one of  the local indices, but are otherwise arbitrary;
+  these triples are arbitrary;
 \item In CSR format the coefficients to be inserted for each input row $i=1,nr$
   are represented by the ordered triples $(i+irw-1),ja(j),val(j)$, for
   $j=irp(i),\dots,irp(i+1)-1$; 
@@ -724,8 +723,11 @@ An integer value; 0 means no error has been detected.
   may be split into   as many calls as desired (even in the CSR format); 
 \item Coefficients from different rows may also be mixed up freely
   in a single call, according to the application needs; 
-\item Any coefficients from matrix rows not owned by the calling
-  process are silently ignored;
+\item Coefficients from matrix rows not owned by the calling
+  process are treated according to the value of \verb|buildmode|
+  specified at allocation time; if 
+  \verb|buildmode| was chosen as \verb|psb_matbld_remote_| the library
+  will keep track of them, otherwise they are   silently ignored;
 \item If the descriptor is in the assembled state, then any entries in
   the sparse matrix that would generate additional communication
   requirements are  ignored; 
@@ -739,7 +741,7 @@ An integer value; 0 means no error has been detected.
 \clearpage\subsection{psb\_spasb --- Sparse matrix assembly routine}
 
 \begin{verbatim}
-call psb_spasb(a, desc_a, info, afmt, upd,  mold)
+call psb_spasb(a, desc_a, info [, afmt, upd,  mold])
 \end{verbatim}
 
 \begin{description}
@@ -808,8 +810,9 @@ An integer value; 0 means no error has been detected.
   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. 
+  \verb|dupl=psb_dupl_add_|; it is necessary to check for possible
+  updates needed in the descriptor, hence there will be a runtime
+  overhead.  
 \end{enumerate}
 
 
@@ -1007,7 +1010,7 @@ Scope: {\bf global}.\\
 Type: {\bf optional}.\\
 Intent: {\bf in}.\\
 Specified as: integer, possible values: \verb|psb_dupl_ovwrt_|,
-\verb|psb_dupl_add_|, \verb|psb_dupl_err_|.
+\verb|psb_dupl_add_|; \verb|psb_dupl_err_| has no effect.
 \item[buildmode] Whether to keep track of matrix entries that do not
   belong to the current process.\\ 
 Scope: {\bf global}.\\
@@ -1032,6 +1035,11 @@ Intent: {\bf out}.\\
 An integer value; 0 means no error has been detected. 
 \end{description}
 
+{\par\noindent\large\bfseries Notes}
+\begin{enumerate}
+\item Using \verb|psb_matbld_remote_| is likely to cause  a runtime  overhead at
+  assembly time;
+\end{enumerate}
 
 %
 %%   psb_ins %%
@@ -1140,7 +1148,22 @@ Type: {\bf required} \\
 Intent: {\bf out}.\\
 An integer value; 0 means no error has been detected. 
 \end{description}
+
+
+{\par\noindent\large\bfseries Notes}
+\begin{enumerate}
+\item On entry to this routine the descriptor must  be in  the
+  assembled state, i.e. \verb|psb_cdasb| must already have been called.
+\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_|.
+\end{enumerate}
+
+
 %
+
 %%   psb_free %%
 %
 \clearpage\subsection{psb\_gefree --- Frees a dense matrix}
diff --git a/docs/src/userguide.tex b/docs/src/userguide.tex
index c9e67456..9d4e1814 100644
--- a/docs/src/userguide.tex
+++ b/docs/src/userguide.tex
@@ -36,7 +36,7 @@
 \relax
 \pdfcompresslevel=0             %-- 0 = none, 9 = best
 \pdfinfo{                       %-- Info dictionary of PDF output  /Author (Alfredo Buttari)
-  /Title (Parallel Sparse BLAS V. 3.7.0)
+  /Title (Parallel Sparse BLAS V. 3.8.0)
   /Subject (Parallel Sparse Basic Linear Algebra Subroutines)
   /Keywords (Computer Science Linear Algebra Fluid Dynamics Parallel Linux MPI PSBLAS Iterative Solvers Preconditioners)
   /Creator (pdfLaTeX)
@@ -99,7 +99,7 @@
 
 \begin{document}
 {
-\pdfbookmark{PSBLAS-v3.7.0 User's Guide}{title}
+\pdfbookmark{PSBLAS-v3.8.0 User's Guide}{title}
 \lstset{language=Fortran}
 \newlength{\centeroffset}
 \setlength{\centeroffset}{-0.5\oddsidemargin}
@@ -109,7 +109,7 @@
 \vspace*{\stretch{1}}
 \noindent\hspace*{\centeroffset}\makebox[0pt][l]{\begin{minipage}{\textwidth}
 \flushright
-{\Huge\bfseries PSBLAS 3.7.0.2 User's guide
+{\Huge\bfseries PSBLAS 3.8.0 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}\\ 
-Feb 14th, 2022
+May 1st, 2022
 \end{minipage}}
 }
 %\addtolength{\textwidth}{\centeroffset}
diff --git a/docs/src/userhtml.tex b/docs/src/userhtml.tex
index 1d83d934..5dc0e6cf 100644
--- a/docs/src/userhtml.tex
+++ b/docs/src/userhtml.tex
@@ -94,9 +94,9 @@
    Alfredo Buttari } \\
 %\\[10ex]
 %\today
-Software version: 3.7.0.1\\
+Software version: 3.8.0\\
 %\today
-Feb 14th, 2022
+May 1st, 2022
 \cleardoublepage
 \begingroup
   \renewcommand*{\thepage}{toc}