doxygen: Fix typos & invalid statements in Ecore_Getopt and Ecore_Legacy

Summary: There are some typos and calogique statements in doxygen
of Ecore_Getopt and Ecore_Legacy so I had fixed typos and cacologique statements.

Test Plan: Doxygen revision

Reviewers: stefan, cedric, raster, Jaehyun_Cho

Subscribers: jpeg, conr2d

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

2 files changed, 149 insertions, 149 deletions

diff --git a/src/lib/ecore/Ecore_Getopt.h b/src/lib/ecore/Ecore_Getopt.h
index e184b20e08..e09a2bef2d 100644
--- a/src/lib/ecore/Ecore_Getopt.h
+++ b/src/lib/ecore/Ecore_Getopt.h
@@ -31,8 +31,8 @@
 #endif /* ! _WIN32 */
 
 /**
- * @defgroup Ecore_Getopt_Group Ecore Getopt
  * @ingroup Ecore
+ * @defgroup Ecore_Getopt_Group Ecore Getopt
  *
  * This group contains powerful getopt replacement.
  *
@@ -58,7 +58,7 @@ extern "C" {
 
 /**
  * @typedef Ecore_Getopt_Action
- * @brief Enumeration that defines the actions to do when parsing command line
+ * @brief Enumeration for defining the actions to do when parsing command line
  * parameters.
  */
 typedef enum {
@@ -80,7 +80,7 @@ typedef enum {
 
 /**
  * @typedef Ecore_Getopt_Type
- * @brief Enumeration that defines the type of the values to store when using
+ * @brief Enumeration for defining the type of the values to store when using
  * append action.
  */
 typedef enum {
@@ -97,7 +97,7 @@ typedef enum {
 
 /**
  * @typedef Ecore_Getopt_Desc_Arg_Requirement
- * @brief Enumeration that defines if the command line options require an
+ * @brief Enumeration for defining if the command line options require an
  * argument.
  */
 typedef enum {
@@ -222,14 +222,14 @@ struct _Ecore_Getopt
 };
 
 /**
- * @brief Macro that helps to fill the Ecore_Getopt_Desc table.
+ * @brief Definition for macro that helps to fill the Ecore_Getopt_Desc table.
  */
 #define ECORE_GETOPT_STORE_FULL(shortname, longname, help, metavar, type, arg_requirement, default_value) \
   {shortname, longname, help, metavar, ECORE_GETOPT_ACTION_STORE,                                         \
    {.store = {type, arg_requirement, default_value}}}
 
 /**
- * @brief Macro that fills an option in Ecore_Getopt_Desc table.
+ * @brief Definition for macro that fills an option in Ecore_Getopt_Desc table.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -240,7 +240,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE_FULL(shortname, longname, help, NULL, type, \
                           ECORE_GETOPT_DESC_ARG_REQUIREMENT_YES, {})
 /**
- * @brief Macro that fill Ecore_Getopt_Desc table with an option of type string.
+ * @brief Definition for macro that fill Ecore_Getopt_Desc table with an option of type string.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -250,7 +250,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE(shortname, longname, help, ECORE_GETOPT_TYPE_STR)
 
 /**
- * @brief Macro that fill Ecore_Getopt_Desc table with an option of type boolean.
+ * @brief Definition for macro that fill Ecore_Getopt_Desc table with an option of type boolean.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -260,7 +260,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE(shortname, longname, help, ECORE_GETOPT_TYPE_BOOL)
 
 /**
- * @brief Macro that fill Ecore_Getopt_Desc table with an option of type short.
+ * @brief Definition for macro that fill Ecore_Getopt_Desc table with an option of type short.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -270,7 +270,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE(shortname, longname, help, ECORE_GETOPT_TYPE_SHORT)
 
 /**
- * @brief Macro that fill Ecore_Getopt_Desc table with an option of type int.
+ * @brief Definition for macro that fill Ecore_Getopt_Desc table with an option of type int.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -280,7 +280,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE(shortname, longname, help, ECORE_GETOPT_TYPE_INT)
 
 /**
- * @brief Macro that fill Ecore_Getopt_Desc table with an option of type long.
+ * @brief Definition for macro that fill Ecore_Getopt_Desc table with an option of type long.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -290,7 +290,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE(shortname, longname, help, ECORE_GETOPT_TYPE_LONG)
 
 /**
- * @brief Macro that fill Ecore_Getopt_Desc table with an option of type ushort.
+ * @brief Definition for macro that fill Ecore_Getopt_Desc table with an option of type ushort.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -300,7 +300,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE(shortname, longname, help, ECORE_GETOPT_TYPE_USHORT)
 
 /**
- * @brief Macro that fill Ecore_Getopt_Desc table with an option of type uint.
+ * @brief Definition for macro that fill Ecore_Getopt_Desc table with an option of type uint.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -310,7 +310,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE(shortname, longname, help, ECORE_GETOPT_TYPE_UINT)
 
 /**
- * @brief Macro that fill Ecore_Getopt_Desc table with an option of type ulong.
+ * @brief Definition for macro that fill Ecore_Getopt_Desc table with an option of type ulong.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -320,7 +320,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE(shortname, longname, help, ECORE_GETOPT_TYPE_ULONG)
 
 /**
- * @brief Macro that fill Ecore_Getopt_Desc table with an option of type double.
+ * @brief Definition for macro that fill Ecore_Getopt_Desc table with an option of type double.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -330,7 +330,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE(shortname, longname, help, ECORE_GETOPT_TYPE_DOUBLE)
 
 /**
- * Macro that helps to fill the Ecore_Getopt_Desc table with a metavar after
+ * Definition for macro that helps to fill the Ecore_Getopt_Desc table with a metavar after
  * the description of the option.
  */
 #define ECORE_GETOPT_STORE_METAVAR(shortname, longname, help, metavar, type) \
@@ -338,7 +338,7 @@ struct _Ecore_Getopt
                           ECORE_GETOPT_DESC_ARG_REQUIREMENT_YES, {})
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type string and metavar.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type string and metavar.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -349,7 +349,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE_METAVAR(shortname, longname, help, metavar, ECORE_GETOPT_TYPE_STR)
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type boolean and metavar.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type boolean and metavar.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -360,7 +360,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE_METAVAR(shortname, longname, help, metavar, ECORE_GETOPT_TYPE_BOOL)
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type short and metavar.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type short and metavar.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -371,7 +371,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE_METAVAR(shortname, longname, help, metavar, ECORE_GETOPT_TYPE_SHORT)
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type int and metavar.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type int and metavar.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -382,7 +382,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE_METAVAR(shortname, longname, help, metavar, ECORE_GETOPT_TYPE_INT)
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type long and metavar.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type long and metavar.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -393,7 +393,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE_METAVAR(shortname, longname, help, metavar, ECORE_GETOPT_TYPE_LONG)
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type unsigned short and metavar.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type unsigned short and metavar.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -404,7 +404,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE_METAVAR(shortname, longname, help, metavar, ECORE_GETOPT_TYPE_USHORT)
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type unsigned int and metavar.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type unsigned int and metavar.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -415,7 +415,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE_METAVAR(shortname, longname, help, metavar, ECORE_GETOPT_TYPE_UINT)
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type unsigned long and metavar.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type unsigned long and metavar.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -426,7 +426,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE_METAVAR(shortname, longname, help, metavar, ECORE_GETOPT_TYPE_ULONG)
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type double and metavar.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type double and metavar.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -437,7 +437,7 @@ struct _Ecore_Getopt
   ECORE_GETOPT_STORE_METAVAR(shortname, longname, help, metavar, ECORE_GETOPT_TYPE_DOUBLE)
 
 /**
- * Macro that helps to fill the Ecore_Getopt_Desc table with a default value.
+ * Definition for macro that helps to fill the Ecore_Getopt_Desc table with a default value.
  */
 #define ECORE_GETOPT_STORE_DEF(shortname, longname, help, type, default_value) \
   ECORE_GETOPT_STORE_FULL(shortname, longname, help, NULL, type,               \
@@ -445,7 +445,7 @@ struct _Ecore_Getopt
                           default_value)
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type string and default value.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type string and default value.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -458,7 +458,7 @@ struct _Ecore_Getopt
                          {.strv = default_value})
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type boolean and default value.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type boolean and default value.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -471,7 +471,7 @@ struct _Ecore_Getopt
                          {.boolv = default_value})
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type short and default value.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type short and default value.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -484,7 +484,7 @@ struct _Ecore_Getopt
                          {.shortv = default_value})
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type int and default value.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type int and default value.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -497,7 +497,7 @@ struct _Ecore_Getopt
                          {.intv = default_value})
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type long and default value.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type long and default value.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -510,7 +510,7 @@ struct _Ecore_Getopt
                          {.longv = default_value})
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type unsigned short and default value.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type unsigned short and default value.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -523,7 +523,7 @@ struct _Ecore_Getopt
                          {.ushortv = default_value})
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type unsigned int and default value.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type unsigned int and default value.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -536,7 +536,7 @@ struct _Ecore_Getopt
                          {.uintv = default_value})
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type unsigned long and default value.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type unsigned long and default value.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -549,7 +549,7 @@ struct _Ecore_Getopt
                          {.ulongv = default_value})
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an option of type double and default value.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an option of type double and default value.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -562,7 +562,7 @@ struct _Ecore_Getopt
                          {.doublev = default_value})
 
 /**
- * @brief Fill full string type option description in Ecore_Getopt_Desc table.
+ * @brief Definition for filling full string type option description in Ecore_Getopt_Desc table.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -578,7 +578,7 @@ struct _Ecore_Getopt
                           {.strv = default_value})
 
 /**
- * @brief Fill full boolean type option description in Ecore_Getopt_Desc table.
+ * @brief Definition for filling full boolean type option description in Ecore_Getopt_Desc table.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -594,7 +594,7 @@ struct _Ecore_Getopt
                           {.boolv = default_value})
 
 /**
- * @brief Fill full short type option description in Ecore_Getopt_Desc table.
+ * @brief Definition for filling full short type option description in Ecore_Getopt_Desc table.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -610,7 +610,7 @@ struct _Ecore_Getopt
                           {.shortv = default_value})
 
 /**
- * @brief Fill full int type option description in Ecore_Getopt_Desc table.
+ * @brief Definition for filling full int type option description in Ecore_Getopt_Desc table.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -626,7 +626,7 @@ struct _Ecore_Getopt
                           {.intv = default_value})
 
 /**
- * @brief Fill full long type option description in Ecore_Getopt_Desc table.
+ * @brief Definition for filling full long type option description in Ecore_Getopt_Desc table.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -642,7 +642,7 @@ struct _Ecore_Getopt
                           {.longv = default_value})
 
 /**
- * @brief Fill full unsigned short type option description in Ecore_Getopt_Desc table.
+ * @brief Definition for filling full unsigned short type option description in Ecore_Getopt_Desc table.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -658,7 +658,7 @@ struct _Ecore_Getopt
                           {.ushortv = default_value})
 
 /**
- * @brief Fill full unsigned int type option description in Ecore_Getopt_Desc table.
+ * @brief Definition for filling full unsigned int type option description in Ecore_Getopt_Desc table.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -674,7 +674,7 @@ struct _Ecore_Getopt
                           {.uintv = default_value})
 
 /**
- * @brief Fill full unsigned long type option description in Ecore_Getopt_Desc table.
+ * @brief Definition for filling full unsigned long type option description in Ecore_Getopt_Desc table.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -690,7 +690,7 @@ struct _Ecore_Getopt
                           {.ulongv = default_value})
 
 /**
- * @brief Fill full double type option description in Ecore_Getopt_Desc table.
+ * @brief Definition for filling full double type option description in Ecore_Getopt_Desc table.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -706,7 +706,7 @@ struct _Ecore_Getopt
                           {.doublev = default_value})
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with a constant value.
+ * @brief Definition for filling Ecore_Getopt_Desc table with a constant value.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -718,7 +718,7 @@ struct _Ecore_Getopt
    {.store_const = value}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with a true boolean value.
+ * @brief Definition for filling Ecore_Getopt_Desc table with a true boolean value.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -729,7 +729,7 @@ struct _Ecore_Getopt
    {.dummy = NULL}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with a false boolean value.
+ * @brief Definition for filling Ecore_Getopt_Desc table with a false boolean value.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -740,7 +740,7 @@ struct _Ecore_Getopt
    {.dummy = NULL}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with a true boolean value.
+ * @brief Definition for filling Ecore_Getopt_Desc table with a true boolean value.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -752,7 +752,7 @@ struct _Ecore_Getopt
    {.choices = choices_array}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with a choice.
+ * @brief Definition for filling Ecore_Getopt_Desc table with a choice.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -765,7 +765,7 @@ struct _Ecore_Getopt
    {.choices = choices_array}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an append action.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an append action.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -777,7 +777,7 @@ struct _Ecore_Getopt
    {.append_type = sub_type}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an append action and a metavar.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an append action and a metavar.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -790,7 +790,7 @@ struct _Ecore_Getopt
    {.append_type = type}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an count action.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an count action.
  *
  * This will store the number of time the option has been passed to the command
  * line.
@@ -803,7 +803,7 @@ struct _Ecore_Getopt
    {.dummy = NULL}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an callback action and argument requirements.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an callback action and argument requirements.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -811,7 +811,7 @@ struct _Ecore_Getopt
  * @param metavar The metavar message concerning the parameter of the option.
  * @param callback_func The callback function to call.
  * @param callback_data The data to pass to the callback.
- * @param argument_requirement the required arguments to this option.
+ * @param argument_requirement The required arguments to this option.
  * @param default_value The default values for these arguments.
  */
 #define ECORE_GETOPT_CALLBACK_FULL(shortname, longname, help, metavar, callback_func, callback_data, argument_requirement, default_value) \
@@ -820,7 +820,7 @@ struct _Ecore_Getopt
                  argument_requirement, default_value}}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an callback action and no arguments.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an callback action and no arguments.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -835,7 +835,7 @@ struct _Ecore_Getopt
                              NULL)
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with an callback action.
+ * @brief Definition for filling Ecore_Getopt_Desc table with an callback action.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -851,7 +851,7 @@ struct _Ecore_Getopt
                              NULL)
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with a help action.
+ * @brief Definition for filling Ecore_Getopt_Desc table with a help action.
  *
  * @param shortname The help option short name.
  * @param longname The help option long name.
@@ -862,7 +862,7 @@ struct _Ecore_Getopt
    {.dummy = NULL}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with a version action.
+ * @brief Definition for filling Ecore_Getopt_Desc table with a version action.
  *
  * @param shortname The version option short name.
  * @param longname The version option long name.
@@ -873,7 +873,7 @@ struct _Ecore_Getopt
    {.dummy = NULL}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with a copyright action.
+ * @brief Definition for filling Ecore_Getopt_Desc table with a copyright action.
  *
  * @param shortname The copyright option short name.
  * @param longname The copyright option long name.
@@ -884,7 +884,7 @@ struct _Ecore_Getopt
    {.dummy = NULL}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with a license action.
+ * @brief Definition for filling Ecore_Getopt_Desc table with a license action.
  *
  * @param shortname The license option short name.
  * @param longname The license option long name.
@@ -895,7 +895,7 @@ struct _Ecore_Getopt
    {.dummy = NULL}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with a break action.
+ * @brief Definition for filling Ecore_Getopt_Desc table with a break action.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -906,7 +906,7 @@ struct _Ecore_Getopt
    {.dummy = NULL}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with a break action with help message.
+ * @brief Definition for filling Ecore_Getopt_Desc table with a break action with help message.
  *
  * @param shortname The option short name.
  * @param longname The option long name.
@@ -921,104 +921,104 @@ struct _Ecore_Getopt
   {0, name, help, NULL, ECORE_GETOPT_ACTION_CATEGORY, {.dummy = NULL}}
 
 /**
- * @brief Fill Ecore_Getopt_Desc table with a sentinel to indicate the end of descriptions.
+ * @brief Definition for filling Ecore_Getopt_Desc table with a sentinel to indicate the end of descriptions.
  *
  */
 #define ECORE_GETOPT_SENTINEL {0, NULL, NULL, NULL, 0, {.dummy = NULL}}
 
 /**
- * @brief options that store a single value in a variable of type string.
+ * @brief Definition for options that store a single value in a variable of type string.
  *
  * @param val The value to store.
  */
 #define ECORE_GETOPT_VALUE_STR(val)      {.strp = &(val)}
 
 /**
- * @brief options that store a single value in a variable of type boolean.
+ * @brief Definition for options that store a single value in a variable of type boolean.
  *
  * @param val The value to store.
  */
 #define ECORE_GETOPT_VALUE_BOOL(val)     {.boolp = &(val)}
 
 /**
- * @brief options that store a single value in a variable of type short.
+ * @brief Definition for options that store a single value in a variable of type short.
  *
  * @param val The value to store.
  */
 #define ECORE_GETOPT_VALUE_SHORT(val)    {.shortp = &(val)}
 
 /**
- * @brief options that store a single value in a variable of type int.
+ * @brief Definition for options that store a single value in a variable of type int.
  *
  * @param val The value to store.
  */
 #define ECORE_GETOPT_VALUE_INT(val)      {.intp = &(val)}
 
 /**
- * @brief options that store a single value in a variable of type long.
+ * @brief Definition for options that store a single value in a variable of type long.
  *
  * @param val The value to store.
  */
 #define ECORE_GETOPT_VALUE_LONG(val)     {.longp = &(val)}
 
 /**
- * @brief options that store a single value in a variable of type unsigned short.
+ * @brief Definition for options that store a single value in a variable of type unsigned short.
  *
  * @param val The value to store.
  */
 #define ECORE_GETOPT_VALUE_USHORT(val)   {.ushortp = &(val)}
 
 /**
- * @brief options that store a single value in a variable of type unsigned int.
+ * @brief Definition for options that store a single value in a variable of type unsigned int.
  *
  * @param val The value to store.
  */
 #define ECORE_GETOPT_VALUE_UINT(val)     {.uintp = &(val)}
 
 /**
- * @brief options that store a single value in a variable of type unsigned long.
+ * @brief Definition for options that store a single value in a variable of type unsigned long.
  *
  * @param val The value to store.
  */
 #define ECORE_GETOPT_VALUE_ULONG(val)    {.ulongp = &(val)}
 
 /**
- * @brief options that store a single value in a variable of type double.
+ * @brief Definition for options that store a single value in a variable of type double.
  *
  * @param val The value to store.
  */
 #define ECORE_GETOPT_VALUE_DOUBLE(val)   {.doublep = &(val)}
 
 /**
- * @brief options that store a single value in a variable of type pointer.
+ * @brief Definition for options that store a single value in a variable of type pointer.
  *
  * @param val The value to store.
  */
 #define ECORE_GETOPT_VALUE_PTR(val)      {.ptrp = &(val)}
 
 /**
- * @brief options that store a single value in a variable of type pointer casted.
+ * @brief Definition for options that store a single value in a variable of type pointer casted.
  *
  * @param val The value to store.
  */
 #define ECORE_GETOPT_VALUE_PTR_CAST(val) {.ptrp = (void **)&(val)}
 
 /**
- * @brief options that store a single value in a variable of type list.
+ * @brief Definition for options that store a single value in a variable of type list.
  *
  * @param val The value to store.
  */
 #define ECORE_GETOPT_VALUE_LIST(val)     {.listp = &(val)}
 
 /**
- * @brief options that store a NULL value.
+ * @brief Definition for options that store a NULL value.
  *
  * @param val The value to store.
  */
 #define ECORE_GETOPT_VALUE_NONE {.ptrp = NULL}
 
 /**
- * Show nicely formatted help message for the given parser.
+ * Shows nicely formatted help message for the given parser.
  *
  * @param fp The file the message will be printed on.
  * @param info The structure containing information about command line options.
@@ -1028,7 +1028,7 @@ struct _Ecore_Getopt
 EAPI void       ecore_getopt_help(FILE *fp, const Ecore_Getopt *info);
 
 /**
- * Show help for a single category (along with program usage and description).
+ * Shows help for a single category (along with program usage and description).
  *
  * @param fp The file the message will be printed on.
  * @param info The structure containing information about command line options.
@@ -1041,7 +1041,7 @@ EAPI void       ecore_getopt_help(FILE *fp, const Ecore_Getopt *info);
 EAPI Eina_Bool  ecore_getopt_help_category(FILE *fp, const Ecore_Getopt *info, const char *category);
 
 /**
- * Check parser for duplicate entries, print them out.
+ * Checks parser for duplicate entries, print them out.
  *
  * @return @c EINA_TRUE if there are duplicates, @c EINA_FALSE otherwise.
  * @param parser The parser to be checked.
@@ -1049,7 +1049,7 @@ EAPI Eina_Bool  ecore_getopt_help_category(FILE *fp, const Ecore_Getopt *info, c
 EAPI Eina_Bool  ecore_getopt_parser_has_duplicates(const Ecore_Getopt *parser);
 
 /**
- * Parse command line parameters.
+ * Parses command line parameters.
  *
  * Walks the command line parameters and parse them based on @a parser
  * description, doing actions based on @c parser->descs->action, like
@@ -1098,22 +1098,22 @@ EAPI Eina_Bool  ecore_getopt_parser_has_duplicates(const Ecore_Getopt *parser);
  * help, license, copyright, version and eventually others you may
  * define.
  *
- * @param parser description of how to work.
- * @param values where to store values, it is assumed that this is a vector
+ * @param parser Description of how to work.
+ * @param values Where to store values, it is assumed that this is a vector
  *        of the same size as @c parser->descs. Values should be previously
  *        initialized.
- * @param argc how many elements in @a argv. If not provided it will be
+ * @param argc How many elements in @a argv. If not provided it will be
  *        retrieved with ecore_app_args_get().
- * @param argv command line parameters.
+ * @param argv Command line parameters.
  *
- * @return index of first non-option parameter or -1 on error.
+ * @return Index of first non-option parameter or @c -1 on error.
  *
  * @see ecore_getopt_parse_positional()
  */
 EAPI int        ecore_getopt_parse(const Ecore_Getopt *parser, Ecore_Getopt_Value *values, int argc, char **argv);
 
 /**
- * Parse command line positional parameters.
+ * Parses command line positional parameters.
  *
  * Walks the command line positional parameters (those that do not
  * start with "-" or "--") and parse them based on @a parser
@@ -1148,18 +1148,18 @@ EAPI int        ecore_getopt_parse(const Ecore_Getopt *parser, Ecore_Getopt_Valu
  * standard/global gettext() call will be applied on them if ecore was
  * compiled with such support.
  *
- * @param parser description of how to work.
- * @param values where to store values, it is assumed that this is a vector
+ * @param parser Description of how to work.
+ * @param values Where to store values, it is assumed that this is a vector
  *        of the same size as @c parser->descs. Values should be previously
  *        initialized.
- * @param argc how many elements in @a argv. If not provided it will be
+ * @param argc How many elements in @a argv. If not provided it will be
  *        retrieved with ecore_app_args_get().
- * @param argv command line parameters.
- * @param start the initial position argument to look at, usually the
+ * @param argv Command line parameters.
+ * @param start The initial position argument to look at, usually the
  *        return of ecore_getopt_parse(). If less than 1, will try to
  *        find it automatically.
  *
- * @return index of first non-option parameter or -1 on error. If the
+ * @return Index of first non-option parameter or @c -1 on error. If the
  *         last positional argument is of action @c
  *         ECORE_GETOPT_ACTION_APPEND then it will be the same as @a argc.
  */
@@ -1167,9 +1167,9 @@ EAPI int        ecore_getopt_parse_positional(const Ecore_Getopt *parser, Ecore_
 
 
 /**
- * Utility to free list and nodes allocated by @a ECORE_GETOPT_ACTION_APPEND.
+ * Utilities to free list and nodes allocated by @a ECORE_GETOPT_ACTION_APPEND.
  *
- * @param list pointer to list to be freed.
+ * @param list Pointer to list to be freed.
  * @return always @c NULL, so you can easily make your list head @c NULL.
  */
 EAPI Eina_List *ecore_getopt_list_free(Eina_List *list);
@@ -1181,11 +1181,11 @@ EAPI Eina_List *ecore_getopt_list_free(Eina_List *list);
  * @param desc This parameter isn't in use.
  * @param str Geometry value
  * @param data This parameter isn't in use.
- * @param storage must be a pointer to @c Eina_Rectangle and will be used to
+ * @param storage Must be a pointer to @c Eina_Rectangle and will be used to
  * store the four values passed in the given string.
  * @return @c EINA_TRUE on success, @c EINA_FALSE on incorrect geometry value.
  *
- * This is a helper functions to be used with ECORE_GETOPT_CALLBACK_*().
+ * This is a helper function to be used with ECORE_GETOPT_CALLBACK_*().
  * 
  * @c callback_data value is ignored, you can safely use @c NULL.
  */
@@ -1198,7 +1198,7 @@ EAPI Eina_Bool  ecore_getopt_callback_geometry_parse(const Ecore_Getopt *parser,
  * @param desc This parameter isn't in use.
  * @param str size value
  * @param data This parameter isn't in use.
- * @param storage must be a pointer to @c Eina_Rectangle and will be used to
+ * @param storage Must be a pointer to @c Eina_Rectangle and will be used to
  * store the two values passed in the given string and @c 0 in the x and y
  * fields.
  * @return @c EINA_TRUE on success, @c EINA_FALSE on incorrect size value.
diff --git a/src/lib/ecore/Ecore_Legacy.h b/src/lib/ecore/Ecore_Legacy.h
index 3db194a074..f596b40873 100644
--- a/src/lib/ecore/Ecore_Legacy.h
+++ b/src/lib/ecore/Ecore_Legacy.h
@@ -30,21 +30,21 @@ extern "C" {
  * closest power of 2 greater than @a interval will be used.
  *
  * When the poller @p func is called, it must return a value of either
- * ECORE_CALLBACK_RENEW(or 1) or ECORE_CALLBACK_CANCEL(or 0). If it
- * returns 1, it will be called again at the next tick, or if it returns
- * 0 it will be deleted automatically making any references/handles for it
+ * @c ECORE_CALLBACK_RENEW(or @c 1) or @c ECORE_CALLBACK_CANCEL(or @c 0). If it
+ * returns @c 1, it will be called again at the next tick, or if it returns
+ * @c 0 it will be deleted automatically making any references/handles for it
  * invalid.
  */
 EAPI Ecore_Poller *ecore_poller_add(Ecore_Poller_Type type, int interval, Ecore_Task_Cb func, const void *data);
 
 /**
- * @brief Delete the specified poller from the timer list.
+ * @brief Deletes the specified poller from the timer list.
  * @param poller The poller to delete.
  * @return The data pointer set for the timer when @ref ecore_poller_add was
  * called on success, @c NULL otherwise.
  *
  * @note @a poller must be a valid handle. If the poller function has already
- * returned 0, the handle is no longer valid (and does not need to be deleted).
+ * returned @c 0, the handle is no longer valid (and does not need to be deleted).
  */
 EAPI void *ecore_poller_del(Ecore_Poller *poller);
 
@@ -80,7 +80,7 @@ EAPI double ecore_poller_poll_interval_get(Ecore_Poller_Type type);
 typedef struct _Ecore_Animator Ecore_Animator;
 
 /**
- * @brief Add an animator to call @p func at every animation tick during main
+ * @brief Adds an animator to call @p func at every animation tick during main
  * loop execution.
  *
  * @param func The function to call when it ticks off
@@ -93,19 +93,19 @@ typedef struct _Ecore_Animator Ecore_Animator;
  * function will be passed the @p data pointer as its parameter.
  *
  * When the animator @p func is called, it must return a boolean value.
- * If it returns EINA_TRUE (or ECORE_CALLBACK_RENEW), it will be called again at
- * the next tick, or if it returns EINA_FALSE (or ECORE_CALLBACK_CANCEL) it will be
+ * If it returns @c EINA_TRUE (or @c ECORE_CALLBACK_RENEW), it will be called again at
+ * the next tick, or if it returns @c EINA_FALSE (or @c ECORE_CALLBACK_CANCEL) it will be
  * deleted automatically making any references/handles for it invalid.
+ * @see ecore_animator_timeline_add()
+ * @see ecore_animator_frametime_set()
  *
  * @note The default @p frametime value is 1/30th of a second.
  *
- * @see ecore_animator_timeline_add()
- * @see ecore_animator_frametime_set()
  */
 EAPI Ecore_Animator *ecore_animator_add(Ecore_Task_Cb func, const void *data);
 
 /**
- * @brief Add an animator that runs for a limited time
+ * @brief Adds an animator that runs for a limited time.
  *
  * @param runtime The time to run in seconds
  * @param func The function to call when it ticks off
@@ -115,8 +115,8 @@ EAPI Ecore_Animator *ecore_animator_add(Ecore_Task_Cb func, const void *data);
  * This function is just like ecore_animator_add() except the animator only
  * runs for a limited time specified in seconds by @p runtime. Once the
  * runtime the animator has elapsed (animator finished) it will automatically
- * be deleted. The callback function @p func can return ECORE_CALLBACK_RENEW
- * to keep the animator running or ECORE_CALLBACK_CANCEL ro stop it and have
+ * be deleted. The callback function @p func can return @c ECORE_CALLBACK_RENEW
+ * to keep the animator running or @c ECORE_CALLBACK_CANCEL ro stop it and have
  * it be deleted automatically at any time.
  *
  * The @p func will ALSO be passed a position parameter that will be in value
@@ -124,22 +124,22 @@ EAPI Ecore_Animator *ecore_animator_add(Ecore_Task_Cb func, const void *data);
  * the animator run is at. If the callback wishes not to have a linear
  * transition it can "map" this value to one of several curves and mappings
  * via ecore_animator_pos_map().
+ * @see ecore_animator_add()
+ * @see ecore_animator_pos_map()
  *
  * @note The default @p frametime value is 1/30th of a second.
  *
- * @see ecore_animator_add()
- * @see ecore_animator_pos_map()
  * @since 1.1.0
  */
 EAPI Ecore_Animator *ecore_animator_timeline_add(double runtime, Ecore_Timeline_Cb func, const void *data);
 
 /**
- * @brief Delete the specified animator from the animator list.
+ * @brief Deletes the specified animator from the animator list.
  *
  * @param animator The animator to delete
  * @return The data pointer set for the animator on add
  *
- * Delete the specified @p animator from the set of animators that are
+ * Deletes the specified @p animator from the set of animators that are
  * executed during main loop execution. This function returns the data
  * parameter that was being passed to the callback on success, or @c NULL on
  * failure. After this call returns the specified animator object @p animator
@@ -149,7 +149,7 @@ EAPI Ecore_Animator *ecore_animator_timeline_add(double runtime, Ecore_Timeline_
 EAPI void *ecore_animator_del(Ecore_Animator *animator);
 
 /**
- * @brief Suspend the specified animator.
+ * @brief Suspends the specified animator.
  *
  * @param animator The animator to delete
  *
@@ -165,7 +165,7 @@ EAPI void *ecore_animator_del(Ecore_Animator *animator);
 EAPI void ecore_animator_freeze(Ecore_Animator *animator);
 
 /**
- * @brief Restore execution of the specified animator.
+ * @brief Restores execution of the specified animator.
  *
  * @param animator The animator to delete
  *
@@ -187,19 +187,19 @@ EAPI void ecore_animator_thaw(Ecore_Animator *animator);
 /**
  * Creates a timer to call the given function in the given period of time.
  * @param   in   The interval in seconds.
- * @param   func The given function.  If @p func returns 1, the timer is
+ * @param   func The given function.  If @p func returns @c 1, the timer is
  *               rescheduled for the next interval @p in.
  * @param   data Data to pass to @p func when it is called.
- * @return  A timer object on success.  @c NULL on failure.
+ * @return  A timer object on success,  @c NULL on failure.
  *
- * This function adds a timer and returns its handle on success and NULL on
+ * This function adds a timer and returns its handle on success and @c NULL on
  * failure. The function @p func will be called every @p in seconds. The
  * function will be passed the @p data pointer as its parameter.
  *
- * When the timer @p func is called, it must return a value of either 1
- * (or ECORE_CALLBACK_RENEW) or 0 (or ECORE_CALLBACK_CANCEL).
- * If it returns 1, it will be called again at the next tick, or if it returns
- * 0 it will be deleted automatically making any references/handles for it
+ * When the timer @p func is called, it must return a value of either @c 1
+ * (or @c ECORE_CALLBACK_RENEW) or @c 0 (or @c ECORE_CALLBACK_CANCEL).
+ * If it returns @c 1, it will be called again at the next tick, or if it returns
+ * @c 0 it will be deleted automatically making any references/handles for it
  * invalid.
  */
 EAPI Ecore_Timer *ecore_timer_add(double in, Ecore_Task_Cb func, const void *data);
@@ -210,7 +210,7 @@ EAPI Ecore_Timer *ecore_timer_add(double in, Ecore_Task_Cb func, const void *dat
  * @param   func The given function.  If @p func returns 1, the timer is
  *               rescheduled for the next interval @p in.
  * @param   data Data to pass to @p func when it is called.
- * @return  A timer object on success.  @c NULL on failure.
+ * @return  A timer object on success,  @c NULL on failure.
  *
  * This is the same as ecore_timer_add(), but "now" is the time from
  * ecore_loop_time_get() not ecore_time_get() as ecore_timer_add() uses. See
@@ -219,13 +219,13 @@ EAPI Ecore_Timer *ecore_timer_add(double in, Ecore_Task_Cb func, const void *dat
 EAPI Ecore_Timer *ecore_timer_loop_add(double in, Ecore_Task_Cb func, const void *data);
 
 /**
- * Delete the specified timer from the timer list.
+ * Deletes the specified timer from the timer list.
  * @param   timer The timer to delete.
  * @return  The data pointer set for the timer when @ref ecore_timer_add was
  *          called.  @c NULL is returned if the function is unsuccessful.
  *
  * Note: @p timer must be a valid handle. If the timer function has already
- * returned 0, the handle is no longer valid (and does not need to be delete).
+ * returned @c 0, the handle is no longer valid (and does not need to be delete).
  */
 EAPI void *ecore_timer_del(Ecore_Timer *timer);
 
@@ -248,7 +248,7 @@ EAPI void ecore_timer_thaw(Ecore_Timer *timer);
  */
 
 /**
- * Add an idler handler.
+ * Adds an idler handler.
  * @param  func The function to call when idling.
  * @param  data The data to be passed to this @p func call.
  * @return A idler handle if successfully added, @c NULL otherwise.
@@ -256,15 +256,15 @@ EAPI void ecore_timer_thaw(Ecore_Timer *timer);
  * Add an idler handle to the event loop, returning a handle on
  * success and @c NULL otherwise. The function @p func will be called
  * repeatedly while no other events are ready to be processed, as
- * long as it returns @c 1 (or ECORE_CALLBACK_RENEW). A return of @c 0
- * (or ECORE_CALLBACK_CANCEL) deletes the idler.
+ * long as it returns @c 1 (or @c ECORE_CALLBACK_RENEW). A return of @c 0
+ * (or @c ECORE_CALLBACK_CANCEL) deletes the idler.
  *
  * Idlers are useful for progressively processing data without blocking.
  */
 EAPI Ecore_Idler *ecore_idler_add(Ecore_Task_Cb func, const void *data);
 
 /**
- * Delete an idler callback from the list to be executed.
+ * Deletes an idler callback from the list to be executed.
  * @param  idler The handle of the idler callback to delete
  * @return The data pointer passed to the idler callback on success, @c NULL
  *         otherwise.
@@ -272,53 +272,53 @@ EAPI Ecore_Idler *ecore_idler_add(Ecore_Task_Cb func, const void *data);
 EAPI void *ecore_idler_del(Ecore_Idler *idler);
 
 /**
- * Add an idle enterer handler.
+ * Adds an idle enterer handler.
  * @param   func The function to call when entering an idle state.
  * @param   data The data to be passed to the @p func call
  * @return  A handle to the idle enterer callback if successful.  Otherwise,
- *          NULL is returned.
+ *          @c NULL is returned.
  * @note The function func will be called every time the main loop is entering
- * idle state, as long as it returns 1 (or ECORE_CALLBACK_RENEW). A return of 0
- * (or ECORE_CALLBACK_CANCEL) deletes the idle enterer.
+ * idle state, as long as it returns @c 1 (or @c ECORE_CALLBACK_RENEW). A return of @c 0
+ * (or @c ECORE_CALLBACK_CANCEL) deletes the idle enterer.
  */
 EAPI Ecore_Idle_Enterer *ecore_idle_enterer_add(Ecore_Task_Cb func, const void *data);
 
 /**
- * Add an idle enterer handler at the start of the list so it gets called earlier than others.
+ * Adds an idle enterer handler at the start of the list so it gets called earlier than others.
  * @param   func The function to call when entering an idle state.
  * @param   data The data to be passed to the @p func call
  * @return  A handle to the idle enterer callback if successful.  Otherwise,
- *          NULL is returned.
+ *          @c NULL is returned.
  * @note The function func will be called every time the main loop is entering
- * idle state, as long as it returns 1 (or ECORE_CALLBACK_RENEW). A return of 0
- * (or ECORE_CALLBACK_CANCEL) deletes the idle enterer.
+ * idle state, as long as it returns @c 1 (or @c ECORE_CALLBACK_RENEW). A return of @c 0
+ * (or @c ECORE_CALLBACK_CANCEL) deletes the idle enterer.
  */
 EAPI Ecore_Idle_Enterer *ecore_idle_enterer_before_add(Ecore_Task_Cb func, const void *data);
 
 /**
- * Delete an idle enterer callback.
+ * Deletes an idle enterer callback.
  * @param   idle_enterer The idle enterer to delete
  * @return  The data pointer passed to the idler enterer callback on success.
- *          NULL otherwise.
+ *          @c NULL otherwise.
  */
 EAPI void *ecore_idle_enterer_del(Ecore_Idle_Enterer *idle_enterer);
 
 /**
- * Add an idle exiter handler.
+ * Adds an idle exiter handler.
  * @param func The function to call when exiting an idle state.
- * @param data The data to be passed to the @p func call
- * @return A handle to the idle exiter callback on success.  NULL otherwise.
+ * @param data The data to be passed to the @p func call.
+ * @return A handle to the idle exiter callback on success.  @c NULL otherwise.
  * @note The function func will be called every time the main loop is exiting
- * idle state, as long as it returns 1 (or ECORE_CALLBACK_RENEW). A return of 0
- * (or ECORE_CALLBACK_CANCEL) deletes the idle exiter.
+ * idle state, as long as it returns @c 1 (or @c ECORE_CALLBACK_RENEW). A return of @c 0
+ * (or @c ECORE_CALLBACK_CANCEL) deletes the idle exiter.
  */
 EAPI Ecore_Idle_Exiter *ecore_idle_exiter_add(Ecore_Task_Cb func, const void *data);
 
 /**
- * Delete an idle exiter handler from the list to be run on exiting idle state.
+ * Deletes an idle exiter handler from the list to be run on exiting idle state.
  * @param idle_exiter The idle exiter to delete
  * @return The data pointer that was being being passed to the handler if
- *         successful.  NULL otherwise.
+ *         successful. @c NULL otherwise.
  */
 EAPI void *ecore_idle_exiter_del(Ecore_Idle_Exiter *idle_exiter);
 
@@ -344,7 +344,7 @@ EAPI void *ecore_idle_exiter_del(Ecore_Idle_Exiter *idle_exiter);
  * @{
  */
 /**
- * Add a job to the event queue.
+ * Adds a job to the event queue.
  * @param   func The function to call when the job gets handled.
  * @param   data Data pointer to be passed to the job function when the job is
  *               handled.
@@ -355,7 +355,7 @@ EAPI void *ecore_idle_exiter_del(Ecore_Idle_Exiter *idle_exiter);
 EAPI Ecore_Job *ecore_job_add(Ecore_Cb func, const void *data);
 
 /**
- * Delete a queued job that has not yet been executed.
+ * Deletes a queued job that has not yet been executed.
  * @param   obj  Handle of the job to delete.
  * @return  The data pointer that was to be passed to the job.
  */