Update Point_set_3 user man

Point_set_3/doc/Point_set_3/Point_set_3.txt

@@ -65,15 +65,20 @@ intensity property, and how to modify the point set according to this.
 \section Point_set_3_Algorithms Applying CGAL Algorithms
 
 Most \cgal algorithms let the user free to choose an input data
-structure: the points and attributes are then accessed
-through iterators and property maps. The `CGAL::Point_set_3`
-class directly provides these iterators and property maps so that
-applying \cgal algorithms is straightforward.
+structure: the points and attributes are then accessed through ranges
+and property maps. The `CGAL::Point_set_3` class is a range that
+provides property maps: applying \cgal algorithms is straightforward.
 
-In addition, all functions of the package
+As the \ref PkgPointSetProcessing "Point Set Processing" algorithms
+use \ref BGLNamedParameters to handle property maps, a method
+`CGAL::Point_set_3::parameters()` is provided: it returns a named
+parameter object with the right point and normal maps to read and
+write in the point set object.
+
+In addition, all input/output functions of the package
 \ref Chapter_Point_Set_Processing "Point Set Processing" are overloaded so
 that the user only has to call them with a `CGAL::Point_set_3`
-object as a parameter.
+object as a parameter (see \ref Point_set_3_IO).
 
 \subsection Point_set_3_PSP Point Set Processing
 

Point_set_3/doc/Point_set_3/dependencies

@@ -8,3 +8,4 @@ Point_set_processing_3
 Point_set_shape_detection_3
 Advancing_front_surface_reconstruction
 Surface_mesh
+BGL

Point_set_3/examples/Point_set_3/point_set_algo.cpp

@@ -38,13 +38,18 @@ int main (int, char**)
 
   // Add normal property and estimate normal values
   point_set.add_normal_map();
-  CGAL::jet_estimate_normals<CGAL::Sequential_tag> (point_set,
-                                                    12); // Number of neighbors
+  CGAL::jet_estimate_normals<CGAL::Sequential_tag>
+    (point_set,
+     12,; // Number of neighbors
+     point_set.parameters(). // Named parameters provided by Point_set_3
+     degree_fitting(2));     // additional named parameter specific to jet_estimate_normals
 
 
   // Simplify point set
-  CGAL::grid_simplify_point_set (point_set,
-                                 0.1); // Size of grid cell
+  CGAL::grid_simplify_point_set
+    (point_set,
+     0.1); // Size of grid cell
+  // point_set.parameters() can be omitted if no additional named parameter is needed
 
   std::vector<std::string> properties = point_set.properties();
   std::cerr << "Properties:" << std::endl;