mtapi_cpp: improved doxygen documentation

mtapi_cpp/include/embb/mtapi/action.h

@@ -50,11 +50,23 @@ class Action {
     handle_.tag = 0;
     handle_.tag = 0;
   }
   }
 
 
-  Action(Action const & other) : handle_(other.handle_) {
+  /**
+   * Copies an Action.
+   */
+  Action(
+    Action const & other               /**< Action to copy */
+    ) : handle_(other.handle_) {
     // empty
     // empty
   }
   }
 
 
-  Action & operator=(Action const & other) {
+  /**
+   * Copies an Action.
+   *
+   * \returns Reference to this object.
+   */
+  Action & operator=(
+    Action const & other               /**< Action to copy */
+    ) {
     handle_ = other.handle_;
     handle_ = other.handle_;
     return *this;
     return *this;
   }
   }

mtapi_cpp/include/embb/mtapi/group.h

@@ -51,11 +51,23 @@ namespace mtapi {
  */
  */
 class Group {
 class Group {
  public:
  public:
-  Group(Group const & other) : handle_(other.handle_) {
+  /**
+   * Copies a Group.
+   */
+  Group(
+    Group const & other                /**< Group to copy */
+    ) : handle_(other.handle_) {
     // empty
     // empty
   }
   }
 
 
-  Group & operator=(Group const & other) {
+  /**
+   * Copies a Group.
+   *
+   * \returns Reference to this object.
+   */
+  Group & operator=(
+    Group const & other                /**< Group to copy */
+    ) {
     handle_ = other.handle_;
     handle_ = other.handle_;
     return *this;
     return *this;
   }
   }

mtapi_cpp/include/embb/mtapi/node.h

@@ -68,6 +68,9 @@ namespace mtapi {
  */
  */
 class Node {
 class Node {
  public:
  public:
+  /**
+   * Function type for simple SMP interface.
+   */
   typedef embb::base::Function<void, TaskContext &> SMPFunction;
   typedef embb::base::Function<void, TaskContext &> SMPFunction;
 
 
   /**
   /**
@@ -285,16 +288,33 @@ class Node {
       MTAPI_DEFAULT_TASK_ATTRIBUTES);
       MTAPI_DEFAULT_TASK_ATTRIBUTES);
   }
   }
 
 
-  Job GetJob(mtapi_job_id_t job_id) {
+  /**
+   * Get the job with the given id in the domain of the node.
+   *
+   * \returns The handle for the requested Job.
+   */
+  Job GetJob(
+    mtapi_job_id_t job_id              /**< ID of the job to return */
+    ) {
     return Job(job_id, domain_id_);
     return Job(job_id, domain_id_);
   }
   }
 
 
-  Job GetJob(mtapi_job_id_t job_id, mtapi_domain_t domain_id) {
+  /**
+   * Get the job with the given id in the specified domain.
+   *
+   * \returns The handle for the requested Job.
+   */
+  Job GetJob(
+    mtapi_job_id_t job_id,             /**< ID of the job to return */
+    mtapi_domain_t domain_id           /**< Domain to get the job from */
+    ) {
     return Job(job_id, domain_id);
     return Job(job_id, domain_id);
   }
   }
 
 
   /**
   /**
    * Constructs an Action.
    * Constructs an Action.
+   *
+   * \returns The handle for the new Action.
    */
    */
   Action CreateAction(
   Action CreateAction(
     mtapi_job_id_t job_id,             /**< Job ID the Action belongs to */
     mtapi_job_id_t job_id,             /**< Job ID the Action belongs to */
@@ -311,6 +331,8 @@ class Node {
 
 
   /**
   /**
    * Constructs an Action.
    * Constructs an Action.
+   *
+   * \returns The handle for the new Action.
    */
    */
   Action CreateAction(
   Action CreateAction(
     mtapi_job_id_t job_id,             /**< Job ID the Action belongs to */
     mtapi_job_id_t job_id,             /**< Job ID the Action belongs to */
@@ -325,6 +347,8 @@ class Node {
 
 
   /**
   /**
    * Constructs an Action.
    * Constructs an Action.
+   *
+   * \returns The handle for the new Action.
    */
    */
   Action CreateAction(
   Action CreateAction(
     mtapi_job_id_t job_id,             /**< Job ID the Action belongs to */
     mtapi_job_id_t job_id,             /**< Job ID the Action belongs to */
@@ -337,6 +361,8 @@ class Node {
 
 
   /**
   /**
    * Constructs an Action.
    * Constructs an Action.
+   *
+   * \returns The handle for the new Action.
    */
    */
   Action CreateAction(
   Action CreateAction(
     mtapi_job_id_t job_id,             /**< Job ID the Action belongs to */
     mtapi_job_id_t job_id,             /**< Job ID the Action belongs to */
@@ -347,6 +373,8 @@ class Node {
 
 
   /**
   /**
    * Constructs a Group object with default attributes.
    * Constructs a Group object with default attributes.
+   *
+   * \returns The handle for the new Group.
    */
    */
   Group CreateGroup() {
   Group CreateGroup() {
     return Group(MTAPI_GROUP_ID_NONE, MTAPI_DEFAULT_GROUP_ATTRIBUTES);
     return Group(MTAPI_GROUP_ID_NONE, MTAPI_DEFAULT_GROUP_ATTRIBUTES);
@@ -354,6 +382,8 @@ class Node {
 
 
   /**
   /**
    * Constructs a Group object with default attributes and the given ID.
    * Constructs a Group object with default attributes and the given ID.
+   *
+   * \returns The handle for the new Group.
    */
    */
   Group CreateGroup(
   Group CreateGroup(
     mtapi_group_id_t id                /**< A user defined ID of the Group. */
     mtapi_group_id_t id                /**< A user defined ID of the Group. */
@@ -363,14 +393,19 @@ class Node {
 
 
   /**
   /**
    * Constructs a Group object using the given Attributes.
    * Constructs a Group object using the given Attributes.
+   *
+   * \returns The handle for the new Group.
    */
    */
   Group CreateGroup(
   Group CreateGroup(
-    GroupAttributes const & group_attr) {
+    GroupAttributes const & group_attr /**< Attributes for the Group. */
+    ) {
     return Group(MTAPI_GROUP_ID_NONE, &group_attr.GetInternal());
     return Group(MTAPI_GROUP_ID_NONE, &group_attr.GetInternal());
   }
   }
 
 
   /**
   /**
    * Constructs a Group object with given attributes and ID.
    * Constructs a Group object with given attributes and ID.
+   *
+   * \returns The handle for the new Group.
    */
    */
   Group CreateGroup(
   Group CreateGroup(
     mtapi_group_id_t id,               /**< A user defined ID of the Group. */
     mtapi_group_id_t id,               /**< A user defined ID of the Group. */
@@ -381,6 +416,8 @@ class Node {
 
 
   /**
   /**
    * Constructs a Queue with the given Job and default attributes.
    * Constructs a Queue with the given Job and default attributes.
+   *
+   * \returns The handle for the new Queue.
    */
    */
   Queue CreateQueue(
   Queue CreateQueue(
     Job & job                          /**< The Job to use for the Queue. */
     Job & job                          /**< The Job to use for the Queue. */
@@ -390,6 +427,8 @@ class Node {
 
 
   /**
   /**
    * Constructs a Queue with the given Job and QueueAttributes.
    * Constructs a Queue with the given Job and QueueAttributes.
+   *
+   * \returns The handle for the new Queue.
    */
    */
   Queue CreateQueue(
   Queue CreateQueue(
     Job const & job,                   /**< The Job to use for the Queue. */
     Job const & job,                   /**< The Job to use for the Queue. */

mtapi_cpp/include/embb/mtapi/queue.h

@@ -51,11 +51,23 @@ namespace mtapi {
  */
  */
 class Queue {
 class Queue {
  public:
  public:
-  Queue(Queue const & other) : handle_(other.handle_) {
+  /**
+   * Copies a Queue.
+   */
+  Queue(
+    Queue const & other                /**< The Queue to copy */
+    ) : handle_(other.handle_) {
     // empty
     // empty
   }
   }
 
 
-  Queue & operator=(Queue const & other) {
+  /**
+   * Copies a Queue.
+   *
+   * \returns Reference to this object.
+   */
+  Queue & operator=(
+    Queue const & other                /**< The Queue to copy */
+    ) {
     handle_ = other.handle_;
     handle_ = other.handle_;
     return *this;
     return *this;
   }
   }

mtapi_cpp/include/embb/mtapi/task_attributes.h

@@ -103,8 +103,15 @@ class TaskAttributes {
     return *this;
     return *this;
   }
   }
 
 
+  /**
+   * Sets the ExecutionPolicy of a Task.
+   * The policy influences the priority and affinity of a Task.
+   *
+   * \returns Reference to this object.
+   * \notthreadsafe
+   */
   TaskAttributes & SetPolicy(
   TaskAttributes & SetPolicy(
-    ExecutionPolicy const & policy
+    ExecutionPolicy const & policy     /**< The policy to set. */
     ) {
     ) {
     SetPriority(policy.GetPriority());
     SetPriority(policy.GetPriority());
     SetAffinity(policy.GetAffinity());
     SetAffinity(policy.GetAffinity());