X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=include%2Fafb%2Fafb-event-x2.h;h=0caa706c6ba5a84e8124886fbe763b7f25763db4;hb=65353dce81a629e042800bb7b86fcd869a76727e;hp=f0a27877e1a9171dc72b12b068dba136adb9cbcd;hpb=4521c1e7ae5371ab9d639adc617d17fb4e8ded0c;p=src%2Fapp-framework-binder.git

diff --git a/include/afb/afb-event-x2.h b/include/afb/afb-event-x2.h
index f0a27877..0caa706c 100644
--- a/include/afb/afb-event-x2.h
+++ b/include/afb/afb-event-x2.h
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2016, 2017, 2018 "IoT.bzh"
+ * Copyright (C) 2015-2020 "IoT.bzh"
  * Author: José Bollo <jose.bollo@iot.bzh>
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
@@ -19,6 +19,9 @@
 
 #include "afb-event-x2-itf.h"
 
+/** @defgroup AFB_EVENT
+ *  @{ */
+
 /**
  * Checks whether the 'event' is valid or not.
  *
@@ -42,7 +45,7 @@ static inline int afb_event_x2_is_valid(struct afb_event_x2 *event)
  * @param event the event to broadcast
  * @param object the companion object to associate to the broadcasted event (can be NULL)
  *
- * @return the count of clients that received the event.
+ * @return 0 in case of success or -1 in case of error
  */
 static inline int afb_event_x2_broadcast(
 			struct afb_event_x2 *event,
@@ -62,7 +65,10 @@ static inline int afb_event_x2_broadcast(
  * @param event the event to push
  * @param object the companion object to associate to the pushed event (can be NULL)
  *
- * @return the count of clients that received the event.
+ * @Return
+ *   *  1 if at least one client listen for the event
+ *   *  0 if no more client listen for the event
+ *   * -1 in case of error (the event can't be delivered)
  */
 static inline int afb_event_x2_push(
 			struct afb_event_x2 *event,
@@ -111,3 +117,4 @@ static inline struct afb_event_x2 *afb_event_x2_addref(
 	return event->itf->addref(event);
 }
 
+/** @} */