psblas3:

base/modules/psb_base_tools_mod.f90
 base/tools/psb_cdins.f90
 docs/html/footnode.html
 docs/html/img100.png
 docs/html/img101.png
 docs/html/img102.png
 docs/html/img103.png
 docs/html/img104.png
 docs/html/img105.png
 docs/html/img106.png
 docs/html/img107.png
 docs/html/img108.png
 docs/html/img109.png
 docs/html/img110.png
 docs/html/img111.png
 docs/html/img112.png
 docs/html/img113.png
 docs/html/img114.png
 docs/html/img115.png
 docs/html/img116.png
 docs/html/img117.png
 docs/html/img118.png
 docs/html/img119.png
 docs/html/img120.png
 docs/html/img121.png
 docs/html/img122.png
 docs/html/img123.png
 docs/html/img124.png
 docs/html/img125.png
 docs/html/img126.png
 docs/html/img127.png
 docs/html/img128.png
 docs/html/img129.png
 docs/html/img130.png
 docs/html/img131.png
 docs/html/img132.png
 docs/html/img133.png
 docs/html/img134.png
 docs/html/img135.png
 docs/html/img136.png
 docs/html/img137.png
 docs/html/img138.png
 docs/html/img139.png
 docs/html/img140.png
 docs/html/img141.png
 docs/html/img142.png
 docs/html/img143.png
 docs/html/img144.png
 docs/html/img145.png
 docs/html/img146.png
 docs/html/img147.png
 docs/html/img148.png
 docs/html/img149.png
 docs/html/img19.png
 docs/html/img20.png
 docs/html/img21.png
 docs/html/img22.png
 docs/html/img23.png
 docs/html/img24.png
 docs/html/img25.png
 docs/html/img26.png
 docs/html/img27.png
 docs/html/img28.png
 docs/html/img29.png
 docs/html/img30.png
 docs/html/img31.png
 docs/html/img32.png
 docs/html/img33.png
 docs/html/img34.png
 docs/html/img35.png
 docs/html/img36.png
 docs/html/img37.png
 docs/html/img38.png
 docs/html/img39.png
 docs/html/img40.png
 docs/html/img41.png
 docs/html/img42.png
 docs/html/img43.png
 docs/html/img44.png
 docs/html/img45.png
 docs/html/img46.png
 docs/html/img47.png
 docs/html/img48.png
 docs/html/img49.png
 docs/html/img50.png
 docs/html/img51.png
 docs/html/img52.png
 docs/html/img53.png
 docs/html/img54.png
 docs/html/img55.png
 docs/html/img56.png
 docs/html/img58.png
 docs/html/img59.png
 docs/html/img60.png
 docs/html/img61.png
 docs/html/img62.png
 docs/html/img63.png
 docs/html/img64.png
 docs/html/img65.png
 docs/html/img66.png
 docs/html/img67.png
 docs/html/img68.png
 docs/html/img69.png
 docs/html/img70.png
 docs/html/img71.png
 docs/html/img72.png
 docs/html/img73.png
 docs/html/img74.png
 docs/html/img75.png
 docs/html/img76.png
 docs/html/img77.png
 docs/html/img78.png
 docs/html/img79.png
 docs/html/img80.png
 docs/html/img81.png
 docs/html/img82.png
 docs/html/img83.png
 docs/html/img84.png
 docs/html/img85.png
 docs/html/img86.png
 docs/html/img87.png
 docs/html/img88.png
 docs/html/img89.png
 docs/html/img90.png
 docs/html/img91.png
 docs/html/img92.png
 docs/html/img93.png
 docs/html/img94.png
 docs/html/img95.png
 docs/html/img96.png
 docs/html/img97.png
 docs/html/img98.png
 docs/html/img99.png
 docs/html/index.html
 docs/html/node10.html
 docs/html/node100.html
 docs/html/node101.html
 docs/html/node113.html
 docs/html/node118.html
 docs/html/node120.html
 docs/html/node20.html
 docs/html/node3.html
 docs/html/node30.html
 docs/html/node36.html
 docs/html/node38.html
 docs/html/node39.html
 docs/html/node4.html
 docs/html/node40.html
 docs/html/node41.html
 docs/html/node42.html
 docs/html/node43.html
 docs/html/node44.html
 docs/html/node45.html
 docs/html/node46.html
 docs/html/node47.html
 docs/html/node48.html
 docs/html/node49.html
 docs/html/node50.html
 docs/html/node52.html
 docs/html/node53.html
 docs/html/node54.html
 docs/html/node55.html
 docs/html/node57.html
 docs/html/node58.html
 docs/html/node62.html
 docs/html/node63.html
 docs/html/node64.html
 docs/html/node68.html
 docs/html/node69.html
 docs/html/node7.html
 docs/html/node70.html
 docs/html/node72.html
 docs/html/node73.html
 docs/html/node74.html
 docs/html/node75.html
 docs/html/node76.html
 docs/html/node77.html
 docs/html/node78.html
 docs/html/node8.html
 docs/html/node81.html
 docs/html/node83.html
 docs/html/node85.html
 docs/html/node86.html
 docs/html/node87.html
 docs/html/node89.html
 docs/html/node93.html
 docs/html/node94.html
 docs/html/node95.html
 docs/html/node96.html
 docs/html/node97.html
 docs/html/node98.html
 docs/html/node99.html
 docs/html/userhtml.html
 docs/psblas-3.0.pdf
 docs/src/intro.tex
 docs/src/toolsrout.tex
 docs/src/userguide.tex
 docs/src/userhtml.tex

Towards the "official" 3.0 release: 
1. fixed minor interface problem with LIDX in cdins.
2. Updated docs with  cross-references for usage of LIDX/LOCAL.

docs/html/node58.html

@@ -57,14 +57,27 @@ psb_cdins -- Communication descriptor insert routine</A>
 
 <P>
 <PRE>
-call psb_cdins(nz, ia, ja, desc_a, info)
+call psb_cdins(nz, ia, ja, desc_a, info [,ila,jla])
+call psb_cdins(nz,ja,desc,info[,jla,mask,lidx])
 </PRE>
 
 <P>
 This subroutine examines the edges of the graph associated with the
 discretization mesh (and isomorphic to the sparsity pattern of a
 linear system coefficient matrix), storing them as necessary into the
-communication descriptor.
+communication descriptor. In the first form the edges are specified as
+pairs of indices <IMG
+ WIDTH="76" HEIGHT="32" ALIGN="MIDDLE" BORDER="0"
+ SRC="img95.png"
+ ALT="$ia(i),ja(i)$">; the starting index <IMG
+ WIDTH="36" HEIGHT="32" ALIGN="MIDDLE" BORDER="0"
+ SRC="img96.png"
+ ALT="$ia(i)$"> should
+belong to the current process. 
+In the second form only the remote indices <IMG
+ WIDTH="37" HEIGHT="32" ALIGN="MIDDLE" BORDER="0"
+ SRC="img97.png"
+ ALT="$ja(i)$"> are specified. 
 
 <P>
 <DL>
@@ -95,8 +108,8 @@ Type: <B>required</B>.
 Intent: <B>in</B>.
 <BR>
 Specified as: an integer array of length <IMG
- WIDTH="22" HEIGHT="13" ALIGN="BOTTOM" BORDER="0"
- SRC="img95.png"
+ WIDTH="22" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
+ SRC="img98.png"
  ALT="$nz$">.
 </DD>
 <DT><STRONG>ja</STRONG></DT>
@@ -109,8 +122,37 @@ Type: <B>required</B>.
 Intent: <B>in</B>.
 <BR>
 Specified as: an integer array of length <IMG
- WIDTH="22" HEIGHT="13" ALIGN="BOTTOM" BORDER="0"
- SRC="img95.png"
+ WIDTH="22" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
+ SRC="img98.png"
+ ALT="$nz$">.
+</DD>
+<DT><STRONG>mask</STRONG></DT>
+<DD>Mask entries in <code>ja</code>, they are inserted only when the
+  corresponding <code>mask</code> entries are <code>.true.</code>
+<BR>
+Scope: <B>local</B>.
+<BR>
+Type: <B>optional</B>.
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as: a logical  array of length <IMG
+ WIDTH="22" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
+ SRC="img98.png"
+ ALT="$nz$">, default <code>.true.</code>.
+</DD>
+<DT><STRONG>lidx</STRONG></DT>
+<DD>User defined local indices for <code>ja</code>.
+<BR>
+Scope: <B>local</B>.
+<BR>
+Type: <B>optional</B>.
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as: an integer array of length <IMG
+ WIDTH="22" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
+ SRC="img98.png"
  ALT="$nz$">.
 </DD>
 </DL>
@@ -142,6 +184,36 @@ Intent: <B>out</B>.
 <BR>
 An integer value; 0 means no error has been detected. 
 </DD>
+<DT><STRONG>ila</STRONG></DT>
+<DD>the local indices of the starting vertex of the edges  being inserted.
+<BR>
+Scope: <B>local</B>.
+<BR>
+Type: <B>optional</B>.
+<BR>
+Intent: <B>out</B>.
+<BR>
+Specified as: an integer array of length <IMG
+ WIDTH="22" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
+ SRC="img98.png"
+ ALT="$nz$">.
+</DD>
+<DT><STRONG>jla</STRONG></DT>
+<DD>the local indices of the end vertex of the edges  being inserted.
+<BR>
+Scope: <B>local</B>.
+<BR>
+Type: <B>optional</B>.
+<BR>
+Intent: <B>out</B>.
+<BR>
+Specified as: an integer array of length <IMG
+ WIDTH="22" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
+ SRC="img98.png"
+ ALT="$nz$">.
+
+<P>
+</DD>
 </DL>
 <FONT SIZE="+1"><B>Notes</B></FONT>
 
@@ -151,14 +223,10 @@ An integer value; 0 means no error has been detected.
 </LI>
 <LI>This routine automatically ignores edges that do not
 insist on the  current process, i.e. edges for which neither the starting
-nor the end vertex belong to the current process. 
+nor the end vertex belong to the current process.
 </LI>
-<LI>There exists another interface for this routine
-<PRE>
-call psb_cdins(nz, ja, desc_a, info)
-</PRE>
-which will digest all entries in <code>ja</code> and add them to the
-communication requirements. 
+<LI>The second form of this routine will be useful when dealing with
+  user-specified index mappings; see also&nbsp;<A HREF="node7.html#sec:usermaps">2.3.1</A>.
 </LI>
 </OL>