diff --git a/Point_set_shape_detection_3/doc/Point_set_shape_detection_3/Point_set_shape_detection_3.txt b/Point_set_shape_detection_3/doc/Point_set_shape_detection_3/Point_set_shape_detection_3.txt
index f59878aa9ab..ab0618f85f3 100644
--- a/Point_set_shape_detection_3/doc/Point_set_shape_detection_3/Point_set_shape_detection_3.txt
+++ b/Point_set_shape_detection_3/doc/Point_set_shape_detection_3/Point_set_shape_detection_3.txt
@@ -107,9 +107,7 @@ which is used by the example  \ref Point_set_shape_detection_3/efficient_RANSAC_
 
 \section Point_set_shape_detection_3Plane_regularization Plane Regularization
 
-Shape detection is very suited for man-made shapes such as urban scenes or scans of mechanical pieces. Such scenes may contain a wide variety of regularities that user may want to favor: parallelism, orthogonality, concentricity, coaxiality, etc., not to mention orbits and composed relationships.
-
-Among all these possibilities, \cgal provides a means to regularize four properties of regularity through a function `CGAL::regularize_planes()`. It only postprocesses planes detected by `CGAL::Shape_detection_3<Traits>` (other primitives are left unchanged):
+Shape detection applies to man-made scenes or objects such as urban scenes or scans of mechanical parts. Such scenes often contain a wide range of geometric regularities such as parallelism, orthogonality, or symmetry. This package offers a function to reinforce four types of regularities for planar shapes: `CGAL::regularize_planes()`. It only postprocesses planes detected by `CGAL::Shape_detection_3<Traits>` (other primitives are left unchanged):
 
 - Planes that are near __parallel__ are made parallel: normal vectors of planes that form angles smaller than a user-defined threshold are made equal.
 
diff --git a/Point_set_shape_detection_3/include/CGAL/regularize_planes.h b/Point_set_shape_detection_3/include/CGAL/regularize_planes.h
index 09b406200e3..78d8f531934 100644
--- a/Point_set_shape_detection_3/include/CGAL/regularize_planes.h
+++ b/Point_set_shape_detection_3/include/CGAL/regularize_planes.h
@@ -547,8 +547,9 @@ void subgraph_mutually_orthogonal_clusters (PlaneClusterContainer& clusters,
     \tparam Traits a model of `EfficientRANSACTraits`
 
     \param shape_detection Shape detection object used to detect
-    shapes from the input data. This engine may handle any types of
-    primitive shapes but only planes will be regularized. 
+    shapes from the input data. While the shape detection algorithm
+    deals with several types of primitive shapes only planes can be
+    regularized.
 
     \warning The `shape_detection` parameter must have already
     detected shapes. If no plane exists in it, the regularization