From: Wolfgang Bangerth Date: Fri, 27 May 2016 23:31:19 +0000 (-0500) Subject: Address Denis Davydov's comments on the pull request. X-Git-Tag: v8.5.0-rc1~1005^2 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=64ebcfac8835bdf69d86e0b3d49d23d72df49146;p=dealii.git Address Denis Davydov's comments on the pull request. --- 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. * * */