From 405316ae1cc6f403f347507bd30287716f514802 Mon Sep 17 00:00:00 2001
From: Wolfgang Bangerth <bangerth@math.tamu.edu>
Date: Fri, 7 Nov 2014 14:47:59 -0600
Subject: [PATCH] Minor documentation update. Reorder two functions.

---
 include/deal.II/distributed/tria.h | 22 +++++++++-------------
 source/distributed/tria.cc         | 10 ++++++----
 2 files changed, 15 insertions(+), 17 deletions(-)

diff --git a/include/deal.II/distributed/tria.h b/include/deal.II/distributed/tria.h
index adb5fb0333..f0b515b2ef 100644
--- a/include/deal.II/distributed/tria.h
+++ b/include/deal.II/distributed/tria.h
@@ -697,25 +697,21 @@ namespace parallel
                                                               const void *)> &unpack_callback);
 
       /**
-       * Returns a permutation vector for the mapping from the
-       * coarse deal cells to the p4est trees. This is the inverse
-       * of get_p4est_tree_to_coarse_cell_permutation.
+       * Return a permutation vector for the order the coarse cells
+       * are handed off to p4est. For example the value of the $i$th element
+       * in this vector is the index of the deal.II coarse cell (counting
+       * from begin(0)) that corresponds to the $i$th tree managed by p4est.
        */
       const std::vector<types::global_dof_index> &
-      get_coarse_cell_to_p4est_tree_permutation() const;
-
-
+      get_p4est_tree_to_coarse_cell_permutation() const;
 
       /**
-       * Returns a permutation vector for the order the coarse cells
-       * are handed of to p4est. For example the first element i in
-       * this vector denotes that the first cell in hierarchical
-       * ordering is the ith deal cell starting from begin(0).
+       * Return a permutation vector for the mapping from the
+       * coarse deal cells to the p4est trees. This is the inverse
+       * of get_p4est_tree_to_coarse_cell_permutation.
        */
       const std::vector<types::global_dof_index> &
-      get_p4est_tree_to_coarse_cell_permutation() const;
-
-
+      get_coarse_cell_to_p4est_tree_permutation() const;
 
       /**
        * Join faces in the p4est forest for periodic boundary
diff --git a/source/distributed/tria.cc b/source/distributed/tria.cc
index 55d554d673..07f4a6986b 100644
--- a/source/distributed/tria.cc
+++ b/source/distributed/tria.cc
@@ -3322,20 +3322,22 @@ namespace parallel
 
     template <int dim, int spacedim>
     const std::vector<types::global_dof_index> &
-    Triangulation<dim, spacedim>::get_coarse_cell_to_p4est_tree_permutation() const
+    Triangulation<dim, spacedim>::get_p4est_tree_to_coarse_cell_permutation() const
     {
-      return coarse_cell_to_p4est_tree_permutation;
+      return p4est_tree_to_coarse_cell_permutation;
     }
 
 
 
     template <int dim, int spacedim>
     const std::vector<types::global_dof_index> &
-    Triangulation<dim, spacedim>::get_p4est_tree_to_coarse_cell_permutation() const
+    Triangulation<dim, spacedim>::get_coarse_cell_to_p4est_tree_permutation() const
     {
-      return p4est_tree_to_coarse_cell_permutation;
+      return coarse_cell_to_p4est_tree_permutation;
     }
 
+
+
     namespace
     {
       /**
-- 
2.39.5