From: Martin Kronbichler Date: Thu, 18 Jul 2024 11:47:41 +0000 (+0200) Subject: Improve documentation of FEEvaluation::submit_xxx() X-Git-Tag: v9.6.0-rc1~76^2 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3c8803b3b6cc3e9ce62f384761f97e4653b2a05d;p=dealii.git Improve documentation of FEEvaluation::submit_xxx() --- diff --git a/include/deal.II/matrix_free/fe_evaluation.h b/include/deal.II/matrix_free/fe_evaluation.h index ce37a8927f..78ddb7e298 100644 --- a/include/deal.II/matrix_free/fe_evaluation.h +++ b/include/deal.II/matrix_free/fe_evaluation.h @@ -429,7 +429,8 @@ public: * further information. * * @note This operation writes the data to the same field as - * submit_gradient(). As a consequence, only one of these two can be + * submit_gradient(), submit_divergence(), submit_symmetric_gradient() and + * submit_curl(). As a consequence, only one of these functions can be * used. Usually, the contribution of a potential call to this function must * be added into the contribution for submit_gradient() when both are * desired. Furthermore, the data array is the same as for get_gradient() @@ -504,11 +505,12 @@ public: * @note Only available for the vector-valued case (n_components == dim). * * @note This operation writes the data to the same field as - * submit_gradient() or submit_divergence(). As a consequence, only one of - * these three can be used. In case several terms of this kind appear in a - * weak form, the contribution of a potential call to this function must be - * added into the diagonal of the rank-2 tensor contribution passed to - * submit_gradient(). + * submit_gradient(), submit_normal_derivative(), + * submit_symmetric_gradient() and submit_curl(). As a consequence, only one + * of these functions can be used. In case several terms of this kind appear + * in a weak form, the contribution of a potential call to this function + * must be added into the diagonal of the rank-2 tensor contribution passed + * to submit_gradient(). */ template > void @@ -535,12 +537,12 @@ public: * @note Only available for the vector-valued case (n_components == dim). * * @note This operation writes the data to the same field as - * submit_gradient() or submit_divergence(). As a consequence, only one of - * these three functions can be used. In case several terms of this kind - * appear in a weak form, the contribution of a potential call to this - * function must be added into the diagonal of the rank-2 tensor - * contribution passed to submit_gradient(), in order not to overwrite - * information. + * submit_gradient(), submit_normal_derivative(), submit_divergence() and + * submit_curl(). As a consequence, only one of these functions can be + * used. In case several terms of this kind appear in a weak form, the + * contribution of a potential call to this function must be added into the + * diagonal of the rank-2 tensor contribution passed to submit_gradient(), + * in order not to overwrite information. */ template > void @@ -568,10 +570,11 @@ public: * @note Only available for the vector-valued case (n_components == dim). * * @note This operation writes the data to the same field as - * submit_gradient() and submit_divergence(). As a consequence, only one of - * these can be used. Usually, the contribution of a potential call to this - * function must be added to the respective entries of the rank-2 tensor for - * submit_gradient(). + * submit_gradient(), submit_normal_derivative(), submit_divergence() and + * submit_symmetric_gradient(). As a consequence, only one of these + * functions can be used. Usually, the contribution of a potential call to + * this function must be added to the respective entries of the rank-2 + * tensor for submit_gradient(). */ template >