From d995e95951544e6464dfdbd7bf02d456ce2b97df Mon Sep 17 00:00:00 2001 From: bangerth Date: Wed, 27 Mar 2013 13:59:55 +0000 Subject: [PATCH] Augment documentation. git-svn-id: https://svn.dealii.org/trunk@29069 0785d39b-7218-0410-832d-ea1e28bc413d --- deal.II/include/deal.II/grid/tria_accessor.h | 24 ++++++++++++++++---- 1 file changed, 19 insertions(+), 5 deletions(-) diff --git a/deal.II/include/deal.II/grid/tria_accessor.h b/deal.II/include/deal.II/grid/tria_accessor.h index 6a0e28e247..9f90da2345 100644 --- a/deal.II/include/deal.II/grid/tria_accessor.h +++ b/deal.II/include/deal.II/grid/tria_accessor.h @@ -1098,11 +1098,25 @@ public: * called on a face, then the * boundary indicator of the 4 * edges that bound the face - * remain unchanged. On the other - * hand, the boundary indicators - * of face and edges are all set - * at the same time using the - * current function. + * remain unchanged. In contrast, if you call the current function, + * the boundary indicators + * of face and edges are all set to the given value. + * + * This function is useful if you set boundary indicators of faces + * in 3d (in 2d, the function does the same as set_boundary_indicator()) + * and you do so because you want a curved boundary object to + * represent the part of the boundary that corresponds to the + * current face. In that case, the Triangulation class needs to figure + * out where to put new vertices upon mesh refinement, and higher order + * Mapping objects also need to figure out where new interpolation points + * for a curved boundary approximation should be. In either case, the + * two classes first determine where interpolation points on the edges + * of a boundary face should be, asking the boundary object, before + * asking the boundary object for the interpolation points corresponding + * to the interior of the boundary face. For this to work properly, it is + * not sufficient to have set the boundary indicator for the face alone, + * but you also need to set the boundary indicators of the edges that + * bound the face. This function does all of this at once. * * @ingroup boundary * -- 2.39.5