Augment documentation.

git-svn-id: https://svn.dealii.org/trunk@28544 0785d39b-7218-0410-832d-ea1e28bc413d

diff --git a/deal.II/include/deal.II/grid/grid_generator.h b/deal.II/include/deal.II/grid/grid_generator.h
index b92327f0bfea56b7522cb265880fa3042bfb3603..eabdfd32f6e555a1303520e10780099c0515a424 100644 (file)
--- a/deal.II/include/deal.II/grid/grid_generator.h
+++ b/deal.II/include/deal.II/grid/grid_generator.h
@@ -590,17 +590,17 @@ public:
 
   /**
    * This class produces a square on the <i>xy</i>-plane with a circular hole
-   * in the middle, times the interval [0.L] (only in 3d).
+   * in the middle. Square and circle are centered at the origin. In 3d, this
+   * geometry is extruded in $z$ direction to the interval $[0,L]$.
    *
    *  @image html cubes_hole.png
    *
    * It is implemented in 2d and 3d, and takes the following arguments:
    *
-   * @arg @p inner_radius: size of the
+   * @arg @p inner_radius: radius of the
    *    internal hole
-   * @arg @p  outer_radius: size of the
-   *    biggest enclosed cylinder
-   * @arg @p L: extension on the @p z-direction
+   * @arg @p  outer_radius: half of the edge length of the square
+   * @arg @p L: extension in @p z-direction (only used in 3d)
    * @arg @p repetitions: number of subdivisions
    *      along the @p z-direction
    * @arg @p colorize: wether to assign different