From 49bb65c0c47f5215ce1ff625f7984fff2688461b Mon Sep 17 00:00:00 2001 From: "Toby D. Young" Date: Sun, 7 Mar 2010 12:47:29 +0000 Subject: [PATCH] Documentation of the previous patch: Changes in PETSc detect. git-svn-id: https://svn.dealii.org/trunk@20744 0785d39b-7218-0410-832d-ea1e28bc413d --- deal.II/doc/news/changes.h | 14 ++++++++ deal.II/doc/readme-petsc-trilinos.html | 50 ++++++++++++-------------- deal.II/doc/readme.html | 12 ++++--- 3 files changed, 43 insertions(+), 33 deletions(-) diff --git a/deal.II/doc/news/changes.h b/deal.II/doc/news/changes.h index 9782420752..d782f6bcff 100644 --- a/deal.II/doc/news/changes.h +++ b/deal.II/doc/news/changes.h @@ -30,6 +30,20 @@ inconvenience this causes.

    +
  1. +

    + Removed: The interface to PETSc has been simplified to better handle + incremental changes in PETSc versions and accomodate changes in + functionality between versions. As a part of this process, the + deal.II configure script no longer handles PETSc versions + <2.3.0. Attempting to configure deal.II with PETSc versions that are + not supported will result in the error message, "Unknown PETSc + version". The usage of the PETScWrappers are otherwise not affected + by this change. +
    + (Toby D. Young 2010/03/06) +

    +
  2. Removed: The class TrilinosWrappers::PreconditionStokes has been deleted diff --git a/deal.II/doc/readme-petsc-trilinos.html b/deal.II/doc/readme-petsc-trilinos.html index 1028abf70f..da31da8bb3 100644 --- a/deal.II/doc/readme-petsc-trilinos.html +++ b/deal.II/doc/readme-petsc-trilinos.html @@ -44,7 +44,6 @@ on MPI since the native deal.II linear algebra classes lack this ability.

    -

    Configuring the interfaces to PETSc and Trilinos

    @@ -55,7 +54,6 @@ packages:

    -
    PETSc

    @@ -63,18 +61,18 @@ environment variables PETSC_DIR and PETSC_ARCH to a path to PETSc and denoting the architecture for which PETSc is compiled. If these environment variables are set, then - deal.II will pick them up during configuration, and - store them. It will then also recognize that PETSc shall be used, and - enable the wrapper classes. + deal.II will pick them up during + configuration, and store them. It will then also recognize that + PETSc shall be used, and enable the wrapper classes.

    Alternatively, the --with-petsc=DIR and --with-petsc-arch=ARCH switches to ./configure can be used to override the values - of PETSC_DIR and PETSC_ARCH or if these - environment variables are not set at all. If you do have a PETSc installation - and have set the PETSC_DIR and + of PETSC_DIR and PETSC_ARCH or if + these environment variables are not set at all. If you do have a + PETSc installation and have set the PETSC_DIR and PETSC_ARCH environment variables but do not wish deal.II to be configured for PETSc use, you should specify --with-petsc=no as a flag during @@ -83,31 +81,29 @@

    Note that in order to use PETSc with deal.II - with the current version of deal.II, you - need to have at least PETSc version 2.3.1 - installed. deal.II version 6.0 has been - tested up to PETSc release 2.3.3-p4. + with the current version of deal.II you will + need to have at least PETSc version 2.3.0 installed, earlier + releases are no longer supported. deal.II + version 6.2 has been tested up to PETSc release 3.0.0-p11.

    - Installing both PETSc and deal.II together can be a bit of a challenge. A - good summary of the relevant steps can be found on the Frequently Asked Questions page, as well as - in - this posting to the mailing list. + There is an additional caveat: PETSc appears not to co-operate + well when using threads and some programs crash when deal.II is + compiled in its usual mode supporting multithreading. If you see + this sort of behavior, we recommend to try disabling + multithreading upon configuration of deal.II + using the + --disable-threads switch to ./configure.

    - There is an additional caveat: PETSc appears not to co-operate well when using - threads and some programs crash when deal.II is compiled in its usual mode - supporting multithreading. If you see this sort of behavior, we - recommend to try disabling multithreading upon configuration of deal.II using the - --disable-threads switch to ./configure. + Installing both PETSc and deal.II together can be a bit of a + challenge. A good summary of the relevant steps can be found on + the Frequently Asked Questions page.

    -
    Trilinos

    @@ -151,7 +147,6 @@ make install Obviously the path names in the first line and at the end of the configure line need to be adjusted.

    -
    Trilinos starting with version 10.0
    @@ -162,7 +157,7 @@ make install the following slightly longish set of commands:
    -cd trilinos-9.0.2
    +cd trilinos-10.0.2
     mkdir build
     cd build
     cmake \
    @@ -206,7 +201,6 @@ make install
           flip the value of the TPL_ENABLE_MPI flag above.
           

    -

    Configuring for installed Trilinos packages

    diff --git a/deal.II/doc/readme.html b/deal.II/doc/readme.html index d4f8c5b227..259ee55ab3 100644 --- a/deal.II/doc/readme.html +++ b/deal.II/doc/readme.html @@ -565,11 +565,13 @@

    Petsc

    - deal.II can interface to the PETSc - library. The simplest way to do so is to set the PETSC_DIR - and PETSC_ARCH environment variables. More information and - configuration options can be found deal.II can interface to + the PETSc library. The simplest way to do so is to + set the PETSC_DIR and PETSC_ARCH + environment variables. More information and configuration + options can be found by issuing ./configure --help + at the command line, or, here.

    -- 2.39.5