From: Wolfgang Bangerth <bangerth@colostate.edu>
Date: Mon, 15 Oct 2018 21:24:20 +0000 (-0600)
Subject: Update comments of two functions.
X-Git-Tag: v9.1.0-rc1~611^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4a93ec686502255ef024af32ce6d8cc457960bf6;p=dealii.git

Update comments of two functions.

These functions were not individually documented. Fix this and make
clear what they do.
---

diff --git a/include/deal.II/hp/dof_handler.h b/include/deal.II/hp/dof_handler.h
index 6560d5646f..64f0d5360a 100644
--- a/include/deal.II/hp/dof_handler.h
+++ b/include/deal.II/hp/dof_handler.h
@@ -928,14 +928,23 @@ namespace hp
     create_active_fe_table();
 
     /**
-     * Functions that will be triggered through signals whenever the
-     * triangulation is modified.
+     * A function that will be triggered through a triangulation
+     * signal just before the triangulation is modified.
      *
-     * Here they are used to administrate the active_fe_fields during the
-     * spatial refinement.
+     * The function that stores the active_fe_flags of all cells that will
+     * be refined or coarsened before the refinement happens, so that
+     * they can be set again after refinement.
      */
     void
     pre_refinement_action();
+
+    /**
+     * A function that will be triggered through a triangulation
+     * signal just after the triangulation is modified.
+     *
+     * The function that restores the active_fe_flags of all cells that
+     * were refined.
+     */
     void
     post_refinement_action();