Update some documentation pieces.

diff --git a/include/deal.II/grid/tria_accessor.h b/include/deal.II/grid/tria_accessor.h
index 3c53e712f2e6453d62b20a4d2f54834da39ae113..f99b96997028a63839b7479c959eb3904875c6e9 100644 (file)
--- a/include/deal.II/grid/tria_accessor.h
+++ b/include/deal.II/grid/tria_accessor.h
@@ -3260,7 +3260,11 @@ public:
 
   /**
    * Get the level subdomain id of this cell. This is used for parallel
-   * multigrid.
+   * multigrid where not only the global mesh (consisting of the active cells)
+   * is partitioned among processors, but also the individual levels of the
+   * hierarchy of recursively refined cells that make up the mesh. In
+   * other words, the level subdomain id is a property that is also defined
+   * for non-active cells if a multigrid hierarchy is used.
    */
   types::subdomain_id
   level_subdomain_id() const;

diff --git a/include/deal.II/grid/tria_levels.h b/include/deal.II/grid/tria_levels.h
index 9ec92745f699eb1f733c764f0acd7a84b8a28f6c..70c513ad366ead39f8f3f8678abde15b9a9d5f41 100644 (file)
--- a/include/deal.II/grid/tria_levels.h
+++ b/include/deal.II/grid/tria_levels.h
@@ -120,13 +120,19 @@ namespace internal
       /**
        * One integer per cell to store which subdomain it belongs to. This
        * field is most often used in parallel computations, where it denotes
-       * which processor shall work on the cells with a given subdomain
+       * which processor shall work on/owns the cells with a given subdomain
        * number.
+       *
+       * This number is only used on active cells.
        */
       std::vector<types::subdomain_id> subdomain_ids;
 
       /**
-       * for parallel multigrid
+       * The subdomain id used on each level for parallel multigrid.
+       *
+       * In contrast to the subdomain_id, this number is also used on inactive
+       * cells once the mesh has been partitioned also on the lower levels of
+       * the multigrid hierarchy.
        */
       std::vector<types::subdomain_id> level_subdomain_ids;
 

diff --git a/source/grid/tria_accessor.cc b/source/grid/tria_accessor.cc
index 06321aebf5b2f460ec96718b6dcbd2c3eb578ec5..80579e6e84a1987bc51598a9571f9608847850d4 100644 (file)
--- a/source/grid/tria_accessor.cc
+++ b/source/grid/tria_accessor.cc
@@ -1981,6 +1981,7 @@ CellAccessor<dim, spacedim>::set_subdomain_id(
 }
 
 
+
 template <int dim, int spacedim>
 types::subdomain_id
 CellAccessor<dim, spacedim>::level_subdomain_id() const