From e6ec7318d6ec16f2fd09800ba03715410e0b8c99 Mon Sep 17 00:00:00 2001 From: heister Date: Wed, 12 Feb 2014 22:25:48 +0000 Subject: [PATCH] improve documentation git-svn-id: https://svn.dealii.org/trunk@32463 0785d39b-7218-0410-832d-ea1e28bc413d --- deal.II/include/deal.II/grid/tria_accessor.h | 18 +++++++++++++----- 1 file changed, 13 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 7ff6297f2c..9822d047ba 100644 --- a/deal.II/include/deal.II/grid/tria_accessor.h +++ b/deal.II/include/deal.II/grid/tria_accessor.h @@ -2598,10 +2598,17 @@ public: */ /** - * Return the @p - * RefinementCase this cell - * was flagged to be refined - * with. + * Return the @p RefinementCase this cell was flagged to be refined + * with. + * The return value of this function can be compared to a bool to check if this cell is flagged + * for any kind of refinement. For example, after calling cell->set_refine_flag() + * this code will go into the if statement: + * @code + * if (cell->refine_flag_set()) + * { + * // yes, this cell is marked for refinement. + * } + * @endcode */ RefinementCase refine_flag_set () const; @@ -2609,7 +2616,8 @@ public: * Flag the cell pointed to for * refinement. This function is * only allowed for active - * cells. + * cells. Keeping the default value for @p ref_case will mark this cell for + * isotropic refinement. */ void set_refine_flag (const RefinementCase ref_case = RefinementCase::isotropic_refinement) const; -- 2.39.5