From: Martin Kronbichler <kronbichler@lnm.mw.tum.de>
Date: Thu, 16 May 2019 14:30:01 +0000 (+0200)
Subject: Improve in-code documentation
X-Git-Tag: v9.2.0-rc1~1441^2~2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d4e3c89671b416a848fb0cdff5ba0e1e5a8b997f;p=dealii.git

Improve in-code documentation
---

diff --git a/include/deal.II/grid/grid_generator.h b/include/deal.II/grid/grid_generator.h
index 3d7c616c78..006577e0ad 100644
--- 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 91afef6700..283b553aa0 100644
--- 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)
       {