]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Clarify the documentation of GridGenerator::cylinder(). 7405/head
authorWolfgang Bangerth <bangerth@colostate.edu>
Thu, 1 Nov 2018 16:54:30 +0000 (10:54 -0600)
committerWolfgang Bangerth <bangerth@colostate.edu>
Thu, 1 Nov 2018 18:29:36 +0000 (12:29 -0600)
include/deal.II/grid/grid_generator.h

index 5c61e0faaa993ae9ffeb492f9020e0b844856713..81e4ef50851c63939fa55d7fa5d12e95a125d50a 100644 (file)
@@ -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

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.