0024784: Move documentation in CDL files to proper location

Mostly duplicated comments were removed and missing ones were moved
into dedicated class CDL files.
Some more duplicated comments were removed from CDL files.
Correction of merge

src/CPnts/CPnts.cdl

@@ -29,26 +29,14 @@ is
 
 
    imported RealFunction;
-    ---Purpose: typedef Standard_Real (*CPnts_RealFunction)
-    --          (const Standard_Real, const Standard_Address)
-    --          
-    --          A pointer on a function for MyGaussFunction
 
    private class MyGaussFunction;
-       ---Purpose: for implementation, compute values for Gauss
 
    private class MyRootFunction;
-       ---Purpose: for implementation,  compute Length  and Derivative
-       --          of the curve for Newton.
 
    class  AbscissaPoint;
-       ---Purpose:  
-       -- This algorithm computes a point and its parameter 
-       -- as the distance between this and a given point is the abscissa
 
    class UniformDeflection;
-        --- Purpose : This Algorithm computes a distribution of points 
-        --  with a given chordal deviation on a parametrized curve.
 
 end CPnts;
 

src/CPnts/CPnts_MyGaussFunction.cdl

@@ -16,6 +16,7 @@
 
 private class MyGaussFunction from CPnts 
 inherits Function from math
+       ---Purpose: for implementation, compute values for Gauss
 
 uses
     RealFunction from CPnts

src/CPnts/CPnts_MyRootFunction.cdl

@@ -20,6 +20,7 @@ inherits FunctionWithDerivative from math
 
 ---Purpose: Implements a function for the Newton algorithm to find the
 --          solution of Integral(F) = L
+--          (compute Length  and Derivative of the curve for Newton)
 
 uses
     MyGaussFunction from CPnts,

src/CPnts/CPnts_RealFunction.hxx

@@ -19,6 +19,8 @@
 
 #include <Standard_TypeDef.hxx>
 
+//! A pointer on a function for MyGaussFunction
+
 typedef Standard_Real (*CPnts_RealFunction)(const Standard_Real, 
 					    const Standard_Address);
 

src/CPnts/CPnts_UniformDeflection.cdl

@@ -16,8 +16,9 @@
 
 class UniformDeflection from CPnts 
  
-        ---Purpose : This classe defines an algorithm to create a set of points at the
-        --  positions of constant deflection of a given curve or a trimmed 
+        ---Purpose : This class defines an algorithm to create a set of points
+        -- (with a given chordal deviation) at the
+        --  positions of constant deflection of a given parametrized curve or a trimmed
         --  circle.
         --  The continuity of the curve must be at least C2.
         --