From: Wolfgang Bangerth <bangerth@colostate.edu>
Date: Sat, 22 Jun 2024 03:14:23 +0000 (-0600)
Subject: Make some connections between classes.
X-Git-Tag: v9.6.0-rc1~163^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F17168%2Fhead;p=dealii.git

Make some connections between classes.
---

diff --git a/include/deal.II/lac/petsc_ts.h b/include/deal.II/lac/petsc_ts.h
index 908011c0fc..9266342c6c 100644
--- a/include/deal.II/lac/petsc_ts.h
+++ b/include/deal.II/lac/petsc_ts.h
@@ -228,8 +228,11 @@ namespace PETScWrappers
    *   \end{cases}
    * \f]
    *
-   * The interface to PETSc is realized by means of std::function callbacks
-   * like in the SUNDIALS::IDA and SUNDIALS::ARKode classes.
+   * The interface to PETSc is realized by means of std::function
+   * callbacks like in the SUNDIALS::IDA (which also solves implicit
+   * ODES) and SUNDIALS::ARKode classes (which solves a slightly
+   * generalized form of the explicit formulation above that also
+   * allows for a mass matrix on the left hand side).
    *
    * TimeStepper supports any vector and matrix type having constructors and
    * methods:
diff --git a/include/deal.II/sundials/ida.h b/include/deal.II/sundials/ida.h
index 059458c231..cece278c32 100644
--- a/include/deal.II/sundials/ida.h
+++ b/include/deal.II/sundials/ida.h
@@ -61,7 +61,8 @@ namespace SUNDIALS
    *
    * The class IDA is a wrapper to SUNDIALS Implicit Differential-Algebraic
    * solver which is a general purpose solver for systems of
-   * Differential-Algebraic Equations (DAEs).
+   * Differential-Algebraic Equations (DAEs). Another class that can solve
+   * this set of equations is PETScWrappers::TS.
    *
    * The user has to provide the implementation of the following std::functions:
    *  - reinit_vector;