0029746: Modeling Algoriothms - declare Boolean operation classes in BRepAlgo package as deprecated

The API classes in the package BRepAlgo providing access to old Boolean operations (Fuse, Common, Cut, Section) are marked as deprecated.
Corresponding classes from the package BRepAlgoAPI should be used instead.

dox/dev_guides/upgrade/upgrade.md

@@ -1515,7 +1515,7 @@ Multiple changes have been applied to lights management within TKV3d and TKOpenG
   (preserving most methods of V3d_Light sub-classes to simplify porting).
 * Obsolete debugging functionality for drawing lights source has been removed from V3d_Light.
   Methods and constructors taking parameters for this drawing and not affecting light definition itself has been also removed.
-* Light constructors taking V3d_Viewer has been marked deprecated.
+* Light constructors taking V3d_Viewer have been marked deprecated.
   Application may call V3d_Viewer::AddLight() explicitly to register new light sources created by new constructors within V3d_Viewer, but this step is now optional.
 * The upper limit of 8 light sources has been removed.
 * Dedicated classes per light source type V3d_AmbientLight, V3d_DirectionalLight, V3d_PositionalLight and V3d_SpotLight have been preserved,
@@ -1561,3 +1561,12 @@ Since new version, these unclassified faces are no longer added into resulting s
 The following public methods of the *BOPAlgo_BuilderSolid* class have been removed as excessive:
 * void SetSolid(const TopoDS_Solid& theSolid);
 * const TopoDS_Solid& Solid() const;
+
+@subsection upgrade_730_BRepAlgoBO Boolean Operation classes in BRepAlgo are deprecated
+
+The API classes in the package BRepAlgo providing access to old Boolean operations are marked as deprecated:
+* BRepAlgo_Fuse
+* BRepAlgo_Common
+* BRepAlgo_Cut
+* BRepAlgo_Section
+Corresponding classes from the package BRepAlgoAPI should be used instead.

src/BRepAlgo/BRepAlgo_Common.cxx

@@ -18,6 +18,8 @@
 #include <BRepAlgo_Common.hxx>
 #include <TopoDS_Shape.hxx>
 
+Standard_DISABLE_DEPRECATION_WARNINGS
+
 //=======================================================================
 //function : BRepAlgo_Common
 //purpose  : 
@@ -30,3 +32,5 @@ BRepAlgo_Common::BRepAlgo_Common(const TopoDS_Shape& S1,
   PerformDS();
   Perform(TopAbs_IN,TopAbs_IN);
 }
+
+Standard_ENABLE_DEPRECATION_WARNINGS

src/BRepAlgo/BRepAlgo_Common.hxx

@@ -31,7 +31,8 @@ class TopoDS_Shape;
 //! - defining the construction of a common shape,
 //! - implementing the construction algorithm, and
 //! - consulting the result.
-class BRepAlgo_Common  : public BRepAlgo_BooleanOperation
+class Standard_DEPRECATED("This class is deprecated - BRepAlgoAPI_Common should be used instead")
+  BRepAlgo_Common  : public BRepAlgo_BooleanOperation
 {
 public:
 

src/BRepAlgo/BRepAlgo_Cut.cxx

@@ -18,6 +18,8 @@
 #include <BRepAlgo_Cut.hxx>
 #include <TopoDS_Shape.hxx>
 
+Standard_DISABLE_DEPRECATION_WARNINGS
+
 //=======================================================================
 //function : BRepAlgo_Cut
 //purpose  : 
@@ -30,3 +32,5 @@ BRepAlgo_Cut::BRepAlgo_Cut(const TopoDS_Shape& S1,
   PerformDS();
   Perform(TopAbs_OUT,TopAbs_IN);
 }
+
+Standard_ENABLE_DEPRECATION_WARNINGS

src/BRepAlgo/BRepAlgo_Cut.hxx

@@ -31,7 +31,8 @@ class TopoDS_Shape;
 //! - defining the construction of a cut shape,
 //! - implementing the construction algorithm, and
 //! - consulting the result.
-class BRepAlgo_Cut  : public BRepAlgo_BooleanOperation
+class Standard_DEPRECATED("This class is deprecated - BRepAlgoAPI_Cut should be used instead")
+  BRepAlgo_Cut : public BRepAlgo_BooleanOperation
 {
 public:
 

src/BRepAlgo/BRepAlgo_Fuse.cxx

@@ -18,6 +18,8 @@
 #include <BRepAlgo_Fuse.hxx>
 #include <TopoDS_Shape.hxx>
 
+Standard_DISABLE_DEPRECATION_WARNINGS
+
 //=======================================================================
 //function : BRepAlgo_Fuse
 //purpose  : 
@@ -30,3 +32,5 @@ BRepAlgo_Fuse::BRepAlgo_Fuse(const TopoDS_Shape& S1,
   PerformDS();
   Perform(TopAbs_OUT,TopAbs_OUT);
 }
+
+Standard_ENABLE_DEPRECATION_WARNINGS

src/BRepAlgo/BRepAlgo_Fuse.hxx

@@ -31,7 +31,8 @@ class TopoDS_Shape;
 //! - defining the construction of a fused shape,
 //! - implementing the construction algorithm, and
 //! - consulting the result.
-class BRepAlgo_Fuse  : public BRepAlgo_BooleanOperation
+class Standard_DEPRECATED("This class is deprecated - BRepAlgoAPI_Fuse should be used instead")
+  BRepAlgo_Fuse  : public BRepAlgo_BooleanOperation
 {
 public:
 

src/BRepAlgo/BRepAlgo_Section.cxx

@@ -34,6 +34,8 @@
 
 static TopoDS_Shape MakeShape(const Handle(Geom_Surface)& );
 
+Standard_DISABLE_DEPRECATION_WARNINGS
+
 //=======================================================================
 //function : BRepAlgo_Section
 //purpose  : 
@@ -352,3 +354,5 @@ TopoDS_Shape MakeShape(const Handle(Geom_Surface)& S)
   if (c >= GeomAbs_C2) return BRepBuilderAPI_MakeFace(S, Precision::Confusion());
   else return BRepBuilderAPI_MakeShell(S);
 }
+
+Standard_ENABLE_DEPRECATION_WARNINGS

src/BRepAlgo/BRepAlgo_Section.hxx

@@ -54,7 +54,8 @@ class Geom_Surface;
 //! S.Build();
 //! TopoDS_Shape R = S.Shape();
 //! On Null Shapes of geometries, NotDone() is called.
-class BRepAlgo_Section  : public BRepAlgo_BooleanOperation
+class Standard_DEPRECATED("This class is deprecated - BRepAlgoAPI_Section should be used instead")
+  BRepAlgo_Section  : public BRepAlgo_BooleanOperation
 {
 public:
 

src/BRepTest/BRepTest_TopologyCommands.cxx

@@ -45,6 +45,8 @@
 #include <TopTools_IndexedMapOfShape.hxx>
 #include <TopExp.hxx>
 
+Standard_DISABLE_DEPRECATION_WARNINGS
+
 //=======================================================================
 // topop
 //=======================================================================
@@ -154,6 +156,8 @@ static Standard_Integer psection(Draw_Interpretor& , Standard_Integer n, const c
   return 0;
 }
 
+Standard_ENABLE_DEPRECATION_WARNINGS
+
 static Standard_Integer halfspace(Draw_Interpretor& di,
 				  Standard_Integer n, const char** a)
 {