Documentation - Update parameter annotations for consistency #161

Reorganized style for param to the next templates:
 - "@param theParameter description ..."
 - "@param[in] theParameter description ..."
 - "@param[out] theParameter description ..."
 - "@param[in][out] theParameter description ..."
 The replacement was with keeping spacing, no removing of extra spaces.
In some files '/' was used instead of '@', that was not updated yet.

src/AIS/AIS_Animation.hxx

@@ -172,7 +172,7 @@ public:
   bool IsStopped() { return myState != AnimationState_Started; }
 
   //! Update single frame of animation, update timer state
-  //! @param thePts [in] the time moment within [0; Duration()]
+  //! @param[in] thePts  the time moment within [0; Duration()]
   //! @return True if timeline is in progress
   Standard_EXPORT virtual Standard_Boolean Update (const Standard_Real thePts);
 

src/AIS/AIS_ColorScale.hxx

@@ -373,11 +373,11 @@ public:
 public:
 
   //! Returns the width of text.
-  //! @param theText [in] the text of which to calculate width.
+  //! @param[in] theText  the text of which to calculate width.
   Standard_EXPORT Standard_Integer TextWidth (const TCollection_ExtendedString& theText) const;
 
   //! Returns the height of text.
-  //! @param theText [in] the text of which to calculate height.
+  //! @param[in] theText  the text of which to calculate height.
   Standard_EXPORT Standard_Integer TextHeight (const TCollection_ExtendedString& theText) const;
 
   Standard_EXPORT void TextSize (const TCollection_ExtendedString& theText,
@@ -403,17 +403,17 @@ public:
 private:
 
   //! Returns the size of color scale.
-  //! @param theWidth [out] the width of color scale.
+  //! @param[out] theWidth  the width of color scale.
-  //! @param theHeight [out] the height of color scale.
+  //! @param[out] theHeight  the height of color scale.
   void SizeHint (Standard_Integer& theWidth, Standard_Integer& theHeight) const;
 
   //! Returns the upper value of given interval, or minimum for theIndex = 0.
   Standard_Real GetIntervalValue (const Standard_Integer theIndex) const;
 
   //! Returns the color for the given value in the given interval.
-  //! @param theValue [in] the current value of interval
+  //! @param[in] theValue  the current value of interval
-  //! @param theMin   [in] the min value of interval
+  //! @param[in] theMin    the min value of interval
-  //! @param theMax   [in] the max value of interval
+  //! @param[in] theMax    the max value of interval
   Quantity_Color colorFromValue (const Standard_Real theValue,
                                  const Standard_Real theMin,
                                  const Standard_Real theMax) const;
@@ -422,11 +422,11 @@ private:
   void updateTextAspect();
 
   //! Simple alias for Prs3d_Text::Draw().
-  //! @param theGroup [in] presentation group
+  //! @param[in] theGroup  presentation group
-  //! @param theText  [in] text to draw
+  //! @param[in] theText   text to draw
-  //! @param theX     [in] X coordinate of text position
+  //! @param[in] theX      X coordinate of text position
-  //! @param theY     [in] Y coordinate of text position
+  //! @param[in] theY      Y coordinate of text position
-  //! @param theVertAlignment [in] text vertical alignment
+  //! @param[in] theVertAlignment  text vertical alignment
   void drawText (const Handle(Graphic3d_Group)& theGroup,
                  const TCollection_ExtendedString& theText,
                  const Standard_Integer theX, const Standard_Integer theY,
@@ -451,11 +451,11 @@ private:
                      const Standard_Integer theColorBreadth);
 
   //! Draw a frame.
-  //! @param theX [in] the X coordinate of frame position.
+  //! @param[in] theX  the X coordinate of frame position.
-  //! @param theY [in] the Y coordinate of frame position.
+  //! @param[in] theY  the Y coordinate of frame position.
-  //! @param theWidth [in] the width of frame.
+  //! @param[in] theWidth  the width of frame.
-  //! @param theHeight [in] the height of frame.
+  //! @param[in] theHeight  the height of frame.
-  //! @param theColor [in] the color of frame.
+  //! @param[in] theColor  the color of frame.
   void drawFrame (const Handle(Prs3d_Presentation)& thePrs,
                   const Standard_Integer theX, const Standard_Integer theY,
                   const Standard_Integer theWidth, const Standard_Integer theHeight,

src/AIS/AIS_InteractiveContext.hxx

@@ -247,21 +247,21 @@ public: //! @name highlighting management
   void SetSelectionStyle (const Handle(Prs3d_Drawer)& theStyle) { myStyles[Prs3d_TypeOfHighlight_Selected] = theStyle; }
 
   //! Returns highlight style of the object if it is marked as highlighted via global status
-  //! @param theObj [in] the object to check
+  //! @param[in] theObj  the object to check
   Standard_EXPORT Standard_Boolean HighlightStyle (const Handle(AIS_InteractiveObject)& theObj,
                                                    Handle(Prs3d_Drawer)& theStyle) const;
 
   //! Returns highlight style of the owner if it is selected
-  //! @param theOwner [in] the owner to check
+  //! @param[in] theOwner  the owner to check
   Standard_EXPORT Standard_Boolean HighlightStyle (const Handle(SelectMgr_EntityOwner)& theOwner,
                                                    Handle(Prs3d_Drawer)& theStyle) const;
 
   //! Returns true if the object is marked as highlighted via its global status
-  //! @param theObj [in] the object to check
+  //! @param[in] theObj  the object to check
   Standard_EXPORT Standard_Boolean IsHilighted (const Handle(AIS_InteractiveObject)& theObj) const;
 
   //! Returns true if the owner is marked as selected
-  //! @param theOwner [in] the owner to check
+  //! @param[in] theOwner  the owner to check
   Standard_EXPORT Standard_Boolean IsHilighted (const Handle(SelectMgr_EntityOwner)& theOwner) const;
 
   //! Changes the color of all the lines of the object in view.
@@ -461,10 +461,10 @@ public: //! @name Selection management
 
   //! Selects objects within the bounding rectangle.
   //! Viewer should be explicitly redrawn after selection.
-  //! @param thePntMin [in] rectangle lower point (in pixels)
+  //! @param[in] thePntMin  rectangle lower point (in pixels)
-  //! @param thePntMax [in] rectangle upper point (in pixels)
+  //! @param[in] thePntMax  rectangle upper point (in pixels)
-  //! @param theView   [in] active view where rectangle is defined
+  //! @param[in] theView    active view where rectangle is defined
-  //! @param theSelScheme [in] selection scheme
+  //! @param[in] theSelScheme  selection scheme
   //! @return picking status
   //! @sa StdSelect_ViewerSelector3d::AllowOverlapDetection()
   Standard_EXPORT AIS_StatusOfPick SelectRectangle (const Graphic3d_Vec2i&    thePntMin,
@@ -474,9 +474,9 @@ public: //! @name Selection management
 
   //! Select everything found in the polygon defined by bounding polyline.
   //! Viewer should be explicitly redrawn after selection.
-  //! @param thePolyline  [in] polyline defining polygon bounds (in pixels)
+  //! @param[in] thePolyline   polyline defining polygon bounds (in pixels)
-  //! @param theView      [in] active view where polyline is defined
+  //! @param[in] theView       active view where polyline is defined
-  //! @param theSelScheme [in] selection scheme
+  //! @param[in] theSelScheme  selection scheme
   //! @return picking status
   Standard_EXPORT AIS_StatusOfPick SelectPolygon (const TColgp_Array1OfPnt2d& thePolyline,
                                                   const Handle(V3d_View)&     theView,
@@ -484,9 +484,9 @@ public: //! @name Selection management
 
   //! Selects the topmost object picked by the point in the view,
   //! Viewer should be explicitly redrawn after selection.
-  //! @param thePnt  [in] point pixel coordinates within the view
+  //! @param[in] thePnt   point pixel coordinates within the view
-  //! @param theView [in] active view where point is defined
+  //! @param[in] theView  active view where point is defined
-  //! @param theSelScheme [in] selection scheme
+  //! @param[in] theSelScheme  selection scheme
   //! @return picking status
   Standard_EXPORT AIS_StatusOfPick SelectPoint (const Graphic3d_Vec2i&    thePnt,
                                                 const Handle(V3d_View)&   theView,
@@ -495,7 +495,7 @@ public: //! @name Selection management
   //! Select and hilights the previous detected via AIS_InteractiveContext::MoveTo() method;
   //! unhilights the previous picked.
   //! Viewer should be explicitly redrawn after selection.
-  //! @param theSelScheme [in] selection scheme
+  //! @param[in] theSelScheme  selection scheme
   //! @return picking status
   //!
   //! @sa HighlightStyle() defining default highlight styles of selected owners (Prs3d_TypeOfHighlight_Selected and Prs3d_TypeOfHighlight_LocalSelected)
@@ -1318,8 +1318,8 @@ protected: //! @name internal methods
   Standard_EXPORT void highlightSelected (const Handle(SelectMgr_EntityOwner)& theOwner);
 
   //! Helper function that highlights the owners with check for AutoHighlight, e.g. is used for selection.
-  //! @param theOwners [in] list of owners to highlight
+  //! @param[in] theOwners  list of owners to highlight
-  //! @param theStyle  [in] highlight style to apply or NULL to apply selection style
+  //! @param[in] theStyle   highlight style to apply or NULL to apply selection style
   Standard_EXPORT void highlightOwners (const AIS_NListOfEntityOwner& theOwners,
                                         const Handle(Prs3d_Drawer)& theStyle);
 
@@ -1347,32 +1347,32 @@ protected: //! @name internal methods
 
   //! Helper function that turns on sub-intensity in global status and highlights
   //! given objects with sub-intensity color
-  //! @param theObject [in] the object. If NULL is given, than sub-intensity will be turned on for
+  //! @param[in] theObject  the object. If NULL is given, than sub-intensity will be turned on for
   //! all inveractive objects of the context
-  //! @param theDispMode [in] display mode. If -1 is given, sub-intensity will be turned on for
+  //! @param[in] theDispMode  display mode. If -1 is given, sub-intensity will be turned on for
   //! all display modes in global status's list of modes
-  //! @param theIsDisplayedOnly [in] is true if sub-intensity should be applied only to objects with
+  //! @param[in] theIsDisplayedOnly  is true if sub-intensity should be applied only to objects with
   //! status AIS_DS_Displayed
   Standard_EXPORT void turnOnSubintensity (const Handle(AIS_InteractiveObject)& theObject = NULL,
                                            const Standard_Integer theDispMode = -1,
                                            const Standard_Boolean theIsDisplayedOnly = Standard_True) const;
 
   //! Helper function that highlights the object with sub-intensity color without any checks
-  //! @param theObject [in] the object that will be highlighted
+  //! @param[in] theObject  the object that will be highlighted
-  //! @param theMode [in] display mode
+  //! @param[in] theMode  display mode
   Standard_EXPORT void highlightWithSubintensity (const Handle(AIS_InteractiveObject)& theObject,
                                                   const Standard_Integer theMode) const;
 
   //! Helper function that highlights the owner with sub-intensity color without any checks
-  //! @param theOwner [in] the owner that will be highlighted
+  //! @param[in] theOwner  the owner that will be highlighted
-  //! @param theMode [in] display mode
+  //! @param[in] theMode  display mode
   Standard_EXPORT void highlightWithSubintensity (const Handle(SelectMgr_EntityOwner)& theOwner,
                                                   const Standard_Integer theMode) const;
 
   //! Helper function that returns correct dynamic highlight style for the object:
   //! if custom style is defined via object's highlight drawer, it will be used. Otherwise,
   //! dynamic highlight style of interactive context will be returned.
-  //! @param theObj [in] the object to check
+  //! @param[in] theObj  the object to check
   const Handle(Prs3d_Drawer)& getHiStyle (const Handle(AIS_InteractiveObject)& theObj,
                                           const Handle(SelectMgr_EntityOwner)& theOwner) const
   {
@@ -1392,7 +1392,7 @@ protected: //! @name internal methods
   //! Helper function that returns correct selection style for the object:
   //! if custom style is defined via object's highlight drawer, it will be used. Otherwise,
   //! selection style of interactive context will be returned.
-  //! @param theObj [in] the object to check
+  //! @param[in] theObj  the object to check
   const Handle(Prs3d_Drawer)& getSelStyle (const Handle(AIS_InteractiveObject)& theObj,
                                            const Handle(SelectMgr_EntityOwner)& theOwner) const
   {

src/AIS/AIS_InteractiveObject.hxx

@@ -104,12 +104,12 @@ public:
   void ClearOwner() { myOwner.Nullify(); }
 
   //! Drag object in the viewer.
-  //! @param theCtx      [in] interactive context
+  //! @param[in] theCtx       interactive context
-  //! @param theView     [in] active View
+  //! @param[in] theView      active View
-  //! @param theOwner    [in] the owner of detected entity
+  //! @param[in] theOwner     the owner of detected entity
-  //! @param theDragFrom [in] drag start point
+  //! @param[in] theDragFrom  drag start point
-  //! @param theDragTo   [in] drag end point
+  //! @param[in] theDragTo    drag end point
-  //! @param theAction   [in] drag action
+  //! @param[in] theAction    drag action
   //! @return FALSE if object rejects dragging action (e.g. AIS_DragAction_Start)
   Standard_EXPORT virtual Standard_Boolean ProcessDragging (const Handle(AIS_InteractiveContext)& theCtx,
                                                             const Handle(V3d_View)& theView,

src/AIS/AIS_LightSource.hxx

@@ -148,11 +148,11 @@ public: //! @name Light properties
   }
 
   //! Returns light source icon.
-  //! @param theIsEnabled [in] marker index for enabled/disabled light source states
+  //! @param[in] theIsEnabled  marker index for enabled/disabled light source states
   const Handle(Graphic3d_MarkerImage)& MarkerImage (bool theIsEnabled) const { return myMarkerImages[theIsEnabled ? 1 : 0]; }
 
   //! Returns light source icon.
-  //! @param theIsEnabled [in] marker index for enabled/disabled light source states
+  //! @param[in] theIsEnabled  marker index for enabled/disabled light source states
   Aspect_TypeOfMarker MarkerType (bool theIsEnabled) const { return myMarkerTypes[theIsEnabled ? 1 : 0]; }
 
   //! Sets custom icon to light source.

src/AIS/AIS_Manipulator.hxx

@@ -157,12 +157,12 @@ public:
 
 public:
   //! Drag object in the viewer.
-  //! @param theCtx      [in] interactive context
+  //! @param[in] theCtx       interactive context
-  //! @param theView     [in] active View
+  //! @param[in] theView      active View
-  //! @param theOwner    [in] the owner of detected entity
+  //! @param[in] theOwner     the owner of detected entity
-  //! @param theDragFrom [in] drag start point
+  //! @param[in] theDragFrom  drag start point
-  //! @param theDragTo   [in] drag end point
+  //! @param[in] theDragTo    drag end point
-  //! @param theAction   [in] drag action
+  //! @param[in] theAction    drag action
   //! @return FALSE if object rejects dragging action (e.g. AIS_DragAction_Start)
   Standard_EXPORT virtual Standard_Boolean ProcessDragging (const Handle(AIS_InteractiveContext)& theCtx,
                                                             const Handle(V3d_View)& theView,
@@ -187,7 +187,7 @@ public:
   Standard_EXPORT void Transform (const gp_Trsf& aTrsf);
 
   //! Reset start (reference) transformation.
-  //! @param theToApply [in] option to apply or to cancel the started transformation.
+  //! @param[in] theToApply  option to apply or to cancel the started transformation.
   //! @warning It is used in chain with StartTransform-Transform(gp_Trsf)-StopTransform
   //! and is used only for custom transform set.
   Standard_EXPORT void StopTransform (const Standard_Boolean theToApply = Standard_True);
@@ -319,7 +319,7 @@ public: //! @name Presentation computation
                                         const Standard_Integer theMode = 0) Standard_OVERRIDE;
 
   //! Computes selection sensitive zones (triangulation) for manipulator.
-  //! @param theNode [in] Selection mode that is treated as transformation mode.
+  //! @param[in] theNode  Selection mode that is treated as transformation mode.
   Standard_EXPORT virtual void ComputeSelection (const Handle(SelectMgr_Selection)& theSelection,
                                                  const Standard_Integer theMode) Standard_OVERRIDE;
 

src/AIS/AIS_PointCloud.hxx

@@ -65,16 +65,16 @@ public:
 
   //! Sets the points from array of points.
   //! Method will not copy the input data - array will be stored as handle.
-  //! @param thePoints [in] the array of points
+  //! @param[in] thePoints  the array of points
   Standard_EXPORT virtual void SetPoints (const Handle(Graphic3d_ArrayOfPoints)& thePoints);
 
   //! Sets the points with optional colors.
   //! The input data will be copied into internal buffer.
   //! The input arrays should have equal length, otherwise
   //! the presentation will not be computed and displayed.
-  //! @param theCoords  [in] the array of coordinates
+  //! @param[in] theCoords   the array of coordinates
-  //! @param theColors  [in] optional array of colors
+  //! @param[in] theColors   optional array of colors
-  //! @param theNormals [in] optional array of normals
+  //! @param[in] theNormals  optional array of normals
   Standard_EXPORT virtual void SetPoints (const Handle(TColgp_HArray1OfPnt)&     theCoords,
                                           const Handle(Quantity_HArray1OfColor)& theColors  = NULL,
                                           const Handle(TColgp_HArray1OfDir)&     theNormals = NULL);

src/AIS/AIS_RubberBand.hxx

@@ -41,9 +41,9 @@ public:
   Standard_EXPORT AIS_RubberBand();
 
   //! Constructs the rubber band with empty filling and defined line style.
-  //! @param theLineColor [in] color of rubber band lines
+  //! @param[in] theLineColor  color of rubber band lines
-  //! @param theType [in] type of rubber band lines
+  //! @param[in] theType  type of rubber band lines
-  //! @param theLineWidth [in] width of rubber band line. By default it is 1.
+  //! @param[in] theLineWidth  width of rubber band line. By default it is 1.
   //! @warning It binds this object with Graphic3d_ZLayerId_TopOSD layer.
   Standard_EXPORT AIS_RubberBand (const Quantity_Color& theLineColor,
                                   const Aspect_TypeOfLine theType,
@@ -51,11 +51,11 @@ public:
                                   const Standard_Boolean theIsPolygonClosed = Standard_True);
 
   //! Constructs the rubber band with defined filling and line parameters.
-  //! @param theLineColor [in] color of rubber band lines
+  //! @param[in] theLineColor  color of rubber band lines
-  //! @param theType [in] type of rubber band lines
+  //! @param[in] theType  type of rubber band lines
-  //! @param theFillColor [in] color of rubber band filling
+  //! @param[in] theFillColor  color of rubber band filling
-  //! @param theTransparency [in] transparency of the filling. 0 is for opaque filling. By default it is transparent.
+  //! @param[in] theTransparency  transparency of the filling. 0 is for opaque filling. By default it is transparent.
-  //! @param theLineWidth [in] width of rubber band line. By default it is 1.
+  //! @param[in] theLineWidth  width of rubber band line. By default it is 1.
   //! @warning It binds this object with Graphic3d_ZLayerId_TopOSD layer.
   Standard_EXPORT AIS_RubberBand (const Quantity_Color& theLineColor,
                                   const Aspect_TypeOfLine theType,
@@ -109,7 +109,7 @@ public:
   Standard_EXPORT Aspect_TypeOfLine LineType() const;
 
   //! Sets fill transparency.
-  //! @param theValue [in] the transparency value. 1.0 is for transparent background
+  //! @param[in] theValue  the transparency value. 1.0 is for transparent background
   Standard_EXPORT void SetFillTransparency (const Standard_Real theValue) const;
 
   //! @return fill transparency.
@@ -119,8 +119,8 @@ public:
   Standard_EXPORT void SetFilling (const Standard_Boolean theIsFilling);
 
   //! Enable filling of rubber band with defined parameters.
-  //! @param theColor [in] color of filling
+  //! @param[in] theColor  color of filling
-  //! @param theTransparency [in] transparency of the filling. 0 is for opaque filling.
+  //! @param[in] theTransparency  transparency of the filling. 0 is for opaque filling.
   Standard_EXPORT void SetFilling (const Quantity_Color theColor, const Standard_Real theTransparency);
 
   //! @return true if filling of rubber band is enabled.

src/AIS/AIS_Selection.hxx

@@ -105,8 +105,8 @@ public:
 protected:
 
   //! Append the owner into the current selection if filter is Ok.
-  //! @param theOwner [in] element to change selection state
+  //! @param[in] theOwner  element to change selection state
-  //! @param theFilter [in] context filter to skip not acceptable owners
+  //! @param[in] theFilter  context filter to skip not acceptable owners
   //! @return result of selection
   Standard_EXPORT virtual AIS_SelectStatus appendOwner (const Handle(SelectMgr_EntityOwner)& theOwner,
                                                         const Handle(SelectMgr_Filter)& theFilter);

src/AIS/AIS_ViewController.hxx

@@ -500,11 +500,11 @@ public:
 
   //! Pick closest point under mouse cursor.
   //! This method is expected to be called from rendering thread.
-  //! @param thePnt   [out] result point
+  //! @param[out] thePnt    result point
-  //! @param theCtx    [in] interactive context
+  //! @param[in] theCtx     interactive context
-  //! @param theView   [in] active view
+  //! @param[in] theView    active view
-  //! @param theCursor [in] mouse cursor
+  //! @param[in] theCursor  mouse cursor
-  //! @param theToStickToPickRay [in] when TRUE, the result point will lie on picking ray
+  //! @param[in] theToStickToPickRay  when TRUE, the result point will lie on picking ray
   //! @return TRUE if result has been found
   Standard_EXPORT virtual bool PickPoint (gp_Pnt& thePnt,
                                           const Handle(AIS_InteractiveContext)& theCtx,
@@ -514,10 +514,10 @@ public:
 
   //! Pick closest point by axis.
   //! This method is expected to be called from rendering thread.
-  //! @param theTopPnt [out] result point
+  //! @param[out] theTopPnt  result point
-  //! @param theCtx    [in] interactive context
+  //! @param[in] theCtx     interactive context
-  //! @param theView   [in] active view
+  //! @param[in] theView    active view
-  //! @param theAxis   [in] selection axis
+  //! @param[in] theAxis    selection axis
   //! @return TRUE if result has been found
   Standard_EXPORT virtual bool PickAxis (gp_Pnt& theTopPnt,
                                          const Handle(AIS_InteractiveContext)& theCtx,
@@ -668,8 +668,8 @@ protected:
 
   //! Return current and previously fetched event times.
   //! This callback is intended to compute delta between sequentially processed events.
-  //! @param thePrevTime [out] events time fetched previous time by this method
+  //! @param[out] thePrevTime  events time fetched previous time by this method
-  //! @param theCurrTime [out] actual events time
+  //! @param[out] theCurrTime  actual events time
   void updateEventsTime (double& thePrevTime,
                          double& theCurrTime)
   {

src/AIS/AIS_ViewCube.hxx

@@ -290,7 +290,7 @@ public: //! @name Style management API
   const Quantity_Color& BoxColor() const { return myDrawer->ShadingAspect()->Color(); }
 
   //! Set new value of front color for the 3D part of object.
-  //! @param theColor [in] input color value.
+  //! @param[in] theColor  input color value.
   void SetBoxColor (const Quantity_Color& theColor)
   {
     if (!myDrawer->ShadingAspect()->Color().IsEqual (theColor)
@@ -308,7 +308,7 @@ public: //! @name Style management API
   Standard_Real BoxTransparency() const { return myDrawer->ShadingAspect()->Transparency(); }
 
   //! Set new value of transparency for 3D part of object.
-  //! @param theValue [in] input transparency value
+  //! @param[in] theValue  input transparency value
   void SetBoxTransparency (Standard_Real theValue)
   {
     if (Abs (myDrawer->ShadingAspect()->Transparency() - theValue) > Precision::Confusion()
@@ -412,7 +412,7 @@ public: //! @name Style management API
 public:
 
   //! Set new value of color for the whole object.
-  //! @param theColor [in] input color value.
+  //! @param[in] theColor  input color value.
   virtual void SetColor (const Quantity_Color& theColor) Standard_OVERRIDE
   {
     SetBoxColor (theColor);
@@ -428,7 +428,7 @@ public:
   }
 
   //! Set new value of transparency for the whole object.
-  //! @param theValue [in] input transparency value.
+  //! @param[in] theValue  input transparency value.
   virtual void SetTransparency (const Standard_Real theValue) Standard_OVERRIDE
   {
     SetBoxTransparency (theValue);
@@ -469,7 +469,7 @@ public: //! @name animation methods
   Standard_EXPORT Standard_Real Duration() const;
 
   //! Set duration of animation.
-  //! @param theValue [in] input value of duration in seconds
+  //! @param[in] theValue  input value of duration in seconds
   Standard_EXPORT void SetDuration (Standard_Real theValue);
 
   //! Return TRUE if new camera Up direction should be always set to default value for a new camera Direction; FALSE by default.
@@ -490,11 +490,11 @@ public: //! @name animation methods
   Standard_EXPORT Standard_Boolean HasAnimation() const;
 
   //! Start camera transformation corresponding to the input detected owner.
-  //! @param theOwner [in] detected owner.
+  //! @param[in] theOwner  detected owner.
   Standard_EXPORT virtual void StartAnimation (const Handle(AIS_ViewCubeOwner)& theOwner);
 
   //! Perform one step of current camera transformation.
-  //! theToUpdate [in] enable/disable update of view.
+  //! theToUpdate[in]  enable/disable update of view.
   //! @return TRUE if animation is not stopped.
   Standard_EXPORT virtual Standard_Boolean UpdateAnimation (const Standard_Boolean theToUpdate);
 
@@ -508,7 +508,7 @@ protected:
   Standard_EXPORT Standard_Boolean updateAnimation();
 
   //! Fit selected/all into view.
-  //! @param theView [in] view definition to retrieve scene bounding box
+  //! @param[in] theView  view definition to retrieve scene bounding box
   //! @param theCamera [in,out] camera definition
   Standard_EXPORT virtual void viewFitAll (const Handle(V3d_View)& theView,
                                            const Handle(Graphic3d_Camera)& theCamera);
@@ -530,17 +530,17 @@ public: //! @name Presentation computation
   virtual Handle(SelectMgr_EntityOwner) GlobalSelOwner() const Standard_OVERRIDE { return Handle(SelectMgr_EntityOwner)(); }
 
   //! Compute 3D part of View Cube.
-  //! @param thePrsMgr [in] presentation manager.
+  //! @param[in] thePrsMgr  presentation manager.
-  //! @param thePrs [in] input presentation that is to be filled with flat presentation primitives.
+  //! @param[in] thePrs  input presentation that is to be filled with flat presentation primitives.
-  //! @param theMode [in] display mode.
+  //! @param[in] theMode  display mode.
   //! @warning this object accept only 0 display mode.
   Standard_EXPORT virtual void Compute (const Handle(PrsMgr_PresentationManager)& thePrsMgr,
                                         const Handle(Prs3d_Presentation)& thePrs,
                                         const Standard_Integer theMode = 0) Standard_OVERRIDE;
 
   //! Redefine computing of sensitive entities for View Cube.
-  //! @param theSelection [in] input selection object that is to be filled with sensitive entities.
+  //! @param[in] theSelection  input selection object that is to be filled with sensitive entities.
-  //! @param theMode [in] selection mode.
+  //! @param[in] theMode  selection mode.
   //! @warning object accepts only 0 selection mode.
   Standard_EXPORT virtual void ComputeSelection (const Handle(SelectMgr_Selection)& theSelection,
                                                  const Standard_Integer theMode) Standard_OVERRIDE;
@@ -553,9 +553,9 @@ public: //! @name Presentation computation
   virtual void ClearSelected() Standard_OVERRIDE {}
 
   //! Method which highlights input owner belonging to this selectable object.
-  //! @param thePM [in] presentation manager
+  //! @param[in] thePM  presentation manager
-  //! @param theStyle [in] style for dynamic highlighting.
+  //! @param[in] theStyle  style for dynamic highlighting.
-  //! @param theOwner [in] input entity owner.
+  //! @param[in] theOwner  input entity owner.
   Standard_EXPORT virtual void HilightOwnerWithColor (const Handle(PrsMgr_PresentationManager)& thePM,
                                                       const Handle(Prs3d_Drawer)& theStyle,
                                                       const Handle(SelectMgr_EntityOwner)& theOwner) Standard_OVERRIDE;
@@ -586,7 +586,7 @@ protected: //! @name Auxiliary classes to fill presentation with proper primitiv
   //! @param theTris    [in,out] triangulation to fill, or NULL to return size
   //! @param theNbNodes [in,out] should be incremented by a number of nodes defining this triangulation
   //! @param theNbTris  [in,out] should be incremented by a number of triangles defining this triangulation
-  //! @param theDir     [in] part to define
+  //! @param[in] theDir      part to define
   Standard_EXPORT virtual void createBoxPartTriangles (const Handle(Graphic3d_ArrayOfTriangles)& theTris,
                                                        Standard_Integer& theNbNodes,
                                                        Standard_Integer& theNbTris,
@@ -596,7 +596,7 @@ protected: //! @name Auxiliary classes to fill presentation with proper primitiv
   //! @param theTris    [in,out] triangulation to fill, or NULL to return size
   //! @param theNbNodes [in,out] should be incremented by a number of nodes defining this triangulation
   //! @param theNbTris  [in,out] should be incremented by a number of triangles defining this triangulation
-  //! @param theDir     [in] part to define
+  //! @param[in] theDir      part to define
   Standard_EXPORT virtual void createBoxSideTriangles (const Handle(Graphic3d_ArrayOfTriangles)& theTris,
                                                        Standard_Integer& theNbNodes,
                                                        Standard_Integer& theNbTris,
@@ -606,7 +606,7 @@ protected: //! @name Auxiliary classes to fill presentation with proper primitiv
   //! @param theTris    [in,out] triangulation to fill, or NULL to return size
   //! @param theNbNodes [in,out] should be incremented by a number of nodes defining this triangulation
   //! @param theNbTris  [in,out] should be incremented by a number of triangles defining this triangulation
-  //! @param theDir     [in] part to define
+  //! @param[in] theDir      part to define
   Standard_EXPORT virtual void createBoxEdgeTriangles (const Handle(Graphic3d_ArrayOfTriangles)& theTris,
                                                        Standard_Integer& theNbNodes,
                                                        Standard_Integer& theNbTris,
@@ -616,7 +616,7 @@ protected: //! @name Auxiliary classes to fill presentation with proper primitiv
   //! @param theTris    [in,out] triangulation to fill, or NULL to return size
   //! @param theNbNodes [in,out] should be incremented by a number of nodes defining this triangulation
   //! @param theNbTris  [in,out] should be incremented by a number of triangles defining this triangulation
-  //! @param theDir     [in] part to define
+  //! @param[in] theDir      part to define
   Standard_EXPORT virtual void createBoxCornerTriangles (const Handle(Graphic3d_ArrayOfTriangles)& theTris,
                                                          Standard_Integer& theNbNodes,
                                                          Standard_Integer& theNbTris,
@@ -628,9 +628,9 @@ protected:
   //! @param theTris    [in,out] triangulation to fill, or NULL to return size
   //! @param theNbNodes [in,out] should be incremented by a number of nodes defining this triangulation
   //! @param theNbTris  [in,out] should be incremented by a number of triangles defining this triangulation
-  //! @param theSize    [in] rectangle dimensions
+  //! @param[in] theSize     rectangle dimensions
-  //! @param theRadius  [in] radius at corners
+  //! @param[in] theRadius   radius at corners
-  //! @param theTrsf    [in] transformation
+  //! @param[in] theTrsf     transformation
   Standard_EXPORT static void createRoundRectangleTriangles (const Handle(Graphic3d_ArrayOfTriangles)& theTris,
                                                              Standard_Integer& theNbNodes,
                                                              Standard_Integer& theNbTris,

src/Adaptor3d/Adaptor3d_TopolTool.hxx

@@ -127,18 +127,18 @@ public:
   //! Compute the sample-points for the intersections algorithms by adaptive algorithm for BSpline surfaces.
   //! For other surfaces algorithm is the same as in method ComputeSamplePoints(),
   //! but only fill arrays of U and V sample parameters;
-  //! @param theDefl  [in] a required deflection
+  //! @param[in] theDefl   a required deflection
-  //! @param theNUmin [in] minimal nb points for U
+  //! @param[in] theNUmin  minimal nb points for U
-  //! @param theNVmin [in] minimal nb points for V
+  //! @param[in] theNVmin  minimal nb points for V
   Standard_EXPORT virtual void SamplePnts (const Standard_Real theDefl,
                                            const Standard_Integer theNUmin,
                                            const Standard_Integer theNVmin);
 
   //! Compute the sample-points for the intersections algorithms
   //! by adaptive algorithm for BSpline surfaces - is used in SamplePnts
-  //! @param theDefl  [in] required deflection
+  //! @param[in] theDefl   required deflection
-  //! @param theNUmin [in] minimal nb points for U
+  //! @param[in] theNUmin  minimal nb points for U
-  //! @param theNVmin [in] minimal nb points for V
+  //! @param[in] theNVmin  minimal nb points for V
   Standard_EXPORT virtual void BSplSamplePnts (const Standard_Real theDefl,
                                                const Standard_Integer theNUmin,
                                                const Standard_Integer theNVmin);

src/Aspect/Aspect_GenId.hxx

@@ -64,7 +64,7 @@ public:
   Standard_EXPORT Standard_Integer Next();
 
   //! Generates the next available identifier.
-  //! @param theId [out] generated identifier
+  //! @param[out] theId  generated identifier
   //! @return FALSE if all identifiers are busy.
   Standard_EXPORT Standard_Boolean Next (Standard_Integer& theId);
   

src/Aspect/Aspect_OpenVRSession.hxx

@@ -65,12 +65,12 @@ public:
   Standard_EXPORT virtual void ProcessEvents() Standard_OVERRIDE;
 
   //! Submit texture eye to XR Composer.
-  //! @param theTexture     [in] texture handle
+  //! @param[in] theTexture      texture handle
-  //! @param theGraphicsLib [in] graphics library in which texture handle is defined
+  //! @param[in] theGraphicsLib  graphics library in which texture handle is defined
-  //! @param theColorSpace  [in] texture color space;
+  //! @param[in] theColorSpace   texture color space;
   //!                            sRGB means no color conversion by composer;
   //!                            Linear means to sRGB color conversion by composer
-  //! @param theEye [in] eye to display
+  //! @param[in] theEye  eye to display
   //! @return FALSE on error
   Standard_EXPORT virtual bool SubmitEye (void* theTexture,
                                           Aspect_GraphicsLibrary theGraphicsLib,

src/Aspect/Aspect_XRSession.hxx

@@ -84,12 +84,12 @@ public:
   virtual void ProcessEvents() = 0;
 
   //! Submit texture eye to XR Composer.
-  //! @param theTexture     [in] texture handle
+  //! @param[in] theTexture      texture handle
-  //! @param theGraphicsLib [in] graphics library in which texture handle is defined
+  //! @param[in] theGraphicsLib  graphics library in which texture handle is defined
-  //! @param theColorSpace  [in] texture color space;
+  //! @param[in] theColorSpace   texture color space;
   //!                            sRGB means no color conversion by composer;
   //!                            Linear means to sRGB color conversion by composer
-  //! @param theEye [in] eye to display
+  //! @param[in] theEye  eye to display
   //! @return FALSE on error
   virtual bool SubmitEye (void* theTexture,
                           Aspect_GraphicsLibrary theGraphicsLib,
@@ -153,8 +153,8 @@ public:
   virtual Standard_Integer NamedTrackedDevice (Aspect_XRTrackedDeviceRole theDevice) const = 0;
 
   //! Load model for displaying device.
-  //! @param theDevice  [in] device index
+  //! @param[in] theDevice   device index
-  //! @param theTexture [out] texture source
+  //! @param[out] theTexture  texture source
   //! @return model triangulation or NULL if not found
   Handle(Graphic3d_ArrayOfTriangles) LoadRenderModel (Standard_Integer theDevice,
                                                       Handle(Image_Texture)& theTexture)
@@ -163,9 +163,9 @@ public:
   }
 
   //! Load model for displaying device.
-  //! @param theDevice  [in] device index
+  //! @param[in] theDevice   device index
-  //! @param theToApplyUnitFactor [in] flag to apply unit scale factor
+  //! @param[in] theToApplyUnitFactor  flag to apply unit scale factor
-  //! @param theTexture [out] texture source
+  //! @param[out] theTexture  texture source
   //! @return model triangulation or NULL if not found
   Handle(Graphic3d_ArrayOfTriangles) LoadRenderModel (Standard_Integer theDevice,
                                                       Standard_Boolean theToApplyUnitFactor,
@@ -175,16 +175,16 @@ public:
   }
 
   //! Fetch data for digital input action (like button).
-  //! @param theAction [in] action of Aspect_XRActionType_InputDigital type
+  //! @param[in] theAction  action of Aspect_XRActionType_InputDigital type
   virtual Aspect_XRDigitalActionData GetDigitalActionData (const Handle(Aspect_XRAction)& theAction) const = 0;
 
   //! Fetch data for digital input action (like axis).
-  //! @param theAction [in] action of Aspect_XRActionType_InputAnalog type
+  //! @param[in] theAction  action of Aspect_XRActionType_InputAnalog type
   virtual Aspect_XRAnalogActionData GetAnalogActionData (const Handle(Aspect_XRAction)& theAction) const = 0;
 
   //! Fetch data for pose input action (like fingertip position).
   //! The returned values will match the values returned by the last call to WaitPoses().
-  //! @param theAction [in] action of Aspect_XRActionType_InputPose type
+  //! @param[in] theAction  action of Aspect_XRActionType_InputPose type
   virtual Aspect_XRPoseActionData GetPoseActionDataForNextFrame (const Handle(Aspect_XRAction)& theAction) const = 0;
 
   //! Trigger vibration.
@@ -228,9 +228,9 @@ protected:
   Standard_EXPORT Aspect_XRSession();
 
   //! Load model for displaying device.
-  //! @param theDevice  [in] device index
+  //! @param[in] theDevice   device index
-  //! @param theToApplyUnitFactor [in] flag to apply unit scale factor
+  //! @param[in] theToApplyUnitFactor  flag to apply unit scale factor
-  //! @param theTexture [out] texture source
+  //! @param[out] theTexture  texture source
   //! @return model triangulation or NULL if not found
   virtual Handle(Graphic3d_ArrayOfTriangles) loadRenderModel (Standard_Integer theDevice,
                                                               Standard_Boolean theToApplyUnitFactor,

src/BOPAlgo/BOPAlgo_MakeConnected.hxx

@@ -146,14 +146,14 @@ public: //! @name Constructor
 public: //! @name Setters for the shapes to make connected
 
   //! Sets the shape for making them connected.
-  //! @param theArgs [in] The arguments for the operation.
+  //! @param[in] theArgs  The arguments for the operation.
   void SetArguments(const TopTools_ListOfShape& theArgs)
   {
     myArguments = theArgs;
   }
 
   //! Adds the shape to the arguments.
-  //! @param theS [in] One of the argument shapes.
+  //! @param[in] theS  One of the argument shapes.
   void AddArgument(const TopoDS_Shape& theS)
   {
     myArguments.Append(theS);
@@ -176,13 +176,13 @@ public: //! @name Shape periodicity & repetition
   //! Makes the connected shape periodic.
   //! Repeated calls of this method overwrite the previous calls
   //! working with the basis connected shape.
-  //! @param theParams [in] Periodic options.
+  //! @param[in] theParams  Periodic options.
   Standard_EXPORT void MakePeriodic(const BOPAlgo_MakePeriodic::PeriodicityParams& theParams);
 
   //! Performs repetition of the periodic shape in specified direction
   //! required number of times.
-  //! @param theDirectionID [in] The direction's ID (0 for X, 1 for Y, 2 for Z);
+  //! @param[in] theDirectionID  The direction's ID (0 for X, 1 for Y, 2 for Z);
-  //! @param theTimes [in] Requested number of repetitions (sign of the value defines
+  //! @param[in] theTimes  Requested number of repetitions (sign of the value defines
   //!                      the side of the repetition direction (positive or negative)).
   Standard_EXPORT void RepeatShape(const Standard_Integer theDirectionID,
                                    const Standard_Integer theTimes);
@@ -202,7 +202,7 @@ public: //! @name Material transitions
 
   //! Returns the original shapes which images contain the
   //! the given shape with FORWARD orientation.
-  //! @param theS [in] The shape for which the materials are necessary.
+  //! @param[in] theS  The shape for which the materials are necessary.
   const TopTools_ListOfShape& MaterialsOnPositiveSide(const TopoDS_Shape& theS)
   {
     const TopTools_ListOfShape* pLM = myMaterials.Seek(theS.Oriented(TopAbs_FORWARD));
@@ -211,7 +211,7 @@ public: //! @name Material transitions
 
   //! Returns the original shapes which images contain the
   //! the given shape with REVERSED orientation.
-  //! @param theS [in] The shape for which the materials are necessary.
+  //! @param[in] theS  The shape for which the materials are necessary.
   const TopTools_ListOfShape& MaterialsOnNegativeSide(const TopoDS_Shape& theS)
   {
     const TopTools_ListOfShape* pLM = myMaterials.Seek(theS.Oriented(TopAbs_REVERSED));
@@ -228,14 +228,14 @@ public: //! @name History methods
   }
 
   //! Returns the list of shapes modified from the given shape.
-  //! @param theS [in] The shape for which the modified shapes are necessary.
+  //! @param[in] theS  The shape for which the modified shapes are necessary.
   const TopTools_ListOfShape& GetModified(const TopoDS_Shape& theS)
   {
     return (myHistory.IsNull() ? EmptyList() : myHistory->Modified(theS));
   }
 
   //! Returns the list of original shapes from which the current shape has been created.
-  //! @param theS [in] The shape for which the origins are necessary.
+  //! @param[in] theS  The shape for which the origins are necessary.
   const TopTools_ListOfShape& GetOrigins(const TopoDS_Shape& theS)
   {
     const TopTools_ListOfShape* pLOr = myOrigins.Seek(theS);

src/BOPAlgo/BOPAlgo_MakePeriodic.hxx

@@ -138,7 +138,7 @@ public: //! @name Constructor
 public: //! @name Setting the shape to make it periodic
 
   //! Sets the shape to make it periodic.
-  //! @param theShape [in] The shape to make periodic.
+  //! @param[in] theShape  The shape to make periodic.
   void SetShape(const TopoDS_Shape& theShape)
   {
     myInputShape = theShape;
@@ -178,7 +178,7 @@ public: //! @name Definition of the structure to keep all periodicity parameters
 public: //! @name Setters/Getters for periodicity parameters structure
 
   //! Sets the periodicity parameters.
-  //! @param theParams [in] Periodicity parameters
+  //! @param[in] theParams  Periodicity parameters
   void SetPeriodicityParameters(const PeriodicityParams& theParams)
   {
     myPeriodicityParams = theParams;
@@ -197,9 +197,9 @@ public: //! @name Methods for setting/getting periodicity info using ID as a dir
   //! - 1 - Y direction;
   //! - 2 - Z direction.
   //!
-  //! @param theDirectionID [in] The direction's ID;
+  //! @param[in] theDirectionID  The direction's ID;
-  //! @param theIsPeriodic [in] Flag defining periodicity in given direction;
+  //! @param[in] theIsPeriodic  Flag defining periodicity in given direction;
-  //! @param thePeriod [in] Required period in given direction.
+  //! @param[in] thePeriod  Required period in given direction.
   void MakePeriodic(const Standard_Integer theDirectionID,
                     const Standard_Boolean theIsPeriodic,
                     const Standard_Real thePeriod = 0.0)
@@ -210,14 +210,14 @@ public: //! @name Methods for setting/getting periodicity info using ID as a dir
   }
 
   //! Returns the info about Periodicity of the shape in specified direction.
-  //! @param theDirectionID [in] The direction's ID.
+  //! @param[in] theDirectionID  The direction's ID.
   Standard_Boolean IsPeriodic(const Standard_Integer theDirectionID) const
   {
     return myPeriodicityParams.myPeriodic[ToDirectionID(theDirectionID)];
   }
 
   //! Returns the Period of the shape in specified direction.
-  //! @param theDirectionID [in] The direction's ID.
+  //! @param[in] theDirectionID  The direction's ID.
   Standard_Real Period(const Standard_Integer theDirectionID) const
   {
     Standard_Integer id = ToDirectionID(theDirectionID);
@@ -228,8 +228,8 @@ public: //! @name Methods for setting/getting periodicity info using ID as a dir
 public: //! @name Named methods for setting/getting info about shape's periodicity
 
   //! Sets the flag to make the shape periodic in X direction.
-  //! @param theIsPeriodic [in] Flag defining periodicity in X direction;
+  //! @param[in] theIsPeriodic  Flag defining periodicity in X direction;
-  //! @param thePeriod [in] Required period in X direction.
+  //! @param[in] thePeriod  Required period in X direction.
   void MakeXPeriodic(const Standard_Boolean theIsPeriodic,
                      const Standard_Real thePeriod = 0.0)
   {
@@ -243,8 +243,8 @@ public: //! @name Named methods for setting/getting info about shape's periodici
   Standard_Real XPeriod() const { return Period(0); }
 
   //! Sets the flag to make the shape periodic in Y direction.
-  //! @param theIsPeriodic [in] Flag defining periodicity in Y direction;
+  //! @param[in] theIsPeriodic  Flag defining periodicity in Y direction;
-  //! @param thePeriod [in] Required period in Y direction.
+  //! @param[in] thePeriod  Required period in Y direction.
   void MakeYPeriodic(const Standard_Boolean theIsPeriodic,
                      const Standard_Real thePeriod = 0.0)
   {
@@ -258,8 +258,8 @@ public: //! @name Named methods for setting/getting info about shape's periodici
   Standard_Real YPeriod() const { return Period(1); }
 
   //! Sets the flag to make the shape periodic in Z direction.
-  //! @param theIsPeriodic [in] Flag defining periodicity in Z direction;
+  //! @param[in] theIsPeriodic  Flag defining periodicity in Z direction;
-  //! @param thePeriod [in] Required period in Z direction.
+  //! @param[in] thePeriod  Required period in Z direction.
   void MakeZPeriodic(const Standard_Boolean theIsPeriodic,
                      const Standard_Real thePeriod = 0.0)
   {
@@ -288,9 +288,9 @@ public: //! @name Methods for setting/getting trimming info taking Direction ID
   //!
   //! Before calling this method, the shape has to be set to be periodic in this direction.
   //!
-  //! @param theDirectionID [in] The direction's ID;
+  //! @param[in] theDirectionID  The direction's ID;
-  //! @param theIsTrimmed [in] The flag defining trimming of the shape in given direction;
+  //! @param[in] theIsTrimmed  The flag defining trimming of the shape in given direction;
-  //! @param theFirst [in] The first periodic parameter in the given direction.
+  //! @param[in] theFirst  The first periodic parameter in the given direction.
   void SetTrimmed(const Standard_Integer theDirectionID,
                   const Standard_Boolean theIsTrimmed,
                   const Standard_Real theFirst = 0.0)
@@ -304,14 +304,14 @@ public: //! @name Methods for setting/getting trimming info taking Direction ID
   }
 
   //! Returns whether the input shape was trimmed in the specified direction.
-  //! @param theDirectionID [in] The direction's ID.
+  //! @param[in] theDirectionID  The direction's ID.
   Standard_Boolean IsInputTrimmed(const Standard_Integer theDirectionID) const
   {
     return myPeriodicityParams.myIsTrimmed[ToDirectionID(theDirectionID)];
   }
 
   //! Returns the first periodic parameter in the specified direction.
-  //! @param theDirectionID [in] The direction's ID.
+  //! @param[in] theDirectionID  The direction's ID.
   Standard_Real PeriodFirst(const Standard_Integer theDirectionID) const
   {
     Standard_Integer id = ToDirectionID(theDirectionID);
@@ -328,9 +328,9 @@ public: //! @name Named methods for setting/getting trimming info
   //!
   //! Before calling this method, the shape has to be set to be periodic in this direction.
   //!
-  //! @param theIsTrimmed [in] Flag defining whether the shape is already trimmed
+  //! @param[in] theIsTrimmed  Flag defining whether the shape is already trimmed
   //!                          in X direction to fit the X period;
-  //! @param theFirst [in] The first X periodic parameter.
+  //! @param[in] theFirst  The first X periodic parameter.
   void SetXTrimmed(const Standard_Boolean theIsTrimmed,
                    const Standard_Boolean theFirst = 0.0)
   {
@@ -356,9 +356,9 @@ public: //! @name Named methods for setting/getting trimming info
   //!
   //! Before calling this method, the shape has to be set to be periodic in this direction.
   //!
-  //! @param theIsTrimmed [in] Flag defining whether the shape is already trimmed
+  //! @param[in] theIsTrimmed  Flag defining whether the shape is already trimmed
   //!                          in Y direction to fit the Y period;
-  //! @param theFirst [in] The first Y periodic parameter.
+  //! @param[in] theFirst  The first Y periodic parameter.
   void SetYTrimmed(const Standard_Boolean theIsTrimmed,
                    const Standard_Boolean theFirst = 0.0)
   {
@@ -384,9 +384,9 @@ public: //! @name Named methods for setting/getting trimming info
   //!
   //! Before calling this method, the shape has to be set to be periodic in this direction.
   //!
-  //! @param theIsTrimmed [in] Flag defining whether the shape is already trimmed
+  //! @param[in] theIsTrimmed  Flag defining whether the shape is already trimmed
   //!                          in Z direction to fit the Z period;
-  //! @param theFirst [in] The first Z periodic parameter.
+  //! @param[in] theFirst  The first Z periodic parameter.
   void SetZTrimmed(const Standard_Boolean theIsTrimmed,
                    const Standard_Boolean theFirst = 0.0)
   {
@@ -419,8 +419,8 @@ public: //! @name Using the algorithm to repeat the shape
   //! be perform in negative direction.
   //! Makes the repeated shape a base for following repetitions.
   //!
-  //! @param theDirectionID [in] The direction's ID;
+  //! @param[in] theDirectionID  The direction's ID;
-  //! @param theTimes [in] Requested number of repetitions.
+  //! @param[in] theTimes  Requested number of repetitions.
   Standard_EXPORT const TopoDS_Shape& RepeatShape(const Standard_Integer theDirectionID,
                                                   const Standard_Integer theTimes);
 
@@ -429,7 +429,7 @@ public: //! @name Using the algorithm to repeat the shape
   //! perform in negative X direction.
   //! Makes the repeated shape a base for following repetitions.
   //!
-  //! @param theTimes [in] Requested number of repetitions.
+  //! @param[in] theTimes  Requested number of repetitions.
   const TopoDS_Shape& XRepeat(const Standard_Integer theTimes)
   {
     return RepeatShape(0, theTimes);
@@ -440,7 +440,7 @@ public: //! @name Using the algorithm to repeat the shape
   //! perform in negative Y direction.
   //! Makes the repeated shape a base for following repetitions.
   //!
-  //! @param theTimes [in] Requested number of repetitions.
+  //! @param[in] theTimes  Requested number of repetitions.
   const TopoDS_Shape& YRepeat(const Standard_Integer theTimes)
   {
     return RepeatShape(1, theTimes);
@@ -451,7 +451,7 @@ public: //! @name Using the algorithm to repeat the shape
   //! perform in negative Z direction.
   //! Makes the repeated shape a base for following repetitions.
   //!
-  //! @param theTimes [in] Requested number of repetitions.
+  //! @param[in] theTimes  Requested number of repetitions.
   const TopoDS_Shape& ZRepeat(const Standard_Integer theTimes)
   {
     return RepeatShape(2, theTimes);
@@ -490,7 +490,7 @@ public: //! @name Getting the identical shapes
   //! on the opposite periodic side.
   //! Returns empty list in case the shape has no twin.
   //!
-  //! @param theS [in] Shape to get the twins for.
+  //! @param[in] theS  Shape to get the twins for.
   const TopTools_ListOfShape& GetTwins(const TopoDS_Shape& theS) const
   {
     static TopTools_ListOfShape empty;
@@ -559,17 +559,17 @@ protected: //! @name Protected methods performing the operation
 
   //! Splits the shape by the given tools, copying the geometry of coinciding
   //! parts from the given tools to the split shape.
-  //! @param theTools [in] The tools to split the shape and take the geometry
+  //! @param[in] theTools  The tools to split the shape and take the geometry
   //!                      for coinciding parts.
-  //! @param theSplitShapeHistory [out] The history of shape split
+  //! @param[out] theSplitShapeHistory  The history of shape split
-  //! @param theSplitToolsHistory [out] The history of tools modifications during the split
+  //! @param[out] theSplitToolsHistory  The history of tools modifications during the split
   Standard_EXPORT void SplitShape(const TopTools_ListOfShape& theTools,
                                   Handle(BRepTools_History) theSplitShapeHistory = NULL,
                                   Handle(BRepTools_History) theSplitToolsHistory = NULL);
 
   //! Updates the map of twins after periodic shape repetition.
-  //! @param theTranslationHistory [in] The history of translation of the periodic shape.
+  //! @param[in] theTranslationHistory  The history of translation of the periodic shape.
-  //! @param theGluingHistory [in] The history of gluing of the repeated shapes.
+  //! @param[in] theGluingHistory  The history of gluing of the repeated shapes.
   Standard_EXPORT void UpdateTwins(const BRepTools_History& theTranslationHistory,
                                    const BRepTools_History& theGluingHistory);
 

src/BOPAlgo/BOPAlgo_RemoveFeatures.hxx

@@ -161,7 +161,7 @@ public: //! @name Constructors
 public: //! @name Setting input data for the algorithm
 
   //! Sets the shape for processing.
-  //! @param theShape [in] The shape to remove the faces from.
+  //! @param[in] theShape  The shape to remove the faces from.
   //!                      It should either be the SOLID, COMPSOLID or COMPOUND of Solids.
   void SetShape(const TopoDS_Shape& theShape)
   {
@@ -175,14 +175,14 @@ public: //! @name Setting input data for the algorithm
   }
 
   //! Adds the face to remove from the input shape.
-  //! @param theFace [in] The shape to extract the faces for removal.
+  //! @param[in] theFace  The shape to extract the faces for removal.
   void AddFaceToRemove(const TopoDS_Shape& theFace)
   {
     myFacesToRemove.Append(theFace);
   }
 
   //! Adds the faces to remove from the input shape.
-  //! @param theFaces [in] The list of shapes to extract the faces for removal.
+  //! @param[in] theFaces  The list of shapes to extract the faces for removal.
   void AddFacesToRemove(const TopTools_ListOfShape& theFaces)
   {
     TopTools_ListIteratorOfListOfShape it(theFaces);
@@ -238,14 +238,14 @@ protected: //! @name Protected methods performing the removal
   Standard_EXPORT void RemoveFeatures(const Message_ProgressRange& theRange);
 
   //! Remove the single feature from the shape.
-  //! @param theFeature [in] The feature to remove;
+  //! @param[in] theFeature  The feature to remove;
-  //! @param theSolids [in] The solids to be reconstructed after feature removal;
+  //! @param[in] theSolids  The solids to be reconstructed after feature removal;
-  //! @param theFeatureFacesMap [in] The map of feature faces;
+  //! @param[in] theFeatureFacesMap  The map of feature faces;
-  //! @param theHasAdjacentFaces [in] Shows whether the adjacent faces have been
+  //! @param[in] theHasAdjacentFaces  Shows whether the adjacent faces have been
   //!                                 found for the feature or not;
-  //! @param theAdjFaces [in] The reconstructed adjacent faces covering the feature;
+  //! @param[in] theAdjFaces  The reconstructed adjacent faces covering the feature;
-  //! @param theAdjFacesHistory [in] The history of the adjacent faces reconstruction;
+  //! @param[in] theAdjFacesHistory  The history of the adjacent faces reconstruction;
-  //! @param theSolidsHistoryNeeded [in] Defines whether the history of solids
+  //! @param[in] theSolidsHistoryNeeded  Defines whether the history of solids
   //!                                    modifications should be tracked or not.
   Standard_EXPORT void RemoveFeature(const TopoDS_Shape& theFeature,
                                      const TopTools_IndexedMapOfShape& theSolids,

src/BOPTools/BOPTools_AlgoTools.hxx

@@ -321,10 +321,10 @@ public: //! @name Choosing correct orientation for the split shape
   //! - 100 - bad types.
   //! In case of any error the method always returns FALSE.
   //!
-  //! @param theSplit [in] Split shape
+  //! @param[in] theSplit  Split shape
-  //! @param theShape [in] Original shape
+  //! @param[in] theShape  Original shape
-  //! @param theContext [in] cached geometrical tools
+  //! @param[in] theContext  cached geometrical tools
-  //! @param theError [out] Error Status of the operation
+  //! @param[out] theError  Error Status of the operation
   Standard_EXPORT static Standard_Boolean IsSplitToReverse(const TopoDS_Shape& theSplit,
                                                            const TopoDS_Shape& theShape,
                                                            const Handle(IntTools_Context)& theContext,
@@ -354,10 +354,10 @@ public: //! @name Choosing correct orientation for the split shape
   //! - 4 - unable to compute the normal for the original face.
   //! In case of any error the method always returns FALSE.
   //!
-  //! @param theSplit [in] Split face
+  //! @param[in] theSplit  Split face
-  //! @param theShape [in] Original face
+  //! @param[in] theShape  Original face
-  //! @param theContext [in] cached geometrical tools
+  //! @param[in] theContext  cached geometrical tools
-  //! @param theError [out] Error Status of the operation
+  //! @param[out] theError  Error Status of the operation
   Standard_EXPORT static Standard_Boolean IsSplitToReverse(const TopoDS_Face& theSplit,
                                                            const TopoDS_Face& theShape,
                                                            const Handle(IntTools_Context)& theContext,
@@ -379,10 +379,10 @@ public: //! @name Choosing correct orientation for the split shape
   //! - 4 - unable to compute the tangent vector for the original edge;
   //! In case of any error the method always returns FALSE.
   //!
-  //! @param theSplit [in] Split edge
+  //! @param[in] theSplit  Split edge
-  //! @param theShape [in] Original edge
+  //! @param[in] theShape  Original edge
-  //! @param theContext [in] cached geometrical tools
+  //! @param[in] theContext  cached geometrical tools
-  //! @param theError [out] Error Status of the operation
+  //! @param[out] theError  Error Status of the operation
   Standard_EXPORT static Standard_Boolean IsSplitToReverse(const TopoDS_Edge& theSplit,
                                                            const TopoDS_Edge& theShape,
                                                            const Handle(IntTools_Context)& theContext,

src/BRep/BRep_TFace.hxx

@@ -92,8 +92,8 @@ public:
   Standard_EXPORT const Handle(Poly_Triangulation)& Triangulation (const Poly_MeshPurpose thePurpose = Poly_MeshPurpose_NONE) const;
 
   //! Sets input triangulation for this face.
-  //! @param theTriangulation [in] triangulation to be set
+  //! @param[in] theTriangulation  triangulation to be set
-  //! @param theToReset [in] flag to reset triangulations list to new list with only one input triangulation.
+  //! @param[in] theToReset  flag to reset triangulations list to new list with only one input triangulation.
   //! If theTriangulation is NULL internal list of triangulations will be cleared and active triangulation will be nullified.
   //! If theToReset is TRUE internal list of triangulations will be reset
   //! to new list with only one input triangulation that will be active.

src/BRep/BRep_Tool.hxx

@@ -65,9 +65,9 @@ public:
   Standard_EXPORT static Handle(Geom_Surface) Surface (const TopoDS_Face& F);
 
   //! Returns the triangulation of the face according to the mesh purpose.
-  //! @param theFace [in] the input face to find triangulation.
+  //! @param[in] theFace  the input face to find triangulation.
-  //! @param theLocation [out] the face location.
+  //! @param[out] theLocation  the face location.
-  //! @param theMeshPurpose [in] a mesh purpose to find appropriate triangulation (NONE by default).
+  //! @param[in] theMeshPurpose  a mesh purpose to find appropriate triangulation (NONE by default).
   //! @return an active triangulation in case of NONE purpose,
   //!         the first triangulation appropriate for the input purpose,
   //!         just the first triangulation if none matching other criteria and input purpose is AnyFallback
@@ -76,8 +76,8 @@ public:
                                                                           const Poly_MeshPurpose theMeshPurpose = Poly_MeshPurpose_NONE);
 
   //! Returns all triangulations of the face.
-  //! @param theFace [in] the input face.
+  //! @param[in] theFace  the input face.
-  //! @param theLocation [out] the face location.
+  //! @param[out] theLocation  the face location.
   //! @return list of all available face triangulations.
   Standard_EXPORT static const Poly_ListOfTriangulation& Triangulations (const TopoDS_Face& theFace, TopLoc_Location& theLocation);
 
@@ -269,9 +269,9 @@ public:
   Standard_EXPORT static Standard_Real Tolerance (const TopoDS_Vertex& V);
   
   //! Finds the parameter of <theV> on <theE>.
-  //! @param theV [in] input vertex
+  //! @param[in] theV  input vertex
-  //! @param theE [in] input edge
+  //! @param[in] theE  input edge
-  //! @param theParam  [out] calculated parameter on the curve
+  //! @param[out] theParam   calculated parameter on the curve
   //! @return TRUE if done
   Standard_EXPORT static Standard_Boolean Parameter (const TopoDS_Vertex& theV,
 	                                                   const TopoDS_Edge& theE,

src/BRepAlgoAPI/BRepAlgoAPI_Check.hxx

@@ -60,12 +60,12 @@ public: //! @name Constructors
 
   //! Constructor for checking single shape.
   //!
-  //! @param theS [in] - the shape to check;
+  //! @param[in] theS  - the shape to check;
-  //! @param bTestSE [in] - flag which specifies whether to check the shape
+  //! @param[in] bTestSE  - flag which specifies whether to check the shape
   //!                       on small edges or not; by default it is set to TRUE;
-  //! @param bTestSI [in] - flag which specifies whether to check the shape
+  //! @param[in] bTestSI  - flag which specifies whether to check the shape
   //!                       on self-interference or not; by default it is set to TRUE;
-  //! @param theRange [in] - parameter to use progress indicator
+  //! @param[in] theRange  - parameter to use progress indicator
   Standard_EXPORT BRepAlgoAPI_Check(const TopoDS_Shape& theS,
                                     const Standard_Boolean bTestSE = Standard_True,
                                     const Standard_Boolean bTestSI = Standard_True,
@@ -76,15 +76,15 @@ public: //! @name Constructors
   //! the types of the given shapes will be checked on validity
   //! for Boolean operation of given type.
   //!
-  //! @param theS1 [in] - the first shape to check;
+  //! @param[in] theS1  - the first shape to check;
-  //! @param theS2 [in] - the second shape to check;
+  //! @param[in] theS2  - the second shape to check;
-  //! @param theOp [in] - the type of Boolean Operation for which the validity
+  //! @param[in] theOp  - the type of Boolean Operation for which the validity
   //!                     of given shapes should be checked.
-  //! @param bTestSE [in] - flag which specifies whether to check the shape
+  //! @param[in] bTestSE  - flag which specifies whether to check the shape
   //!                       on small edges or not; by default it is set to TRUE;
-  //! @param bTestSI [in] - flag which specifies whether to check the shape
+  //! @param[in] bTestSI  - flag which specifies whether to check the shape
   //!                       on self-interference or not; by default it is set to TRUE;
-  //! @param theRange [in] - parameter to use progress indicator
+  //! @param[in] theRange  - parameter to use progress indicator
   Standard_EXPORT BRepAlgoAPI_Check(const TopoDS_Shape& theS1,
                                     const TopoDS_Shape& theS2,
                                     const BOPAlgo_Operation theOp = BOPAlgo_UNKNOWN,
@@ -97,10 +97,10 @@ public: //! @name Initializing the algorithm
 
   //! Initializes the algorithm with single shape.
   //!
-  //! @param theS [in] - the shape to check;
+  //! @param[in] theS  - the shape to check;
-  //! @param bTestSE [in] - flag which specifies whether to check the shape
+  //! @param[in] bTestSE  - flag which specifies whether to check the shape
   //!                       on small edges or not; by default it is set to TRUE;
-  //! @param bTestSI [in] - flag which specifies whether to check the shape
+  //! @param[in] bTestSI  - flag which specifies whether to check the shape
   //!                       on self-interference or not; by default it is set to TRUE;
   void SetData(const TopoDS_Shape& theS,
                const Standard_Boolean bTestSE = Standard_True,
@@ -118,13 +118,13 @@ public: //! @name Initializing the algorithm
   //! the types of the given shapes will be checked on validity
   //! for Boolean operation of given type.
   //!
-  //! @param theS1 [in] - the first shape to check;
+  //! @param[in] theS1  - the first shape to check;
-  //! @param theS2 [in] - the second shape to check;
+  //! @param[in] theS2  - the second shape to check;
-  //! @param theOp [in] - the type of Boolean Operation for which the validity
+  //! @param[in] theOp  - the type of Boolean Operation for which the validity
   //!                     of given shapes should be checked.
-  //! @param bTestSE [in] - flag which specifies whether to check the shape
+  //! @param[in] bTestSE  - flag which specifies whether to check the shape
   //!                       on small edges or not; by default it is set to TRUE;
-  //! @param bTestSI [in] - flag which specifies whether to check the shape
+  //! @param[in] bTestSI  - flag which specifies whether to check the shape
   //!                       on self-interference or not; by default it is set to TRUE;
   void SetData(const TopoDS_Shape& theS1,
                const TopoDS_Shape& theS2,

src/BRepAlgoAPI/BRepAlgoAPI_Defeaturing.hxx

@@ -117,7 +117,7 @@ public: //! @name Constructors
 public: //! @name Setting input data for the algorithm
 
   //! Sets the shape for processing.
-  //! @param theShape [in] The shape to remove the features from.
+  //! @param[in] theShape  The shape to remove the features from.
   //!                      It should either be the SOLID, COMPSOLID or COMPOUND of Solids.
   void SetShape(const TopoDS_Shape& theShape)
   {
@@ -131,14 +131,14 @@ public: //! @name Setting input data for the algorithm
   }
 
   //! Adds the features to remove from the input shape.
-  //! @param theFace [in] The shape to extract the faces for removal.
+  //! @param[in] theFace  The shape to extract the faces for removal.
   void AddFaceToRemove(const TopoDS_Shape& theFace)
   {
     myFacesToRemove.Append(theFace);
   }
 
   //! Adds the faces to remove from the input shape.
-  //! @param theFaces [in] The list of shapes to extract the faces for removal.
+  //! @param[in] theFaces  The list of shapes to extract the faces for removal.
   void AddFacesToRemove(const TopTools_ListOfShape& theFaces)
   {
     TopTools_ListIteratorOfListOfShape it(theFaces);

src/BRepBuilderAPI/BRepBuilderAPI_MakeShapeOnMesh.hxx

@@ -29,7 +29,7 @@ public:
   DEFINE_STANDARD_ALLOC
 
   //! Ctor. Sets mesh to process.
-  //! @param theMesh [in] - Mesh to construct shape for.
+  //! @param[in] theMesh  - Mesh to construct shape for.
   BRepBuilderAPI_MakeShapeOnMesh(const Handle(Poly_Triangulation)& theMesh)
   : myMesh(theMesh)
   {}

src/BRepGProp/BRepGProp_Gauss.hxx

@@ -78,9 +78,9 @@ public: //! @name public API
   //! @param theLocation - location of the point or the plane;
   //! @param theCoeff - plane coefficients;
   //! @param theIsByPoint - flag of restricition (point/plane);
-  //! @param theOutMass[out] - mass (volume) of region;
+  //! @param[out] theOutMass - mass (volume) of region;
-  //! @param theOutGravityCenter[out] - garvity center of region;
+  //! @param[out] theOutGravityCenter - garvity center of region;
-  //! @param theOutInertia[out] - matrix of inertia;
+  //! @param[out] theOutInertia - matrix of inertia;
   Standard_EXPORT void Compute(
     const BRepGProp_Face&  theSurface,
     const gp_Pnt&          theLocation,
@@ -97,9 +97,9 @@ public: //! @name public API
   //! Error of the computation is not calculated.
   //! @param theSurface - bounding surface of the region;
   //! @param theLocation - surface location;
-  //! @param theOutMass[out] - mass (volume) of region;
+  //! @param[out] theOutMass - mass (volume) of region;
-  //! @param theOutGravityCenter[out] - garvity center of region;
+  //! @param[out] theOutGravityCenter - garvity center of region;
-  //! @param theOutInertia[out] - matrix of inertia;
+  //! @param[out] theOutInertia - matrix of inertia;
   Standard_EXPORT void Compute(
     const BRepGProp_Face&  theSurface,
     const gp_Pnt&          theLocation,
@@ -118,9 +118,9 @@ public: //! @name public API
   //! @param theLocation - location of the point or the plane;
   //! @param theCoeff - plane coefficients;
   //! @param theIsByPoint - flag of restricition (point/plane);
-  //! @param theOutMass[out] - mass (volume) of region;
+  //! @param[out] theOutMass - mass (volume) of region;
-  //! @param theOutGravityCenter[out] - garvity center of region;
+  //! @param[out] theOutGravityCenter - garvity center of region;
-  //! @param theOutInertia[out] - matrix of inertia;
+  //! @param[out] theOutInertia - matrix of inertia;
   Standard_EXPORT void Compute(
     BRepGProp_Face&        theSurface,
     BRepGProp_Domain&      theDomain,
@@ -139,9 +139,9 @@ public: //! @name public API
   //! @param theSurface - bounding surface of the region;
   //! @param theDomain - surface boundings;
   //! @param theLocation - surface location;
-  //! @param theOutMass[out] - mass (volume) of region;
+  //! @param[out] theOutMass - mass (volume) of region;
-  //! @param theOutGravityCenter[out] - garvity center of region;
+  //! @param[out] theOutGravityCenter - garvity center of region;
-  //! @param theOutInertia[out] - matrix of inertia;
+  //! @param[out] theOutInertia - matrix of inertia;
   Standard_EXPORT void Compute(
     BRepGProp_Face&        theSurface,
     BRepGProp_Domain&      theDomain,
@@ -160,9 +160,9 @@ public: //! @name public API
   //! @param theEps - maximal relative error of computed mass (volume) for face;
   //! @param theCoeff - plane coefficients;
   //! @param theIsByPoint - flag of restricition (point/plane);
-  //! @param theOutMass[out] - mass (volume) of region;
+  //! @param[out] theOutMass - mass (volume) of region;
-  //! @param theOutGravityCenter[out] - garvity center of region;
+  //! @param[out] theOutGravityCenter - garvity center of region;
-  //! @param theOutInertia[out] - matrix of inertia;
+  //! @param[out] theOutInertia - matrix of inertia;
   //! @return value of error which is calculated as
   //! Abs((M(i+1)-M(i))/M(i+1)), M(i+1) and M(i) are values
   //! for two successive steps of adaptive integration.
@@ -183,9 +183,9 @@ public: //! @name public API
   //! @param theDomain - surface boundings;
   //! @param theLocation - surface location;
   //! @param theEps - maximal relative error of computed mass (square) for face;
-  //! @param theOutMass[out] - mass (volume) of region;
+  //! @param[out] theOutMass - mass (volume) of region;
-  //! @param theOutGravityCenter[out] - garvity center of region;
+  //! @param[out] theOutGravityCenter - garvity center of region;
-  //! @param theOutInertia[out] - matrix of inertia;
+  //! @param[out] theOutInertia - matrix of inertia;
   //! @return value of error which is calculated as
   //! Abs((M(i+1)-M(i))/M(i+1)), M(i+1) and M(i) are values
   //! for two successive steps of adaptive integration.

src/BRepLib/BRepLib.hxx

@@ -274,13 +274,13 @@ public:
 
 
   //! Enlarges the face on the given value.
-  //! @param theF [in] The face to extend
+  //! @param[in] theF  The face to extend
-  //! @param theExtVal [in] The extension value
+  //! @param[in] theExtVal  The extension value
-  //! @param theExtUMin [in] Defines whether to extend the face in UMin direction
+  //! @param[in] theExtUMin  Defines whether to extend the face in UMin direction
-  //! @param theExtUMax [in] Defines whether to extend the face in UMax direction
+  //! @param[in] theExtUMax  Defines whether to extend the face in UMax direction
-  //! @param theExtVMin [in] Defines whether to extend the face in VMin direction
+  //! @param[in] theExtVMin  Defines whether to extend the face in VMin direction
-  //! @param theExtVMax [in] Defines whether to extend the face in VMax direction
+  //! @param[in] theExtVMax  Defines whether to extend the face in VMax direction
-  //! @param theFExtended [in] The extended face
+  //! @param[in] theFExtended  The extended face
   Standard_EXPORT static void ExtendFace(const TopoDS_Face& theF,
                                          const Standard_Real theExtVal,
                                          const Standard_Boolean theExtUMin,

src/BRepMesh/BRepMesh_Deflection.hxx

@@ -56,12 +56,12 @@ public:
 
   //! Checks if the deflection of current polygonal representation
   //! is consistent with the required deflection.
-  //! @param theCurrent [in] Current deflection.
+  //! @param[in] theCurrent  Current deflection.
-  //! @param theRequired [in] Required deflection.
+  //! @param[in] theRequired  Required deflection.
-  //! @param theAllowDecrease [in] Flag controlling the check. If decrease is allowed,
+  //! @param[in] theAllowDecrease  Flag controlling the check. If decrease is allowed,
   //! to be consistent the current and required deflections should be approximately the same.
   //! If not allowed, the current deflection should be less than required.
-  //! @param theRatio [in] The ratio for comparison of the deflections (value from 0 to 1).
+  //! @param[in] theRatio  The ratio for comparison of the deflections (value from 0 to 1).
   Standard_EXPORT static Standard_Boolean IsConsistent (
     const Standard_Real theCurrent,
     const Standard_Real theRequired,

src/BRepMesh/BRepMesh_GeomTool.hxx

@@ -110,9 +110,9 @@ public:
   //! @param theIndex index of discretization point.
   //! @param theIsoParam parameter on surface to be used as second coordinate 
   //! of resulting 2d point.
-  //! @param theParam[out] parameter of the point on the iso curve.
+  //! @param[out] theParam parameter of the point on the iso curve.
-  //! @param thePoint[out] discretization point.
+  //! @param[out] thePoint discretization point.
-  //! @param theUV[out] discretization point in parametric space of the surface.
+  //! @param[out] theUV discretization point in parametric space of the surface.
   //! @return TRUE on success, FALSE elsewhere.
   Standard_EXPORT Standard_Boolean Value(const Standard_Integer theIndex,
                                          const Standard_Real    theIsoParam,
@@ -123,9 +123,9 @@ public:
   //! Gets parameters of discretization point with the given index.
   //! @param theIndex index of discretization point.
   //! @param theSurface surface the curve is lying onto.
-  //! @param theParam[out] parameter of the point on the curve.
+  //! @param[out] theParam parameter of the point on the curve.
-  //! @param thePoint[out] discretization point.
+  //! @param[out] thePoint discretization point.
-  //! @param theUV[out] discretization point in parametric space of the surface.
+  //! @param[out] theUV discretization point in parametric space of the surface.
   //! @return TRUE on success, FALSE elsewhere.
   Standard_EXPORT Standard_Boolean Value(const Standard_Integer              theIndex,
                                          const Handle(BRepAdaptor_Surface)& theSurface,

src/BRepPrimAPI/BRepPrimAPI_MakeCone.hxx

@@ -39,23 +39,23 @@ public:
 
 
   //! Make a cone.
-  //! @param R1 [in] cone bottom radius, may be null (z = 0)
+  //! @param[in] R1  cone bottom radius, may be null (z = 0)
-  //! @param R2 [in] cone top radius, may be null (z = H)
+  //! @param[in] R2  cone top radius, may be null (z = H)
-  //! @param H  [in] cone height
+  //! @param[in] H   cone height
   Standard_EXPORT BRepPrimAPI_MakeCone(const Standard_Real R1, const Standard_Real R2, const Standard_Real H);
 
   //! Make a cone.
-  //! @param R1    [in] cone bottom radius, may be null (z = 0)
+  //! @param[in] R1     cone bottom radius, may be null (z = 0)
-  //! @param R2    [in] cone top radius, may be null (z = H)
+  //! @param[in] R2     cone top radius, may be null (z = H)
-  //! @param H     [in] cone height
+  //! @param[in] H      cone height
-  //! @param angle [in] angle to create a part cone
+  //! @param[in] angle  angle to create a part cone
   Standard_EXPORT BRepPrimAPI_MakeCone(const Standard_Real R1, const Standard_Real R2, const Standard_Real H, const Standard_Real angle);
 
   //! Make a cone.
-  //! @param axes [in] coordinate system for the construction of the cone
+  //! @param[in] axes  coordinate system for the construction of the cone
-  //! @param R1   [in] cone bottom radius, may be null (z = 0)
+  //! @param[in] R1    cone bottom radius, may be null (z = 0)
-  //! @param R2   [in] cone top radius, may be null (z = H)
+  //! @param[in] R2    cone top radius, may be null (z = H)
-  //! @param H    [in] cone height
+  //! @param[in] H     cone height
   Standard_EXPORT BRepPrimAPI_MakeCone(const gp_Ax2& Axes, const Standard_Real R1, const Standard_Real R2, const Standard_Real H);
   
   //! Make a cone of height H radius R1 in the plane z =

src/BRepPrimAPI/BRepPrimAPI_MakeCylinder.hxx

@@ -38,20 +38,20 @@ public:
   DEFINE_STANDARD_ALLOC
 
   //! Make a cylinder.
-  //! @param R [in] cylinder radius
+  //! @param[in] R  cylinder radius
-  //! @param H [in] cylinder height
+  //! @param[in] H  cylinder height
   Standard_EXPORT BRepPrimAPI_MakeCylinder(const Standard_Real R, const Standard_Real H);
 
   //! Make a cylinder (part cylinder).
-  //! @param R     [in] cylinder radius
+  //! @param[in] R      cylinder radius
-  //! @param H     [in] cylinder height
+  //! @param[in] H      cylinder height
-  //! @param Angle [in] defines the missing portion of the cylinder
+  //! @param[in] Angle  defines the missing portion of the cylinder
   Standard_EXPORT BRepPrimAPI_MakeCylinder(const Standard_Real R, const Standard_Real H, const Standard_Real Angle);
 
   //! Make a cylinder of radius R and length H.
-  //! @param Axes [in] coordinate system for the construction of the cylinder
+  //! @param[in] Axes  coordinate system for the construction of the cylinder
-  //! @param R    [in] cylinder radius
+  //! @param[in] R     cylinder radius
-  //! @param H    [in] cylinder height
+  //! @param[in] H     cylinder height
   Standard_EXPORT BRepPrimAPI_MakeCylinder(const gp_Ax2& Axes, const Standard_Real R, const Standard_Real H);
 
   //! Make a cylinder   of  radius R  and  length H with

src/BRepPrimAPI/BRepPrimAPI_MakeSphere.hxx

@@ -39,69 +39,69 @@ public:
 
   
   //! Make a sphere.
-  //! @param R [in] sphere radius
+  //! @param[in] R  sphere radius
   Standard_EXPORT BRepPrimAPI_MakeSphere(const Standard_Real R);
 
   //! Make a sphere (spherical wedge).
-  //! @param R     [in] sphere radius
+  //! @param[in] R      sphere radius
-  //! @param angle [in] angle between the radii lying within the bounding semidisks
+  //! @param[in] angle  angle between the radii lying within the bounding semidisks
   Standard_EXPORT BRepPrimAPI_MakeSphere(const Standard_Real R, const Standard_Real angle);
 
   //! Make a sphere (spherical segment).
-  //! @param R [in] sphere radius
+  //! @param[in] R  sphere radius
-  //! @param angle1 [in] first angle defining a spherical segment
+  //! @param[in] angle1  first angle defining a spherical segment
-  //! @param angle2 [in] second angle defining a spherical segment
+  //! @param[in] angle2  second angle defining a spherical segment
   Standard_EXPORT BRepPrimAPI_MakeSphere(const Standard_Real R, const Standard_Real angle1, const Standard_Real angle2);
 
   //! Make a sphere (spherical segment).
-  //! @param R      [in] sphere radius
+  //! @param[in] R       sphere radius
-  //! @param angle1 [in] first angle defining a spherical segment
+  //! @param[in] angle1  first angle defining a spherical segment
-  //! @param angle2 [in] second angle defining a spherical segment
+  //! @param[in] angle2  second angle defining a spherical segment
-  //! @param angle3 [in] angle between the radii lying within the bounding semidisks
+  //! @param[in] angle3  angle between the radii lying within the bounding semidisks
   Standard_EXPORT BRepPrimAPI_MakeSphere(const Standard_Real R, const Standard_Real angle1, const Standard_Real angle2, const Standard_Real angle3);
 
   //! Make a sphere.
-  //! @param Center [in] sphere center coordinates
+  //! @param[in] Center  sphere center coordinates
-  //! @param R      [in] sphere radius
+  //! @param[in] R       sphere radius
   Standard_EXPORT BRepPrimAPI_MakeSphere(const gp_Pnt& Center, const Standard_Real R);
   
   //! Make a sphere (spherical wedge).
-  //! @param Center [in] sphere center coordinates
+  //! @param[in] Center  sphere center coordinates
-  //! @param R      [in] sphere radius
+  //! @param[in] R       sphere radius
-  //! @param angle  [in] angle between the radii lying within the bounding semidisks
+  //! @param[in] angle   angle between the radii lying within the bounding semidisks
   Standard_EXPORT BRepPrimAPI_MakeSphere(const gp_Pnt& Center, const Standard_Real R, const Standard_Real angle);
 
   //! Make a sphere (spherical segment).
-  //! @param Center [in] sphere center coordinates
+  //! @param[in] Center  sphere center coordinates
-  //! @param R      [in] sphere radius
+  //! @param[in] R       sphere radius
-  //! @param angle1 [in] first angle defining a spherical segment
+  //! @param[in] angle1  first angle defining a spherical segment
-  //! @param angle2 [in] second angle defining a spherical segment
+  //! @param[in] angle2  second angle defining a spherical segment
   Standard_EXPORT BRepPrimAPI_MakeSphere(const gp_Pnt& Center, const Standard_Real R, const Standard_Real angle1, const Standard_Real angle2);
 
   //! Make a sphere (spherical segment).
-  //! @param Center [in] sphere center coordinates
+  //! @param[in] Center  sphere center coordinates
-  //! @param R      [in] sphere radius
+  //! @param[in] R       sphere radius
-  //! @param angle1 [in] first angle defining a spherical segment
+  //! @param[in] angle1  first angle defining a spherical segment
-  //! @param angle2 [in] second angle defining a spherical segment
+  //! @param[in] angle2  second angle defining a spherical segment
-  //! @param angle3 [in] angle between the radii lying within the bounding semidisks
+  //! @param[in] angle3  angle between the radii lying within the bounding semidisks
   Standard_EXPORT BRepPrimAPI_MakeSphere(const gp_Pnt& Center, const Standard_Real R, const Standard_Real angle1, const Standard_Real angle2, const Standard_Real angle3);
 
   //! Make a sphere.
-  //! @param Axis [in] coordinate system for the construction of the sphere
+  //! @param[in] Axis  coordinate system for the construction of the sphere
-  //! @param R    [in] sphere radius
+  //! @param[in] R     sphere radius
   Standard_EXPORT BRepPrimAPI_MakeSphere(const gp_Ax2& Axis, const Standard_Real R);
 
   //! Make a sphere (spherical wedge).
-  //! @param Axis  [in] coordinate system for the construction of the sphere
+  //! @param[in] Axis   coordinate system for the construction of the sphere
-  //! @param R     [in] sphere radius
+  //! @param[in] R      sphere radius
-  //! @param angle [in] angle between the radii lying within the bounding semidisks
+  //! @param[in] angle  angle between the radii lying within the bounding semidisks
   Standard_EXPORT BRepPrimAPI_MakeSphere(const gp_Ax2& Axis, const Standard_Real R, const Standard_Real angle);
 
   //! Make a sphere (spherical segment).
-  //! @param Axis   [in] coordinate system for the construction of the sphere
+  //! @param[in] Axis    coordinate system for the construction of the sphere
-  //! @param R      [in] sphere radius
+  //! @param[in] R       sphere radius
-  //! @param angle1 [in] first angle defining a spherical segment
+  //! @param[in] angle1  first angle defining a spherical segment
-  //! @param angle2 [in] second angle defining a spherical segment
+  //! @param[in] angle2  second angle defining a spherical segment
   Standard_EXPORT BRepPrimAPI_MakeSphere(const gp_Ax2& Axis, const Standard_Real R, const Standard_Real angle1, const Standard_Real angle2);
 
   //! Make a sphere of radius R.

src/BRepPrimAPI/BRepPrimAPI_MakeTorus.hxx

@@ -39,50 +39,50 @@ public:
 
 
   //! Make a torus.
-  //! @param R1 [in] distance from the center of the pipe to the center of the torus
+  //! @param[in] R1  distance from the center of the pipe to the center of the torus
-  //! @param R2 [in] radius of the pipe
+  //! @param[in] R2  radius of the pipe
   Standard_EXPORT BRepPrimAPI_MakeTorus(const Standard_Real R1, const Standard_Real R2);
 
   //! Make a section of a torus.
-  //! @param R1    [in] distance from the center of the pipe to the center of the torus
+  //! @param[in] R1     distance from the center of the pipe to the center of the torus
-  //! @param R2    [in] radius of the pipe
+  //! @param[in] R2     radius of the pipe
-  //! @param angle [in] angle to create a torus pipe segment
+  //! @param[in] angle  angle to create a torus pipe segment
   Standard_EXPORT BRepPrimAPI_MakeTorus(const Standard_Real R1, const Standard_Real R2, const Standard_Real angle);
   
   //! Make  a torus with angles on the small circle.
-  //! @param R1     [in] distance from the center of the pipe to the center of the torus
+  //! @param[in] R1      distance from the center of the pipe to the center of the torus
-  //! @param R2     [in] radius of the pipe
+  //! @param[in] R2      radius of the pipe
-  //! @param angle1 [in] first  angle to create a torus ring segment
+  //! @param[in] angle1  first  angle to create a torus ring segment
-  //! @param angle2 [in] second angle to create a torus ring segment
+  //! @param[in] angle2  second angle to create a torus ring segment
   Standard_EXPORT BRepPrimAPI_MakeTorus(const Standard_Real R1, const Standard_Real R2, const Standard_Real angle1, const Standard_Real angle2);
   
   //! Make  a torus with angles on the small circle.
-  //! @param R1     [in] distance from the center of the pipe to the center of the torus
+  //! @param[in] R1      distance from the center of the pipe to the center of the torus
-  //! @param R2     [in] radius of the pipe
+  //! @param[in] R2      radius of the pipe
-  //! @param angle1 [in] first  angle to create a torus ring segment
+  //! @param[in] angle1  first  angle to create a torus ring segment
-  //! @param angle2 [in] second angle to create a torus ring segment
+  //! @param[in] angle2  second angle to create a torus ring segment
-  //! @param angle  [in] angle to create a torus pipe segment
+  //! @param[in] angle   angle to create a torus pipe segment
   Standard_EXPORT BRepPrimAPI_MakeTorus(const Standard_Real R1, const Standard_Real R2, const Standard_Real angle1, const Standard_Real angle2, const Standard_Real angle);
   
   //! Make a torus.
-  //! @param Axes [in] coordinate system for the construction of the sphere
+  //! @param[in] Axes  coordinate system for the construction of the sphere
-  //! @param R1   [in] distance from the center of the pipe to the center of the torus
+  //! @param[in] R1    distance from the center of the pipe to the center of the torus
-  //! @param R2   [in] radius of the pipe
+  //! @param[in] R2    radius of the pipe
   Standard_EXPORT BRepPrimAPI_MakeTorus(const gp_Ax2& Axes, const Standard_Real R1, const Standard_Real R2);
   
   //! Make a section of a torus.
-  //! @param Axes  [in] coordinate system for the construction of the sphere
+  //! @param[in] Axes   coordinate system for the construction of the sphere
-  //! @param R1    [in] distance from the center of the pipe to the center of the torus
+  //! @param[in] R1     distance from the center of the pipe to the center of the torus
-  //! @param R2    [in] radius of the pipe
+  //! @param[in] R2     radius of the pipe
-  //! @param angle [in] angle to create a torus pipe segment
+  //! @param[in] angle  angle to create a torus pipe segment
   Standard_EXPORT BRepPrimAPI_MakeTorus(const gp_Ax2& Axes, const Standard_Real R1, const Standard_Real R2, const Standard_Real angle);
   
   //! Make a torus.
-  //! @param Axes   [in] coordinate system for the construction of the sphere
+  //! @param[in] Axes    coordinate system for the construction of the sphere
-  //! @param R1     [in] distance from the center of the pipe to the center of the torus
+  //! @param[in] R1      distance from the center of the pipe to the center of the torus
-  //! @param R2     [in] radius of the pipe
+  //! @param[in] R2      radius of the pipe
-  //! @param angle1 [in] first  angle to create a torus ring segment
+  //! @param[in] angle1  first  angle to create a torus ring segment
-  //! @param angle2 [in] second angle to create a torus ring segment
+  //! @param[in] angle2  second angle to create a torus ring segment
   Standard_EXPORT BRepPrimAPI_MakeTorus(const gp_Ax2& Axes, const Standard_Real R1, const Standard_Real R2, const Standard_Real angle1, const Standard_Real angle2);
   
   //! Make a section of a torus of radii R1 R2.

src/BRepTools/BRepTools.hxx

@@ -144,8 +144,8 @@ public:
   //! triangulations and polygons 3d of the edges.
   //! In case polygonal representation is the only available representation
   //! for the shape (shape does not have geometry) it is not removed.
-  //! @param theShape  [in] the shape to clean
+  //! @param[in] theShape   the shape to clean
-  //! @param theForce  [in] allows removing all polygonal representations from the shape,
+  //! @param[in] theForce   allows removing all polygonal representations from the shape,
   //!                       including polygons on triangulations irrelevant for the faces of the given shape.
   Standard_EXPORT static void Clean (const TopoDS_Shape& theShape, const Standard_Boolean theForce = Standard_False);
   
@@ -160,9 +160,9 @@ public:
 
   //! Verifies that each Face from the shape has got a triangulation with a deflection smaller or equal to specified one
   //! and the Edges a discretization on this triangulation.
-  //! @param theShape   [in] shape to verify
+  //! @param[in] theShape    shape to verify
-  //! @param theLinDefl [in] maximum allowed linear deflection
+  //! @param[in] theLinDefl  maximum allowed linear deflection
-  //! @param theToCheckFreeEdges [in] if TRUE, then free Edges are required to have 3D polygon
+  //! @param[in] theToCheckFreeEdges  if TRUE, then free Edges are required to have 3D polygon
   //! @return FALSE if input Shape contains Faces without triangulation,
   //!               or that triangulation has worse (greater) deflection than specified one,
   //!               or Edges in Shape lack polygons on triangulation
@@ -173,13 +173,13 @@ public:
 
   //! Loads triangulation data for each face of the shape
   //! from some deferred storage using specified shared input file system
-  //! @param theShape            [in] shape to load triangulations
+  //! @param[in] theShape             shape to load triangulations
-  //! @param theTriangulationIdx [in] index defining what triangulation should be loaded. Starts from 0.
+  //! @param[in] theTriangulationIdx  index defining what triangulation should be loaded. Starts from 0.
   //!        -1 is used in specific case to load currently already active triangulation.
   //!        If some face doesn't contain triangulation with this index, nothing will be loaded for it.
   //!        Exception will be thrown in case of invalid negative index
-  //! @param theToSetAsActive    [in] flag to activate triangulation after its loading
+  //! @param[in] theToSetAsActive     flag to activate triangulation after its loading
-  //! @param theFileSystem       [in] shared file system
+  //! @param[in] theFileSystem        shared file system
   //! @return TRUE if at least one triangulation is loaded.
   Standard_EXPORT static Standard_Boolean LoadTriangulation (const TopoDS_Shape& theShape,
                                                              const Standard_Integer theTriangulationIdx = -1,
@@ -187,8 +187,8 @@ public:
                                                              const Handle(OSD_FileSystem)& theFileSystem = Handle(OSD_FileSystem)());
 
   //! Releases triangulation data for each face of the shape if there is deferred storage to load it later
-  //! @param theShape            [in] shape to unload triangulations
+  //! @param[in] theShape             shape to unload triangulations
-  //! @param theTriangulationIdx [in] index defining what triangulation should be unloaded. Starts from 0.
+  //! @param[in] theTriangulationIdx  index defining what triangulation should be unloaded. Starts from 0.
   //!        -1 is used in specific case to unload currently already active triangulation.
   //!        If some face doesn't contain triangulation with this index, nothing will be unloaded for it.
   //!        Exception will be thrown in case of invalid negative index
@@ -198,10 +198,10 @@ public:
 
   //! Activates triangulation data for each face of the shape
   //! from some deferred storage using specified shared input file system
-  //! @param theShape              [in] shape to activate triangulations
+  //! @param[in] theShape               shape to activate triangulations
-  //! @param theTriangulationIdx   [in] index defining what triangulation should be activated. Starts from 0.
+  //! @param[in] theTriangulationIdx    index defining what triangulation should be activated. Starts from 0.
   //!        Exception will be thrown in case of invalid negative index
-  //! @param theToActivateStrictly [in] flag to activate exactly triangulation with defined theTriangulationIdx index.
+  //! @param[in] theToActivateStrictly  flag to activate exactly triangulation with defined theTriangulationIdx index.
   //!        In TRUE case if some face doesn't contain triangulation with this index, active triangulation
   //!        will not be changed for it. Else the last available triangulation will be activated.
   //! @return TRUE if at least one active triangulation was changed.
@@ -211,14 +211,14 @@ public:
 
   //! Loads all available triangulations for each face of the shape
   //! from some deferred storage using specified shared input file system
-  //! @param theShape      [in] shape to load triangulations
+  //! @param[in] theShape       shape to load triangulations
-  //! @param theFileSystem [in] shared file system
+  //! @param[in] theFileSystem  shared file system
   //! @return TRUE if at least one triangulation is loaded.
   Standard_EXPORT static Standard_Boolean LoadAllTriangulations (const TopoDS_Shape& theShape,
                                                                  const Handle(OSD_FileSystem)& theFileSystem = Handle(OSD_FileSystem)());
 
   //! Releases all available triangulations for each face of the shape if there is deferred storage to load them later
-  //! @param theShape      [in] shape to unload triangulations
+  //! @param[in] theShape       shape to unload triangulations
   //! @return TRUE if at least one triangulation is unloaded.
   Standard_EXPORT static Standard_Boolean UnloadAllTriangulations (const TopoDS_Shape& theShape);
 
@@ -255,8 +255,8 @@ public:
 
   //! Writes the shape to the stream in an ASCII format TopTools_FormatVersion_VERSION_1.
   //! This alias writes shape with triangulation data.
-  //! @param theShape [in]       the shape to write
+  //! @param[in] theShape        the shape to write
-  //! @param theStream [in][out] the stream to output shape into
+  //! @param[in][out] theStream  the stream to output shape into
   //! @param theRange            the range of progress indicator to fill in
   static void Write (const TopoDS_Shape& theShape,
                      Standard_OStream& theStream,
@@ -267,13 +267,13 @@ public:
   }
 
   //! Writes the shape to the stream in an ASCII format of specified version.
-  //! @param theShape [in]         the shape to write
+  //! @param[in] theShape          the shape to write
-  //! @param theStream [in][out]   the stream to output shape into
+  //! @param[in][out] theStream    the stream to output shape into
-  //! @param theWithTriangles [in] flag which specifies whether to save shape with (TRUE) or without (FALSE) triangles;
+  //! @param[in] theWithTriangles  flag which specifies whether to save shape with (TRUE) or without (FALSE) triangles;
   //!                              has no effect on triangulation-only geometry
-  //! @param theWithNormals [in]   flag which specifies whether to save triangulation with (TRUE) or without (FALSE) normals;
+  //! @param[in] theWithNormals    flag which specifies whether to save triangulation with (TRUE) or without (FALSE) normals;
   //!                              has no effect on triangulation-only geometry
-  //! @param theVersion [in]       the TopTools format version
+  //! @param[in] theVersion        the TopTools format version
   //! @param theProgress the range of progress indicator to fill in
   Standard_EXPORT static void Write (const TopoDS_Shape& theShape,
                                      Standard_OStream& theStream,
@@ -289,8 +289,8 @@ public:
 
   //! Writes the shape to the file in an ASCII format TopTools_FormatVersion_VERSION_1.
   //! This alias writes shape with triangulation data.
-  //! @param theShape [in] the shape to write
+  //! @param[in] theShape  the shape to write
-  //! @param theFile [in]  the path to file to output shape into
+  //! @param[in] theFile   the path to file to output shape into
   //! @param theProgress the range of progress indicator to fill in
   static Standard_Boolean Write (const TopoDS_Shape& theShape,
                                  const Standard_CString theFile,
@@ -301,13 +301,13 @@ public:
   }
 
   //! Writes the shape to the file in an ASCII format of specified version.
-  //! @param theShape [in]         the shape to write
+  //! @param[in] theShape          the shape to write
-  //! @param theFile [in]          the path to file to output shape into
+  //! @param[in] theFile           the path to file to output shape into
-  //! @param theWithTriangles [in] flag which specifies whether to save shape with (TRUE) or without (FALSE) triangles;
+  //! @param[in] theWithTriangles  flag which specifies whether to save shape with (TRUE) or without (FALSE) triangles;
   //!                              has no effect on triangulation-only geometry
-  //! @param theWithNormals [in]   flag which specifies whether to save triangulation with (TRUE) or without (FALSE) normals;
+  //! @param[in] theWithNormals    flag which specifies whether to save triangulation with (TRUE) or without (FALSE) normals;
   //!                              has no effect on triangulation-only geometry
-  //! @param theVersion [in]       the TopTools format version
+  //! @param[in] theVersion        the TopTools format version
   //! @param theProgress the range of progress indicator to fill in
   Standard_EXPORT static Standard_Boolean Write (const TopoDS_Shape& theShape,
                                                  const Standard_CString theFile,

src/BRepTools/BRepTools_History.hxx

@@ -95,8 +95,8 @@ public: //! @name Constructors for History creation
 
   //! Template constructor for History creation from the algorithm having
   //! standard history methods such as IsDeleted(), Modified() and Generated().
-  //! @param theArguments [in] Arguments of the algorithm;
+  //! @param[in] theArguments  Arguments of the algorithm;
-  //! @param theAlgo [in] The algorithm.
+  //! @param[in] theAlgo  The algorithm.
   template <class TheAlgo>
   BRepTools_History(const TopTools_ListOfShape& theArguments,
                     TheAlgo& theAlgo)
@@ -216,8 +216,8 @@ public: //! A method to merge a next history to this history.
   //! Template method for merging history of the algorithm having standard
   //! history methods such as IsDeleted(), Modified() and Generated()
   //! into current history object.
-  //! @param theArguments [in] Arguments of the algorithm;
+  //! @param[in] theArguments  Arguments of the algorithm;
-  //! @param theAlgo [in] The algorithm.
+  //! @param[in] theAlgo  The algorithm.
   template<class TheAlgo>
   void Merge(const TopTools_ListOfShape& theArguments,
              TheAlgo& theAlgo)

src/BinTools/BinTools.hxx

@@ -56,8 +56,8 @@ public:
 
   //! Writes the shape to the stream in binary format BinTools_FormatVersion_CURRENT.
   //! This alias writes shape with triangulation data.
-  //! @param theShape [in]       the shape to write
+  //! @param[in] theShape        the shape to write
-  //! @param theStream [in][out] the stream to output shape into
+  //! @param[in][out] theStream  the stream to output shape into
   //! @param theRange            the range of progress indicator to fill in
   static void Write (const TopoDS_Shape& theShape,
                      Standard_OStream& theStream,
@@ -68,13 +68,13 @@ public:
   }
 
   //! Writes the shape to the stream in binary format of specified version.
-  //! @param theShape [in]         the shape to write
+  //! @param[in] theShape          the shape to write
-  //! @param theStream [in][out]   the stream to output shape into
+  //! @param[in][out] theStream    the stream to output shape into
-  //! @param theWithTriangles [in] flag which specifies whether to save shape with (TRUE) or without (FALSE) triangles;
+  //! @param[in] theWithTriangles  flag which specifies whether to save shape with (TRUE) or without (FALSE) triangles;
   //!                              has no effect on triangulation-only geometry
-  //! @param theWithNormals [in]   flag which specifies whether to save triangulation with (TRUE) or without (FALSE) normals;
+  //! @param[in] theWithNormals    flag which specifies whether to save triangulation with (TRUE) or without (FALSE) normals;
   //!                              has no effect on triangulation-only geometry
-  //! @param theVersion [in]       the BinTools format version
+  //! @param[in] theVersion        the BinTools format version
   //! @param theRange              the range of progress indicator to fill in
   Standard_EXPORT static void Write(const TopoDS_Shape& theShape, Standard_OStream& theStream,
                                     const Standard_Boolean theWithTriangles,
@@ -87,8 +87,8 @@ public:
                                     const Message_ProgressRange& theRange = Message_ProgressRange());
 
   //! Writes the shape to the file in binary format BinTools_FormatVersion_CURRENT.
-  //! @param theShape [in] the shape to write
+  //! @param[in] theShape  the shape to write
-  //! @param theFile [in]  the path to file to output shape into
+  //! @param[in] theFile   the path to file to output shape into
   //! @param theRange      the range of progress indicator to fill in
   static Standard_Boolean Write (const TopoDS_Shape& theShape,
                                  const Standard_CString theFile,
@@ -99,13 +99,13 @@ public:
   }
 
   //! Writes the shape to the file in binary format of specified version.
-  //! @param theShape [in]         the shape to write
+  //! @param[in] theShape          the shape to write
-  //! @param theFile [in]          the path to file to output shape into
+  //! @param[in] theFile           the path to file to output shape into
-  //! @param theWithTriangles [in] flag which specifies whether to save shape with (TRUE) or without (FALSE) triangles;
+  //! @param[in] theWithTriangles  flag which specifies whether to save shape with (TRUE) or without (FALSE) triangles;
   //!                              has no effect on triangulation-only geometry
-  //! @param theWithNormals [in]   flag which specifies whether to save triangulation with (TRUE) or without (FALSE) normals;
+  //! @param[in] theWithNormals    flag which specifies whether to save triangulation with (TRUE) or without (FALSE) normals;
   //!                              has no effect on triangulation-only geometry
-  //! @param theVersion [in]       the BinTools format version
+  //! @param[in] theVersion        the BinTools format version
   //! @param theRange              the range of progress indicator to fill in
   Standard_EXPORT static Standard_Boolean Write (const TopoDS_Shape& theShape,
                                                  const Standard_CString theFile,

src/BinTools/BinTools_ShapeSet.hxx

@@ -37,7 +37,7 @@ public:
   DEFINE_STANDARD_ALLOC
 
   //! Builds an empty ShapeSet.
-  //! @param theWithTriangles [in] flag to write triangulation data
+  //! @param[in] theWithTriangles  flag to write triangulation data
   Standard_EXPORT BinTools_ShapeSet ();
 
   Standard_EXPORT virtual ~BinTools_ShapeSet();

src/DBRep/DBRep.hxx

@@ -41,18 +41,18 @@ public:
   Standard_EXPORT static void Set (const Standard_CString Name, const TopoDS_Shape& S);
   
   //! Returns the shape in the variable.
-  //! @param theName [in] [out] variable name, or "." to pick up shape interactively (the picked name will be returned then)
+  //! @param[in][out] theName   variable name, or "." to pick up shape interactively (the picked name will be returned then)
-  //! @param theType [in]       shape type filter; function will return NULL if shape has different type
+  //! @param[in] theType        shape type filter; function will return NULL if shape has different type
-  //! @param theToComplain [in] when TRUE, prints a message on cout if the variable is not set
+  //! @param[in] theToComplain  when TRUE, prints a message on cout if the variable is not set
   static TopoDS_Shape Get (Standard_CString& theName, TopAbs_ShapeEnum theType = TopAbs_SHAPE, Standard_Boolean theToComplain = Standard_False)
   {
     return getShape (theName, theType, theToComplain);
   }
 
   //! Returns the shape in the variable.
-  //! @param theName [in] [out] variable name, or "." to pick up shape interactively (the picked name will be returned then)
+  //! @param[in][out] theName   variable name, or "." to pick up shape interactively (the picked name will be returned then)
-  //! @param theType [in]       shape type filter; function will return NULL if shape has different type
+  //! @param[in] theType        shape type filter; function will return NULL if shape has different type
-  //! @param theToComplain [in] when TRUE, prints a message on cout if the variable is not set
+  //! @param[in] theToComplain  when TRUE, prints a message on cout if the variable is not set
   static TopoDS_Shape Get (TCollection_AsciiString& theName, TopAbs_ShapeEnum theType = TopAbs_SHAPE, Standard_Boolean theToComplain = Standard_False)
   {
     Standard_CString aNamePtr = theName.ToCString();
@@ -65,9 +65,9 @@ public:
   }
 
   //! Returns the shape in the variable.
-  //! @param theName [in] variable name
+  //! @param[in] theName  variable name
-  //! @param theType [in] shape type filter; function will return NULL if shape has different type
+  //! @param[in] theType  shape type filter; function will return NULL if shape has different type
-  //! @param theToComplain [in] when TRUE, prints a message on cout if the variable is not set
+  //! @param[in] theToComplain  when TRUE, prints a message on cout if the variable is not set
   static TopoDS_Shape GetExisting (const TCollection_AsciiString& theName, TopAbs_ShapeEnum theType = TopAbs_SHAPE, Standard_Boolean theToComplain = Standard_False)
   {
     if (theName.Length() == 1
@@ -110,9 +110,9 @@ public:
 protected:
 
   //! Returns the shape in the variable.
-  //! @param theName [in] [out] variable name, or "." to pick up shape interactively (the picked name will be returned then)
+  //! @param[in][out] theName   variable name, or "." to pick up shape interactively (the picked name will be returned then)
-  //! @param theType [in]       shape type filter; function will return NULL if shape has different type
+  //! @param[in] theType        shape type filter; function will return NULL if shape has different type
-  //! @param theToComplain [in] when TRUE, prints a message on cout if the variable is not set
+  //! @param[in] theToComplain  when TRUE, prints a message on cout if the variable is not set
   Standard_EXPORT static TopoDS_Shape getShape (Standard_CString& theName,
                                                 TopAbs_ShapeEnum theType,
                                                 Standard_Boolean theToComplain);

src/DBRep/DBRep_DrawableShape.hxx

@@ -101,28 +101,28 @@ public:
 public:
 
   //! Auxiliary method computing nodal normals for presentation purposes.
-  //! @param theNormals [out] vector of computed normals (pair of points [from, to])
+  //! @param[out] theNormals  vector of computed normals (pair of points [from, to])
-  //! @param theFace    [in]  input face
+  //! @param[in] theFace      input face
-  //! @param theLength  [in]  normal length
+  //! @param[in] theLength    normal length
   //! @return FALSE if normals can not be computed
   Standard_EXPORT static Standard_Boolean addMeshNormals (NCollection_Vector<std::pair<gp_Pnt, gp_Pnt> >& theNormals,
                                                           const TopoDS_Face&  theFace,
                                                           const Standard_Real theLength);
 
   //! Auxiliary method computing nodal normals for presentation purposes.
-  //! @param theNormals [out] map of computed normals (grouped per Face)
+  //! @param[out] theNormals  map of computed normals (grouped per Face)
-  //! @param theShape   [in]  input shape which will be exploded into Faces
+  //! @param[in] theShape     input shape which will be exploded into Faces
-  //! @param theLength  [in]  normal length
+  //! @param[in] theLength    normal length
   Standard_EXPORT static void addMeshNormals (NCollection_DataMap<TopoDS_Face, NCollection_Vector<std::pair<gp_Pnt, gp_Pnt> > > & theNormals,
                                               const TopoDS_Shape& theShape,
                                               const Standard_Real theLength);
 
   //! Auxiliary method computing surface normals distributed within the Face for presentation purposes.
-  //! @param theNormals  [out] vector of computed normals (pair of points [from, to])
+  //! @param[out] theNormals   vector of computed normals (pair of points [from, to])
-  //! @param theFace     [in]  input face
+  //! @param[in] theFace       input face
-  //! @param theLength   [in]  normal length
+  //! @param[in] theLength     normal length
-  //! @param theNbAlongU [in]  number along U
+  //! @param[in] theNbAlongU   number along U
-  //! @param theNbAlongV [in]  number along V
+  //! @param[in] theNbAlongV   number along V
   //! @return FALSE if normals can not be computed
   Standard_EXPORT static Standard_Boolean addSurfaceNormals (NCollection_Vector<std::pair<gp_Pnt, gp_Pnt> >& theNormals,
                                                              const TopoDS_Face&     theFace,
@@ -131,11 +131,11 @@ public:
                                                              const Standard_Integer theNbAlongV);
 
   //! Auxiliary method computing surface normals distributed within the Face for presentation purposes.
-  //! @param theNormals  [out] map of computed normals (grouped per Face)
+  //! @param[out] theNormals   map of computed normals (grouped per Face)
-  //! @param theShape    [in]  input shape which will be exploded into Faces
+  //! @param[in] theShape      input shape which will be exploded into Faces
-  //! @param theLength   [in]  normal length
+  //! @param[in] theLength     normal length
-  //! @param theNbAlongU [in]  number along U
+  //! @param[in] theNbAlongU   number along U
-  //! @param theNbAlongV [in]  number along V
+  //! @param[in] theNbAlongV   number along V
   //! @return FALSE if normals can not be computed
   Standard_EXPORT static void addSurfaceNormals (NCollection_DataMap<TopoDS_Face, NCollection_Vector<std::pair<gp_Pnt, gp_Pnt> > >& theNormals,
                                                  const TopoDS_Shape&    theShape,

src/DE/DE_Provider.hxx

@@ -59,7 +59,7 @@ public:
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theDocument document to save result
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return True if Read was successful
   Standard_EXPORT virtual Standard_Boolean Read(const TCollection_AsciiString& thePath,
                                                 const Handle(TDocStd_Document)& theDocument,
@@ -70,7 +70,7 @@ public:
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theDocument document to export
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return True if Write was successful
   Standard_EXPORT virtual Standard_Boolean Write(const TCollection_AsciiString& thePath,
                                                  const Handle(TDocStd_Document)& theDocument,
@@ -80,7 +80,7 @@ public:
   //! Reads a CAD file, according internal configuration
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theDocument document to save result
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return True if Read was successful
   Standard_EXPORT virtual Standard_Boolean Read(const TCollection_AsciiString& thePath,
                                                 const Handle(TDocStd_Document)& theDocument,
@@ -89,7 +89,7 @@ public:
   //! Writes a CAD file, according internal configuration
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theDocument document to export
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return True if Write was successful
   Standard_EXPORT virtual Standard_Boolean Write(const TCollection_AsciiString& thePath,
                                                  const Handle(TDocStd_Document)& theDocument,
@@ -99,7 +99,7 @@ public:
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theShape shape to save result
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return True if Read was successful
   Standard_EXPORT virtual Standard_Boolean Read(const TCollection_AsciiString& thePath,
                                                 TopoDS_Shape& theShape,
@@ -110,7 +110,7 @@ public:
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theShape shape to export
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return True if Write was successful
   Standard_EXPORT virtual Standard_Boolean Write(const TCollection_AsciiString& thePath,
                                                  const TopoDS_Shape& theShape,
@@ -120,7 +120,7 @@ public:
   //! Reads a CAD file, according internal configuration
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theShape shape to save result
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return True if Read was successful
   Standard_EXPORT virtual Standard_Boolean Read(const TCollection_AsciiString& thePath,
                                                 TopoDS_Shape& theShape,
@@ -129,7 +129,7 @@ public:
   //! Writes a CAD file, according internal configuration
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theShape shape to export
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return True if Write was successful
   Standard_EXPORT virtual Standard_Boolean Write(const TCollection_AsciiString& thePath,
                                                  const TopoDS_Shape& theShape,

src/DE/DE_Wrapper.hxx

@@ -79,7 +79,7 @@ public:
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theDocument document to save result
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT Standard_Boolean Read(const TCollection_AsciiString& thePath,
                                         const Handle(TDocStd_Document)& theDocument,
@@ -90,7 +90,7 @@ public:
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theDocument document to export
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT Standard_Boolean Write(const TCollection_AsciiString& thePath,
                                          const Handle(TDocStd_Document)& theDocument,
@@ -100,7 +100,7 @@ public:
   //! Reads a CAD file, according internal configuration
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theDocument document to save result
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT Standard_Boolean Read(const TCollection_AsciiString& thePath,
                                         const Handle(TDocStd_Document)& theDocument,
@@ -109,7 +109,7 @@ public:
   //! Writes a CAD file, according internal configuration
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theDocument document to export
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT Standard_Boolean Write(const TCollection_AsciiString& thePath,
                                          const Handle(TDocStd_Document)& theDocument,
@@ -119,7 +119,7 @@ public:
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theShape shape to save result
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT Standard_Boolean Read(const TCollection_AsciiString& thePath,
                                         TopoDS_Shape& theShape,
@@ -130,7 +130,7 @@ public:
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theShape shape to export
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT Standard_Boolean Write(const TCollection_AsciiString& thePath,
                                          const TopoDS_Shape& theShape,
@@ -140,7 +140,7 @@ public:
   //! Reads a CAD file, according internal configuration
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theShape shape to save result
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT Standard_Boolean Read(const TCollection_AsciiString& thePath,
                                         TopoDS_Shape& theShape,
@@ -149,7 +149,7 @@ public:
   //! Writes a CAD file, according internal configuration
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theShape shape to export
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT Standard_Boolean Write(const TCollection_AsciiString& thePath,
                                          const TopoDS_Shape& theShape,

src/DEBRepCascade/DEBRepCascade_Provider.hxx

@@ -46,7 +46,7 @@ public:
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theDocument document to save result
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT virtual bool Read(const TCollection_AsciiString& thePath,
                                     const Handle(TDocStd_Document)& theDocument,
@@ -57,7 +57,7 @@ public:
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theDocument document to export
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT virtual bool Write(const TCollection_AsciiString& thePath,
                                      const Handle(TDocStd_Document)& theDocument,
@@ -67,7 +67,7 @@ public:
   //! Reads a CAD file, according internal configuration
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theDocument document to save result
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT virtual bool Read(const TCollection_AsciiString& thePath,
                                     const Handle(TDocStd_Document)& theDocument,
@@ -76,7 +76,7 @@ public:
   //! Writes a CAD file, according internal configuration
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theDocument document to export
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT virtual bool Write(const TCollection_AsciiString& thePath,
                                      const Handle(TDocStd_Document)& theDocument,
@@ -86,7 +86,7 @@ public:
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theShape shape to save result
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT virtual bool Read(const TCollection_AsciiString& thePath,
                                     TopoDS_Shape& theShape,
@@ -97,7 +97,7 @@ public:
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theShape shape to export
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT virtual bool Write(const TCollection_AsciiString& thePath,
                                      const TopoDS_Shape& theShape,
@@ -107,7 +107,7 @@ public:
   //! Reads a CAD file, according internal configuration
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theShape shape to save result
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT virtual bool Read(const TCollection_AsciiString& thePath,
                                     TopoDS_Shape& theShape,
@@ -116,7 +116,7 @@ public:
   //! Writes a CAD file, according internal configuration
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theShape shape to export
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT virtual bool Write(const TCollection_AsciiString& thePath,
                                      const TopoDS_Shape& theShape,

src/DEXCAFCascade/DEXCAFCascade_Provider.hxx

@@ -46,7 +46,7 @@ public:
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theDocument document to save result
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT virtual bool Read(const TCollection_AsciiString& thePath,
                                     const Handle(TDocStd_Document)& theDocument,
@@ -57,7 +57,7 @@ public:
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theDocument document to export
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT virtual bool Write(const TCollection_AsciiString& thePath,
                                      const Handle(TDocStd_Document)& theDocument,
@@ -67,7 +67,7 @@ public:
   //! Reads a CAD file, according internal configuration
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theDocument document to save result
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT virtual bool Read(const TCollection_AsciiString& thePath,
                                     const Handle(TDocStd_Document)& theDocument,
@@ -76,7 +76,7 @@ public:
   //! Writes a CAD file, according internal configuration
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theDocument document to export
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT virtual bool Write(const TCollection_AsciiString& thePath,
                                      const Handle(TDocStd_Document)& theDocument,
@@ -86,7 +86,7 @@ public:
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theShape shape to save result
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT virtual bool Read(const TCollection_AsciiString& thePath,
                                     TopoDS_Shape& theShape,
@@ -97,7 +97,7 @@ public:
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theShape shape to export
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT virtual bool Write(const TCollection_AsciiString& thePath,
                                      const TopoDS_Shape& theShape,
@@ -107,7 +107,7 @@ public:
   //! Reads a CAD file, according internal configuration
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theShape shape to save result
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT virtual bool Read(const TCollection_AsciiString& thePath,
                                     TopoDS_Shape& theShape,
@@ -116,7 +116,7 @@ public:
   //! Writes a CAD file, according internal configuration
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theShape shape to export
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT virtual bool Write(const TCollection_AsciiString& thePath,
                                      const TopoDS_Shape& theShape,

src/Draw/Draw.hxx

@@ -33,12 +33,12 @@ public:
   DEFINE_STANDARD_ALLOC
 
   //! (Re)Load a Draw Harness plugin.
-  //! @param theDI  [in] [out] Tcl interpretor to append loaded commands
+  //! @param[in][out] theDI    Tcl interpretor to append loaded commands
-  //! @param theKey [in] plugin code name to be resolved in resource file
+  //! @param[in] theKey  plugin code name to be resolved in resource file
-  //! @param theResourceFileName   [in] description file name
+  //! @param[in] theResourceFileName    description file name
-  //! @param theDefaultsDirectory  [in] default folder for looking description file
+  //! @param[in] theDefaultsDirectory   default folder for looking description file
-  //! @param theUserDefaultsDirectory [in] user folder for looking description file
+  //! @param[in] theUserDefaultsDirectory  user folder for looking description file
-  //! @param theIsVerbose [in] print verbose messages
+  //! @param[in] theIsVerbose  print verbose messages
   Standard_EXPORT static void Load (Draw_Interpretor& theDI,
                                     const TCollection_AsciiString& theKey,
                                     const TCollection_AsciiString& theResourceFileName,
@@ -128,9 +128,9 @@ public: //! @name argument parsing tools
   //!   }
   //! @endcode
   //!
-  //! @param theArgNb  [in] number of available arguments in theArgVec (array limits)
+  //! @param[in] theArgNb   number of available arguments in theArgVec (array limits)
-  //! @param theArgVec [in] argument list
+  //! @param[in] theArgVec  argument list
-  //! @param theColor [out] retrieved color
+  //! @param[out] theColor  retrieved color
   //! @return number of handled arguments (1, 2, 3 or 4) or 0 on syntax error
   static Standard_Integer ParseColor (const Standard_Integer   theArgNb,
                                       const char* const* const theArgVec,
@@ -140,9 +140,9 @@ public: //! @name argument parsing tools
   }
 
   //! Parses RGB color argument(s).
-  //! @param theArgNb  [in] number of available arguments in theArgVec (array limits)
+  //! @param[in] theArgNb   number of available arguments in theArgVec (array limits)
-  //! @param theArgVec [in] argument list
+  //! @param[in] theArgVec  argument list
-  //! @param theColor [out] retrieved color
+  //! @param[out] theColor  retrieved color
   //! @return number of handled arguments (1 or 3) or 0 on syntax error.
   static Standard_Integer ParseColor (const Standard_Integer   theArgNb,
                                       const char* const* const theArgVec,
@@ -177,8 +177,8 @@ public: //! @name argument parsing tools
   //!   }
   //! @endcode
   //!
-  //! @param theArg   [in] argument value
+  //! @param[in] theArg    argument value
-  //! @param theIsOn [out] decoded Boolean flag
+  //! @param[out] theIsOn  decoded Boolean flag
   //! @return FALSE on syntax error
   Standard_EXPORT static Standard_Boolean ParseOnOff (Standard_CString  theArg,
                                                       Standard_Boolean& theIsOn);
@@ -197,9 +197,9 @@ public: //! @name argument parsing tools
   //!   }
   //! @endcode
   //!
-  //! @param theArgsNb [in] overall number of arguments
+  //! @param[in] theArgsNb  overall number of arguments
-  //! @param theArgVec [in] vector of arguments
+  //! @param[in] theArgVec  vector of arguments
-  //! @param theArgIter [in] [out] argument position to parse
+  //! @param[in][out] theArgIter   argument position to parse
   //! @return flag value
   Standard_EXPORT static Standard_Boolean ParseOnOffIterator (Standard_Integer  theArgsNb,
                                                               const char**      theArgVec,
@@ -208,9 +208,9 @@ public: //! @name argument parsing tools
   //! Parses boolean argument at specified iterator position with optional on/off coming next.
   //! Similar to ParseOnOffIterator() but also reverses returned value if argument name starts with "no" prefix.
   //! E.g. if nominal argument is "cmd -usefeature [on|off|1|0]=on", then "-nousefeature" argument will return FALSE.
-  //! @param theArgsNb [in] overall number of arguments
+  //! @param[in] theArgsNb  overall number of arguments
-  //! @param theArgVec [in] vector of arguments
+  //! @param[in] theArgVec  vector of arguments
-  //! @param theArgIter [in] [out] argument position to parse
+  //! @param[in][out] theArgIter   argument position to parse
   //! @return flag value
   Standard_EXPORT static Standard_Boolean ParseOnOffNoIterator (Standard_Integer  theArgsNb,
                                                                 const char**      theArgVec,
@@ -256,8 +256,8 @@ public: //! @name methods loading standard command sets
 protected:
 
   //! Returns a variable value.
-  //! @param theName [in] [out] variable name, or "." to activate picking
+  //! @param[in][out] theName   variable name, or "." to activate picking
-  //! @param theToAllowPick [in] when TRUE, "." name will activate picking
+  //! @param[in] theToAllowPick  when TRUE, "." name will activate picking
   Standard_EXPORT static Handle(Draw_Drawable3D) getDrawable (Standard_CString& theName,
                                                               Standard_Boolean theToAllowPick);
 

src/Draw/Draw_Drawable3D.hxx

@@ -37,14 +37,14 @@ public:
   typedef Handle(Draw_Drawable3D)(*FactoryFunction_t)(Standard_IStream& theStream);
 
   //! Register factory for restoring drawable from stream (opposite to Draw_Drawable3D::Save()).
-  //! @param theType [in] class name
+  //! @param[in] theType  class name
-  //! @param theFactory [in] factory function
+  //! @param[in] theFactory  factory function
   Standard_EXPORT static void RegisterFactory (const Standard_CString theType,
                                                const FactoryFunction_t& theFactory);
 
   //! Restore drawable from stream (opposite to Draw_Drawable3D::Save()).
-  //! @param theType [in] class name
+  //! @param[in] theType  class name
-  //! @param theStream [in] input stream
+  //! @param[in] theStream  input stream
   //! @return restored drawable or NULL if factory is undefined for specified class
   Standard_EXPORT static Handle(Draw_Drawable3D) Restore (const Standard_CString theType,
                                                           Standard_IStream& theStream);

src/Draw/Draw_Window.hxx

@@ -204,11 +204,11 @@ public:
 protected:
 
   //! Main constructor.
-  //! @param theTitle  [in] window title
+  //! @param[in] theTitle   window title
-  //! @param theXY     [in] top-left position
+  //! @param[in] theXY      top-left position
-  //! @param theSize   [in] window dimensions
+  //! @param[in] theSize    window dimensions
-  //! @param theParent [in] optional native parent window
+  //! @param[in] theParent  optional native parent window
-  //! @param theWin    [in] optional native window
+  //! @param[in] theWin     optional native window
   Standard_EXPORT Draw_Window (const char* theTitle,
                                const NCollection_Vec2<int>& theXY,
                                const NCollection_Vec2<int>& theSize,

src/DsgPrs/DsgPrs_DatumPrs.hxx

@@ -31,9 +31,9 @@ public:
   //! The thihedron origin and axis directions are defined by theDatum coordinate system.
   //! DsgPrs_XYZAxisPresentation framework is used to create graphical primitives for each axis.
   //! Axes are marked with "X", "Y", "Z" text.
-  //! @param thePresentation [out] the modified presentation
+  //! @param[out] thePresentation  the modified presentation
-  //! @param theDatum [in] the source of trihedron position
+  //! @param[in] theDatum  the source of trihedron position
-  //! @param theDrawer [in] the provider of display attributes
+  //! @param[in] theDrawer  the provider of display attributes
   Standard_EXPORT static void Add (const Handle(Prs3d_Presentation)& thePresentation, const gp_Ax2& theDatum,
                                    const Handle(Prs3d_Drawer)& theDrawer);
 

src/Font/Font_FTFont.hxx

@@ -300,8 +300,8 @@ public:
 public:
 
   //! Computes outline contour for the symbol.
-  //! @param theUChar    [in] the character to be loaded as current one
+  //! @param[in] theUChar     the character to be loaded as current one
-  //! @param theOutline  [out] outline contour
+  //! @param[out] theOutline   outline contour
   //! @return true on success
   Standard_EXPORT const FT_Outline* renderGlyphOutline(const Standard_Utf32Char theChar);
 

src/Font/Font_FontMgr.hxx

@@ -94,11 +94,11 @@ public:
   //! If the requested family name not found -> search for any font family with given aspect and height.
   //! If the font is still not found, returns any font available in the system.
   //! Returns NULL in case when the fonts are not found in the system.
-  //! @param theFontName    [in]       font family to find or alias name
+  //! @param[in] theFontName           font family to find or alias name
-  //! @param theStrictLevel [in]       search strict level for using aliases and fallback
+  //! @param[in] theStrictLevel        search strict level for using aliases and fallback
-  //! @param theFontAspect  [in] [out] font aspect to find (considered only if family name is not found);
+  //! @param[in][out] theFontAspect    font aspect to find (considered only if family name is not found);
   //!                                  can be modified if specified font alias refers to another style (compatibility with obsolete aliases)
-  //! @param theDoFailMsg   [in]       put error message on failure into default messenger
+  //! @param[in] theDoFailMsg          put error message on failure into default messenger
   Standard_EXPORT Handle(Font_SystemFont) FindFont (const TCollection_AsciiString& theFontName,
                                                     Font_StrictLevel theStrictLevel,
                                                     Font_FontAspect& theFontAspect,
@@ -113,8 +113,8 @@ public:
 
   //! Tries to find fallback font for specified Unicode subset.
   //! Returns NULL in case when fallback font is not found in the system.
-  //! @param theSubset     [in] Unicode subset
+  //! @param[in] theSubset      Unicode subset
-  //! @param theFontAspect [in] font aspect to find
+  //! @param[in] theFontAspect  font aspect to find
   Standard_EXPORT Handle(Font_SystemFont) FindFallbackFont (Font_UnicodeSubset theSubset,
                                                             Font_FontAspect theFontAspect) const;
 
@@ -153,12 +153,12 @@ public:
   void SetTraceAliases (Standard_Boolean theToTrace) { myToTraceAliases = theToTrace; }
 
   //! Return font names with defined aliases.
-  //! @param theAliases [out] alias names
+  //! @param[out] theAliases  alias names
   Standard_EXPORT void GetAllAliases (TColStd_SequenceOfHAsciiString& theAliases) const;
 
   //! Return aliases to specified font name.
-  //! @param theFontNames [out] font names associated with alias name
+  //! @param[out] theFontNames  font names associated with alias name
-  //! @param theAliasName [in]  alias name
+  //! @param[in] theAliasName   alias name
   Standard_EXPORT void GetFontAliases (TColStd_SequenceOfHAsciiString& theFontNames,
                                        const TCollection_AsciiString& theAliasName) const;
 
@@ -173,16 +173,16 @@ public:
   //! Aliases are defined "in advance", so that they could point to non-existing fonts,
   //! and they are resolved dynamically on request - first existing font is returned in case of multiple aliases to the same name.
   //!
-  //! @param theAliasName [in] alias name or name of another font to be used as alias
+  //! @param[in] theAliasName  alias name or name of another font to be used as alias
-  //! @param theFontName  [in] font to be used as substitution for alias
+  //! @param[in] theFontName   font to be used as substitution for alias
   //! @return FALSE if alias has been already registered
   Standard_EXPORT bool AddFontAlias (const TCollection_AsciiString& theAliasName,
                                      const TCollection_AsciiString& theFontName);
 
   //! Unregister font alias.
-  //! @param theAliasName [in] alias name or name of another font to be used as alias;
+  //! @param[in] theAliasName  alias name or name of another font to be used as alias;
   //!                          all aliases will be removed in case of empty name
-  //! @param theFontName  [in] font to be used as substitution for alias;
+  //! @param[in] theFontName   font to be used as substitution for alias;
   //!                          all fonts will be removed in case of empty name
   //! @return TRUE if alias has been removed
   Standard_EXPORT bool RemoveFontAlias (const TCollection_AsciiString& theAliasName,
@@ -231,7 +231,7 @@ private:
     Font_FontMap() {}
 
     //! Try finding font with specified parameters or the closest one.
-    //! @param theFontName [in] font family to find (or empty string if family name can be ignored)
+    //! @param[in] theFontName  font family to find (or empty string if family name can be ignored)
     //! @return best match font or NULL if not found
     Handle(Font_SystemFont) Find (const TCollection_AsciiString& theFontName) const;
   };

src/GCPnts/GCPnts_QuasiUniformAbscissa.hxx

@@ -69,55 +69,55 @@ public:
   //!     the package Geom2d (in the case of an Adaptor2d_Curve2d curve)
   //!     or a 3D curve from the package Geom (in the case of an Adaptor3d_Curve curve),
   //! -   and those required on the curve by the computation algorithm.
-  //! @param theC [in] input 3D curve
+  //! @param[in] theC  input 3D curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
   Standard_EXPORT GCPnts_QuasiUniformAbscissa (const Adaptor3d_Curve& theC,
                                                const Standard_Integer theNbPoints,
                                                const Standard_Real theU1, const Standard_Real theU2);
 
   //! Initialize the algorithms with 3D curve and target number of points.
-  //! @param theC [in] input 3D curve
+  //! @param[in] theC  input 3D curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
   Standard_EXPORT void Initialize (const Adaptor3d_Curve& theC,
                                    const Standard_Integer theNbPoints);
 
   //! Initialize the algorithms with 3D curve, target number of points and curve parameter range.
-  //! @param theC [in] input 3D curve
+  //! @param[in] theC  input 3D curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
   Standard_EXPORT void Initialize (const Adaptor3d_Curve& theC,
                                    const Standard_Integer theNbPoints,
                                    const Standard_Real theU1, const Standard_Real theU2);
 
   //! Computes a uniform abscissa distribution of points on the 2D curve.
-  //! @param theC [in] input 2D curve
+  //! @param[in] theC  input 2D curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
   Standard_EXPORT GCPnts_QuasiUniformAbscissa (const Adaptor2d_Curve2d& theC,
                                                const Standard_Integer theNbPoints);
 
   //! Computes a Uniform abscissa distribution of points on a part of the 2D curve.
-  //! @param theC [in] input 2D curve
+  //! @param[in] theC  input 2D curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
   Standard_EXPORT GCPnts_QuasiUniformAbscissa (const Adaptor2d_Curve2d& theC,
                                                const Standard_Integer theNbPoints,
                                                const Standard_Real theU1, const Standard_Real theU2);
 
   //! Initialize the algorithms with 2D curve and target number of points.
-  //! @param theC [in] input 2D curve
+  //! @param[in] theC  input 2D curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
   Standard_EXPORT void Initialize (const Adaptor2d_Curve2d& theC,
                                    const Standard_Integer theNbPoints);
   
   //! Initialize the algorithms with 2D curve, target number of points and curve parameter range.
-  //! @param theC [in] input 2D curve
+  //! @param[in] theC  input 2D curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
   Standard_EXPORT void Initialize (const Adaptor2d_Curve2d& theC,
                                    const Standard_Integer theNbPoints,
                                    const Standard_Real theU1, const Standard_Real theU2);

src/GCPnts/GCPnts_TangentialDeflection.hxx

@@ -70,12 +70,12 @@ public:
   Standard_EXPORT GCPnts_TangentialDeflection();
 
   //! Constructor for 3D curve.
-  //! @param theC [in] 3d curve
+  //! @param[in] theC  3d curve
-  //! @param theAngularDeflection   [in] angular deflection in radians
+  //! @param[in] theAngularDeflection    angular deflection in radians
-  //! @param theCurvatureDeflection [in] linear deflection
+  //! @param[in] theCurvatureDeflection  linear deflection
-  //! @param theMinimumOfPoints [in] minimum number of points
+  //! @param[in] theMinimumOfPoints  minimum number of points
-  //! @param theUTol   [in] tolerance in curve parametric scope
+  //! @param[in] theUTol    tolerance in curve parametric scope
-  //! @param theMinLen [in] minimal length
+  //! @param[in] theMinLen  minimal length
   Standard_EXPORT GCPnts_TangentialDeflection (const Adaptor3d_Curve& theC,
                                                const Standard_Real theAngularDeflection, const Standard_Real theCurvatureDeflection,
                                                const Standard_Integer theMinimumOfPoints = 2,
@@ -83,14 +83,14 @@ public:
                                                const Standard_Real theMinLen = 1.0e-7);
 
   //! Constructor for 3D curve with restricted range.
-  //! @param theC [in] 3d curve
+  //! @param[in] theC  3d curve
-  //! @param theFirstParameter [in] first parameter on curve
+  //! @param[in] theFirstParameter  first parameter on curve
-  //! @param theLastParameter  [in] last  parameter on curve
+  //! @param[in] theLastParameter   last  parameter on curve
-  //! @param theAngularDeflection   [in] angular deflection in radians
+  //! @param[in] theAngularDeflection    angular deflection in radians
-  //! @param theCurvatureDeflection [in] linear deflection
+  //! @param[in] theCurvatureDeflection  linear deflection
-  //! @param theMinimumOfPoints [in] minimum number of points
+  //! @param[in] theMinimumOfPoints  minimum number of points
-  //! @param theUTo  l [in] tolerance in curve parametric scope
+  //! @param theUTo  l[in]  tolerance in curve parametric scope
-  //! @param theMinLen [in] minimal length
+  //! @param[in] theMinLen  minimal length
   Standard_EXPORT GCPnts_TangentialDeflection (const Adaptor3d_Curve& theC,
                                                const Standard_Real theFirstParameter, const Standard_Real theLastParameter,
                                                const Standard_Real theAngularDeflection, const Standard_Real theCurvatureDeflection,
@@ -99,12 +99,12 @@ public:
                                                const Standard_Real theMinLen = 1.0e-7);
 
   //! Constructor for 2D curve.
-  //! @param theC [in] 2d curve
+  //! @param[in] theC  2d curve
-  //! @param theAngularDeflection   [in] angular deflection in radians
+  //! @param[in] theAngularDeflection    angular deflection in radians
-  //! @param theCurvatureDeflection [in] linear deflection
+  //! @param[in] theCurvatureDeflection  linear deflection
-  //! @param theMinimumOfPoints [in] minimum number of points
+  //! @param[in] theMinimumOfPoints  minimum number of points
-  //! @param theUTol   [in] tolerance in curve parametric scope
+  //! @param[in] theUTol    tolerance in curve parametric scope
-  //! @param theMinLen [in] minimal length
+  //! @param[in] theMinLen  minimal length
   Standard_EXPORT GCPnts_TangentialDeflection (const Adaptor2d_Curve2d& theC,
                                                const Standard_Real theAngularDeflection, const Standard_Real theCurvatureDeflection,
                                                const Standard_Integer theMinimumOfPoints = 2,
@@ -112,14 +112,14 @@ public:
                                                const Standard_Real theMinLen = 1.0e-7);
 
   //! Constructor for 2D curve with restricted range.
-  //! @param theC [in] 2d curve
+  //! @param[in] theC  2d curve
-  //! @param theFirstParameter [in] first parameter on curve
+  //! @param[in] theFirstParameter  first parameter on curve
-  //! @param theLastParameter  [in] last  parameter on curve
+  //! @param[in] theLastParameter   last  parameter on curve
-  //! @param theAngularDeflection   [in] angular deflection in radians
+  //! @param[in] theAngularDeflection    angular deflection in radians
-  //! @param theCurvatureDeflection [in] linear deflection
+  //! @param[in] theCurvatureDeflection  linear deflection
-  //! @param theMinimumOfPoints [in] minimum number of points
+  //! @param[in] theMinimumOfPoints  minimum number of points
-  //! @param theUTol   [in] tolerance in curve parametric scope
+  //! @param[in] theUTol    tolerance in curve parametric scope
-  //! @param theMinLen [in] minimal length
+  //! @param[in] theMinLen  minimal length
   Standard_EXPORT GCPnts_TangentialDeflection (const Adaptor2d_Curve2d& theC,
                                                const Standard_Real theFirstParameter, const Standard_Real theLastParameter,
                                                const Standard_Real theAngularDeflection, const Standard_Real theCurvatureDeflection,
@@ -128,12 +128,12 @@ public:
                                                const Standard_Real theMinLen = 1.0e-7);
 
   //! Initialize algorithm for 3D curve.
-  //! @param theC [in] 3d curve
+  //! @param[in] theC  3d curve
-  //! @param theAngularDeflection   [in] angular deflection in radians
+  //! @param[in] theAngularDeflection    angular deflection in radians
-  //! @param theCurvatureDeflection [in] linear deflection
+  //! @param[in] theCurvatureDeflection  linear deflection
-  //! @param theMinimumOfPoints [in] minimum number of points
+  //! @param[in] theMinimumOfPoints  minimum number of points
-  //! @param theUTol   [in] tolerance in curve parametric scope
+  //! @param[in] theUTol    tolerance in curve parametric scope
-  //! @param theMinLen [in] minimal length
+  //! @param[in] theMinLen  minimal length
   Standard_EXPORT void Initialize (const Adaptor3d_Curve& theC,
                                    const Standard_Real theAngularDeflection, const Standard_Real theCurvatureDeflection,
                                    const Standard_Integer theMinimumOfPoints = 2,
@@ -141,14 +141,14 @@ public:
                                    const Standard_Real theMinLen = 1.0e-7);
 
   //! Initialize algorithm for 3D curve with restricted range.
-  //! @param theC [in] 3d curve
+  //! @param[in] theC  3d curve
-  //! @param theFirstParameter [in] first parameter on curve
+  //! @param[in] theFirstParameter  first parameter on curve
-  //! @param theLastParameter  [in] last  parameter on curve
+  //! @param[in] theLastParameter   last  parameter on curve
-  //! @param theAngularDeflection   [in] angular deflection in radians
+  //! @param[in] theAngularDeflection    angular deflection in radians
-  //! @param theCurvatureDeflection [in] linear deflection
+  //! @param[in] theCurvatureDeflection  linear deflection
-  //! @param theMinimumOfPoints [in] minimum number of points
+  //! @param[in] theMinimumOfPoints  minimum number of points
-  //! @param theUTol   [in] tolerance in curve parametric scope
+  //! @param[in] theUTol    tolerance in curve parametric scope
-  //! @param theMinLen [in] minimal length
+  //! @param[in] theMinLen  minimal length
   Standard_EXPORT void Initialize (const Adaptor3d_Curve& theC,
                                    const Standard_Real theFirstParameter, const Standard_Real theLastParameter,
                                    const Standard_Real theAngularDeflection, const Standard_Real theCurvatureDeflection,
@@ -157,12 +157,12 @@ public:
                                    const Standard_Real theMinLen = 1.0e-7);
 
   //! Initialize algorithm for 2D curve.
-  //! @param theC [in] 2d curve
+  //! @param[in] theC  2d curve
-  //! @param theAngularDeflection   [in] angular deflection in radians
+  //! @param[in] theAngularDeflection    angular deflection in radians
-  //! @param theCurvatureDeflection [in] linear deflection
+  //! @param[in] theCurvatureDeflection  linear deflection
-  //! @param theMinimumOfPoints [in] minimum number of points
+  //! @param[in] theMinimumOfPoints  minimum number of points
-  //! @param theUTol   [in] tolerance in curve parametric scope
+  //! @param[in] theUTol    tolerance in curve parametric scope
-  //! @param theMinLen [in] minimal length
+  //! @param[in] theMinLen  minimal length
   Standard_EXPORT void Initialize (const Adaptor2d_Curve2d& theC,
                                    const Standard_Real theAngularDeflection, const Standard_Real theCurvatureDeflection,
                                    const Standard_Integer theMinimumOfPoints = 2,
@@ -170,14 +170,14 @@ public:
                                    const Standard_Real theMinLen = 1.0e-7);
 
   //! Initialize algorithm for 2D curve with restricted range.
-  //! @param theC [in] 2d curve
+  //! @param[in] theC  2d curve
-  //! @param theFirstParameter [in] first parameter on curve
+  //! @param[in] theFirstParameter  first parameter on curve
-  //! @param theLastParameter  [in] last  parameter on curve
+  //! @param[in] theLastParameter   last  parameter on curve
-  //! @param theAngularDeflection   [in] angular deflection in radians
+  //! @param[in] theAngularDeflection    angular deflection in radians
-  //! @param theCurvatureDeflection [in] linear deflection
+  //! @param[in] theCurvatureDeflection  linear deflection
-  //! @param theMinimumOfPoints [in] minimum number of points
+  //! @param[in] theMinimumOfPoints  minimum number of points
-  //! @param theUTol   [in] tolerance in curve parametric scope
+  //! @param[in] theUTol    tolerance in curve parametric scope
-  //! @param theMinLen [in] minimal length
+  //! @param[in] theMinLen  minimal length
   Standard_EXPORT void Initialize (const Adaptor2d_Curve2d& theC,
                                    const Standard_Real theFirstParameter, const Standard_Real theLastParameter,
                                    const Standard_Real theAngularDeflection, const Standard_Real theCurvatureDeflection,

src/GCPnts/GCPnts_UniformAbscissa.hxx

@@ -35,20 +35,20 @@ public:
   Standard_EXPORT GCPnts_UniformAbscissa();
 
   //! Computes a uniform abscissa distribution of points on the 3D curve.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theAbscissa [in] abscissa (distance between two consecutive points)
+  //! @param[in] theAbscissa  abscissa (distance between two consecutive points)
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT GCPnts_UniformAbscissa (const Adaptor3d_Curve& theC,
                                           const Standard_Real theAbscissa,
                                           const Standard_Real theToler = -1);
 
   //! Computes a Uniform abscissa distribution of points on a part of the 3D Curve.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theAbscissa [in] abscissa (distance between two consecutive points)
+  //! @param[in] theAbscissa  abscissa (distance between two consecutive points)
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT GCPnts_UniformAbscissa (const Adaptor3d_Curve& theC,
                                           const Standard_Real theAbscissa,
@@ -56,20 +56,20 @@ public:
                                           const Standard_Real theToler = -1);
 
   //! Computes a uniform abscissa distribution of points on the 3D Curve.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT GCPnts_UniformAbscissa (const Adaptor3d_Curve& theC,
                                           const Standard_Integer theNbPoints,
                                           const Standard_Real theToler = -1);
 
   //! Computes a Uniform abscissa distribution of points on a part of the 3D Curve.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT GCPnts_UniformAbscissa (const Adaptor3d_Curve& theC,
                                           const Standard_Integer theNbPoints,
@@ -77,20 +77,20 @@ public:
                                           const Standard_Real theToler = -1);
 
   //! Initialize the algorithms with 3D curve, Abscissa, and Tolerance.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theAbscissa [in] abscissa (distance between two consecutive points)
+  //! @param[in] theAbscissa  abscissa (distance between two consecutive points)
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT void Initialize (const Adaptor3d_Curve& theC,
                                    const Standard_Real theAbscissa,
                                    const Standard_Real theToler = -1);
 
   //! Initialize the algorithms with 3D curve, Abscissa, Tolerance, and parameter range.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theAbscissa [in] abscissa (distance between two consecutive points)
+  //! @param[in] theAbscissa  abscissa (distance between two consecutive points)
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT void Initialize (const Adaptor3d_Curve& theC,
                                    const Standard_Real theAbscissa,
@@ -98,20 +98,20 @@ public:
                                    const Standard_Real theToler = -1);
 
   //! Initialize the algorithms with 3D curve, number of points, and Tolerance.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT void Initialize (const Adaptor3d_Curve& theC,
                                    const Standard_Integer theNbPoints,
                                    const Standard_Real theToler = -1);
 
   //! Initialize the algorithms with 3D curve, number of points, Tolerance, and parameter range.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT void Initialize (const Adaptor3d_Curve& theC,
                                    const Standard_Integer theNbPoints,
@@ -121,20 +121,20 @@ public:
 public:
 
   //! Computes a uniform abscissa distribution of points on the 2D curve.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theAbscissa [in] abscissa (distance between two consecutive points)
+  //! @param[in] theAbscissa  abscissa (distance between two consecutive points)
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT GCPnts_UniformAbscissa (const Adaptor2d_Curve2d& theC,
                                           const Standard_Real theAbscissa,
                                           const Standard_Real theToler = -1);
 
   //! Computes a Uniform abscissa distribution of points on a part of the 2D Curve.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theAbscissa [in] abscissa (distance between two consecutive points)
+  //! @param[in] theAbscissa  abscissa (distance between two consecutive points)
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT GCPnts_UniformAbscissa (const Adaptor2d_Curve2d& theC,
                                           const Standard_Real theAbscissa,
@@ -142,20 +142,20 @@ public:
                                           const Standard_Real theToler = -1);
 
   //! Computes a uniform abscissa distribution of points on the 2D Curve.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT GCPnts_UniformAbscissa (const Adaptor2d_Curve2d& theC,
                                           const Standard_Integer theNbPoints,
                                           const Standard_Real theToler = -1);
 
   //! Computes a Uniform abscissa distribution of points on a part of the 2D Curve.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT GCPnts_UniformAbscissa (const Adaptor2d_Curve2d& theC,
                                           const Standard_Integer theNbPoints,
@@ -163,20 +163,20 @@ public:
                                           const Standard_Real theToler = -1);
 
   //! Initialize the algorithms with 2D curve, Abscissa, and Tolerance.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theAbscissa [in] abscissa (distance between two consecutive points)
+  //! @param[in] theAbscissa  abscissa (distance between two consecutive points)
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT void Initialize (const Adaptor2d_Curve2d& theC,
                                    const Standard_Real theAbscissa,
                                    const Standard_Real theToler = -1);
 
   //! Initialize the algorithms with 2D curve, Abscissa, Tolerance, and parameter range.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theAbscissa [in] abscissa (distance between two consecutive points)
+  //! @param[in] theAbscissa  abscissa (distance between two consecutive points)
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT void Initialize (const Adaptor2d_Curve2d& theC,
                                    const Standard_Real theAbscissa,
@@ -184,20 +184,20 @@ public:
                                    const Standard_Real theToler = -1);
 
   //! Initialize the algorithms with 2D curve, number of points, and Tolerance.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT void Initialize (const Adaptor2d_Curve2d& theC,
                                    const Standard_Integer theNbPoints,
                                    const Standard_Real theToler = -1);
 
   //! Initialize the algorithms with 2D curve, number of points, Tolerance, and parameter range.
-  //! @param theC [in] input curve
+  //! @param[in] theC  input curve
-  //! @param theNbPoints [in] defines the number of desired points
+  //! @param[in] theNbPoints  defines the number of desired points
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
-  //! @param theToler [in] used for more precise calculation of curve length
+  //! @param[in] theToler  used for more precise calculation of curve length
   //!                      (Precision::Confusion() by default)
   Standard_EXPORT void Initialize (const Adaptor2d_Curve2d& theC,
                                    const Standard_Integer theNbPoints,

src/GCPnts/GCPnts_UniformDeflection.hxx

@@ -44,38 +44,38 @@ public:
   Standard_EXPORT GCPnts_UniformDeflection();
 
   //! Computes a uniform Deflection distribution of points on the curve.
-  //! @param theC [in] input 3D curve
+  //! @param[in] theC  input 3D curve
-  //! @param theDeflection [in] target deflection
+  //! @param[in] theDeflection  target deflection
-  //! @param theWithControl [in] when TRUE, the algorithm controls the estimate deflection
+  //! @param[in] theWithControl  when TRUE, the algorithm controls the estimate deflection
   Standard_EXPORT GCPnts_UniformDeflection (const Adaptor3d_Curve& theC,
                                             const Standard_Real theDeflection,
                                             const Standard_Boolean theWithControl = Standard_True);
 
   //! Computes a uniform Deflection distribution of points on the curve.
-  //! @param theC [in] input 2D curve
+  //! @param[in] theC  input 2D curve
-  //! @param theDeflection [in] target deflection
+  //! @param[in] theDeflection  target deflection
-  //! @param theWithControl [in] when TRUE, the algorithm controls the estimate deflection
+  //! @param[in] theWithControl  when TRUE, the algorithm controls the estimate deflection
   Standard_EXPORT GCPnts_UniformDeflection (const Adaptor2d_Curve2d& theC,
                                             const Standard_Real theDeflection,
                                             const Standard_Boolean theWithControl = Standard_True);
 
   //! Computes a Uniform Deflection distribution of points on a part of the curve.
-  //! @param theC [in] input 3D curve
+  //! @param[in] theC  input 3D curve
-  //! @param theDeflection [in] target deflection
+  //! @param[in] theDeflection  target deflection
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
-  //! @param theWithControl [in] when TRUE, the algorithm controls the estimate deflection
+  //! @param[in] theWithControl  when TRUE, the algorithm controls the estimate deflection
   Standard_EXPORT GCPnts_UniformDeflection (const Adaptor3d_Curve& theC,
                                             const Standard_Real theDeflection,
                                             const Standard_Real theU1, const Standard_Real theU2,
                                             const Standard_Boolean theWithControl = Standard_True);
   
   //! Computes a Uniform Deflection distribution of points on a part of the curve.
-  //! @param theC [in] input 2D curve
+  //! @param[in] theC  input 2D curve
-  //! @param theDeflection [in] target deflection
+  //! @param[in] theDeflection  target deflection
-  //! @param theU1 [in] first parameter on curve
+  //! @param[in] theU1  first parameter on curve
-  //! @param theU2 [in] last  parameter on curve
+  //! @param[in] theU2  last  parameter on curve
-  //! @param theWithControl [in] when TRUE, the algorithm controls the estimate deflection
+  //! @param[in] theWithControl  when TRUE, the algorithm controls the estimate deflection
   Standard_EXPORT GCPnts_UniformDeflection (const Adaptor2d_Curve2d& theC,
                                             const Standard_Real theDeflection,
                                             const Standard_Real theU1, const Standard_Real theU2,

src/GeomLib/GeomLib.hxx

@@ -155,13 +155,13 @@ public:
   Standard_EXPORT static void DensifyArray1OfReal (const Standard_Integer MinNumPoints, const TColStd_Array1OfReal& InParameters, Handle(TColStd_HArray1OfReal)& OutParameters);
   
   //! This method fuse intervals Interval1 and Interval2 with specified Confusion
-  //! @param Interval1 [in] first interval to fuse 
+  //! @param[in] Interval1  first interval to fuse 
-  //! @param Interval2 [in] second interval to fuse
+  //! @param[in] Interval2  second interval to fuse
-  //! @param Confision [in] tolerance to compare intervals
+  //! @param[in] Confision  tolerance to compare intervals
-  //! @param IsAdjustToFirstInterval [in] flag to set method of fusion, if intervals are close
+  //! @param[in] IsAdjustToFirstInterval  flag to set method of fusion, if intervals are close
   //!                               if false, intervals are fusing by half-division methdod
   //!                               if true, intervals are fusing by selecting value from Interval1
-  //! @param Fusion [out] output interval 
+  //! @param[out] Fusion  output interval 
   Standard_EXPORT static void FuseIntervals (const TColStd_Array1OfReal& Interval1, 
                                              const TColStd_Array1OfReal& Interval2, 
                                              TColStd_SequenceOfReal& Fusion,

src/Graphic3d/Graphic3d_ArrayOfPrimitives.hxx

@@ -690,17 +690,17 @@ public: //! @name optional array of Indices/Edges for using shared Vertex data
   //! Add triangle strip into indexed triangulation array.
   //! N-2 triangles are added from N input nodes.
   //! Raises exception if array is not of type Graphic3d_TOPA_TRIANGLES.
-  //! @param theVertexLower [in] index of first node defining triangle strip
+  //! @param[in] theVertexLower  index of first node defining triangle strip
-  //! @param theVertexUpper [in] index of last  node defining triangle strip
+  //! @param[in] theVertexUpper  index of last  node defining triangle strip
   Standard_EXPORT void AddTriangleStripEdges (Standard_Integer theVertexLower,
                                               Standard_Integer theVertexUpper);
 
   //! Add triangle fan into indexed triangulation array.
   //! N-2 triangles are added from N input nodes (or N-1 with closed flag).
   //! Raises exception if array is not of type Graphic3d_TOPA_TRIANGLES.
-  //! @param theVertexLower [in] index of first node defining triangle fun (center)
+  //! @param[in] theVertexLower  index of first node defining triangle fun (center)
-  //! @param theVertexUpper [in] index of last  node defining triangle fun
+  //! @param[in] theVertexUpper  index of last  node defining triangle fun
-  //! @param theToClose [in] close triangle fan (connect first and last points)
+  //! @param[in] theToClose  close triangle fan (connect first and last points)
   Standard_EXPORT void AddTriangleFanEdges (Standard_Integer theVertexLower,
                                             Standard_Integer theVertexUpper,
                                             Standard_Boolean theToClose);
@@ -708,9 +708,9 @@ public: //! @name optional array of Indices/Edges for using shared Vertex data
   //! Add line strip (polyline) into indexed segments array.
   //! N-1 segments are added from N input nodes (or N with closed flag).
   //! Raises exception if array is not of type Graphic3d_TOPA_SEGMENTS.
-  //! @param theVertexLower [in] index of first node defining line strip fun (center)
+  //! @param[in] theVertexLower  index of first node defining line strip fun (center)
-  //! @param theVertexUpper [in] index of last  node defining triangle fun
+  //! @param[in] theVertexUpper  index of last  node defining triangle fun
-  //! @param theToClose [in] close triangle fan (connect first and last points)
+  //! @param[in] theToClose  close triangle fan (connect first and last points)
   Standard_EXPORT void AddPolylineEdges (Standard_Integer theVertexLower,
                                          Standard_Integer theVertexUpper,
                                          Standard_Boolean theToClose);

src/Graphic3d/Graphic3d_AspectText3d.hxx

@@ -32,12 +32,12 @@ public:
   Standard_EXPORT Graphic3d_AspectText3d();
 
   //! Creates a context table for text primitives defined with the specified values.
-  //! @param theColor [in] text color
+  //! @param[in] theColor  text color
-  //! @param theFont  [in] font family name or alias like Font_NOF_ASCII_MONO
+  //! @param[in] theFont   font family name or alias like Font_NOF_ASCII_MONO
-  //! @param theExpansionFactor [in] deprecated parameter, has no effect
+  //! @param[in] theExpansionFactor  deprecated parameter, has no effect
-  //! @param theSpace [in] deprecated parameter, has no effect
+  //! @param[in] theSpace  deprecated parameter, has no effect
-  //! @param theStyle [in] font style
+  //! @param[in] theStyle  font style
-  //! @param theDisplayType [in] display mode
+  //! @param[in] theDisplayType  display mode
   Standard_EXPORT Graphic3d_AspectText3d (const Quantity_Color& theColor,
                                           Standard_CString theFont,
                                           Standard_Real theExpansionFactor,

src/Graphic3d/Graphic3d_CView.hxx

@@ -272,24 +272,24 @@ public:
 
   //! Dumps the graphical contents of a shadowmap framebuffer into an image.
   //! @param theImage the image to store the shadow map.
-  //! @param theLightName [in] name of the light used to generate the shadow map.
+  //! @param[in] theLightName  name of the light used to generate the shadow map.
   virtual Standard_Boolean ShadowMapDump (Image_PixMap& theImage, const TCollection_AsciiString& theLightName) = 0;
 
   //! Marks BVH tree and the set of BVH primitives of correspondent priority list with id theLayerId as outdated.
   virtual void InvalidateBVHData (const Graphic3d_ZLayerId theLayerId) = 0;
 
   //! Add a layer to the view.
-  //! @param theNewLayerId [in] id of new layer, should be > 0 (negative values are reserved for default layers).
+  //! @param[in] theNewLayerId  id of new layer, should be > 0 (negative values are reserved for default layers).
-  //! @param theSettings   [in] new layer settings
+  //! @param[in] theSettings    new layer settings
-  //! @param theLayerAfter [in] id of layer to append new layer before
+  //! @param[in] theLayerAfter  id of layer to append new layer before
   virtual void InsertLayerBefore (const Graphic3d_ZLayerId theNewLayerId,
                                   const Graphic3d_ZLayerSettings& theSettings,
                                   const Graphic3d_ZLayerId theLayerAfter) = 0;
 
   //! Add a layer to the view.
-  //! @param theNewLayerId  [in] id of new layer, should be > 0 (negative values are reserved for default layers).
+  //! @param[in] theNewLayerId   id of new layer, should be > 0 (negative values are reserved for default layers).
-  //! @param theSettings    [in] new layer settings
+  //! @param[in] theSettings     new layer settings
-  //! @param theLayerBefore [in] id of layer to append new layer after
+  //! @param[in] theLayerBefore  id of layer to append new layer after
   virtual void InsertLayerAfter (const Graphic3d_ZLayerId theNewLayerId,
                                  const Graphic3d_ZLayerSettings& theSettings,
                                  const Graphic3d_ZLayerId theLayerBefore) = 0;
@@ -383,9 +383,9 @@ public:
   const Handle(Graphic3d_CubeMap)& IBLCubeMap() const { return myCubeMapIBL; }
 
   //! Sets image texture or environment cubemap as background.
-  //! @param theTextureMap [in] source to set a background;
+  //! @param[in] theTextureMap  source to set a background;
   //!                           should be either Graphic3d_Texture2D or Graphic3d_CubeMap
-  //! @param theToUpdatePBREnv [in] defines whether IBL maps will be generated or not
+  //! @param[in] theToUpdatePBREnv  defines whether IBL maps will be generated or not
   //!                               (see GeneratePBREnvironment())
   virtual void SetBackgroundImage (const Handle(Graphic3d_TextureMap)& theTextureMap,
                                    Standard_Boolean theToUpdatePBREnv = Standard_True) = 0;
@@ -497,7 +497,7 @@ public:
   void SetBaseXRCamera (const Handle(Graphic3d_Camera)& theCamera) { myBaseXRCamera = theCamera; }
 
   //! Convert XR pose to world space.
-  //! @param thePoseXR [in] transformation defined in VR local coordinate system,
+  //! @param[in] thePoseXR  transformation defined in VR local coordinate system,
   //!                       oriented as Y-up, X-right and -Z-forward
   //! @return transformation defining orientation of XR pose in world space
   gp_Trsf PoseXRToWorld (const gp_Trsf& thePoseXR) const
@@ -511,7 +511,7 @@ public:
   }
 
   //! Returns view direction in the world space based on XR pose.
-  //! @param thePoseXR [in] transformation defined in VR local coordinate system,
+  //! @param[in] thePoseXR  transformation defined in VR local coordinate system,
   //!                       oriented as Y-up, X-right and -Z-forward
   gp_Ax1 ViewAxisInWorld (const gp_Trsf& thePoseXR) const
   {
@@ -548,8 +548,8 @@ public: //! @name obsolete Graduated Trihedron functionality
   virtual void GraduatedTrihedronErase() {}
 
   //! Sets minimum and maximum points of scene bounding box for Graduated Trihedron stored in graphic view object.
-  //! @param theMin [in] the minimum point of scene.
+  //! @param[in] theMin  the minimum point of scene.
-  //! @param theMax [in] the maximum point of scene.
+  //! @param[in] theMax  the maximum point of scene.
   virtual void GraduatedTrihedronMinMaxValues (const Graphic3d_Vec3 theMin, const Graphic3d_Vec3 theMax)
   {
     (void )theMin;

src/Graphic3d/Graphic3d_Camera.hxx

@@ -166,10 +166,10 @@ public:
   //! This transformation might be not in line with user expectations.
   //! In this case, application might define intermediate camera positions for interpolation or implement own interpolation logic.
   //!
-  //! @param theStart  [in] initial camera position
+  //! @param[in] theStart   initial camera position
-  //! @param theEnd    [in] final   camera position
+  //! @param[in] theEnd     final   camera position
-  //! @param theT      [in] step between initial and final positions within [0,1] range
+  //! @param[in] theT       step between initial and final positions within [0,1] range
-  //! @param theCamera [out] interpolation result
+  //! @param[out] theCamera  interpolation result
   Standard_EXPORT static void Interpolate (const Handle(Graphic3d_Camera)& theStart,
                                            const Handle(Graphic3d_Camera)& theEnd,
                                            const double theT,
@@ -186,7 +186,7 @@ public:
   Standard_EXPORT Graphic3d_Camera();
 
   //! Copy constructor.
-  //! @param theOther [in] the camera to copy from.
+  //! @param[in] theOther  the camera to copy from.
   Standard_EXPORT Graphic3d_Camera (const Handle(Graphic3d_Camera)& theOther);
 
   //! Initialize mapping related parameters from other camera handle.
@@ -196,7 +196,7 @@ public:
   Standard_EXPORT void CopyOrientationData (const Handle(Graphic3d_Camera)& theOtherCamera);
 
   //! Copy properties of another camera.
-  //! @param theOther [in] the camera to copy from.
+  //! @param[in] theOther  the camera to copy from.
   Standard_EXPORT void Copy (const Handle(Graphic3d_Camera)& theOther);
 
 //! @name Public camera properties
@@ -208,12 +208,12 @@ public:
 
   //! Sets camera look direction preserving the current Eye() position.
   //! WARNING! This method does NOT verify that the current Up() vector is orthogonal to the new Direction.
-  //! @param theDir [in] the direction.
+  //! @param[in] theDir  the direction.
   Standard_EXPORT void SetDirectionFromEye (const gp_Dir& theDir);
 
   //! Sets camera look direction and computes the new Eye position relative to current Center.
   //! WARNING! This method does NOT verify that the current Up() vector is orthogonal to the new Direction.
-  //! @param theDir [in] the direction.
+  //! @param[in] theDir  the direction.
   Standard_EXPORT void SetDirection (const gp_Dir& theDir);
 
   //! Get camera Up direction vector.
@@ -222,7 +222,7 @@ public:
 
   //! Sets camera Up direction vector, orthogonal to camera direction.
   //! WARNING! This method does NOT verify that the new Up vector is orthogonal to the current Direction().
-  //! @param theUp [in] the Up direction vector.
+  //! @param[in] theUp  the Up direction vector.
   //! @sa OrthogonalizeUp().
   Standard_EXPORT void SetUp (const gp_Dir& theUp);
 
@@ -244,20 +244,20 @@ public:
 
   //! Sets camera Eye position.
   //! Unlike SetEye(), this method only changes Eye point and preserves camera direction.
-  //! @param theEye [in] the location of camera's Eye.
+  //! @param[in] theEye  the location of camera's Eye.
   //! @sa SetEye()
   Standard_EXPORT void MoveEyeTo (const gp_Pnt& theEye);
 
   //! Sets camera Eye and Center positions.
-  //! @param theEye    [in] the location of camera's Eye
+  //! @param[in] theEye     the location of camera's Eye
-  //! @param theCenter [in] the location of camera's Center
+  //! @param[in] theCenter  the location of camera's Center
   Standard_EXPORT void SetEyeAndCenter (const gp_Pnt& theEye,
                                         const gp_Pnt& theCenter);
 
   //! Sets camera Eye position.
   //! WARNING! For backward compatibility reasons, this method also changes view direction,
   //! so that the new direction is computed from new Eye position to old Center position.
-  //! @param theEye [in] the location of camera's Eye.
+  //! @param[in] theEye  the location of camera's Eye.
   //! @sa MoveEyeTo(), SetEyeAndCenter()
   Standard_EXPORT void SetEye (const gp_Pnt& theEye);
 
@@ -272,7 +272,7 @@ public:
   //! Sets Center of the camera, e.g. the point where camera looks at.
   //! This methods changes camera direction, so that the new direction is computed
   //! from current Eye position to specified Center position.
-  //! @param theCenter [in] the point where the camera looks at.
+  //! @param[in] theCenter  the point where the camera looks at.
   Standard_EXPORT void SetCenter (const gp_Pnt& theCenter);
 
   //! Get distance of Eye from camera Center.
@@ -280,7 +280,7 @@ public:
   Standard_Real Distance() const { return myDistance; }
 
   //! Set distance of Eye from camera Center.
-  //! @param theDistance [in] the distance.
+  //! @param[in] theDistance  the distance.
   Standard_EXPORT void SetDistance (const Standard_Real theDistance);
 
   //! Get camera scale.
@@ -294,7 +294,7 @@ public:
   //! both dimensions assuming that the aspect is 1.0. The projection height
   //! and width are specified with the scale and correspondingly multiplied
   //! by the aspect.
-  //! @param theScale [in] the scale factor.
+  //! @param[in] theScale  the scale factor.
   Standard_EXPORT void SetScale (const Standard_Real theScale);
 
   //! Get camera axial scale.
@@ -302,7 +302,7 @@ public:
   const gp_XYZ& AxialScale() const { return myAxialScale; }
 
   //! Set camera axial scale.
-  //! @param theAxialScale [in] the axial scale vector.
+  //! @param[in] theAxialScale  the axial scale vector.
   Standard_EXPORT void SetAxialScale (const gp_XYZ& theAxialScale);
 
   //! Change camera projection type.
@@ -338,7 +338,7 @@ public:
 
   //! Set Field Of View (FOV) in y axis for perspective projection.
   //! Field of View in x axis is automatically scaled from view aspect ratio.
-  //! @param theFOVy [in] the FOV in degrees.
+  //! @param[in] theFOVy  the FOV in degrees.
   Standard_EXPORT void SetFOVy (const Standard_Real theFOVy);
 
   //! Get Field Of View (FOV) in y axis.
@@ -394,8 +394,8 @@ public:
   //! For perspective projection, only positive values are allowed.
   //! Program error exception is raised if non-positive values are
   //! specified for perspective projection or theZNear >= theZFar.
-  //! @param theZNear [in] the distance of the plane from the Eye.
+  //! @param[in] theZNear  the distance of the plane from the Eye.
-  //! @param theZFar [in] the distance of the plane from the Eye.
+  //! @param[in] theZFar  the distance of the plane from the Eye.
   Standard_EXPORT void SetZRange (const Standard_Real theZNear, const Standard_Real theZFar);
 
   //! Get the Near Z-clipping plane position.
@@ -427,7 +427,7 @@ public:
   }
 
   //! Changes width / height display ratio.
-  //! @param theAspect [in] the display ratio.
+  //! @param[in] theAspect  the display ratio.
   Standard_EXPORT void SetAspect (const Standard_Real theAspect);
 
   //! Get camera display ratio.
@@ -438,10 +438,10 @@ public:
   }
 
   //! Sets stereographic focus distance.
-  //! @param theType [in] the focus definition type. Focus can be defined
+  //! @param[in] theType  the focus definition type. Focus can be defined
   //! as absolute value or relatively to (as coefficient of) coefficient of
   //! camera focal length.
-  //! @param theZFocus [in] the focus absolute value or coefficient depending
+  //! @param[in] theZFocus  the focus absolute value or coefficient depending
   //! on the passed definition type.
   Standard_EXPORT void SetZFocus (const FocusType theType, const Standard_Real theZFocus);
 
@@ -461,9 +461,9 @@ public:
   }
 
   //! Sets Intraocular distance.
-  //! @param theType [in] the IOD definition type. IOD can be defined as
+  //! @param[in] theType  the IOD definition type. IOD can be defined as
   //! absolute value or relatively to (as coefficient of) camera focal length.
-  //! @param theIOD [in] the Intraocular distance.
+  //! @param[in] theIOD  the Intraocular distance.
   Standard_EXPORT void SetIOD (const IODType theType, const Standard_Real theIOD);
 
   //! Get Intraocular distance value.
@@ -496,7 +496,7 @@ public:
 
   //! Transform orientation components of the camera:
   //! Eye, Up and Center points.
-  //! @param theTrsf [in] the transformation to apply.
+  //! @param[in] theTrsf  the transformation to apply.
   Standard_EXPORT void Transform (const gp_Trsf& theTrsf);
 
   //! Calculate view plane size at center (target) point
@@ -509,7 +509,7 @@ public:
 
   //! Calculate view plane size at center point with specified Z offset
   //! and distance between ZFar and ZNear planes.
-  //! @param theZValue [in] the distance from the eye in eye-to-center direction
+  //! @param[in] theZValue  the distance from the eye in eye-to-center direction
   //! @return values in form of gp_Pnt (Width, Height, Depth).
   Standard_EXPORT gp_XYZ ViewDimensions (const Standard_Real theZValue) const;
 
@@ -537,12 +537,12 @@ public:
   //! The frustum planes are usually used as inputs for camera algorithms.
   //! Thus, if any changes to projection matrix calculation are necessary,
   //! the frustum planes calculation should be also touched.
-  //! @param theLeft [out] the frustum plane for left side of view.
+  //! @param[out] theLeft  the frustum plane for left side of view.
-  //! @param theRight [out] the frustum plane for right side of view.
+  //! @param[out] theRight  the frustum plane for right side of view.
-  //! @param theBottom [out] the frustum plane for bottom side of view.
+  //! @param[out] theBottom  the frustum plane for bottom side of view.
-  //! @param theTop [out] the frustum plane for top side of view.
+  //! @param[out] theTop  the frustum plane for top side of view.
-  //! @param theNear [out] the frustum plane for near side of view.
+  //! @param[out] theNear  the frustum plane for near side of view.
-  //! @param theFar [out] the frustum plane for far side of view.
+  //! @param[out] theFar  the frustum plane for far side of view.
   Standard_EXPORT void Frustum (gp_Pln& theLeft,
                                 gp_Pln& theRight,
                                 gp_Pln& theBottom,
@@ -555,37 +555,37 @@ public:
 
   //! Project point from world coordinate space to
   //! normalized device coordinates (mapping).
-  //! @param thePnt [in] the 3D point in WCS.
+  //! @param[in] thePnt  the 3D point in WCS.
   //! @return mapped point in NDC.
   Standard_EXPORT gp_Pnt Project (const gp_Pnt& thePnt) const;
 
   //! Unproject point from normalized device coordinates
   //! to world coordinate space.
-  //! @param thePnt [in] the NDC point.
+  //! @param[in] thePnt  the NDC point.
   //! @return 3D point in WCS.
   Standard_EXPORT gp_Pnt UnProject (const gp_Pnt& thePnt) const;
 
   //! Convert point from view coordinate space to
   //! projection coordinate space.
-  //! @param thePnt [in] the point in VCS.
+  //! @param[in] thePnt  the point in VCS.
   //! @return point in NDC.
   Standard_EXPORT gp_Pnt ConvertView2Proj (const gp_Pnt& thePnt) const;
 
   //! Convert point from projection coordinate space
   //! to view coordinate space.
-  //! @param thePnt [in] the point in NDC.
+  //! @param[in] thePnt  the point in NDC.
   //! @return point in VCS.
   Standard_EXPORT gp_Pnt ConvertProj2View (const gp_Pnt& thePnt) const;
 
   //! Convert point from world coordinate space to
   //! view coordinate space.
-  //! @param thePnt [in] the 3D point in WCS.
+  //! @param[in] thePnt  the 3D point in WCS.
   //! @return point in VCS.
   Standard_EXPORT gp_Pnt ConvertWorld2View (const gp_Pnt& thePnt) const;
 
   //! Convert point from view coordinate space to
   //! world coordinates.
-  //! @param thePnt [in] the 3D point in VCS.
+  //! @param[in] thePnt  the 3D point in VCS.
   //! @return point in WCS.
   Standard_EXPORT gp_Pnt ConvertView2World (const gp_Pnt& thePnt) const;
 
@@ -659,20 +659,20 @@ public:
 public:
 
   //! Get stereo projection matrices.
-  //! @param theProjL      [out] left  eye projection matrix
+  //! @param[out] theProjL       left  eye projection matrix
-  //! @param theHeadToEyeL [out] left  head to eye translation matrix
+  //! @param[out] theHeadToEyeL  left  head to eye translation matrix
-  //! @param theProjR      [out] right eye projection matrix
+  //! @param[out] theProjR       right eye projection matrix
-  //! @param theHeadToEyeR [out] right head to eye translation matrix
+  //! @param[out] theHeadToEyeR  right head to eye translation matrix
   Standard_EXPORT void StereoProjection (Graphic3d_Mat4d& theProjL,
                                          Graphic3d_Mat4d& theHeadToEyeL,
                                          Graphic3d_Mat4d& theProjR,
                                          Graphic3d_Mat4d& theHeadToEyeR) const;
 
   //! Get stereo projection matrices.
-  //! @param theProjL      [out] left  eye projection matrix
+  //! @param[out] theProjL       left  eye projection matrix
-  //! @param theHeadToEyeL [out] left  head to eye translation matrix
+  //! @param[out] theHeadToEyeL  left  head to eye translation matrix
-  //! @param theProjR      [out] right eye projection matrix
+  //! @param[out] theProjR       right eye projection matrix
-  //! @param theHeadToEyeR [out] right head to eye translation matrix
+  //! @param[out] theHeadToEyeR  right head to eye translation matrix
   Standard_EXPORT void StereoProjectionF (Graphic3d_Mat4& theProjL,
                                           Graphic3d_Mat4& theHeadToEyeL,
                                           Graphic3d_Mat4& theProjR,
@@ -693,10 +693,10 @@ public:
   bool IsCustomStereoProjection() const { return myIsCustomProjMatLR; }
 
   //! Set custom stereo projection matrices.
-  //! @param theProjL      [in] left  eye projection matrix
+  //! @param[in] theProjL       left  eye projection matrix
-  //! @param theHeadToEyeL [in] left  head to eye translation matrix
+  //! @param[in] theHeadToEyeL  left  head to eye translation matrix
-  //! @param theProjR      [in] right eye projection matrix
+  //! @param[in] theProjR       right eye projection matrix
-  //! @param theHeadToEyeR [in] right head to eye translation matrix
+  //! @param[in] theHeadToEyeR  right head to eye translation matrix
   Standard_EXPORT void SetCustomStereoProjection (const Graphic3d_Mat4d& theProjL,
                                                   const Graphic3d_Mat4d& theHeadToEyeL,
                                                   const Graphic3d_Mat4d& theProjR,
@@ -715,10 +715,10 @@ public:
 private:
 
   //! Get stereo projection matrices.
-  //! @param theProjL      [out] left  eye projection matrix
+  //! @param[out] theProjL       left  eye projection matrix
-  //! @param theHeadToEyeL [out] left  head to eye translation matrix
+  //! @param[out] theHeadToEyeL  left  head to eye translation matrix
-  //! @param theProjR      [out] right eye projection matrix
+  //! @param[out] theProjR       right eye projection matrix
-  //! @param theHeadToEyeR [out] right head to eye translation matrix
+  //! @param[out] theHeadToEyeR  right head to eye translation matrix
   template <typename Elem_t>
   Standard_EXPORT void stereoProjection (NCollection_Mat4<Elem_t>& theProjL,
                                          NCollection_Mat4<Elem_t>& theHeadToEyeL,
@@ -726,10 +726,10 @@ private:
                                          NCollection_Mat4<Elem_t>& theHeadToEyeR) const;
 
   //! Compute projection matrices.
-  //! @param theProjM [out] mono projection matrix
+  //! @param[out] theProjM  mono projection matrix
-  //! @param theProjL [out] left  eye projection matrix
+  //! @param[out] theProjL  left  eye projection matrix
-  //! @param theProjR [out] right eye projection matrix
+  //! @param[out] theProjR  right eye projection matrix
-  //! @param theToAddHeadToEye [in] flag to pre-multiply head-to-eye translation
+  //! @param[in] theToAddHeadToEye  flag to pre-multiply head-to-eye translation
   template <typename Elem_t>
   Standard_EXPORT void computeProjection (NCollection_Mat4<Elem_t>& theProjM,
                                           NCollection_Mat4<Elem_t>& theProjL,
@@ -737,7 +737,7 @@ private:
                                           bool theToAddHeadToEye) const;
 
   //! Compute projection matrices.
-  //! @param theMatrices [in] the matrices data container.
+  //! @param[in] theMatrices  the matrices data container.
   template <typename Elem_t>
   TransformMatrices<Elem_t>& UpdateProjection (TransformMatrices<Elem_t>& theMatrices) const
   {
@@ -750,7 +750,7 @@ private:
   }
 
   //! Compute orientation matrix.
-  //! @param theMatrices [in] the matrices data container.
+  //! @param[in] theMatrices  the matrices data container.
   template <typename Elem_t>
   Standard_EXPORT
     TransformMatrices<Elem_t>& UpdateOrientation (TransformMatrices<Elem_t>& theMatrices) const;
@@ -758,10 +758,10 @@ private:
 private:
 
   //! Compose orthographic projection matrix for the passed camera volume mapping.
-  //! @param theOutMx [out] the projection matrix
+  //! @param[out] theOutMx  the projection matrix
-  //! @param theLRBT [in] the left/right/bottom/top mapping (clipping) coordinates
+  //! @param[in] theLRBT  the left/right/bottom/top mapping (clipping) coordinates
-  //! @param theNear [in] the near mapping (clipping) coordinate
+  //! @param[in] theNear  the near mapping (clipping) coordinate
-  //! @param theFar [in] the far mapping (clipping) coordinate
+  //! @param[in] theFar  the far mapping (clipping) coordinate
   template <typename Elem_t>
   void orthoProj (NCollection_Mat4<Elem_t>& theOutMx,
                   const Aspect_FrustumLRBT<Elem_t>& theLRBT,
@@ -769,10 +769,10 @@ private:
                   const Elem_t theFar) const;
 
   //! Compose perspective projection matrix for the passed camera volume mapping.
-  //! @param theOutMx [out] the projection matrix
+  //! @param[out] theOutMx  the projection matrix
-  //! @param theLRBT [in] the left/right/bottom/top mapping (clipping) coordinates
+  //! @param[in] theLRBT  the left/right/bottom/top mapping (clipping) coordinates
-  //! @param theNear [in] the near mapping (clipping) coordinate
+  //! @param[in] theNear  the near mapping (clipping) coordinate
-  //! @param theFar [in] the far mapping (clipping) coordinate
+  //! @param[in] theFar  the far mapping (clipping) coordinate
   template <typename Elem_t>
   void perspectiveProj (NCollection_Mat4<Elem_t>& theOutMx,
                         const Aspect_FrustumLRBT<Elem_t>& theLRBT,
@@ -780,13 +780,13 @@ private:
                         const Elem_t theFar) const;
 
   //! Compose projection matrix for L/R stereo eyes.
-  //! @param theOutMx [out] the projection matrix
+  //! @param[out] theOutMx  the projection matrix
-  //! @param theLRBT [in] the left/right/bottom/top mapping (clipping) coordinates
+  //! @param[in] theLRBT  the left/right/bottom/top mapping (clipping) coordinates
-  //! @param theNear [in] the near mapping (clipping) coordinate
+  //! @param[in] theNear  the near mapping (clipping) coordinate
-  //! @param theFar [in] the far mapping (clipping) coordinate
+  //! @param[in] theFar  the far mapping (clipping) coordinate
-  //! @param theIOD [in] the Intraocular distance
+  //! @param[in] theIOD  the Intraocular distance
-  //! @param theZFocus [in] the z coordinate of off-axis projection plane with zero parallax
+  //! @param[in] theZFocus  the z coordinate of off-axis projection plane with zero parallax
-  //! @param theEyeIndex [in] choose between L/R eyes
+  //! @param[in] theEyeIndex  choose between L/R eyes
   template <typename Elem_t>
   void stereoEyeProj (NCollection_Mat4<Elem_t>& theOutMx,
                       const Aspect_FrustumLRBT<Elem_t>& theLRBT,
@@ -799,10 +799,10 @@ private:
   //! Construct "look at" orientation transformation.
   //! Reference point differs for perspective and ortho modes 
   //! (made for compatibility, to be improved..).
-  //! @param theEye [in] the eye coordinates in 3D space.
+  //! @param[in] theEye  the eye coordinates in 3D space.
-  //! @param theFwdDir [in] view direction
+  //! @param[in] theFwdDir  view direction
-  //! @param theUpDir [in] the up direction vector.
+  //! @param[in] theUpDir  the up direction vector.
-  //! @param theAxialScale [in] the axial scale vector.
+  //! @param[in] theAxialScale  the axial scale vector.
   //! @param theOutMx [in/out] the orientation matrix.
   template <typename Elem_t>
   static void

src/Graphic3d/Graphic3d_ClipPlane.hxx

@@ -59,27 +59,27 @@ public:
   Standard_EXPORT Graphic3d_ClipPlane();
 
   //! Copy constructor.
-  //! @param theOther [in] the copied plane.
+  //! @param[in] theOther  the copied plane.
   Standard_EXPORT Graphic3d_ClipPlane(const Graphic3d_ClipPlane& theOther);
 
   //! Construct clip plane for the passed equation.
   //! By default the plane is on, capping is turned off.
-  //! @param theEquation [in] the plane equation.
+  //! @param[in] theEquation  the plane equation.
   Standard_EXPORT Graphic3d_ClipPlane (const Graphic3d_Vec4d& theEquation);
 
   //! Construct clip plane from the passed geometrical definition.
   //! By default the plane is on, capping is turned off.
-  //! @param thePlane [in] the plane.
+  //! @param[in] thePlane  the plane.
   Standard_EXPORT Graphic3d_ClipPlane (const gp_Pln& thePlane);
 
   //! Set plane equation by its geometrical definition.
   //! The equation is specified in "world" coordinate system.
-  //! @param thePlane [in] the plane.
+  //! @param[in] thePlane  the plane.
   Standard_EXPORT void SetEquation (const gp_Pln& thePlane);
 
   //! Set 4-component equation vector for clipping plane.
   //! The equation is specified in "world" coordinate system.
-  //! @param theEquation [in] the XYZW (or "ABCD") equation vector.
+  //! @param[in] theEquation  the XYZW (or "ABCD") equation vector.
   Standard_EXPORT void SetEquation (const Graphic3d_Vec4d& theEquation);
 
   //! Get 4-component equation vector for clipping plane.
@@ -98,12 +98,12 @@ public:
   }
 
   //! Change state of the clipping plane.
-  //! @param theIsOn [in] the flag specifying whether the graphic driver
+  //! @param[in] theIsOn  the flag specifying whether the graphic driver
   //! clipping by this plane should be turned on or off.
   Standard_EXPORT void SetOn(const Standard_Boolean theIsOn);
 
   //! Change state of capping surface rendering.
-  //! @param theIsOn [in] the flag specifying whether the graphic driver should
+  //! @param[in] theIsOn  the flag specifying whether the graphic driver should
   //! perform rendering of capping surface produced by this plane. The graphic
   //! driver produces this surface for convex graphics by means of stencil-test
   //! and multi-pass rendering.
@@ -172,14 +172,14 @@ public: // @name user-defined graphical attributes
   Standard_EXPORT void SetCappingColor (const Quantity_Color& theColor);
 
   //! Set material for rendering capping surface.
-  //! @param theMat [in] the material.
+  //! @param[in] theMat  the material.
   Standard_EXPORT void SetCappingMaterial (const Graphic3d_MaterialAspect& theMat);
 
   //! @return capping material.
   const Graphic3d_MaterialAspect& CappingMaterial() const { return myAspect->FrontMaterial(); }
 
   //! Set texture to be applied on capping surface.
-  //! @param theTexture [in] the texture.
+  //! @param[in] theTexture  the texture.
   Standard_EXPORT void SetCappingTexture (const Handle(Graphic3d_TextureMap)& theTexture);
 
   //! @return capping texture map.
@@ -188,14 +188,14 @@ public: // @name user-defined graphical attributes
                                                               : Handle(Graphic3d_TextureMap)(); }
 
   //! Set hatch style (stipple) and turn hatching on.
-  //! @param theStyle [in] the hatch style.
+  //! @param[in] theStyle  the hatch style.
   Standard_EXPORT void SetCappingHatch (const Aspect_HatchStyle theStyle);
 
   //! @return hatching style.
   Aspect_HatchStyle CappingHatch() const { return (Aspect_HatchStyle)myAspect->HatchStyle()->HatchType(); }
 
   //! Set custom hatch style (stipple) and turn hatching on.
-  //! @param theStyle [in] the hatch pattern.
+  //! @param[in] theStyle  the hatch pattern.
   Standard_EXPORT void SetCappingCustomHatch (const Handle(Graphic3d_HatchStyle)& theStyle);
 
   //! @return hatching style.

src/Graphic3d/Graphic3d_CullingTool.hxx

@@ -59,8 +59,8 @@ public:
   Standard_EXPORT Graphic3d_CullingTool();
 
   //! Retrieves view volume's planes equations and its vertices from projection and world-view matrices.
-  //! @param theCamera [in] camera definition
+  //! @param[in] theCamera  camera definition
-  //! @param theModelWorld [in] optional object transformation for computing frustum in object local coordinate system
+  //! @param[in] theModelWorld  optional object transformation for computing frustum in object local coordinate system
   Standard_EXPORT void SetViewVolume (const Handle(Graphic3d_Camera)& theCamera,
                                       const Graphic3d_Mat4d& theModelWorld = Graphic3d_Mat4d());
 
@@ -81,10 +81,10 @@ public:
   Standard_EXPORT void CacheClipPtsProjections();
 
   //! Checks whether given AABB should be entirely culled or not.
-  //! @param theCtx    [in] culling properties
+  //! @param[in] theCtx     culling properties
-  //! @param theMinPnt [in] maximum point of AABB
+  //! @param[in] theMinPnt  maximum point of AABB
-  //! @param theMaxPnt [in] minimum point of AABB
+  //! @param[in] theMaxPnt  minimum point of AABB
-  //! @param theIsInside [out] flag indicating if AABB is fully inside; initial value should be set to TRUE
+  //! @param[out] theIsInside  flag indicating if AABB is fully inside; initial value should be set to TRUE
   //! @return TRUE if AABB is completely outside of view frustum or culled by size/distance;
   //!         FALSE in case of partial or complete overlap (use theIsInside to distinguish)
   bool IsCulled (const CullingContext& theCtx,
@@ -137,15 +137,15 @@ public:
 public:
 
   //! Calculates signed distance from plane to point.
-  //! @param theNormal [in] the plane's normal.
+  //! @param[in] theNormal  the plane's normal.
-  //! @param thePnt    [in]
+  //! @param[in] thePnt    
   Standard_EXPORT Standard_Real SignedPlanePointDistance (const Graphic3d_Vec4d& theNormal,
                                                           const Graphic3d_Vec4d& thePnt);
 
   //! Detects if AABB overlaps view volume using separating axis theorem (SAT).
-  //! @param theMinPnt   [in] maximum point of AABB
+  //! @param[in] theMinPnt    maximum point of AABB
-  //! @param theMaxPnt   [in] minimum point of AABB
+  //! @param[in] theMaxPnt    minimum point of AABB
-  //! @param theIsInside [out] flag indicating if AABB is fully inside; initial value should be set to TRUE
+  //! @param[out] theIsInside  flag indicating if AABB is fully inside; initial value should be set to TRUE
   //! @return TRUE if AABB is completely outside of view frustum;
   //!         FALSE in case of partial or complete overlap (use theIsInside to distinguish)
   //! @sa SelectMgr_Frustum::hasOverlap()
@@ -217,9 +217,9 @@ public:
   }
 
   //! Returns TRUE if given AABB should be discarded by distance culling criterion.
-  //! @param theMinPnt   [in] maximum point of AABB
+  //! @param[in] theMinPnt    maximum point of AABB
-  //! @param theMaxPnt   [in] minimum point of AABB
+  //! @param[in] theMaxPnt    minimum point of AABB
-  //! @param theIsInside [out] flag indicating if AABB is fully inside; initial value should be set to TRUE
+  //! @param[out] theIsInside  flag indicating if AABB is fully inside; initial value should be set to TRUE
   //! @return TRUE if AABB is completely behind culling distance;
   //!         FALSE in case of partial or complete overlap (use theIsInside to distinguish)
   bool IsTooDistant (const CullingContext&  theCtx,

src/Graphic3d/Graphic3d_GraphicDriver.hxx

@@ -90,17 +90,17 @@ public:
 
   //! Adds a layer to all views.
   //! To add a structure to desired layer on display it is necessary to set the layer ID for the structure.
-  //! @param theNewLayerId [in] id of new layer, should be > 0 (negative values are reserved for default layers).
+  //! @param[in] theNewLayerId  id of new layer, should be > 0 (negative values are reserved for default layers).
-  //! @param theSettings   [in] new layer settings
+  //! @param[in] theSettings    new layer settings
-  //! @param theLayerAfter [in] id of layer to append new layer before
+  //! @param[in] theLayerAfter  id of layer to append new layer before
   Standard_EXPORT virtual void InsertLayerBefore (const Graphic3d_ZLayerId theNewLayerId,
                                                   const Graphic3d_ZLayerSettings& theSettings,
                                                   const Graphic3d_ZLayerId theLayerAfter) = 0;
 
   //! Adds a layer to all views.
-  //! @param theNewLayerId  [in] id of new layer, should be > 0 (negative values are reserved for default layers).
+  //! @param[in] theNewLayerId   id of new layer, should be > 0 (negative values are reserved for default layers).
-  //! @param theSettings    [in] new layer settings
+  //! @param[in] theSettings     new layer settings
-  //! @param theLayerBefore [in] id of layer to append new layer after
+  //! @param[in] theLayerBefore  id of layer to append new layer after
   Standard_EXPORT virtual void InsertLayerAfter (const Graphic3d_ZLayerId theNewLayerId,
                                                  const Graphic3d_ZLayerSettings& theSettings,
                                                  const Graphic3d_ZLayerId theLayerBefore) = 0;

src/Graphic3d/Graphic3d_GraphicDriverFactory.hxx

@@ -30,8 +30,8 @@ class Graphic3d_GraphicDriverFactory : public Standard_Transient
 public:
 
   //! Registers factory.
-  //! @param theFactory     [in] factory to register
+  //! @param[in] theFactory      factory to register
-  //! @param theIsPreferred [in] add to the beginning of the list when TRUE, or add to the end otherwise
+  //! @param[in] theIsPreferred  add to the beginning of the list when TRUE, or add to the end otherwise
   Standard_EXPORT static void RegisterFactory (const Handle(Graphic3d_GraphicDriverFactory)& theFactory,
                                                bool theIsPreferred = false);
 

src/Graphic3d/Graphic3d_MarkerImage.hxx

@@ -38,16 +38,16 @@ public:
 public:
 
   //! Constructor from existing pixmap.
-  //! @param theImage [in] source image
+  //! @param[in] theImage  source image
-  //! @param theImageAlpha [in] colorless image
+  //! @param[in] theImageAlpha  colorless image
   Standard_EXPORT Graphic3d_MarkerImage (const Handle(Image_PixMap)& theImage,
                                          const Handle(Image_PixMap)& theImageAlpha = Handle(Image_PixMap)());
 
   //! Creates marker image from array of bytes
   //! (method for compatibility with old markers definition).
-  //! @param theBitMap [in] source bitmap stored as array of bytes
+  //! @param[in] theBitMap  source bitmap stored as array of bytes
-  //! @param theWidth  [in] number of bits in a row
+  //! @param[in] theWidth   number of bits in a row
-  //! @param theHeight [in] number of bits in a column
+  //! @param[in] theHeight  number of bits in a column
   Standard_EXPORT Graphic3d_MarkerImage (const Handle(TColStd_HArray1OfByte)& theBitMap,
                                          const Standard_Integer theWidth,
                                          const Standard_Integer theHeight);
@@ -81,7 +81,7 @@ public:
   //! @param theAlphaValue pixels in the image that have alpha value greater than
   //!                      or equal to this parameter will be stored in bitmap as "1",
   //!                      others will be stored as "0"
-  //! @param theIsTopDown [in] flag indicating expected rows order in returned bitmap, which is bottom-up by default
+  //! @param[in] theIsTopDown  flag indicating expected rows order in returned bitmap, which is bottom-up by default
   Standard_EXPORT Handle(TColStd_HArray1OfByte) GetBitMapArray (const Standard_Real theAlphaValue = 0.5,
                                                                 const Standard_Boolean theIsTopDown = false) const;
 

src/Graphic3d/Graphic3d_MaterialAspect.hxx

@@ -44,8 +44,8 @@ public:
   Standard_EXPORT static Graphic3d_TypeOfMaterial MaterialType (const Standard_Integer theRank);
 
   //! Finds the material for specified name.
-  //! @param theName [in]  name to find
+  //! @param[in] theName   name to find
-  //! @param theMat  [out] found material
+  //! @param[out] theMat   found material
   //! @return FALSE if name was unrecognized
   Standard_EXPORT static Standard_Boolean MaterialFromName (const Standard_CString theName,
                                                             Graphic3d_NameOfMaterial& theMat);

src/Graphic3d/Graphic3d_PBRMaterial.hxx

@@ -108,20 +108,20 @@ public:
 
   //! Generates 2D look up table of scale and bias for fresnell zero coefficient.
   //! It is needed for calculation reflectance part of environment lighting.
-  //! @param [out] theLUT table storage (must be Image_Format_RGF).
+  //! @param[out]  theLUT table storage (must be Image_Format_RGF).
-  //! @param [in] theNbIntegralSamples number of importance samples in hemisphere integral calculation for every table item.
+  //! @param[in]  theNbIntegralSamples number of importance samples in hemisphere integral calculation for every table item.
   Standard_EXPORT static void GenerateEnvLUT (const Handle(Image_PixMap)& theLUT,
                                               unsigned int                theNbIntegralSamples = 1024);
 
   //! Compute material roughness from common material (specular color + shininess).
-  //! @param theSpecular [in] specular color
+  //! @param[in] theSpecular  specular color
-  //! @param theShiness  [in] normalized shininess coefficient within [0..1] range
+  //! @param[in] theShiness   normalized shininess coefficient within [0..1] range
   //! @return roughness within [0..1] range
   Standard_EXPORT static Standard_ShortReal RoughnessFromSpecular (const Quantity_Color& theSpecular,
                                                                    const Standard_Real theShiness);
 
   //! Compute material metallicity from common material (specular color).
-  //! @param theSpecular [in] specular color
+  //! @param[in] theSpecular  specular color
   //! @return metallicity within [0..1] range
   static Standard_ShortReal MetallicFromSpecular (const Quantity_Color& theSpecular)
   {

src/Graphic3d/Graphic3d_ShaderManager.hxx

@@ -104,8 +104,8 @@ public:
 protected:
 
   //! Generate map key for light sources configuration.
-  //! @param theLights [in] list of light sources
+  //! @param[in] theLights  list of light sources
-  //! @param theHasShadowMap [in] flag indicating shadow maps usage
+  //! @param[in] theHasShadowMap  flag indicating shadow maps usage
   Standard_EXPORT TCollection_AsciiString genLightKey (const Handle(Graphic3d_LightSet)& theLights,
                                                        const bool theHasShadowMap) const;
 
@@ -113,23 +113,23 @@ protected:
   Standard_EXPORT Handle(Graphic3d_ShaderProgram) getStdProgramFont() const;
 
   //! Prepare standard GLSL program without lighting.
-  //! @param theBits      [in] program bits
+  //! @param[in] theBits       program bits
-  //! @param theIsOutline [in] draw silhouette
+  //! @param[in] theIsOutline  draw silhouette
   Standard_EXPORT Handle(Graphic3d_ShaderProgram) getStdProgramUnlit (Standard_Integer theBits,
                                                                       Standard_Boolean theIsOutline = false) const;
 
   //! Prepare standard GLSL program with per-vertex lighting.
-  //! @param theLights [in] list of light sources
+  //! @param[in] theLights  list of light sources
-  //! @param theBits   [in] program bits
+  //! @param[in] theBits    program bits
   Standard_EXPORT Handle(Graphic3d_ShaderProgram) getStdProgramGouraud (const Handle(Graphic3d_LightSet)& theLights,
                                                                         Standard_Integer theBits) const;
 
   //! Prepare standard GLSL program with per-pixel lighting.
-  //! @param theLights [in] list of light sources
+  //! @param[in] theLights  list of light sources
-  //! @param theBits   [in] program bits
+  //! @param[in] theBits    program bits
-  //! @param theIsFlatNormal [in] when TRUE, the Vertex normals will be ignored and Face normal will be computed instead
+  //! @param[in] theIsFlatNormal  when TRUE, the Vertex normals will be ignored and Face normal will be computed instead
-  //! @param theIsPBR  [in] when TRUE, the PBR pipeline will be activated
+  //! @param[in] theIsPBR   when TRUE, the PBR pipeline will be activated
-  //! @param theNbShadowMaps [in] number of shadow maps
+  //! @param[in] theNbShadowMaps  number of shadow maps
   Standard_EXPORT Handle(Graphic3d_ShaderProgram) getStdProgramPhong (const Handle(Graphic3d_LightSet)& theLights,
                                                                       const Standard_Integer theBits,
                                                                       const Standard_Boolean theIsFlatNormal,
@@ -173,10 +173,10 @@ protected:
   Standard_EXPORT bool hasGlslBitwiseOps() const;
 
   //! Prepare GLSL version header.
-  //! @param theProgram [in] [out] program to set version header
+  //! @param[in][out] theProgram   program to set version header
-  //! @param theName [in] program id suffix
+  //! @param[in] theName  program id suffix
-  //! @param theBits [in] program bits
+  //! @param[in] theBits  program bits
-  //! @param theUsesDerivates [in] program uses standard derivatives functions or not
+  //! @param[in] theUsesDerivates  program uses standard derivatives functions or not
   //! @return filtered program bits with unsupported features disabled
   Standard_EXPORT Standard_Integer defaultGlslVersion (const Handle(Graphic3d_ShaderProgram)& theProgram,
                                                        const TCollection_AsciiString& theName,
@@ -184,9 +184,9 @@ protected:
                                                        bool theUsesDerivates = false) const;
 
   //! Prepare GLSL version header for OIT composition programs.
-  //! @param theProgram [in] [out] program to set version header
+  //! @param[in][out] theProgram   program to set version header
-  //! @param theName [in] program id suffix
+  //! @param[in] theName  program id suffix
-  //! @param theMsaa [in] multisampling flag
+  //! @param[in] theMsaa  multisampling flag
   Standard_EXPORT void defaultOitGlslVersion (const Handle(Graphic3d_ShaderProgram)& theProgram,
                                               const TCollection_AsciiString& theName,
                                               bool theMsaa) const;
@@ -199,12 +199,12 @@ protected:
                                                                  Standard_Integer theBits) const;
 
   //! Define computeLighting GLSL function depending on current lights configuration
-  //! @param theNbLights     [out] number of defined light sources
+  //! @param[out] theNbLights      number of defined light sources
-  //! @param theLights       [in]  light sources list
+  //! @param[in] theLights         light sources list
-  //! @param theHasVertColor [in]  flag to use getVertColor() instead of Ambient and Diffuse components of active material
+  //! @param[in] theHasVertColor   flag to use getVertColor() instead of Ambient and Diffuse components of active material
-  //! @param theIsPBR        [in]  flag to activate PBR pipeline
+  //! @param[in] theIsPBR          flag to activate PBR pipeline
-  //! @param theHasTexColor  [in]  flag to include color texturing
+  //! @param[in] theHasTexColor    flag to include color texturing
-  //! @param theNbShadowMaps [in]  flag to include shadow map
+  //! @param[in] theNbShadowMaps   flag to include shadow map
   Standard_EXPORT TCollection_AsciiString stdComputeLighting (Standard_Integer& theNbLights,
                                                               const Handle(Graphic3d_LightSet)& theLights,
                                                               Standard_Boolean  theHasVertColor,

src/Graphic3d/Graphic3d_Structure.hxx

@@ -95,8 +95,8 @@ public:
   virtual void Erase() { erase(); }
   
   //! Highlights the structure in all the views with the given style
-  //! @param theStyle [in] the style (type of highlighting: box/color, color and opacity)
+  //! @param[in] theStyle  the style (type of highlighting: box/color, color and opacity)
-  //! @param theToUpdateMgr [in] defines whether related computed structures will be
+  //! @param[in] theToUpdateMgr  defines whether related computed structures will be
   //! highlighted via structure manager or not
   Standard_EXPORT void Highlight (const Handle(Graphic3d_PresentationAttributes)& theStyle, const Standard_Boolean theToUpdateMgr = Standard_True);
   
@@ -130,7 +130,7 @@ public:
   Graphic3d_ZLayerId GetZLayer() const { return myCStructure->ZLayer(); }
   
   //! Changes a sequence of clip planes slicing the structure on rendering.
-  //! @param thePlanes [in] the set of clip planes.
+  //! @param[in] thePlanes  the set of clip planes.
   void SetClipPlanes (const Handle(Graphic3d_SequenceOfHClipPlane)& thePlanes)
   {
     if (!myCStructure.IsNull()) { myCStructure->SetClipPlanes (thePlanes); }

src/Graphic3d/Graphic3d_TextureRoot.hxx

@@ -83,7 +83,7 @@ public:
 
   //! This method will be called by graphic driver each time when texture resource should be created.
   //! It is called in front of GetImage() for uploading compressed image formats natively supported by GPU.
-  //! @param theSupported [in] the list of supported compressed texture formats;
+  //! @param[in] theSupported  the list of supported compressed texture formats;
   //!                          returning image in unsupported format will result in texture upload failure
   //! @return compressed pixmap or NULL if image is not in supported compressed format
   Standard_EXPORT virtual Handle(Image_CompressedPixMap) GetCompressedImage (const Handle(Image_SupportedFormats)& theSupported);

src/Graphic3d/Graphic3d_TransformPers.hxx

@@ -244,9 +244,9 @@ public:
 public:
 
   //! Find scale value based on the camera position and view dimensions
-  //! @param theCamera [in] camera definition
+  //! @param[in] theCamera  camera definition
-  //! @param theViewportWidth [in] the width of viewport.
+  //! @param[in] theViewportWidth  the width of viewport.
-  //! @param theViewportHeight [in] the height of viewport.
+  //! @param[in] theViewportHeight  the height of viewport.
   virtual Standard_Real persistentScale (const Handle(Graphic3d_Camera)& theCamera,
                                          const Standard_Integer theViewportWidth,
                                          const Standard_Integer theViewportHeight) const
@@ -265,9 +265,9 @@ public:
   //! Create orientation matrix based on camera and view dimensions.
   //! Default implementation locks rotation by nullifying rotation component.
   //! Camera and view dimensions are not used, by default.
-  //! @param theCamera [in] camera definition
+  //! @param[in] theCamera  camera definition
-  //! @param theViewportWidth [in] the width of viewport
+  //! @param[in] theViewportWidth  the width of viewport
-  //! @param theViewportHeight [in] the height of viewport
+  //! @param[in] theViewportHeight  the height of viewport
   virtual NCollection_Mat3<Standard_Real> persistentRotationMatrix (const Handle(Graphic3d_Camera)& theCamera,
                                                                     const Standard_Integer theViewportWidth,
                                                                     const Standard_Integer theViewportHeight) const
@@ -281,11 +281,11 @@ public:
   }
 
   //! Apply transformation to bounding box of presentation.
-  //! @param theCamera [in] camera definition
+  //! @param[in] theCamera  camera definition
-  //! @param theProjection [in] the projection transformation matrix.
+  //! @param[in] theProjection  the projection transformation matrix.
-  //! @param theWorldView [in] the world view transformation matrix.
+  //! @param[in] theWorldView  the world view transformation matrix.
-  //! @param theViewportWidth [in] the width of viewport (for 2d persistence).
+  //! @param[in] theViewportWidth  the width of viewport (for 2d persistence).
-  //! @param theViewportHeight [in] the height of viewport (for 2d persistence).
+  //! @param[in] theViewportHeight  the height of viewport (for 2d persistence).
   //! @param theBoundingBox [in/out] the bounding box to transform.
   template<class T>
   void Apply (const Handle(Graphic3d_Camera)& theCamera,
@@ -296,11 +296,11 @@ public:
               Bnd_Box& theBoundingBox) const;
 
   //! Apply transformation to bounding box of presentation
-  //! @param theCamera [in] camera definition
+  //! @param[in] theCamera  camera definition
-  //! @param theProjection [in] the projection transformation matrix.
+  //! @param[in] theProjection  the projection transformation matrix.
-  //! @param theWorldView [in] the world view transformation matrix.
+  //! @param[in] theWorldView  the world view transformation matrix.
-  //! @param theViewportWidth [in] the width of viewport (for 2d persistence).
+  //! @param[in] theViewportWidth  the width of viewport (for 2d persistence).
-  //! @param theViewportHeight [in] the height of viewport (for 2d persistence).
+  //! @param[in] theViewportHeight  the height of viewport (for 2d persistence).
   //! @param theBoundingBox [in/out] the bounding box to transform.
   template<class T>
   void Apply (const Handle(Graphic3d_Camera)& theCamera,
@@ -313,12 +313,12 @@ public:
   //! Compute transformation.
   //! Computed matrix can be applied to model world transformation
   //! of an object to implement effect of transformation persistence.
-  //! @param theCamera [in] camera definition
+  //! @param[in] theCamera  camera definition
-  //! @param theProjection [in] the projection transformation matrix.
+  //! @param[in] theProjection  the projection transformation matrix.
-  //! @param theWorldView [in] the world view transformation matrix.
+  //! @param[in] theWorldView  the world view transformation matrix.
-  //! @param theViewportWidth [in] the width of viewport (for 2d persistence).
+  //! @param[in] theViewportWidth  the width of viewport (for 2d persistence).
-  //! @param theViewportHeight [in] the height of viewport (for 2d persistence).
+  //! @param[in] theViewportHeight  the height of viewport (for 2d persistence).
-  //! @param theToApplyProjPers [in] if should apply projection persistence to matrix (for orthographic persistence).
+  //! @param[in] theToApplyProjPers  if should apply projection persistence to matrix (for orthographic persistence).
   //! @return transformation matrix to be applied to model world transformation of an object.
   template<class T>
   NCollection_Mat4<T> Compute (const Handle(Graphic3d_Camera)& theCamera,
@@ -329,13 +329,13 @@ public:
                                const Standard_Boolean theToApplyProjPers = false) const;
 
   //! Apply transformation persistence on specified matrices.
-  //! @param theCamera [in] camera definition
+  //! @param[in] theCamera  camera definition
-  //! @param theProjection [in] projection matrix to modify
+  //! @param[in] theProjection  projection matrix to modify
   //! @param theWorldView [in/out]  world-view matrix to modify
-  //! @param theViewportWidth [in]  viewport width
+  //! @param[in] theViewportWidth   viewport width
-  //! @param theViewportHeight [in] viewport height
+  //! @param[in] theViewportHeight  viewport height
-  //! @param theAnchor [in] if not NULL, overrides anchor point
+  //! @param[in] theAnchor  if not NULL, overrides anchor point
-  //! @param theToApplyProjPers [in] if should apply projection persistence to matrix (for orthographic persistence).
+  //! @param[in] theToApplyProjPers  if should apply projection persistence to matrix (for orthographic persistence).
   template<class T>
   void Apply (const Handle(Graphic3d_Camera)& theCamera,
               const NCollection_Mat4<T>& theProjection,
@@ -346,10 +346,10 @@ public:
               const Standard_Boolean theToApplyProjPers = true) const;
 
   //! Perform computations for applying transformation persistence on specified matrices.
-  //! @param theCamera [in] camera definition
+  //! @param[in] theCamera  camera definition
-  //! @param theViewportWidth [in]  viewport width
+  //! @param[in] theViewportWidth   viewport width
-  //! @param theViewportHeight [in] viewport height
+  //! @param[in] theViewportHeight  viewport height
-  //! @param theAnchor [in] if not NULL, overrides anchor point
+  //! @param[in] theAnchor  if not NULL, overrides anchor point
   virtual NCollection_Mat4<Standard_Real> ComputeApply (Handle(Graphic3d_Camera)& theCamera,
                                                         const Standard_Integer theViewportWidth,
                                                         const Standard_Integer theViewportHeight,

src/Graphic3d/Graphic3d_TransformPersScaledAbove.hxx

@@ -32,9 +32,9 @@ public:
 
   //! Find scale value based on the camera position and view dimensions
   //! If the camera scale value less than the persistence scale, zoom persistence is not applied.
-  //! @param theCamera [in] camera definition
+  //! @param[in] theCamera  camera definition
-  //! @param theViewportWidth [in] the width of viewport.
+  //! @param[in] theViewportWidth  the width of viewport.
-  //! @param theViewportHeight [in] the height of viewport.
+  //! @param[in] theViewportHeight  the height of viewport.
   Standard_EXPORT virtual Standard_Real persistentScale (const Handle(Graphic3d_Camera)& theCamera,
                                                          const Standard_Integer theViewportWidth,
                                                          const Standard_Integer theViewportHeight) const Standard_OVERRIDE;

src/Graphic3d/Graphic3d_WorldViewProjState.hxx

@@ -32,9 +32,9 @@ public:
   }
 
   //! Constructor for custom projector type.
-  //! @param theProjectionState [in] the projection state.
+  //! @param[in] theProjectionState  the projection state.
-  //! @param theWorldViewState [in] the world view state.
+  //! @param[in] theWorldViewState  the world view state.
-  //! @param theCamera [in] the pointer to the class supplying projection and
+  //! @param[in] theCamera  the pointer to the class supplying projection and
   //!                       world view matrices (camera).
   Graphic3d_WorldViewProjState (const Standard_Size theProjectionState,
                                 const Standard_Size theWorldViewState,

src/IGESCAFControl/IGESCAFControl_Provider.hxx

@@ -47,7 +47,7 @@ public:
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theDocument document to save result
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT virtual bool Read(const TCollection_AsciiString& thePath,
                                     const Handle(TDocStd_Document)& theDocument,
@@ -58,7 +58,7 @@ public:
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theDocument document to export
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT virtual bool Write(const TCollection_AsciiString& thePath,
                                      const Handle(TDocStd_Document)& theDocument,
@@ -68,7 +68,7 @@ public:
   //! Reads a CAD file, according internal configuration
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theDocument document to save result
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT virtual bool Read(const TCollection_AsciiString& thePath,
                                     const Handle(TDocStd_Document)& theDocument,
@@ -77,7 +77,7 @@ public:
   //! Writes a CAD file, according internal configuration
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theDocument document to export
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT virtual bool Write(const TCollection_AsciiString& thePath,
                                      const Handle(TDocStd_Document)& theDocument,
@@ -87,7 +87,7 @@ public:
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theShape shape to save result
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT virtual bool Read(const TCollection_AsciiString& thePath,
                                     TopoDS_Shape& theShape,
@@ -98,7 +98,7 @@ public:
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theShape shape to export
   //! @param[in] theWS current work session
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT virtual bool Write(const TCollection_AsciiString& thePath,
                                      const TopoDS_Shape& theShape,
@@ -108,7 +108,7 @@ public:
   //! Reads a CAD file, according internal configuration
   //! @param[in] thePath path to the import CAD file
   //! @param[out] theShape shape to save result
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Read operation has ended correctly
   Standard_EXPORT virtual bool Read(const TCollection_AsciiString& thePath,
                                     TopoDS_Shape& theShape,
@@ -117,7 +117,7 @@ public:
   //! Writes a CAD file, according internal configuration
   //! @param[in] thePath path to the export CAD file
   //! @param[out] theShape shape to export
-  //! @param theProgress[in] progress indicator
+  //! @param[in] theProgress progress indicator
   //! @return true if Write operation has ended correctly
   Standard_EXPORT virtual bool Write(const TCollection_AsciiString& thePath,
                                      const TopoDS_Shape& theShape,

src/IVtk/IVtk_IShapeData.hxx

@@ -35,44 +35,44 @@ public:
   DEFINE_STANDARD_RTTIEXT(IVtk_IShapeData,IVtk_Interface)
 
   //! Insert a coordinate
-  //! @param [in] thePnt  point position
+  //! @param[in]  thePnt  point position
-  //! @param [in] theNorm point normal
+  //! @param[in]  theNorm point normal
   //! @return id of added point
   virtual IVtk_PointId InsertPoint (const gp_Pnt& thePnt,
                                     const NCollection_Vec3<float>& theNorm) = 0;
 
   //! Insert a vertex.
-  //! @param [in] theShapeID id of the sub-shape to which the vertex belongs.
+  //! @param[in]  theShapeID id of the sub-shape to which the vertex belongs.
-  //! @param [in] thePointId id of the point that defines the coordinates of the vertex
+  //! @param[in]  thePointId id of the point that defines the coordinates of the vertex
-  //! @param [in] theMeshType mesh type of the sub-shape (MT_Undefined by default)
+  //! @param[in]  theMeshType mesh type of the sub-shape (MT_Undefined by default)
   virtual void InsertVertex (const IVtk_IdType   theShapeID,
                              const IVtk_PointId  thePointId,
                              const IVtk_MeshType theMeshType = MT_Undefined) = 0;
 
   //! Insert a line.
-  //! @param [in] theShapeID id of the subshape to which the line belongs.
+  //! @param[in]  theShapeID id of the subshape to which the line belongs.
-  //! @param [in] thePointId1 id of the first point
+  //! @param[in]  thePointId1 id of the first point
-  //! @param [in] thePointId2 id of the second point
+  //! @param[in]  thePointId2 id of the second point
-  //! @param [in] theMeshType mesh type of the subshape (MT_Undefined by default)
+  //! @param[in]  theMeshType mesh type of the subshape (MT_Undefined by default)
   virtual void InsertLine (const IVtk_IdType   theShapeID,
                            const IVtk_PointId  thePointId1,
                            const IVtk_PointId  thePointId2,
                            const IVtk_MeshType theMeshType = MT_Undefined) = 0;
 
   //! Insert a poly-line.
-  //! @param [in] shapeID id of the subshape to which the polyline belongs.
+  //! @param[in]  shapeID id of the subshape to which the polyline belongs.
-  //! @param [in] pointIds vector of point ids
+  //! @param[in]  pointIds vector of point ids
-  //! @param [in] meshType mesh type of the subshape (MT_Undefined by default)
+  //! @param[in]  meshType mesh type of the subshape (MT_Undefined by default)
   virtual void InsertLine (const IVtk_IdType       theShapeID,
                            const IVtk_PointIdList* thePointIds,
                            const IVtk_MeshType     theMeshType = MT_Undefined) = 0;
 
   //! Insert a triangle
-  //! @param [in] theShapeID id of the subshape to which the triangle belongs.
+  //! @param[in]  theShapeID id of the subshape to which the triangle belongs.
-  //! @param [in] thePointId1 id of the first point
+  //! @param[in]  thePointId1 id of the first point
-  //! @param [in] thePointId2 id of the second point
+  //! @param[in]  thePointId2 id of the second point
-  //! @param [in] thePointId3 id of the third point
+  //! @param[in]  thePointId3 id of the third point
-  //! @param [in] theMeshType mesh type of the subshape (MT_Undefined by default)
+  //! @param[in]  theMeshType mesh type of the subshape (MT_Undefined by default)
   virtual void InsertTriangle (const IVtk_IdType   theShapeID,
                                const IVtk_PointId  thePointId1,
                                const IVtk_PointId  thePointId2,
@@ -82,9 +82,9 @@ public:
 public:
 
   //! Insert a coordinate
-  //! @param [in] theX X coordinate
+  //! @param[in]  theX X coordinate
-  //! @param [in] theY Y coordinate
+  //! @param[in]  theY Y coordinate
-  //! @param [in] theZ Z coordinate
+  //! @param[in]  theZ Z coordinate
   //! @return id of added point
   virtual IVtk_PointId InsertCoordinate (double theX, double theY, double theZ)
   {
@@ -92,7 +92,7 @@ public:
   }
 
   //! Insert a coordinate
-  //! @param [in] thePnt point position
+  //! @param[in]  thePnt point position
   //! @return id of added point
   IVtk_PointId InsertCoordinate (const gp_Pnt& thePnt)
   {

src/IVtk/IVtk_IShapeMesher.hxx

@@ -32,8 +32,8 @@ public:
   virtual ~IVtk_IShapeMesher() { }
 
   //! Main entry point for building shape representation
-  //! @param [in] shape IShape to be meshed
+  //! @param[in]  shape IShape to be meshed
-  //! @param [in] data IShapeData interface visualization data is passed to.
+  //! @param[in]  data IShapeData interface visualization data is passed to.
   Standard_EXPORT void Build (const IVtk_IShape::Handle& theShape, const IVtk_IShapeData::Handle& theData);
 
   DEFINE_STANDARD_RTTIEXT(IVtk_IShapeMesher,IVtk_Interface)

src/IVtk/IVtk_IShapePickerAlgo.hxx

@@ -37,7 +37,7 @@ public:
   virtual int  NbPicked() = 0;
 
   //! Get activated selection modes for a shape.
-  //! @param [in] theShape a shape with activated selection mode(s)
+  //! @param[in]  theShape a shape with activated selection mode(s)
   //! @return list of active selection modes
   virtual IVtk_SelectionModeList GetSelectionModes (const IVtk_IShape::Handle& theShape) const = 0;
 
@@ -46,9 +46,9 @@ public: // @name Set selectable shapes and selection modes
   //! Activates/deactivates the given selection mode for the shape.
   //! If mode == SM_None, the shape becomes non-selectable and 
   //! is removed from the internal selection data.
-  //! @param [in] theShape Shape for which the selection mode should be activated
+  //! @param[in]  theShape Shape for which the selection mode should be activated
-  //! @param [in] theMode Selection mode to be activated
+  //! @param[in]  theMode Selection mode to be activated
-  //! @param [in] theIsTurnOn Flag to turn on/off the selection mode
+  //! @param[in]  theIsTurnOn Flag to turn on/off the selection mode
   virtual void SetSelectionMode (const IVtk_IShape::Handle& theShape,
                                  const IVtk_SelectionMode theMode,
                                  const bool theIsTurnOn = true) = 0;
@@ -56,9 +56,9 @@ public: // @name Set selectable shapes and selection modes
   //! Activates/deactivates the given selection mode for the shape.
   //! If mode == SM_None, the shape becomes non-selectable and 
   //! is removed from the internal selection data.
-  //! @param [in] theShapes List of shapes for which the selection mode should be activated
+  //! @param[in]  theShapes List of shapes for which the selection mode should be activated
-  //! @param [in] theMode Selection mode to be activated
+  //! @param[in]  theMode Selection mode to be activated
-  //! @param [in] theIsTurnOn Flag to turn on/off the selection mode
+  //! @param[in]  theIsTurnOn Flag to turn on/off the selection mode
   virtual void SetSelectionMode (const IVtk_ShapePtrList& theShapes,
                                  const IVtk_SelectionMode theMode,
                                  const bool theIsTurnOn = true) = 0;
@@ -80,8 +80,8 @@ public: // @name Obtain picking results
   //! is the first in the list)
   virtual const IVtk_ShapeIdList& ShapesPicked() const = 0;
 
-  //! @param [in] theId Top-level shape ID
+  //! @param[in]  theId Top-level shape ID
-  //! @param [out] theShapeList the list of picked sub-shape IDs for the given top-level shape ID,
+  //! @param[out]  theShapeList the list of picked sub-shape IDs for the given top-level shape ID,
   //! in the order of increasing depth (the ID of the sub-shape closest to the eye 
   //! is the first in the list)
   virtual void SubShapesPicked (const IVtk_IdType theId, IVtk_ShapeIdList& theShapeList) const = 0;

src/IVtk/IVtk_IView.hxx

@@ -86,8 +86,8 @@ public:
                              Standard_Boolean& theIsOrtho) const = 0;
 
   //! Converts 3D display coordinates into 3D world coordinates.
-  //! @param [in] theDisplayPnt 2d point of display coordinates
+  //! @param[in]  theDisplayPnt 2d point of display coordinates
-  //! @param [out] theWorldPnt 3d point of world coordinates
+  //! @param[out]  theWorldPnt 3d point of world coordinates
   //! @return true if conversion was successful, false otherwise
   virtual bool    DisplayToWorld (const gp_XY& theDisplayPnt, gp_XYZ& theWorldPnt) const = 0;
 

src/IVtkOCC/IVtkOCC_SelectableObject.hxx

@@ -34,7 +34,7 @@ public:
   typedef Handle(IVtkOCC_SelectableObject) Handle;
 
   //! Constructs a selectable object initialized by the given shape
-  //! @param [in] theShape Selectable shape
+  //! @param[in]  theShape Selectable shape
   IVtkOCC_SelectableObject (const IVtkOCC_Shape::Handle& theShape);
 
   //! Constructs uninitialized selectable object.
@@ -44,7 +44,7 @@ public:
   virtual ~IVtkOCC_SelectableObject();
 
   //! Sets the selectable shape
-  //! @param [in] theShape Selectable shape
+  //! @param[in]  theShape Selectable shape
   Standard_EXPORT void SetShape (const IVtkOCC_Shape::Handle& theShape);
 
   const IVtkOCC_Shape::Handle&  GetShape() const { return myShape; };
@@ -58,8 +58,8 @@ private:
 
   //! Internal method, computes selection data for viewer selector
   //! Inspired by AIS_Shape::ComputeSelection() from OCCT 6.5.1
-  //! @param [in] selection container for sensitive primitives
+  //! @param[in]  selection container for sensitive primitives
-  //! @param [in] mode Selection mode
+  //! @param[in]  mode Selection mode
   virtual void ComputeSelection (const Handle(SelectMgr_Selection)& theSelection,
                                  const Standard_Integer theMode) Standard_OVERRIDE;
 

src/IVtkOCC/IVtkOCC_Shape.hxx

@@ -33,8 +33,8 @@ public:
   typedef Handle(IVtkOCC_Shape) Handle;
 
   //! Constructor for OCC IShape implementation.
-  //! @param theShape [in] shape to display
+  //! @param[in] theShape  shape to display
-  //! @param theDrawerLink [in] default attributes to link
+  //! @param[in] theDrawerLink  default attributes to link
   Standard_EXPORT IVtkOCC_Shape (const TopoDS_Shape& theShape,
                                  const Handle(Prs3d_Drawer)& theDrawerLink = Handle(Prs3d_Drawer)());
 
@@ -58,7 +58,7 @@ public:
   //! Returns unique ID of the given sub-shape within the top-level shape.
   //! Note that the sub-shape ID remains unchanged until the top-level is 
   //! modified by some operation.
-  //! @param [in] subShape sub-shape whose ID is returned
+  //! @param[in]  subShape sub-shape whose ID is returned
   //! @return local ID of the sub-shape.
   Standard_EXPORT IVtk_IdType GetSubShapeId (const TopoDS_Shape& theSubShape) const;
 
@@ -67,7 +67,7 @@ public:
 
   //! @brief Get a sub-shape by its local ID.
   //!
-  //! @param [in] id local ID of a sub-shape
+  //! @param[in]  id local ID of a sub-shape
   //! @return TopoDS_Shape& a sub-shape
   Standard_EXPORT const TopoDS_Shape& GetSubShape (const IVtk_IdType theId) const;
 
@@ -75,7 +75,7 @@ public:
   //! in a data field. This object internally caches selection data
   //! so it should be stored until the shape is no longer selectable.
   //! Note that the selectable object keeps a pointer to OccShape.
-  //! @param [in] selObj Handle to the selectable object
+  //! @param[in]  selObj Handle to the selectable object
   void SetSelectableObject (const Handle(SelectMgr_SelectableObject)& theSelObj)
   {
     mySelectable = theSelObj;

src/IVtkOCC/IVtkOCC_ShapeMesher.hxx

@@ -105,9 +105,9 @@ private:
   //! Generates wireframe representation of the given TopoDS_Face object
   //! with help of OCCT algorithms. The resulting polylines are passed to IPolyData
   //! interface and associated with the given sub-shape ID.
-  //! @param [in] theFace TopoDS_Face object to build wireframe representation for
+  //! @param[in]  theFace TopoDS_Face object to build wireframe representation for
-  //! @param [in] theShapeId The face' sub-shape ID
+  //! @param[in]  theShapeId The face' sub-shape ID
-  //! @param [in] theDeflection curve deflection
+  //! @param[in]  theDeflection curve deflection
   void addWFFace (const TopoDS_Face&  theFace,
                   const IVtk_IdType   theShapeId,
                   const Standard_Real theDeflection);
@@ -116,8 +116,8 @@ private:
   //! starting from OCCT triangulation that should be created in advance. 
   //! The resulting triangles are passed to IPolyData
   //! interface and associated with the given sub-shape ID.
-  //! @param [in] theFace    TopoDS_Face object to build shaded representation for
+  //! @param[in]  theFace    TopoDS_Face object to build shaded representation for
-  //! @param [in] theShapeId the face' sub-shape ID
+  //! @param[in]  theShapeId the face' sub-shape ID
   //! @see IVtkOCC_ShapeMesher::meshShape, IVtkOCC_ShapeMesher::addEdge
   void addShadedFace (const TopoDS_Face&  theFace,
                       const IVtk_IdType   theShapeId);

src/IVtkOCC/IVtkOCC_ShapePickerAlgo.hxx

@@ -44,7 +44,7 @@ public:
   Standard_EXPORT virtual int  NbPicked() Standard_OVERRIDE;
 
   //! Get activated selection modes for a shape.
-  //! @param [in] theShape a shape with activated selection mode(s)
+  //! @param[in]  theShape a shape with activated selection mode(s)
   //! @return list of active selection modes
   Standard_EXPORT virtual IVtk_SelectionModeList 
     GetSelectionModes (const IVtk_IShape::Handle& theShape) const Standard_OVERRIDE;
@@ -54,9 +54,9 @@ public: //! @name Set selectable shapes and selection modes
   //! Activates/deactivates the given selection mode for the shape.
   //! If mode == SM_None, the shape becomes non-selectable and 
   //! is removed from the internal selection data.
-  //! @param [in] theShape Shape for which the selection mode should be activated
+  //! @param[in]  theShape Shape for which the selection mode should be activated
-  //! @param [in] theMode Selection mode to be activated
+  //! @param[in]  theMode Selection mode to be activated
-  //! @param [in] theIsTurnOn Flag to turn on/off the selection mode
+  //! @param[in]  theIsTurnOn Flag to turn on/off the selection mode
   Standard_EXPORT virtual void SetSelectionMode (const IVtk_IShape::Handle& theShape,
                                                  const IVtk_SelectionMode theMode,
                                                  const bool theIsTurnOn = true) Standard_OVERRIDE;
@@ -64,9 +64,9 @@ public: //! @name Set selectable shapes and selection modes
   //! Activates/deactivates the given selection mode for the shape.
   //! If mode == SM_None, the shape becomes non-selectable and 
   //! is removed from the internal selection data.
-  //! @param [in] theShapes List of shapes for which the selection mode should be activated
+  //! @param[in]  theShapes List of shapes for which the selection mode should be activated
-  //! @param [in] theMode Selection mode to be activated
+  //! @param[in]  theMode Selection mode to be activated
-  //! @param [in] theIsTurnOn Flag to turn on/off the selection mode
+  //! @param[in]  theIsTurnOn Flag to turn on/off the selection mode
   Standard_EXPORT virtual void SetSelectionMode (const IVtk_ShapePtrList& theShapes,
                                                  const IVtk_SelectionMode theMode,
                                                  const bool theIsTurnOn = true) Standard_OVERRIDE;
@@ -89,15 +89,15 @@ public: //! @name Obtain picking results
   //! is the first in the list)
   Standard_EXPORT virtual const IVtk_ShapeIdList& ShapesPicked() const Standard_OVERRIDE;
 
-  //! @param [in] theId Top-level shape ID
+  //! @param[in]  theId Top-level shape ID
-  //! @param [out] theShapeList the list of picked sub-shape IDs for the given top-level shape ID,
+  //! @param[out]  theShapeList the list of picked sub-shape IDs for the given top-level shape ID,
   //! in the order of increasing depth (the ID of the sub-shape closest to the eye 
   //! is the first in the list)
   Standard_EXPORT virtual void 
     SubShapesPicked (const IVtk_IdType theId, IVtk_ShapeIdList& theShapeList) const Standard_OVERRIDE;
 
   //! Remove selectable object from the picker (from internal maps).
-  //! @param [in] theShape the selectable shape
+  //! @param[in]  theShape the selectable shape
   Standard_EXPORT virtual void RemoveSelectableObject(const IVtk_IShape::Handle& theShape);
 
   //! Return topmost picked 3D point or (Inf, Inf, Inf) if undefined.

src/IVtkOCC/IVtkOCC_ViewerSelector.hxx

@@ -33,15 +33,15 @@ public:
   virtual ~IVtkOCC_ViewerSelector();
 
   //! Implements point picking
-  //! @param [in] theXPix, theYPix Display coordinates of the point
+  //! @param[in]  theXPix, theYPix Display coordinates of the point
-  //! @param [in] theView  ICamera interface to update the projection parameters.
+  //! @param[in]  theView  ICamera interface to update the projection parameters.
   void Pick (const Standard_Integer    theXPix,
              const Standard_Integer    theYPix,
              const IVtk_IView::Handle& theView);
 
   //! Picking by rectangle
-  //! @param [in] theXMin, theYMin, theXMax, theYMax Rectangle coords
+  //! @param[in]  theXMin, theYMin, theXMax, theYMax Rectangle coords
-  //! @param [in] theView ICamera interface to calculate projections
+  //! @param[in]  theView ICamera interface to calculate projections
   void Pick (const Standard_Integer    theXMin,
              const Standard_Integer    theYMin,
              const Standard_Integer    theXMax,

src/IVtkTools/IVtkTools.hxx

@@ -35,33 +35,33 @@ namespace IVtkTools
 
   //! Set a color for given type of sub-shapes.
   //! @param [in,out] theColorTable vtkLookupTable to set the color.
-  //! @param [in]  theColorRole type of sub-shapes to set the color.
+  //! @param[in]   theColorRole type of sub-shapes to set the color.
-  //! @param [in]  theR red color component. Use [0,1] double values.
+  //! @param[in]   theR red color component. Use [0,1] double values.
-  //! @param [in]  theG green color component. Use [0,1] double values.
+  //! @param[in]   theG green color component. Use [0,1] double values.
-  //! @param [in]  theB blue color component. Use [0,1] double values.
+  //! @param[in]   theB blue color component. Use [0,1] double values.
-  //! @param [in]  theA the alpha value (the opacity) as a double between 0 and 1.
+  //! @param[in]   theA the alpha value (the opacity) as a double between 0 and 1.
   Standard_EXPORT void SetLookupTableColor (vtkLookupTable* theColorTable, 
                                             const IVtk_MeshType theColorRole, 
                                             const double theR, const double theG, const double theB, 
                                             const double theA = 1);
 
   //! Get a color for given type of sub-shapes.
-  //! @param [in]  theColorTable vtkLookupTable to set the color.
+  //! @param[in]   theColorTable vtkLookupTable to set the color.
-  //! @param [in]  theColorRole type of sub-shapes to set the color.
+  //! @param[in]   theColorRole type of sub-shapes to set the color.
-  //! @param [out] theR red color component as a double between 0 and 1.
+  //! @param[out]  theR red color component as a double between 0 and 1.
-  //! @param [out] theG green color component as a double between 0 and 1.
+  //! @param[out]  theG green color component as a double between 0 and 1.
-  //! @param [out] theB blue color component as a double between 0 and 1.
+  //! @param[out]  theB blue color component as a double between 0 and 1.
   Standard_EXPORT void GetLookupTableColor (vtkLookupTable* theColorTable, 
                                             const IVtk_MeshType theColorRole, 
                                             double &theR, double &theG, double &theB);
 
   //! Get a color for given type of sub-shapes.
-  //! @param [in]  theColorTable vtkLookupTable to set the color.
+  //! @param[in]   theColorTable vtkLookupTable to set the color.
-  //! @param [in]  theColorRole type of sub-shapes to set the color.
+  //! @param[in]   theColorRole type of sub-shapes to set the color.
-  //! @param [out] theR red color component as a double between 0 and 1.
+  //! @param[out]  theR red color component as a double between 0 and 1.
-  //! @param [out] theG green color component as a double between 0 and 1.
+  //! @param[out]  theG green color component as a double between 0 and 1.
-  //! @param [out] theB blue color component as a double between 0 and 1.
+  //! @param[out]  theB blue color component as a double between 0 and 1.
-  //! @param [out] theA the alpha value (the opacity) as a double between 0 and 1.
+  //! @param[out]  theA the alpha value (the opacity) as a double between 0 and 1.
   Standard_EXPORT void GetLookupTableColor (vtkLookupTable* theColorTable, 
                                             const IVtk_MeshType theColorRole, 
                                             double &theR, double &theG, double &theB, 
@@ -72,7 +72,7 @@ namespace IVtkTools
 
   //! Set up the initial shape mapper parameters with user colors.
   //! @param [in,out] theMapper mapper to initialize
-  //! @param [in] theColorTable a table with user's colors definition
+  //! @param[in]  theColorTable a table with user's colors definition
   Standard_EXPORT void InitShapeMapper (vtkMapper* theMapper, 
                                         vtkLookupTable* theColorTable);
 

src/IVtkTools/IVtkTools_ShapeDataSource.hxx

@@ -46,7 +46,7 @@ public:
 public: //! @name Initialization
 
   //! Set the source OCCT shape.
-  //! @param theOccShape [in] OCCT shape wrapper.
+  //! @param[in] theOccShape  OCCT shape wrapper.
   void SetShape(const IVtkOCC_Shape::Handle& theOccShape);
 
   //! Get the source OCCT shape.
@@ -63,7 +63,7 @@ public: //! @name Data accessors
   IVtk_IdType GetId() const;
 
   //! Checks if the internal OccShape pointer is the same the argument.
-  //! @param [in] shape OccShape pointer to be checked.
+  //! @param[in]  shape OccShape pointer to be checked.
   //! @return true if the two OccShape instances are the same, and false otherwise.
   Standard_Boolean Contains (const IVtkOCC_Shape::Handle& theOccShape) const;
 
@@ -76,11 +76,11 @@ protected: //! @name Interface to override
   //! This is called by the superclass.
   //! This is the method you should override if you use this class as ancestor.
   //! Build output polygonal data set from the shape wrapper.
-  //! @param theRequest [in] information about data object.
+  //! @param[in] theRequest  information about data object.
   //! In current implementation it is ignored.
-  //! @param theInputVector [in] the input data. As adata source is the start
+  //! @param[in] theInputVector  the input data. As adata source is the start
   //! stage of the VTK pipeline, theInputVector is empty and not used (no input port).
-  //! @param theOutputVector [in] the pointer to output data, that is filled in this method.
+  //! @param[in] theOutputVector  the pointer to output data, that is filled in this method.
   virtual int RequestData(vtkInformation* theRequest,
                           vtkInformationVector** theInputVector,
                           vtkInformationVector* theOutputVector) Standard_OVERRIDE;
@@ -89,8 +89,8 @@ protected: //! @name Internals
 
   //! Transforms the passed polygonal data by the given OCCT transformation
   //! matrix.
-  //! @param theSource [in] source polygonal data to transform.
+  //! @param[in] theSource  source polygonal data to transform.
-  //! @param theTrsf [in] transformation to apply.
+  //! @param[in] theTrsf  transformation to apply.
   //! @return resulting polygonal data (transformed copy of source).
   vtkSmartPointer<vtkPolyData> transform (vtkPolyData* theSource, const gp_Trsf& theTrsf) const;
 

src/IVtkTools/IVtkTools_ShapePicker.hxx

@@ -67,38 +67,38 @@ public:
   //! Sets the renderer to be used by OCCT selection algorithm
   void SetRenderer (vtkRenderer* theRenderer);
   //! Sets area selection on/off
-  //! @param [in] theIsOn true if area selection is turned on, false otherwise.
+  //! @param[in]  theIsOn true if area selection is turned on, false otherwise.
   void SetAreaSelection (bool theIsOn);
 
   //! Get activated selection modes for a shape.
-  //! @param [in] theShape a shape with activated selection mode(s)
+  //! @param[in]  theShape a shape with activated selection mode(s)
   //! @return list of active selection modes
   IVtk_SelectionModeList GetSelectionModes (const IVtk_IShape::Handle& theShape) const;
 
   //! Get activated selection modes for a shape actor.
-  //! @param [in] theShapeActor an actor with activated selection mode(s)
+  //! @param[in]  theShapeActor an actor with activated selection mode(s)
   //! @return list of active selection modes
   IVtk_SelectionModeList GetSelectionModes (vtkActor* theShapeActor) const;
 
   //! Turn on/off a selection mode for a shape actor.
-  //! @param [in] theShape a shape to set a selection mode for
+  //! @param[in]  theShape a shape to set a selection mode for
-  //! @param [in] theMode selection mode to be activated
+  //! @param[in]  theMode selection mode to be activated
-  //! @param [in] theIsTurnOn Flag to turn on/off the selection mode
+  //! @param[in]  theIsTurnOn Flag to turn on/off the selection mode
   void SetSelectionMode (const IVtk_IShape::Handle& theShape,
                          const IVtk_SelectionMode theMode,
                          const bool theIsTurnOn = true) const;
 
   //! Turn on/off a selection mode for a shape actor.
-  //! @param [in] theShapeActor shape presentation actor to set a selection mode for
+  //! @param[in]  theShapeActor shape presentation actor to set a selection mode for
-  //! @param [in] theMode selection mode to be activated
+  //! @param[in]  theMode selection mode to be activated
-  //! @param [in] theIsTurnOn Flag to turn on/off the selection mode
+  //! @param[in]  theIsTurnOn Flag to turn on/off the selection mode
   void SetSelectionMode (vtkActor* theShapeActor,
                          const IVtk_SelectionMode theMode,
                          const bool theIsTurnOn = true) const;
 
   //! Sets the current selection mode for all visible shape objects.
-  //! @param [in] theMode selection mode to be activated
+  //! @param[in]  theMode selection mode to be activated
-  //! @param [in] theIsTurnOn Flag to turn on/off the selection mode
+  //! @param[in]  theIsTurnOn Flag to turn on/off the selection mode
   void SetSelectionMode (const IVtk_SelectionMode theMode,
                          const bool theIsTurnOn = true) const;
 
@@ -109,30 +109,30 @@ public:
   //! all OccShape objects found by the picking algorithm. e.g. all 
   //! shapes under the mouse cursor. Otherwise, ID of the shape closest to the eye
   //! is returned.
-  //! @param [in] theIsAll Get all selected shapes or just the only
+  //! @param[in]  theIsAll Get all selected shapes or just the only
   //!        top one is returned, has no effect during area selection.
   //! @return List of top-level shape IDs
   IVtk_ShapeIdList GetPickedShapesIds (bool theIsAll = false) const;
 
   //! Access to the list of sub-shapes ids picked. 
-  //! @param [in] theId top-level shape ID
+  //! @param[in]  theId top-level shape ID
-  //! @param [in] theIsAll Get all selected sub-shapes or just the 
+  //! @param[in]  theIsAll Get all selected sub-shapes or just the 
   //!        only top one is returned, has no effect during area selection.
   //! @return List of sub-shapes IDs
   IVtk_ShapeIdList GetPickedSubShapesIds (const IVtk_IdType theId, bool theIsAll = false) const;
 
   //! Access to the list of actors picked. 
-  //! @param [in] theIsAll Get all selected actors or just the only
+  //! @param[in]  theIsAll Get all selected actors or just the only
   //!         top one is returned, has no effect during area selection.
   //! @return List of actors IDs
   vtkSmartPointer<vtkActorCollection> GetPickedActors (bool theIsAll = false) const;
 
   //! Remove selectable object from the picker (from internal maps).
-  //! @param [in] theShape the selectable shape
+  //! @param[in]  theShape the selectable shape
   void RemoveSelectableObject(const IVtk_IShape::Handle& theShape);
 
   //! Remove selectable object from the picker (from internal maps).
-  //! @param [in] theShapeActor the shape presentation actor to be removed from the picker
+  //! @param[in]  theShapeActor the shape presentation actor to be removed from the picker
   void RemoveSelectableActor(vtkActor* theShapeActor);
 
 protected:
@@ -152,10 +152,10 @@ private: // not copyable
 
   //! Implementation of picking algorithm. 
   //! The coordinates accepted by this method are display (pixel) coordinates.
-  //! @param [in] pos contains the pick point (3 coordinates) or pick rectangle (6 coordinates)
+  //! @param[in]  pos contains the pick point (3 coordinates) or pick rectangle (6 coordinates)
   //! or polyline (array of 2d coordinates)
-  //! @param [in] renderer vtkRenderer object to be used (normally set in advance with setRenderer())
+  //! @param[in]  renderer vtkRenderer object to be used (normally set in advance with setRenderer())
-  //! @param [in] nbPoints number of points for polyline case
+  //! @param[in]  nbPoints number of points for polyline case
   //! @see IVtkTools_ShapePicker::setRenderer
   virtual void doPickImpl (double*, vtkRenderer* theRenderer, const int theNbPoints = -1);
 

src/IVtkVTK/IVtkVTK_ShapeData.hxx

@@ -54,43 +54,43 @@ public:
   DEFINE_STANDARD_RTTIEXT(IVtkVTK_ShapeData,IVtk_IShapeData)
 
   //! Insert a coordinate
-  //! @param [in] thePnt  point position
+  //! @param[in]  thePnt  point position
-  //! @param [in] theNorm point normal
+  //! @param[in]  theNorm point normal
   //! @return id of added point
   Standard_EXPORT virtual IVtk_PointId InsertPoint (const gp_Pnt& thePnt,
                                                     const NCollection_Vec3<float>& theNorm) Standard_OVERRIDE;
 
   //! Insert a vertex.
-  //! @param [in] theShapeID id of the subshape to which the vertex belongs.
+  //! @param[in]  theShapeID id of the subshape to which the vertex belongs.
-  //! @param [in] thePointId id of the point that defines the coordinates of the vertex
+  //! @param[in]  thePointId id of the point that defines the coordinates of the vertex
-  //! @param [in] theMeshType mesh type of the subshape (MT_Undefined by default)
+  //! @param[in]  theMeshType mesh type of the subshape (MT_Undefined by default)
   Standard_EXPORT virtual void InsertVertex (const IVtk_IdType   theShapeID,
                                              const IVtk_PointId  thePointId,
                                              const IVtk_MeshType theMeshType) Standard_OVERRIDE;
 
   //! Insert a line.
-  //! @param [in] theShapeID id of the subshape to which the line belongs.
+  //! @param[in]  theShapeID id of the subshape to which the line belongs.
-  //! @param [in] thePointId1 id of the first point
+  //! @param[in]  thePointId1 id of the first point
-  //! @param [in] thePointId2 id of the second point
+  //! @param[in]  thePointId2 id of the second point
-  //! @param [in] theMeshType mesh type of the subshape (MT_Undefined by default)
+  //! @param[in]  theMeshType mesh type of the subshape (MT_Undefined by default)
   Standard_EXPORT virtual void InsertLine (const IVtk_IdType   theShapeID,
                                            const IVtk_PointId  thePointId1,
                                            const IVtk_PointId  thePointId2,
                                            const IVtk_MeshType theMeshType) Standard_OVERRIDE;
 
   //! Insert a poly-line.
-  //! @param [in] theShapeID id of the subshape to which the polyline belongs.
+  //! @param[in]  theShapeID id of the subshape to which the polyline belongs.
-  //! @param [in] thePointIds vector of point ids
+  //! @param[in]  thePointIds vector of point ids
-  //! @param [in] theMeshType mesh type of the subshape (MT_Undefined by default)
+  //! @param[in]  theMeshType mesh type of the subshape (MT_Undefined by default)
   Standard_EXPORT virtual void InsertLine (const IVtk_IdType       theShapeID, 
                                            const IVtk_PointIdList* thePointIds,
                                            const IVtk_MeshType     theMeshType) Standard_OVERRIDE;
   //! Insert a triangle
-  //! @param [in] theShapeID id of the subshape to which the triangle belongs.
+  //! @param[in]  theShapeID id of the subshape to which the triangle belongs.
-  //! @param [in] thePointId1 id of the first point
+  //! @param[in]  thePointId1 id of the first point
-  //! @param [in] thePointId2 id of the second point
+  //! @param[in]  thePointId2 id of the second point
-  //! @param [in] thePointId3 id of the third point
+  //! @param[in]  thePointId3 id of the third point
-  //! @param [in] theMeshType mesh type of the subshape (MT_Undefined by default)
+  //! @param[in]  theMeshType mesh type of the subshape (MT_Undefined by default)
   Standard_EXPORT virtual void InsertTriangle (const IVtk_IdType   theShapeID,
                                                const IVtk_PointId  thePointId1,
                                                const IVtk_PointId  thePointId2,

src/IVtkVTK/IVtkVTK_View.hxx

@@ -94,8 +94,8 @@ public:
                                               Standard_Real& theHeight) const Standard_OVERRIDE;
 
   //! Converts 3D display coordinates into 3D world coordinates.
-  //! @param [in] theDisplayPnt 2d point of display coordinates
+  //! @param[in]  theDisplayPnt 2d point of display coordinates
-  //! @param [out] theWorldPnt 3d point of world coordinates
+  //! @param[out]  theWorldPnt 3d point of world coordinates
   //! @return true if conversion was successful, false otherwise
   Standard_EXPORT virtual bool DisplayToWorld (const gp_XY& theDisplayPnt, gp_XYZ& theWorldPnt) const Standard_OVERRIDE;
 

src/Image/Image_DDSParser.hxx

@@ -25,11 +25,11 @@ class Image_DDSParser
 public:
 
   //! Load the face from DDS file.
-  //! @param theSupported [in] list of supported image formats
+  //! @param[in] theSupported  list of supported image formats
-  //! @param theFile      [in] file path
+  //! @param[in] theFile       file path
-  //! @param theFaceIndex [in] face index, within [0, Image_CompressedPixMap::NbFaces()) range;
+  //! @param[in] theFaceIndex  face index, within [0, Image_CompressedPixMap::NbFaces()) range;
   //!                          use -1 to skip reading the face data
-  //! @param theFileOffset [in] offset to the DDS data
+  //! @param[in] theFileOffset  offset to the DDS data
   //! @return loaded face or NULL if file cannot be read or not valid DDS file
   Standard_EXPORT static Handle(Image_CompressedPixMap) Load (const Handle(Image_SupportedFormats)& theSupported,
                                                               const TCollection_AsciiString& theFile,
@@ -37,9 +37,9 @@ public:
                                                               const int64_t theFileOffset = 0);
 
   //! Load the face from DDS file.
-  //! @param theSupported [in] list of supported image formats
+  //! @param[in] theSupported  list of supported image formats
-  //! @param theBuffer    [in] pre-loaded file data, should be at least of 128 bytes long defining DDS header.
+  //! @param[in] theBuffer     pre-loaded file data, should be at least of 128 bytes long defining DDS header.
-  //! @param theFaceIndex [in] face index, within [0, Image_CompressedPixMap::NbFaces()) range;
+  //! @param[in] theFaceIndex  face index, within [0, Image_CompressedPixMap::NbFaces()) range;
   //!                          use -1 to skip reading the face data
   //! @return loaded face or NULL if file cannot be read or not valid DDS file
   Standard_EXPORT static Handle(Image_CompressedPixMap) Load (const Handle(Image_SupportedFormats)& theSupported,

src/Image/Image_VideoRecorder.hxx

@@ -85,8 +85,8 @@ public:
   Standard_EXPORT void Close();
 
   //! Open output stream - initialize recorder.
-  //! @param theFileName [in] video filename
+  //! @param[in] theFileName  video filename
-  //! @param theParams   [in] video parameters
+  //! @param[in] theParams    video parameters
   Standard_EXPORT Standard_Boolean Open (const char* theFileName,
                                          const Image_VideoParams& theParams);
 
@@ -109,8 +109,8 @@ protected:
   Standard_EXPORT TCollection_AsciiString formatAvError (const int theError) const;
 
   //! Append video stream.
-  //! theParams     [in] video parameters
+  //! theParams[in]      video parameters
-  //! theDefCodecId [in] identifier of codec managed by FFmpeg library (AVCodecID enum)
+  //! theDefCodecId[in]  identifier of codec managed by FFmpeg library (AVCodecID enum)
   Standard_EXPORT Standard_Boolean addVideoStream (const Image_VideoParams& theParams,
                                                    const Standard_Integer   theDefCodecId);
 

src/IntTools/IntTools_FaceFace.hxx

@@ -76,7 +76,7 @@ public:
   Standard_EXPORT Standard_Boolean TangentFaces() const;
 
   //! Provides post-processing the result lines.
-  //! @param bToSplit [in] split the closed 3D-curves on parts when TRUE,
+  //! @param[in] bToSplit  split the closed 3D-curves on parts when TRUE,
   //!                      remain untouched otherwise
   Standard_EXPORT void PrepareLines3D (const Standard_Boolean bToSplit = Standard_True);
 

src/Media/Media_PlayerContext.hxx

@@ -36,16 +36,16 @@ class Media_PlayerContext : public Standard_Transient
 public:
 
   //! Dump first video frame.
-  //! @param theSrcVideo [in] path to the video
+  //! @param[in] theSrcVideo  path to the video
-  //! @param theMediaInfo [out] video description
+  //! @param[out] theMediaInfo  video description
   Standard_EXPORT static Handle(Media_Frame) DumpFirstFrame (const TCollection_AsciiString& theSrcVideo,
                                                              TCollection_AsciiString& theMediaInfo);
 
   //! Dump first video frame.
-  //! @param theSrcVideo [in] path to the video
+  //! @param[in] theSrcVideo  path to the video
-  //! @param theOutImage [in] path to make a screenshot
+  //! @param[in] theOutImage  path to make a screenshot
-  //! @param theMediaInfo [out] video description
+  //! @param[out] theMediaInfo  video description
-  //! @param theMaxSize [in] when positive - downscales image to specified size
+  //! @param[in] theMaxSize  when positive - downscales image to specified size
   Standard_EXPORT static bool DumpFirstFrame (const TCollection_AsciiString& theSrcVideo,
                                               const TCollection_AsciiString& theOutImage,
                                               TCollection_AsciiString& theMediaInfo,

src/MeshVS/MeshVS_Mesh.hxx

@@ -183,9 +183,9 @@ friend class MeshVS_PrsBuilder;
 protected:
 
   //! Stores all vertices that belong to one of the faces to the given map
-  //! @param theAllElements [in] the map of all mesh elements
+  //! @param[in] theAllElements  the map of all mesh elements
-  //! @param theNbMaxFaceNodes [in] the maximum amount of nodes per face, retrieved from drawer
+  //! @param[in] theNbMaxFaceNodes  the maximum amount of nodes per face, retrieved from drawer
-  //! @param theSharedNodes [out] the result map of all vertices that belong to one face at least
+  //! @param[out] theSharedNodes  the result map of all vertices that belong to one face at least
   Standard_EXPORT void scanFacesForSharedNodes (const TColStd_PackedMapOfInteger& theAllElements,
                                                 const Standard_Integer theNbMaxFaceNodes,
                                                 TColStd_PackedMapOfInteger& theSharedNodes) const;

src/Message/Message.hxx

@@ -112,14 +112,14 @@ public:
   }
 
   //! Converts message metric to OSD memory info type.
-  //! @param theMetric [in] message metric
+  //! @param[in] theMetric  message metric
-  //! @param theMemInfo [out] filled memory info type
+  //! @param[out] theMemInfo  filled memory info type
   //! @return true if converted
   static Standard_EXPORT Standard_Boolean ToOSDMetric (const Message_MetricType theMetric, OSD_MemInfo::Counter& theMemInfo);
 
   //! Converts OSD memory info type to message metric.
   //! @param theMemInfo [int] memory info type
-  //! @param theMetric [out] filled message metric
+  //! @param[out] theMetric  filled message metric
   //! @return true if converted
   static Standard_EXPORT Standard_Boolean ToMessageMetric (const OSD_MemInfo::Counter theMemInfo, Message_MetricType& theMetric);
 

src/Message/Message_AttributeMeter.hxx

@@ -37,31 +37,31 @@ public:
   Standard_EXPORT Message_AttributeMeter (const TCollection_AsciiString& theName = TCollection_AsciiString());
 
   //! Checks whether the attribute has values for the metric
-  //! @param theMetric [in] metric type
+  //! @param[in] theMetric  metric type
   //! @return true if the metric values exist in the attribute
   Standard_EXPORT Standard_Boolean HasMetric (const Message_MetricType& theMetric) const;
 
   //! Returns true when both values of the metric are set.
-  //! @param theMetric [in] metric type
+  //! @param[in] theMetric  metric type
   //! @return true if metric values are valid
   Standard_EXPORT Standard_Boolean IsMetricValid (const Message_MetricType& theMetric) const;
 
   //! Returns start value for the metric
-  //! @param theMetric [in] metric type
+  //! @param[in] theMetric  metric type
   //! @return real value
   Standard_EXPORT Standard_Real StartValue (const Message_MetricType& theMetric) const;
 
   //! Sets start values for the metric
-  //! @param theMetric [in] metric type
+  //! @param[in] theMetric  metric type
   Standard_EXPORT void SetStartValue (const Message_MetricType& theMetric, const Standard_Real theValue);
 
   //! Returns stop value for the metric
-  //! @param theMetric [in] metric type
+  //! @param[in] theMetric  metric type
   //! @return real value
   Standard_EXPORT Standard_Real StopValue (const Message_MetricType& theMetric) const;
 
   //! Sets stop values for the metric
-  //! @param theMetric [in] metric type
+  //! @param[in] theMetric  metric type
   Standard_EXPORT void SetStopValue (const Message_MetricType& theMetric, const Standard_Real theValue);
 
 public:

src/Message/Message_LazyProgressScope.hxx

@@ -28,11 +28,11 @@ class Message_LazyProgressScope : protected Message_ProgressScope
 public:
 
   //! Main constructor.
-  //! @param theRange [in] progress range to scope
+  //! @param[in] theRange  progress range to scope
-  //! @param theName  [in] name of this scope
+  //! @param[in] theName   name of this scope
-  //! @param theMax   [in] number of steps within this scope
+  //! @param[in] theMax    number of steps within this scope
-  //! @param thePatchStep [in] number of steps to update progress
+  //! @param[in] thePatchStep  number of steps to update progress
-  //! @param theIsInf [in] infinite flag
+  //! @param[in] theIsInf  infinite flag
   Message_LazyProgressScope (const Message_ProgressRange& theRange,
                              const char* theName,
                              const Standard_Real theMax,

src/Message/Message_ProgressScope.hxx

@@ -217,10 +217,10 @@ public: //! @name Preparation methods
   //! The topmost scope is created and owned by Message_ProgressIndicator
   //! and its pointer is contained in the Message_ProgressRange returned by the Start() method of progress indicator.
   //!
-  //! @param theRange [in][out] range to fill (will be disarmed)
+  //! @param[in][out] theRange  range to fill (will be disarmed)
-  //! @param theName  [in]      new scope name
+  //! @param[in] theName        new scope name
-  //! @param theMax   [in]      number of steps in scope
+  //! @param[in] theMax         number of steps in scope
-  //! @param isInfinite [in]    infinite flag
+  //! @param[in] isInfinite     infinite flag
   Message_ProgressScope (const Message_ProgressRange& theRange,
                          const TCollection_AsciiString& theName,
                          Standard_Real theMax,
@@ -233,10 +233,10 @@ public: //! @name Preparation methods
   //! The topmost scope is created and owned by Message_ProgressIndicator
   //! and its pointer is contained in the Message_ProgressRange returned by the Start() method of progress indicator.
   //!
-  //! @param theRange [in][out] range to fill (will be disarmed)
+  //! @param[in][out] theRange  range to fill (will be disarmed)
-  //! @param theName  [in]      new scope name constant (will be stored by pointer with no deep copy)
+  //! @param[in] theName        new scope name constant (will be stored by pointer with no deep copy)
-  //! @param theMax   [in]      number of steps in scope
+  //! @param[in] theMax         number of steps in scope
-  //! @param isInfinite [in]    infinite flag
+  //! @param[in] isInfinite     infinite flag
   template<size_t N>
   Message_ProgressScope (const Message_ProgressRange& theRange,
                          const char (&theName)[N],
@@ -250,10 +250,10 @@ public: //! @name Preparation methods
   //! The topmost scope is created and owned by Message_ProgressIndicator
   //! and its pointer is contained in the Message_ProgressRange returned by the Start() method of progress indicator.
   //!
-  //! @param theRange [in][out] range to fill (will be disarmed)
+  //! @param[in][out] theRange  range to fill (will be disarmed)
-  //! @param theName  [in]      empty scope name (only NULL is accepted as argument)
+  //! @param[in] theName        empty scope name (only NULL is accepted as argument)
-  //! @param theMax   [in]      number of steps in scope
+  //! @param[in] theMax         number of steps in scope
-  //! @param isInfinite [in]    infinite flag
+  //! @param[in] isInfinite     infinite flag
   Message_ProgressScope (const Message_ProgressRange& theRange,
                          const NullString* theName,
                          Standard_Real theMax,

src/NCollection/NCollection_DoubleMap.hxx

@@ -408,8 +408,8 @@ public:
   }
 
   //! Find the Key1 and return Key2 value (by copying its value).
-  //! @param [in]  theKey1 Key1 to find
+  //! @param[in]   theKey1 Key1 to find
-  //! @param [out] theKey2 Key2 to return
+  //! @param[out]  theKey2 Key2 to return
   //! @return TRUE if Key1 has been found
   Standard_Boolean Find1 (const TheKey1Type& theKey1,
                           TheKey2Type& theKey2) const
@@ -423,7 +423,7 @@ public:
   }
 
   //! Find the Key1 and return pointer to Key2 or NULL if Key1 is not bound.
-  //! @param [in]  theKey1 Key1 to find
+  //! @param[in]   theKey1 Key1 to find
   //! @return pointer to Key2 or NULL if Key1 is not found
   const TheKey2Type* Seek1 (const TheKey1Type& theKey1) const
   {
@@ -450,8 +450,8 @@ public:
   }
 
   //! Find the Key2 and return Key1 value (by copying its value).
-  //! @param [in]  theKey2 Key2 to find
+  //! @param[in]   theKey2 Key2 to find
-  //! @param [out] theKey1 Key1 to return
+  //! @param[out]  theKey1 Key1 to return
   //! @return TRUE if Key2 has been found
   Standard_Boolean Find2 (const TheKey2Type& theKey2,
                           TheKey1Type& theKey1) const
@@ -465,7 +465,7 @@ public:
   }
 
   //! Find the Key2 and return pointer to Key1 or NULL if not bound.
-  //! @param [in] theKey2 Key2 to find
+  //! @param[in]  theKey2 Key2 to find
   //! @return pointer to Key1 if Key2 has been found
   const TheKey1Type* Seek2 (const TheKey2Type& theKey2) const
   {

src/NCollection/NCollection_Lerp.hxx

@@ -57,7 +57,7 @@ public:
   //! Compute interpolated value between two values.
   //! @param theT normalized interpolation coefficient within [0, 1] range,
   //!             with 0 pointing to first value and 1 to the second value.
-  //! @param theResult [out] interpolated value
+  //! @param[out] theResult  interpolated value
   void Interpolate (double theT, T& theResult) const
   {
     theResult = (1.0 - theT) * myStart + theT * myEnd;

src/NCollection/NCollection_Mat3.hxx

@@ -57,8 +57,8 @@ public:
   }
 
   //! Get element at the specified row and column.
-  //! @param theRow [in] the row.to address.
+  //! @param[in] theRow  the row.to address.
-  //! @param theCol [in] the column to address.
+  //! @param[in] theCol  the column to address.
   //! @return the value of the addressed element.
   Element_t GetValue (const size_t theRow, const size_t theCol) const
   {
@@ -66,8 +66,8 @@ public:
   }
 
   //! Access element at the specified row and column.
-  //! @param theRow [in] the row.to access.
+  //! @param[in] theRow  the row.to access.
-  //! @param theCol [in] the column to access.
+  //! @param[in] theCol  the column to access.
   //! @return reference on the matrix element.
   Element_t& ChangeValue (const size_t theRow, const size_t theCol)
   {
@@ -75,9 +75,9 @@ public:
   }
 
   //! Set value for the element specified by row and columns.
-  //! @param theRow   [in] the row to change.
+  //! @param[in] theRow    the row to change.
-  //! @param theCol   [in] the column to change.
+  //! @param[in] theCol    the column to change.
-  //! @param theValue [in] the value to set.s
+  //! @param[in] theValue  the value to set.s
   void SetValue (const size_t    theRow,
                  const size_t    theCol,
                  const Element_t theValue)
@@ -98,8 +98,8 @@ public:
   }
 
   //! Change first 3 row values by the passed vector.
-  //! @param theRow [in] the row to change.
+  //! @param[in] theRow  the row to change.
-  //! @param theVec [in] the vector of values.
+  //! @param[in] theVec  the vector of values.
   void SetRow (const size_t theRow, const NCollection_Vec3<Element_t>& theVec)
   {
     SetValue (theRow, 0, theVec.x());
@@ -114,8 +114,8 @@ public:
   }
 
   //! Change first 3 column values by the passed vector.
-  //! @param theCol [in] the column to change.
+  //! @param[in] theCol  the column to change.
-  //! @param theVec [in] the vector of values.
+  //! @param[in] theVec  the vector of values.
   void SetColumn (const size_t theCol,
                   const NCollection_Vec3<Element_t>& theVec)
   {
@@ -182,7 +182,7 @@ public:
   Element_t*       ChangeData()       { return myMat; }
 
   //! Multiply by the vector (M * V).
-  //! @param theVec [in] the vector to multiply.
+  //! @param[in] theVec  the vector to multiply.
   NCollection_Vec3<Element_t> operator* (const NCollection_Vec3<Element_t>& theVec) const
   {
     return NCollection_Vec3<Element_t> (
@@ -192,8 +192,8 @@ public:
   }
 
   //! Compute matrix multiplication product: A * B.
-  //! @param theMatA [in] the matrix "A".
+  //! @param[in] theMatA  the matrix "A".
-  //! @param theMatB [in] the matrix "B".
+  //! @param[in] theMatB  the matrix "B".
   static NCollection_Mat3 Multiply (const NCollection_Mat3& theMatA,
                                     const NCollection_Mat3& theMatB)
   {
@@ -214,14 +214,14 @@ public:
   }
 
   //! Compute matrix multiplication.
-  //! @param theMat [in] the matrix to multiply.
+  //! @param[in] theMat  the matrix to multiply.
   void Multiply (const NCollection_Mat3& theMat)
   {
     *this = Multiply(*this, theMat);
   }
 
   //! Multiply by the another matrix.
-  //! @param theMat [in] the other matrix.
+  //! @param[in] theMat  the other matrix.
   NCollection_Mat3& operator*= (const NCollection_Mat3& theMat)
   {
     Multiply (theMat);
@@ -229,7 +229,7 @@ public:
   }
 
   //! Compute matrix multiplication product.
-  //! @param theMat [in] the other matrix.
+  //! @param[in] theMat  the other matrix.
   //! @return result of multiplication.
   Standard_NODISCARD NCollection_Mat3 operator* (const NCollection_Mat3& theMat) const
   {
@@ -237,7 +237,7 @@ public:
   }
 
   //! Compute matrix multiplication product.
-  //! @param theMat [in] the other matrix.
+  //! @param[in] theMat  the other matrix.
   //! @return result of multiplication.
   Standard_NODISCARD NCollection_Mat3 Multiplied (const NCollection_Mat3& theMat) const
   {
@@ -247,7 +247,7 @@ public:
   }
 
   //! Compute per-component multiplication.
-  //! @param theFactor [in] the scale factor.
+  //! @param[in] theFactor  the scale factor.
   void Multiply (const Element_t theFactor)
   {
     for (size_t i = 0; i < 9; ++i)
@@ -257,7 +257,7 @@ public:
   }
 
   //! Compute per-element multiplication.
-  //! @param theFactor [in] the scale factor.
+  //! @param[in] theFactor  the scale factor.
   NCollection_Mat3& operator*= (const Element_t theFactor)
   {
     Multiply (theFactor);
@@ -265,7 +265,7 @@ public:
   }
 
   //! Compute per-element multiplication.
-  //! @param theFactor [in] the scale factor.
+  //! @param[in] theFactor  the scale factor.
   //! @return the result of multiplication.
   Standard_NODISCARD NCollection_Mat3 operator* (const Element_t theFactor) const
   {
@@ -273,7 +273,7 @@ public:
   }
 
   //! Compute per-element multiplication.
-  //! @param theFactor [in] the scale factor.
+  //! @param[in] theFactor  the scale factor.
   //! @return the result of multiplication.
   Standard_NODISCARD NCollection_Mat3 Multiplied (const Element_t theFactor) const
   {
@@ -283,7 +283,7 @@ public:
   }
 
   //! Compute per-component division.
-  //! @param theFactor [in] the scale factor.
+  //! @param[in] theFactor  the scale factor.
   void Divide (const Element_t theFactor)
   {
     for (size_t i = 0; i < 9; ++i)
@@ -293,7 +293,7 @@ public:
   }
 
   //! Per-component division.
-  //! @param theScalar [in] the scale factor.
+  //! @param[in] theScalar  the scale factor.
   NCollection_Mat3& operator/= (const Element_t theScalar)
   {
     Divide (theScalar);

src/NCollection/NCollection_Mat4.hxx

@@ -76,8 +76,8 @@ public:
   }
 
   //! Get element at the specified row and column.
-  //! @param theRow [in] the row to address.
+  //! @param[in] theRow  the row to address.
-  //! @param theCol [in] the column to address.
+  //! @param[in] theCol  the column to address.
   //! @return the value of the addressed element.
   Element_t GetValue (const size_t theRow, const size_t theCol) const
   {
@@ -85,8 +85,8 @@ public:
   }
 
   //! Access element at the specified row and column.
-  //! @param theRow [in] the row to access.
+  //! @param[in] theRow  the row to access.
-  //! @param theCol [in] the column to access.
+  //! @param[in] theCol  the column to access.
   //! @return reference on the matrix element.
   Element_t& ChangeValue (const size_t theRow, const size_t theCol)
   {
@@ -94,9 +94,9 @@ public:
   }
 
   //! Set value for the element specified by row and columns.
-  //! @param theRow   [in] the row to change.
+  //! @param[in] theRow    the row to change.
-  //! @param theCol   [in] the column to change.
+  //! @param[in] theCol    the column to change.
-  //! @param theValue [in] the value to set.
+  //! @param[in] theValue  the value to set.
   void SetValue (const size_t    theRow,
                  const size_t    theCol,
                  const Element_t theValue)
@@ -111,7 +111,7 @@ public:
   Element_t  operator() (const size_t theRow, const size_t theCol) const { return GetValue (theRow, theCol); }
 
   //! Get vector of elements for the specified row.
-  //! @param theRow [in] the row to access.
+  //! @param[in] theRow  the row to access.
   //! @return vector of elements.
   NCollection_Vec4<Element_t> GetRow (const size_t theRow) const
   {
@@ -122,8 +122,8 @@ public:
   }
 
   //! Change first 3 row values by the passed vector.
-  //! @param theRow [in] the row to change.
+  //! @param[in] theRow  the row to change.
-  //! @param theVec [in] the vector of values.
+  //! @param[in] theVec  the vector of values.
   void SetRow (const size_t theRow, const NCollection_Vec3<Element_t>& theVec)
   {
     SetValue (theRow, 0, theVec.x());
@@ -132,8 +132,8 @@ public:
   }
 
   //! Set row values by the passed 4 element vector.
-  //! @param theRow [in] the row to change.
+  //! @param[in] theRow  the row to change.
-  //! @param theVec [in] the vector of values.
+  //! @param[in] theVec  the vector of values.
   void SetRow (const size_t theRow, const NCollection_Vec4<Element_t>& theVec)
   {
     SetValue (theRow, 0, theVec.x());
@@ -143,7 +143,7 @@ public:
   }
 
   //! Get vector of elements for the specified column.
-  //! @param theCol [in] the column to access.
+  //! @param[in] theCol  the column to access.
   //! @return vector of elements.
   NCollection_Vec4<Element_t> GetColumn (const size_t theCol) const
   {
@@ -154,8 +154,8 @@ public:
   }
 
   //! Change first 3 column values by the passed vector.
-  //! @param theCol [in] the column to change.
+  //! @param[in] theCol  the column to change.
-  //! @param theVec [in] the vector of values.
+  //! @param[in] theVec  the vector of values.
   void SetColumn (const size_t theCol,
                   const NCollection_Vec3<Element_t>& theVec)
   {
@@ -165,8 +165,8 @@ public:
   }
 
   //! Set column values by the passed 4 element vector.
-  //! @param theCol [in] the column to change.
+  //! @param[in] theCol  the column to change.
-  //! @param theVec [in] the vector of values.
+  //! @param[in] theVec  the vector of values.
   void SetColumn (const size_t theCol,
                   const NCollection_Vec4<Element_t>& theVec)
   {
@@ -196,7 +196,7 @@ public:
   }
 
   //! Set diagonal elements of the matrix by the passed vector.
-  //! @param theVec [in] the vector of values.
+  //! @param[in] theVec  the vector of values.
   void SetDiagonal (const NCollection_Vec4<Element_t>& theVec)
   {
     SetValue (0, 0, theVec.x());
@@ -257,7 +257,7 @@ public:
   Element_t*       ChangeData()       { return myMat; }
 
   //! Multiply by the vector (M * V).
-  //! @param theVec [in] the vector to multiply.
+  //! @param[in] theVec  the vector to multiply.
   NCollection_Vec4<Element_t> operator* (const NCollection_Vec4<Element_t>& theVec) const
   {
     return NCollection_Vec4<Element_t> (
@@ -268,8 +268,8 @@ public:
   }
 
   //! Compute matrix multiplication product: A * B.
-  //! @param theMatA [in] the matrix "A".
+  //! @param[in] theMatA  the matrix "A".
-  //! @param theMatB [in] the matrix "B".
+  //! @param[in] theMatB  the matrix "B".
   static NCollection_Mat4 Multiply (const NCollection_Mat4& theMatA,
                                     const NCollection_Mat4& theMatB)
   {
@@ -290,14 +290,14 @@ public:
   }
 
   //! Compute matrix multiplication.
-  //! @param theMat [in] the matrix to multiply.
+  //! @param[in] theMat  the matrix to multiply.
   void Multiply (const NCollection_Mat4& theMat)
   {
     *this = Multiply(*this, theMat);
   }
 
   //! Multiply by the another matrix.
-  //! @param theMat [in] the other matrix.
+  //! @param[in] theMat  the other matrix.
   NCollection_Mat4& operator*= (const NCollection_Mat4& theMat)
   {
     Multiply (theMat);
@@ -305,7 +305,7 @@ public:
   }
 
   //! Compute matrix multiplication product.
-  //! @param theMat [in] the other matrix.
+  //! @param[in] theMat  the other matrix.
   //! @return result of multiplication.
   Standard_NODISCARD NCollection_Mat4 operator* (const NCollection_Mat4& theMat) const
   {
@@ -313,7 +313,7 @@ public:
   }
 
   //! Compute matrix multiplication product.
-  //! @param theMat [in] the other matrix.
+  //! @param[in] theMat  the other matrix.
   //! @return result of multiplication.
   Standard_NODISCARD NCollection_Mat4 Multiplied (const NCollection_Mat4& theMat) const
   {
@@ -323,7 +323,7 @@ public:
   }
 
   //! Compute per-component multiplication.
-  //! @param theFactor [in] the scale factor.
+  //! @param[in] theFactor  the scale factor.
   void Multiply (const Element_t theFactor)
   {
     for (size_t i = 0; i < 16; ++i)
@@ -333,7 +333,7 @@ public:
   }
 
   //! Compute per-element multiplication.
-  //! @param theFactor [in] the scale factor.
+  //! @param[in] theFactor  the scale factor.
   NCollection_Mat4& operator*= (const Element_t theFactor)
   {
     Multiply (theFactor);
@@ -341,7 +341,7 @@ public:
   }
 
   //! Compute per-element multiplication.
-  //! @param theFactor [in] the scale factor.
+  //! @param[in] theFactor  the scale factor.
   //! @return the result of multiplication.
   Standard_NODISCARD NCollection_Mat4 operator* (const Element_t theFactor) const
   {
@@ -349,7 +349,7 @@ public:
   }
 
   //! Compute per-element multiplication.
-  //! @param theFactor [in] the scale factor.
+  //! @param[in] theFactor  the scale factor.
   //! @return the result of multiplication.
   Standard_NODISCARD NCollection_Mat4 Multiplied (const Element_t theFactor) const
   {
@@ -359,7 +359,7 @@ public:
   }
 
   //! Compute per-component division.
-  //! @param theFactor [in] the scale factor.
+  //! @param[in] theFactor  the scale factor.
   void Divide (const Element_t theFactor)
   {
     for (size_t i = 0; i < 16; ++i)
@@ -369,7 +369,7 @@ public:
   }
 
   //! Per-component division.
-  //! @param theScalar [in] the scale factor.
+  //! @param[in] theScalar  the scale factor.
   NCollection_Mat4& operator/= (const Element_t theScalar)
   {
     Divide (theScalar);
@@ -459,7 +459,7 @@ public:
   Standard_NODISCARD NCollection_Mat4 operator-() const { return Negated(); }
 
   //! Translate the matrix on the passed vector.
-  //! @param theVec [in] the translation vector.
+  //! @param[in] theVec  the translation vector.
   void Translate (const NCollection_Vec3<Element_t>& theVec)
   {
     NCollection_Mat4 aTempMat;
@@ -486,8 +486,8 @@ public:
   }
 
   //! Compute inverted matrix.
-  //! @param theOutMx [out] the inverted matrix
+  //! @param[out] theOutMx  the inverted matrix
-  //! @param theDet   [out] determinant of matrix
+  //! @param[out] theDet    determinant of matrix
   //! @return true if reversion success
   bool Inverted (NCollection_Mat4<Element_t>& theOutMx, Element_t& theDet) const
   {
@@ -578,7 +578,7 @@ public:
   }
 
   //! Compute inverted matrix.
-  //! @param theOutMx [out] the inverted matrix
+  //! @param[out] theOutMx  the inverted matrix
   //! @return true if reversion success
   bool Inverted (NCollection_Mat4<Element_t>& theOutMx) const
   {

src/OSD/OSD_FileSystem.hxx

@@ -50,11 +50,11 @@ public:
 
   //! Opens stream for specified file URL for reading operations (std::istream).
   //! Default implementation create a stream from file buffer returned by OSD_FileSystem::OpenFileBuffer().
-  //! @param theUrl       [in] path to open
+  //! @param[in] theUrl        path to open
-  //! @param theMode      [in] flags describing the requested input mode for the stream (std::ios_base::in will be implicitly added)
+  //! @param[in] theMode       flags describing the requested input mode for the stream (std::ios_base::in will be implicitly added)
-  //! @param theOffset    [in] expected stream position from the beginning of the file (beginning of the stream by default);
+  //! @param[in] theOffset     expected stream position from the beginning of the file (beginning of the stream by default);
   //!                          -1 would keep seek position undefined (in case of re-using theOldStream)
-  //! @param theOldStream [in] a pointer to existing stream pointing to theUrl to be reused (without re-opening)
+  //! @param[in] theOldStream  a pointer to existing stream pointing to theUrl to be reused (without re-opening)
   //! @return pointer to newly created opened stream, to theOldStream if it can be reused or NULL in case of failure.
   Standard_EXPORT virtual std::shared_ptr<std::istream> OpenIStream
                           (const TCollection_AsciiString& theUrl,
@@ -64,17 +64,17 @@ public:
 
   //! Opens stream for specified file URL for writing operations (std::ostream).
   //! Default implementation create a stream from file buffer returned by OSD_FileSystem::OpenFileBuffer().
-  //! @param theUrl       [in] path to open
+  //! @param[in] theUrl        path to open
-  //! @param theMode      [in] flags describing the requested output mode for the stream (std::ios_base::out will be implicitly added)
+  //! @param[in] theMode       flags describing the requested output mode for the stream (std::ios_base::out will be implicitly added)
   //! @return pointer to newly created opened stream or NULL in case of failure.
   Standard_EXPORT virtual std::shared_ptr<std::ostream> OpenOStream (const TCollection_AsciiString& theUrl,
                                                                      const std::ios_base::openmode theMode);
 
   //! Opens stream buffer for specified file URL.
-  //! @param theUrl        [in]  path to open
+  //! @param[in] theUrl          path to open
-  //! @param theMode       [in]  flags describing the requested input mode for the stream
+  //! @param[in] theMode         flags describing the requested input mode for the stream
-  //! @param theOffset     [in]  expected stream position from the beginning of the buffer (beginning of the stream buffer by default)
+  //! @param[in] theOffset       expected stream position from the beginning of the buffer (beginning of the stream buffer by default)
-  //! @param theOutBufSize [out] total buffer size (only if buffer is opened for read)
+  //! @param[out] theOutBufSize  total buffer size (only if buffer is opened for read)
   //! @return pointer to newly created opened stream buffer or NULL in case of failure.
   virtual std::shared_ptr<std::streambuf> OpenStreamBuffer (const TCollection_AsciiString& theUrl,
                                                             const std::ios_base::openmode theMode,

src/OSD/OSD_FileSystemSelector.hxx

@@ -28,8 +28,8 @@ public:
   OSD_FileSystemSelector() {}
 
   //! Registers file system within this selector.
-  //! @param theFileSystem  [in] file system to register
+  //! @param[in] theFileSystem   file system to register
-  //! @param theIsPreferred [in] add to the beginning of the list when TRUE, or add to the end otherwise
+  //! @param[in] theIsPreferred  add to the beginning of the list when TRUE, or add to the end otherwise
   Standard_EXPORT void AddProtocol (const Handle(OSD_FileSystem)& theFileSystem, bool theIsPreferred = false);
 
   //! Unregisters file system within this selector.