Clarify the documentation of GridGenerator::cylinder().

diff --git a/include/deal.II/grid/grid_generator.h b/include/deal.II/grid/grid_generator.h
index 5c61e0faaa993ae9ffeb492f9020e0b844856713..81e4ef50851c63939fa55d7fa5d12e95a125d50a 100644 (file)
--- a/include/deal.II/grid/grid_generator.h
+++ b/include/deal.II/grid/grid_generator.h
@@ -713,13 +713,16 @@ namespace GridGenerator
                   const double        radius = 1.);
 
   /**
-   * Create a cylinder around the $x$-axis.  The cylinder extends from
-   * <tt>x=-half_length</tt> to <tt>x=+half_length</tt> and its projection
-   * into the @p yz-plane is a circle of radius @p radius.
-   *
-   * In two dimensions, the cylinder is a rectangle from
-   * <tt>x=-half_length</tt> to <tt>x=+half_length</tt> and from
-   * <tt>y=-radius</tt> to <tt>y=radius</tt>.
+   * Create a @p dim dimensional cylinder where the $x$-axis serves as
+   * the axis of the cylinder. For the purposes of this function, a
+   * cylinder is defined as a (@p dim - 1) dimensional disk of given
+   * @p radius, extruded along the axis of the cylinder (which is the
+   * first coordinate direction). Consequently, in three dimensions,
+   * the cylinder extends from `x=-half_length` to `x=+half_length`
+   * and its projection into the @p yz-plane is a circle of radius @p
+   * radius. In two dimensions, the cylinder is a rectangle from
+   * `x=-half_length` to `x=+half_length` and from `y=-radius` to
+   * `y=radius`.
    *
    * The boundaries are colored according to the following scheme: 0 for the
    * hull of the cylinder, 1 for the left hand face and 2 for the right hand