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/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*    theVStartEnd,
+                         Standard_Real*    theUStartEnd,  //!< First and last parameters in U
+                         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