From: Wolfgang Bangerth Date: Sun, 6 Mar 2022 03:16:58 +0000 (-0700) Subject: Minor doc adjustments. X-Git-Tag: v9.4.0-rc1~409^2 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F13495%2Fhead;p=dealii.git Minor doc adjustments. --- diff --git a/include/deal.II/base/quadrature_lib.h b/include/deal.II/base/quadrature_lib.h index 6832c428a1..d58afc17ec 100644 --- a/include/deal.II/base/quadrature_lib.h +++ b/include/deal.II/base/quadrature_lib.h @@ -588,6 +588,9 @@ public: * * No transformation is applied to the weights, and the weights referring to * points that live outside the reference simplex are simply discarded. + * Because this leads to (or *may* lead to) a sum of quadrature weights that + * do not equal the area of the simplex, the resulting quadrature formula + * is not useful for actually computing integrals. * * The main use of this quadrature formula is not to chop tensor product * quadratures. Ideally you should pass to this class a quadrature formula diff --git a/include/deal.II/grid/reference_cell.h b/include/deal.II/grid/reference_cell.h index 53beb6fb7b..8bc55b156a 100644 --- a/include/deal.II/grid/reference_cell.h +++ b/include/deal.II/grid/reference_cell.h @@ -205,9 +205,16 @@ public: /** * Return a quadrature rule with the support points of the given reference - * cell. + * cell. For 1d line segments, this corresponds to the quadrature points + * of the trapezoidal rule, which by taking tensor products easily + * generalizes also to other hypercube elements (see also QTrapezoid). + * For all reference cell shapes, the quadrature points are ordered + * in the same order as the vertices of the reference cell. * - * @note The weights of the quadrature object are left unfilled. + * @note The weights of the quadrature object are left unfilled and + * consequently the object cannot usefully be used for actually + * computing integrals. This is in contrast to, for example, the QTrapez + * class that correctly sets quadrature weights. */ template const Quadrature &