From: Martin Kronbichler <kronbichler@lnm.mw.tum.de>
Date: Fri, 20 Oct 2017 16:27:58 +0000 (+0200)
Subject: Extend documentation
X-Git-Tag: v9.0.0-rc1~874^2~5
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ed1e4fea52345c306f0c803d6a6ad88f5fb82d4b;p=dealii.git

Extend documentation
---

diff --git a/include/deal.II/dofs/dof_handler.h b/include/deal.II/dofs/dof_handler.h
index 8abdbd1e12..cc51795caf 100644
--- a/include/deal.II/dofs/dof_handler.h
+++ b/include/deal.II/dofs/dof_handler.h
@@ -828,7 +828,6 @@ public:
    */
   const IndexSet &locally_owned_mg_dofs(const unsigned int level) const;
 
-
   /**
    * Return a vector that stores the locally owned DoFs of each processor. If
    * you are only interested in the number of elements each processor owns
@@ -840,9 +839,6 @@ public:
   const std::vector<IndexSet> &
   locally_owned_dofs_per_processor () const;
 
-  const std::vector<IndexSet> &
-  locally_owned_mg_dofs_per_processor (const unsigned int level) const;
-
   /**
    * Return a vector that stores the number of degrees of freedom each
    * processor that participates in this triangulation owns locally. The sum
@@ -858,6 +854,16 @@ public:
   const std::vector<types::global_dof_index> &
   n_locally_owned_dofs_per_processor () const;
 
+  /**
+   * Return a vector that stores the locally owned DoFs of each processor on
+   * the given level @p level.
+   *
+   * If this is a sequential job, then the vector has a single element that
+   * equals the IndexSet representing the entire range [0,n_dofs()].
+   */
+  const std::vector<IndexSet> &
+  locally_owned_mg_dofs_per_processor (const unsigned int level) const;
+
   /**
    * Return a constant reference to the selected finite element object.
    * Since there is only one FiniteElement @p index must be equal to zero
diff --git a/source/dofs/dof_tools.cc b/source/dofs/dof_tools.cc
index ab956ffcb8..c115da2d80 100644
--- a/source/dofs/dof_tools.cc
+++ b/source/dofs/dof_tools.cc
@@ -1114,6 +1114,7 @@ namespace DoFTools
   }
 
 
+
   template <typename DoFHandlerType>
   void
   extract_locally_relevant_level_dofs (const DoFHandlerType &dof_handler,
@@ -1160,6 +1161,8 @@ namespace DoFTools
     dof_set.compress();
   }
 
+
+
   template <typename DoFHandlerType>
   void
   extract_constant_modes (const DoFHandlerType            &dof_handler,