From: Wolfgang Bangerth <bangerth@colostate.edu>
Date: Sun, 19 Mar 2023 22:38:33 +0000 (-0600)
Subject: Update description of UpdateFlags::update_quadrature_points.
X-Git-Tag: v9.5.0-rc1~458^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F14916%2Fhead;p=dealii.git

Update description of UpdateFlags::update_quadrature_points.
---

diff --git a/include/deal.II/fe/fe_update_flags.h b/include/deal.II/fe/fe_update_flags.h
index 14ce6435f8..3caf07cbba 100644
--- a/include/deal.II/fe/fe_update_flags.h
+++ b/include/deal.II/fe/fe_update_flags.h
@@ -114,8 +114,16 @@ enum UpdateFlags
    * flag to the FEValues constructor to make sure you can later
    * access them.
    *
-   * In the context of DataPostprocessor,
-   * DataPostprocessorInputs::CommonInputs::evaluation_points will be updated.
+   * There are contexts other than FEValues (and related classes) that
+   * take update flags. An example is the DataPostprocessor class
+   * (and derived classes). In these cases, the `update_quadrature_points`
+   * flag is generally understood to update the location of "evaluation
+   * points", i.e., the physical locations of the points at which
+   * the solution is evaluated. As a consequence, the flag is
+   * misnamed in these contexts: No quadrature (i.e., computation of
+   * integrals) is involved, and consequently what is being
+   * updated is, in the context of DataPostprocessor, the member variable
+   * DataPostprocessorInputs::CommonInputs::evaluation_points.
    */
   update_quadrature_points = 0x0020,
   //! Transformed quadrature weights