From: Toby D. Young Date: Sun, 7 Mar 2010 12:47:29 +0000 (+0000) Subject: Documentation of the previous patch: Changes in PETSc detect. X-Git-Tag: v8.0.0~6371 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=49bb65c0c47f5215ce1ff625f7984fff2688461b;p=dealii.git Documentation of the previous patch: Changes in PETSc detect. git-svn-id: https://svn.dealii.org/trunk@20744 0785d39b-7218-0410-832d-ea1e28bc413d --- 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.