From: Peter Munch <peterrmuench@gmail.com>
Date: Wed, 15 Mar 2023 09:52:04 +0000 (+0100)
Subject: CellWiseInverse: extend comments
X-Git-Tag: v9.5.0-rc1~472^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a718375d04a74dd1c039d3e0731e1177b22abe2b;p=dealii.git

CellWiseInverse: extend comments
---

diff --git a/include/deal.II/matrix_free/evaluation_kernels.h b/include/deal.II/matrix_free/evaluation_kernels.h
index da52686722..5bc29954d8 100644
--- a/include/deal.II/matrix_free/evaluation_kernels.h
+++ b/include/deal.II/matrix_free/evaluation_kernels.h
@@ -5580,7 +5580,7 @@ namespace internal
 
 
   /**
-   * This struct implements the action of the inverse @ref GlossMassMatrix "mass matrix" operation
+   * This struct implements the action of the inverse @ref GlossMassMatrix "mass matrix" operation,
    * using an FEEvaluationData argument.
    */
   template <int dim, typename Number>
@@ -5698,7 +5698,9 @@ namespace internal
 
   /**
    * This struct implements the action of the inverse @ref GlossMassMatrix "mass matrix" operation
-   * using an FEEvaluationData argument.
+   * with user-provided coefficients at quadrature points (in contrast to
+   * CellwiseInverseMassMatrixImplBasic, which implicitly uses `1/(|J|xW)' as
+   * coefficient).
    */
   template <int dim, typename Number>
   struct CellwiseInverseMassMatrixImplFlexible
@@ -5784,8 +5786,10 @@ namespace internal
 
 
   /**
-   * This struct implements the action of the inverse @ref GlossMassMatrix "mass matrix" operation
-   * using an FEEvaluationData argument.
+   * This struct implements the action of a projection of the values given
+   * at the quadrature points to the support points,
+   * using an FEEvaluationData argument. For the derivation, see comments in
+   * step-67.
    */
   template <int dim, typename Number>
   struct CellwiseInverseMassMatrixImplTransformFromQPoints