SLEPc for Debian
----------------

This source package includes the following binary packages:

     libslepc-real3.17     - shared libraries (real number support)
     libslepc-real3.17-dev - static libraries, shared links, and header files
                             real number support (latest v3.17)
     libslepc3.17-dev-examples - examples
     slepc3.17-doc         - documentation

The following binary packages include support for complex numbers:
     libslepc-complex3.17
     libslepc-complex3.17-dev

slepc-dev installs the latest version (real number support).

With slepc-dev installed (or libslepc-real3.17-dev or libslepc-complex3.17-dev),
you can build programs against it two ways:

     1. Standard build convention: use -I/usr/include/slepc for headers and
	link to optimized libraries in /usr/lib, so your resulting binaries
	will only depend on libslepc3.17.
     2. PETSc/SLEPc build convention: modify the makefile from the one in
        their examples directory and build with

        PETSC_DIR=/usr/lib/petsc PETSC_ARCH=`petscarch` \
	  PETSC_LIB_DIR=$PETSC_DIR/$PETSC_ARCH/lib SLEPC_DIR=/usr/lib/slepc \
	  SLEPC_LIB_DIR=$SLEPC_DIR/$PETSC_ARCH/lib make

The libslepc3.17-dev-examples package comes with the SLEPc examples in
/usr/share/doc/libslepc3.17-dev-examples/examples/
Copy as needed and use the PETSc/SLEPc build convention make command
above.

See also README.Debian in the PETSc package for more related notes.

Alternative SLEPc Versions
--------------------------

The preferred version of SLEPc (real or complex, the preferred minor
patch version) can be controlled using alternatives:
   update-alternatives --config slepc
(other slepc alternatives are listed below)
Or PETSC_DIR and SLEPC_DIR can be set to the preferred version located under
/usr/lib/petscdir and /usr/lib/slepcdir.

The full set of SLEPc alternatives is:

slepc   - set the default version (real or complex) of SLEPc (/usr/lib/slepc)

libslepc_real.so
        - set the default SLEPc shared library with real number support

libslepc_complex.so
        - set the default SLEPc shared library with complex number support

slepc3.17
        - set the preferred version (real or complex) of SLEPc 3.17
          (/usr/lib/slepcdir/3.17)

libslepc.so.3.17
        - set the preferred version (real or complex) for the
          shared library of SLEPc 3.17

(likewise for other major versions in place of 3.17)


===== 64-bit indexing =====

Support for 64-bit indexing is provided in libslepc64* packages.
This enables SLEPc to be used on larger systems with more than
2 billion elements.
