0028189: Result of Boolean operation is non-manifold wire

1. The result of Boolean operation on the arguments of collection type, containers WIRE/SHELL/COMPSOLID, is also a collection.
The containers of type WIRE included into result should now also (as the SHELLs) have coherent orientation of its sub-shapes.
For that the new method has been implemented (BOPTools_AlgoTools::OrientEdgesOnWire(TopoDS_Shape&)) which reorients edges for correct ordering.
The duplicating containers, i.e. containers with the contents completely included in other containers, are now avoided in the result of BOP.
2. The result of Fuse operation on Compsolids is now also will be Compsolid.
3. Documentation has been updated.
4. New test cases for the issue.
5. Adjusting test cases to current behavior.

Correction of test case bugs/modalg_4/bug726_2 according to the new behavior

tests/boolean/bcommon_2d/F3

@@ -3,7 +3,7 @@ restore [locate_data_file offset_wire_034.brep] b
 
 bcommon result b a
 
-checkprops result -l 691.95
+checkprops result -l 345.975
 checksection result
 checknbshapes result -vertex 8 -edge 7 -t
 

tests/boolean/bcommon_2d/F4

@@ -3,7 +3,7 @@ restore [locate_data_file case_3_wire2.brep] b
 
 bcommon result b a
 
-checkprops result -l 691.95
+checkprops result -l 345.975
 checksection result
 checknbshapes result -vertex 14 -edge 13 -t
 

tests/boolean/bcommon_2d/F5

@@ -3,7 +3,7 @@ restore [locate_data_file case_3_wire5.brep] b
 
 bcommon result b a
 
-checkprops result -l 132.732
+checkprops result -l 66.3661
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bcommon_2d/N8

@@ -3,7 +3,7 @@ restore [locate_data_file case_9_wire1.brep] b
 
 bcommon result b a
 
-checkprops result -l 287.575
+checkprops result -l 143.787
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bcommon_2d/N9

@@ -3,7 +3,7 @@ restore [locate_data_file case_9_wire2.brep] b
 
 bcommon result b a
 
-checkprops result -l 287.575
+checkprops result -l 143.787
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bcommon_2d/O1

@@ -3,7 +3,7 @@ restore [locate_data_file case_9_wire3.brep] b
 
 bcommon result b a
 
-checkprops result -l 159.8
+checkprops result -l 79.9002
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bcommon_2d/O7

@@ -3,7 +3,7 @@ restore [locate_data_file case_9_wire1.brep] b
 
 bcommon result b a
 
-checkprops result -l 287.575
+checkprops result -l 143.787
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t