Documentation - Fix whitespaces and typos (#821)

- Removed excessive whitespace between words in comments
- Removed <br> syntax
- Fixed spelling errors ("hilight" → "highlights", "texte" → "text")
- Improved comment formatting and structure

src/ModelingData/TKBRep/BRepTools/BRepTools.hxx

@@ -45,7 +45,7 @@ class Geom2d_Curve;
 class Geom_Surface;
 class OSD_FileSystem;
 
-//! The BRepTools package provides  utilities for BRep
+//! The BRepTools package provides utilities for BRep
 //! data structures.
 //!
 //! * WireExplorer: Tool to explore the topology of

src/ModelingData/TKBRep/BRepTools/BRepTools_ReShape.hxx

@@ -167,9 +167,9 @@ protected:
   //!
   //! If the first shape has the reversed orientation
   //! then the both shapes are reversed.
-  //! If the first shape has the internal or external orientation then: <br>
+  //! If the first shape has the internal or external orientation then:
   //! - the second shape is oriented forward (reversed) if it's orientation
-  //!   is equal (not equal) to the orientation of the first shape; <br>
+  //!   is equal (not equal) to the orientation of the first shape;
   //! - the first shape is oriented forward.
   Standard_EXPORT virtual void replace(const TopoDS_Shape&    shape,
                                        const TopoDS_Shape&    newshape,

src/ModelingData/TKBRep/TopTools/TopTools_ShapeSet.hxx

@@ -98,7 +98,7 @@ public:
   //! Writes the geometry calling WriteGeometry.
   //!
   //! Dumps the shapes from last to first.
-  //! For each shape  :
+  //! For each shape:
   //! Write the type.
   //! calls WriteGeometry(S).
   //! Write the flags, the subshapes.