Add documentation for C++HighAPI

diff --git a/doc/tui/Modules.doc b/doc/tui/Modules.doc
index 71060e595a7be054a67c4a1d413bdfe22c8a02b1..4c6f43c2c71b9c4c1f8c45b52d8b355410ef2119 100644 (file)
--- a/doc/tui/Modules.doc
+++ b/doc/tui/Modules.doc
@@ -35,6 +35,15 @@
  *
  */
  
+/**
+ * \defgroup CPPHighAPI C++ High API
+ *
+ * \brief C++ API for using fetures concentrated in plugins.
+ *
+ * The API intendend to be wrapped by SWIG and used in Python.
+ *
+ */
+
  /**
  * \defgroup Config Config 
  *
@@ -87,4 +96,3 @@
  * (like in ExchangePlugin_ImportFormatValidator).
  *
  */
-

diff --git a/src/ConstructionAPI/ConstructionAPI_Point.h b/src/ConstructionAPI/ConstructionAPI_Point.h
index 8f0a1943b2a3c1d7b9d130ba8aa9c99efd47f514..0612227e753bca80f76e67a154aaac00d7a8f04a 100644 (file)
--- a/src/ConstructionAPI/ConstructionAPI_Point.h
+++ b/src/ConstructionAPI/ConstructionAPI_Point.h
@@ -16,25 +16,33 @@ class ModelAPI_AttributeDouble;
 class ModelAPI_Document;
 class ModelHighAPI_Double;
 //--------------------------------------------------------------------------------------
-/*
- *
+/**\class ConstructionAPI_Point
+ * \ingroup CPPHighAPI
+ * \brief C++ HighAPI interface for Point feature
  */
 class ConstructionAPI_Point : public ModelHighAPI_Interface
 {
 public:
-  ConstructionAPI_Point(const std::shared_ptr<ModelAPI_Feature> & theFeature);
+  /// Constructor
+  explicit ConstructionAPI_Point(const std::shared_ptr<ModelAPI_Feature> & theFeature);
+  /// Constructor with values
   ConstructionAPI_Point(const std::shared_ptr<ModelAPI_Feature> & theFeature,
                         const ModelHighAPI_Double & theX,
                         const ModelHighAPI_Double & theY,
                         const ModelHighAPI_Double & theZ);
+  /// Destructor
   virtual ~ConstructionAPI_Point();
 
+  /// Set point values
   void setPoint(const ModelHighAPI_Double & theX,
                 const ModelHighAPI_Double & theY,
                 const ModelHighAPI_Double & theZ);
 
+  /// X coordinate for the point
   std::shared_ptr<ModelAPI_AttributeDouble> x() const;
+  /// Y coordinate for the point
   std::shared_ptr<ModelAPI_AttributeDouble> y() const;
+  /// Z coordinate for the point
   std::shared_ptr<ModelAPI_AttributeDouble> z() const;
 
 protected:
@@ -46,6 +54,9 @@ protected:
 //! Pointer on point object
 typedef std::shared_ptr<ConstructionAPI_Point> PointPtr;
 
+/**\ingroup CPPHighAPI
+ * \brief C++ HighAPI function for creating Point feature
+ */
 PointPtr addPoint(std::shared_ptr<ModelAPI_Document> thePart,
                   const ModelHighAPI_Double & theX,
                   const ModelHighAPI_Double & theY,

diff --git a/src/ModelHighAPI/ModelHighAPI_Interface.h b/src/ModelHighAPI/ModelHighAPI_Interface.h
index 111cbf4567987d684c0f75e277faaa7369625e0f..4393b480736d1da945131d5d0f29a729855f73bd 100644 (file)
--- a/src/ModelHighAPI/ModelHighAPI_Interface.h
+++ b/src/ModelHighAPI/ModelHighAPI_Interface.h
@@ -13,13 +13,16 @@
 //--------------------------------------------------------------------------------------
 class ModelAPI_Feature;
 //--------------------------------------------------------------------------------------
-/*
- *
+/**\class ModelHighAPI_Interface
+ * \ingroup CPPHighAPI
+ * \brief Base class for feature interfaces
  */
 class ModelHighAPI_Interface
 {
 public:
+  /// Constructor
   explicit ModelHighAPI_Interface(const std::shared_ptr<ModelAPI_Feature> & theFeature);
+  /// Destructor
   virtual ~ModelHighAPI_Interface();
 
   /// Return ModelAPI_Feature
@@ -28,7 +31,7 @@ public:
   /// Shortcut for feature()->execute()
   void execute();
 
-  /// Throw exception to event loop.
+  /// Throw exception to event loop
   void throwException(const std::string & theDescription);
 
 protected: