From 991ce74d8d6c562520ec623ec35763850918ad30 Mon Sep 17 00:00:00 2001
From: Stefano Zampini <stefano.zampini@gmail.com>
Date: Wed, 17 Jul 2024 18:29:37 +0200
Subject: [PATCH] fix petsc installation readme

---
 doc/external-libs/petsc.html | 37 +++++++++---------------------------
 1 file changed, 9 insertions(+), 28 deletions(-)

diff --git a/doc/external-libs/petsc.html b/doc/external-libs/petsc.html
index a865d3fd41..8f8064b8f7 100644
--- a/doc/external-libs/petsc.html
+++ b/doc/external-libs/petsc.html
@@ -17,10 +17,10 @@
       target="_top">PETSc</a> is a
       software package that provides lots of functionality for linear
       algebra, among other things. For example, it includes implementations of a variety of
-      linear solvers, as well as various different sparse and dense matrix and
-      vector formats. Of particular interest to deal.II is their ability to
-      provide this functionality both on sequential and parallel (using MPI)
-      computers.
+      linear, nonlinear and ordinary differential equation solvers, as well as various
+      different sparse and dense matrix and vector formats. Of particular interest to
+      deal.II is their ability to provide this functionality both on sequential and
+      parallel (using MPI) computers.
     </p>
 
     <p>
@@ -30,17 +30,15 @@
       algebra classes. We use these interfaces for parallel computations based
       on MPI since the native deal.II linear algebra classes lack this
       ability. They are used, among other programs, in step-17, step-18 and
-      step-40.
+      step-40. See step-77 for an example that uses PETSc's nonlinear solver
+      capabilities.
     </p>
 
     <h4>Installing <acronym>deal.II</acronym> with PETSc</h4>
 
-    <p style="color: red"><b>Note:</b> The most recent version of PETSc
-      that has been reported to be compatible with
-      <acronym>deal.II</acronym> is version 3.17.1. If you use a later
-      version than this and encounter problems, let us
-      know. <acronym>deal.II</acronym> does not support versions of PETSc prior
-      to 3.7.0.
+    <p style="color: red"><b>Note:</b> <acronym>deal.II</acronym> is compatible
+      with any PETSc version newer than 3.7.0. If you encounter problems with a
+      specific version, let us know.
     </p>
 
     <p>
@@ -73,23 +71,6 @@
       during configuration.
     </p>
 
-    <p><b>Note:</b> <acronym>deal.II</acronym> can be installed with both
-      PETSc and Trilinos and they do not usually get in their
-      respective ways. There are, however, occasions where this is not true
-      and this fundamentally comes from the fact that both of these packages
-      are built from subpackages that are developed by independent
-      groups. Unfortunately, some of these sub-packages can be configured to
-      be part of both PETSc and Trilinos, and if you try to
-      use <acronym>deal.II</acronym> with versions of PETSc and Trilinos
-      that <i>both</i> contain a particular sub-package, little good will come
-      of it in general. In particular, we have experienced this with the ML
-      package that can serve as an algebraic multigrid method to both PETSc
-      and Trilinos. If both of these packages are configured to use ML, then
-      difficult to understand error messages at compile or link time are
-      almost inevitable, and there is little the <acronym>deal.II</acronym>
-      build system can do to prevent this. Thus, <i>don't try to do that!</i>
-    </p>
-
 
     <h4>Installing PETSc</h4>
 
-- 
2.39.5