From c598ce36fcb99c2679ee80c681436b0ea67ef1b9 Mon Sep 17 00:00:00 2001 From: Lucas De Marchi Date: Fri, 14 Dec 2012 16:28:36 +0000 Subject: [PATCH] edbus: Add blank lines to separate function docs find . -name '*.h' -exec \ sed -i '/^\s*$/b; N; /\n\/\*\*/{P;x;p;x;D}' {} \; This ensures to add a blank line above a doxygen comment if and only if there wasn't one. SVN revision: 80962 --- legacy/edbus/src/lib/EDBus.h | 1 + legacy/edbus/src/lib/edbus_freedesktop.h | 3 +++ legacy/edbus/src/lib/edbus_message.h | 6 ++++++ legacy/edbus/src/lib/edbus_object.h | 3 +++ legacy/edbus/src/lib/edbus_proxy.h | 5 +++++ legacy/edbus/src/lib/edbus_service.h | 2 ++ legacy/edbus/src/lib/edbus_signal_handler.h | 3 +++ 7 files changed, 23 insertions(+) diff --git a/legacy/edbus/src/lib/EDBus.h b/legacy/edbus/src/lib/EDBus.h index ef1eec1..46d0654 100644 --- a/legacy/edbus/src/lib/EDBus.h +++ b/legacy/edbus/src/lib/EDBus.h @@ -162,6 +162,7 @@ typedef struct _EDBus_Message_Iter EDBus_Message_Iter; * destination. */ typedef struct _EDBus_Pending EDBus_Pending; + /** * @typedef EDBus_Signal_Handler * diff --git a/legacy/edbus/src/lib/edbus_freedesktop.h b/legacy/edbus/src/lib/edbus_freedesktop.h index 9a89337..4e622d0 100644 --- a/legacy/edbus/src/lib/edbus_freedesktop.h +++ b/legacy/edbus/src/lib/edbus_freedesktop.h @@ -70,6 +70,7 @@ EAPI void edbus_name_owner_changed_callback_del(EDBus_Connectio */ EAPI EDBus_Pending *edbus_object_peer_ping(EDBus_Object *obj, EDBus_Message_Cb cb, const void *data) EINA_ARG_NONNULL(1, 2); EAPI EDBus_Pending *edbus_object_peer_machine_id_get(EDBus_Object *obj, EDBus_Message_Cb cb, const void *data) EINA_ARG_NONNULL(1, 2); + /** * @} */ @@ -119,6 +120,7 @@ EAPI Eina_Value *edbus_proxy_property_local_get(EDBus_Proxy *proxy, co * EDBUS_PROXY_EVENT_PROPERTY_CHANGED. */ EAPI const Eina_Hash *edbus_proxy_property_local_get_all(EDBus_Proxy *proxy) EINA_ARG_NONNULL(1); + /** * @} */ @@ -129,6 +131,7 @@ EAPI const Eina_Hash *edbus_proxy_property_local_get_all(EDBus_Proxy *proxy */ EAPI EDBus_Pending *edbus_object_managed_objects_get(EDBus_Object *obj, EDBus_Message_Cb cb, const void *data) EINA_ARG_NONNULL(1, 2); + /** * @} */ diff --git a/legacy/edbus/src/lib/edbus_message.h b/legacy/edbus/src/lib/edbus_message.h index d230b24..df886af 100644 --- a/legacy/edbus/src/lib/edbus_message.h +++ b/legacy/edbus/src/lib/edbus_message.h @@ -91,6 +91,7 @@ EAPI Eina_Bool edbus_message_arguments_vget(const EDBus_Message *msg * edbus_message_iter_* functions. */ EAPI Eina_Bool edbus_message_arguments_set(EDBus_Message *msg, const char *signature, ...) EINA_ARG_NONNULL(1, 2); + /** * @brief Set data to EDBus_Message. * @@ -122,6 +123,7 @@ EAPI Eina_Bool edbus_message_arguments_vset(EDBus_Message *msg, cons * @return the new iterator */ EAPI EDBus_Message_Iter *edbus_message_iter_container_new(EDBus_Message_Iter *iter, int type, const char* contained_signature) EINA_ARG_NONNULL(1, 3) EINA_WARN_UNUSED_RESULT; + /** * @brief Append a basic type to EDBus_Iterator. */ @@ -145,6 +147,7 @@ EAPI Eina_Bool edbus_message_iter_basic_append(EDBus_Message_Iter * data and close it.. */ EAPI Eina_Bool edbus_message_iter_arguments_set(EDBus_Message_Iter *iter, const char *signature, ...) EINA_ARG_NONNULL(1, 2); + /** * @brief Set data to EDBus_Message_Iter. For each complete in signature * you need pass the value, in case of complex type a pointer to be allocated a @@ -164,6 +167,7 @@ EAPI Eina_Bool edbus_message_iter_arguments_set(EDBus_Message_Iter * data and close it. */ EAPI Eina_Bool edbus_message_iter_arguments_vset(EDBus_Message_Iter *iter, const char *signature, va_list ap) EINA_ARG_NONNULL(1, 2, 3); + /** * @brief Closes a container-typed value appended to the message. * @@ -196,6 +200,7 @@ EAPI char *edbus_message_iter_signature_get(EDBus_Message_Iter * @return if iterator was reach to end return EINA_FALSE */ EAPI Eina_Bool edbus_message_iter_next(EDBus_Message_Iter *iter) EINA_ARG_NONNULL(1); + /** * @brief Get a complete type from EDBus_Message_Iter if is not at the end * of iterator and move to next field. @@ -268,6 +273,7 @@ EAPI Eina_Bool edbus_message_iter_arguments_vget(EDBus_Message_Ite * @param iter the iterator to be deleted. */ EAPI void edbus_message_iter_del(EDBus_Message_Iter *iter) EINA_ARG_NONNULL(1); + /** * @} */ diff --git a/legacy/edbus/src/lib/edbus_object.h b/legacy/edbus/src/lib/edbus_object.h index fb48e5c..6bf8138 100644 --- a/legacy/edbus/src/lib/edbus_object.h +++ b/legacy/edbus/src/lib/edbus_object.h @@ -6,6 +6,7 @@ * * @{ */ + /** * @brief Get an object of the given bus and path. * @@ -80,6 +81,7 @@ typedef void (*EDBus_Object_Event_Cb)(void *data, EDBus_Object *obj, void *event * type occurs. */ EAPI void edbus_object_event_callback_add(EDBus_Object *obj, EDBus_Object_Event_Type type, EDBus_Object_Event_Cb cb, const void *cb_data) EINA_ARG_NONNULL(1, 3); + /** * @brief Remove callback registered in edbus_object_event_callback_add(). */ @@ -113,6 +115,7 @@ EAPI EDBus_Pending *edbus_object_send(EDBus_Object *obj, EDBus_Message *m EAPI EDBus_Signal_Handler *edbus_object_signal_handler_add(EDBus_Object *obj, const char *interface, const char *member, EDBus_Signal_Cb cb, const void *cb_data) EINA_ARG_NONNULL(1, 4); EAPI EDBus_Message *edbus_object_method_call_new(EDBus_Object *obj, const char *interface, const char *member) EINA_ARG_NONNULL(1, 2, 3) EINA_WARN_UNUSED_RESULT; + /** * @} */ diff --git a/legacy/edbus/src/lib/edbus_proxy.h b/legacy/edbus/src/lib/edbus_proxy.h index 263d05e..b3764dd 100644 --- a/legacy/edbus/src/lib/edbus_proxy.h +++ b/legacy/edbus/src/lib/edbus_proxy.h @@ -6,6 +6,7 @@ * * @{ */ + /** * @brief Get a proxy of the following interface name in a EDBus_Object. */ @@ -32,6 +33,7 @@ EAPI void *edbus_proxy_data_del(EDBus_Proxy *proxy, const char * * type passed. */ EAPI void edbus_proxy_cb_free_add(EDBus_Proxy *proxy, EDBus_Free_Cb cb, const void *data) EINA_ARG_NONNULL(1, 2); + /** * @brief Remove callback registered in edbus_proxy_cb_free_add(). */ @@ -53,6 +55,7 @@ EAPI EDBus_Message *edbus_proxy_method_call_new(EDBus_Proxy *proxy, const * EDBUS_TIMEOUT_INFINITE for no timeout */ EAPI EDBus_Pending *edbus_proxy_send(EDBus_Proxy *proxy, EDBus_Message *msg, EDBus_Message_Cb cb, const void *cb_data, double timeout) EINA_ARG_NONNULL(1, 2); + /** * @brief Call a method in proxy. * Send a method call to interface that proxy belong with data. @@ -88,6 +91,7 @@ EAPI EDBus_Pending *edbus_proxy_call(EDBus_Proxy *proxy, const char *memb * edbus_message_iter_* functions. */ EAPI EDBus_Pending *edbus_proxy_vcall(EDBus_Proxy *proxy, const char *member, EDBus_Message_Cb cb, const void *cb_data, double timeout, const char *signature, va_list ap) EINA_ARG_NONNULL(1, 2, 6); + /** * @brief Add a signal handler. * @@ -127,6 +131,7 @@ typedef void (*EDBus_Proxy_Event_Cb)(void *data, EDBus_Proxy *proxy, void *event * type passed. */ EAPI void edbus_proxy_event_callback_add(EDBus_Proxy *proxy, EDBus_Proxy_Event_Type type, EDBus_Proxy_Event_Cb cb, const void *cb_data) EINA_ARG_NONNULL(1, 3); + /** * @brief Remove callback registered in edbus_proxy_event_callback_add(). */ diff --git a/legacy/edbus/src/lib/edbus_service.h b/legacy/edbus/src/lib/edbus_service.h index 326b3b4..b29bb0a 100644 --- a/legacy/edbus/src/lib/edbus_service.h +++ b/legacy/edbus/src/lib/edbus_service.h @@ -164,6 +164,7 @@ EAPI void edbus_service_object_data_set(EDBus_Service_Interface *iface, const ch * @return pointer to data if found otherwise NULL */ EAPI void *edbus_service_object_data_get(const EDBus_Service_Interface *iface, const char *key) EINA_ARG_NONNULL(1, 2) EINA_WARN_UNUSED_RESULT; + /** * @brief Del data stored in object path. * @@ -201,6 +202,7 @@ EAPI Eina_Bool edbus_service_object_manager_attach(EDBus_Service_Interface *ifac * @return EINA_TRUE if success */ EAPI Eina_Bool edbus_service_object_manager_detach(EDBus_Service_Interface *iface) EINA_ARG_NONNULL(1); + /** * @} */ diff --git a/legacy/edbus/src/lib/edbus_signal_handler.h b/legacy/edbus/src/lib/edbus_signal_handler.h index 6798383..1df5fb3 100644 --- a/legacy/edbus/src/lib/edbus_signal_handler.h +++ b/legacy/edbus/src/lib/edbus_signal_handler.h @@ -6,6 +6,7 @@ * * @{ */ + /** * @brief Add a signal handler. * @@ -28,6 +29,7 @@ EAPI EDBus_Signal_Handler *edbus_signal_handler_ref(EDBus_Signal_Handler *handle * If reference == 0 signal handler will be freed. */ EAPI void edbus_signal_handler_unref(EDBus_Signal_Handler *handler) EINA_ARG_NONNULL(1); + /** * @brief Decrease signal handler reference like edbus_signal_handler_unref() * but if reference > 0 this signal handler will stop listening to signals. In other @@ -51,6 +53,7 @@ EAPI void edbus_signal_handler_del(EDBus_Signal_Handler *handle * http://dbus.freedesktop.org/doc/dbus-specification.html#message-bus-routing-match-rules */ EAPI Eina_Bool edbus_signal_handler_match_extra_set(EDBus_Signal_Handler *sh, ...) EINA_ARG_NONNULL(1) EINA_SENTINEL; + /** * @brief Add extra argument in match of signal handler to obtain specifics signals. * -- 2.7.4