From: Marc Fehling <mafehling.git@gmail.com>
Date: Mon, 15 Mar 2021 23:08:32 +0000 (-0600)
Subject: Document that adaptation flags need to be placed on all procs for p:s:Tria.
X-Git-Tag: v9.3.0-rc1~322^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F11920%2Fhead;p=dealii.git

Document that adaptation flags need to be placed on all procs for p:s:Tria.
---

diff --git a/include/deal.II/distributed/shared_tria.h b/include/deal.II/distributed/shared_tria.h
index 0d4efafe5e..dfb05e9cc3 100644
--- a/include/deal.II/distributed/shared_tria.h
+++ b/include/deal.II/distributed/shared_tria.h
@@ -70,6 +70,11 @@ 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.
      *
+     * As a consequence of storing the entire mesh on each processor, active
+     * cells need to be flagged for refinement or coarsening consistently on
+     * all processors if you want to adapt them, regardless of being classified
+     * as locally owned, ghost or artificial.
+     *
      * The class is also useful in cases where compute time and memory
      * considerations dictate that the program needs to be run in parallel,
      * but where algorithmic concerns require that every processor knows