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

@@ -134,17 +134,13 @@ uses
 is
 
       deferred class Curve2d; 
-       ---Purpose: Root of the 2d curve.
 
       pointer Curve2dPtr to Curve2d from Adaptor2d;
 
       deferred class HCurve2d;
-        ---Purpose: deferred class for the  2d curves manipulated with
-        --          Handle.
 
       generic class GenHCurve2d;
-      	---Purpose: Generic  class  used to create a  curve inheriting
+
-      	--          from HCurve2d.
 
               
 

src/Adaptor3d/Adaptor3d.cdl

@@ -139,31 +139,20 @@ uses
 is
 
       deferred class Curve; 
-      	---Purpose: Root of the 3d curve.
 
       pointer CurvePtr to Curve from Adaptor3d;
 
       deferred class HCurve;
-        ---Purpose: deferred  class for  the  curves manipulated  with
-        --          Handle.
 
       generic class GenHCurve;
-      	---Purpose: Generic  class  used to create a  curve inheriting
-      	--          from HCurve.
-      
               
       deferred class Surface;
-        ---Purpose: Root of the surface.
       
       pointer SurfacePtr to Surface from Adaptor3d;
 
       deferred class HSurface;
-        ---Purpose: deferred class for  the  surfaces manipulated with
-        --          Handle.
 
       generic class GenHSurface;
-      	---Purpose: Generic class used to  create a surface inheriting
-      	--          from  HSurface.
       
 
       --
@@ -188,15 +177,12 @@ is
 
 
       class IsoCurve;
-      ---Purpose: Algorithmic 3d curv, isoparametric on a surface.
 
       class HIsoCurve instantiates GenHCurve from Adaptor3d
         (IsoCurve from Adaptor3d);
               
 
       class CurveOnSurface;
-       ---Purpose: Algorithmic 3d curve from a surface and a 2d  curve
-       --          in the parameter space.
        
       pointer CurveOnSurfacePtr to CurveOnSurface from Adaptor3d;
 
@@ -206,16 +192,11 @@ is
 	
 
       class OffsetCurve;
-      ---Purpose: Algorithmic 2d curve.
 
       class HOffsetCurve instantiates GenHCurve2d from Adaptor2d
         (OffsetCurve  from Adaptor3d);
 
-    
       class SurfaceOfRevolution;
-      ---Purpose: Algorithmic Surface from a Curve and an Axis
-      --          Curve and Axis are coplanar.
-      --          Curve doesn't intersect Axis.
       
       class HSurfaceOfRevolution instantiates GenHSurface from Adaptor3d
        (SurfaceOfRevolution from Adaptor3d);
@@ -223,13 +204,10 @@ is
       
       
       class SurfaceOfLinearExtrusion;    
-      ---Purpose: Algorithmic Surface from a curve and a direction
 
       class HSurfaceOfLinearExtrusion instantiates GenHSurface from Adaptor3d
        (SurfaceOfLinearExtrusion from Adaptor3d);
 
       private  class  InterFunc; 
-      ---Purpose: function to find the Cn discontinuity point. Used to
-      --          find the roots of the functions 
 
 end Adaptor3d;

src/Adaptor3d/Adaptor3d_InterFunc.cdl

@@ -19,7 +19,8 @@ private  class  InterFunc  from  Adaptor3d  inherits  FunctionWithDerivative  fr
          ---Purpose: Used to find the points U(t) = U0 or V(t) = V0 in
          --          order to determine the  Cn discontinuities of  an
          --               Adpator_CurveOnSurface  relativly  to    the
-         --          discontinuities of the surface. 
+         --          discontinuities of the surface. Used to
+         --          find the roots of the functions
 	 
 uses  
       HCurve2d  from  Adaptor2d

src/Adaptor3d/Adaptor3d_OffsetCurve.cdl

@@ -16,7 +16,7 @@
 
 class OffsetCurve from Adaptor3d inherits Curve2d from Adaptor2d
 	
-	---Purpose: Defines an Offset curve.
+	---Purpose: Defines an Offset curve (algorithmic 2d curve).
 	--          
 
 uses

src/Adaptor3d/Adaptor3d_SurfaceOfRevolution.cdl

@@ -33,6 +33,8 @@ class SurfaceOfRevolution from Adaptor3d inherits Surface from Adaptor3d
         --  The derivatives are always defined for the u direction.
         --  For the v direction the definition of the derivatives depends on
         --  the degree of continuity of the referenced curve.
+        --  Curve and Axis are coplanar.
+        --  Curve doesn't intersect Axis.
 
 
 

src/AdvApp2Var/AdvApp2Var.cdl

@@ -77,28 +77,11 @@ is
     --  
 
     class ApproxAFunc2Var from AdvApp2Var ;
-    ---Purpose:
-    -- this class approximates a given function of 2 variables
 
     imported EvaluatorFunc2Var ;
-    ---Purpose:
-    --  typedef  void (*EvaluatorFunc2Var)  (
-    --  Standard_Integer *     -- dimension
-    --  Standard_Real    *     -- first and last parameters in U
-    --  Standard_Real    *     -- first and last parameters in V
-    --  Standard_Integer *     -- choice of constante, 1 for U, 2 for V
-    --  Standard_Real    *     -- value of constant parameter
-    --  Standard_Integer *     -- number of parameters
-    --  Standard_Real    *     -- values of parameters
-    --  Standard_Integer *     -- order of derivation in U
-    --  Standard_Integer *     -- order of derivation in V
-    --  Standard_Real    *     -- evaluation
-    --  Standard_Integer *     -- error code
-    --  ) ;
 
     deferred class Criterion from AdvApp2Var ;
-    ---Purpose:
+
-    -- this class contains a given criterion to be satisfied
 
 
     -- 
@@ -109,25 +92,12 @@ is
     -- Basic Data
 
     class Context from AdvApp2Var;
-    ---Purpose :
-    -- contains  all the  parameters  for approximation
-    --         ( tolerancy, computing option, ...)
-    --        
 
     class Node from AdvApp2Var;
-    ---Purpose :
-    -- used to store constraints on a (Ui,Vj) point
-    -- 
 
     class Iso from AdvApp2Var;
-    ---Purpose :
-    -- used to store constraints on a line U = Ui or V = Vj
-    -- 
 
     class Patch from AdvApp2Var;
-    ---Purpose :
-    -- used to store results on a domain [Ui,Ui+1]x[Vj,Vj+1]
-    -- 
 
     class Strip from AdvApp2Var instantiates
      	    	    Sequence from TCollection (Iso from  AdvApp2Var); 

src/AdvApp2Var/AdvApp2Var_Context.cdl

@@ -20,6 +20,9 @@
 
 
 class Context from AdvApp2Var
+    ---Purpose :
+    -- contains  all the  parameters  for approximation
+    --         ( tolerancy, computing option, ...)
 
 uses
     HArray1OfReal from TColStd,

src/AdvApp2Var/AdvApp2Var_Criterion.cdl

@@ -15,6 +15,8 @@
 -- commercial license or contractual agreement.
 
 deferred class Criterion from AdvApp2Var
+    ---Purpose:
+    -- this class contains a given criterion to be satisfied
 
 uses
     Patch,Context from AdvApp2Var,

src/AdvApp2Var/AdvApp2Var_EvaluatorFunc2Var.hxx

@@ -35,8 +35,8 @@ public:
 
   //! Function evaluation method to be defined by descendant
   virtual void Evaluate (Standard_Integer* theDimension,
-                         Standard_Real*    theUStartEnd,
+                         Standard_Real*    theUStartEnd,  //!< First and last parameters in U
-                         Standard_Real*    theVStartEnd,
+                         Standard_Real*    theVStartEnd,  //!< First and last parameters in V
                          Standard_Integer* theFavorIso,   //!< Choice of constante, 1 for U, 2 for V
                          Standard_Real*    theConstParam, //!< Value of constant parameter
                          Standard_Integer* theNbParams,   //!< Number of parameters N

src/AdvApp2Var/AdvApp2Var_Iso.cdl

@@ -15,6 +15,9 @@
 -- commercial license or contractual agreement.
 
 class Iso from AdvApp2Var
+    ---Purpose :
+    -- used to store constraints on a line U = Ui or V = Vj
+    --
 
 uses
 

src/AdvApp2Var/AdvApp2Var_Node.cdl

@@ -15,7 +15,9 @@
 -- commercial license or contractual agreement.
 
 class Node from AdvApp2Var
-
+    ---Purpose :
+    -- used to store constraints on a (Ui,Vj) point
+    --
 
 uses
     XY,Pnt           from gp,

src/AdvApp2Var/AdvApp2Var_Patch.cdl

@@ -21,6 +21,9 @@
 --		        Field 'myCritValue'
 
 class Patch from AdvApp2Var
+    ---Purpose :
+    -- used to store results on a domain [Ui,Ui+1]x[Vj,Vj+1]
+    --
 
 uses
 

src/AdvApprox/AdvApprox.cdl

@@ -36,42 +36,18 @@ is
     
 
     class ApproxAFunction from AdvApprox ;
-    ---Purpose:
-    -- this approximate a given function
     class SimpleApprox;
 --  class ApproxAFunction;  
 
     imported EvaluatorFunction ;
-    ---Purpose:
-    --  typedef  void (*EvaluatorFunction)  (
-    --  Standard_Integer *
-    --  Standard_Real    *
-    --  Standard_Real    *
-    --  Standard_Integer *
-    --  Standard_Real    *
-    --  Standard_Integer *) ;
-    
 
     deferred class Cutting;
-    ---Purpose : 
-    -- this class is used to choose the way of cutting if needed 
 
     class DichoCutting;
-    ---Purpose :
-    -- inherits class Cutting;
-    -- if Cutting is necessary in [a,b], we cut at (a+b) / 2.
-    -- 
 
     class PrefCutting;
-    ---Purpose : 
-    -- inherits class Cutting; contains a list of preferential points (di)i
-    -- if Cutting is necessary in [a,b], we cut at the di nearest from (a+b)/2.
 
     class PrefAndRec;
-    ---Purpose : 
-    -- inherits class Cutting; contains two lists of preferential points to
-    -- manage to level of preferential cutting.
-    -- if Cutting is necessary in [a,b], we cut at the di nearest from (a+b)/2
 
 
 end AdvApprox;

src/AdvApprox/AdvApprox_ApproxAFunction.cdl

@@ -15,7 +15,8 @@
 -- commercial license or contractual agreement.
 
 class ApproxAFunction from AdvApprox 
-
+    ---Purpose:
+    -- this approximate a given function
 uses Array1OfInteger   from TColStd,
      Vector            from math,
      HArray1OfInteger  from TColStd,

src/AdvApprox/AdvApprox_PrefAndRec.cdl

@@ -19,6 +19,7 @@ class PrefAndRec from AdvApprox inherits Cutting from AdvApprox
     ---Purpose : 
     -- inherits class Cutting; contains a list of preferential points (pi)i
     -- and a list of Recommended points used in cutting management.
+    -- if Cutting is necessary in [a,b], we cut at the di nearest from (a+b)/2
     
 
 uses Array1OfReal from TColStd

src/AppCont/AppCont.cdl

@@ -42,27 +42,15 @@ is
     --- Algorithms:
     -------------------------------
 
-    ---Purpose: The two following algorithms are using the same recipe:
-    --          Minimizing the difference between the approximate result 
-    --          Curve or Surface and respectively a continous MultiLine 
-    --          or a continous surface.
-
     generic class LeastSquare;
-	    ---Purpose: makes an approximation of a continous Line described by
-	    --          the tool TheLineTool.
 
     ------------------------------------------------------
     --- Necessary class for approximation a function f(t):
     ------------------------------------------------------
 
     deferred class Function;
-	    ---Purpose: This class must be provided by the user to use the
-	    --          approximation algorithm FittingCurve.
-
 
     class FunctionTool;
-	    ---Purpose: This class is the inteface between the Function 
-	    --          class and the tool asked by LeastSquare.
 
 
     ---------------------------------------------------------
@@ -70,14 +58,8 @@ is
     ---------------------------------------------------------
 
     deferred class Function2d;
-	    ---Purpose: This class must be provided by the user to use the
-	    --          approximation algorithm FittingCurve2d.
-
 
     class FunctionTool2d;
-	    ---Purpose: This class is the inteface between the Function2d 
-	    --          class and the tool asked by LeastSquare.
-
 
 
     class FitFunction instantiates LeastSquare from AppCont

src/AppCont/AppCont_Function.cdl

@@ -17,7 +17,8 @@
 deferred class Function from AppCont
 
     ---Purpose: deferred class describing a continous 3d function f(u)
-
+    --          This class must be provided by the user to use the
+    --          approximation algorithm FittingCurve.
 
 uses Pnt from gp,
      Vec from gp

src/AppCont/AppCont_Function2d.cdl

@@ -17,7 +17,8 @@
 deferred class Function2d from AppCont
 
     ---Purpose: deferred class describing a continous 2d function f(u)
-
+    --          This class must be provided by the user to use the
+    --          approximation algorithm FittingCurve2d.
 
 uses Pnt2d from gp,
      Vec2d from gp

src/AppCont/AppCont_FunctionTool.cdl

@@ -15,7 +15,8 @@
 -- commercial license or contractual agreement.
 
 class FunctionTool from AppCont
-
+    ---Purpose: This class is the inteface between the Function
+    --          class and the tool asked by LeastSquare.
 
 uses Function        from AppCont,
      Pnt             from gp,

src/AppCont/AppCont_FunctionTool2d.cdl

@@ -15,7 +15,8 @@
 -- commercial license or contractual agreement.
 
 class FunctionTool2d from AppCont
-
+    ---Purpose: This class is the inteface between the Function2d
+    --          class and the tool asked by LeastSquare.
 
 uses Function2d      from AppCont,
      Pnt             from gp,

src/AppCont/AppCont_LeastSquare.cdl

@@ -18,8 +18,10 @@ generic class LeastSquare from AppCont(MultiLine as any;
     	    	    	    	       LineTool  as any)
 				       ---as TheToolLine(MultiLine)
 
-    ---Purpose:
+    ---Purpose: Makes an approximation of a continous Line described by
-
+    --          the tool TheLineTool.
+    --          Minimizing the difference between the approximate result
+    --          Curve and a continous MultiLine
 
 uses  Matrix          from math,
       Vector          from math,

src/AppDef/AppDef.cdl

@@ -43,25 +43,16 @@ uses AppParCurves, Approx, gp, TColgp, TCollection, Standard, MMgt, math, FEmToo
 is
 
 class MultiPointConstraint;  
-    ---Purpose: a MultiPointConstraint is a set of points which have the same range 
-    -- in the MultiLine and the same constraints.
-
 
 class MultiLine;
-    ---Purpose: this is the organized set of points.
 
 class MyLineTool;
-    ---Purpose: example of MultiLine tool corresponding to the tools of the packages
-    -- AppParCurves and Approx. For Approx, the tool will not addd points
-    -- if the algorithms want some.
 
 deferred  class  SmoothCriterion;
 
 class  LinearCriteria;
                  
 class Variational;
-     ---Purpose: computes the approximation of a Multiline by
-     --          Variational optimization.
 
 
 --- Classes instanciees:

src/AppDef/AppDef_MyLineTool.cdl

@@ -15,6 +15,9 @@
 -- commercial license or contractual agreement.
 
 class MyLineTool from AppDef
+    ---Purpose: example of MultiLine tool corresponding to the tools of the packages
+    -- AppParCurves and Approx. For Approx, the tool will not addd points
+    -- if the algorithms want some.
 
 uses MultiLine     from AppDef,
      Pnt           from gp,

src/AppDef/AppDef_Variational.cdl

@@ -23,7 +23,8 @@ class Variational from AppDef
     ---Purpose: This class is used to smooth N points with constraints
     --          by   minimization  of quadratic  criterium   but  also
     --          variational criterium in order to obtain " fair Curve "
-    --          
+    --          Computes the approximation of a Multiline by
+    --          Variational optimization.
 
 uses Matrix                    from math,
      Vector                    from math,

src/AppParCurves/AppParCurves.cdl

@@ -51,16 +51,8 @@ is
     
     
     generic class LeastSquare;
-     	---Purpose: computes in parallel the least square resolution of a 
-     	--          set of points (MultiLine). The result is a 
-     	--          set of Bezier curves (MultiCurve).
 
     generic class ResolConstraint;
-    	---Purpose: computes the approximating resolution with constraints
-    	--          starting from a guess solution issued, for example, 
-    	--          from the least squares.
-    	--          It uses the Uzawa method from the mathematical package.
-
 
     generic class Function;
 
@@ -69,17 +61,8 @@ is
     
 
     generic class Gradient,  Gradient_BFGS, ParLeastSquare, ResConstraint, ParFunction;
-    	---Purpose: computes the approximation of a MultiLine by the
-    	--          search for a new parameters to minimize the 
-    	--          sum||C(ui)-Qi||2 with a gradient method.
-
-
 
     generic class BSpGradient, BSpGradient_BFGS,  BSpParLeastSquare, BSpParFunction;
-    	---Purpose: computes the approximation of a MultiLine by the
-    	--          search for a new parameters to minimize the 
-    	--          sum||C(ui)-Qi||2 with a gradient method.
-    	--          The Result is a Bspline set.
 
 
     --- instantiate classes:

src/AppParCurves/AppParCurves_BSpGradient.cdl

@@ -25,7 +25,7 @@ generic class BSpGradient from AppParCurves
     --          sum(square(|F(i)-Qi|)) by changing the parameter. 
     --          The algorithm used is from of the mathematical 
     --          package: math_BFGS, a gradient method.
-
+    --          The Result is a Bspline set.
 
 
 uses Vector                           from math, 

src/AppParCurves/AppParCurves_LeastSquare.cdl

@@ -22,6 +22,9 @@ generic class LeastSquare from AppParCurves
     ---Purpose: This class describes the least square fitting of a
     --          MultiLine using the Householder method from the
     --          mathematical package.
+    --          Computes in parallel the least square resolution of a
+    --          set of points (MultiLine). The result is a
+    --          set of Bezier curves (MultiCurve).
     --          The problem to solve is the following one:
     --          minimizing the sum(|C(ui)- Qi|)2 where Qi are the points of
     --          the MultiLine and C(ui) the points of the approximating

src/Approx/Approx.cdl

@@ -61,11 +61,8 @@ end;
 
 
    generic class ComputeLine, MyGradient;
-    ---Purpose: Approximate a MultiLine with a cutting.
 
    generic class ComputeCLine, MyLeastSquare;
-    ---Purpose: Approximate a continous MultiLine with a cutting.
-    --          The Tool of the line is the tool from AppCont.
 
 ----------------------------------------------
 ---Algorithms for BSpline curves construction:
@@ -117,10 +114,7 @@ end;
     	(Function2d from AppCont, FunctionTool2d from AppCont);
 
     class SameParameter from Approx ;
-    ---Purpose: this makes a 3D curve from Adaptor3d and
+
-    --          a curve on surface to check and build a 2D 
-    --          BSpline curve that has the same parameterisation
-    --          as the 3D curve.
     class Array1OfAdHSurface    instantiates Array1 from TCollection 
     	    	    	    (HSurface  from  Adaptor3d)                      ;
     class HArray1OfAdHSurface  instantiates HArray1 from TCollection
@@ -133,7 +127,6 @@ end;
 			    
     --    class ApproxPoints from Approx ;
     --    class ApproxPoints  from Approx ;
-    ---Purpose:  
     --      this approximates a series of points
     --   Boundary conditions can be given as well
     --   a given parameterisation

src/Approx/Approx_ComputeCLine.cdl

@@ -17,7 +17,8 @@
 generic class ComputeCLine from Approx 
     	    	    (MultiLine as any;
     	    	     LineTool  as any)
-
+    ---Purpose: Approximate a continous MultiLine with a cutting.
+    --          The Tool of the line is the tool from AppCont.
 
 uses ParametrizationType       from Approx,
      SequenceOfReal            from TColStd,

src/Approx/Approx_ComputeLine.cdl

@@ -17,7 +17,7 @@
 generic class ComputeLine from Approx 
     	    	    (MultiLine as any;
     	    	     LineTool  as any)
-
+    ---Purpose: Approximate a MultiLine with a cutting.
 
 uses ParametrizationType       from Approx,
      SequenceOfReal            from TColStd,

src/Aspect/Aspect.cdl

@@ -93,7 +93,7 @@ is
         -- G002A study 
 
         imported CLayer2d;
-        ---Purpose: Defines the C structure <alayer>
+
         ---Category: Imported types
 
         imported RGBPixel;
@@ -101,25 +101,15 @@ is
 
         primitive Handle;
         primitive Drawable;
-        ---Purpose:
-        -- To manage Drawable
 
         primitive Display;
-        ---Purpose:
-        -- To manage Display 
 
         primitive RenderingContext;
-        ---Purpose:
-        -- To manage 2D or 3D graphic context
 
         imported GraphicCallbackProc;
-        ---Purpose:
-        -- To manage client post display 
 
         -- 22-03-04 OCC4895 SAN High-level interface for controlling polygon offsets
         imported PolygonOffsetMode;
-        ---Purpose: 
-        -- Enumeration for polygon offset modes
 
         ---------------------
         -- Category: Pointers
@@ -214,25 +204,18 @@ is
         ------------------------------
 
         deferred class ColorMap;
-        ---Purpose: Defines a color map.
         ---Category: Classes Color map
 
         class ColorCubeColorMap;
-        ---Purpose: Associates a index and a color in the "ColorCube" space.
         ---Category: Classes Color map
 
         class ColorRampColorMap;
-        ---Purpose: Associates a index and a color in the linear "ColorRamp"
-        --          space.
         ---Category: Classes Color map
 
         class GenericColorMap;
-        ---Purpose: Associates an index and a color.
         ---Category: Classes Color map
 
         class ColorMapEntry;
-        ---Purpose: Defines an entry in the color map :
-        --          an index and a color.
         ---Category: Classes Color map
 
         ------------------------------
@@ -240,15 +223,12 @@ is
         ------------------------------
 
         deferred class Pixel;
-        ---Purpose: Defines a picture element.
         ---Category: Classes Pixel
 
         class IndexPixel;
-        ---Purpose: 
         ---Category: Classes Pixel
 
         class ColorPixel;
-        ---Purpose: 
         ---Category: Classes Pixel
 
         ---------------------------
@@ -256,18 +236,12 @@ is
         ---------------------------
 
         deferred class AspectLine;
-        ---Purpose: Creates and updates a group of graphic attributes
-        --          for primitives 'Line'
         ---Category: Classes Aspect
 
         deferred class AspectMarker;
-        ---Purpose: Creates and updates a group of graphic attributes
-        --          for primitives 'Marker'.
         ---Category: Classes Aspect
 
         deferred class AspectFillArea;
-        ---Purpose: Creates and updates a group of graphic attributes
-        --          for primitives 'Face'.
         ---Category: Classes Aspect
 
         --------------------
@@ -275,79 +249,57 @@ is
         --------------------
 
         class Background;
-        ---Purpose: Defines a window background
         ---Category: Classes
 
         class GradientBackground;
-        ---Purpose: Defines a window gradient background
         ---Category: Classes
 
         class Edge;
-        ---Purpose: Defines an edge.
         ---Category: Classes
 
         class GenId;
-        ---Purpose: Creates and controles all identifiers.
         ---Category: Classes
 
         class FontStyle;
-        ---Purpose: Defines a Font Style
         ---Category: The classes
 
         class FontMapEntry;
-        ---Purpose: Defines an entry in the Font map :
-        --          an index and a text Font.
         ---Category: Classes Font map
 
         class FontMap;
-        ---Purpose: Associates an index and a text Font entry.
         ---Category: The classes
 
         class WidthMapEntry;
-        ---Purpose: Defines an entry in the Width map :
-        --          an index and a line Width.
         ---Category: Classes Width map
 
         class WidthMap;
-        ---Purpose: Associates an index and a line width entry.
         ---Category: The classes
 
         class LineStyle;
-        ---Purpose: Defines a Line Style
         ---Category: The classes
 
         class TypeMap;
-        ---Purpose: Associates an index and a line type entry.
         ---Category: The classes
 
         class TypeMapEntry;
-        ---Purpose: Defines an entry in the Type map :
-        --          an index and a line style.
         ---Category: Classes Type map
 
         class MarkerStyle;
-        ---Purpose: Defines a Marker Style
         ---Category: The classes
 
         class MarkMap;
-        ---Purpose: Associates an index and a Marker entry.
         ---Category: The classes
 
         class MarkMapEntry;
-        ---Purpose: Defines an entry in the Marker map :
-        --          an index and a marker style.
         ---Category: Classes Mark map
 
         deferred class Window;
-        ---Purpose: Defines a window.
         ---Category: Classes
 
         deferred class Driver;
-        ---Purpose: Defines a virtual driver.
         ---Category: Classes
 
         deferred class WindowDriver;
-        ---Purpose: Defines a virtual driver associated to a window.
         ---Category: Classes
 
         deferred class Grid;
@@ -355,13 +307,10 @@ is
         class CircularGrid;
 
         deferred class ColorScale;
-        ---Purpose: Defines a color scale for viewer.
 
         imported DisplayConnection;
-        ---Purpose: Creates and provides connection with X server.
 
         imported DisplayConnection_Handle;
-        ---Purpose: Handle for DisplayConnection;
 
         -------------------------
         -- Category: Enumerations

src/Aspect/Aspect_CLayer2d.hxx

@@ -17,6 +17,7 @@
 /*====									      */
 /*==== Implementation:  This is a primitive type implemented with typedef     */
 /*============================================================================*/
+// Defines the C structure <alayer>
 
 #ifndef _Aspect_CLayer2d_HeaderFile
 #define _Aspect_CLayer2d_HeaderFile

src/Aspect/Aspect_ColorCubeColorMap.cdl

@@ -19,6 +19,7 @@ class ColorCubeColorMap from Aspect inherits ColorMap from Aspect
 	---Version: 0.0
 
 	---Purpose: This class defines a ColorCube ColorMap object.
+	--          Associates a index and a color in the "ColorCube" space.
 	---Keywords:
 	---Warning:
 	---References:

src/Aspect/Aspect_ColorRampColorMap.cdl

@@ -19,6 +19,7 @@ class ColorRampColorMap from Aspect inherits ColorMap from Aspect
 	---Version: 0.0
 
 	---Purpose: This class defines a ColorRampColorMap object.
+	--          Associates a index and a color in the linear "ColorRamp" space.
 	---Keywords:
 	---Warning:
 	---References:

src/Aspect/Aspect_ColorScale.cdl

@@ -14,7 +14,7 @@
 -- commercial license or contractual agreement.
 
 deferred class ColorScale from Aspect inherits TShared from MMgt
-
+        ---Purpose: Defines a color scale for viewer.
 uses
 
        TypeOfColorScaleData     from Aspect,

src/Aspect/Aspect_Display.hxx

@@ -17,6 +17,7 @@
 /*==== "V3d"                                                           */
 /*==== Implementation:  This is a primitive type implemented with typedef     */
 /*============================================================================*/
+// To manage Display
 
 #ifndef _Aspect_Display_HeaderFile
 #define _Aspect_Display_HeaderFile

src/Aspect/Aspect_DisplayConnection_Handle.hxx

@@ -16,6 +16,8 @@
 
 #include <Standard_Transient.hxx>
 
+// Handle for DisplayConnection;
+
 class Aspect_DisplayConnection;
 DEFINE_STANDARD_HANDLE(Aspect_DisplayConnection, Standard_Transient)
 typedef Handle(Aspect_DisplayConnection) Aspect_DisplayConnection_Handle;

src/Aspect/Aspect_Drawable.hxx

@@ -17,6 +17,7 @@
 /*==== "Xw" & "WNT"                                                           */
 /*==== Implementation:  This is a primitive type implemented with typedef     */
 /*============================================================================*/
+// To manage Drawable
 
 #ifndef _Aspect_Drawable_HeaderFile
 #define _Aspect_Drawable_HeaderFile

src/Aspect/Aspect_FontMap.cdl

@@ -19,6 +19,7 @@ class FontMap from Aspect inherits TShared from MMgt
 	---Version: 0.0
 
 	---Purpose: This class defines a FontMap object.
+	--          Associates an index and a text Font entry.
 	---Keywords:
 	---Warning:
 	---References:

src/Aspect/Aspect_GenericColorMap.cdl

@@ -20,6 +20,7 @@ class GenericColorMap from Aspect inherits ColorMap from Aspect
 
 	---Level: Public
 	---Purpose: This class defines a GenericColorMap object.
+	--          Associates an index and a color.
 	---Keywords:
 	---Warning:
 	---References:

src/Aspect/Aspect_GraphicCallbackProc.hxx

@@ -14,6 +14,8 @@
 #ifndef _Aspect_GraphicCallbackProc_HeaderFile
 #define _Aspect_GraphicCallbackProc_HeaderFile
 
+// To manage client post display
+
 #include <Aspect_Display.hxx>
 #include <Aspect_Drawable.hxx>
 #include <Aspect_RenderingContext.hxx>

src/Aspect/Aspect_MarkMap.cdl

@@ -19,6 +19,7 @@ class MarkMap from Aspect inherits TShared from MMgt
 	---Version: 0.0
 
 	---Purpose: This class defines a MarkMap object.
+	--          Associates an index and a Marker entry.
 	---Keywords:
 	---Warning:
 	---References:

src/Aspect/Aspect_Pixel.cdl

@@ -19,6 +19,7 @@ deferred class Pixel from Aspect inherits Storable
 	---Version: 0.0
 
 	---Purpose: This class defines a Pixel.
+	--          Defines a picture element.
 	---Keywords:
 	---Warning:
 	---References:

src/Aspect/Aspect_PolygonOffsetMode.hxx

@@ -16,6 +16,8 @@
 #ifndef ASPECT_POLYGONOFFSETMODE_HEADER
 #define ASPECT_POLYGONOFFSETMODE_HEADER
 
+// Enumeration for polygon offset modes
+
 typedef enum 
 {
   Aspect_POM_Off   = 0x00,  /* all polygon offset modes disabled                     */

src/Aspect/Aspect_RenderingContext.hxx

@@ -17,6 +17,7 @@
 /*==== "V3d"                                                           */
 /*==== Implementation:  This is a primitive type implemented with typedef     */
 /*============================================================================*/
+// To manage 2D or 3D graphic context
 
 #ifndef _Aspect_RenderingContext_HeaderFile
 #define _Aspect_RenderingContext_HeaderFile

src/Aspect/Aspect_TypeMap.cdl

@@ -19,6 +19,7 @@ class TypeMap from Aspect inherits TShared from MMgt
 	---Version: 0.0
 
 	---Purpose: This class defines a TypeMap object.
+	--          Associates an index and a line type entry.
 	---Keywords:
 	---Warning:
 	---References:

src/Aspect/Aspect_WidthMap.cdl

@@ -19,6 +19,7 @@ class WidthMap from Aspect inherits TShared from MMgt
 	---Version: 0.0
 
 	---Purpose: This class defines a WidthMap object.
+	--          Associates an index and a line width entry.
 	---Keywords:
 	---Warning:
 	---References:

src/Aspect/Aspect_Window.cdl

@@ -14,7 +14,7 @@
 -- commercial license or contractual agreement.
 
 deferred class Window from Aspect
-
+        ---Purpose: Defines a window.
 inherits
 	TShared from MMgt
 

src/BRep/BRep.cdl

@@ -49,9 +49,6 @@ is
     --  
 
     class TFace;
-	---Purpose: The TFace  class is inherited  from the TFace from
-	--          TopoDS. It contains a  surface, a tolerance  and a
-	--          natural restriction flag.
 
     --
     --  Edge
@@ -83,92 +80,54 @@ is
     --  
 
     deferred class CurveRepresentation;
-	---Purpose: Root      for curve representations.    Contains a
-	--          location.
 
     class ListOfCurveRepresentation instantiates
     List from TCollection (CurveRepresentation from BRep);
     
     deferred class GCurve;
-	---Purpose: Root class  for geometric curves  representations.
-	--          Contains a first an a last parameter.
 
     class Curve3D;
-	---Purpose: Representation by a 3d curve.
 
     class CurveOnSurface;
-	---Purpose: Representation by a curve in the  parametric space
-	--          of a surface.
 
     class CurveOnClosedSurface;
-	---Purpose: Representation  by two   curves in the  parametric
-	--          space of a closed surface.
 
     class Polygon3D;
-	---Purpose: Representation by a 3D polygon.
 
     class PolygonOnTriangulation;
-	---Purpose: Representation by    an array  of  indices  on   a
-	--          triangulation.
 
     class PolygonOnClosedTriangulation;
-	---Purpose: Representation   by two  arrays  of indices   on a
-	--          triangulation.
 
     class PolygonOnSurface;
-	---Purpose: Representation by 2d polygon in the parametric space
-	--          of a surface.
 
     class PolygonOnClosedSurface;
-	---Purpose: Representation by two 2d polygons in the parametric
-	--          space of the  surface.
 
     class CurveOn2Surfaces;
-	---Purpose: Geometric continuity bewtween two surfaces.
 
     class TEdge;
-	---Purpose: The TEdge class is  inherited  from the TEdge from
-	--          TopoDS.   It contains a  3d   curve and  a list of
-	--          representations.
-
 
     --
     --  Vertex
     --
 
     deferred class PointRepresentation;
-	---Purpose: Root  for   point   representations.  Contains   a
-	--          location. 
 
     class ListOfPointRepresentation instantiates
     List from TCollection (PointRepresentation from BRep);
     
     class PointOnCurve;
-	---Purpose: Representation by a parameter on a 3D curve.
 
     deferred class PointsOnSurface;
-	---Purpose: Root for points on surface.
 
     class PointOnCurveOnSurface;
-	---Purpose: Representation by   a parameter on  a curve   on a
-	--          surface. 
 
     class PointOnSurface;
-	---Purpose: Representation by two parameters on a surface.
 
     class TVertex;
-	---Purpose: The TVertex class  is  inherited from the  TVertex
-	--          from    TopoDS.  It contains  a  3d  point   and a
-	--          location.
 
     class Builder;
-	---Purpose: The  Builder  from BRep is   inherited    from the
-	--          Builder3D   from  TopoDS.    It  is  used to build
-	--          Shapes.
 
     class Tool;
-	---Purpose: The Tool from BRep is used to access the geometric
-	--          data.
 
 
 end BRep;

src/BRep/BRep_Builder.cdl

@@ -17,6 +17,7 @@
 class Builder from BRep inherits Builder from TopoDS
 
         ---Purpose: A framework providing advanced tolerance control.
+  -- It is used to build Shapes.
 	-- If tolerance control is required, you are advised to:
 	-- 1. build a default precision for topology, using the
 	-- classes provided in the BRepAPI package

src/BRep/BRep_GCurve.cdl

@@ -18,7 +18,7 @@ deferred class GCurve from BRep inherits CurveRepresentation from BRep
 
 	---Purpose: Root   class    for    the    geometric     curves
 	--          representation. Contains a range.
-
+  --          Contains a first and a last parameter.
 uses
 
     Location from TopLoc,

src/BRep/BRep_PointOnCurve.cdl

@@ -16,7 +16,7 @@
 
 class PointOnCurve from BRep inherits PointRepresentation from BRep
 
-	---Purpose: 
+	---Purpose: Representation by a parameter on a 3D curve.
 
 uses
     Curve    from Geom,

src/BRep/BRep_PointOnCurveOnSurface.cdl

@@ -15,6 +15,8 @@
 -- commercial license or contractual agreement.
 
 class PointOnCurveOnSurface from BRep inherits  PointsOnSurface from  BRep
+	---Purpose: Representation by   a parameter on  a curve   on a
+	--          surface.
 
 uses
 

src/BRep/BRep_PointOnSurface.cdl

@@ -15,6 +15,7 @@
 -- commercial license or contractual agreement.
 
 class PointOnSurface from BRep inherits PointsOnSurface from BRep
+	---Purpose: Representation by two parameters on a surface.
 
 uses
     Surface  from Geom,

src/BRep/BRep_PointsOnSurface.cdl

@@ -16,7 +16,7 @@
 
 deferred class PointsOnSurface from BRep inherits PointRepresentation from BRep
 
-	---Purpose: 
+	---Purpose: Root for points on surface.
 
 uses
 

src/BRep/BRep_Polygon3D.cdl

@@ -16,7 +16,7 @@
 
 class Polygon3D from BRep inherits CurveRepresentation from BRep
 
-	---Purpose: 
+	---Purpose: Representation by a 3D polygon.
 
 uses
     Polygon3D           from Poly,

src/BRep/BRep_TVertex.cdl

@@ -19,7 +19,7 @@ class TVertex from BRep inherits TVertex from TopoDS
 	---Purpose: The TVertex from  BRep inherits  from  the TVertex
 	--          from TopoDS. It contains the geometric data.
 	--          
-	--          The  TVertex contains a 3d point and a tolerance.
+	--          The  TVertex contains a 3d point, location and a tolerance.
 	--            
 uses
     Pnt    from gp,

src/BRepAdaptor/BRepAdaptor.cdl

@@ -49,17 +49,12 @@ uses
 is
 
     class Surface;
-	---Purpose: Transforms a Face in a Surface from Adaptor3d.
 	
     class Curve;
-	---Purpose: Transforms an Edge in a Curve from Adaptor3d.
 
     class Curve2d;
-	---Purpose: Transforms an Edge   on a Face  in  a Curve2d from
-	--          Adaptor2d. 
 
     class  CompCurve; 
-    	---Purpose: Transforms a Wire in a Curve from Adaptor3d.
     	
     class HSurface instantiates GenHSurface from Adaptor3d
     	(Surface from BRepAdaptor);

src/BRepAlgo/BRepAlgo.cdl

@@ -77,10 +77,6 @@ is
     class Image; 
     class AsDes;
     class FaceRestrictor;
-        ---Purpose:Build all the faces limited with a set of non 
-        --         jointing and planars wires
-        --         The Wires must have correct orientations.
-        --         
 
     class BooleanOperations;
         ---Purpose: 
@@ -89,7 +85,7 @@ is
     class EdgeConnector;
         ---Purpose: 
     class  NormalProjection; 
-            ---Purpose: 
+
   --  class  Sewing; now it is in BRepBuilderAPI
     
     class DataMapOfShapeBoolean instantiates

src/BRepAlgoAPI/BRepAlgoAPI.cdl

@@ -98,20 +98,15 @@ uses
 is
 	     
     deferred class BooleanOperation; 
-    	---Purpose: Root class for boolean operations.
 
     class Fuse;                    
-    	---Purpose: Perform the boolean operation FUSE.
+
-    	---
     class Common;                         
-    	---Purpose: Perform the boolean operation COMMON.
+
-    	--- 
     class Cut;                           
-    	---Purpose: Perform the boolean operation CUT.
+
- 	---    
     class Section;                       
-        ---Purpose: Perform the operation SECTION. 
+
-        --- 
     class Check;
         ---Purpose: Check shapes on validity for boolean
         --- operation.

src/BRepBlend/BRepBlend.cdl

@@ -105,74 +105,35 @@ is
 
 
     class AppSurface; 
-    ---Purpose: Used to Approximate the surfaces.
 
     deferred class AppFuncRoot;
-    ---Purpose: Root Class Function to approximate by AppSurface	 
 
     class AppFunc;
-    ---Purpose: Function to approximate by AppSurface for 
-    --          Surface/Surface contact.
 
     class AppFuncRst;
-    ---Purpose: Function  to approximate by AppSurface  for  
-    --          Curve/Surface contact.
 
     class AppFuncRstRst;
-    ---Purpose: Function  to approximate by AppSurface  for  
-    --          Curve/Curve contact.
 
     class SurfRstEvolRad;
-    ---Purpose: Function  to approximate by AppSurface  for  
-    --          Edge/Face  and  evolutif  radius	 
 
     class SurfRstConstRad;
-    ---Purpose: Copy of CSConstRad with pcurve on surface 
-    --          as support. 
 
     class RstRstEvolRad;
-    ---Purpose: Function  to approximate by AppSurface  for  
+
-    --          Edge/Edge  and  evolutif  radius
-    --          
     class RstRstConstRad;
-    ---Purpose: Copy of CSConstRad with a pcurve on surface 
-    --          as support. 
 
     class SurfPointConstRadInv;
-    ---Purpose: Function of reframing between a point and a surface.
 
     class SurfCurvConstRadInv;
-    ---Purpose: Function of reframing between a restriction surface of the
-    --          surface and a curve.
 
     class SurfPointEvolRadInv;
-    ---Purpose: Fonction of reframing between a point and a surface.
 
     class CurvPointRadInv;
-    ---Purpose: Function of reframing between a point and a curve.
+
-    --          valid in cases of constant and progressive radius
     class SurfCurvEvolRadInv;
-    ---Purpose: Function of reframing between a surface restriction 
-    --          of the surface and a curve.
 
     class SurfRstLineBuilder;
-    ---Purpose: Construction of a BRepBlend_Line between a surface and
-    --          a pcurve on surface from an approached
-    --          starting solution. The output entries of this builder
-    --          are of the same nature as of the traditional walking
-    --          but the requirements on the Line are not the same
-    --          If the determination of validity range is always
-    --          guaranteed, the criteria of correct repartition of sections 
-    --          before smoothing are not respected. The resulting Line
-    --          is f(t) oriented.
 
     class RstRstLineBuilder;
-    ---Purpose: Construction of a BRepBlend_Line between two pcurves
+
-    --          from an approached starting solution. The output
-    --          entries of this builder are of the same nature 
-    --          as of a traditional walking, but the requirements 
-    --          to the Line are not the same. If the determination of validity range is always
-    --          guaranteed, the criteria of correct repartition of sections 
-    --          before smoothing are not respected. The resulting Line
-    --          is f(t) oriented.          
 end BRepBlend;

src/BRepBlend/BRepBlend_AppFunc.cdl

@@ -17,6 +17,7 @@
 class AppFunc from BRepBlend inherits AppFuncRoot from BRepBlend
 
 	---Purpose: Function to approximate by AppSurface
+	--          for Surface/Surface contact.
 	---Level: Advanced
 
 uses

src/BRepBlend/BRepBlend_AppFuncRst.cdl

@@ -15,7 +15,7 @@
 -- commercial license or contractual agreement.
 
 class AppFuncRst from BRepBlend inherits AppFuncRoot from BRepBlend
-	---Purpose: Function to approximate by AppSurface for Edge/Face          
+	---Purpose: Function  to approximate by AppSurface  for Curve/Surface contact.
 	---Level: Advanced
 
 uses 

src/BRepBlend/BRepBlend_AppFuncRstRst.cdl

@@ -15,7 +15,7 @@
 -- commercial license or contractual agreement.
 
 class AppFuncRstRst from BRepBlend inherits AppFuncRoot from BRepBlend
-	---Purpose: Function to approximate by AppSurface for Edge/Face          
+	---Purpose: Function to approximate by AppSurface for Edge/Face (Curve/Curve contact).
 	---Level: Advanced
 
 uses 

src/BRepBlend/BRepBlend_CurvPointRadInv.cdl

@@ -18,7 +18,9 @@ class CurvPointRadInv from BRepBlend
 
 inherits CurvPointFuncInv from Blend 
 
-    ---Purpose: This function  is used  to find a  solution on  a done
+    ---Purpose: Function of reframing between a point and a curve.
+    --          valid in cases of constant and progressive radius.
+    --          This function  is used  to find a  solution on  a done
     --          point   of   the curve 1 when   using  RstRstConsRad or
     --          CSConstRad... 
     --          The vector <X>  used in Value, Values and  Derivatives

src/BRepBlend/BRepBlend_RstRstConstRad.cdl

@@ -17,7 +17,8 @@
 class RstRstConstRad from BRepBlend
 inherits RstRstFunction from Blend
 
-	---Purpose: 
+    ---Purpose: Copy of CSConstRad with a pcurve on surface
+    --          as support.
 
 uses Vector          from math,
      Matrix          from math,

src/BRepBlend/BRepBlend_RstRstEvolRad.cdl

@@ -17,6 +17,8 @@
 class RstRstEvolRad from BRepBlend
 inherits RstRstFunction from Blend
 
+    ---Purpose: Function  to approximate by AppSurface  for
+    --          Edge/Edge  and  evolutif  radius
 
 uses Vector               from math,
      Matrix               from math,

src/BRepBlend/BRepBlend_RstRstLineBuilder.cdl

@@ -36,6 +36,15 @@ class RstRstLineBuilder from BRepBlend
       --          3) stall as there  is a solution of problem
       --          surf/surf  within the domain  of the  surface
       --          of support of the restriction.
+      --
+      --          Construction of a BRepBlend_Line between two pcurves
+      --          from an approached starting solution. The output
+      --          entries of this builder are of the same nature
+      --          as of a traditional walking, but the requirements
+      --          to the Line are not the same. If the determination of validity range is always
+      --          guaranteed, the criteria of correct repartition of sections
+      --          before smoothing are not respected. The resulting Line
+      --          is f(t) oriented.
 
 uses Point            from Blend,
      Status           from Blend,

src/BRepBlend/BRepBlend_SurfCurvConstRadInv.cdl

@@ -18,7 +18,9 @@ class SurfCurvConstRadInv from BRepBlend
 
 inherits SurfCurvFuncInv from Blend
 
-    ---Purpose: Class     used   to   compute  a    solution   of  the
+    ---Purpose: Function of reframing between a restriction surface of the
+    --          surface and a curve.
+    --          Class     used   to   compute  a    solution   of  the
     --          surfRstConstRad  problem  on a done restriction of the
     --          surface.          
     --          The vector  <X> used in  Value, Values and Derivatives

src/BRepBlend/BRepBlend_SurfCurvEvolRadInv.cdl

@@ -18,7 +18,9 @@ class SurfCurvEvolRadInv from BRepBlend
 
 inherits SurfCurvFuncInv from Blend
 
-    ---Purpose: Class     used   to   compute  a    solution   of  the
+    ---Purpose: Function of reframing between a surface restriction
+    --          of the surface and a curve.
+    --          Class     used   to   compute  a    solution   of  the
     --          surfRstConstRad  problem  on a done restriction of the
     --          surface.
     --          The vector  <X> used in  Value, Values and Derivatives

src/BRepBlend/BRepBlend_SurfPointConstRadInv.cdl

@@ -18,7 +18,8 @@ class SurfPointConstRadInv from BRepBlend
 
 inherits SurfPointFuncInv from Blend 
 
-    ---Purpose: This function  is used  to find a  solution on  a done
+    ---Purpose: Function of reframing between a point and a surface.
+    --          This function  is used  to find a  solution on  a done
     --          point   of   the curve when   using  SurfRstConsRad or
     --          CSConstRad...          
     --          The vector <X>  used in Value, Values and  Derivatives

src/BRepBlend/BRepBlend_SurfPointEvolRadInv.cdl

@@ -18,7 +18,8 @@ class SurfPointEvolRadInv from BRepBlend
 
 inherits SurfPointFuncInv from Blend
 
-    ---Purpose: This function  is used  to find a  solution on  a done
+    ---Purpose: Function of reframing between a point and a surface.
+    --          This function  is used  to find a  solution on  a done
     --          point   of   the curve when   using  SurfRstConsRad or
     --          CSConstRad...
     --          The vector <X>  used in Value, Values and  Derivatives

src/BRepBlend/BRepBlend_SurfRstConstRad.cdl

@@ -17,6 +17,8 @@
 class SurfRstConstRad from BRepBlend
 inherits SurfRstFunction from Blend
 
+    ---Purpose: Copy of CSConstRad with pcurve on surface
+    --          as support.
 
 uses Vector          from math,
      Matrix          from math,

src/BRepBlend/BRepBlend_SurfRstEvolRad.cdl

@@ -17,7 +17,8 @@
 class SurfRstEvolRad from BRepBlend
 inherits SurfRstFunction from Blend
 
-	---Purpose: 
+    ---Purpose: Function  to approximate by AppSurface  for
+    --          Edge/Face  and  evolutif  radius
 
 uses Vector          from math,
      Matrix          from math,

src/BRepBlend/BRepBlend_SurfRstLineBuilder.cdl

@@ -34,6 +34,16 @@ class SurfRstLineBuilder from BRepBlend
       --          3)  stall as there  is a solution to  the problem
       --          surf/surf  within  the  domain of  the surface
       --          of  support  of  the   restriction.
+      --
+      --          Construction of a BRepBlend_Line between a surface and
+      --          a pcurve on surface from an approached
+      --          starting solution. The output entries of this builder
+      --          are of the same nature as of the traditional walking
+      --          but the requirements on the Line are not the same
+      --          If the determination of validity range is always
+      --          guaranteed, the criteria of correct repartition of sections
+      --          before smoothing are not respected. The resulting Line
+      --          is f(t) oriented.
 
 uses Point            from Blend,
      Status           from Blend,

src/BRepBuilderAPI/BRepBuilderAPI.cdl

@@ -231,10 +231,8 @@ is
     end  TransitionMode; 
 
     deferred class Command;
-	---Purpose: Root class for all BRepBuilderAPI commands.
 
     deferred class MakeShape;
-	---Purpose: Root class for all shape constructions.
 
     -- 
     -- Construction of topology from geometry
@@ -260,10 +258,6 @@ is
     -- 
 
     class  Sewing;
-	---Purpose: Provides a tool to
-	--          - identify contigous boundaries (for control
-	--            of continuity: C0, C1, ...)
-	--          - assemble contigous shapes into one shape.
 
     -- 
     --  Construction of composite topologies
@@ -284,9 +278,6 @@ is
     class Transform;
 
     class NurbsConvert ;
-    ---Purpose: converts all 3D analytical representation of surfaces 
-    --          and curves to NURBS execpt for Planes
-    --          
 
     class GTransform;
 

src/BRepBuilderAPI/BRepBuilderAPI_NurbsConvert.cdl

@@ -16,10 +16,11 @@
 
 class NurbsConvert from BRepBuilderAPI inherits ModifyShape from BRepBuilderAPI
 
-	---Purpose: Conversion of the complete geometry of a shape into
+	---Purpose: Conversion of the complete geometry of a shape
-    	-- NURBS geometry. For example, all curves supporting
+      -- (all 3D analytical representation of surfaces and curves)
-    	-- edges of the basis shape are converted into BSpline
+      -- into NURBS geometry (execpt for Planes). For example,
-    	-- curves, and all surfaces supporting its faces are
+      -- all curves supporting edges of the basis shape are converted
+      -- into BSpline curves, and all surfaces supporting its faces are
       -- converted into BSpline surfaces.
 
 uses 

src/BRepBuilderAPI/BRepBuilderAPI_Sewing.cdl

@@ -26,7 +26,7 @@ class Sewing from BRepBuilderAPI inherits TShared from MMgt
 	---Purpose: Provides methods to
 	--           
 	--          - identify possible contigous boundaries (for control
-	--            afterwards)
+	--            afterwards (of continuity: C0, C1, ...))
 	--            
 	--          - assemble contigous shapes into one shape.
 	--            Only manifold shapes will be found. Sewing will not

src/BRepClass/BRepClass.cdl

@@ -36,19 +36,14 @@ uses
 
 is
     class Edge;
-	---Purpose: Stores the Edge and the Face.
 
     class Intersector;
-	---Purpose: Intersect an Edge  with a segment.   This class is
-	--          inherited   from   IntConicCurveOfGInter      from
-	--          Geom2dInt.
 
     class FacePassiveClassifier instantiates Classifier2d from TopClass
     	(Edge         from BRepClass,
 	 Intersector  from BRepClass);
 
     class FaceExplorer;
-	---Purpose: Exploration of a Face to return UV edges.
 
     class FClassifier instantiates FaceClassifier from TopClass
     	(FaceExplorer from BRepClass,
@@ -56,8 +51,5 @@ is
 	 Intersector  from BRepClass);
 	 
     class FaceClassifier;
-	---Purpose: Inherited    from   FClassifier   to   provide   a
-	--          Constructor with a Face.
-
 
 end BRepClass;

src/BRepClass/BRepClass_FaceClassifier.cdl

@@ -16,7 +16,7 @@
 
 class FaceClassifier from BRepClass inherits FClassifier from BRepClass
 
-	---Purpose: Provides Constructors.
+	---Purpose: Provides Constructors with a Face.
 
 uses
     FaceExplorer from BRepClass,

src/BRepClass/BRepClass_FaceExplorer.cdl

@@ -19,7 +19,7 @@
 class FaceExplorer from BRepClass 
 
 	---Purpose: Provide an   exploration of a  BRep Face   for the
-	--          classification.
+	--          classification. Return UV edges.
 
 uses
     Orientation  from TopAbs,

src/BRepClass/BRepClass_Intersector.cdl

@@ -17,7 +17,8 @@
 class Intersector from BRepClass 
 inherits IntConicCurveOfGInter from Geom2dInt
 
-	---Purpose: Implement the Intersector2d required by the classifier.
+	---Purpose: Intersect an Edge  with a segment.
+	--          Implement the Intersector2d required by the classifier.
 
 uses
     Lin2d from gp,

src/BRepFill/BRepFill.cdl

@@ -76,10 +76,6 @@ 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; 
@@ -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 PipeShell; 
 
     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,11 +117,8 @@ 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;  
      
@@ -196,20 +174,8 @@ 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;
     

src/BRepFill/BRepFill_CompatibleWires.cdl

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

src/BRepFill/BRepFill_CurveConstraint.cdl

@@ -15,6 +15,9 @@
 -- commercial license or contractual agreement.
 
 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
 

src/BRepLib/BRepLib.cdl

@@ -93,10 +93,8 @@ is
     end ShapeModification;
 
     deferred class Command;
-	---Purpose: Root class for all BRepBuilderAPI commands.
 
     deferred class MakeShape;
-	---Purpose: Root class for all shape constructions.
 
     -- 
     -- Construction of topology from geometry
@@ -131,7 +129,6 @@ is
 
 
     class FindSurface;
-	---Purpose: Find a surface in a set of edges.
 
     class FuseEdges;
 	---Purpose: 

src/BRepMAT2d/BRepMAT2d.cdl

@@ -32,19 +32,10 @@ uses
     
 is
     class Explorer;
-    	---Purpose: Construct an  explorer for  the computation of the 
-    	--          bisecting locus  from a Wire, a  Face, or a set of 
-    	--          curves from Geom2d.
 
     class BisectingLocus;
-	---Purpose: Constuction of the map of the bisector locus on a
-    	--          set of geometrys from Geom2d.
-	
-	---Purpose: the map of bisecting locus.
 
     class LinkTopoBilo;
-    	---Purpose: Constucts links between the Wire or the Face and
-    	--          the BasicElts contained in the bisecting locus.
 
 
     class DataMapOfShapeSequenceOfBasicElt instantiates DataMap from TCollection 

src/BRepMAT2d/BRepMAT2d_LinkTopoBilo.cdl

@@ -16,7 +16,7 @@
 
 class LinkTopoBilo from BRepMAT2d 
 
-	---Purpose:Constucts links between the Face of the explorer and
+	---Purpose:Constucts links between the Wire or the Face of the explorer and
     	--         the BasicElts contained in the bisecting locus. 
 
 uses

src/BRepMesh/BRepMesh.cdl

@@ -167,7 +167,6 @@ is    enumeration DegreeOfFreedom is
       imported ClassifierPtr; -- smart pointer on Classifier
 
       class IncrementalMesh from BRepMesh;
-      ---Purpose: meshes faces from a Shape only if necessary.
 
          ---- classes moved from MeshShape
       class GeomTool;

src/BRepMesh/BRepMesh_IncrementalMesh.cdl

@@ -19,8 +19,8 @@ class IncrementalMesh from BRepMesh
 inherits DiscretRoot from BRepMesh
 
     ---Purpose: Builds the mesh of a shape with respect of their
-    --          correctly triangulated parts
+    --          correctly triangulated parts.
-    --
+    --          Meshes faces from a Shape only if necessary.
 
 uses
     Box from Bnd,

src/BRepOffset/BRepOffset.cdl

@@ -84,12 +84,6 @@ is
     class Inter2d;
     
     class Offset;
-    	---Purpose: This class compute elemenary offset surface.
-	--          Evaluate the offset generated :
-	--               1 - from a face.
-	--               2 - from an edge.
-	--               3 - from a vertex.
-	--               
 
     class Analyse;
 

src/BRepOffset/BRepOffset_Offset.cdl

@@ -16,8 +16,11 @@
 
 class Offset from BRepOffset 
 
-	---Purpose: class for the creation of Offseting.
+	---Purpose: This class compute elemenary offset surface.
-
+	--          Evaluate the offset generated :
+	--               1 - from a face.
+	--               2 - from an edge.
+	--               3 - from a vertex.
 uses
     
     Status              from BRepOffset,

src/BRepOffsetAPI/BRepOffsetAPI.cdl

@@ -46,12 +46,8 @@ is
     -- 
 
     class MakePipe;        ---  inherits MakeSweep from BRepPrimAPI    
-	---Purpose: To create shape by pipe
 
     class MakePipeShell;  ---  inherits MakeSweep from BRepPrimAPI
-    	---Purpose: Numerous posibilities to create shell by sweeping          
-     
-
 
     class  MakeDraft; ---  inherits MakeShape from BRepBuilderAPI
     
@@ -61,8 +57,6 @@ is
 
 
     class FindContigousEdges;
-      ---Purpose: find the contigous edges of shapes for control
-      --          (continuity C0, C1, ...)
 
     alias Sewing  is  Sewing from BRepBuilderAPI;
       ---Purpose: sew the shapes along their common edges
@@ -74,13 +68,11 @@ is
     -- 
     
     class MakeOffset;     ---  inherits MakeShape from BRepBuilderAPI
-	---Purpose: Offsets to a set of plane wires.
 
     class MakeOffsetShape; ---  inherits MakeShape from BRepBuilderAPI
     	--Purpose: Offset shape to shells or solids.
 
     class MakeThickSolid;    ---   inherits MakeOffsetShape from BRepOffsetAPI
-	---Purpose: Thick solid to shells or solids.
 
     class MakeEvolved;    ---  inherits MakeShape from BRepBuilderAPI
 
@@ -100,15 +92,6 @@ is
     --     
     class MakeFilling;  ---  inherits MakeShape from BRepBuilderAPI
 
-	---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.
-     
     class SequenceOfSequenceOfReal instantiates 
     	Sequence from TCollection (SequenceOfReal from TColStd);
 

src/BRepPrimAPI/BRepPrimAPI.cdl

@@ -110,7 +110,6 @@ is
     class MakeWedge;               ---  inherits MakeShape from BRepBuilderAPI
     
     deferred class MakeOneAxis;    ---  inherits MakeShape from BRepBuilderAPI
-	---Purpose: Root class for rotational primitives.
     
     class MakeCylinder;            ---  inherits MakeShape from BRepBuilderAPI
     

src/BRepProj/BRepProj.cdl

@@ -34,9 +34,6 @@ is
 
     
     class  Projection; 
-        ---Purpose: provides  conical  and  cylindrical projections of  
-        --          Edge  or Wire  on  a Shape from TopoDS. The result  
-        --          will be a Edge  or  Wire  from  TopoDS.    
 
 
 end BRepProj;