[petsc] 02/08: update 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 petsc.

commit bbfae3871d89707c9205365034c220f0c57d2264
Author: Drew Parsons <dparsons at debian.org>
Date:   Sun Oct 4 12:35:52 2015 +0800

    update README.Debian
    
    add reference to pkg-config
---
 debian/README.Debian | 46 +++++++++++++++++++++++++++-------------------
 1 file changed, 27 insertions(+), 19 deletions(-)

diff --git a/debian/README.Debian b/debian/README.Debian
index a3af787..9e6a726 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -2,36 +2,32 @@
                       PETSc Debian Package Description
                       --------------------------------
 
-For up-to-date information about the package, its issues, and future plans,
-please see: http://lyre.mit.edu/~powell/petsc.html .  You can also look there
-for old versions of the package, in case you need to build something against a
-2.0.28 or 2.1.0 release (I keep the last package for each upstream version).
-
-This is upstream version 3.6.1.  We no longer include the upstream patch
-level in the Debian version number to minimize wasteful redistribution of
-99.99% identical .orig.tar.gz files for each release.
-
 INTRODUCTION
 
 This source package is distributed in five binary packages: the shared
-libraries are in libpetsc3.6.1; header files, static libraries, the petscarch
-and mpirun_lam scripts and important files for building examples are in
-libpetsc3.6.1-dev, this also sets up various alternatives links; debugging
-static libraries are in libpetsc3.6.1-dbg; extensive documentation and source
-code from "tests" and "tutorials" directories are in petsc3.6.1-doc.
+libraries are in libpetsc3.6; header files, static libraries  and important 
+files for building examples are in libpetsc3.6.1-dev, this also sets up 
+various alternatives links; debugging libraries are in libpetsc3.6.1-dbg; 
+extensive documentation and source code from "tests" and "tutorials" 
+directories are in petsc3.6.1-doc.
+
+The preferred PETSc installation is located at /usr/lib/petsc. This is a symlink
+to the actual installation, managed by Debian alternatives (see below). The
+standard installation is located at 
+  /usr/lib/petscdir/<PETSC_VERSION>/<arch>-cxx-opt
+e.g.
+  /usr/lib/petscdir/3.6.1/x86_64-linux-gnu-cxx-opt
 
 With libpetsc3.6.1-dev installed, you can build programs against it two ways:
 
      1. Standard build convention: use -I/usr/include/petsc for headers and
 	link to optimized libraries in /usr/lib, so your resulting binaries
-	will only depend on libpetsc3.6.1.  To link against the static
-	debugging libs in libpetsc3.6.1-dbg, just set LD_LIBRARY_PATH to
-	/usr/lib/petsc/lib/libg/`petscarch`.
+	will only depend on libpetsc3.6.1.
      2. PETSc build convention: adapt a makefile from one of their tests or
 	tutorial directories and build with make PETSC_DIR=/usr/lib/petsc
-	PETSC_ARCH=`petscarch` PETSC_LIB_DIR=$PETSC_DIR/$PETSC_ARCH/lib .
+     3. Use pkg-config (via /usr/lib/pkgconfig/PETSC.pc).
 
-Of these, the latter is probably the easier one, as it automatically sets up
+Of these, the latter two are probably easier, as they automatically set up
 all of the include paths and library linkages for PETSc and its various
 dependencies.
 
@@ -55,6 +51,18 @@ consistently maintained.  If you file a bug report because of a failed example,
 I will forward it upstream and leave it open until it's fixed, but can't
 promise I'll try to fix it.
 
+DEBUGGING LIBRARY
+
+With libpetsc3.6.1-dbg installed, a debug version is available at
+  /usr/lib/petscdir/3.6.1/x86_64-linux-gnu-cxx-debug
+
+This library includes unstripped symbols and also has internal PETSc debugging
+switched on. It may be accessed
+1) by setting PETSC_DIR
+2) via the pkg-config file in
+  /usr/lib/petscdir/3.6.1/x86_64-linux-gnu-cxx-debug/lib/pkgconfig
+3) or by configuring as preferred alternative with update-alternatives.
+
 REPORTING BUGS and BUILDING FROM SOURCE
 
 Also, upstream does not maintain old versions of PETSc.  If you have trouble

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