Add some docs.

git-svn-id: https://svn.dealii.org/trunk@8950 0785d39b-7218-0410-832d-ea1e28bc413d

diff --git a/deal.II/deal.II/include/dofs/dof_tools.h b/deal.II/deal.II/include/dofs/dof_tools.h
index b923de4c43b9b88fbbd605b57b8082988f24829e..5dd60ce33d420e469d616e77d805a597594faa7e 100644 (file)
--- a/deal.II/deal.II/include/dofs/dof_tools.h
+++ b/deal.II/deal.II/include/dofs/dof_tools.h
@@ -800,6 +800,16 @@ class DoFTools
                                      * asymptotically vanishing as we refine
                                      * the mesh as long as the number of
                                      * partitions is kept constant.
+                                     *
+                                     * This function returns the association
+                                     * of each DoF with one subdomain. If you
+                                     * are looking for the association of
+                                     * each @em cell with a subdomain, either
+                                     * query the
+                                     * <tt>cell->subdomain_id()</tt>
+                                     * function, or use the
+                                     * <tt>GridTools::get_subdomain_association</tt>
+                                     * function.
                                       */
     template <int dim>
     static void
@@ -821,6 +831,13 @@ class DoFTools
                                       * This function will generate an
                                       * exception if there are no cells with
                                       * the given @p subdomain index.
+                                     *
+                                     * This function returns the number of
+                                     * DoFs associated with one subdomain. If
+                                     * you are looking for the association of
+                                     * @em cells with this subdomain, use the
+                                     * <tt>GridTools::count_cells_with_subdomain_association</tt>
+                                     * function.
                                       */
     template <int dim>
     static unsigned int