diff options
author | JinYong Park <j4939.park@samsung.com> | 2017-10-26 11:54:04 +0900 |
---|---|---|
committer | Jean-Philippe Andre <jp.andre@samsung.com> | 2017-10-26 12:17:41 +0900 |
commit | 157daefd5bff87933b576c7f3eb473fc8824cf1d (patch) | |
tree | 0f08b5c3239e4776a798292d00099dff8504df06 /src/lib/eldbus | |
parent | e784afbd8806790d15a768c5e04fef935c2c2668 (diff) | |
download | efl-157daefd5bff87933b576c7f3eb473fc8824cf1d.tar.gz |
eldbus-service: add parameters and return type description for doxygen
Summary: Add omitted descriptions for doxygen warning
Test Plan: API Doxygen Revision
Reviewers: raster, cedric, jpeg, myoungwoon, Jaehyun_Cho
Differential Revision: https://phab.enlightenment.org/D5378
Diffstat (limited to 'src/lib/eldbus')
-rw-r--r-- | src/lib/eldbus/eldbus_service.h | 17 |
1 files changed, 16 insertions, 1 deletions
diff --git a/src/lib/eldbus/eldbus_service.h b/src/lib/eldbus/eldbus_service.h index ba5a9a3fc8..febf67de1d 100644 --- a/src/lib/eldbus/eldbus_service.h +++ b/src/lib/eldbus/eldbus_service.h @@ -182,12 +182,16 @@ eldbus_service_interface_fallback_register2(Eldbus_Connection *conn, const char * @brief Unregister a interface. * Note: This doesn't unregister the object path if interface count reaches 0. * Use eldbus_service_object_unregister() to unregister the object. + * + * @param iface interface to unregister */ EAPI void eldbus_service_interface_unregister(Eldbus_Service_Interface *iface) EINA_ARG_NONNULL(1); /** * @brief Unregister all interfaces of the object path that this interface belongs * and the object path. + * + * @param iface interface to unregister */ EAPI void eldbus_service_object_unregister(Eldbus_Service_Interface *iface) EINA_ARG_NONNULL(1); EAPI Eldbus_Connection *eldbus_service_connection_get(const Eldbus_Service_Interface *iface) EINA_ARG_NONNULL(1) EINA_WARN_UNUSED_RESULT; @@ -201,6 +205,8 @@ EAPI const char *eldbus_service_object_path_get(const Eldbus_Service_Interface * * @param iface interface of the signal * @param signal_id id of signal * @param ... values that will be send on signal + * + * @return EINA_TRUE if success */ EAPI Eina_Bool eldbus_service_signal_emit(const Eldbus_Service_Interface *iface, unsigned int signal_id, ...) EINA_ARG_NONNULL(1); @@ -212,15 +218,22 @@ EAPI Eina_Bool eldbus_service_signal_emit(const Eldbus_Service_Interface *iface, * * @param iface interface of the signal * @param signal_id id of signal + * + * @return EINA_TRUE if success */ EAPI Eldbus_Message *eldbus_service_signal_new(const Eldbus_Service_Interface *iface, unsigned int signal_id) EINA_ARG_NONNULL(1) EINA_WARN_UNUSED_RESULT; /** * @brief Send a signal message. * - * On success this will call eldbus_message_unref() on the @param signal_msg, + * On success this will call eldbus_message_unref() on the @p signal_msg, * which is the intended behavior in 99% of the cases. Remember to increment * the refcount if you want to keep it alive. + * + * @param iface interface of the signal + * @param signal_msg message of signal + * + * @return EINA_TRUE if success */ EAPI Eina_Bool eldbus_service_signal_send(const Eldbus_Service_Interface *iface, Eldbus_Message *signal_msg) EINA_ARG_NONNULL(1, 2); @@ -262,6 +275,8 @@ EAPI void *eldbus_service_object_data_del(Eldbus_Service_Interface *iface, const * * @param iface Interface containing the changed property * @param name Property name + * + * @return EINA_TRUE if success */ EAPI Eina_Bool eldbus_service_property_changed(const Eldbus_Service_Interface *iface, const char *name) EINA_ARG_NONNULL(1, 2); |