Improve in-code documentation

diff --git a/include/deal.II/grid/grid_generator.h b/include/deal.II/grid/grid_generator.h
index 3d7c616c78c5fbde3c21d94aa14ef56701b85ce1..006577e0addbef5f91621ed7e5c32792329350e7 100644 (file)
--- a/include/deal.II/grid/grid_generator.h
+++ b/include/deal.II/grid/grid_generator.h
@@ -1041,8 +1041,6 @@ namespace GridGenerator
                  const unsigned int  n_radial_cells = 0,
                  const unsigned int  n_axial_cells  = 0);
 
-
-
   /**
    * Produce the volume or surface mesh of a torus. The axis of the torus is
    * the $y$-axis while the plane of the torus is the $x$-$z$ plane.

diff --git a/source/grid/grid_generator.cc b/source/grid/grid_generator.cc
index 91afef6700f7f18587f738fda9945f5794b33392..283b553aa00f19c31ec4fe9f00a4f19b9bfaff16 100644 (file)
--- a/source/grid/grid_generator.cc
+++ b/source/grid/grid_generator.cc
@@ -757,7 +757,8 @@ namespace GridGenerator
     vertices[6] = p + Point<3>(-1, +1, 0) * (r / std::sqrt(2.0)),
     vertices[7] = p + Point<3>(+1, +1, 0) * (r / std::sqrt(2.0));
 
-    // create remaining vertices by rotating around positive y-axis
+    // create remaining vertices by rotating around negative y-axis (the
+    // direction is to ensure positive cell measures)
     double phi_cell = 2.0 * numbers::PI / n_cells_toroidal;
     for (unsigned int c = 1; c < n_cells_toroidal; ++c)
       {