From: Wolfgang Bangerth Date: Mon, 14 Jul 2014 22:08:41 +0000 (+0000) Subject: Clarify a piece of documentation that was pretty much unintelligible before. X-Git-Tag: v8.2.0-rc1~301 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=20bc4c60cc8a5dc68f9350f7955ce6549cc5d13c;p=dealii.git Clarify a piece of documentation that was pretty much unintelligible before. git-svn-id: https://svn.dealii.org/trunk@33171 0785d39b-7218-0410-832d-ea1e28bc413d --- diff --git a/deal.II/include/deal.II/base/data_out_base.h b/deal.II/include/deal.II/base/data_out_base.h index fe2be969d1..885577d9de 100644 --- a/deal.II/include/deal.II/base/data_out_base.h +++ b/deal.II/include/deal.II/base/data_out_base.h @@ -303,21 +303,22 @@ namespace DataOutBase Table<2,float> data; /** - * Bool flag indicating, whether the coordinates of the inner - * patch points are appended to the @p data table (@p true) or not - * (@p false), where the second is the standard and can be found - * for all cells in the interior of a domain. + * A flag indicating whether the coordinates of the interior patch points + * (assuming that the patch is supposed to be subdivided further) are + * appended to the @p data table (@p true) or not (@p false). The latter + * is the default and in this case the locations of the points interior to + * this patch are computed by (bi-, tri-)linear interpolation from the + * vertices of the patch. * - * On the boundary of a domain, patch points are evaluated using a - * Mapping and therefore have to be stored inside the patch, as - * the Mapping and the corresponding boundary information are no - * longer available later on when we actually write the patch out - * to an output stream. + * This option exists since patch points may be evaluated using a Mapping + * (rather than by a linear interpolation) and therefore have to be stored + * in the Patch structure. */ bool points_are_available; /** - * Default constructor. Sets #n_subdivisions to one. + * Default constructor. Sets #n_subdivisions to one, #points_are_available + * to false, and #patch_index to #no_neighbor. */ Patch ();