doxygen docs: Fix several warnings in Eina files

diff --git a/src/lib/eina/eina_accessor.h b/src/lib/eina/eina_accessor.h
index c0fdb37..96f9549 100644 (file)
--- a/src/lib/eina/eina_accessor.h
+++ b/src/lib/eina/eina_accessor.h
@@ -398,7 +398,7 @@ EAPI Eina_Accessor* eina_carray_length_ptr_accessor_new(void** array, unsigned i
  * @def EINA_C_ARRAY_ACCESSOR_NEW
  * @brief Creates an Eina_Accessor that wraps a plain fixed size C array
  *
- * @param[in] array The array
+ * @param[in] Array The array
  * @return The accessor that will give access to the passed array
  *
  * You can create it like this:
@@ -413,7 +413,7 @@ EAPI Eina_Accessor* eina_carray_length_ptr_accessor_new(void** array, unsigned i
  * @def EINA_C_ARRAY_ACCESSOR_NEW
  * @brief Creates an Eina_Accessor that wraps a plain fixed size C array
  *
- * @param[in] array The array
+ * @param[in] Array The array
  * @return The accessor that will give access to the passed array
  *
  * You can create it like this:

diff --git a/src/lib/eina/eina_debug.h b/src/lib/eina/eina_debug.h
index 0bc6e5f..dbc36ca 100644 (file)
--- a/src/lib/eina/eina_debug.h
+++ b/src/lib/eina/eina_debug.h
@@ -108,7 +108,7 @@ typedef Eina_Bool (*Eina_Debug_Timer_Cb)(void *);
 typedef struct _Eina_Debug_Timer Eina_Debug_Timer;
 
 /**
- * @typedef Eina_Debug_Packet_Header
+ * @struct Eina_Debug_Packet_Header
  *
  * Header of Eina Debug packet
  */
@@ -143,7 +143,7 @@ typedef struct
   }
 
 /**
- * @typedef Eina_Debug_Opcode
+ * @struct Eina_Debug_Opcode
  *
  * Structure to describe information for an opcode. It is used to register new
  * opcodes.

diff --git a/src/lib/eina/eina_error.h b/src/lib/eina/eina_error.h
index 837bf92..e5a0612 100644 (file)
--- a/src/lib/eina/eina_error.h
+++ b/src/lib/eina/eina_error.h
@@ -107,7 +107,7 @@ typedef Eina_Bool Eina_Success_Flag;
 #define EINA_ERROR_NO_ERROR ((Eina_Error)0)
 
 /**
- * @var EINA_ERROR_OUT_OF_MEMORY
+ * @var Eina_Error EINA_ERROR_OUT_OF_MEMORY
  * @brief The error identifier corresponding to lack of memory.
  *
  * @deprecated since 1.19, same as @c ENOMEM from @c errno.h

diff --git a/src/lib/eina/eina_hash.h b/src/lib/eina/eina_hash.h
index 4e4b4e4..28e7ee5 100644 (file)
--- a/src/lib/eina/eina_hash.h
+++ b/src/lib/eina/eina_hash.h
@@ -320,7 +320,7 @@ typedef unsigned int (*Eina_Key_Length)(const void *key);
 typedef int          (*Eina_Key_Cmp)(const void *key1, int key1_length, const void *key2, int key2_length);
 /**
  * @def EINA_KEY_CMP
- * @param[in]Function The function used to compare hash key.
+ * @param[in] Function The function used to compare hash key.
  */
 #define EINA_KEY_CMP(Function)    ((Eina_Key_Cmp)Function)
 

diff --git a/src/lib/eina/eina_iterator.h b/src/lib/eina/eina_iterator.h
index 4f05bda..092a89c 100644 (file)
--- a/src/lib/eina/eina_iterator.h
+++ b/src/lib/eina/eina_iterator.h
@@ -322,7 +322,7 @@ EAPI Eina_Iterator *eina_carray_length_iterator_new(void** array, unsigned int s
  * @brief Creates an Eina_Iterator that iterates through a
  * NUL-terminated C array.
  *
- * @param[in] array The NUL-terminated array
+ * @param[in] Array The NUL-terminated array
  * @return The iterator that will walk over the array.
  *
  * You can create it like this:
@@ -370,10 +370,10 @@ EAPI Eina_Iterator *eina_multi_iterator_internal_new(Eina_Iterator *it, ...) EIN
  * @brief Calls the process method on each node of iterator, producing new "processed"
  * nodes and returning a new iterator which contains them.
  *
- * @param[in] original Iterator containing the nodes to process.
+ * @param[in] iterator Iterator containing the nodes to process.
  * @param[in] process Method to call on each node.
  * @param[in] free_cb Method called when all nodes have been processed. It receives "data" as a parameter.
- * @param[in] data Additional data passed to the process method.
+ * @param[in] fdata Additional data passed to the process method.
  *
  * Processes every node in the input iterator and returns a new iterator containing
  * the processed nodes. This is akin to a Map function:
@@ -388,7 +388,7 @@ EAPI Eina_Iterator* eina_iterator_processed_new(Eina_Iterator *iterator, Eina_Pr
  * @brief Creates an Eina_Iterator that iterates through a series
  * of Eina_Iterator.
  *
- * @param[in] it The first Eina_Iterator to iterate over
+ * @param[in] It The first Eina_Iterator to iterate over
  * @return The iterator that will walk all the other iterator
  *
  * Eina_Iterator* iterator = eina_multi_iterator_new(it1, it2, it3);

diff --git a/src/lib/eina/eina_list.h b/src/lib/eina/eina_list.h
index c507953..cf33a0e 100644 (file)
--- a/src/lib/eina/eina_list.h
+++ b/src/lib/eina/eina_list.h
@@ -1373,7 +1373,7 @@ EAPI int                   eina_list_data_idx(const Eina_List *list, void *data)
  *
  * @param[in] list The list to iterate over.
  * @param[out] l A list that is used as an iterator and points to the current node.
- * @param[out] data Current item's data.
+ * @param[out] _data Current item's data.
  *
  * This macro iterates over @p list from the first element to
  * the last. @p data is the data related to the current element.
@@ -1441,7 +1441,7 @@ EAPI int                   eina_list_data_idx(const Eina_List *list, void *data)
  *
  * @param[in] list The list to iterate over.
  * @param[out] l A list that is used as an iterator and points to the current node.
- * @param[out] data Current item's data.
+ * @param[out] _data Current item's data.
  *
  * This macro works like EINA_LIST_FOREACH, but iterates from the
  * last element of a list to the first.

diff --git a/src/lib/eina/eina_lock.h b/src/lib/eina/eina_lock.h
index ed747e4..6d4bbec 100644 (file)
--- a/src/lib/eina/eina_lock.h
+++ b/src/lib/eina/eina_lock.h
@@ -265,7 +265,7 @@ static inline Eina_Bool eina_condition_wait(Eina_Condition *cond);
  * @param[in] t The maximum amount of time to wait, in seconds.
  *
  * @return #EINA_TRUE on success, #EINA_FALSE otherwise. If the operation
- *         timed out, eina error will be set to #ETIMEDOUT.
+ *         timed out, eina error will be set to @c ETIMEDOUT.
  *
  * @see eina_condition_wait()
  */
@@ -549,7 +549,7 @@ static inline Eina_Bool eina_barrier_wait(Eina_Barrier *barrier);
  * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
  *
  * @note Spinlocks are only implemented on the POSIX platform and are only available
- *      if #EINA_HAVE_POSIX_SPINLOCK is defined. you get a new #Eina_Lock on All other platforms.
+ *      if @c EINA_HAVE_POSIX_SPINLOCK is defined. You get a new #Eina_Lock on All other platforms.
  *
  * @see eina_spinlock_free()
  */

diff --git a/src/lib/eina/eina_matrix.h b/src/lib/eina/eina_matrix.h
index 533609d..c20efd6 100644 (file)
--- a/src/lib/eina/eina_matrix.h
+++ b/src/lib/eina/eina_matrix.h
@@ -392,7 +392,7 @@ EAPI void eina_matrix3_compose(const Eina_Matrix3 *m1,
  *
  * @since 1.14
  */
-EAPI void eina_matrix3_translate(Eina_Matrix3 *t, double tx, double ty);
+EAPI void eina_matrix3_translate(Eina_Matrix3 *m, double tx, double ty);
 
 /**
  * @brief Sets the matrix values for a scaling operation.
@@ -403,16 +403,16 @@ EAPI void eina_matrix3_translate(Eina_Matrix3 *t, double tx, double ty);
  *
  * @since 1.14
  */
-EAPI void eina_matrix3_scale(Eina_Matrix3 *t, double sx, double sy);
+EAPI void eina_matrix3_scale(Eina_Matrix3 *m, double sx, double sy);
 
 /**
  * @brief Sets the matrix values for a rotation operation.
- * @param[out] t The matrix.
+ * @param[out] m The matrix.
  * @param[in] rad The number of radians to rotate.
  *
  * @since 1.14
  */
-EAPI void eina_matrix3_rotate(Eina_Matrix3 *t, double rad);
+EAPI void eina_matrix3_rotate(Eina_Matrix3 *m, double rad);
 
 /**
  * @brief Sets the given floating point matrix to the identity matrix.
@@ -424,7 +424,7 @@ EAPI void eina_matrix3_rotate(Eina_Matrix3 *t, double rad);
  *
  * @since 1.14
  */
-EAPI void eina_matrix3_identity(Eina_Matrix3 *t);
+EAPI void eina_matrix3_identity(Eina_Matrix3 *m);
 
 /**
  * @brief Calculates the determinant of the given matrix.

diff --git a/src/lib/eina/eina_rectangle.h b/src/lib/eina/eina_rectangle.h
index c1a0788..b58693a 100644 (file)
--- a/src/lib/eina/eina_rectangle.h
+++ b/src/lib/eina/eina_rectangle.h
@@ -553,7 +553,7 @@ EAPI Eina_Rectangle *eina_rectangle_new(int x, int y, int w, int h) EINA_MALLOC
 /**
  * @brief Frees the given rectangle.
  *
- * @param[iin] rect The rectangle to free.
+ * @param[in] rect The rectangle to free.
  *
  * This function removes @p rect from the rectangles pool.
  */

diff --git a/src/lib/eina/eina_slice.h b/src/lib/eina/eina_slice.h
index a597fe2..6bb3aaa 100644 (file)
--- a/src/lib/eina/eina_slice.h
+++ b/src/lib/eina/eina_slice.h
@@ -362,7 +362,7 @@ static inline char *eina_slice_strdup(const Eina_Slice slice);
 /**
  * @brief A null-terminated string for this slice.
  *
- * @param[in] slice the reference memory.
+ * @param[in] rw_slice the reference memory.
  * @return newly allocated memory or @c NULL on error
  *
  * @since 1.19

diff --git a/src/lib/eina/eina_value.h b/src/lib/eina/eina_value.h
index 8979399..6197f7c 100644 (file)
--- a/src/lib/eina/eina_value.h
+++ b/src/lib/eina/eina_value.h
@@ -1847,10 +1847,10 @@ static inline Eina_Bool eina_value_array_value_get(const Eina_Value *src,
  * @brief Definition for the macro to iterate over an array contained in an Eina_Value.
  * @since 1.21
  *
- * @param[in] array The list to iterate over.
- * @param[in] length Contain the length of the array
- * @param[out] it Contain the current position walked over
- * @param[out] value Contain the value at the current position.
+ * @param[in] Array The list to iterate over.
+ * @param[in] Length Contain the length of the array
+ * @param[out] It Contain the current position walked over
+ * @param[out] Value Contain the value at the current position.
  *
  * This macro iterates over @p array from the first element to
  * the last. @p value is the data related to the current element.
@@ -1966,7 +1966,7 @@ static inline Eina_Bool eina_value_list_setup(Eina_Value *value,
 /**
  * @brief Queries number of elements in value of list type.
  *
- * @param[in]value value object.
+ * @param[in] value value object.
  * @return number of child elements.
  *
  * @since 1.2