doc: add info to distort_random

diff --git a/include/deal.II/grid/grid_tools.h b/include/deal.II/grid/grid_tools.h
index fcfb6c94d8a33de777846ed185d767d12d705fc9..a7b9ae0614119a83a945dfa6921d00e7722f8c22 100644 (file)
--- a/include/deal.II/grid/grid_tools.h
+++ b/include/deal.II/grid/grid_tools.h
@@ -802,6 +802,11 @@ namespace GridTools
    * @p seed is used for the initialization of the random engine. Its
    * default value initializes the engine with the same state as in
    * previous versions of deal.II.
+   *
+   * @note If the Triangulation is of distributed kind (derived from
+   * DistributedTriangulationBase) and computations are done in
+   * parallel, the new vertex locations will be consistently updated
+   * on all ranks.
    */
   template <int dim, int spacedim>
   void