doxygen: fix typos and some wrong expressions in Edje and Eet API reference documentation.

Summary: I had fixed some typos and some wrong expressions, such as capital letters, singular, and orders of groups in Edje and Eet API reference doxygen.

Test Plan: Doxygen Revision

Reviewers: stefan, cedric, raster, Jaehyun_Cho, jpeg

Subscribers: conr2d

Differential Revision: https://phab.enlightenment.org/D4666

Signed-off-by: Cedric BAIL <cedric@osg.samsung.com>

5 files changed, 1943 insertions, 1331 deletions

diff --git a/src/lib/edje/Edje.h b/src/lib/edje/Edje.h
index c13292f3d9..82f3cbac2d 100644
--- a/src/lib/edje/Edje.h
+++ b/src/lib/edje/Edje.h
@@ -197,7 +197,7 @@ param in edje programs
 
 /**
  * @file Edje.h
- * @brief Edje Graphical Design Library
+ * @brief Edje Graphical Design Library.
  *
  * These routines are used for Edje.
  */
diff --git a/src/lib/edje/Edje_Common.h b/src/lib/edje/Edje_Common.h
index 243a28ca00..c39e0ceb06 100644
--- a/src/lib/edje/Edje_Common.h
+++ b/src/lib/edje/Edje_Common.h
@@ -2,11 +2,11 @@
 
 /**
  * @internal
+ * @ingroup Edje_General_Group
  *
  * @typedef Edje_Version
  * Type for edje version
  *
- * @ingroup Edje_General_Group
  */
 typedef struct _Edje_Version
 {
@@ -75,6 +75,7 @@ struct _Edje_Size_Class
 
 /**
  * @defgroup Edje_Object_Communication_Interface_Signal Edje Communication Interface: Signal
+ * @ingroup Edje_Object_Group
  *
  * @brief Functions that deal with signals.
  *
@@ -85,17 +86,15 @@ struct _Edje_Size_Class
  * emit a signal from @b code to a @b theme or create handles for
  * the ones emitted from @b themes. Signals are identified by strings.
  *
- * @ingroup Edje_Object_Group
- *
  * @{
  */
 
 typedef void         (*Edje_Signal_Cb)          (void *data, Evas_Object *obj, const char *emission, const char *source); /**< Edje signal callback functions's prototype definition. @c data will have the auxiliary data pointer set at the time the callback registration. @c obj will be a pointer the Edje object where the signal comes from. @c emission will identify the exact signal's emission string and @c source the exact signal's source one. */
 
 /**
- * @brief Get extra data passed to callbacks.
+ * @brief Gets extra data passed to callbacks.
  *
- * @return the extra data for that callback.
+ * @return The extra data for that callback.
  *
  * Some callbacks pass extra information. This function gives access to that
  * extra information. It's somehow like event_info in smart callbacks.
@@ -123,7 +122,7 @@ EAPI void *       edje_object_signal_callback_extra_data_get(void);
  */
 
 /**
- * @brief Initialize the Edje library.
+ * @brief Initializes the Edje library.
  *
  * @return The new init count. The initial value is zero.
  *
@@ -144,7 +143,7 @@ EAPI void *       edje_object_signal_callback_extra_data_get(void);
 EAPI int          edje_init                       (void);
 
 /**
- * @brief Shutdown the Edje library.
+ * @brief Shuts down the Edje library.
  *
  * @return The number of times the library has been initialized
  *         without being shutdown.
@@ -165,7 +164,7 @@ EAPI int          edje_init                       (void);
 EAPI int                edje_shutdown                   (void);
 
 /**
- * @brief Set the edje append fontset.
+ * @brief Sets the edje append fontset.
  *
  * @param fonts The fontset to append.
  *
@@ -175,10 +174,10 @@ EAPI int		edje_shutdown			(void);
 EAPI void               edje_fontset_append_set         (const char *fonts);
 
 /**
- * Get data from the file level data block of an edje mapped file
+ * @brief Gets data from the file level data block of an edje mapped file.
  * @param f The mapped edje file
  * @param key The data key
- * @return The string value of the data or NULL if no key is found.
+ * @return The string value of the data, or @c NULL if no key is found.
  * Must be freed by the user when no longer needed.
  *
  * If an edje file test.edj is built from the following edc:
@@ -194,10 +193,10 @@ EAPI void		edje_fontset_append_set		(const char *fonts);
 EAPI char             *edje_mmap_data_get(const Eina_File *f, const char *key);
 
 /**
- * Get data from the file level data block of an edje file
+ * @brief Gets data from the file level data block of an edje file.
  * @param file The path to the .edj file
  * @param key The data key
- * @return The string value of the data or NULL if no key is found.
+ * @return The string value of the data, or @c NULL if no key is found.
  * Must be freed by the user when no longer needed.
  *
  * If an edje file test.edj is built from the following edc:
@@ -215,9 +214,9 @@ EAPI char             *edje_mmap_data_get(const Eina_File *f, const char *key);
 EAPI char        *edje_file_data_get              (const char *file, const char *key);
 
 /**
- * @brief Load a new module in Edje.
+ * @brief Loads a new module in Edje.
  * @param module The name of the module that will be added to Edje.
- * @return EINA_TRUE if the module was successfully loaded. Otherwise, EINA_FALSE.
+ * @return @c EINA_TRUE if the module was successfully loaded. Otherwise, @c EINA_FALSE.
  *
  * Modules are used to add functionality to Edje.
  * So, when a module is loaded, its functionality should be available for use.
@@ -237,7 +236,7 @@ EAPI Eina_Bool               edje_module_load                (const char *module
 EAPI const Eina_List        *edje_available_modules_get      (void);
 
 /**
- * @brief Get the edje append fontset.
+ * @brief Gets the edje append fontset.
  *
  * @return The edje append fontset.
  *
@@ -250,7 +249,7 @@ EAPI const Eina_List        *edje_available_modules_get      (void);
 EAPI const char         *edje_fontset_append_get        (void);
 
 /**
- * @brief Set the file cache size.
+ * @brief Sets the file cache size.
  *
  * @param count The file cache size in edje file units. Default is 16.
  *
@@ -265,7 +264,7 @@ EAPI const char		*edje_fontset_append_get	(void);
 EAPI void         edje_file_cache_set             (int count);
 
 /**
- * @brief Return the file cache size.
+ * @brief Returns the file cache size.
  *
  * @return The file cache size in edje file units. Default is 16.
  *
@@ -279,7 +278,7 @@ EAPI void         edje_file_cache_set             (int count);
 EAPI int          edje_file_cache_get             (void);
 
 /**
- * @brief Clean the file cache.
+ * @brief Cleans the file cache.
  *
  * This function cleans the file cache entries, but keeps this cache's
  * size to the last value set.
@@ -291,7 +290,7 @@ EAPI int          edje_file_cache_get             (void);
 EAPI void         edje_file_cache_flush           (void);
 
 /**
- * @brief Set the collection cache size.
+ * @brief Sets the collection cache size.
  *
  * @param count The collection cache size, in edje object units. Default is 16.
  *
@@ -307,7 +306,7 @@ EAPI void         edje_file_cache_flush           (void);
 EAPI void         edje_collection_cache_set       (int count);
 
 /**
- * @brief Return the collection cache size.
+ * @brief Returns the collection cache size.
  *
  * @return The collection cache size, in edje object units. Default is 16.
  *
@@ -321,7 +320,7 @@ EAPI void         edje_collection_cache_set       (int count);
 EAPI int          edje_collection_cache_get       (void);
 
 /**
- * @brief Clean the collection cache.
+ * @brief Cleans the collection cache.
  *
  * This function cleans the collection cache, but keeps this cache's
  * size to the last value set.
@@ -592,28 +591,28 @@ typedef struct _Edje_External_Type_Info Edje_External_Type_Info;
 
 /**
  * @defgroup Edje_External_Plugin_Development_Group Edje Development of External Plugins
+ * @ingroup Edje_External_Group
  *
  * @brief Functions to register, unregister EXTERNAL types and develop the plugins.
  *
- * This group dicusses functions useful for the development of new plugins.
+ * This group discusses functions useful for the development of new plugins.
  * These functions deal with the newly EXTERNAL types by registering, unregistering and manipulating them.
  *
- * @ingroup Edje_External_Group
  *
  * @{
  */
 
 /**
- * Register a type to be used by EXTERNAL parts.
+ * @brief Registers a type to be used by EXTERNAL parts.
  *
  * Parts of type EXTERNAL will call user defined functions
  * to create and manipulate the object that's allocated in that part. This is
  * done by expecifying in the @c source property of the part the name of the
  * external to use, which must be one registered with this function.
  *
- * @param type_name name to register and be known by edje's "source:"
+ * @param type_name Name to register and be known by edje's "source:"
  *        parameter of "type: EXTERNAL" parts.
- * @param type_info meta-information describing how to interact with it.
+ * @param type_info Meta-information describing how to interact with it.
  *
  * @return @c EINA_TRUE on success, @c EINA_FALSE on failure (like
  *         type already registered).
@@ -623,7 +622,7 @@ typedef struct _Edje_External_Type_Info Edje_External_Type_Info;
 EAPI Eina_Bool    edje_external_type_register             (const char *type_name, const Edje_External_Type *type_info);
 
 /**
- * Unregister a previously registered EXTERNAL type.
+ * @brief Unregisters a previously registered EXTERNAL type.
  *
  * @param type_name name to unregister. It should have been registered with
  *        edje_external_type_register() before.
@@ -636,7 +635,7 @@ EAPI Eina_Bool    edje_external_type_register             (const char *type_name
 EAPI Eina_Bool    edje_external_type_unregister           (const char *type_name);
 
 /**
- * Register a batch of types and their information.
+ * @brief Registers a batch of types and their information.
  *
  * When several types will be registered it is recommended to use this
  * function instead of several calls to edje_external_type_register(), as it
@@ -661,7 +660,7 @@ EAPI Eina_Bool    edje_external_type_unregister           (const char *type_name
 EAPI void         edje_external_type_array_register       (const Edje_External_Type_Info *array);
 
 /**
- * Unregister a batch of given external type previously registered.
+ * @brief Unregisters a batch of given external type previously registered.
  *
  * @param array @c NULL terminated array, should be the same as the
  *        one used to register with edje_external_type_array_register()
@@ -671,7 +670,7 @@ EAPI void         edje_external_type_array_register       (const Edje_External_T
 EAPI void         edje_external_type_array_unregister     (const Edje_External_Type_Info *array);
 
 /**
- * Return the current ABI version for Edje_External_Type structure.
+ * @brief Returns the current ABI version for Edje_External_Type structure.
  *
  * Always check this number before accessing Edje_External_Type in
  * your own software. If the number is not the same, your software may
@@ -693,7 +692,7 @@ EAPI unsigned int edje_external_type_abi_version_get      (void) EINA_CONST;
 
 /**
  *
- * @return an iterator of all the registered EXTERNAL types.
+ * @return An iterator of all the registered EXTERNAL types.
  *
  * Each item in the iterator is an @c Eina_Hash_Tuple which has the type
  * of the external in the @c key and #Edje_External_Type as @c data.
@@ -737,7 +736,7 @@ EAPI unsigned int edje_external_type_abi_version_get      (void) EINA_CONST;
 EAPI Eina_Iterator                  *edje_external_iterator_get     (void);
 
 /**
- * Conevenience function to find a specific parameter in a list of them.
+ * @brief Convenience function to find a specific parameter in a list of them.
  *
  * @param params The list of parameters for the external
  * @param key The parameter to look for
@@ -747,7 +746,7 @@ EAPI Eina_Iterator                  *edje_external_iterator_get     (void);
 EAPI Edje_External_Param            *edje_external_param_find       (const Eina_List *params, const char *key);
 
 /**
- * Get the value of the given parameter of integer type.
+ * @brief Gets the value of the given parameter of integer type.
  *
  * Look for the @p key parameter in the @p params list and return its value in
  * @p ret. If the parameter is found and is of type
@@ -759,13 +758,13 @@ EAPI Edje_External_Param            *edje_external_param_find       (const Eina_
  * @param key Name of the parameter to fetch
  * @param ret Int pointer where to store the value, must not be NULL.
  *
- * @return EINA_TRUE if the parameter was found and is of integer type,
- * EINA_FALSE otherwise.
+ * @return @c EINA_TRUE if the parameter was found and is of integer type,
+ * @c EINA_FALSE otherwise.
  */
 EAPI Eina_Bool                       edje_external_param_int_get    (const Eina_List *params, const char *key, int *ret);
 
 /**
- * Get the value of the given parameter of double type.
+ * @brief Gets the value of the given parameter of double type.
  *
  * Look for the @p key parameter in the @p params list and return its value in
  * @p ret. If the parameter is found and is of type
@@ -777,13 +776,13 @@ EAPI Eina_Bool                       edje_external_param_int_get    (const Eina_
  * @param key Name of the parameter to fetch
  * @param ret Double pointer where to store the value, must not be NULL.
  *
- * @return EINA_TRUE if the parameter was found and is of double type,
- * EINA_FALSE otherwise.
+ * @return @c EINA_TRUE if the parameter was found and is of double type,
+ * @c EINA_FALSE otherwise.
  */
 EAPI Eina_Bool                       edje_external_param_double_get (const Eina_List *params, const char *key, double *ret);
 
 /**
- * Get the value of the given parameter of string type.
+ * @brief Gets the value of the given parameter of string type.
  *
  * Look for the @p key parameter in the @p params list and return its value in
  * @p ret. If the parameter is found and is of type
@@ -797,13 +796,13 @@ EAPI Eina_Bool                       edje_external_param_double_get (const Eina_
  * @param key Name of the parameter to fetch
  * @param ret String pointer where to store the value, must not be NULL.
  *
- * @return EINA_TRUE if the parameter was found and is of string type,
- * EINA_FALSE otherwise.
+ * @return @c EINA_TRUE if the parameter was found and is of string type,
+ * @c EINA_FALSE otherwise.
  */
 EAPI Eina_Bool                       edje_external_param_string_get (const Eina_List *params, const char *key, const char **ret);
 
 /**
- * Get the value of the given parameter of boolean type.
+ * @brief Gets the value of the given parameter of boolean type.
  *
  * Look for the @p key parameter in the @p params list and return its value in
  * @p ret. If the parameter is found and is of type
@@ -815,13 +814,13 @@ EAPI Eina_Bool                       edje_external_param_string_get (const Eina_
  * @param key Name of the parameter to fetch
  * @param ret Eina_Bool pointer where to store the value, must not be NULL.
  *
- * @return EINA_TRUE if the parameter was found and is of boolean type,
- * EINA_FALSE otherwise.
+ * @return @c EINA_TRUE if the parameter was found and is of boolean type,
+ * @c EINA_FALSE otherwise.
  */
 EAPI Eina_Bool                       edje_external_param_bool_get   (const Eina_List *params, const char *key, Eina_Bool *ret);
 
 /**
- * Get the value of the given parameter of choice type.
+ * @brief Gets the value of the given parameter of choice type.
  *
  * Look for the @p key parameter in the @p params list and return its value in
  * @p ret. If the parameter is found and is of type
@@ -841,7 +840,7 @@ EAPI Eina_Bool                       edje_external_param_bool_get   (const Eina_
 EAPI Eina_Bool                       edje_external_param_choice_get (const Eina_List *params, const char *key, const char **ret);
 
 /**
- * Get the array of parameters information about a type given its name.
+ * @brief Gets the array of parameters information about a type given its name.
  *
  * @note the type names and other strings are static, that means they are
  *       @b NOT translated. One must use
@@ -857,7 +856,7 @@ EAPI Eina_Bool                       edje_external_param_choice_get (const Eina_
 EAPI const Edje_External_Param_Info *edje_external_param_info_get   (const char *type_name);
 
 /**
- * Get the #Edje_External_Type that defines an EXTERNAL type registered with
+ * @brief Gets the #Edje_External_Type that defines an EXTERNAL type registered with
  * the name @p type_name.
  */
 EAPI const Edje_External_Type       *edje_external_type_get         (const char *type_name);
@@ -889,6 +888,7 @@ EAPI const Edje_External_Type       *edje_external_type_get         (const char
 
 /**
  * @defgroup Edje_Object_Scale Edje Scale
+ * @ingroup Edje_Object_Group
  *
  * @brief Functions that deal with scaling objects
  *
@@ -899,13 +899,12 @@ EAPI const Edje_External_Type       *edje_external_type_get         (const char
  * Scaling affects the values of minimum/maximum @b part sizes, which
  * are @b multiplied by it. Font sizes are scaled, too.
  *
- * @ingroup Edje_Object_Group
  *
  * @{
  */
 
 /**
- * @brief Set Edje's global scaling factor.
+ * @brief Sets Edje's global scaling factor.
  *
  * @param scale The global scaling factor (the default value is @c 1.0)
  *
@@ -924,9 +923,9 @@ EAPI const Edje_External_Type       *edje_external_type_get         (const char
 EAPI void         edje_scale_set                  (double scale);
 
 /**
- * @brief Retrieve Edje's global scaling factor.
+ * @brief Retrieves Edje's global scaling factor.
  *
- * @return The global scaling factor
+ * @return The global scaling factor.
  *
  * This function returns Edje's global scaling factor.
  *
@@ -941,6 +940,7 @@ EAPI double       edje_scale_get                  (void);
 
 /**
  * @defgroup Edje_Text_Entry Edje Text Entry
+ * @ingroup Edje_Part_Text
  *
  * @brief Functions that deal with text entries
  *
@@ -953,7 +953,6 @@ EAPI double       edje_scale_get                  (void);
  *
  * Use the functions of this section to handle the user input of text.
  *
- * @ingroup Edje_Part_Text
  *
  * @{
  */
@@ -1039,12 +1038,12 @@ typedef void         (*Edje_Markup_Filter_Cb)   (void *data, Evas_Object *obj, c
  * @param obj The Evas_Object to filter.
  * @param part Edje part name
  * @param item Item of container
- * @return must be an Evas_Object.
+ * @return Must be an Evas_Object.
  */
 typedef Evas_Object *(*Edje_Item_Provider_Cb)   (void *data, Evas_Object *obj, const char *part, const char *item);
 
 /**
- * @brief Show last character in password mode.
+ * @brief Shows last character in password mode.
  *
  * @param password_show_last If TRUE enable last character show in password mode.
  *
@@ -1058,7 +1057,7 @@ typedef Evas_Object *(*Edje_Item_Provider_Cb)   (void *data, Evas_Object *obj, c
 EAPI void edje_password_show_last_set(Eina_Bool password_show_last);
 
 /**
- * @brief Set the timeout value in last show password mode.
+ * @brief Sets the timeout value in last show password mode.
  *
  * @param password_show_last_timeout The timeout value.
  *
@@ -1078,6 +1077,7 @@ EAPI void edje_password_show_last_timeout_set(double password_show_last_timeout)
 
 /**
  * @defgroup Edje_Object_Color_Class Edje Class: Color
+ * @ingroup Edje_Object_Group
  *
  * @brief Functions that deal with Color Classes
  *
@@ -1090,13 +1090,11 @@ EAPI void edje_password_show_last_timeout_set(double password_show_last_timeout)
  * will affect all parts with that color class, while at a object level will
  * affect only the parts inside an specified object.
  *
- * @ingroup Edje_Object_Group
- *
  * @{
  */
 
 /**
- * @brief Set Edje color class.
+ * @brief Sets Edje color class.
  *
  * @param color_class
  * @param r Object Red value
@@ -1128,15 +1126,15 @@ EAPI void edje_password_show_last_timeout_set(double password_show_last_timeout)
  *
  * @see edje_color_class_set().
  *
- * @note unlike Evas, Edje colors are @b not pre-multiplied. That is,
+ * @note Unlike Evas, Edje colors are @b not pre-multiplied. That is,
  *       half-transparent white is 255 255 255 128.
  *
- * @return Eina_Bool, EINA_TRUE on success and EINA_FALSE on failure.
+ * @return Eina_Bool, @c EINA_TRUE on success and @c EINA_FALSE on failure.
  */
 EAPI Eina_Bool    edje_color_class_set            (const char *color_class, int r, int g, int b, int a, int r2, int g2, int b2, int a2, int r3, int g3, int b3, int a3);
 
 /**
- * @brief Get Edje color class.
+ * @brief Gets Edje color class.
  *
  * @param color_class
  * @param r Object Red value
@@ -1152,7 +1150,7 @@ EAPI Eina_Bool    edje_color_class_set            (const char *color_class, int
  * @param b3 Shadow Blue value
  * @param a3 Shadow Alpha value
  *
- * @return EINA_TRUE if found or EINA_FALSE if not found and all
+ * @return @c EINA_TRUE if found or @c EINA_FALSE if not found and all
  *         values are zeroed.
  *
  * This function gets the color values for a process level color
@@ -1166,13 +1164,13 @@ EAPI Eina_Bool    edje_color_class_set            (const char *color_class, int
  *
  * @see edje_color_class_set().
  *
- * @note unlike Evas, Edje colors are @b not pre-multiplied. That is,
+ * @note Unlike Evas, Edje colors are @b not pre-multiplied. That is,
  *       half-transparent white is 255 255 255 128.
  */
 EAPI Eina_Bool    edje_color_class_get            (const char *color_class, int *r, int *g, int *b, int *a, int *r2, int *g2, int *b2, int *a2, int *r3, int *g3, int *b3, int *a3);
 
 /**
- * @brief Delete edje color class.
+ * @brief Deletes edje color class.
  *
  * @param color_class
  *
@@ -1199,7 +1197,7 @@ EAPI void         edje_color_class_del            (const char *color_class);
 EAPI Eina_List   *edje_color_class_list           (void);
 
 /**
- * @brief Iterate over all the active class of an application.
+ * @brief Iterates over all the active class of an application.
  *
  * @return an iterator of Edje_Color_Class of the currently active color class
  *
@@ -1211,7 +1209,7 @@ EAPI Eina_List   *edje_color_class_list           (void);
 EAPI Eina_Iterator *edje_color_class_active_iterator_new(void);
 
 /**
- * @brief Iterate over all the color class provided by an Edje file.
+ * @brief Iterates over all the color class provided by an Edje file.
  *
  * @return an iterator of Edje_Color_Class provided by the Edje file.
  *
@@ -1226,6 +1224,7 @@ EAPI Eina_Iterator *edje_mmap_color_class_iterator_new(Eina_File *f);
 
 /**
  * @defgroup Edje_Object_Part Edje Part
+ * @ingroup Edje_Object_Group
  *
  * @brief Functions that deal with layout components
  *
@@ -1239,15 +1238,13 @@ EAPI Eina_Iterator *edje_mmap_color_class_iterator_new(Eina_File *f);
  * This section has some functions specific for some types and others that
  * could be applied to any type.
  *
- * @ingroup Edje_Object_Group
- *
  * @{
  */
 
 /**
  * @typedef Edje_Part_Type
  *
- * All possible "part" types in Edje
+ * All possible "part" types in Edje.
  */
 typedef enum _Edje_Part_Type
 {
@@ -1277,6 +1274,7 @@ typedef enum _Edje_Part_Type
 
 /**
  * @defgroup Edje_Part_Text Edje Text Part
+ * @ingroup Edje_Object_Part
  *
  * @brief Functions that deal with parts of type text
  *
@@ -1286,8 +1284,6 @@ typedef enum _Edje_Part_Type
  * a input panel, where one can set a virtual keyboard to handle
  * keyboard entry easily.
  *
- * @ingroup Edje_Object_Part
- *
  * @{
  */
 
@@ -1302,7 +1298,7 @@ typedef enum _Edje_Part_Type
 /**
  * @typedef Edje_Text_Effect
  *
- * All possible text effects in Edje
+ * All possible text effects in Edje.
  */
 typedef enum _Edje_Text_Effect
 {
@@ -1333,10 +1329,10 @@ typedef enum _Edje_Text_Effect
 /**
  * @typedef (*Edje_Text_Change_Cb)
  *
- * Callback prototype for Edje_Text_Change
- * @param data user provided data to pass to the callback
- * @param obj the Evas_Object
- * @param The edje part
+ * Callback prototype for Edje_Text_Change.
+ * @param data User provided data to pass to the callback
+ * @param obj The Evas_Object
+ * @param part The edje part
  */
 typedef void         (*Edje_Text_Change_Cb)     (void *data, Evas_Object *obj, const char *part);
 /**
@@ -1345,8 +1341,9 @@ typedef void         (*Edje_Text_Change_Cb)     (void *data, Evas_Object *obj, c
 
 /**
  * @defgroup Edje_Text_Selection Edje Text Selection
+ * @ingroup Edje_Part_Text
  *
- * @brief Functions that deal with selection in text parts
+ * @brief Functions that deal with selection in text parts.
  *
  * Selection is a known functionality for texts in the whole computational
  * world. It is a block of text marked for further manipulation.
@@ -1354,8 +1351,6 @@ typedef void         (*Edje_Text_Change_Cb)     (void *data, Evas_Object *obj, c
  * Edje is responsible for handling this functionality through the
  * following functions.
  *
- * @ingroup Edje_Part_Text
- *
  * @{
  */
 /**
@@ -1364,8 +1359,9 @@ typedef void         (*Edje_Text_Change_Cb)     (void *data, Evas_Object *obj, c
 
 /**
  * @defgroup Edje_Text_Cursor Edje Text Cursor
+ * @ingroup Edje_Part_Text
  *
- * @brief Functions that deal with cursor in text parts
+ * @brief Functions that deal with cursor in text parts.
  *
  * Cursor is a known functionality for texts in the whole computational
  * world. It marks a position in the text from where one may want
@@ -1374,8 +1370,6 @@ typedef void         (*Edje_Text_Change_Cb)     (void *data, Evas_Object *obj, c
  * Edje is responsible for handling this functionality through the
  * following functions.
  *
- * @ingroup Edje_Part_Text
- *
  * @{
  */
 
@@ -1385,6 +1379,7 @@ typedef void         (*Edje_Text_Change_Cb)     (void *data, Evas_Object *obj, c
 
 /**
  * @defgroup Edje_Part_Swallow Edje Swallow Part
+ * @ingroup Edje_Object_Part
  *
  * @brief Functions that deal with parts of type swallow and swallowed objects.
  *
@@ -1397,7 +1392,6 @@ typedef void         (*Edje_Text_Change_Cb)     (void *data, Evas_Object *obj, c
  * objects that are not native of Edje. In this last case, Edje will
  * only treat the Evas_Object properties of the swallowed objects.
  *
- * @ingroup Edje_Object_Part
  *
  * @{
  */
@@ -1405,7 +1399,7 @@ typedef void         (*Edje_Text_Change_Cb)     (void *data, Evas_Object *obj, c
 /**
  * @typedef Edje_Aspect_Control
  *
- * All Edje aspect control values
+ * All Edje aspect control values.
  *
  */
 typedef enum _Edje_Aspect_Control
@@ -1423,6 +1417,7 @@ typedef enum _Edje_Aspect_Control
 
 /**
  * @defgroup Edje_Object_Geometry_Group Edje Object Geometry
+ * @ingroup Edje_Object_Group
  *
  * @brief Functions that deal with object's geometry.
  *
@@ -1434,8 +1429,6 @@ typedef enum _Edje_Aspect_Control
  * the appearance in the screen of the parts inside. Most times
  * that is what you want.
  *
- * @ingroup Edje_Object_Group
- *
  * @{
  */
 /**
@@ -1444,6 +1437,7 @@ typedef enum _Edje_Aspect_Control
 
 /**
  * @defgroup Edje_Part_Drag Edje Drag
+ * @ingroup Edje_Object_Part
  *
  * @brief Functions that deal with dragable parts.
  *
@@ -1456,7 +1450,6 @@ typedef enum _Edje_Aspect_Control
  *
  * @see @ref tutorial_edje_drag
  *
- * @ingroup Edje_Object_Part
  *
  * @{
  */
@@ -1467,14 +1460,13 @@ typedef enum _Edje_Aspect_Control
 
 /**
  * @defgroup Edje_Part_Box Edje Box Part
+ * @ingroup Edje_Object_Part
  *
  * @brief Functions that deal with parts of type box.
  *
  * Box is a container type for parts, that means it can contain
  * other parts.
  *
- * @ingroup Edje_Object_Part
- *
  * @{
  */
 
@@ -1508,21 +1500,20 @@ EAPI void         edje_box_layout_register        (const char *name, Evas_Object
 
 /**
  * @defgroup Edje_Part_Table Edje Table Part
+ * @ingroup Edje_Object_Part
  *
  * @brief Functions that deal with parts of type table.
  *
  * Table is a container type for parts, that means it can contain
  * other parts.
  *
- * @ingroup Edje_Object_Part
- *
  * @{
  */
 
 /**
  * @typedef Edje_Object_Table_Homogeneous_Mode
  *
- * Table homogeneous modes
+ * Table homogeneous modes.
  *
  */
 typedef enum _Edje_Object_Table_Homogeneous_Mode
@@ -1538,8 +1529,8 @@ typedef enum _Edje_Object_Table_Homogeneous_Mode
 
 /**
  * @defgroup Edje_Object_Text_Class Edje Class: Text
- *
- * @brief Functions that deal with Text Classes
+ * @ingroup Edje_Object_Group
+ * @brief Functions that deal with Text Classes.
  *
  * Sometimes we want to change the text of two or more parts equally and
  * that's when we use text classes.
@@ -1550,19 +1541,17 @@ typedef enum _Edje_Object_Table_Homogeneous_Mode
  * all parts with that text class, while at object level will affect only
  * the parts inside an specified object.
  *
- * @ingroup Edje_Object_Group
- *
  * @{
  */
 
 /**
- * @brief Set the Edje text class.
+ * @brief Sets the Edje text class.
  *
  * @param text_class The text class name
  * @param font The font name
  * @param size The font size
  *
- * @return @c EINA_TRUE, on success or @c EINA_FALSE, on error
+ * @return @c EINA_TRUE on success, or @c EINA_FALSE on error
  *
  * This function updates all Edje members at the process level which
  * belong to this text class with the new font attributes.
@@ -1578,13 +1567,13 @@ typedef enum _Edje_Object_Table_Homogeneous_Mode
 EAPI Eina_Bool    edje_text_class_set             (const char *text_class, const char *font, Evas_Font_Size size);
 
 /**
- * @brief Get the font and the font size from Edje text class.
+ * @brief Gets the font and the font size from Edje text class.
  *
  * @param text_class The text class name
  * @param font The font name
  * @param size The font size
  *
- * @return @c EINA_TRUE, on success or @c EINA_FALSE, on error
+ * @return @c EINA_TRUE on success, or @c EINA_FALSE on error
  *
  * This function gets the font and the font name from the specified Edje
  * text class. The font string will only be valid until the text class is
@@ -1596,7 +1585,7 @@ EAPI Eina_Bool    edje_text_class_set             (const char *text_class, const
 EAPI Eina_Bool    edje_text_class_get             (const char *text_class, const char **font, Evas_Font_Size *size);
 
 /**
- * @brief Delete the text class.
+ * @brief Deletes the text class.
  *
  * @param text_class The text class name string
  *
@@ -1607,7 +1596,7 @@ EAPI Eina_Bool    edje_text_class_get             (const char *text_class, const
 EAPI void         edje_text_class_del             (const char *text_class);
 
 /**
- * @brief List text classes.
+ * @brief Lists text classes.
  *
  * @return A list of text class names (strings). These strings are
  * stringshares and the list must be free()'d by the caller.
@@ -1647,6 +1636,7 @@ EAPI Eina_Iterator *edje_mmap_text_class_iterator_new(Eina_File *f);
 
 /**
  * @defgroup Edje_Object_Size_Class Edje Class: Size
+ * @ingroup Edje_Object_Group
  *
  * @brief Functions that deal with Size Classes
  *
@@ -1659,13 +1649,11 @@ EAPI Eina_Iterator *edje_mmap_text_class_iterator_new(Eina_File *f);
  * all parts with that size class, while at object level will affect only
  * the parts inside an specified object.
  *
- * @ingroup Edje_Object_Group
- *
  * @{
  */
 
 /**
- * @brief Set the Edje size class.
+ * @brief Sets the Edje size class.
  *
  * @param size_class The size class name
  * @param minw The min width
@@ -1673,7 +1661,7 @@ EAPI Eina_Iterator *edje_mmap_text_class_iterator_new(Eina_File *f);
  * @param maxw The max width
  * @param maxh The max height
  *
- * @return @c EINA_TRUE, on success or @c EINA_FALSE, on error
+ * @return @c EINA_TRUE on success, or @c EINA_FALSE on error
  *
  * This function updates all Edje members at the process level which
  * belong to this size class with the new min and max attributes.
@@ -1685,7 +1673,7 @@ EAPI Eina_Iterator *edje_mmap_text_class_iterator_new(Eina_File *f);
 EAPI Eina_Bool    edje_size_class_set             (const char *size_class, Evas_Coord minw, Evas_Coord minh, Evas_Coord maxw, Evas_Coord maxh);
 
 /**
- * @brief Get the Edje size class.
+ * @brief Gets the Edje size class.
  *
  * @param size_class The size class name
  * @param minw The min width
@@ -1693,7 +1681,7 @@ EAPI Eina_Bool    edje_size_class_set             (const char *size_class, Evas_
  * @param maxw The max width
  * @param maxh The max height
  *
- * @return @c EINA_TRUE, on success or @c EINA_FALSE, on error
+ * @return @c EINA_TRUE on success, or @c EINA_FALSE on error
  *
  * This function gets the min and max size from the specified Edje
  * size class.
@@ -1703,7 +1691,7 @@ EAPI Eina_Bool    edje_size_class_set             (const char *size_class, Evas_
 EAPI Eina_Bool    edje_size_class_get             (const char *size_class, Evas_Coord *minw, Evas_Coord *minh, Evas_Coord *maxw, Evas_Coord *maxh);
 
 /**
- * @brief Delete the size class.
+ * @brief Deletes the size class.
  *
  * @param size_class The size class name
  *
@@ -1715,7 +1703,7 @@ EAPI Eina_Bool    edje_size_class_get             (const char *size_class, Evas_
 EAPI void         edje_size_class_del             (const char *size_class);
 
 /**
- * @brief List size classes.
+ * @brief Lists size classes.
  *
  * @return A list of size class names (strings). These strings are
  * stringshares and the list must be eina_stringshare_del()'ed by the caller.
@@ -1728,9 +1716,9 @@ EAPI void         edje_size_class_del             (const char *size_class);
 EAPI Eina_List   *edje_size_class_list            (void);
 
 /**
- * @brief Iterate over all active classes of an application.
+ * @brief Iterates over all active classes of an application.
  *
- * @return an iterator of Edje_Size_Class of the currently active size class
+ * @return An iterator of Edje_Size_Class of the currently active size class
  *
  * This function only iterates over the Edje_Size_Class in use by
  * an application.
@@ -1740,7 +1728,7 @@ EAPI Eina_List   *edje_size_class_list            (void);
 EAPI Eina_Iterator *edje_size_class_active_iterator_new(void);
 
 /**
- * @brief Iterate over all size classes provided by an Edje file.
+ * @brief Iterates over all size classes provided by an Edje file.
  *
  * @return an iterator of Edje_Size_Class provided by the Edje file.
  *
@@ -1754,6 +1742,7 @@ EAPI Eina_Iterator *edje_mmap_size_class_iterator_new(Eina_File *f);
 
 /**
  * @defgroup Edje_Object_File Edje Object File
+ * @ingroup Edje_Object_Group
  *
  * @brief Functions to deals with EDJ files.
  *
@@ -1767,13 +1756,11 @@ EAPI Eina_Iterator *edje_mmap_size_class_iterator_new(Eina_File *f);
  * either by loading them or retrieving information of the EDC
  * file about objects.
  *
- * @ingroup Edje_Object_Group
- *
  * @{
  */
 
 /**
- * Get a list of groups in an edje mapped file
+ * @brief Gets a list of groups in an edje mapped file.
  * @param f The mapped file
  *
  * @return The Eina_List of group names (char *)
@@ -1784,7 +1771,7 @@ EAPI Eina_Iterator *edje_mmap_size_class_iterator_new(Eina_File *f);
 EAPI Eina_List        *edje_mmap_collection_list(Eina_File *f);
 
 /**
- * Free file collection list
+ * @brief Frees file collection list.
  * @param lst The Eina_List of groups
  *
  * Frees the list returned by edje_mmap_collection_list().
@@ -1792,27 +1779,27 @@ EAPI Eina_List        *edje_mmap_collection_list(Eina_File *f);
 EAPI void              edje_mmap_collection_list_free(Eina_List *lst);
 
 /**
- * Determine whether a group matching glob exists in an edje mapped file.
+ * @brief Determines whether a group matching glob exists in an edje mapped file.
  * @param f The mapped file
  * @param glob A glob to match on
  *
- * @return 1 if a match is found, 0 otherwise
+ * @return @c 1 if a match is found, @c 0 otherwise
  */
 EAPI Eina_Bool         edje_mmap_group_exists(Eina_File *f, const char *glob);
 
 /**
- * Determine whether a group have 3D Scene.
+ * @brief Determines whether a group have 3D Scene.
  * @param f The mapped file
  * @param glob The group name
  *
- * @return 1 if a Scene is found is found, 0 otherwise
+ * @return @c 1 if a Scene is found is found, @c 0 otherwise
  *
  * @since 1.18
  */
 EAPI Eina_Bool         edje_mmap_3d_has(Eina_File *f, const char *group);
 
 /**
- * @brief Iterate over all the opened Edje file.
+ * @brief Iterates over all the opened Edje file.
  *
  * @return an iterator of Eina_File currently opened Edje file.
  *
@@ -1821,7 +1808,7 @@ EAPI Eina_Bool         edje_mmap_3d_has(Eina_File *f, const char *group);
 EAPI Eina_Iterator *edje_file_iterator_new(void);
 
 /**
- * Get a list of groups in an edje file
+ * @brief Gets a list of groups in an edje file.
  * @param file The path to the edje file
  *
  * @return The Eina_List of group names (char *)
@@ -1835,7 +1822,7 @@ EAPI Eina_Iterator *edje_file_iterator_new(void);
 EAPI Eina_List        *edje_file_collection_list  (const char *file);
 
 /**
- * Free file collection list
+ * @brief Frees file collection list.
  * @param lst The Eina_List of groups
  *
  * Frees the list returned by edje_file_collection_list().
@@ -1843,16 +1830,16 @@ EAPI Eina_List        *edje_file_collection_list  (const char *file);
 EAPI void             edje_file_collection_list_free (Eina_List *lst);
 
 /**
- * Determine whether a group matching glob exists in an edje file.
+ * @brief Determines whether a group matching glob exists in an edje file.
  * @param file The file path
  * @param glob A glob to match on
  *
- * @return 1 if a match is found, 0 otherwise
+ * @return @c 1 if a match is found, @c 0 otherwise
  */
 EAPI Eina_Bool        edje_file_group_exists      (const char *file, const char *glob);
 
 /**
- * Converts the given Edje file load error code into a string
+ * @brief Converts the given Edje file load error code into a string
  * describing it in English.
  *
  * @param error the error code, a value in ::Edje_Load_Error.
@@ -1873,13 +1860,11 @@ EAPI const char	      *edje_load_error_str	  (Edje_Load_Error error);
 
 /**
  * @defgroup Edje_Object_Animation Edje Object Animation
- *
+ * @ingroup Edje_Object_Group
  * @brief Functions that deal with animations.
  *
  * Edje has the ability to animate objects. One can start, stop, play,
- * pause, freeze and thaw edje animations using the functions of this section.
- *
- * @ingroup Edje_Object_Group
+ * pause, freeze, and thaw edje animations using the functions of this section.
  *
  * @{
  */
@@ -1887,7 +1872,7 @@ EAPI const char	      *edje_load_error_str	  (Edje_Load_Error error);
 /**
  * @typedef Edje_Tween_Mode
  *
- * Available tween mode for edje animations
+ * Available tween mode for edje animations.
  */
 typedef enum _Edje_Tween_Mode
 {
@@ -1946,7 +1931,7 @@ typedef enum _Edje_Action_Type
 } Edje_Action_Type;
 
 /**
- * @brief Set edje trasitions' frame time.
+ * @brief Sets edje transitions' frame time.
  *
  * @param t The frame time, in seconds. Default value is 1/30.
  *
@@ -1961,7 +1946,7 @@ typedef enum _Edje_Action_Type
 EAPI void         edje_frametime_set              (double t);
 
 /**
- * @brief Get edje trasitions' frame time.
+ * @brief Gets edje transitions' frame time.
  *
  * @return The frame time, in seconds.
  *
@@ -1974,7 +1959,7 @@ EAPI void         edje_frametime_set              (double t);
 EAPI double       edje_frametime_get              (void);
 
 /**
- * @brief Freeze Edje objects.
+ * @brief Freezes Edje objects.
  *
  * This function freezes all Edje animations in the current process.
  *
@@ -1986,7 +1971,7 @@ EAPI double       edje_frametime_get              (void);
 EAPI void         edje_freeze                     (void);
 
 /**
- * @brief Thaw Edje objects.
+ * @brief Thaws Edje objects.
  *
  * This function thaws all Edje animations in the current process.
  *
@@ -1998,7 +1983,7 @@ EAPI void         edje_freeze                     (void);
 EAPI void         edje_thaw                       (void);
 
 /**
- * @brief Set's Edje language.
+ * @brief Sets Edje language.
  *
  * This function sets the given language.
  *
@@ -2009,9 +1994,9 @@ EAPI void         edje_thaw                       (void);
 EAPI void         edje_language_set               (const char *locale);
 
 /**
- * @brief Set edje transition duration factor.
+ * @brief Sets edje transition duration factor.
  *
- * @param scale The edje trasition's duration factor (the default value is @c 1.0)
+ * @param scale The edje transition's duration factor (the default value is @c 1.0)
  *
  * This function sets the edje transition duration factor
  * It will affect the speed of transitions
@@ -2032,7 +2017,7 @@ EAPI void         edje_language_set               (const char *locale);
 EAPI void         edje_transition_duration_factor_set        (double scale);
 
 /**
- * @brief Retrieve transitions duration factor.
+ * @brief Retrieves transitions duration factor.
  *
  * @return The edje transition duration factor
  *
@@ -2051,6 +2036,7 @@ EAPI double       edje_transition_duration_factor_get                  (void);
 
 /**
  * @defgroup Edje_Object_Communication_Interface_Message Edje Communication Interface: Message
+ * @ingroup Edje_Object_Group
  *
  * @brief Functions that deal with messages.
  *
@@ -2065,8 +2051,6 @@ EAPI double       edje_transition_duration_factor_get                  (void);
  *
  * @note Messages must be handled by scripts.
  *
- * @ingroup Edje_Object_Group
- *
  * @{
  */
 
@@ -2143,7 +2127,7 @@ struct _Edje_Message_String_Float_Set
 typedef void         (*Edje_Message_Handler_Cb) (void *data, Evas_Object *obj, Edje_Message_Type type, int id, void *msg); /**< Edje message handler callback functions's prototype definition. @c data will have the auxiliary data pointer set at the time the callback registration. @c obj will be a pointer the Edje object where the message comes from. @c type will identify the type of the given message and @c msg will be a pointer the message's contents, de facto, which depend on @c type. */
 
 /**
- * @brief Process all queued up edje messages.
+ * @brief Processes all queued up edje messages.
  *
  * This function triggers the processing of messages addressed to any
  * (alive) edje objects.
@@ -2157,6 +2141,7 @@ EAPI void         edje_message_signal_process             (void);
 
 /**
  * @defgroup Edje_Perspective Edje Perspective
+ * @ingroup Edje_Object_Group
  *
  * @brief Functions that deal with 3D projection of an 2D object.
  *
@@ -2169,13 +2154,11 @@ EAPI void         edje_message_signal_process             (void);
  * affecting all the objects inside that have no particular perspective
  * set already.
  *
- * @ingroup Edje_Object_Group
- *
  * @{
  */
 
 /**
- * Creates a new perspective in the given canvas.
+ * @brief Creates a new perspective in the given canvas.
  *
  * @param e The given canvas (Evas).
  * @return An @ref Edje_Perspective object for this canvas, or @c NULL on errors.
@@ -2188,7 +2171,7 @@ EAPI void         edje_message_signal_process             (void);
  */
 EAPI Edje_Perspective       *edje_perspective_new            (Evas *e);
 /**
- * Delete the given perspective object.
+ * @brief Deletes the given perspective object.
  *
  * @param ps A valid perspective object, or @c NULL.
  *
@@ -2200,7 +2183,7 @@ EAPI Edje_Perspective       *edje_perspective_new            (Evas *e);
  */
 EAPI void                    edje_perspective_free           (Edje_Perspective *ps);
 /**
- * Setup the transform for this perspective object.
+ * @brief Sets up the transform for this perspective object.
  *
  * This sets the parameters of the perspective transformation. X, Y and Z
  * values are used. The px and py points specify the "infinite distance" point
@@ -2223,7 +2206,7 @@ EAPI void                    edje_perspective_free           (Edje_Perspective *
  */
 EAPI void                    edje_perspective_set            (Edje_Perspective *ps, Evas_Coord px, Evas_Coord py, Evas_Coord z0, Evas_Coord foc);
 /**
- * Make this perspective object be global for its canvas.
+ * @brief Makes this perspective object be global for its canvas.
  *
  * @param ps The given perspective object
  * @param global @c EINA_TRUE if the perspective should be global, @c
@@ -2247,7 +2230,7 @@ EAPI void                    edje_perspective_set            (Edje_Perspective *
  */
 EAPI void                    edje_perspective_global_set     (Edje_Perspective *ps, Eina_Bool global);
 /**
- * Get whether the given perspective object is global or not.
+ * @brief Gets whether the given perspective object is global or not.
  *
  * @param ps The given perspective object.
  * @return @c EINA_TRUE if this perspective object is global, @c EINA_FALSE
@@ -2257,7 +2240,7 @@ EAPI void                    edje_perspective_global_set     (Edje_Perspective *
  */
 EAPI Eina_Bool               edje_perspective_global_get     (const Edje_Perspective *ps);
 /**
- * Get the global perspective object set for this canvas.
+ * @brief Gets the global perspective object set for this canvas.
  *
  * @param e The given canvas (Evas).
  * @return The perspective object set as global for this canvas. Or @c NULL
@@ -2276,6 +2259,7 @@ EAPI const Edje_Perspective *edje_evas_global_perspective_get(const Evas *e);
 
 /**
  * @defgroup Edje_Audio Edje Audio
+ * @ingroup Edje_Audio
  *
  * @brief Functions to manipulate audio abilities in edje.
  *
@@ -2288,8 +2272,6 @@ EAPI const Edje_Perspective *edje_evas_global_perspective_get(const Evas *e);
  * affecting all the objects inside that have no particular perspective
  * set already.
  *
- * @ingroup Edje_Audio
- *
  * @{
  */
 
@@ -2315,7 +2297,7 @@ typedef enum _Edje_Channel
 } Edje_Channel;
 
 /**
- * Set the mute state of audio for the process as a whole
+ * @brief Sets the mute state of audio for the process as a whole.
  *
  * @param channel The channel to set the mute state of
  * @param mute The mute state
@@ -2329,7 +2311,7 @@ typedef enum _Edje_Channel
 EAPI void edje_audio_channel_mute_set(Edje_Channel channel, Eina_Bool mute);
 
 /**
- * Get the mute state of the given channel
+ * @brief Gets the mute state of the given channel.
  *
  * @param channel The channel to get the mute state of
  * @return The mute state of the channel
@@ -2341,7 +2323,7 @@ EAPI void edje_audio_channel_mute_set(Edje_Channel channel, Eina_Bool mute);
 EAPI Eina_Bool edje_audio_channel_mute_get(Edje_Channel channel);
 
 /**
- * Get the part name of an edje part object
+ * @brief Gets the part name of an edje part object.
  * @param obj An edje part object
  * @return The name of the part, if the object is an edje part, or @c NULL
  * @note If this function returns @c NULL, @p obj was not an Edje part object
@@ -2353,7 +2335,7 @@ EAPI const char *edje_object_part_object_name_get(const Evas_Object *obj);
 #ifdef EFL_BETA_API_SUPPORT
 
 /**
- * Create scene and root node which contains all 3D parts of edje object
+ * @brief Creates scene and root node which contains all 3D parts of edje object.
  * @param obj An edje part object
  * @param root node to collect all 3D parts
  * @param scene
diff --git a/src/lib/edje/Edje_Edit.h b/src/lib/edje/Edje_Edit.h
index 2b6c1c610c..7bb5a07c1f 100644
--- a/src/lib/edje/Edje_Edit.h
+++ b/src/lib/edje/Edje_Edit.h
@@ -194,12 +194,13 @@ extern "C" {
 /******************************************************************************/
 /**************************   GENERAL API   ***********************************/
 /******************************************************************************/
-/** @name General API
- *  General functions that don't fit in other cateories.
+/**
+ * @name General API
+ * General functions that don't fit in other categories.
  */ //@{
 
-/** Adds an editable Edje object to the canvas.
- *
+/**
+ * @brief Adds an editable Edje object to the canvas.
  * An Edje_Edit object is, for the most part, a standard Edje object. Only
  * difference is you can use the Edje_Edit API on them.
  *
@@ -209,19 +210,20 @@ extern "C" {
  */
 EAPI Evas_Object * edje_edit_object_add(Evas *e);
 
-/** Free a generic Eina_List of (char *) allocated by an edje_edit_*_get() function.
- *
+/**
+ * @brief Frees a generic Eina_List of (char *) allocated by an edje_edit_*_get() function.
  * @param lst List of strings to free.
  */
 EAPI void edje_edit_string_list_free(Eina_List *lst);
 
-/** Free a generic string (char *) allocated by an edje_edit_*_get() function.
- *
+/**
+ * @brief Frees a generic string (char *) allocated by an edje_edit_*_get() function.
  * @param str String to free.
  */
 EAPI void edje_edit_string_free(const char *str);
 
-/** Get the name of the program that compiled the edje file.
+/**
+ * @brief Gets the name of the program that compiled the edje file.
  * Can be 'edje_cc' or 'edje_edit'
  *
  * @param obj Object being edited.
@@ -230,8 +232,8 @@ EAPI void edje_edit_string_free(const char *str);
  */
 EAPI const char * edje_edit_compiler_get(Evas_Object *obj);
 
-/** Save the modified edje object back to his file.
- *
+/**
+ * @brief Saves the modified edje object back to his file.
  * Use this function when you are done with your editing, all the change made
  * to the current loaded group will be saved back to the original file.
  *
@@ -246,8 +248,8 @@ EAPI const char * edje_edit_compiler_get(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_save(Evas_Object *obj);
 
-/** Saves every group back into the file.
- *
+/**
+ * @brief Saves every group back into the file.
  * @param obj Object to save.
  *
  * @return @c EINA_TRUE in case of success, @c EINA_FALSE otherwise.
@@ -256,8 +258,8 @@ EAPI Eina_Bool edje_edit_save(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_save_all(Evas_Object *obj);
 
-/** Save every group into new file.
- *
+/**
+ * @brief Saves every group into new file.
  * Use this function when you need clean eet dictionary in .edj file from
  * unnecessary text entries (e.g. names of deleted groups etc.).
  *
@@ -271,8 +273,8 @@ EAPI Eina_Bool edje_edit_save_all(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_clean_save_as(Evas_Object *obj, const char* new_file_name);
 
-/** Save the group(s) back to the file, without generation source code.
- *
+/**
+ * @brief Saves the group(s) back to the file, without generation source code.
  * This function saves changes in group(s) back into the edj file. Process of
  * saving takes a bit time in compare with @see edje_edit_save() and @see edje_edit_save_all(),
  * because this function DOES NOT generate source code for groups.
@@ -292,7 +294,8 @@ EAPI Eina_Bool edje_edit_clean_save_as(Evas_Object *obj, const char* new_file_na
  */
 EAPI Eina_Bool edje_edit_without_source_save(Evas_Object *obj, Eina_Bool current_group);
 
-/** Print on standard output many information about the internal status
+/**
+ * @brief Prints on standard output many information about the internal status
  * of the edje object.
  *
  * This is probably only useful to debug.
@@ -306,12 +309,13 @@ EAPI void edje_edit_print_internal_status(Evas_Object *obj);
 /******************************************************************************/
 /**************************   GROUPS API   ************************************/
 /******************************************************************************/
-/** @name Groups API
- *  Functions to deal with groups property (see @ref edcref).
+/**
+ * @name Groups API
+ * Functions to deal with groups property (see @ref edcref).
  */ //@{
 
 /**
- * @brief Add an edje (empty) group to an edje object's group set.
+ * @brief Adds an edje (empty) group to an edje object's group set.
  *
  * @param obj The pointer to edje object.
  * @param name The name of the group.
@@ -330,7 +334,7 @@ EAPI void edje_edit_print_internal_status(Evas_Object *obj);
 EAPI Eina_Bool edje_edit_group_add(Evas_Object *obj, const char *name);
 
 /**
- * @brief Copy whole group and all it's data into separate group.
+ * @brief Copies whole group and all it's data into separate group.
  *
  * @param obj The pointer to edje object.
  * @param group_name The name of the group.
@@ -354,7 +358,7 @@ EAPI Eina_Bool edje_edit_group_add(Evas_Object *obj, const char *name);
 EAPI Eina_Bool edje_edit_group_copy(Evas_Object *obj, const char *group_name, const char *copy_name);
 
 /**
- * @brief Delete the specified group from the edje file.
+ * @brief Deletes the specified group from the edje file.
  *
  * @param obj The pointer to the edje object.
  * @param group_name Group to delete.
@@ -375,8 +379,8 @@ EAPI Eina_Bool edje_edit_group_copy(Evas_Object *obj, const char *group_name, co
  */
 EAPI Eina_Bool edje_edit_group_del(Evas_Object *obj, const char *group_name);
 
-/** Check if a group with the given name exist in the edje.
- *
+/**
+ * @brief Checks if a group with the given name exist in the edje.
  * @param obj Object being edited.
  * @param group Group name to check for.
  *
@@ -384,7 +388,8 @@ EAPI Eina_Bool edje_edit_group_del(Evas_Object *obj, const char *group_name);
  */
 EAPI Eina_Bool edje_edit_group_exist(Evas_Object *obj, const char *group);
 
-/** Set a new name for the current open group.
+/**
+ * @brief Sets a new name for the current open group.
  *
  * You can only rename a group that is currently loaded
  * Note that the relative getter function don't exist as it doesn't make sense ;)
@@ -395,7 +400,8 @@ EAPI Eina_Bool edje_edit_group_exist(Evas_Object *obj, const char *group);
  */
 EAPI Eina_Bool edje_edit_group_name_set(Evas_Object *obj, const char *new_name);
 
-/** Get the group minimum width.
+/**
+ * @brief Gets the group minimum width.
  *
  * @param obj Object being edited.
  *
@@ -403,7 +409,8 @@ EAPI Eina_Bool edje_edit_group_name_set(Evas_Object *obj, const char *new_name);
  */
 EAPI int edje_edit_group_min_w_get(Evas_Object *obj);
 
-/** Set the group minimum width.
+/**
+ * @brief Sets the group minimum width.
  *
  * @param obj Object being edited.
  * @param w New minimum width for the group.
@@ -412,15 +419,17 @@ EAPI int edje_edit_group_min_w_get(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_group_min_w_set(Evas_Object *obj, int w);
 
-/** Get the group minimum height.
+/**
+ * @brief Gets the group minimum height.
  *
  * @param obj Object being edited.
  *
- * @return The minimum height set for the group. -1 if an error occurred.
+ * @return The minimum height set for the group. @c -1 if an error occurred.
  */
 EAPI int edje_edit_group_min_h_get(Evas_Object *obj);
 
-/** Set the group minimum height.
+/**
+ * @brief Sets the group minimum height.
  *
  * @param obj Object being edited.
  * @param h New minimum height for the group.
@@ -429,15 +438,17 @@ EAPI int edje_edit_group_min_h_get(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_group_min_h_set(Evas_Object *obj, int h);
 
-/** Get the group maximum width.
+/**
+ * @brief Gets the group maximum width.
  *
  * @param obj Object being edited.
  *
- * @return The maximum width set for the group. -1 if an error occurred.
+ * @return The maximum width set for the group. @c -1 if an error occurred.
  */
 EAPI int edje_edit_group_max_w_get(Evas_Object *obj);
 
-/** Set the group maximum width.
+/**
+ * @brief Sets the group maximum width.
  *
  * @param obj Object being edited.
  * @param w New maximum width for the group.
@@ -446,15 +457,17 @@ EAPI int edje_edit_group_max_w_get(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_group_max_w_set(Evas_Object *obj, int w);
 
-/** Get the group maximum height.
+/**
+ * @brief Gets the group maximum height.
  *
  * @param obj Object being edited.
  *
- * @return The maximum height set for the group. -1 if an error occurred.
+ * @return The maximum height set for the group. @c -1 if an error occurred.
  */
 EAPI int edje_edit_group_max_h_get(Evas_Object *obj);
 
-/** Set the group maximum height.
+/**
+ * @brief Sets the group maximum height.
  *
  * @param obj Object being edited.
  * @param h New maximum height for the group.
@@ -463,7 +476,8 @@ EAPI int edje_edit_group_max_h_get(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_group_max_h_set(Evas_Object *obj, int h);
 
-/** Get the group broadcast_signal.
+/**
+ * @brief Gets the group broadcast_signal.
  *
  * @param obj Object being edited.
  *
@@ -472,7 +486,8 @@ EAPI Eina_Bool edje_edit_group_max_h_set(Evas_Object *obj, int h);
  */
 EAPI Eina_Bool edje_edit_group_broadcast_signal_get(Evas_Object *obj);
 
-/** Set the group broadcast signal.
+/**
+ * @brief Sets the group broadcast signal.
  *
  * @param obj Object being edited.
  * @param bs @c EINA_TRUE if group will accept broadcast signal, @c EINA_FALSE otherwise.
@@ -485,7 +500,8 @@ EAPI Eina_Bool edje_edit_group_broadcast_signal_set(Evas_Object *obj, Eina_Bool
 //@}
 
 
-/** Retrieves a list with the item names inside the vertical limits block at the group level.
+/**
+ * @brief Retrieves a list with the item names inside the vertical limits block at the group level.
  *
  * @param obj Object being edited.
  *
@@ -493,7 +509,8 @@ EAPI Eina_Bool edje_edit_group_broadcast_signal_set(Evas_Object *obj, Eina_Bool
  */
 EAPI Eina_List * edje_edit_group_limits_vertical_list_get(Evas_Object *obj);
 
-/** Delete given pair name-value from the vertical limits block at the group level.
+/**
+ * @brief Deletes given pair name-value from the vertical limits block at the group level.
  *
  * @param obj Object being edited.
  * @param name Limit name.
@@ -503,7 +520,8 @@ EAPI Eina_List * edje_edit_group_limits_vertical_list_get(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_group_limits_vertical_del(Evas_Object *obj, const char *name, int value);
 
-/** Add given pair name-value to the vertical limits block at the group level.
+/**
+ * @brief Adds given pair name-value to the vertical limits block at the group level.
  *
  * @param obj Object being edited.
  * @param name Limit name.
@@ -513,7 +531,8 @@ EAPI Eina_Bool edje_edit_group_limits_vertical_del(Evas_Object *obj, const char
  */
 EAPI Eina_Bool edje_edit_group_limits_vertical_add(Evas_Object *obj, const char *name, int value);
 
-/** Retrieves a list with the item names inside the horizontal limits block at the group level.
+/**
+ * @brief Retrieves a list with the item names inside the horizontal limits block at the group level.
  *
  * @param obj Object being edited.
  *
@@ -521,7 +540,8 @@ EAPI Eina_Bool edje_edit_group_limits_vertical_add(Evas_Object *obj, const char
  */
 EAPI Eina_List * edje_edit_group_limits_horizontal_list_get(Evas_Object *obj);
 
-/** Delete given pair name-value from the horizontal limits block at the group level.
+/**
+ * @brief Deletes given pair name-value from the horizontal limits block at the group level.
  *
  * @param obj Object being edited.
  * @param name Limit name.
@@ -531,7 +551,8 @@ EAPI Eina_List * edje_edit_group_limits_horizontal_list_get(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_group_limits_horizontal_del(Evas_Object *obj, const char *name, int value);
 
-/** Add given pair name-value to the horizontal limits block at the group level.
+/**
+ * @brief Adds given pair name-value to the horizontal limits block at the group level.
  *
  * @param obj Object being edited.
  * @param name Limit name.
@@ -541,7 +562,8 @@ EAPI Eina_Bool edje_edit_group_limits_horizontal_del(Evas_Object *obj, const cha
  */
 EAPI Eina_Bool edje_edit_group_limits_horizontal_add(Evas_Object *obj, const char *name, int value);
 
-/** Free an Eina_List of (Edje_Edit_List *) allocated by an edje_edit_limits_vertical_list_get() or edje_edit_limits_horizontal_list_get() functions.
+/**
+ @brief Frees an Eina_List of (Edje_Edit_List *) allocated by an edje_edit_limits_vertical_list_get() or edje_edit_limits_horizontal_list_get() functions.
  *
  * @param lst List to free.
  */
@@ -550,12 +572,13 @@ EAPI void edje_edit_limits_list_free(Eina_List *lst);
 /******************************************************************************/
 /**************************   ALIAS API   **************************************/
 /******************************************************************************/
-/** @name Alias API
- *  Functions to deal with aliases that just another names of the group in the edje (see @ref edcref).
+/**
+ * @name Alias API
+ * Functions to deal with aliases that just another names of the group in the edje (see @ref edcref).
  */ //@{
 
 /**
- * Retrieves a list of aliases for this group.
+ * @brief Retrieves a list of aliases for this group.
  * If given group name is an alias name then this function will return NULL.
  *
  * @attention After you done using returned list, please use edje_edit_string_list_free to free this list.
@@ -568,7 +591,7 @@ EAPI void edje_edit_limits_list_free(Eina_List *lst);
 EAPI Eina_List * edje_edit_group_aliases_get(Evas_Object *obj, const char *group_name);
 
 /**
- * Check if this group is an alias name.
+ * @brief Checks if this group is an alias name.
  *
  * @param obj Object being edited.
  * @param alias_name Group name that is alias.
@@ -578,7 +601,7 @@ EAPI Eina_List * edje_edit_group_aliases_get(Evas_Object *obj, const char *group
 EAPI Eina_Bool edje_edit_group_alias_is(Evas_Object *obj, const char *alias_name);
 
 /**
- * Return the main group name that is aliased by given alias name.
+ * @brief Returns the main group name that is aliased by given alias name.
  *
  * @attention After you done using this string, please use edje_edit_string_free to free this string.
  *
@@ -590,7 +613,7 @@ EAPI Eina_Bool edje_edit_group_alias_is(Evas_Object *obj, const char *alias_name
 EAPI const char * edje_edit_group_aliased_get(Evas_Object *obj, const char *alias_name);
 
 /**
- * Add new alias to the given group.
+ * @brief Adds new alias to the given group.
  *
  * @attention when aliasing a group, be sure that the given group_name is no an alias.
  *
@@ -606,11 +629,13 @@ EAPI Eina_Bool edje_edit_group_alias_add(Evas_Object *obj, const char *group_nam
 /******************************************************************************/
 /**************************   DATA API   **************************************/
 /******************************************************************************/
-/** @name Data API
- *  Functions to deal with data embedded in the edje (see @ref edcref).
+/**
+ * @name Data API
+ * Functions to deal with data embedded in the edje (see @ref edcref).
  */ //@{
 
-/** Retrieves a list with the item names inside the data block.
+/**
+ * @brief Retrieves a list with the item names inside the data block.
  *
  * @param obj Object being edited.
  *
@@ -618,7 +643,8 @@ EAPI Eina_Bool edje_edit_group_alias_add(Evas_Object *obj, const char *group_nam
  */
 EAPI Eina_List * edje_edit_data_list_get(Evas_Object *obj);
 
-/** Create a new *global* data object in the given edje file.
+/**
+ * @brief Creates a new *global* data object in the given edje file.
  *
  * If another data entry with the same name exists, nothing is created and
  * EINA_FALSE is returned.
@@ -631,7 +657,8 @@ EAPI Eina_List * edje_edit_data_list_get(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_data_add(Evas_Object *obj, const char *itemname, const char *value);
 
-/** Delete the given data object from edje.
+/**
+ * @brief Deletes the given data object from edje.
  *
  * @param obj Object being edited.
  * @param itemname Data entry to remove from the global data block.
@@ -640,7 +667,8 @@ EAPI Eina_Bool edje_edit_data_add(Evas_Object *obj, const char *itemname, const
  */
 EAPI Eina_Bool edje_edit_data_del(Evas_Object *obj, const char *itemname);
 
-/** Get the data associated with the given itemname.
+/**
+ * @brief Gets the data associated with the given itemname.
  *
  * @param obj Object being edited.
  * @param itemname Name of the data entry to fetch the value for.
@@ -649,7 +677,8 @@ EAPI Eina_Bool edje_edit_data_del(Evas_Object *obj, const char *itemname);
  */
 EAPI const char * edje_edit_data_value_get(Evas_Object *obj, const char *itemname);
 
-/** Set the data associated with the given itemname.
+/**
+ * @brief Sets the data associated with the given itemname.
  *
  * @param obj Object being edited.
  * @param itemname Name of data entry to change the value.
@@ -659,7 +688,8 @@ EAPI const char * edje_edit_data_value_get(Evas_Object *obj, const char *itemnam
  */
 EAPI Eina_Bool edje_edit_data_value_set(Evas_Object *obj, const char *itemname, const char *value);
 
-/** Change the name of the given data object.
+/**
+ * @brief Changes the name of the given data object.
  *
  * @param obj Object being edited.
  * @param itemname Data entry to rename.
@@ -669,7 +699,8 @@ EAPI Eina_Bool edje_edit_data_value_set(Evas_Object *obj, const char *itemname,
  */
 EAPI Eina_Bool edje_edit_data_name_set(Evas_Object *obj, const char *itemname, const char *newname);
 
-/** Retrieves a list with the item names inside the data block at the group level.
+/**
+ * @brief Retrieves a list with the item names inside the data block at the group level.
  *
  * @param obj Object being edited.
  *
@@ -677,7 +708,8 @@ EAPI Eina_Bool edje_edit_data_name_set(Evas_Object *obj, const char *itemname, c
  */
 EAPI Eina_List * edje_edit_group_data_list_get(Evas_Object *obj);
 
-/** Create a new data object in the given edje file *belonging to the current group*.
+/**
+ * @brief Creates a new data object in the given edje file *belonging to the current group*.
  *
  * If another data entry with the same name exists,
  * nothing is created and EINA_FALSE is returned.
@@ -690,7 +722,8 @@ EAPI Eina_List * edje_edit_group_data_list_get(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_group_data_add(Evas_Object *obj, const char *itemname, const char *value);
 
-/** Delete the given data object from the group.
+/**
+ * @brief Deletes the given data object from the group.
  *
  * @param obj Object being edited.
  * @param itemname Name of the data entry to remove.
@@ -699,7 +732,8 @@ EAPI Eina_Bool edje_edit_group_data_add(Evas_Object *obj, const char *itemname,
  */
 EAPI Eina_Bool edje_edit_group_data_del(Evas_Object *obj, const char *itemname);
 
-/** Get the data associated with the given itemname.
+/**
+ * @brief Gets the data associated with the given itemname.
  *
  * @param obj Object being edited.
  * @param itemname Name of the data entry.
@@ -708,7 +742,8 @@ EAPI Eina_Bool edje_edit_group_data_del(Evas_Object *obj, const char *itemname);
  */
 EAPI const char * edje_edit_group_data_value_get(Evas_Object *obj, const char *itemname);
 
-/** Set the data associated with the given itemname.
+/**
+ * @brief Sets the data associated with the given itemname.
  *
  * @param obj Object being edited.
  * @param itemname Name of the data entry to set the value.
@@ -718,7 +753,8 @@ EAPI const char * edje_edit_group_data_value_get(Evas_Object *obj, const char *i
  */
 EAPI Eina_Bool edje_edit_group_data_value_set(Evas_Object *obj, const char *itemname, const char *value);
 
-/** Change the name of the given data object.
+/**
+ * @brief Changes the name of the given data object.
  *
  * @param obj Object being edited.
  * @param itemname Name of the data entry to rename.
@@ -733,11 +769,13 @@ EAPI Eina_Bool edje_edit_group_data_name_set(Evas_Object *obj, const char *itemn
 /*****************************************************************************/
 /***********************   SIZE CLASSES API   ********************************/
 /*****************************************************************************/
-/** @name Size Classes API
- *  Functions to deal with Size Classes (see @ref edcref).
+/**
+ * @name Size Classes API
+ * Functions to deal with Size Classes (see @ref edcref).
  */ //@{
 
-/** Get the list of all the Size Classes in the given edje object.
+/**
+ * @brief Gets the list of all the Size Classes in the given edje object.
  *
  * @param obj Object being edited.
  *
@@ -751,7 +789,8 @@ EAPI Eina_Bool edje_edit_group_data_name_set(Evas_Object *obj, const char *itemn
 EAPI Eina_List *
 edje_edit_size_classes_list_get(Evas_Object *obj);
 
-/** Create a new size class object in the given edje.
+/**
+ * @brief Creates a new size class object in the given edje.
  *
  * If class is already exist then nothing is created and EINA_FALSE returned.
  *
@@ -765,7 +804,8 @@ edje_edit_size_classes_list_get(Evas_Object *obj);
 EAPI Eina_Bool
 edje_edit_size_class_add(Evas_Object *obj, const char *name);
 
-/** Delete size class object from edje.
+/**
+ * @brief Deletes size class object from edje.
  *
  * @param obj Object being edited.
  * @param name Size class to delete.
@@ -777,7 +817,8 @@ edje_edit_size_class_add(Evas_Object *obj, const char *name);
 EAPI Eina_Bool
 edje_edit_size_class_del(Evas_Object *obj, const char *name);
 
-/** Change name of a size class.
+/**
+ * @brief Changes name of a size class.
  *
  * @param obj Object being edited.
  * @param name Size class to rename.
@@ -790,7 +831,8 @@ edje_edit_size_class_del(Evas_Object *obj, const char *name);
 EAPI Eina_Bool
 edje_edit_size_class_name_set(Evas_Object *obj, const char *name, const char *newname);
 
-/** Return width min size of specified size class.
+/**
+ * @brief Returns width min size of specified size class.
  *
  * @param obj Object being edited.
  * @param class_name Size class to fetch values.
@@ -802,7 +844,8 @@ edje_edit_size_class_name_set(Evas_Object *obj, const char *name, const char *ne
 EAPI Evas_Coord
 edje_edit_size_class_min_w_get(Evas_Object *obj, const char *class_name);
 
-/** Set width min size of specified size class.
+/**
+ * @brief Sets width min size of specified size class.
  *
  * @param obj Object being edited.
  * @param class_name Size class to set values.
@@ -815,7 +858,8 @@ edje_edit_size_class_min_w_get(Evas_Object *obj, const char *class_name);
 EAPI Eina_Bool
 edje_edit_size_class_min_w_set(Evas_Object *obj, const char *class_name, Evas_Coord size);
 
-/** Return width max size of specified size class.
+/**
+ * @brief Returns width max size of specified size class.
  *
  * @param obj Object being edited.
  * @param class_name Size class to fetch values.
@@ -827,7 +871,8 @@ edje_edit_size_class_min_w_set(Evas_Object *obj, const char *class_name, Evas_Co
 EAPI Evas_Coord
 edje_edit_size_class_max_w_get(Evas_Object *obj, const char *class_name);
 
-/** Set width max size of specified size class.
+/**
+ * @brief Sets width max size of specified size class.
  *
  * @param obj Object being edited.
  * @param class_name Size class to set values.
@@ -840,7 +885,8 @@ edje_edit_size_class_max_w_get(Evas_Object *obj, const char *class_name);
 EAPI Eina_Bool
 edje_edit_size_class_max_w_set(Evas_Object *obj, const char *class_name, Evas_Coord size);
 
-/** Return height min size of specified size class.
+/**
+ * @brief Returns height min size of specified size class.
  *
  * @param obj Object being edited.
  * @param class_name Size class to fetch values.
@@ -852,7 +898,8 @@ edje_edit_size_class_max_w_set(Evas_Object *obj, const char *class_name, Evas_Co
 EAPI Evas_Coord
 edje_edit_size_class_min_h_get(Evas_Object *obj, const char *class_name);
 
-/** Set height min size of specified size class.
+/**
+ * @brief Sets height min size of specified size class.
  *
  * @param obj Object being edited.
  * @param class_name Size class to set values.
@@ -865,7 +912,8 @@ edje_edit_size_class_min_h_get(Evas_Object *obj, const char *class_name);
 EAPI Eina_Bool
 edje_edit_size_class_min_h_set(Evas_Object *obj, const char *class_name, Evas_Coord size);
 
-/** Return height max size of specified size class.
+/**
+ * @brief Returns height max size of specified size class.
  *
  * @param obj Object being edited.
  * @param class_name Size class to fetch values.
@@ -877,7 +925,8 @@ edje_edit_size_class_min_h_set(Evas_Object *obj, const char *class_name, Evas_Co
 EAPI Evas_Coord
 edje_edit_size_class_max_h_get(Evas_Object *obj, const char *class_name);
 
-/** Set height max size of specified size class.
+/**
+ * @brief Sets height max size of specified size class.
  *
  * @param obj Object being edited.
  * @param class_name Size class to set values.
@@ -894,11 +943,13 @@ edje_edit_size_class_max_h_set(Evas_Object *obj, const char *class_name, Evas_Co
 /*****************************************************************************/
 /***********************   TEXT CLASSES API   ********************************/
 /*****************************************************************************/
-/** @name Text Classes API
- *  Functions to deal with Text Classes (see @ref edcref).
+/**
+ * @name Text Classes API
+ * Functions to deal with Text Classes (see @ref edcref).
  */ //@{
 
-/** Get the list of all the Text Classes in the given edje object.
+/**
+ * @brief Gets the list of all the Text Classes in the given edje object.
  *
  * @param obj Object being edited.
  *
@@ -912,7 +963,8 @@ edje_edit_size_class_max_h_set(Evas_Object *obj, const char *class_name, Evas_Co
 EAPI Eina_List *
 edje_edit_text_classes_list_get(Evas_Object *obj);
 
-/** Create a new text class object in the given edje.
+/**
+ * @brief Creates a new text class object in the given edje.
  *
  * If class is already exist then nothing is created and EINA_FALSE returned.
  *
@@ -926,7 +978,8 @@ edje_edit_text_classes_list_get(Evas_Object *obj);
 EAPI Eina_Bool
 edje_edit_text_class_add(Evas_Object *obj, const char *name);
 
-/** Delete text class object from edje.
+/**
+ * @brief Deletes text class object from edje.
  *
  * @param obj Object being edited.
  * @param name Text class to delete.
@@ -938,7 +991,8 @@ edje_edit_text_class_add(Evas_Object *obj, const char *name);
 EAPI Eina_Bool
 edje_edit_text_class_del(Evas_Object *obj, const char *name);
 
-/** Change name of a text class.
+/**
+ * @brief Changes name of a text class.
  *
  * @param obj Object being edited.
  * @param name Text class to rename.
@@ -951,7 +1005,8 @@ edje_edit_text_class_del(Evas_Object *obj, const char *name);
 EAPI Eina_Bool
 edje_edit_text_class_name_set(Evas_Object *obj, const char *name, const char *newname);
 
-/** Return font name of specified text class.
+/**
+ * @brief Returns font name of specified text class.
  *
  * @param obj Object being edited.
  * @param class_name Text class to fetch values.
@@ -963,7 +1018,8 @@ edje_edit_text_class_name_set(Evas_Object *obj, const char *name, const char *ne
 EAPI Eina_Stringshare *
 edje_edit_text_class_font_get(Evas_Object *obj, const char *class_name);
 
-/** Set font for the given text class.
+/**
+ * @brief Sets font for the given text class.
  *
  * NULL is possible value.
  *
@@ -978,7 +1034,8 @@ edje_edit_text_class_font_get(Evas_Object *obj, const char *class_name);
 EAPI Eina_Bool
 edje_edit_text_class_font_set(Evas_Object *obj, const char *class_name, const char *font);
 
-/** Return font size of specified text class.
+/**
+ * @brief Returns font size of specified text class.
  *
  * @param obj Object being edited.
  * @param class_name Text class to fetch values.
@@ -990,7 +1047,8 @@ edje_edit_text_class_font_set(Evas_Object *obj, const char *class_name, const ch
 EAPI Evas_Font_Size
 edje_edit_text_class_size_get(Evas_Object *obj, const char *class_name);
 
-/** Set font size for specified text class
+/**
+ * @brief Sets font size for specified text class
  *
  * @param obj Object being edited.
  * @param class_name Text class to set values.
@@ -1008,11 +1066,13 @@ edje_edit_text_class_size_set(Evas_Object *obj, const char *class_name, Evas_Fon
 /******************************************************************************/
 /***********************   COLOR CLASSES API   ********************************/
 /******************************************************************************/
-/** @name Color Classes API
- *  Functions to deal with Color Classes (see @ref edcref).
+/**
+ * @name Color Classes API
+ * Functions to deal with Color Classes (see @ref edcref).
  */ //@{
 
-/** Get the list of all the Color Classes in the given edje object.
+/**
+ * @brief Gets the list of all the Color Classes in the given edje object.
  *
  * @param obj Object being edited.
  *
@@ -1020,7 +1080,8 @@ edje_edit_text_class_size_set(Evas_Object *obj, const char *class_name, Evas_Fon
  */
 EAPI Eina_List * edje_edit_color_classes_list_get(Evas_Object *obj);
 
-/** Create a new color class object in the given edje.
+/**
+ * @brief Creates a new color class object in the given edje.
  *
  * If another class with the same name exists nothing is created and EINA_FALSE is returned.
  *
@@ -1031,7 +1092,8 @@ EAPI Eina_List * edje_edit_color_classes_list_get(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_color_class_add(Evas_Object *obj, const char *name);
 
-/** Delete the given class object from edje.
+/**
+ * @brief Deletes the given class object from edje.
  *
  * @param obj Object being edited.
  * @param name Color class to delete.
@@ -1040,7 +1102,8 @@ EAPI Eina_Bool edje_edit_color_class_add(Evas_Object *obj, const char *name);
  */
 EAPI Eina_Bool edje_edit_color_class_del(Evas_Object *obj, const char *name);
 
-/** Get all the colors that compose the class.
+/**
+ * @brief Gets all the colors that compose the class.
  *
  * You can pass NULL to colors you are not intrested in.
  *
@@ -1063,7 +1126,8 @@ EAPI Eina_Bool edje_edit_color_class_del(Evas_Object *obj, const char *name);
  */
 EAPI Eina_Bool edje_edit_color_class_colors_get(Evas_Object *obj, const char *class_name, int *r, int *g, int *b, int *a, int *r2, int *g2, int *b2, int *a2, int *r3, int *g3, int *b3, int *a3);
 
-/** Set the colors for the given color class.
+/**
+ * @brief Sets the colors for the given color class.
  *
  * If you set a color to -1 it will not be touched.
  *
@@ -1086,7 +1150,8 @@ EAPI Eina_Bool edje_edit_color_class_colors_get(Evas_Object *obj, const char *cl
  */
 EAPI Eina_Bool edje_edit_color_class_colors_set(Evas_Object *obj, const char *class_name, int r, int g, int b, int a, int r2, int g2, int b2, int a2, int r3, int g3, int b3, int a3);
 
-/** Change the name of a color class.
+/**
+ * @brief Changes the name of a color class.
  *
  * @param obj Object being edited.
  * @param name Color class to rename.
@@ -1096,7 +1161,8 @@ EAPI Eina_Bool edje_edit_color_class_colors_set(Evas_Object *obj, const char *cl
  */
 EAPI Eina_Bool edje_edit_color_class_name_set(Evas_Object *obj, const char *name, const char *newname);
 
-/** Get the description of a color class.
+/**
+ * @brief Gets the description of a color class.
  *
  * @param obj Object being edited.
  * @param name Color class to get the description of.
@@ -1106,7 +1172,8 @@ EAPI Eina_Bool edje_edit_color_class_name_set(Evas_Object *obj, const char *name
  */
 EAPI Eina_Stringshare *edje_edit_color_class_description_get(Evas_Object *obj, const char *class_name);
 
-/** Change the description of a color class.
+/**
+ * @brief Changes the description of a color class.
  *
  * @param obj Object being edited.
  * @param name Color class to edit.
@@ -1122,11 +1189,13 @@ EAPI Eina_Bool edje_edit_color_class_description_set(Evas_Object *obj, const cha
 /******************************************************************************/
 /**************************   TEXT STYLES *************************************/
 /******************************************************************************/
-/** @name Text styles API
- *  Functions to deal with text styles (see @ref edcref).
+/**
+ * @name Text styles API
+ * Functions to deal with text styles (see @ref edcref).
  */ //@{
 
-/** Get the list of all the text styles in the given edje object.
+/**
+ * @brief Gets the list of all the text styles in the given edje object.
  *
  * @param obj Object being edited.
  *
@@ -1134,7 +1203,8 @@ EAPI Eina_Bool edje_edit_color_class_description_set(Evas_Object *obj, const cha
  */
 EAPI Eina_List * edje_edit_styles_list_get(Evas_Object *obj);
 
-/** Create a new text style object in the given edje.
+/**
+ * @brief Creates a new text style object in the given edje.
  *
  * If another style with the same name exists nothing is created and EINA_FALSE is returned.
  *
@@ -1145,7 +1215,8 @@ EAPI Eina_List * edje_edit_styles_list_get(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_style_add(Evas_Object *obj, const char *style);
 
-/** Delete the given text style and all the child tags.
+/**
+ * @brief Deletes the given text style and all the child tags.
  *
  * @param obj Object being edited.
  * @param style Style to delete.
@@ -1154,7 +1225,8 @@ EAPI Eina_Bool edje_edit_style_add(Evas_Object *obj, const char *style);
  */
 EAPI Eina_Bool edje_edit_style_del(Evas_Object *obj, const char *style);
 
-/** Get the list of all the tags name in the given text style.
+/**
+ * @brief Gets the list of all the tags name in the given text style.
  *
  * @param obj Object being edited.
  * @param style Style to get the tags for.
@@ -1163,7 +1235,8 @@ EAPI Eina_Bool edje_edit_style_del(Evas_Object *obj, const char *style);
  */
 EAPI Eina_List * edje_edit_style_tags_list_get(Evas_Object *obj, const char *style);
 
-/** Get the value of the given tag.
+/**
+ * @brief Gets the value of the given tag.
  *
  * @param obj Object being edited.
  * @param style Style containing the tag being.
@@ -1173,7 +1246,8 @@ EAPI Eina_List * edje_edit_style_tags_list_get(Evas_Object *obj, const char *sty
  */
 EAPI const char * edje_edit_style_tag_value_get(Evas_Object *obj, const char *style, const char *tag);
 
-/** Set the value of the given tag.
+/**
+ * @brief Sets the value of the given tag.
  *
  * @param obj Object being edited.
  * @param style Style containing the tag to change.
@@ -1184,7 +1258,8 @@ EAPI const char * edje_edit_style_tag_value_get(Evas_Object *obj, const char *st
  */
 EAPI Eina_Bool edje_edit_style_tag_value_set(Evas_Object *obj, const char *style, const char *tag, const char *new_value);
 
-/** Set the name of the given tag.
+/**
+ * @brief Sets the name of the given tag.
  *
  * @param obj Object being edited.
  * @param style Style containing the tag to rename.
@@ -1195,7 +1270,8 @@ EAPI Eina_Bool edje_edit_style_tag_value_set(Evas_Object *obj, const char *style
  */
 EAPI Eina_Bool edje_edit_style_tag_name_set(Evas_Object *obj, const char *style, const char *tag, const char *new_name);
 
-/** Add a new tag to the given text style.
+/**
+ @ @brief Adds a new tag to the given text style.
  *
  * If another tag with the same name exists nothing is created and EINA_FALSE is returned.
  *
@@ -1207,7 +1283,8 @@ EAPI Eina_Bool edje_edit_style_tag_name_set(Evas_Object *obj, const char *style,
  */
 EAPI Eina_Bool edje_edit_style_tag_add(Evas_Object *obj, const char *style, const char *tag_name);
 
-/** Delete the given tag.
+/**
+ * @brief Deletes the given tag.
  *
  * @param obj Object being edited.
  * @param style Style from where to remove the tag.
@@ -1222,11 +1299,13 @@ EAPI Eina_Bool edje_edit_style_tag_del(Evas_Object *obj, const char *style, cons
 /******************************************************************************/
 /************************   EXTERNALS API   ***********************************/
 /******************************************************************************/
-/** @name Externals API
- *  Functions to deal with list of external modules (see @ref edcref).
+/**
+ * @name Externals API
+ * Functions to deal with list of external modules (see @ref edcref).
  */ //@{
 
-/** Get the list of all the externals requested in the given edje object.
+/**
+ * @brief Gets the list of all the externals requested in the given edje object.
  *
  * @param obj Object being edited.
  *
@@ -1234,7 +1313,8 @@ EAPI Eina_Bool edje_edit_style_tag_del(Evas_Object *obj, const char *style, cons
  */
 EAPI Eina_List * edje_edit_externals_list_get(Evas_Object *obj);
 
-/** Add an external module to be requested on edje load.
+/**
+ * @brief Adds an external module to be requested on edje load.
  *
  * @param obj Object being edited.
  * @param external Name of the external module to add to the list of autoload.
@@ -1243,7 +1323,8 @@ EAPI Eina_List * edje_edit_externals_list_get(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_external_add(Evas_Object *obj, const char *external);
 
-/** Delete the given external from the list.
+/**
+ * @brief Deletes the given external from the list.
  *
  * @param obj Object being edited.
  * @param external Name of the external module to remove from the autoload list.
@@ -1257,11 +1338,13 @@ EAPI Eina_Bool edje_edit_external_del(Evas_Object *obj, const char *external);
 /******************************************************************************/
 /**************************   PARTS API   *************************************/
 /******************************************************************************/
-/** @name Parts API
- *  Functions to deal with part objects (see @ref edcref).
+/**
+ * @name Parts API
+ * Functions to deal with part objects (see @ref edcref).
  */ //@{
 
-/** Get the select mode for a textblock part
+/**
+ * @brief Gets the select mode for a textblock part.
 
  * @param obj Object being edited.
  * @param part Name of the part.
@@ -1271,7 +1354,8 @@ EAPI Eina_Bool edje_edit_external_del(Evas_Object *obj, const char *external);
  */
 EAPI Edje_Edit_Select_Mode edje_edit_part_select_mode_get(Evas_Object *obj, const char *part);
 
-/** Set the select mode for a textblock part
+/**
+ * @brief Sets the select mode for a textblock part.
  *
  * @param obj Object being edited.
  * @param part Name of the part.
@@ -1283,7 +1367,8 @@ EAPI Edje_Edit_Select_Mode edje_edit_part_select_mode_get(Evas_Object *obj, cons
  */
 EAPI Eina_Bool edje_edit_part_select_mode_set(Evas_Object *obj, const char *part, Edje_Edit_Select_Mode mode);
 
-/** Get the edit mode for a textblock part
+/**
+ * @brief Gets the edit mode for a textblock part.
  *
  * @param obj Object being edited.
  * @param part Name of the part.
@@ -1293,7 +1378,8 @@ EAPI Eina_Bool edje_edit_part_select_mode_set(Evas_Object *obj, const char *part
  */
 EAPI Edje_Edit_Entry_Mode edje_edit_part_entry_mode_get(Evas_Object *obj, const char *part);
 
-/** Set the edit mode for a textblock part
+/**
+ * @brief Sets the edit mode for a textblock part.
  *
  * @param obj Object being edited.
  * @param part Name of the part.
@@ -1305,7 +1391,8 @@ EAPI Edje_Edit_Entry_Mode edje_edit_part_entry_mode_get(Evas_Object *obj, const
  */
 EAPI Eina_Bool edje_edit_part_entry_mode_set(Evas_Object *obj, const char *part, Edje_Edit_Entry_Mode mode);
 
-/** Get the list of all the parts in the given edje object.
+/**
+ * @brief Gets the list of all the parts in the given edje object.
  *
  * @param obj Object being edited.
  *
@@ -1316,7 +1403,8 @@ EAPI Eina_Bool edje_edit_part_entry_mode_set(Evas_Object *obj, const char *part,
  */
 EAPI Eina_List * edje_edit_parts_list_get(Evas_Object *obj);
 
-/** Create a new part in the given edje.
+/**
+ * @brief Creates a new part in the given edje.
  *
  * If another part with the same name just exists nothing is created and EINA_FALSE is returned.
  * Note that this function also create a default description for the part.
@@ -1329,7 +1417,8 @@ EAPI Eina_List * edje_edit_parts_list_get(Evas_Object *obj);
  */
 EAPI Eina_Bool edje_edit_part_add(Evas_Object *obj, const char *name, Edje_Part_Type type);
 
-/** Create a new part of type EXTERNAL in the given edje.
+/**
+ * @brief Creates a new part of type EXTERNAL in the given edje.
  *
  * If another part with the same name just exists nothing is created and EINA_FALSE is returned.
  * Note that this function also create a default description for the part.
@@ -1342,7 +1431,8 @@ EAPI Eina_Bool edje_edit_part_add(Evas_Object *obj, const char *name, Edje_Part_
  */
 EAPI Eina_Bool edje_edit_part_external_add(Evas_Object *obj, const char *name, const char *source);
 
-/** Delete the given part from the edje.
+/**
+ * @brief Deletes the given part from the edje.
  *
  * All the reference to this part will be zeroed.
  *
@@ -1353,7 +1443,8 @@ EAPI Eina_Bool edje_edit_part_external_add(Evas_Object *obj, const char *name, c
  */
 EAPI Eina_Bool edje_edit_part_del(Evas_Object *obj, const char *part);
 
-/** Copy the given part in edje.
+/**
+ * @brief Copies the given part in edje.
  *
  * If another part with the same name just exists nothing is created and EINA_FALSE is returned.
  *
@@ -1366,7 +1457,8 @@ EAPI Eina_Bool edje_edit_part_del(Evas_Object *obj, const char *part);
  */
 EAPI Eina_Bool edje_edit_part_copy(Evas_Object *obj, const char *part, const char *new_copy);
 
-/** Check if a part with the given name exist in the edje object.
+/**
+ * @brief Checks if a part with the given name exist in the edje object.
  *
  * @param obj Object being edited.
  * @param part Name of part to check for its existence.
@@ -1375,7 +1467,8 @@ EAPI Eina_Bool edje_edit_part_copy(Evas_Object *obj, const char *part, const cha
  */
 EAPI Eina_Bool edje_edit_part_exist(Evas_Object *obj, const char *part);
 
-/** Get the name of part stacked above the one passed.
+/**
+ * @brief Gets the name of part stacked above the one passed.
  *
  * @param obj Object being edited.
  * @param part Name of part of which to check the one above.
@@ -1385,7 +1478,8 @@ EAPI Eina_Bool edje_edit_part_exist(Evas_Object *obj, const char *part);
  */
 EAPI const char * edje_edit_part_above_get(Evas_Object *obj, const char *part);
 
-/** Get the name of part stacked below the one passed.
+/**
+ * @brief Gets the name of part stacked below the one passed.
  *
  * @param obj Object being edited.
  * @param part Name of part of which to check the one below.
@@ -1395,7 +1489,8 @@ EAPI const char * edje_edit_part_above_get(Evas_Object *obj, const char *part);
  */
 EAPI const char * edje_edit_part_below_get(Evas_Object *obj, const char *part);
 
-/** Move the given part below the previous one.
+/**
+ * @brief Moves the given part below the previous one.
  *
  * @param obj Object being edited.
  * @param part Name of part to move one step below.
@@ -1404,7 +1499,8 @@ EAPI const char * edje_edit_part_below_get(Evas_Object *obj, const char *part);
  */
 EAPI Eina_Bool edje_edit_part_restack_below(Evas_Object *obj, const char *part);
 
-/** Move the given part below the part named below.
+/**
+ * @brief Moves the given part below the part named below.
  *
  * @param obj Object being edited.
  * @param part Name of part which will be moved.
@@ -1414,7 +1510,8 @@ EAPI Eina_Bool edje_edit_part_restack_below(Evas_Object *obj, const char *part);
  */
 EAPI Eina_Bool edje_edit_part_restack_part_below(Evas_Object *obj, const char* part, const char *below);
 
-/** Move the given part above the next one.
+/**
+ * @brief Moves the given part above the next one.
  *
  * @param obj Object being edited.
  * @param part Name of part to move one step above.
@@ -1423,7 +1520,8 @@ EAPI Eina_Bool edje_edit_part_restack_part_below(Evas_Object *obj, const char* p
  */
 EAPI Eina_Bool edje_edit_part_restack_above(Evas_Object *obj, const char *part);
 
-/** Move the given part above the part named above.
+/**
+ * @brief Moves the given part above the part named above.
  *
  * @param obj Object being edited.
  * @param part Name of part which will be moved.
@@ -1433,7 +1531,8 @@ EAPI Eina_Bool edje_edit_part_restack_above(Evas_Object *obj, const char *part);
  */
 EAPI Eina_Bool edje_edit_part_restack_part_above(Evas_Object *obj, const char* part, const char *above);
 
-/** Set a new name for part.
+/**
+ * @brief Sets a new name for part.
  *
  * Note that the relative getter function don't exist as it don't make sense ;)
  *
@@ -1445,25 +1544,28 @@ EAPI Eina_Bool edje_edit_part_restack_part_above(Evas_Object *obj, const char* p
  */
 EAPI Eina_Bool edje_edit_part_name_set(Evas_Object *obj, const char *part, const char *new_name);
 
-/** Get api's name of a part.
+/**
+ * @brief Gets api's name of a part.
  *
  * @param obj Object being edited.
  * @param part Name of the part.
  *
- * @return name of the api if successful, NULL otherwise.
+ * @return Name of the API if successful, NULL otherwise.
  */
 EAPI const char * edje_edit_part_api_name_get(Evas_Object *obj, const char *part);
 
-/** Get api's description of a part.
+/**
+ * @brief Gets api's description of a part.
  *
  * @param obj Object being edited.
  * @param part Name of the part.
  *
- * @return description of the api if successful, NULL otherwise.
+ * @return Description of the api if successful, NULL otherwise.
  */
 EAPI const char * edje_edit_part_api_description_get(Evas_Object *obj, const char *part);
 
-/** Set api's name of a part.
+/**
+ * @brief Sets api's name of a part.
  *
  * @param obj Object being edited.
  * @param part Name of the part.
@@ -1473,7 +1575,8 @@ EAPI const char * edje_edit_part_api_description_get(Evas_Object *obj, const cha
  */
 EAPI Eina_Bool edje_edit_part_api_name_set(Evas_Object *obj, const char *part, const char *name);
 
-/** Set api's description of a part.
+/**
+ * @brief Sets api's description of a part.
  *
  * @param obj Object being edited.
  * @param part Name of part.
@@ -1483,7 +1586,8 @@ EAPI Eina_Bool edje_edit_part_api_name_set(Evas_Object *obj, const char *part, c
  */
 EAPI Eina_Bool edje_edit_part_api_description_set(Evas_Object *obj, const char *part, const char *description);
 
-/** Get the type of a part.
+/**
+ * @brief Gets the type of a part.
  *
  * @param obj Object being edited.
  * @param part Name of part to get the type of.
@@ -1492,7 +1596,8 @@ EAPI Eina_Bool edje_edit_part_api_description_set(Evas_Object *obj, const char *
  */
 EAPI Edje_Part_Type edje_edit_part_type_get(Evas_Object *obj, const char *part);
 
-/** Get the clip_to part.
+/**
+ * @brief Gets the clip_to part.
  *
  * @param obj Object being edited.
  * @param part Name of the part whose clipper to get.
@@ -1501,7 +1606,8 @@ EAPI Edje_Part_Type edje_edit_part_type_get(Evas_Object *obj, const char *part);
  */
 EAPI const char * edje_edit_part_clip_to_get(Evas_Object *obj, const char *part);
 
-/** Set a part to clip part to.
+/**
+ * @brief Sets a part to clip part to.
  *
  * @param obj Object being edited.
  * @param part Part to set the clipper to.
@@ -1511,7 +1617,8 @@ EAPI const char * edje_edit_part_clip_to_get(Evas_Object *obj, const char *part)
  */
 EAPI Eina_Bool edje_edit_part_clip_to_set(Evas_Object *obj, const char *part, const char *clip_to);
 
-/** Get the source of part.
+/**
+ * @brief Gets the source of part.
  *
  * The meaning of this parameter varies depending on the type of the part.
  * For GROUP parts, it's the name of another group in the Edje file which will
@@ -1528,7 +1635,8 @@ EAPI Eina_Bool edje_edit_part_clip_to_set(Evas_Object *obj, const char *part, co
  */
 EAPI const char * edje_edit_part_source_get(Evas_Object *obj, const char *part);
 
-/** Set the source of part.
+/**
+ * @brief Sets the source of part.
  *
  * If setting source of the part will lead to recursive reference
  * (when A source to B, and B is going to be source to A because of this function),
@@ -1549,7 +1657,8 @@ EAPI const char * edje_edit_part_source_get(Evas_Object *obj, const char *part);
  */
 EAPI Eina_Bool edje_edit_part_source_set(Evas_Object *obj, const char *part, const char *source);
 
-/** Get the source2 of part.
+/**
+ * @brief Gets the source2 of part.
  *
  * Only available to TEXTBLOCK parts. It is used for the group to be loaded and
  * used for selection display OVER the selected text. source is used for under
@@ -1563,7 +1672,8 @@ EAPI Eina_Bool edje_edit_part_source_set(Evas_Object *obj, const char *part, con
  */
 EAPI const char * edje_edit_part_source2_get(Evas_Object *obj, const char *part);
 
-/** Set the source2 of part.
+/**
+ * @brief Sets the source2 of part.
  *
  * @param obj Object being edited.
  * @param part Part to set the source of.
@@ -1576,7 +1686,8 @@ EAPI const char * edje_edit_part_source2_get(Evas_Object *obj, const char *part)
  */
 EAPI Eina_Bool edje_edit_part_source2_set(Evas_Object *obj, const char *part, const char *source);
 
-/** Get the source3 of part.
+/**
+ * @brief Gets the source3 of part.
  *
  * Only available to TEXTBLOCK parts. It is used for the group to be loaded and
  * used for cursor display UNDER the cursor position. source4 is used for over
@@ -1590,7 +1701,8 @@ EAPI Eina_Bool edje_edit_part_source2_set(Evas_Object *obj, const char *part, co
  */
 EAPI const char * edje_edit_part_source3_get(Evas_Object *obj, const char *part);
 
-/** Set the source3 of part.
+/**
+ * @brief Sets the source3 of part.
  *
  * @param obj Object being edited.
  * @param part Part to set the source of.
@@ -1605,7 +1717,8 @@ EAPI const char * edje_edit_part_source3_get(Evas_Object *obj, const char *part)
  */
 EAPI Eina_Bool edje_edit_part_source3_set(Evas_Object *obj, const char *part, const char *source);
 
-/** Get the source4 of part.
+/**
+ * @brief Gets the source4 of part.
  *
  * Only available to TEXTBLOCK parts. It is used for the group to be loaded and
  * used for cursor display OVER the cursor position. source3 is used for under
@@ -1619,7 +1732,8 @@ EAPI Eina_Bool edje_edit_part_source3_set(Evas_Object *obj, const char *part, co
  */
 EAPI const char * edje_edit_part_source4_get(Evas_Object *obj, const char *part);
 
-/** Set the source4 of part.
+/**
+ * @brief Sets the source4 of part.
  *
  * @param obj Object being edited.
  * @param part Part to set the source of.
@@ -1634,7 +1748,8 @@ EAPI const char * edje_edit_part_source4_get(Evas_Object *obj, const char *part)
  */
 EAPI Eina_Bool edje_edit_part_source4_set(Evas_Object *obj, const char *part, const char *source);
 
-/** Get the source5 of part.
+/**
+ * @brief Gets the source5 of part.
  *
  * Only available to TEXTBLOCK parts. It is used for the group to be loaded and
  * used for anchors display UNDER the anchor position. source6 is used for over
@@ -1648,7 +1763,8 @@ EAPI Eina_Bool edje_edit_part_source4_set(Evas_Object *obj, const char *part, co
  */
 EAPI const char * edje_edit_part_source5_get(Evas_Object *obj, const char *part);
 
-/** Set the source5 of part.
+/**
+ * @brief Sets the source5 of part.
  *
  * @param obj Object being edited.
  * @param part Part to set the source of.
@@ -1661,7 +1777,8 @@ EAPI const char * edje_edit_part_source5_get(Evas_Object *obj, const char *part)
  */
 EAPI Eina_Bool edje_edit_part_source5_set(Evas_Object *obj, const char *part, const char *source);
 
-/** Get the source6 of part.
+/**
+ * @brief Gets the source6 of part.
  *
  * Only available to TEXTBLOCK parts. It is used for the group to be loaded and
  * used for anchor display OVER the anchor position. source5 is used for under
@@ -1675,7 +1792,8 @@ EAPI Eina_Bool edje_edit_part_source5_set(Evas_Object *obj, const char *part, co
  */
 EAPI const char * edje_edit_part_source6_get(Evas_Object *obj, const char *part);
 
-/** Set the source6 of part.
+/**
+ * @brief Sets the source6 of part.
  *
  * @param obj Object being edited.
  * @param part Part to set the source of.
@@ -1688,7 +1806,8 @@ EAPI const char * edje_edit_part_source6_get(Evas_Object *obj, const char *part)
  */
 EAPI Eina_Bool edje_edit_part_source6_set(Evas_Object *obj, const char *part, const char *source);
 
-/** Get the effect for a given part.
+/**
+ * @brief Gets the effect for a given part.
  *
  * Gets the effect used for parts of type TEXT. See @ref edcref for more details.
  *
@@ -1699,7 +1818,8 @@ EAPI Eina_Bool edje_edit_part_source6_set(Evas_Object *obj, const char *part, co
  */
 EAPI Edje_Text_Effect edje_edit_part_effect_get(Evas_Object *obj, const char *part);
 
-/** Set the effect for a given part.
+/**
+ * @brief Sets the effect for a given part.
  * Effects and shadow directions can be combined.
  *
  * For effect and shadow direction list please look at Edje Part Text ref page.
@@ -1714,7 +1834,8 @@ EAPI Edje_Text_Effect edje_edit_part_effect_get(Evas_Object *obj, const char *pa
  */
 EAPI Eina_Bool edje_edit_part_effect_set(Evas_Object *obj, const char *part, Edje_Text_Effect effect);
 
-/** Get the current selected state in part.
+/**
+ * @brief Gets the current selected state in part.
  *
  * @param obj Object being edited.
  * @param part Part to get the selected state of.
@@ -1724,7 +1845,8 @@ EAPI Eina_Bool edje_edit_part_effect_set(Evas_Object *obj, const char *part, Edj
  */
 EAPI const char * edje_edit_part_selected_state_get(Evas_Object *obj, const char *part, double *value);
 
-/** Set the current state in part.
+/**
+ * @brief Sets the current state in part.
  *
  * @param obj Object being edited.
  * @param part Part to set the state of.
@@ -1735,7 +1857,8 @@ EAPI const char * edje_edit_part_selected_state_get(Evas_Object *obj, const char
  */
 EAPI Eina_Bool edje_edit_part_selected_state_set(Evas_Object *obj, const char *part, const char *state, double value);
 
-/** Get mouse_events for part.
+/**
+ * @brief Gets mouse_events for part.
  *
  * @param obj Object being edited.
  * @param part Part to get if the mouse events is accepted.
@@ -1744,37 +1867,41 @@ EAPI Eina_Bool edje_edit_part_selected_state_set(Evas_Object *obj, const char *p
  */
 EAPI Eina_Bool edje_edit_part_mouse_events_get(Evas_Object *obj, const char *part);
 
-/** Set mouse_events for part.
+/**
+ * @brief Sets mouse_events for part.
  *
  * @param obj Object being edited.
  * @param part The part to set if the mouse events is accepted.
- * @param mouse_events EINA_TRUE if part will accept mouse events, @c EINA_FALSE otherwise.
+ * @param mouse_events @c EINA_TRUE if part will accept mouse events, @c EINA_FALSE otherwise.
  *
  * @return @c EINA_TRUE in case of success, @c EINA_FALSE otherwise.
  */
 EAPI Eina_Bool edje_edit_part_mouse_events_set(Evas_Object *obj, const char *part, Eina_Bool mouse_events);
 
-/** Get anti-alising for part.
+/**
+ * @brief Gets anti-aliasing for part.
  *
  * @param obj Object being edited.
  * @param part Part to get if the anti-aliasing is accepted.
  *
- * @return @c EINA_TRUE if part will draw anti-alised, @c EINA_FALSE otherwise.
+ * @return @c EINA_TRUE if part will draw anti-aliased, @c EINA_FALSE otherwise.
  */
 EAPI Eina_Bool edje_edit_part_anti_alias_get(Evas_Object *obj, const char *part);
 
-/** Set anti-alising for part.
+/**
+ * @brief Sets anti-aliasing for part.
  *
  * @param obj Object being edited.
  * @param part The part to set if the anti-aliasing is accepted.
- * @param mouse_events EINA_TRUE if part should to draw anti-aliased, @c EINA_FALSE otherwise.
+ * @param mouse_events @c EINA_TRUE if part should to draw anti-aliased, @c EINA_FALSE otherwise.
  *
  * @return @c EINA_TRUE in case of success, @c EINA_FALSE otherwise.
  */
 EAPI Eina_Bool edje_edit_part_anti_alias_set(Evas_Object *obj, const char *part, Eina_Bool anti_alias);
 
 
-/** Get repeat_events for part.
+/**
+ * @brief Gets repeat_events for part.
  *
  * @param obj Object being edited.
  * @param part Part to get if it will pass all events to the other parts.
@@ -1783,17 +1910,19 @@ EAPI Eina_Bool edje_edit_part_anti_alias_set(Evas_Object *obj, const char *part,
  */
 EAPI Eina_Bool edje_edit_part_repeat_events_get(Evas_Object *obj, const char *part);
 
-/** Set repeat_events for part.
+/**
+ * @brief Sets repeat_events for part.
  *
  * @param obj Object being edited.
  * @param part Part to set if will repeat all the received mouse events to other parts.
- * @param repeat_events EINA_TRUE if the events received will propagate to other parts, @c EINA_FALSE otherwise
+ * @param repeat_events @c EINA_TRUE if the events received will propagate to other parts, @c EINA_FALSE otherwise
  *
  * @return @c EINA_TRUE in case of success, @c EINA_FALSE otherwise.
  */
 EAPI Eina_Bool edje_edit_part_repeat_events_set(Evas_Object *obj, const char *part, Eina_Bool repeat_events);
 
-/** Get use_alternate_font_metrics variable for part.
+/**
+ * @brief Gets use_alternate_font_metrics variable for part.
  *
  * @param obj Object being edited.
  * @param part Part to get use_alternate_font_metrics for text or textblock part is enabled.
@@ -1804,7 +1933,8 @@ EAPI Eina_Bool edje_edit_part_repeat_events_set(Evas_Object *obj, const char *pa
 EAPI Eina_Bool
 edje_edit_part_use_alternate_font_metrics_get(Evas_Object *obj, const char *part);
 
-/** Set use_alternate_font_metrics variable for part.
+/**
+ * @brief Sets use_alternate_font_metrics variable for part.
  *
  * @param obj Object being edited.
  * @param part Part to set use_alternate_font_metrics for text or textblock part is enabled.
@@ -1816,7 +1946,8 @@ edje_edit_part_use_alternate_font_metrics_get(Evas_Object *obj, const char *part
 EAPI Eina_Bool
 edje_edit_part_use_alternate_font_metrics_set(Evas_Object *obj, const char *part, Eina_Bool use);
 
-/** Get multiline for part.
+/**
+ * @brief Gets multiline for part.
  *
  * @param obj Object being edited.
  * @param part Part to get if editing multiple lines for text or textblock part is enabled.
@@ -1826,18 +1957,20 @@ edje_edit_part_use_alternate_font_metrics_set(Evas_Object *obj, const char *part
  */
 EAPI Eina_Bool edje_edit_part_multiline_get(Evas_Object *obj, const char *part);
 
-/** Set multiline for part.
+/**
+ * @brief Sets multiline for part.
  *
  * @param obj Object being edited.
  * @param part Part to set if editing multiple lines for text or textblock part is enabled.
- * @param multiline EINA_TRUE if multiple lines for editing is enabled, @c EINA_FALSE otherwise
+ * @param multiline @c EINA_TRUE if multiple lines for editing is enabled, @c EINA_FALSE otherwise
  *
  * @return @c EINA_TRUE in case of success, @c EINA_FALSE otherwise.
  * @since 1.11
  */
 EAPI Eina_Bool edje_edit_part_multiline_set(Evas_Object *obj, const char *part, Eina_Bool multiline);
 
-/** Get precise_is_inside for part.
+/**
+ * @brief Gets precise_is_inside for part.
  *
  * @param obj Object being edited.
  * @param part Part to get if it will enable point collision detection for the part.
@@ -1847,7 +1980,8 @@ EAPI Eina_Bool edje_edit_part_multiline_set(Evas_Object *obj, const char *part,
  */
 EAPI Eina_Bool edje_edit_part_precise_is_inside_get(Evas_Object *obj, const char *part);
 
-/** Set precise_is_inside for part.
+/**
+ * @brief Sets precise_is_inside for part.
  *
  * @param obj Object being edited.
  * @param part Part to set if it will enable point collision detection for the part.
@@ -1858,7 +1992,8 @@ EAPI Eina_Bool edje_edit_part_precise_is_inside_get(Evas_Object *obj, const char
  */
 EAPI Eina_Bool edje_edit_part_precise_is_inside_set(Evas_Object *obj, const char *part, Eina_Bool precise_is_inside);
 
-/** Get accessibility for part.
+/**
+ * @brief Gets accessibility for part.
  *
  * @param obj Object being edited.
  * @param part Part to get if it uses accessibility feature.
@@ -1868,7 +2003,8 @@ EAPI Eina_Bool edje_edit_part_precise_is_inside_set(Evas_Object *obj, const char
  */
 EAPI Eina_Bool edje_edit_part_access_get(Evas_Object *obj, const char *part);
 
-/** Set accessibility for part.
+/**
+ * @brief Sets accessibility for part.
  *
  * @param obj Object being edited.
  * @param part Part to set if it uses accessibility feature.
@@ -1879,7 +2015,8 @@ EAPI Eina_Bool edje_edit_part_access_get(Evas_Object *obj, const char *part);
  */
 EAPI Eina_Bool edje_edit_part_access_set(Evas_Object *obj, const char *part, Eina_Bool access);
 
-/** Get ignore_flags for part.
+/**
+ * @brief Gets ignore_flags for part.
  *
  * @param obj Object being edited.
  * @param part Part to get which event_flags are being ignored.
@@ -1888,7 +2025,8 @@ EAPI Eina_Bool edje_edit_part_access_set(Evas_Object *obj, const char *part, Ein
  */
 EAPI Evas_Event_Flags edje_edit_part_ignore_flags_get(Evas_Object *obj, const char *part);
 
-/** Set ignore_flags for part.
+/**
+ * @brief Sets ignore_flags for part.
  *
  * @param obj Object being edited.
  * @param part Part to set which event flags will be ignored.
@@ -1898,7 +2036,8 @@ EAPI Evas_Event_Flags edje_edit_part_ignore_flags_get(Evas_Object *obj, const ch
  */
 EAPI Eina_Bool edje_edit_part_ignore_flags_set(Evas_Object *obj, const char *part, Evas_Event_Flags ignore_flags);
 
-/** Get mask_flags for part.
+/**
+ * @brief Gets mask_flags for part.
  *
  * @param obj Object being edited.
  * @param part Part to get which event_flags are being masked.
@@ -1907,7 +2046,8 @@ EAPI Eina_Bool edje_edit_part_ignore_flags_set(Evas_Object *obj, const char *par
  */
 EAPI Evas_Event_Flags edje_edit_part_mask_flags_get(Evas_Object *obj, const char *part);
 
-/** Set mask_flags for part.
+/**
+ * @brief Sets mask_flags for part.
  *
  * @param obj Object being edited.
  * @param part Part to set which event flags will be masked.
@@ -1917,7 +2057,8 @@ EAPI Evas_Event_Flags edje_edit_part_mask_flags_get(Evas_Object *obj, const char
  */
 EAPI Eina_Bool edje_edit_part_mask_flags_set(Evas_Object *obj, const char *part, Evas_Event_Flags mask_flags);
 
-/** Get pointer_mode of a part.
+/**
+ * @brief Gets pointer_mode of a part.
  *
  * @param obj Object being edited.
  * @param part Part name to get it's pointer_mode.
@@ -1927,7 +2068,8 @@ EAPI Eina_Bool edje_edit_part_mask_flags_set(Evas_Object *obj, const char *part,
  */
 EAPI Evas_Object_Pointer_Mode edje_edit_part_pointer_mode_get(Evas_Object *obj, const char *part);
 
-/** Get pointer_mode of a part.
+/**
+ * @brief Gets pointer_mode of a part.
  *
  * Note that Ponter Mode can be:
  * - EVAS_OBJECT_POINTER_MODE_AUTOGRAB - default, X11-like
@@ -1943,7 +2085,8 @@ EAPI Evas_Object_Pointer_Mode edje_edit_part_pointer_mode_get(Evas_Object *obj,
  */
 EAPI Eina_Bool edje_edit_part_pointer_mode_set(Evas_Object *obj, const char *part, Evas_Object_Pointer_Mode pointer_mode);
 
-/** Get cursor_mode of a part.
+/**
+ * @brief Gets cursor_mode of a part.
  *
  * Note that Cursor Mode can be:
  * 0 - UNDER cursor mode means the cursor will draw below the character pointed
@@ -1959,7 +2102,8 @@ EAPI Eina_Bool edje_edit_part_pointer_mode_set(Evas_Object *obj, const char *par
  */
 EAPI unsigned char edje_edit_part_cursor_mode_get(Evas_Object *obj, const char *part);
 
-/** Get pointer_mode of a part.
+/**
+ * @brief Gets pointer_mode of a part.
  *
  * Note that Cursor Mode can be:
  * 0 - UNDER cursor mode means the cursor will draw below the character pointed
@@ -1976,7 +2120,8 @@ EAPI unsigned char edje_edit_part_cursor_mode_get(Evas_Object *obj, const char *
  */
 EAPI Eina_Bool edje_edit_part_cursor_mode_set(Evas_Object *obj, const char *part, unsigned char cursor_mode);
 
-/** Set scale property for the part.
+/**
+ * @brief Sets scale property for the part.
  *
  * This property tells Edje that the given part should be scaled by the
  * Edje scale factor.
@@ -1989,7 +2134,8 @@ EAPI Eina_Bool edje_edit_part_cursor_mode_set(Evas_Object *obj, const char *part
  */
 EAPI Eina_Bool edje_edit_part_scale_set(Evas_Object *obj, const char *part, Eina_Bool scale);
 
-/** Get scale for the part.
+/**
+ * @brief Gets scale for the part.
  *
  * @param obj Object being edited.
  * @param part Part to get the scale value of.
@@ -1998,45 +2144,50 @@ EAPI Eina_Bool edje_edit_part_scale_set(Evas_Object *obj, const char *part, Eina
  */
 EAPI Eina_Bool edje_edit_part_scale_get(Evas_Object *obj, const char *part);
 
-/** Get horizontal dragable state for part.
+/**
+ * @brief Gets horizontal dragable state for part.
  *
  * @param obj Object being edited.
- * @param part Part to get if can be dragged horizontally;
+ * @param part Part to get if can be dragged horizontally.
  *
- * @return 1 (or -1) if the part can be dragged horizontally, 0 otherwise.
+ * @return @c 1 (or -1) if the part can be dragged horizontally, @c 0 otherwise.
  */
 EAPI int edje_edit_part_drag_x_get(Evas_Object *obj, const char *part);
 
-/** Set horizontal dragable state for part.
+/**
+ * @brief Sets horizontal dragable state for part.
  *
  * @param obj Object being edited.
  * @param part Part to set if should be dragged horizontally.
- * @param drag 1 (or -1) if the part should be dragged horizontally, 0 otherwise.
+ * @param drag @c 1 (or -1) if the part should be dragged horizontally, @c 0 otherwise.
  *
  * @return @c EINA_TRUE in case of success, @c EINA_FALSE otherwise.
  */
 EAPI Eina_Bool edje_edit_part_drag_x_set(Evas_Object *obj, const char *part, int drag);
 
-/** Get vertical dragable state for part.
+/**
+ * @brief Gets vertical dragable state for part.
  *
  * @param obj Object being edited.
  * @param part Part to get if can be dragged vertically.
  *
- * @return 1 (or - 1) if the part can be dragged vertically, 0 otherwise.
+ * @return @c 1 (or - 1) if the part can be dragged vertically, @c 0 otherwise.
  */
 EAPI int edje_edit_part_drag_y_get(Evas_Object *obj, const char *part);
 
-/** Set vertical dragable state for part.
+/**
+ * @brief Sets vertical dragable state for part.
  *
  * @param obj Object being edited.
  * @param part Part to set if should be dragged vertically.
- * @param drag 1 (or -1) of the part shpuld be dragged vertically, 0 otherwise.
+ * @param drag @c 1 (or -1) of the part should be dragged vertically, @c 0 otherwise.
  *
  * @return @c EINA_TRUE in case of success, @c EINA_FALSE otherwise.
  */
 EAPI Eina_Bool edje_edit_part_drag_y_set(Evas_Object *obj, const char *part, int drag);
 
-/** Get horizontal dragable step for part.
+/**
+ * @brief Gets horizontal dragable step for part.
  *
  * @param obj Object being edited.
  * @param part Part to get the drag horizontal step value.
@@ -2045,7 +2196,8 @@ EAPI Eina_Bool edje_edit_part_drag_y_set(Evas_Object *obj, const char *part, int
  */
 EAPI int edje_edit_part_drag_step_x_get(Evas_Object *obj, const char *part);
 
-/** Set horizontal dragable state for part.
+/**
+ * @brief Sets horizontal dragable state for part.
  *
  * @param obj Object being edited.
  * @param part Part to set the drag horizontal step value.
@@ -2055,7 +2207,8 @@ EAPI int edje_edit_part_drag_step_x_get(Evas_Object *obj, const char *part);
  */
 EAPI Eina_Bool edje_edit_part_drag_step_x_set(Evas_Object *obj, const char *part, int step);
 
-/** Get vertical dragable step for part.
+/**
+ * @brief Gets vertical dragable step for part.
  *
  * @param obj Object being edited.
  * @param part Part to get the drag vertical step value.
@@ -2064,7 +2217,8 @@ EAPI Eina_Bool edje_edit_part_drag_step_x_set(Evas_Object *obj, const char *part
  */
 EAPI int edje_edit_part_drag_step_y_get(Evas_Object *obj, const char *part);
 
-/** Set vertical dragable state for part.
+/**
+ * @brief Sets vertical dragable state for part.
  *
  * @param obj Object being edited.
  * @param part Part to set the drag vertical step value.
@@ -2074,16 +2228,18 @@ EAPI int edje_edit_part_drag_step_y_get(Evas_Object *obj, const char *part);
  */
 EAPI Eina_Bool edje_edit_part_drag_step_y_set(Evas_Object *obj, const char *part, int step);
 
-/** Get horizontal dragable count for part.
+/**
+ * @brief Gets horizontal dragable count for part.
  *
  * @param obj Object being edited.
  * @param part Part to get the drag horizontal count value.
  *
- * @return horizontal dragable count value
+ * @return Horizontal dragable count value
  */
 EAPI int edje_edit_part_drag_count_x_get(Evas_Object *obj, const char *part);
 
-/** Set horizontal dragable count for part.
+/**
+ * @brief Sets horizontal dragable count for part.
  *
  * @param obj Object being edited.
  * @param part Part to set the drag horizontal count value.
@@ -2093,16 +2249,18 @@ EAPI int edje_edit_part_drag_count_x_get(Evas_Object *obj, const char *part);
  */
 EAPI Eina_Bool edje_edit_part_drag_count_x_set(Evas_Object *obj, const char *part, int count);
 
-/** Get vertical dragable count for part.
+/**
+ * @brief Gets vertical dragable count for part.
  *
  * @param obj Object being edited.
  * @param part Part to get the drag vertical count value.
  *
- * @return vertical dragable count value
+ * @return Vertical dragable count value
  */
 EAPI int edje_edit_part_drag_count_y_get(Evas_Object *obj, const char *part);
 
-/** Set vertical dragable count for part.
+/**
+ * @brief Sets vertical dragable count for part.
  *
  * @param obj Object being edited.
  * @param part Part to set the drag vertical count value.
@@ -2112,26 +2270,29 @@ EAPI int edje_edit_part_drag_count_y_get(Evas_Object *obj, const char *part);
  */
 EAPI Eina_Bool edje_edit_part_drag_count_y_set(Evas_Object *obj, const char *part, int count);
 
-/** Get the name of the part that is used as 'confine' for the given draggies.
+/**
+ * @brief Gets the name of the part that is used as 'confine' for the given draggies.
  *
  * @param obj Object being edited.
  * @param part Part to get the name that is used as 'confine' for the given draggies.
  *
- * @return The name of the confine part or NULL (if unset).
+ * @return The name of the confine part, or NULL (if unset).
  */
 EAPI const char * edje_edit_part_drag_confine_get(Evas_Object *obj, const char *part);
 
-/** Set the name of the part that is used as 'confine' for the given draggies.
+/**
+ * @brief Sets the name of the part that is used as 'confine' for the given draggies.
  *
  * @param obj Object being edited.
  * @param part Part to set the name that is used as 'confine' for the given draggies.
- * @param confine The name of the confine part or NULL to unset confine.
+ * @param confine The name of the confine part, or NULL to unset confine.
  *
  * @return @c EINA_TRUE in case of success, @c EINA_FALSE otherwise.
  */
 EAPI Eina_Bool edje_edit_part_drag_confine_set(Evas_Object *obj, const char *part, const char *confine);
 
-/** Get the name of the part that is used as the receiver of the drag event.
+/**
+ * @brief Gets the name of the part that is used as the receiver of the drag event.
  *
  * @param obj Object being edited.
  * @param part Part to get the name that is used as the receiver of the drag event.
@@ -2140,7 +2301,8 @@ EAPI Eina_Bool edje_edit_part_drag_confine_set(Evas_Object *obj, const char *par
  */
 EAPI const char * edje_edit_part_drag_event_get(Evas_Object *obj, const char *part);
 
-/** Set the name of the part that will receive events from the given draggies.
+/**
+ * @brief Sets the name of the part that will receive events from the given draggies.
  *
  * @param obj Object being edited.
  * @param part Part to set the name that will receive events from the given draggies.
@@ -2150,20 +2312,22 @@ EAPI const char * edje_edit_part_drag_event_get(Evas_Object *obj, const char *pa
  */
 EAPI Eina_Bool edje_edit_part_drag_event_set(Evas_Object *obj, const char *part, const char *event);
 
-/** Get the name of the part that is used as 'threshold' for the given draggies.
+/**
+ * @brief Gets the name of the part that is used as 'threshold' for the given draggies.
  *
  * @param obj Object being edited.
  * @param part Part to get the name that is used as 'threshold' for the given draggies.
  *
- * @return The name of the threshold part or NULL (if unset).
+ * @return The name of the threshold part, or NULL (if unset).
  */
 EAPI const char * edje_edit_part_drag_threshold_get(Evas_Object *obj, const char *part);
 
-/** Set the name of the part that is used as 'threshold' for the given draggies.
+/**
+ * @brief Sets the name of the part that is used as 'threshold' for the given draggies.
  *
  * @param obj Object being edited.