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/BRepFill/BRepFill.cdl

@@ -76,11 +76,7 @@ is
 
     
     class Generator;
-    	   ---Purpose: Compute a topological surface ( a  shell) using
-    	   --          generating wires. The face of the shell will be
-    	   --          ruled surfaces through the wires.
-    	   --          The wires must have the same number of edges.
-       
+
     deferred class SectionLaw; 
     	class ShapeLaw; 
     	class NSections; 
@@ -94,31 +90,16 @@ is
    	class ACRLaw; 
 
     class Pipe;
-	  ---Purpose: Computes  a   topological  shape  using  a  wire
-	  --          (spine) and a shape (profile).
+
     class PipeShell; 
-          ---Purpose: Computes a topological shell using some wires --
-          --          (spines and profiles) and diplacement option
-          
 
     class Evolved;
-	  ---Purpose: Computes  an evolved  volum using  a  generating
-	  --          wire and a profile.
 
     class Sweep; 
-          ---Purpose: Computes an  Sweep  shell using a  generating
-          --          wire, an SectionLaw and an LocationLaw.
 
- 
     class CompatibleWires;
-	---Purpose: Computes Wires with good orientation and origin in order
-          --        to generate a shell not twisted.
-
 
     class OffsetWire;
-	---Purpose: Computes the offset of a Wire or the Wires contained
-	--          in a Face.
-	--          The Wire or the Face must be planar.
 
     class OffsetAncestors;
 
@@ -136,12 +117,9 @@ is
 	
 
     private class TrimSurfaceTool;
-	  ---Purpose: Compute the Pcurves and  the 3d curves resulting
-	  --          of the trimming of a face by an extruded surface.
 
     private class TrimEdgeTool;
-	  ---Purpose: Geometric Tool using to construct Offset Wires.
-     
+
     private class  SectionPlacement;  
      
     private class  Section;  
@@ -196,21 +174,9 @@ is
 
 
     class CurveConstraint ;
-	---Purpose: same as CurveConstraint from GeomPlate
-	--          with BRepAdaptor_Surface instead of 
-	--          GeomAdaptor_Surface 
-	-- inherits CurveConstraint  from  GeomPlate         
-				      
+
     class Filling; 
-	---Purpose: N-Side Filling
-	--  This algorithm avoids to build a face from:
-	--  * a set of edges defining the bounds of the face and some
-	--    constraints the surface of the face has to satisfy
-	--  * a set of edges and points defining some constraints
-	--    the support surface has to satisfy
-	--  * an initial surface to deform for satisfying the constraints
-	--  * a set of parameters to control the constraints.   
-    
+
     private class FaceAndOrder;
     
     private class EdgeFaceAndOrder;

src/BRepFill/BRepFill_CompatibleWires.cdl

@@ -16,9 +16,9 @@
 
 class CompatibleWires from BRepFill
 
-	---Purpose: Constructs a sequence of Wires agreed each other 
-	--          so that the surface passing through these sections
-	--           is not twisted
+	---Purpose: Constructs a sequence of Wires (with good orientation
+	--          and origin) agreed each other so that the surface passing
+	--          through these sections is not twisted
 
 uses
 

src/BRepFill/BRepFill_CurveConstraint.cdl

@@ -14,7 +14,10 @@
 -- Alternatively, this file may be used under the terms of Open CASCADE
 -- commercial license or contractual agreement.
 
-class  CurveConstraint  from  BRepFill  inherits  CurveConstraint  from  GeomPlate 
+class  CurveConstraint  from  BRepFill  inherits  CurveConstraint  from  GeomPlate
+	---Purpose: same as CurveConstraint from GeomPlate
+	--          with BRepAdaptor_Surface instead of
+	--          GeomAdaptor_Surface
 
 uses 
    Pnt  from  gp,  

src/BRepFill/BRepFill_OffsetWire.cdl

@@ -18,7 +18,7 @@ class OffsetWire from BRepFill
 
 	---Purpose: Constructs a Offset Wire to a spine (wire or face) 
 	--          on the left of spine.
-
+	--          The Wire or the Face must be planar.
 uses
 
     Face        from TopoDS,

src/BRepFill/BRepFill_PipeShell.cdl

@@ -16,7 +16,9 @@
 
 class PipeShell from BRepFill inherits  TShared from MMgt 
 
-	---Purpose: Perform general sweeping construction
+    ---Purpose: Computes a topological shell using some wires
+    --          (spines and profiles) and diplacement option
+    --          Perform general sweeping construction
 uses  
  Dir  from  gp,
  Ax2  from  gp,

src/BRepFill/BRepFill_Sweep.cdl

@@ -18,6 +18,8 @@
 class Sweep from BRepFill 
 
 	---Purpose: Topological Sweep Algorithm
+	--          Computes an  Sweep  shell using a  generating
+  --          wire, an SectionLaw and an LocationLaw.
 	---Level: Advanced
 
 uses 

src/BRepFill/BRepFill_TrimEdgeTool.cdl

@@ -16,7 +16,7 @@
 
 private class TrimEdgeTool from BRepFill 
 
-	---Purpose: 
+	---Purpose: Geometric Tool using to construct Offset Wires.
 
 uses
 

src/BRepFill/BRepFill_TrimSurfaceTool.cdl

@@ -16,7 +16,8 @@
 
 private class TrimSurfaceTool from BRepFill 
 
-	---Purpose:
+	---Purpose: Compute the Pcurves and  the 3d curves resulting
+	  --        of the trimming of a face by an extruded surface.
 
 uses