From: Alexander Grayver <agrayver@erdw.ethz.ch>
Date: Sat, 27 Mar 2021 10:29:07 +0000 (+0100)
Subject: Update doc
X-Git-Tag: v9.3.0-rc1~277^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F11972%2Fhead;p=dealii.git

Update doc
---

diff --git a/include/deal.II/grid/grid_in.h b/include/deal.II/grid/grid_in.h
index 7f1b2eca72..31d658530e 100644
--- a/include/deal.II/grid/grid_in.h
+++ b/include/deal.II/grid/grid_in.h
@@ -422,7 +422,7 @@ public:
    * to true.
    *
    * When this flag is set to true, the generated vtu file contains the
-   * triangulation in a xml section which is ignored by vtu general vtu readers.
+   * triangulation in a xml section which is ignored by general vtu readers.
    * If this section is absent, an exception is thrown.
    */
   void
diff --git a/include/deal.II/grid/grid_out.h b/include/deal.II/grid/grid_out.h
index 7fef5a5ca9..258edc8040 100644
--- a/include/deal.II/grid/grid_out.h
+++ b/include/deal.II/grid/grid_out.h
@@ -1324,17 +1324,18 @@ public:
    *
    * Due to the way this function writes data to the output stream,
    * the resulting output files correspond to a faithful representation
-   * of the mesh in that all cells are visible for visualization. However,
+   * of the mesh in that all cells are visible for visualization. In general,
    * the data is not in a format that allows reading this file in again
    * through the GridIn class. This is because every vertex of the mesh is
    * duplicated as many times as there are adjacent cells. In other words,
    * every cell has its own, separate set of vertices that are at the
    * same location as the vertices of other cells, but are separately
-   * numbered. If such a file is read in through the GridIn class, then
-   * that will result in a mesh that has the correct cells and vertex
-   * locations, but because the vertices are logically separate (though at
-   * the same locations) all cells are unconnected and have no neighbors
-   * across faces.
+   * numbered.
+   *
+   * In order to create a file that can be read with the GridIn class,
+   * the flag GridOutFlags::Vtu::serialize_triangulation must be set to true. In
+   * this case, the generated vtu file will contain the triangulation in a xml
+   * section which is ignored by general vtu readers.
    */
   template <int dim, int spacedim>
   void