From 64ebcfac8835bdf69d86e0b3d49d23d72df49146 Mon Sep 17 00:00:00 2001 From: Wolfgang Bangerth Date: Fri, 27 May 2016 18:31:19 -0500 Subject: [PATCH] Address Denis Davydov's comments on the pull request. --- include/deal.II/fe/fe_tools.h | 21 +++++++++++++-------- 1 file changed, 13 insertions(+), 8 deletions(-) diff --git a/include/deal.II/fe/fe_tools.h b/include/deal.II/fe/fe_tools.h index dec736768a..31227841ad 100644 --- a/include/deal.II/fe/fe_tools.h +++ b/include/deal.II/fe/fe_tools.h @@ -841,8 +841,12 @@ namespace FETools /** - * A namespace that contains functions that help build more - * complex finite elements from simpler ("base") elements. + * A namespace that contains functions that help setting up internal + * data structures when implementing FiniteElement which are build + * from simpler ("base") elements, for example FESystem. The things + * computed by these functions typically serve as constructor + * arguments to the FiniteElement base class of the derived finite + * element object being constructed. * * There are generally two ways in which one can build more complex * elements, and this is reflected by several of the functions in @@ -899,12 +903,13 @@ namespace FETools * * The element constructed above of course no longer has a linearly * independent set of shape functions. As a consequence, any matrix - * one creates by treating all shape functions the same will be - * singular. In practice, this strategy is therefore typically used - * in situations where one explicitly makes sure that certain shape - * functions are treated differently (e.g., by multiplying them with - * weight factors), or in cases where the shape functions one - * combines are not linearly dependent. + * one creates by treating all shape functions of the composed + * element in the same way will be singular. In practice, this + * strategy is therefore typically used in situations where one + * explicitly makes sure that certain shape functions are treated + * differently (e.g., by multiplying them with weight functions), or + * in cases where the shape functions one combines are not linearly + * dependent. * * */ -- 2.39.5