From a414fb84efe4939f0605311a0436b942f7841f38 Mon Sep 17 00:00:00 2001 From: Wolfgang Bangerth Date: Thu, 1 Nov 2018 10:54:30 -0600 Subject: [PATCH] Clarify the documentation of GridGenerator::cylinder(). --- include/deal.II/grid/grid_generator.h | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/include/deal.II/grid/grid_generator.h b/include/deal.II/grid/grid_generator.h index 5c61e0faaa..81e4ef5085 100644 --- 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 - * 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. + * 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 -- 2.39.5