]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Documentation of the previous patch: Changes in PETSc detect.
authorToby D. Young <tyoung@ippt.pan.pl>
Sun, 7 Mar 2010 12:47:29 +0000 (12:47 +0000)
committerToby D. Young <tyoung@ippt.pan.pl>
Sun, 7 Mar 2010 12:47:29 +0000 (12:47 +0000)
git-svn-id: https://svn.dealii.org/trunk@20744 0785d39b-7218-0410-832d-ea1e28bc413d

deal.II/doc/news/changes.h
deal.II/doc/readme-petsc-trilinos.html
deal.II/doc/readme.html

index 97824207521b89dcd7d4cd0fb1123c2c70c2dbea..d782f6bcff96569045787416a71c1275c972cd11 100644 (file)
@@ -30,6 +30,20 @@ inconvenience this causes.
 </p>
 
 <ol>
+  <li>
+  <p>
+  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.
+  <br>
+  (Toby D. Young 2010/03/06)
+  </p>
+
   <li>
   <p>
   Removed: The class TrilinosWrappers::PreconditionStokes has been deleted
index 1028abf70fb93c4ae03486b217bec1616d1c8cbf..da31da8bb33594c4aff7602a2870018c336fe636 100644 (file)
@@ -44,7 +44,6 @@
       on MPI since the native deal.II linear algebra classes lack this ability.
       </p>
 
-
       <h3>Configuring the interfaces to PETSc and Trilinos</h3>
 
       <p>
@@ -55,7 +54,6 @@
       packages: 
       </p>
 
-
       <h5>PETSc</h5>
       
       <p>
       environment variables <code>PETSC_DIR</code> and <code>PETSC_ARCH</code>
       to a path to PETSc and denoting the architecture for which PETSc is
       compiled. If these environment variables are set, then
-      <acronym>deal.II</acronym> will pick them up during configuration, and
-      store them. It will then also recognize that PETSc shall be used, and
-      enable the wrapper classes. 
+      <acronym>deal.II</acronym> will pick them up during
+      configuration, and store them. It will then also recognize that
+      PETSc shall be used, and enable the wrapper classes.
       </p>
 
       <p>
       Alternatively, the <code>--with-petsc=DIR</code> and
       <code>--with-petsc-arch=ARCH</code> switches to
       <code>./configure</code> can be used to override the values
-      of <code>PETSC_DIR</code> and <code>PETSC_ARCH</code> or if these
-      environment variables are not set at all. If you do have a PETSc installation
-      and have set the <code>PETSC_DIR</code> and
+      of <code>PETSC_DIR</code> and <code>PETSC_ARCH</code> or if
+      these environment variables are not set at all. If you do have a
+      PETSc installation and have set the <code>PETSC_DIR</code> and
       <code>PETSC_ARCH</code> environment variables but do not wish
       <acronym>deal.II</acronym> to be configured for PETSc use, you
       should specify <code>--with-petsc=no</code> as a flag during
 
       <p>
       Note that in order to use PETSc with <acronym>deal.II</acronym>
-      with the current version of <acronym>deal.II</acronym>, you
-      need to have at least PETSc version 2.3.1
-      installed. <acronym>deal.II</acronym> version 6.0 has been
-      tested up to PETSc release 2.3.3-p4.
+      with the current version of <acronym>deal.II</acronym> you will
+      need to have at least PETSc version 2.3.0 installed, earlier
+      releases are no longer supported. <acronym>deal.II</acronym>
+      version 6.2 has been tested up to PETSc release 3.0.0-p11.
       </p>
 
       <p>
-      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 <a
-      href="http://www-dimat.unipv.it/heltai/wikideal/index.php/Deal.II_Questions_and_Answers"
-      target="_top">Frequently Asked Questions page</a>, as well as
-      <a
-      href="http://ganymed.iwr.uni-heidelberg.de/pipermail/dealii/2007/001820.html">in
-      this posting to the mailing list</a>. 
+      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 <acronym>deal.II</acronym>
+      using the
+      <code>--disable-threads</code> switch to <code>./configure</code>.
       </p>
 
       <p>
-      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
-      <code>--disable-threads</code> switch to <code>./configure</code>.
+      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 <a href="http://www-dimat.unipv.it/heltai/wikideal/index.php/Deal.II_Questions_and_Answers"
+      target="_top">Frequently Asked Questions</a> page.
       </p>
 
-
       <h5>Trilinos</h5>
 
       <p>
@@ -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.
       </p>
-      
 
       <h6>Trilinos starting with version 10.0</h6>
 
@@ -162,7 +157,7 @@ make install
       the following slightly longish set of commands:
       <code>
       <pre>
-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 <code>TPL_ENABLE_MPI</code> flag above.
       </p>
 
-
       <h3>Configuring for installed Trilinos packages</h3>
 
       <p>
index d4f8c5b227f0769b436bba2162042b6873ae1d94..259ee55ab30bae9d181e543617547d2076ec8d8f 100644 (file)
     <dt>Petsc</dt>
     <dd>
       <p>
-      <acronym>deal.II</acronym> can interface to the <a
-      href="http://www.mcs.anl.gov/petsc/" target="_top">PETSc</a>
-      library. The simplest way to do so is to set the <code>PETSC_DIR</code>
-      and <code>PETSC_ARCH</code> environment variables. More information and
-      configuration options can be found <a href="readme-petsc-trilinos.html"
+      <acronym>deal.II</acronym> can interface to
+      the <a href="http://www.mcs.anl.gov/petsc/"
+      target="_top">PETSc</a> library. The simplest way to do so is to
+      set the <code>PETSC_DIR</code> and <code>PETSC_ARCH</code>
+      environment variables. More information and configuration
+      options can be found by issuing <code>./configure --help</code>
+      at the command line, or, <a href="readme-petsc-trilinos.html"
       target="body">here</a>.
       </p>
     </dd>

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.