]> SALOME platform Git repositories - modules/geom.git/commitdiff
Salome HOME
More corrections jfa/Devdocs
authorjfa <jfa@opencascade.com>
Wed, 7 Jul 2021 19:09:19 +0000 (22:09 +0300)
committerjfa <jfa@opencascade.com>
Thu, 26 Aug 2021 12:40:39 +0000 (15:40 +0300)
src/CurveCreator/CurveCreator_Curve.hxx
src/EntityGUI/EntityGUI_PolylineDlg.h
src/GEOMGUI/GEOMGUI_AnnotationAttrs.h
src/GEOMGUI/GEOMGUI_TextTreeSelector.cxx
src/GEOMImpl/GEOMImpl_IBaseIEOperations.cxx
src/GEOMImpl/GEOMImpl_IBaseIEOperations.hxx
src/GEOMImpl/GEOMImpl_IShapesOperations.cxx
src/GEOMImpl/GEOMImpl_IShapesOperations.hxx
src/OBJECT/GEOM_Annotation.hxx

index 54e1d1918b9cbc241f69b8bd088ef99d55c59800..b3f48ff811ff7263405217beeca12eb6f24ea3c6 100644 (file)
@@ -77,7 +77,7 @@ public:
   //! Remove curve creator Displayer object
   virtual void removeDisplayer();
 
-  /** Set depth of undo operations (unlimited if \a theDepth is -1
+  /** Set depth of undo operations (unlimited if \a theDepth is '-1'
    *  or disabled if \a theDepth is 0)
    */
   virtual void setUndoDepth(const int theDepth = -1);
@@ -189,7 +189,7 @@ public:
                                   const bool theIsClosed );
   /**
    *  Set "closed" flag of the specified section (all sections if
-   *  \a theISection is -1).
+   *  \a theISection is '-1').
    */
   virtual bool setClosed( const int theISection,
                           const bool theIsClosed );
@@ -225,7 +225,7 @@ public:
                                        const CurveCreator::SectionType theType );
   /**
    *  Set type of the specified section (or all sections
-   *  if \a theISection is -1).
+   *  if \a theISection is '-1').
    */
   virtual bool setSectionType( const int theISection,
                                const CurveCreator::SectionType theType );
@@ -254,7 +254,7 @@ public:
   virtual bool addPointsInternal( const CurveCreator::SectionsMap &theSectionsMap );
   /**
    *  Add one point to the specified section starting from the given theIPnt index
-   *  (or at the end of points if \a theIPnt is -1).
+   *  (or at the end of points if \a theIPnt is '-1').
    */
   virtual bool addPoints( const CurveCreator::Coordinates &theCoords,
                           const int theISection,
@@ -284,7 +284,7 @@ public:
                                               const int theIPnt ) const;
 
   /**
-   * Get points of a section (the total points in Curve if theISection is equal to -1)..
+   * Get points of a section (the total points in Curve if theISection is equal to "-1")..
    */
   virtual Handle(TColgp_HArray1OfPnt) GetDifferentPoints( int theISection = -1 ) const;
 
@@ -293,7 +293,7 @@ public:
 
   /**
    *  Get number of points in specified section or (the total number of points
-   *  in Curve if theISection is equal to -1).
+   *  in Curve if theISection is equal to '-1').
    */
   virtual int getNbPoints( const int theISection ) const;
 
index c4f6dde0d3a0ab238c81c7cc98fdc75a99197a17..62c9231477347854a7fc3145148a0ee65d7c4bc3 100644 (file)
@@ -85,16 +85,15 @@ private:
    * construct an object using the interface
    * GEOM_ICurvesOperations::MakePolyline2DOnPlane.
    *
-   * \param theCurve a curve object, that contains data.
-   *  \param theCoordsList the list of coordinates list. theCoordsList[0]
-   *         is the coordinates list of the first section. theCoordsList[1]
-   *         is for the second section etc. Output parameter.
-   *  \param theNamesList the list of names. The order corresponds to
-   *         theCoordsList. Output parameter.
-   *  \param theTypesList the list of curve types. The order corresponds to
-   *         theCoordsList. Output parameter.
-   *  \param theClosedList the list of Closed flags. The order corresponds to
-   *         theCoordsList. Output parameter.
+   *  \param theCoords [out] the list of coordinates list.
+   *         theCoords[0] is the coordinates list of the first section.
+   *         theCoords[1] is for the second section etc.
+   *  \param theNames [out] the list of names. The order corresponds to
+   *         theCoords list.
+   *  \param theTypes [out] the list of curve types. The order corresponds to
+   *         theCoords list.
+   *  \param theCloseds [out] the list of Closed flags. The order corresponds to
+   *         theCoords list.
    */
   void GetCurveParams(GEOM::ListOfListOfDouble &theCoords,
                       GEOM::string_array       &theNames,
index 2a617080e3fe2476868293c8b159df353e88ca81..c80c18f2939adb644fe91ae1564c6f3fcf70516c 100644 (file)
@@ -107,7 +107,7 @@ public:
   //! Changes count of annotation definitions stored on the object.
   //! If the count is decreased the extra annotation definitions are
   //! cleared out from the attribute.
-  //! @param theNumber [in] the new number of annotation definitions.
+  //! @param theCount [in] the new number of annotation definitions.
   GEOMGUI_EXPORT void SetNbAnnotation( const int theCount ) const;
 
   //! Returns number of annotation definitions stored on the object.
@@ -170,6 +170,7 @@ public:
 
   //! Appends new annotation definition with the given properties and converts
   //! position and attachment points to the given shape's local frame of reference.
+  //! @param theProps [in] the properties
   //! @param theShapeLCS [in] the position of shape's local frame of reference with respect
   //!        to the world frame of reference.
   GEOMGUI_EXPORT void Append( const Properties& theProps, const gp_Ax3& theShapeLCS );
index 2c0bb54eb629ccc57742e4715dd46188d3d5370b..a8f0cf7086ad84842cae066cf13e665f25670044 100644 (file)
@@ -41,7 +41,8 @@
 
 /*!
   \brief Constructor.
-  \param widget text tree widget
+  \param theWidget text tree widget
+  \param theAnnotationMgr annotation manager
   \param theManager selection manager
 */
 GEOMGUI_TextTreeSelector::GEOMGUI_TextTreeSelector( GEOMGUI_TextTreeWdg* theWidget,
index bf90e6b1282b16504126f597b51f3a6ad07d4c3f..33dc46b8e0f6696f822b36b6c54ce4357870565b 100644 (file)
@@ -62,7 +62,8 @@ GEOMImpl_IBaseIEOperations::~GEOMImpl_IBaseIEOperations()
 //=============================================================================
 /*!
  *  This method creates material groups for an imported object.
- *  \param theObject the imported object.
+ *  \param theObject [in] the imported object.
+ *  \param theSeq [out] the sequence of created groups.
  */
 //=============================================================================
 void GEOMImpl_IBaseIEOperations::MakeMaterialGroups
index bd7d2dc245ac5f0f5e8d804179fb9006272eda59..bacee1ab847eb7e999dcf4ebeeb6a614ea4369d0 100644 (file)
@@ -37,7 +37,8 @@ public:
   Standard_EXPORT ~GEOMImpl_IBaseIEOperations();
   
 protected:
-  Standard_EXPORT void MakeMaterialGroups(const Handle(GEOM_Object)                  &theObject,
+  Standard_EXPORT void MakeMaterialGroups
+                         (const Handle(GEOM_Object)                  &theObject,
                           const Handle(TColStd_HSequenceOfTransient) &theSeq);
 
   Handle(GEOM_Object) MakeGroup
index bb62739658fef468f088b5032774188ee0af071c..02551aebead9d45b8c8cb80e31a3b36dbf81fcef 100644 (file)
@@ -2573,20 +2573,20 @@ Handle(Geom_Surface) GEOMImpl_IShapesOperations::makePlane(const TopoDS_Shape& t
 //function : makeCylinder
   /*!
    * \brief Creates Geom_CylindricalSurface
-    * \param anAxis - edge defining cylinder axis
+    * \param theAxis - edge defining cylinder axis
     * \param theRadius - cylinder radius
     * \retval Handle(Geom_Surface) - resulting surface
    */
 //=======================================================================
-Handle(Geom_Surface) GEOMImpl_IShapesOperations::makeCylinder(const TopoDS_Shape& anAxis,
+Handle(Geom_Surface) GEOMImpl_IShapesOperations::makeCylinder(const TopoDS_Shape& theAxis,
                                                               const Standard_Real theRadius)
 {
   //Axis of the cylinder
-  if (anAxis.ShapeType() != TopAbs_EDGE) {
+  if (theAxis.ShapeType() != TopAbs_EDGE) {
     SetErrorCode("Not an edge given for the axis");
     return NULL;
   }
-  TopoDS_Edge anEdge = TopoDS::Edge(anAxis);
+  TopoDS_Edge anEdge = TopoDS::Edge(theAxis);
   TopoDS_Vertex V1, V2;
   TopExp::Vertices(anEdge, V1, V2, Standard_True);
   if (V1.IsNull() || V2.IsNull()) {
index 6702b466b07f14f574e8b5ba4aae07b268fdd2da..6e70f5cb1abb61ffa14ec0a77c3ac514b8a77f71 100644 (file)
@@ -535,11 +535,11 @@ class GEOMImpl_IShapesOperations : public GEOM_IOperations
 
   /*!
    * \brief Creates Geom_CylindricalSurface
-   * \param theAx1 - edge defining cylinder axis
+   * \param theAxis - edge defining cylinder axis
    * \param theRadius - cylinder radius
    * \retval Handle(Geom_Surface) - resulting surface
    */
-  Handle(Geom_Surface) makeCylinder(const TopoDS_Shape& theAx1,
+  Handle(Geom_Surface) makeCylinder(const TopoDS_Shape& theAxis,
                                     const Standard_Real theRadius);
 
   /*!
index 63ea6f12599eed20a2b4d93e84671ea541b87b0b..46719865d4458c74916bdfbcb54d68bd10bb6d06 100644 (file)
@@ -370,8 +370,8 @@ public:
         myShape( theShape ) {}
 
     //! Perform highlighting of the presentation.
-    //! \param thePresentationMgr [in] the presentation manager.
-    //! \param theColor [in] the highlighting color.
+    //! \param thePM [in] the presentation manager.
+    //! \param theStyle [in] the highlighting style.
     //! \param theMode [in] the display mode.
     virtual void
       HilightWithColor( const Handle(PrsMgr_PresentationManager3d)& thePM,