Document direction parameter for periodic constraints

diff --git a/include/deal.II/dofs/dof_tools.h b/include/deal.II/dofs/dof_tools.h
index fd8c77abbfebe7f1767c2695d652876b19a87bcb..772a23c44ba6a2076c70a8b2c518f5385377c831 100644 (file)
--- a/include/deal.II/dofs/dof_tools.h
+++ b/include/deal.II/dofs/dof_tools.h
@@ -1218,7 +1218,8 @@ namespace DoFTools
    *
    * This function tries to match all faces belonging to the first boundary
    * with faces belonging to the second boundary with the help of
-   * orthogonal_equality().
+   * orthogonal_equality(). More precisely, faces with coordinates only
+   * differing in the @p direction component are identified.
    *
    * If this matching is successful it constrains all DoFs associated with the
    * 'first' boundary to the respective DoFs of the 'second' boundary
@@ -1256,7 +1257,8 @@ namespace DoFTools
    * boundary_ids this function defines a 'left' boundary as all faces with
    * local face index <code>2*dimension</code> and boundary indicator @p b_id
    * and, similarly, a 'right' boundary consisting of all face with local face
-   * index <code>2*dimension+1</code> and boundary indicator @p b_id.
+   * index <code>2*dimension+1</code> and boundary indicator @p b_id. Faces with
+   * coordinates only differing in the @p direction component are identified.
    *
    * @note This version of make_periodicity_constraints  will not work on
    * meshes with cells not in

diff --git a/include/deal.II/grid/grid_tools.h b/include/deal.II/grid/grid_tools.h
index fb287ace4293da0f7c163ed8be75571edd8b402a..23cba652ccb77d0e566e21b2b02644f04c4daa37 100644 (file)
--- a/include/deal.II/grid/grid_tools.h
+++ b/include/deal.II/grid/grid_tools.h
@@ -2571,7 +2571,9 @@ namespace GridTools
    * boundary_ids this function defines a 'left' boundary as all faces with
    * local face index <code>2*dimension</code> and boundary indicator @p b_id
    * and, similarly, a 'right' boundary consisting of all face with local face
-   * index <code>2*dimension+1</code> and boundary indicator @p b_id.
+   * index <code>2*dimension+1</code> and boundary indicator @p b_id. Faces
+   * with coordinates only differing in the @p direction component are
+   * identified.
    *
    * This function will collect periodic face pairs on the coarsest mesh level
    * and add them to @p matched_pairs leaving the original contents intact.