Added Doxygen comments for OCStackApplicationResult
authorBill Dieter <william.r.dieter@intel.com>
Tue, 5 Apr 2016 00:53:22 +0000 (00:53 +0000)
committerUze Choi <uzchoi@samsung.com>
Wed, 6 Apr 2016 10:00:42 +0000 (10:00 +0000)
Change-Id: I43d68ac38edc6cdc830ea0ea4daa6df38420e2f3
Signed-off-by: Bill Dieter <william.r.dieter@intel.com>
Reviewed-on: https://gerrit.iotivity.org/gerrit/7621
Tested-by: jenkins-iotivity <jenkins-iotivity@opendaylight.org>
Reviewed-by: Uze Choi <uzchoi@samsung.com>
resource/csdk/stack/include/octypes.h

index 1eb0525..f64cc9b 100644 (file)
@@ -1351,11 +1351,16 @@ typedef enum
 } OCEntityHandlerFlag;
 
 /**
- * Possible returned values from client application.
+ * Possible return values from client application callback
+ *
+ * A client application callback returns an OCStackApplicationResult to indicate whether
+ * the stack should continue to keep the callback registered.
  */
 typedef enum
 {
+    /** Make no more calls to the callback and call the OCClientContextDeleter for this callback */
     OC_STACK_DELETE_TRANSACTION = 0,
+    /** Keep this callback registered and call it if an apropriate event occurs */
     OC_STACK_KEEP_TRANSACTION
 } OCStackApplicationResult;