[slepc] 01/01: document alternatives in README.Debian

[Drew Parsons]

This is an automated email from the git hooks/post-receive script.

dparsons pushed a commit to branch master
in repository slepc.

commit dbebaa5fb7f5cfbbc6e1a3f5ca05b1dd13e3d656
Author: Drew Parsons <dparsons at debian.org>
Date:   Fri Jun 3 18:11:00 2016 +0800

    document alternatives in README.Debian
---
 debian/README.Debian | 62 ++++++++++++++++++++++++++++++++++++++++------------
 1 file changed, 48 insertions(+), 14 deletions(-)

diff --git a/debian/README.Debian b/debian/README.Debian
index cb93059..ef242d1 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -1,14 +1,8 @@
 SLEPc for Debian
 ----------------
 
-This source package includes the following binary packages:
-
-     libslepc3.2      - shared libraries
-     libslepc3.2-dev  - static libraries, shared links, and header files
-     libslepc3.2-dbg  - static debugging libraries
-     slepc3.2-doc     - documentation and examples
-
-With libslepc3.2-dev installed, you can build programs against it two ways:
+With slepc-dev installed (or libslepc3.6-dev, or libslepc-real-3.6.3-dev 
+or libslepc-complex-3.6.3-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
@@ -22,12 +16,52 @@ With libslepc3.2-dev installed, you can build programs against it two ways:
 	  PETSC_LIB_DIR=$PETSC_DIR/$PETSC_ARCH/lib SLEPC_DIR=/usr/lib/slepc \
 	  SLEPC_LIB_DIR=$SLEPC_DIR/$PETSC_ARCH/lib make
 
-The slepc3.2-doc package comes with the full source code of the SLEPc
-examples. Just do:
+The slepc3.6.3-doc package comes with the SLEPc examples in 
+/usr/share/doc/slepc3.6.3-doc/examples/ 
+Copy as needed and use the PETSc/SLEPc build convention make command 
+above.
+
+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.
 
-	tar xzf /usr/share/doc/slepc3.2-doc/src.tar.gz
+See also README.Debian in the PETSc package for more related notes.
 
-then cd src/examples, and use the PETSc/SLEPc build convention make command 
-above.
+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.6
+        - set the preferred minor patch version (real or complex) of SLEPc 3.6
+          (/usr/lib/slepcdir/3.6)
+        
+slepc3.6-real
+        - set the preferred minor patch version of SLEPc 3.6
+          with real number support (/usr/lib/slepcdir/3.6-real)
+
+slepc3.6-complex
+        - set the preferred minor patch version of SLEPc 3.6
+          with complex number support (/usr/lib/slepcdir/3.6-complex)
+
+libslepc.so.3.6
+        - set the preferred minor patch version (real or complex) for the
+          shared library of SLEPc 3.6
+ 
+libslepc_real.so.3.6
+        - set the preferred minor patch version for the shared library
+          of SLEPc 3.6 with real number support
+
+libslepc_complex.so.so.3.6
+        - set the preferred minor patch version for the shared library
+          of SLEPc 3.6 with complex number support
 
-See also README.Debian in the PETSc package for more releated notes.
+(likewise for other major versions in place of 3.6)

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-science/packages/slepc.git