Update documentation for OCCT 8.0.0: clarify usage of NCollection_HSequence and update method signatures in OCAF and Shape Healing sections

Author: dpasukhi

dox/user_guides/foundation_classes/foundation_classes.md

@@ -1021,16 +1021,18 @@ Let see an example of NCollection template class instantiation for a sequence of
 typedef NCollection_Sequence<gp_Pnt> MyPackage_SequenceOfPnt;
 ~~~~
 
-For the case when a sequence needs to be managed by handle, use `occ::handle<NCollection_Sequence<T>>` directly:
+For the case when a sequence needs to be managed by handle, use `NCollection_HSequence<T>` (which inherits from both `NCollection_Sequence<T>` and `Standard_Transient`):
+
 ~~~~{.cpp}
-#include <NCollection_Sequence.hxx>
+#include <NCollection_HSequence.hxx>
 #include <gp_Pnt.hxx>
 typedef NCollection_Sequence<gp_Pnt> MyPackage_SequenceOfPnt;
+typedef NCollection_HSequence<gp_Pnt> MyPackage_HSequenceOfPnt;
 ...
-occ::handle<MyPackage_SequenceOfPnt> aSeq = new MyPackage_SequenceOfPnt();
+occ::handle<MyPackage_HSequenceOfPnt> aSeq = new MyPackage_HSequenceOfPnt();
 ~~~~
 
-The legacy `DEFINE_HSEQUENCE` macro is retained for compatibility with existing code, but new code should prefer direct use of `occ::handle<NCollection_Sequence<T>>`.
+The legacy `DEFINE_HSEQUENCE` macro is removed in OCCT 8.0.0. Existing code using it should be migrated to `NCollection_HSequence<T>` (the `migrate_hcollections.py` script in `adm/` automates this conversion).
 
 See more details about available collections in following sections.
 

dox/user_guides/modeling_algos/modeling_algos.md

@@ -927,7 +927,7 @@ The algorithm  will function with any class inheriting *Geom_Surface*.
 ~~~~{.cpp}
 gp_Pnt P; 
 occ::handle<Geom_Surface> aSurf = new Geom_BezierSurface(...); 
-GeomAPI_ProjectPointOnSurf Proj (P, S); 
+GeomAPI_ProjectPointOnSurf Proj (P, aSurf); 
 ~~~~
 
 To restrict the search  for normals within the given rectangular domain [U1, U2, V1, V2], use the  constructor <i>GeomAPI_ProjectPointOnSurf Proj (P, S, U1, U2, V1, V2)</i>

dox/user_guides/ocaf/ocaf.md

@@ -1640,30 +1640,30 @@ for (; anIterator.More(); anIterator.Next())
 
 ~~~~{.cpp}
 
-    // A virtual method  ::Arguments() returns a list of arguments of the function.  
-    CylinderDriver::Arguments( NCollection_List<TDF_Label>& args )  
-    {  
+    // A virtual method ::Arguments() returns a list of arguments of the function.
+    void CylinderDriver::Arguments( NCollection_List<TDF_Label>& args )
+    {
       // The direct arguments, located at sub-leaves of the function, are collected (see picture 2)
-      TDF_ChildIterator  cIterator( Label(), false );  
-      for (;  cIterator.More(); cIterator.Next() )  
-      {  
-        // Direct argument.  
-        TDF_Label  sublabel = cIterator.Value();  
-        args.Append(  sublabel );  
-
-        // The references to the external data are  checked.  
-        occ::handle<TDF_Reference>  ref;  
-        if (  sublabel.FindAttribute( TDF_Reference::GetID(), ref ) )  
-        {  
-          args.Append(  ref->Get() );  
+      TDF_ChildIterator  cIterator( Label(), false );
+      for (;  cIterator.More(); cIterator.Next() )
+      {
+        // Direct argument.
+        TDF_Label  sublabel = cIterator.Value();
+        args.Append(  sublabel );
+
+        // The references to the external data are  checked.
+        occ::handle<TDF_Reference>  ref;
+        if (  sublabel.FindAttribute( TDF_Reference::GetID(), ref ) )
+        {
+          args.Append(  ref->Get() );
         }
     }
-     
-    // A virtual method ::Results()  returns a list of result leaves.  
-    CylinderDriver::Results( NCollection_List<TDF_Label>& res )  
-    {  
-      // The result is kept at the function  label.  
-      res.Append(  Label() );  
+
+    // A virtual method ::Results() returns a list of result leaves.
+    void CylinderDriver::Results( NCollection_List<TDF_Label>& res )
+    {
+      // The result is kept at the function  label.
+      res.Append(  Label() );
     }
      
     // Execution of the function  driver.  

dox/user_guides/shape_healing/shape_healing.md

@@ -1320,7 +1320,7 @@ ShapeUpgrade_ShapeConvertToBezier aConvToBez (theShape);
 aConvToBez.SetSurfaceConversion (true);
 aConvToBez.SetPlaneMode (true);
 aConvToBez.Perform();
-if (aConvToBez.Status(ShapeExtend_DONE)
+if (aConvToBez.Status(ShapeExtend_DONE))
 {
   TopoDS_Shape aResult = aConvToBez.Result();
 }