Add a note.

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

diff --git a/deal.II/include/deal.II/grid/tria.h b/deal.II/include/deal.II/grid/tria.h
index 8c5b8921287ff965361f75ba7d3684e8734d915c..ff8aa0c49a5fecd9e935b0109780f2d959152d57 100644 (file)
--- a/deal.II/include/deal.II/grid/tria.h
+++ b/deal.II/include/deal.II/grid/tria.h
@@ -735,7 +735,7 @@ namespace internal
  *   by the @p execute_coarsening_and_refinement function can do some
  *   smoothing of the triangulation. Note that mesh smoothing is only
  *   done for two or more space dimensions, no smoothing is available
- *   at present for one spatial dimension. In the sequel, let
+ *   at present for one spatial dimension. In the following, let
  *   <tt>execute_*</tt> stand for @p execute_coarsening_and_refinement.
  *
  *   For the purpose of smoothing, the
@@ -934,6 +934,14 @@ namespace internal
  *     Select no smoothing at all.
  *   </ul>
  *
+ *   @note While it is possible to pass all of the flags discussed above to
+ *   objects of type parallel::distributed::Triangulation, it is not always
+ *   possible to honor all of these smoothing options if they would require
+ *   knowledge of refinement/coarsening flags on cells not locally owned by
+ *   this processor. As a consequence, for some of these flags, the ultimate
+ *   number of cells of the parallel triangulation may depend on the number of
+ *   processors into which it is partitioned.
+ *
  *
  *   <h3>Material and boundary information</h3>
  *