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
This commit is contained in:
Lucas De Marchi 2012-12-14 16:28:36 +00:00
parent 7a3fd93948
commit c598ce36fc
7 changed files with 23 additions and 0 deletions

View File

@ -162,6 +162,7 @@ typedef struct _EDBus_Message_Iter EDBus_Message_Iter;
* destination.
*/
typedef struct _EDBus_Pending EDBus_Pending;
/**
* @typedef EDBus_Signal_Handler
*

View File

@ -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);
/**
* @}
*/

View File

@ -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);
/**
* @}
*/

View File

@ -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;
/**
* @}
*/

View File

@ -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().
*/

View File

@ -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);
/**
* @}
*/

View File

@ -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.
*