mld2p4-2:

README
 docs/html/index.html
 docs/html/node26.html
 docs/html/node5.html
 docs/html/node6.html
 docs/html/node8.html
 docs/html/userhtml.html
 docs/mld2p4-2.0-guide.pdf
 docs/src/building.tex
 docs/src/userguide.tex
 docs/src/userhtml.tex

Miscellaneous doc fixes.
stopcriterion
Salvatore Filippone 12 years ago
parent 534adf7142
commit 549b6ae9ad

@ -5,7 +5,7 @@ WHAT'S NEW
Version 2.0. Version 2.0.
Finally moved to F2003, with the support of PSBLAS3. Finally moved to F2003, with the support of PSBLAS3.
There are a few minor differences: There are a few minor differences at user level:
1. In the configure step, you should specify the INSTALL directory 1. In the configure step, you should specify the INSTALL directory
of PSBLAS version 3, not the source directory; of PSBLAS version 3, not the source directory;
2. In the various makefiles, libmld_prec.a should now be used in 2. In the various makefiles, libmld_prec.a should now be used in

@ -63,7 +63,7 @@ University of Rome ``Tor Vergata'', Italy
<BR> <BR>
Software version: 2.0-beta Software version: 2.0-beta
<BR> <BR>
March 13, 2013 June 14, 2013
<BR> <BR>

@ -63,7 +63,7 @@ Mathematics Department, Macquarie University, Sydney.
The command line arguments were: <BR> The command line arguments were: <BR>
<STRONG>latex2html</STRONG> <TT>-local_icons -noaddress -dir ../../html userhtml.tex</TT> <STRONG>latex2html</STRONG> <TT>-local_icons -noaddress -dir ../../html userhtml.tex</TT>
<P> <P>
The translation was initiated by Salvatore Filippone on 2013-03-14 The translation was initiated by Salvatore Filippone on 2013-06-06
<BR><HR> <BR><HR>
</BODY> </BODY>

@ -70,7 +70,7 @@ feature, which
enhances the usability of <code>ALLOCATE</code>. enhances the usability of <code>ALLOCATE</code>.
Many compiles do this; in particular, this is Many compiles do this; in particular, this is
supported by the GNU Fortran compiler, for which we supported by the GNU Fortran compiler, for which we
recommend to use at least version 4.7.1. recommend to use at least version 4.7.2.
The software defines data types and interfaces for The software defines data types and interfaces for
real and complex data, in both single and double precision. real and complex data, in both single and double precision.

@ -88,7 +88,7 @@ The following base libraries are needed:
HREF="node25.html#psblas_00">17</A>] Parallel Sparse BLAS is HREF="node25.html#psblas_00">17</A>] Parallel Sparse BLAS is
available from available from
<BR><code>http://www.ce.uniroma2.it/psblas</code>; version <BR><code>http://www.ce.uniroma2.it/psblas</code>; version
3.0 (or later) is required. Indeed, all the prerequisites 3.1 (or later) is required. Indeed, all the prerequisites
listed so far are also prerequisites of PSBLAS. listed so far are also prerequisites of PSBLAS.
</DD> </DD>
</DL> </DL>

@ -71,9 +71,9 @@ be specified with an <EM>absolute</EM> path).
The full set of options may be looked at by issuing the command The full set of options may be looked at by issuing the command
<code>./configure --help</code>, which produces: <code>./configure --help</code>, which produces:
<PRE> <PRE>
`configure' configures MLD2P4 1.1 to adapt to many kinds of systems. `configure' configures MLD2P4 2.0 to adapt to many kinds of systems.
Usage: ./configure [OPTION]... [VAR=VALUE]... Usage: ../../configure [OPTION]... [VAR=VALUE]...
To assign environment variables (e.g., CC, CFLAGS...), specify them as To assign environment variables (e.g., CC, CFLAGS...), specify them as
VAR=VALUE. See below for descriptions of some of the useful variables. VAR=VALUE. See below for descriptions of some of the useful variables.
@ -85,7 +85,7 @@ Configuration:
--help=short display options specific to this package --help=short display options specific to this package
--help=recursive display the short help of all the included packages --help=recursive display the short help of all the included packages
-V, --version display version information and exit -V, --version display version information and exit
-q, --quiet, --silent do not print `checking...' messages -q, --quiet, --silent do not print `checking ...' messages
--cache-file=FILE cache test results in FILE [disabled] --cache-file=FILE cache test results in FILE [disabled]
-C, --config-cache alias for `--cache-file=config.cache' -C, --config-cache alias for `--cache-file=config.cache'
-n, --no-create do not create output files -n, --no-create do not create output files
@ -93,9 +93,9 @@ Configuration:
Installation directories: Installation directories:
--prefix=PREFIX install architecture-independent files in PREFIX --prefix=PREFIX install architecture-independent files in PREFIX
[/usr/local] [/usr/local]
--exec-prefix=EPREFIX install architecture-dependent files in EPREFIX --exec-prefix=EPREFIX install architecture-dependent files in EPREFIX
[PREFIX] [PREFIX]
By default, `make install' will install all the files in By default, `make install' will install all the files in
`/usr/local/bin', `/usr/local/lib' etc. You can specify `/usr/local/bin', `/usr/local/lib' etc. You can specify
@ -105,25 +105,32 @@ for instance `--prefix=$HOME'.
For better control, use the options below. For better control, use the options below.
Fine tuning of the installation directories: Fine tuning of the installation directories:
--bindir=DIR user executables [EPREFIX/bin] --bindir=DIR user executables [EPREFIX/bin]
--sbindir=DIR system admin executables [EPREFIX/sbin] --sbindir=DIR system admin executables [EPREFIX/sbin]
--libexecdir=DIR program executables [EPREFIX/libexec] --libexecdir=DIR program executables [EPREFIX/libexec]
--sysconfdir=DIR read-only single-machine data [PREFIX/etc] --sysconfdir=DIR read-only single-machine data [PREFIX/etc]
--sharedstatedir=DIR modifiable architecture-independent data [PREFIX/com] --sharedstatedir=DIR modifiable architecture-independent data [PREFIX/com]
--localstatedir=DIR modifiable single-machine data [PREFIX/var] --localstatedir=DIR modifiable single-machine data [PREFIX/var]
--libdir=DIR object code libraries [EPREFIX/lib] --libdir=DIR object code libraries [EPREFIX/lib]
--includedir=DIR C header files [PREFIX/include] --includedir=DIR C header files [PREFIX/include]
--oldincludedir=DIR C header files for non-gcc [/usr/include] --oldincludedir=DIR C header files for non-gcc [/usr/include]
--datarootdir=DIR read-only arch.-independent data root [PREFIX/share] --datarootdir=DIR read-only arch.-independent data root [PREFIX/share]
--datadir=DIR read-only architecture-independent data [DATAROOTDIR] --datadir=DIR read-only architecture-independent data [DATAROOTDIR]
--infodir=DIR info documentation [DATAROOTDIR/info] --infodir=DIR info documentation [DATAROOTDIR/info]
--localedir=DIR locale-dependent data [DATAROOTDIR/locale] --localedir=DIR locale-dependent data [DATAROOTDIR/locale]
--mandir=DIR man documentation [DATAROOTDIR/man] --mandir=DIR man documentation [DATAROOTDIR/man]
--docdir=DIR documentation root [DATAROOTDIR/doc/mld2p4] --docdir=DIR documentation root [DATAROOTDIR/doc/mld2p4]
--htmldir=DIR html documentation [DOCDIR] --htmldir=DIR html documentation [DOCDIR]
--dvidir=DIR dvi documentation [DOCDIR] --dvidir=DIR dvi documentation [DOCDIR]
--pdfdir=DIR pdf documentation [DOCDIR] --pdfdir=DIR pdf documentation [DOCDIR]
--psdir=DIR ps documentation [DOCDIR] --psdir=DIR ps documentation [DOCDIR]
Optional Features:
--disable-option-checking ignore unrecognized --enable/--with options
--disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no)
--enable-FEATURE[=ARG] include FEATURE [ARG=yes]
--enable-serial Specify whether to enable a fake mpi library to run
in serial mode.
Optional Packages: Optional Packages:
--with-PACKAGE[=ARG] use PACKAGE [ARG=yes] --with-PACKAGE[=ARG] use PACKAGE [ARG=yes]
@ -133,27 +140,18 @@ Optional Packages:
--with-libs List additional link flags here. For example, --with-libs List additional link flags here. For example,
--with-libs=-lspecial_system_lib or --with-libs=-lspecial_system_lib or
--with-libs=-L/path/to/libs --with-libs=-L/path/to/libs
--with-clibs additional CLIBS flags to be added: will prepend
to CLIBS
--with-flibs additional FLIBS flags to be added: will prepend
to FLIBS
--with-library-path additional LIBRARYPATH flags to be added: will
prepend to LIBRARYPATH
--with-include-path additional INCLUDEPATH flags to be added: will
prepend to INCLUDEPATH
--with-module-path additional MODULE_PATH flags to be added: will
prepend to MODULE_PATH
--with-umfpack=LIBNAME Specify the library name for UMFPACK library. --with-umfpack=LIBNAME Specify the library name for UMFPACK library.
Default: "-lumfpack -lamd" Default: "-lumfpack -lamd"
--with-umfpackdir=DIR Specify the directory for UMFPACK library and --with-umfpackdir=DIR Specify the directory for UMFPACK library and
includes. includes.
--with-superlu=LIBNAME Specify the library name for SUPERLU library. --with-superlu=LIBNAME Specify the library name for SUPERLU library.
Default: "-lslu" Default: "-lsuperlu"
--with-superludir=DIR Specify the directory for SUPERLU library and --with-superludir=DIR Specify the directory for SUPERLU library and
includes. includes.
--with-superludist=LIBNAME --with-superludist=LIBNAME
Specify the libname for SUPERLUDIST library. Specify the libname for SUPERLUDIST library.
Requires you also specify SuperLU. Default: "-lslud" Requires you also specify SuperLU. Default:
"-lsuperlu_dist"
--with-superludistdir=DIR --with-superludistdir=DIR
Specify the directory for SUPERLUDIST library and Specify the directory for SUPERLUDIST library and
includes. includes.
@ -166,10 +164,14 @@ Some influential environment variables:
LIBS libraries to pass to the linker, e.g. -l&lt;library&gt; LIBS libraries to pass to the linker, e.g. -l&lt;library&gt;
CC C compiler command CC C compiler command
CFLAGS C compiler flags CFLAGS C compiler flags
CPPFLAGS C/C++/Objective C preprocessor flags, e.g. -I&lt;include dir&gt; if CPPFLAGS (Objective) C/C++ preprocessor flags, e.g. -I&lt;include dir&gt; if
you have headers in a nonstandard directory &lt;include dir&gt; you have headers in a nonstandard directory &lt;include dir&gt;
CPP C preprocessor CPP C preprocessor
MPICC MPI C compiler command MPICC MPI C compiler command
F77 Fortran 77 compiler command
FFLAGS Fortran 77 compiler flags
MPIF77 MPI Fortran 77 compiler command
MPIFC MPI Fortran compiler command
Use these variables to override the choices made by `configure' or to help Use these variables to override the choices made by `configure' or to help
it to find libraries and programs with nonstandard names/locations. it to find libraries and programs with nonstandard names/locations.
@ -177,12 +179,12 @@ it to find libraries and programs with nonstandard names/locations.
Report bugs to &lt;bugreport@mld2p4.it&gt;. Report bugs to &lt;bugreport@mld2p4.it&gt;.
</PRE> </PRE>
Thus, a sample build with libraries in installation Thus, a sample build with libraries in installation
directories specifics to the GNU 4.3 compiler suite might be as directories specifics to the GNU 4.7 compiler suite might be as
follows, specifying only the UMFPACK external package: follows, specifying only the UMFPACK external package:
<PRE> <PRE>
./configure --with-psblas=/home/user/psblas-3.0/ \ ./configure --with-psblas=/home/user/psblas-3.1/ \
--with-libs="-L/usr/local/BLAS/gnu46" \ --with-libs="-L/usr/local/BLAS/gnu47" \
--with-umfpackdir=/usr/local/UMFPACK/gnu46 --with-umfpackdir=/usr/local/UMFPACK/gnu47
</PRE> </PRE>
Once the configure script has completed execution, it will have Once the configure script has completed execution, it will have
generated the file <code>Make.inc</code> which will then be used by all generated the file <code>Make.inc</code> which will then be used by all

@ -63,7 +63,7 @@ University of Rome ``Tor Vergata'', Italy
<BR> <BR>
Software version: 2.0-beta Software version: 2.0-beta
<BR> <BR>
March 13, 2013 June 14, 2013
<BR> <BR>

File diff suppressed because it is too large Load Diff

@ -14,7 +14,7 @@ feature, which
enhances the usability of \verb|ALLOCATE|. enhances the usability of \verb|ALLOCATE|.
Many compiles do this; in particular, this is Many compiles do this; in particular, this is
supported by the GNU Fortran compiler, for which we supported by the GNU Fortran compiler, for which we
recommend to use at least version 4.7.1. recommend to use at least version 4.7.2.
The software defines data types and interfaces for The software defines data types and interfaces for
real and complex data, in both single and double precision. real and complex data, in both single and double precision.
@ -38,7 +38,7 @@ The following base libraries are needed:
high-performance computing systems; only version 1.1 is required. high-performance computing systems; only version 1.1 is required.
\item[PSBLAS] \cite{PSBLASGUIDE,psblas_00} Parallel Sparse BLAS is \item[PSBLAS] \cite{PSBLASGUIDE,psblas_00} Parallel Sparse BLAS is
available from \\ \verb|http://www.ce.uniroma2.it/psblas|; version available from \\ \verb|http://www.ce.uniroma2.it/psblas|; version
3.0 (or later) is required. Indeed, all the prerequisites 3.1 (or later) is required. Indeed, all the prerequisites
listed so far are also prerequisites of PSBLAS. listed so far are also prerequisites of PSBLAS.
\end{description} \end{description}
Please note that the four previous libraries must have Fortran Please note that the four previous libraries must have Fortran
@ -87,9 +87,9 @@ be specified with an {\em absolute} path).
The full set of options may be looked at by issuing the command The full set of options may be looked at by issuing the command
\verb|./configure --help|, which produces: \verb|./configure --help|, which produces:
\begin{verbatim} \begin{verbatim}
`configure' configures MLD2P4 1.1 to adapt to many kinds of systems. `configure' configures MLD2P4 2.0 to adapt to many kinds of systems.
Usage: ./configure [OPTION]... [VAR=VALUE]... Usage: ../../configure [OPTION]... [VAR=VALUE]...
To assign environment variables (e.g., CC, CFLAGS...), specify them as To assign environment variables (e.g., CC, CFLAGS...), specify them as
VAR=VALUE. See below for descriptions of some of the useful variables. VAR=VALUE. See below for descriptions of some of the useful variables.
@ -101,7 +101,7 @@ Configuration:
--help=short display options specific to this package --help=short display options specific to this package
--help=recursive display the short help of all the included packages --help=recursive display the short help of all the included packages
-V, --version display version information and exit -V, --version display version information and exit
-q, --quiet, --silent do not print `checking...' messages -q, --quiet, --silent do not print `checking ...' messages
--cache-file=FILE cache test results in FILE [disabled] --cache-file=FILE cache test results in FILE [disabled]
-C, --config-cache alias for `--cache-file=config.cache' -C, --config-cache alias for `--cache-file=config.cache'
-n, --no-create do not create output files -n, --no-create do not create output files
@ -109,9 +109,9 @@ Configuration:
Installation directories: Installation directories:
--prefix=PREFIX install architecture-independent files in PREFIX --prefix=PREFIX install architecture-independent files in PREFIX
[/usr/local] [/usr/local]
--exec-prefix=EPREFIX install architecture-dependent files in EPREFIX --exec-prefix=EPREFIX install architecture-dependent files in EPREFIX
[PREFIX] [PREFIX]
By default, `make install' will install all the files in By default, `make install' will install all the files in
`/usr/local/bin', `/usr/local/lib' etc. You can specify `/usr/local/bin', `/usr/local/lib' etc. You can specify
@ -121,25 +121,32 @@ for instance `--prefix=$HOME'.
For better control, use the options below. For better control, use the options below.
Fine tuning of the installation directories: Fine tuning of the installation directories:
--bindir=DIR user executables [EPREFIX/bin] --bindir=DIR user executables [EPREFIX/bin]
--sbindir=DIR system admin executables [EPREFIX/sbin] --sbindir=DIR system admin executables [EPREFIX/sbin]
--libexecdir=DIR program executables [EPREFIX/libexec] --libexecdir=DIR program executables [EPREFIX/libexec]
--sysconfdir=DIR read-only single-machine data [PREFIX/etc] --sysconfdir=DIR read-only single-machine data [PREFIX/etc]
--sharedstatedir=DIR modifiable architecture-independent data [PREFIX/com] --sharedstatedir=DIR modifiable architecture-independent data [PREFIX/com]
--localstatedir=DIR modifiable single-machine data [PREFIX/var] --localstatedir=DIR modifiable single-machine data [PREFIX/var]
--libdir=DIR object code libraries [EPREFIX/lib] --libdir=DIR object code libraries [EPREFIX/lib]
--includedir=DIR C header files [PREFIX/include] --includedir=DIR C header files [PREFIX/include]
--oldincludedir=DIR C header files for non-gcc [/usr/include] --oldincludedir=DIR C header files for non-gcc [/usr/include]
--datarootdir=DIR read-only arch.-independent data root [PREFIX/share] --datarootdir=DIR read-only arch.-independent data root [PREFIX/share]
--datadir=DIR read-only architecture-independent data [DATAROOTDIR] --datadir=DIR read-only architecture-independent data [DATAROOTDIR]
--infodir=DIR info documentation [DATAROOTDIR/info] --infodir=DIR info documentation [DATAROOTDIR/info]
--localedir=DIR locale-dependent data [DATAROOTDIR/locale] --localedir=DIR locale-dependent data [DATAROOTDIR/locale]
--mandir=DIR man documentation [DATAROOTDIR/man] --mandir=DIR man documentation [DATAROOTDIR/man]
--docdir=DIR documentation root [DATAROOTDIR/doc/mld2p4] --docdir=DIR documentation root [DATAROOTDIR/doc/mld2p4]
--htmldir=DIR html documentation [DOCDIR] --htmldir=DIR html documentation [DOCDIR]
--dvidir=DIR dvi documentation [DOCDIR] --dvidir=DIR dvi documentation [DOCDIR]
--pdfdir=DIR pdf documentation [DOCDIR] --pdfdir=DIR pdf documentation [DOCDIR]
--psdir=DIR ps documentation [DOCDIR] --psdir=DIR ps documentation [DOCDIR]
Optional Features:
--disable-option-checking ignore unrecognized --enable/--with options
--disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no)
--enable-FEATURE[=ARG] include FEATURE [ARG=yes]
--enable-serial Specify whether to enable a fake mpi library to run
in serial mode.
Optional Packages: Optional Packages:
--with-PACKAGE[=ARG] use PACKAGE [ARG=yes] --with-PACKAGE[=ARG] use PACKAGE [ARG=yes]
@ -149,27 +156,18 @@ Optional Packages:
--with-libs List additional link flags here. For example, --with-libs List additional link flags here. For example,
--with-libs=-lspecial_system_lib or --with-libs=-lspecial_system_lib or
--with-libs=-L/path/to/libs --with-libs=-L/path/to/libs
--with-clibs additional CLIBS flags to be added: will prepend
to CLIBS
--with-flibs additional FLIBS flags to be added: will prepend
to FLIBS
--with-library-path additional LIBRARYPATH flags to be added: will
prepend to LIBRARYPATH
--with-include-path additional INCLUDEPATH flags to be added: will
prepend to INCLUDEPATH
--with-module-path additional MODULE_PATH flags to be added: will
prepend to MODULE_PATH
--with-umfpack=LIBNAME Specify the library name for UMFPACK library. --with-umfpack=LIBNAME Specify the library name for UMFPACK library.
Default: "-lumfpack -lamd" Default: "-lumfpack -lamd"
--with-umfpackdir=DIR Specify the directory for UMFPACK library and --with-umfpackdir=DIR Specify the directory for UMFPACK library and
includes. includes.
--with-superlu=LIBNAME Specify the library name for SUPERLU library. --with-superlu=LIBNAME Specify the library name for SUPERLU library.
Default: "-lslu" Default: "-lsuperlu"
--with-superludir=DIR Specify the directory for SUPERLU library and --with-superludir=DIR Specify the directory for SUPERLU library and
includes. includes.
--with-superludist=LIBNAME --with-superludist=LIBNAME
Specify the libname for SUPERLUDIST library. Specify the libname for SUPERLUDIST library.
Requires you also specify SuperLU. Default: "-lslud" Requires you also specify SuperLU. Default:
"-lsuperlu_dist"
--with-superludistdir=DIR --with-superludistdir=DIR
Specify the directory for SUPERLUDIST library and Specify the directory for SUPERLUDIST library and
includes. includes.
@ -182,10 +180,14 @@ Some influential environment variables:
LIBS libraries to pass to the linker, e.g. -l<library> LIBS libraries to pass to the linker, e.g. -l<library>
CC C compiler command CC C compiler command
CFLAGS C compiler flags CFLAGS C compiler flags
CPPFLAGS C/C++/Objective C preprocessor flags, e.g. -I<include dir> if CPPFLAGS (Objective) C/C++ preprocessor flags, e.g. -I<include dir> if
you have headers in a nonstandard directory <include dir> you have headers in a nonstandard directory <include dir>
CPP C preprocessor CPP C preprocessor
MPICC MPI C compiler command MPICC MPI C compiler command
F77 Fortran 77 compiler command
FFLAGS Fortran 77 compiler flags
MPIF77 MPI Fortran 77 compiler command
MPIFC MPI Fortran compiler command
Use these variables to override the choices made by `configure' or to help Use these variables to override the choices made by `configure' or to help
it to find libraries and programs with nonstandard names/locations. it to find libraries and programs with nonstandard names/locations.
@ -193,12 +195,12 @@ it to find libraries and programs with nonstandard names/locations.
Report bugs to <bugreport@mld2p4.it>. Report bugs to <bugreport@mld2p4.it>.
\end{verbatim} \end{verbatim}
Thus, a sample build with libraries in installation Thus, a sample build with libraries in installation
directories specifics to the GNU 4.3 compiler suite might be as directories specifics to the GNU 4.7 compiler suite might be as
follows, specifying only the UMFPACK external package: follows, specifying only the UMFPACK external package:
\begin{verbatim} \begin{verbatim}
./configure --with-psblas=/home/user/psblas-3.0/ \ ./configure --with-psblas=/home/user/psblas-3.1/ \
--with-libs="-L/usr/local/BLAS/gnu46" \ --with-libs="-L/usr/local/BLAS/gnu47" \
--with-umfpackdir=/usr/local/UMFPACK/gnu46 --with-umfpackdir=/usr/local/UMFPACK/gnu47
\end{verbatim} \end{verbatim}
Once the configure script has completed execution, it will have Once the configure script has completed execution, it will have
generated the file \verb|Make.inc| which will then be used by all generated the file \verb|Make.inc| which will then be used by all

@ -127,7 +127,7 @@ based on PSBLAS}
\flushright \flushright
\large Software version: 2.0-beta\\ \large Software version: 2.0-beta\\
%\today %\today
\large March 13, 2013 \large June 14, 2013
\end{minipage}} \end{minipage}}
%\addtolength{\textwidth}{\centeroffset} %\addtolength{\textwidth}{\centeroffset}
\vspace{\stretch{2}} \vspace{\stretch{2}}

@ -104,7 +104,7 @@ based on PSBLAS}\\[3ex]
%\today %\today
Software version: 2.0-beta\\ Software version: 2.0-beta\\
%\today %\today
March 13, 2013 June 14, 2013
\clearpage \clearpage
\ \\ \ \\
\thispagestyle{empty} \thispagestyle{empty}

Loading…
Cancel
Save