From: Wolfgang Bangerth <bangerth@colostate.edu>
Date: Fri, 15 Jul 2022 02:52:32 +0000 (-0600)
Subject: Clarify documentation of p::s::T.
X-Git-Tag: v9.5.0-rc1~1089^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F14136%2Fhead;p=dealii.git

Clarify documentation of p::s::T.
---

diff --git a/include/deal.II/distributed/shared_tria.h b/include/deal.II/distributed/shared_tria.h
index 6512842390..f9d56f0839 100644
--- a/include/deal.II/distributed/shared_tria.h
+++ b/include/deal.II/distributed/shared_tria.h
@@ -69,9 +69,16 @@ namespace parallel
      * about cells owned by other processors with the exception of a single
      * layer of ghost cells around their own part of the domain.
      *
-     * Active cells need to be flagged for refinement or coarsening
-     * locally owned cells. The relevant information is gathered for
-     * ghost and artificial cells internally via MPI communication.
+     * Because every MPI process has a complete copy of the entire mesh
+     * as if it were stored on only this process, it needs to know for
+     * every active cell whether it is flagged for refinement or coarsening
+     * when doing mesh refinement via
+     * Triangulation::execute_coarsening_and_refinement(). In practice,
+     * each process only needs to set this information for its own
+     * "locally owned" cells; upon calling
+     * Triangulation::execute_coarsening_and_refinement(), the
+     * relevant information is then exchanged between processes
+     * internally, via MPI communication.
      *
      * The class is also useful in cases where compute time and memory
      * considerations dictate that the program needs to be run in parallel,