summaryrefslogtreecommitdiff
path: root/src/lib/eina
diff options
context:
space:
mode:
authorBryce Harrington <bryce@osg.samsung.com>2018-09-08 07:19:53 -0400
committerChris Michael <cp.michael@samsung.com>2018-09-08 07:19:53 -0400
commitf6d397df04dfff2dce5fe7d8a346ceeb0b8f64de (patch)
tree928827feb8c3a0c6d63d1b704ff97de107015e96 /src/lib/eina
parent84423a465ca2254a38a28bf6e0c62342340d13ad (diff)
eina: Add doxygen in/out tags for remaining APIs
Reviewers: devilhorns Reviewed By: devilhorns Subscribers: cedric, #reviewers, #committers Tags: #efl Differential Revision: https://phab.enlightenment.org/D7007
Diffstat (limited to 'src/lib/eina')
-rw-r--r--src/lib/eina/eina_accessor.h8
-rw-r--r--src/lib/eina/eina_file.h6
-rw-r--r--src/lib/eina/eina_file_common.h6
-rw-r--r--src/lib/eina/eina_hash.h210
-rw-r--r--src/lib/eina/eina_lalloc.h3
-rw-r--r--src/lib/eina/eina_matrix.h2
-rw-r--r--src/lib/eina/eina_promise.h4
-rw-r--r--src/lib/eina/eina_slstr.h18
-rw-r--r--src/lib/eina/eina_str.h92
-rw-r--r--src/lib/eina/eina_stringshare.h23
-rw-r--r--src/lib/eina/eina_thread.h36
-rw-r--r--src/lib/eina/eina_thread_queue.h38
-rw-r--r--src/lib/eina/eina_tiler.h88
-rw-r--r--src/lib/eina/eina_tmpstr.h16
-rw-r--r--src/lib/eina/eina_trash.h8
-rw-r--r--src/lib/eina/eina_types.h16
-rw-r--r--src/lib/eina/eina_unicode.h59
-rw-r--r--src/lib/eina/eina_ustringshare.h12
-rw-r--r--src/lib/eina/eina_util.h20
-rw-r--r--src/lib/eina/eina_value.h363
-rw-r--r--src/lib/eina/eina_vector.h210
-rw-r--r--src/lib/eina/eina_vpath.h13
-rw-r--r--src/lib/eina/eina_xattr.h96
23 files changed, 684 insertions, 663 deletions
diff --git a/src/lib/eina/eina_accessor.h b/src/lib/eina/eina_accessor.h
index aed6d9d307..3586d3c197 100644
--- a/src/lib/eina/eina_accessor.h
+++ b/src/lib/eina/eina_accessor.h
@@ -301,10 +301,10 @@ EAPI Eina_Bool eina_accessor_unlock(Eina_Accessor *accessor) EINA_ARG_NONNULL(1)
301 * @details This macro allows a convenient way to loop over all elements in an 301 * @details This macro allows a convenient way to loop over all elements in an
302 * accessor, very similar to EINA_LIST_FOREACH(). 302 * accessor, very similar to EINA_LIST_FOREACH().
303 * 303 *
304 * @param accessor The accessor to use 304 * @param[in] accessor The accessor to use
305 * @param counter A counter used by eina_accessor_data_get() when 305 * @param[out] counter A counter used by eina_accessor_data_get() when
306 * iterating over the container. 306 * iterating over the container.
307 * @param data A pointer to store the data \n 307 * @param[out] data A pointer to store the data \n
308 * It must be a pointer to support getting 308 * It must be a pointer to support getting
309 * its address since eina_accessor_data_get() requires a pointer. 309 * its address since eina_accessor_data_get() requires a pointer.
310 * 310 *
diff --git a/src/lib/eina/eina_file.h b/src/lib/eina/eina_file.h
index ea3e79481d..78c2b65596 100644
--- a/src/lib/eina/eina_file.h
+++ b/src/lib/eina/eina_file.h
@@ -288,7 +288,7 @@ EAPI Eina_Array *eina_file_split(char *path) EINA_WARN_UNUSED_RESULT EINA_ARG
288 * only fetched when advancing the iterator, which means there is very little 288 * only fetched when advancing the iterator, which means there is very little
289 * cost associated with creating the list and stopping halfway through it. 289 * cost associated with creating the list and stopping halfway through it.
290 * 290 *
291 * @param [in] dir The name of the directory to list 291 * @param[in] dir The name of the directory to list
292 * @return An #Eina_Iterator that walks over the files and directories 292 * @return An #Eina_Iterator that walks over the files and directories
293 * in @p dir. On failure, it returns @c NULL. 293 * in @p dir. On failure, it returns @c NULL.
294 * 294 *
@@ -309,7 +309,7 @@ EAPI Eina_Iterator *eina_file_ls(const char *dir) EINA_WARN_UNUSED_RESULT EINA_A
309 * dir is only fetched when advancing the iterator, which means there is 309 * dir is only fetched when advancing the iterator, which means there is
310 * cost associated with creating the list and stopping halfway through it. 310 * cost associated with creating the list and stopping halfway through it.
311 * 311 *
312 * @param [in] dir The name of the directory to list 312 * @param[in] dir The name of the directory to list
313 * 313 *
314 * @return An #Eina_Iterator that walks over the files and 314 * @return An #Eina_Iterator that walks over the files and
315 * directories in @p dir. On failure, it returns @c NULL. 315 * directories in @p dir. On failure, it returns @c NULL.
@@ -409,7 +409,7 @@ EAPI Eina_Bool eina_file_mkdtemp(const char *templatename, Eina_Tmpstr **path) E
409 * @p dir is only fetched when advancing the iterator, which means there is 409 * @p dir is only fetched when advancing the iterator, which means there is
410 * cost associated with creating the list and stopping halfway through it. 410 * cost associated with creating the list and stopping halfway through it.
411 * 411 *
412 * @param [in] dir The name of the directory to list 412 * @param[in] dir The name of the directory to list
413 * 413 *
414 * @return An Eina_Iterator that walks over the files and 414 * @return An Eina_Iterator that walks over the files and
415 * directories in @p dir. On failure, it returns @c NULL. 415 * directories in @p dir. On failure, it returns @c NULL.
diff --git a/src/lib/eina/eina_file_common.h b/src/lib/eina/eina_file_common.h
index c7ee3f87eb..142ee2d852 100644
--- a/src/lib/eina/eina_file_common.h
+++ b/src/lib/eina/eina_file_common.h
@@ -269,8 +269,8 @@ extern int _eina_file_log_dom;
269/** 269/**
270 * @brief Map the entire contents of a virtual file to a buffer. 270 * @brief Map the entire contents of a virtual file to a buffer.
271 * 271 *
272 * @param file The virtual file to map in memory 272 * @param[in] file The virtual file to map in memory
273 * 273 * @return The buffer
274 */ 274 */
275void *eina_file_virtual_map_all(Eina_File *file); 275void *eina_file_virtual_map_all(Eina_File *file);
276 276
@@ -280,7 +280,7 @@ void *eina_file_virtual_map_all(Eina_File *file);
280 * @param[in,out] file The virtual file to map in memory 280 * @param[in,out] file The virtual file to map in memory
281 * @param[in] offset The offset inside the file to start mapping 281 * @param[in] offset The offset inside the file to start mapping
282 * @param[in] length The length of the region to map 282 * @param[in] length The length of the region to map
283 * 283 * @return The buffer
284 */ 284 */
285void *eina_file_virtual_map_new(Eina_File *file, 285void *eina_file_virtual_map_new(Eina_File *file,
286 unsigned long int offset, unsigned long int length); 286 unsigned long int offset, unsigned long int length);
diff --git a/src/lib/eina/eina_hash.h b/src/lib/eina/eina_hash.h
index 6efdfce34b..16344cfed4 100644
--- a/src/lib/eina/eina_hash.h
+++ b/src/lib/eina/eina_hash.h
@@ -311,7 +311,7 @@ typedef unsigned int (*Eina_Key_Length)(const void *key);
311 311
312/** 312/**
313 * @def EINA_KEY_LENGTH 313 * @def EINA_KEY_LENGTH
314 * @param Function The function used to calculate length of hash key. 314 * @param[in] Function The function used to calculate length of hash key.
315 */ 315 */
316#define EINA_KEY_LENGTH(Function) ((Eina_Key_Length)Function) 316#define EINA_KEY_LENGTH(Function) ((Eina_Key_Length)Function)
317 317
@@ -322,7 +322,7 @@ typedef unsigned int (*Eina_Key_Length)(const void *key);
322typedef int (*Eina_Key_Cmp)(const void *key1, int key1_length, const void *key2, int key2_length); 322typedef int (*Eina_Key_Cmp)(const void *key1, int key1_length, const void *key2, int key2_length);
323/** 323/**
324 * @def EINA_KEY_CMP 324 * @def EINA_KEY_CMP
325 * @param Function The function used to compare hash key. 325 * @param[in]Function The function used to compare hash key.
326 */ 326 */
327#define EINA_KEY_CMP(Function) ((Eina_Key_Cmp)Function) 327#define EINA_KEY_CMP(Function) ((Eina_Key_Cmp)Function)
328 328
@@ -333,7 +333,7 @@ typedef int (*Eina_Key_Cmp)(const void *key1, int key1_length, const vo
333typedef int (*Eina_Key_Hash)(const void *key, int key_length); 333typedef int (*Eina_Key_Hash)(const void *key, int key_length);
334/** 334/**
335 * @def EINA_KEY_HASH 335 * @def EINA_KEY_HASH
336 * @param Function The function used to hash key. 336 * @param[in] Function The function used to hash key.
337 */ 337 */
338#define EINA_KEY_HASH(Function) ((Eina_Key_Hash)Function) 338#define EINA_KEY_HASH(Function) ((Eina_Key_Hash)Function)
339 339
@@ -347,13 +347,13 @@ typedef Eina_Bool (*Eina_Hash_Foreach)(const Eina_Hash *hash, const void *key
347/** 347/**
348 * @brief Creates a new hash table. 348 * @brief Creates a new hash table.
349 * 349 *
350 * @param key_length_cb The function called when getting the size of the key. 350 * @param[in] key_length_cb The function called when getting the size of the key.
351 * @param key_cmp_cb The function called when comparing the keys. 351 * @param[in] key_cmp_cb The function called when comparing the keys.
352 * @param key_hash_cb The function called when getting the values. 352 * @param[in] key_hash_cb The function called when getting the values.
353 * @param data_free_cb The function called on each value when the hash table is 353 * @param[in] data_free_cb The function called on each value when the hash table is
354 * freed, or when an item is deleted from it. @c NULL can be passed as a 354 * freed, or when an item is deleted from it. @c NULL can be passed as a
355 * callback. 355 * callback.
356 * @param buckets_power_size The size of the buckets. 356 * @param[in] buckets_power_size The size of the buckets.
357 * @return The new hash table, or @c NULL on failure. 357 * @return The new hash table, or @c NULL on failure.
358 * 358 *
359 * This function creates a new hash table using user-defined callbacks 359 * This function creates a new hash table using user-defined callbacks
@@ -382,8 +382,8 @@ EAPI Eina_Hash *eina_hash_new(Eina_Key_Length key_length_cb,
382/** 382/**
383 * @brief Sets the data cleanup callback for a hash. 383 * @brief Sets the data cleanup callback for a hash.
384 * 384 *
385 * @param hash The given hash table. 385 * @param[in,out] hash The given hash table.
386 * @param data_free_cb The function called on each value when the hash 386 * @param[in] data_free_cb The function called on each value when the hash
387 * table is freed, or when an item is deleted from it. @c NULL can be passed as 387 * table is freed, or when an item is deleted from it. @c NULL can be passed as
388 * callback to remove an existing callback. 388 * callback to remove an existing callback.
389 * 389 *
@@ -398,7 +398,7 @@ EAPI void eina_hash_free_cb_set(Eina_Hash *hash, Eina_Free_Cb data_free_cb) EINA
398/** 398/**
399 * @brief Creates a new hash table using the djb2 algorithm. 399 * @brief Creates a new hash table using the djb2 algorithm.
400 * 400 *
401 * @param data_free_cb The function called on each value when the hash table 401 * @param[in] data_free_cb The function called on each value when the hash table
402 * is freed, or when an item is deleted from it. @c NULL can be passed as 402 * is freed, or when an item is deleted from it. @c NULL can be passed as
403 * callback. 403 * callback.
404 * @return The new hash table, or @c NULL on failure. 404 * @return The new hash table, or @c NULL on failure.
@@ -413,7 +413,7 @@ EAPI Eina_Hash *eina_hash_string_djb2_new(Eina_Free_Cb data_free_cb);
413/** 413/**
414 * @brief Creates a new hash table for use with strings. 414 * @brief Creates a new hash table for use with strings.
415 * 415 *
416 * @param data_free_cb The function called on each value when the hash table 416 * @param[in] data_free_cb The function called on each value when the hash table
417 * is freed, or when an item is deleted from it. @c NULL can be passed as 417 * is freed, or when an item is deleted from it. @c NULL can be passed as
418 * callback. 418 * callback.
419 * @return The new hash table, or @c NULL on failure. 419 * @return The new hash table, or @c NULL on failure.
@@ -432,7 +432,7 @@ EAPI Eina_Hash *eina_hash_string_superfast_new(Eina_Free_Cb data_free_cb);
432/** 432/**
433 * @brief Creates a new hash table for use with strings with small bucket size. 433 * @brief Creates a new hash table for use with strings with small bucket size.
434 * 434 *
435 * @param data_free_cb The function called on each value when the hash table 435 * @param[in] data_free_cb The function called on each value when the hash table
436 * is freed, or when an item is deleted from it. @c NULL can be passed as 436 * is freed, or when an item is deleted from it. @c NULL can be passed as
437 * callback. 437 * callback.
438 * @return The new hash table, or @c NULL on failure. 438 * @return The new hash table, or @c NULL on failure.
@@ -449,7 +449,7 @@ EAPI Eina_Hash *eina_hash_string_small_new(Eina_Free_Cb data_free_cb);
449/** 449/**
450 * @brief Creates a new hash table for use with 32bit integers. 450 * @brief Creates a new hash table for use with 32bit integers.
451 * 451 *
452 * @param data_free_cb The function called on each value when the hash table 452 * @param[in] data_free_cb The function called on each value when the hash table
453 * is freed, or when an item is deleted from it. @c NULL can be passed as 453 * is freed, or when an item is deleted from it. @c NULL can be passed as
454 * callback. 454 * callback.
455 * @return The new hash table, or @c NULL on failure. 455 * @return The new hash table, or @c NULL on failure.
@@ -467,7 +467,7 @@ EAPI Eina_Hash *eina_hash_int32_new(Eina_Free_Cb data_free_cb);
467/** 467/**
468 * @brief Creates a new hash table for use with 64bit integers. 468 * @brief Creates a new hash table for use with 64bit integers.
469 * 469 *
470 * @param data_free_cb The function called on each value when the hash table 470 * @param[in] data_free_cb The function called on each value when the hash table
471 * is freed, or when an item is deleted from it. @c NULL can be passed as 471 * is freed, or when an item is deleted from it. @c NULL can be passed as
472 * callback. 472 * callback.
473 * @return The new hash table, or @c NULL on failure. 473 * @return The new hash table, or @c NULL on failure.
@@ -484,7 +484,7 @@ EAPI Eina_Hash *eina_hash_int64_new(Eina_Free_Cb data_free_cb);
484/** 484/**
485 * @brief Creates a new hash table for use with pointers. 485 * @brief Creates a new hash table for use with pointers.
486 * 486 *
487 * @param data_free_cb The function called on each value when the hash table 487 * @param[in] data_free_cb The function called on each value when the hash table
488 * is freed, or when an item is deleted from it. @c NULL can be passed as 488 * is freed, or when an item is deleted from it. @c NULL can be passed as
489 * callback. 489 * callback.
490 * @return The new hash table, or @c NULL on failure. 490 * @return The new hash table, or @c NULL on failure.
@@ -510,7 +510,7 @@ EAPI Eina_Hash *eina_hash_pointer_new(Eina_Free_Cb data_free_cb);
510/** 510/**
511 * @brief Creates a new hash table optimized for stringshared values. 511 * @brief Creates a new hash table optimized for stringshared values.
512 * 512 *
513 * @param data_free_cb The function called on each value when the hash table 513 * @param[in] data_free_cb The function called on each value when the hash table
514 * is freed, or when an item is deleted from it. @c NULL can be passed as 514 * is freed, or when an item is deleted from it. @c NULL can be passed as
515 * callback. 515 * callback.
516 * @return The new hash table, or @c NULL on failure. 516 * @return The new hash table, or @c NULL on failure.
@@ -535,9 +535,9 @@ EAPI Eina_Hash *eina_hash_stringshared_new(Eina_Free_Cb data_free_cb);
535/** 535/**
536 * @brief Adds an entry to the given hash table. 536 * @brief Adds an entry to the given hash table.
537 * 537 *
538 * @param hash The given hash table. Cannot be @c NULL. 538 * @param[in,out] hash The given hash table. Cannot be @c NULL.
539 * @param key A unique key. Cannot be @c NULL. 539 * @param[in] key A unique key. Cannot be @c NULL.
540 * @param data The data to associate with the string given by @p key. Cannot be @c 540 * @param[in] data The data to associate with the string given by @p key. Cannot be @c
541 * NULL. 541 * NULL.
542 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise. 542 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise.
543 * 543 *
@@ -562,9 +562,9 @@ EAPI Eina_Bool eina_hash_add(Eina_Hash *hash,
562/** 562/**
563 * @brief Adds an entry to the given hash table without duplicating the string. 563 * @brief Adds an entry to the given hash table without duplicating the string.
564 * 564 *
565 * @param hash The given hash table. Cannot be @c NULL. 565 * @param[in,out] hash The given hash table. Cannot be @c NULL.
566 * @param key A unique key. Cannot be @c NULL. 566 * @param[in] key A unique key. Cannot be @c NULL.
567 * @param data The data to associate with the string given by @p 567 * @param[in] data The data to associate with the string given by @p
568 * key. Cannot be @c NULL 568 * key. Cannot be @c NULL
569 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise. 569 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise.
570 * 570 *
@@ -592,9 +592,9 @@ EAPI Eina_Bool eina_hash_direct_add(Eina_Hash *hash,
592 * @brief Removes the entry identified by a key or a data from the given 592 * @brief Removes the entry identified by a key or a data from the given
593 * hash table. 593 * hash table.
594 * 594 *
595 * @param hash The given hash table. 595 * @param[in,out] hash The given hash table.
596 * @param key The key. 596 * @param[in] key The key.
597 * @param data The data pointer to remove if the key is @c NULL. 597 * @param[in] data The data pointer to remove if the key is @c NULL.
598 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise. 598 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise.
599 * 599 *
600 * This function removes the entry identified by @p key or @p data 600 * This function removes the entry identified by @p key or @p data
@@ -616,8 +616,8 @@ EAPI Eina_Bool eina_hash_del(Eina_Hash *hash,
616/** 616/**
617 * @brief Retrieves a specific entry in the given hash table. 617 * @brief Retrieves a specific entry in the given hash table.
618 * 618 *
619 * @param hash The given hash table. 619 * @param[in] hash The given hash table.
620 * @param key The key of the entry to find. 620 * @param[in] key The key of the entry to find.
621 * @return The data pointer for the stored entry on success, or @c NULL 621 * @return The data pointer for the stored entry on success, or @c NULL
622 * otherwise. 622 * otherwise.
623 * 623 *
@@ -630,9 +630,9 @@ EAPI void *eina_hash_find(const Eina_Hash *hash,
630/** 630/**
631 * @brief Modifies the entry pointer at the specified key and returns 631 * @brief Modifies the entry pointer at the specified key and returns
632 * the previous entry. 632 * the previous entry.
633 * @param hash The given hash table. 633 * @param[in,out] hash The given hash table.
634 * @param key The key of the entry to modify. 634 * @param[in] key The key of the entry to modify.
635 * @param data The new data. 635 * @param[in] data The new data.
636 * @return The data pointer for the previously stored entry on success, 636 * @return The data pointer for the previously stored entry on success,
637 * or @c NULL otherwise. 637 * or @c NULL otherwise.
638 * 638 *
@@ -647,9 +647,9 @@ EAPI void *eina_hash_modify(Eina_Hash *hash,
647 * @brief Modifies the entry pointer at the specified key and returns the 647 * @brief Modifies the entry pointer at the specified key and returns the
648 * previous entry or adds the entry if not found. 648 * previous entry or adds the entry if not found.
649 * 649 *
650 * @param hash The given hash table. 650 * @param[in,out] hash The given hash table.
651 * @param key The key of the entry to modify. 651 * @param[in] key The key of the entry to modify.
652 * @param data The data to replace the previous entry. 652 * @param[in] data The data to replace the previous entry.
653 * @return The data pointer for the previous stored entry, or @c NULL 653 * @return The data pointer for the previous stored entry, or @c NULL
654 * otherwise. 654 * otherwise.
655 * 655 *
@@ -665,9 +665,9 @@ EAPI void *eina_hash_set(Eina_Hash *hash,
665 * @brief Changes the key of an entry in a hash without triggering the 665 * @brief Changes the key of an entry in a hash without triggering the
666 * free callback. 666 * free callback.
667 * 667 *
668 * @param hash The given hash table. 668 * @param[in,out] hash The given hash table.
669 * @param old_key The current key associated with the data. 669 * @param[in] old_key The current key associated with the data.
670 * @param new_key The new key to associate data with. 670 * @param[in] new_key The new key to associate data with.
671 * @return #EINA_FALSE in any case but success, #EINA_TRUE on success. 671 * @return #EINA_FALSE in any case but success, #EINA_TRUE on success.
672 * 672 *
673 * This function moves data from one key to another, 673 * This function moves data from one key to another,
@@ -681,7 +681,7 @@ EAPI Eina_Bool eina_hash_move(Eina_Hash *hash,
681/** 681/**
682 * @brief Frees the given hash table's resources. 682 * @brief Frees the given hash table's resources.
683 * 683 *
684 * @param hash The hash table to be freed. 684 * @param[in] hash The hash table to be freed.
685 * 685 *
686 * This function frees memory allocated for the @p hash and to its 686 * This function frees memory allocated for the @p hash and to its
687 * internal buckets. 687 * internal buckets.
@@ -706,7 +706,7 @@ EAPI void eina_hash_free(Eina_Hash *hash) EINA_ARG_NONNULL(1);
706/** 706/**
707 * @brief Frees the given hash table buckets resources. 707 * @brief Frees the given hash table buckets resources.
708 * 708 *
709 * @param hash The hash table whose buckets have to be freed. 709 * @param[in] hash The hash table whose buckets have to be freed.
710 * 710 *
711 * This function frees memory allocated to internal buckets for @p hash. 711 * This function frees memory allocated to internal buckets for @p hash.
712 * 712 *
@@ -722,7 +722,7 @@ EAPI void eina_hash_free_buckets(Eina_Hash *hash) EINA_ARG_NONNULL(1);
722/** 722/**
723 * @brief Returns the number of entries in the given hash table. 723 * @brief Returns the number of entries in the given hash table.
724 * 724 *
725 * @param hash The given hash table. 725 * @param[in] hash The given hash table.
726 * @return The number of entries in the hash table, or @c 0 on error or 726 * @return The number of entries in the hash table, or @c 0 on error or
727 * if @p hash is @c NULL. 727 * if @p hash is @c NULL.
728 */ 728 */
@@ -731,11 +731,11 @@ EAPI int eina_hash_population(const Eina_Hash *hash) EINA_ARG_NONNULL(1);
731/** 731/**
732 * @brief Adds an entry to the given hash table by its key hash. 732 * @brief Adds an entry to the given hash table by its key hash.
733 * 733 *
734 * @param hash The given hash table. Cannot be @c NULL. 734 * @param[in,out] hash The given hash table. Cannot be @c NULL.
735 * @param key A unique key. Cannot be @c NULL. 735 * @param[in] key A unique key. Cannot be @c NULL.
736 * @param key_length The length of @p key (including terminating '\\0'). 736 * @param[in] key_length The length of @p key (including terminating '\\0').
737 * @param key_hash The hash of @p key. 737 * @param[in] key_hash The hash of @p key.
738 * @param data The data to associate with the string given by the key. Cannot be 738 * @param[in] data The data to associate with the string given by the key. Cannot be
739 * @c NULL. 739 * @c NULL.
740 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise. 740 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise.
741 * 741 *
@@ -758,11 +758,11 @@ EAPI Eina_Bool eina_hash_add_by_hash(Eina_Hash *hash,
758/** 758/**
759 * @brief Adds an entry to a hash table by its key hash without duplicating the string key. 759 * @brief Adds an entry to a hash table by its key hash without duplicating the string key.
760 * 760 *
761 * @param hash The given hash table. Cannot be @c NULL. 761 * @param[in,out] hash The given hash table. Cannot be @c NULL.
762 * @param key A unique key. Cannot be @c NULL. 762 * @param[in] key A unique key. Cannot be @c NULL.
763 * @param key_length The length of @p key (including terminating '\\0'). 763 * @param[in] key_length The length of @p key (including terminating '\\0').
764 * @param key_hash The hash of @p key. 764 * @param[in] key_hash The hash of @p key.
765 * @param data The data to associate with the string given by @p key. Cannot be @c 765 * @param[in] data The data to associate with the string given by @p key. Cannot be @c
766 * NULL. 766 * NULL.
767 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise. 767 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise.
768 * 768 *
@@ -790,10 +790,10 @@ EAPI Eina_Bool eina_hash_direct_add_by_hash(Eina_Hash *hash,
790 * @brief Removes the entry identified by a key and a key hash from the given 790 * @brief Removes the entry identified by a key and a key hash from the given
791 * hash table. 791 * hash table.
792 * 792 *
793 * @param hash The given hash table. Cannot be @c NULL. 793 * @param[in,out] hash The given hash table. Cannot be @c NULL.
794 * @param key The key. Cannot be @c NULL. 794 * @param[in] key The key. Cannot be @c NULL.
795 * @param key_length The length of the key (including terminating '\\0'). 795 * @param[in] key_length The length of the key (including terminating '\\0').
796 * @param key_hash The hash that always matches the key. 796 * @param[in] key_hash The hash that always matches the key.
797 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise. 797 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise.
798 * 798 *
799 * This function removes the entry identified by @p key and 799 * This function removes the entry identified by @p key and
@@ -816,8 +816,8 @@ EAPI Eina_Bool eina_hash_del_by_key_hash(Eina_Hash *hash,
816 * This version will calculate key length and hash by using functions 816 * This version will calculate key length and hash by using functions
817 * provided to the hash creation function. 817 * provided to the hash creation function.
818 * 818 *
819 * @param hash The given hash table. Cannot be @c NULL. 819 * @param[in,out] hash The given hash table. Cannot be @c NULL.
820 * @param key The key. Cannot be @c NULL. 820 * @param[in] key The key. Cannot be @c NULL.
821 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise. 821 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise.
822 * 822 *
823 * This function removes the entry identified by @p key from @p 823 * This function removes the entry identified by @p key from @p
@@ -836,8 +836,8 @@ EAPI Eina_Bool eina_hash_del_by_key(Eina_Hash *hash,
836/** 836/**
837 * @brief Removes an entry from a hash table identified by its data value. 837 * @brief Removes an entry from a hash table identified by its data value.
838 * 838 *
839 * @param hash The given hash table. Cannot be @c NULL. 839 * @param[in,out] hash The given hash table. Cannot be @c NULL.
840 * @param data The data value to search and remove. Cannot be @c NULL. 840 * @param[in] data The data value to search and remove. Cannot be @c NULL.
841 * @return #EINA_FALSE if an error occurred or if @p hash or @p data are 841 * @return #EINA_FALSE if an error occurred or if @p hash or @p data are
842 * @c NULL, #EINA_TRUE otherwise. 842 * @c NULL, #EINA_TRUE otherwise.
843 * thing goes fine. 843 * thing goes fine.
@@ -862,11 +862,11 @@ EAPI Eina_Bool eina_hash_del_by_data(Eina_Hash *hash,
862 * If @p key is @c NULL, then @p data is used to find a match to 862 * If @p key is @c NULL, then @p data is used to find a match to
863 * remove. 863 * remove.
864 * 864 *
865 * @param hash The given hash table. Cannot be @c NULL. 865 * @param[in,out] hash The given hash table. Cannot be @c NULL.
866 * @param key The key. 866 * @param[in] key The key.
867 * @param key_length The length of the key. 867 * @param[in] key_length The length of the key.
868 * @param key_hash The hash that always match the key. 868 * @param[in] key_hash The hash that always match the key.
869 * @param data The data pointer to remove if the key is @c NULL. 869 * @param[in] data The data pointer to remove if the key is @c NULL.
870 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise. 870 * @return #EINA_FALSE if an error occurred, #EINA_TRUE otherwise.
871 * 871 *
872 * This function removes the entry identified by @p key and @p key_hash, 872 * This function removes the entry identified by @p key and @p key_hash,
@@ -891,10 +891,10 @@ EAPI Eina_Bool eina_hash_del_by_hash(Eina_Hash *hash,
891/** 891/**
892 * @brief Retrieves a specific entry from the given hash table. 892 * @brief Retrieves a specific entry from the given hash table.
893 * 893 *
894 * @param hash The given hash table. Cannot be @c NULL. 894 * @param[in] hash The given hash table. Cannot be @c NULL.
895 * @param key The key of the entry to find. 895 * @param[in] key The key of the entry to find.
896 * @param key_length The length of the key. 896 * @param[in] key_length The length of the key.
897 * @param key_hash The hash that always matches the key 897 * @param[in] key_hash The hash that always matches the key
898 * @return The data pointer for the stored entry on success, or @c NULL 898 * @return The data pointer for the stored entry on success, or @c NULL
899 * if @p hash is @c NULL or if the data pointer could not be retrieved. 899 * if @p hash is @c NULL or if the data pointer could not be retrieved.
900 * 900 *
@@ -912,13 +912,13 @@ EAPI void *eina_hash_find_by_hash(const Eina_Hash *hash,
912 * @brief Modifies the entry pointer at the specified key and returns 912 * @brief Modifies the entry pointer at the specified key and returns
913 * the previous entry. 913 * the previous entry.
914 * 914 *
915 * @param hash The given hash table. 915 * @param[in,out] hash The given hash table.
916 * @param key The key of the entry to modify. 916 * @param[in] key The key of the entry to modify.
917 * @param key_length Should be the length of @p key (don't forget to count 917 * @param[in] key_length Should be the length of @p key (don't forget to count
918 * '\\0' for string). 918 * '\\0' for string).
919 * @param key_hash The hash that always matches the key. Ignored if @p 919 * @param[in] key_hash The hash that always matches the key. Ignored if @p
920 * key is @c NULL. 920 * key is @c NULL.
921 * @param data The data to replace the current entry, if it exists. 921 * @param[in] data The data to replace the current entry, if it exists.
922 * @return The data pointer for the previously stored entry, or @c NULL 922 * @return The data pointer for the previously stored entry, or @c NULL
923 * if not found. If an existing entry is not found, nothing is added to 923 * if not found. If an existing entry is not found, nothing is added to
924 * the hash. 924 * the hash.
@@ -932,7 +932,7 @@ EAPI void *eina_hash_modify_by_hash(Eina_Hash *hash,
932/** 932/**
933 * @brief Returns a new iterator associated with hash keys. 933 * @brief Returns a new iterator associated with hash keys.
934 * 934 *
935 * @param hash The hash. 935 * @param[in] hash The hash.
936 * @return A new iterator, or @c NULL if memory could not be allocated. 936 * @return A new iterator, or @c NULL if memory could not be allocated.
937 * 937 *
938 * This function returns a newly allocated iterator associated with @p 938 * This function returns a newly allocated iterator associated with @p
@@ -948,7 +948,7 @@ EAPI Eina_Iterator *eina_hash_iterator_key_new(const Eina_Hash *hash) EINA_MALLO
948/** 948/**
949 * @brief Returns a new iterator associated with a hash. 949 * @brief Returns a new iterator associated with a hash.
950 * 950 *
951 * @param hash The hash. 951 * @param[in] hash The hash.
952 * @return A new iterator, or @c NULL if memory could not be allocated. 952 * @return A new iterator, or @c NULL if memory could not be allocated.
953 * 953 *
954 * This function returns a newly allocated iterator associated with 954 * This function returns a newly allocated iterator associated with
@@ -964,7 +964,7 @@ EAPI Eina_Iterator *eina_hash_iterator_data_new(const Eina_Hash *hash) EINA_MALL
964/** 964/**
965 * @brief Returned a new iterator associated with hash keys and data. 965 * @brief Returned a new iterator associated with hash keys and data.
966 * 966 *
967 * @param hash The hash. 967 * @param[in] hash The hash.
968 * @return A new iterator, or @c NULL if memory could not be allocated. 968 * @return A new iterator, or @c NULL if memory could not be allocated.
969 * 969 *
970 * This function returns a newly allocated iterator associated with @p 970 * This function returns a newly allocated iterator associated with @p
@@ -983,9 +983,9 @@ EAPI Eina_Iterator *eina_hash_iterator_tuple_new(const Eina_Hash *hash) EINA_MAL
983/** 983/**
984 * @brief Calls a function on every member stored in the hash table. 984 * @brief Calls a function on every member stored in the hash table.
985 * 985 *
986 * @param hash The hash table whose members will be walked. 986 * @param[in] hash The hash table whose members will be walked.
987 * @param func The function to call on each parameter. 987 * @param[in] func The function to call on each parameter.
988 * @param fdata The data pointer to pass to the function being called. 988 * @param[in] fdata The data pointer to pass to the function being called.
989 * 989 *
990 * This function iterates over the hash table @p hash, calling the 990 * This function iterates over the hash table @p hash, calling the
991 * function @p func on each member. If @p func modifies the contents 991 * function @p func on each member. If @p func modifies the contents
@@ -1026,33 +1026,41 @@ EAPI void eina_hash_foreach(const Eina_Hash *hash,
1026 * This function is identical to the sequence of calling 1026 * This function is identical to the sequence of calling
1027 * eina_hash_find(), eina_list_append(), eina_hash_set(), 1027 * eina_hash_find(), eina_list_append(), eina_hash_set(),
1028 * but with one fewer required hash lookup. 1028 * but with one fewer required hash lookup.
1029 * @param hash The hash table. 1029 *
1030 * @param key The key associated with the data. 1030 * @param[in,out] hash The hash table.
1031 * @param data The data to append to the list. 1031 * @param[in] key The key associated with the data.
1032 * @param[in] data The data to append to the list.
1033 *
1032 * @since 1.10 1034 * @since 1.10
1033 */ 1035 */
1034EAPI void eina_hash_list_append(Eina_Hash *hash, const void *key, const void *data) EINA_ARG_NONNULL(1, 2, 3); 1036EAPI void eina_hash_list_append(Eina_Hash *hash, const void *key, const void *data) EINA_ARG_NONNULL(1, 2, 3);
1037
1035/** 1038/**
1036 * @brief Prepends data to an #Eina_List inside a hash. 1039 * @brief Prepends data to an #Eina_List inside a hash.
1037 * 1040 *
1038 * This function is identical to the sequence of calling 1041 * This function is identical to the sequence of calling
1039 * eina_hash_find(), eina_list_prepend(), eina_hash_set(), 1042 * eina_hash_find(), eina_list_prepend(), eina_hash_set(),
1040 * but with one fewer required hash lookup. 1043 * but with one fewer required hash lookup.
1041 * @param hash The hash table. 1044 *
1042 * @param key The key associated with the data. 1045 * @param[in,out] hash The hash table.
1043 * @param data The data to prepend to the list. 1046 * @param[in] key The key associated with the data.
1047 * @param[in] data The data to prepend to the list.
1048 *
1044 * @since 1.10 1049 * @since 1.10
1045 */ 1050 */
1046EAPI void eina_hash_list_prepend(Eina_Hash *hash, const void *key, const void *data) EINA_ARG_NONNULL(1, 2, 3); 1051EAPI void eina_hash_list_prepend(Eina_Hash *hash, const void *key, const void *data) EINA_ARG_NONNULL(1, 2, 3);
1052
1047/** 1053/**
1048 * @brief Removes data from an #Eina_List inside a hash. 1054 * @brief Removes data from an #Eina_List inside a hash.
1049 * 1055 *
1050 * This function is identical to the sequence of calling 1056 * This function is identical to the sequence of calling
1051 * eina_hash_find(), eina_list_remove(), eina_hash_set(), 1057 * eina_hash_find(), eina_list_remove(), eina_hash_set(),
1052 * but with one fewer required hash lookup. 1058 * but with one fewer required hash lookup.
1053 * @param hash The hash table. 1059 *
1054 * @param key The key associated with the data. 1060 * @param[in,out] hash The hash table.
1055 * @param data The data to remove from the list. 1061 * @param[in] key The key associated with the data.
1062 * @param[in] data The data to remove from the list.
1063 *
1056 * @since 1.10 1064 * @since 1.10
1057 */ 1065 */
1058EAPI void eina_hash_list_remove(Eina_Hash *hash, const void *key, const void *data) EINA_ARG_NONNULL(1, 2, 3); 1066EAPI void eina_hash_list_remove(Eina_Hash *hash, const void *key, const void *data) EINA_ARG_NONNULL(1, 2, 3);
@@ -1061,8 +1069,8 @@ EAPI void eina_hash_list_remove(Eina_Hash *hash, const void *key, const void *da
1061 * @brief 1069 * @brief
1062 * Paul Hsieh (http://www.azillionmonkeys.com/qed/hash.html) hash function used by WebCore (http://webkit.org/blog/8/hashtables-part-2/) 1070 * Paul Hsieh (http://www.azillionmonkeys.com/qed/hash.html) hash function used by WebCore (http://webkit.org/blog/8/hashtables-part-2/)
1063 * 1071 *
1064 * @param key The key to hash. 1072 * @param[in] key The key to hash.
1065 * @param len The length of the key. 1073 * @param[in] len The length of the key.
1066 * @return The hash value. 1074 * @return The hash value.
1067 */ 1075 */
1068EAPI int eina_hash_superfast(const char *key, 1076EAPI int eina_hash_superfast(const char *key,
@@ -1072,8 +1080,8 @@ EAPI int eina_hash_superfast(const char *key,
1072 * @brief 1080 * @brief
1073 * Hash function first reported by Dan Bernstein many years ago in comp.lang.c 1081 * Hash function first reported by Dan Bernstein many years ago in comp.lang.c
1074 * 1082 *
1075 * @param key The key to hash. 1083 * @param[in] key The key to hash.
1076 * @param len The length of the key. 1084 * @param[in] len The length of the key.
1077 * @return The hash value. 1085 * @return The hash value.
1078 */ 1086 */
1079static inline int eina_hash_djb2(const char *key, 1087static inline int eina_hash_djb2(const char *key,
@@ -1083,8 +1091,8 @@ static inline int eina_hash_djb2(const char *key,
1083 * @brief 1091 * @brief
1084 * Hash function first reported by Dan Bernstein many years ago in comp.lang.c 1092 * Hash function first reported by Dan Bernstein many years ago in comp.lang.c
1085 * 1093 *
1086 * @param key The key to hash. 1094 * @param[in] key The key to hash.
1087 * @param plen The length of the key. 1095 * @param[in] plen The length of the key.
1088 * @return The hash value. 1096 * @return The hash value.
1089 */ 1097 */
1090static inline int eina_hash_djb2_len(const char *key, 1098static inline int eina_hash_djb2_len(const char *key,
@@ -1094,8 +1102,8 @@ static inline int eina_hash_djb2_len(const char *key,
1094 * @brief 1102 * @brief
1095 * Hash function from http://web.archive.org/web/20071223173210/http://www.concentric.net/~Ttwang/tech/inthash.htm 1103 * Hash function from http://web.archive.org/web/20071223173210/http://www.concentric.net/~Ttwang/tech/inthash.htm
1096 * 1104 *
1097 * @param pkey The key to hash. 1105 * @param[in] pkey The key to hash.
1098 * @param len The length of the key. 1106 * @param[in] len The length of the key.
1099 * @return The hash value. 1107 * @return The hash value.
1100 */ 1108 */
1101static inline int eina_hash_int32(const unsigned int *pkey, 1109static inline int eina_hash_int32(const unsigned int *pkey,
@@ -1105,8 +1113,8 @@ static inline int eina_hash_int32(const unsigned int *pkey,
1105 * @brief 1113 * @brief
1106 * Hash function from http://web.archive.org/web/20071223173210/http://www.concentric.net/~Ttwang/tech/inthash.htm 1114 * Hash function from http://web.archive.org/web/20071223173210/http://www.concentric.net/~Ttwang/tech/inthash.htm
1107 * 1115 *
1108 * @param pkey The key to hash. 1116 * @param[in] pkey The key to hash.
1109 * @param len The length of the key. 1117 * @param[in] len The length of the key.
1110 * @return The hash value. 1118 * @return The hash value.
1111 */ 1119 */
1112static inline int eina_hash_int64(const unsigned long long int *pkey, 1120static inline int eina_hash_int64(const unsigned long long int *pkey,
@@ -1116,8 +1124,8 @@ static inline int eina_hash_int64(const unsigned long long int *pkey,
1116 * @brief 1124 * @brief
1117 * Hash function from http://sites.google.com/site/murmurhash/ 1125 * Hash function from http://sites.google.com/site/murmurhash/
1118 * 1126 *
1119 * @param key The key to hash. 1127 * @param[in] key The key to hash.
1120 * @param len The length of the key. 1128 * @param[in] len The length of the key.
1121 * @return The hash value. 1129 * @return The hash value.
1122 */ 1130 */
1123static inline int eina_hash_murmur3(const char *key, 1131static inline int eina_hash_murmur3(const char *key,
@@ -1127,8 +1135,8 @@ static inline int eina_hash_murmur3(const char *key,
1127 * @brief 1135 * @brief
1128 * Hash function using crc-32 algorithm and and 0xEDB88320 polynomial 1136 * Hash function using crc-32 algorithm and and 0xEDB88320 polynomial
1129 * 1137 *
1130 * @param key The key to hash. 1138 * @param[in] key The key to hash.
1131 * @param len The length of the key. 1139 * @param[in] len The length of the key.
1132 * @return The hash value. 1140 * @return The hash value.
1133 */ 1141 */
1134static inline int eina_hash_crc(const char *key, 1142static inline int eina_hash_crc(const char *key,
diff --git a/src/lib/eina/eina_lalloc.h b/src/lib/eina/eina_lalloc.h
index 114d0a9eae..bb14a7163c 100644
--- a/src/lib/eina/eina_lalloc.h
+++ b/src/lib/eina/eina_lalloc.h
@@ -39,9 +39,10 @@
39 * 39 *
40 */ 40 */
41typedef Eina_Bool (*Eina_Lalloc_Alloc)(void *user_data, int num); 41typedef Eina_Bool (*Eina_Lalloc_Alloc)(void *user_data, int num);
42
42/** 43/**
43 * @def EINA_LALLOC_ALLOC 44 * @def EINA_LALLOC_ALLOC
44 * @param function The function to allocate. 45 * @param[in] function The function to allocate.
45 */ 46 */
46#define EINA_LALLOC_ALLOC(function) ((Eina_Lalloc_Alloc)function) 47#define EINA_LALLOC_ALLOC(function) ((Eina_Lalloc_Alloc)function)
47 48
diff --git a/src/lib/eina/eina_matrix.h b/src/lib/eina/eina_matrix.h
index ade4249b04..ed12f6f0db 100644
--- a/src/lib/eina/eina_matrix.h
+++ b/src/lib/eina/eina_matrix.h
@@ -421,7 +421,7 @@ EAPI void eina_matrix3_identity(Eina_Matrix3 *t);
421/** 421/**
422 * @brief Calculates the determinant of the given matrix. 422 * @brief Calculates the determinant of the given matrix.
423 * 423 *
424 * @param m[in] The matrix. 424 * @param[in] m The matrix.
425 * @return The determinant. 425 * @return The determinant.
426 * 426 *
427 * This function returns the determinant of the matrix @p m. No check 427 * This function returns the determinant of the matrix @p m. No check
diff --git a/src/lib/eina/eina_promise.h b/src/lib/eina/eina_promise.h
index 769e02233e..1a142208b8 100644
--- a/src/lib/eina/eina_promise.h
+++ b/src/lib/eina/eina_promise.h
@@ -149,7 +149,7 @@ struct _Eina_Future_Scheduler {
149 * 149 *
150 * @note Must not be @c NULL. 150 * @note Must not be @c NULL.
151 * 151 *
152 * @param entry The scheduled event to cancel 152 * @param[in,out] entry The scheduled event to cancel
153 */ 153 */
154 void (*recall)(Eina_Future_Schedule_Entry *entry); 154 void (*recall)(Eina_Future_Schedule_Entry *entry);
155}; 155};
@@ -1196,7 +1196,7 @@ EAPI Eina_Future_Desc eina_future_cb_console_from_desc(const Eina_Future_Cb_Cons
1196 * next future in the chain. 1196 * next future in the chain.
1197 * 1197 *
1198 * @param[in] err The error to be ignored. 1198 * @param[in] err The error to be ignored.
1199 * @param A future descriptor to be used with eina_future_then() or eina_future_chain() 1199 * @return A future descriptor to be used with eina_future_then() or eina_future_chain()
1200 */ 1200 */
1201EAPI Eina_Future_Desc eina_future_cb_ignore_error(Eina_Error err); 1201EAPI Eina_Future_Desc eina_future_cb_ignore_error(Eina_Error err);
1202 1202
diff --git a/src/lib/eina/eina_slstr.h b/src/lib/eina/eina_slstr.h
index 881276f615..ce93e23b78 100644
--- a/src/lib/eina/eina_slstr.h
+++ b/src/lib/eina/eina_slstr.h
@@ -36,7 +36,7 @@ typedef const char Eina_Slstr;
36/** 36/**
37 * @brief Create a new short lived string by duplicating another string. 37 * @brief Create a new short lived string by duplicating another string.
38 * 38 *
39 * @param string An existing string, it will be copied. 39 * @param[in] string An existing string, it will be copied.
40 * @return A new Eina_Slstr or NULL if out of memory. 40 * @return A new Eina_Slstr or NULL if out of memory.
41 * 41 *
42 * Usage example: 42 * Usage example:
@@ -54,7 +54,7 @@ eina_slstr_copy_new(const char *string);
54/** 54/**
55 * @brief Create a new short lived string by taking ownership of a string. 55 * @brief Create a new short lived string by taking ownership of a string.
56 * 56 *
57 * @param string An existing string. It will not be duplicated. 57 * @param[in] string An existing string. It will not be duplicated.
58 * @return A new Eina_Slstr or NULL if out of memory. 58 * @return A new Eina_Slstr or NULL if out of memory.
59 * 59 *
60 * Usage example: 60 * Usage example:
@@ -71,7 +71,7 @@ eina_slstr_steal_new(char *string);
71/** 71/**
72 * @brief Create a new short lived string by taking ownership of a stringshare. 72 * @brief Create a new short lived string by taking ownership of a stringshare.
73 * 73 *
74 * @param string An existing stringshare, one reference belongs to this slstr. 74 * @param[in] string An existing stringshare, one reference belongs to this slstr.
75 * @return A new Eina_Slstr or NULL if out of memory. 75 * @return A new Eina_Slstr or NULL if out of memory.
76 * 76 *
77 * Usage example: 77 * Usage example:
@@ -88,7 +88,7 @@ eina_slstr_stringshare_new(Eina_Stringshare *string);
88/** 88/**
89 * @brief Create a new short lived string by taking ownership of a tmpstr. 89 * @brief Create a new short lived string by taking ownership of a tmpstr.
90 * 90 *
91 * @param string An existing tmpstr, it will be freed later. 91 * @param[in] string An existing tmpstr, it will be freed later.
92 * @return A new Eina_Slstr or NULL if out of memory. 92 * @return A new Eina_Slstr or NULL if out of memory.
93 * 93 *
94 * Usage example: 94 * Usage example:
@@ -105,7 +105,7 @@ eina_slstr_tmpstr_new(Eina_Tmpstr *string);
105/** 105/**
106 * @brief Create a new short lived string by taking ownership of a strbuf. 106 * @brief Create a new short lived string by taking ownership of a strbuf.
107 * 107 *
108 * @param string An existing strbuf, that will be released (i.e.. steal + free). 108 * @param[in] string An existing strbuf, that will be released (i.e.. steal + free).
109 * @return A new Eina_Slstr or NULL if out of memory. 109 * @return A new Eina_Slstr or NULL if out of memory.
110 * 110 *
111 * Usage example: 111 * Usage example:
@@ -126,8 +126,8 @@ eina_slstr_strbuf_new(Eina_Strbuf *string);
126/** 126/**
127 * @brief Create a new short lived string using sprintf. 127 * @brief Create a new short lived string using sprintf.
128 * 128 *
129 * @param fmt Format string for printf 129 * @param[in] fmt Format string for printf
130 * @param args List of format parameters for printf 130 * @param[in] args List of format parameters for printf
131 * @return A new Eina_Slstr or NULL if out of memory. 131 * @return A new Eina_Slstr or NULL if out of memory.
132 * 132 *
133 * @since 1.19 133 * @since 1.19
@@ -138,8 +138,8 @@ eina_slstr_vasprintf_new(const char *fmt, va_list args);
138/** 138/**
139 * @brief Create a new short lived string using sprintf. 139 * @brief Create a new short lived string using sprintf.
140 * 140 *
141 * @param fmt Format string for printf 141 * @param[in] fmt Format string for printf
142 * @param args List of format parameters for printf 142 * @param[in] args List of format parameters for printf
143 * @return A new Eina_Slstr or NULL if out of memory. 143 * @return A new Eina_Slstr or NULL if out of memory.
144 * 144 *
145 * Usage example: 145 * Usage example:
diff --git a/src/lib/eina/eina_str.h b/src/lib/eina/eina_str.h
index 742c02be55..e8bf685067 100644
--- a/src/lib/eina/eina_str.h
+++ b/src/lib/eina/eina_str.h
@@ -85,9 +85,9 @@
85/** 85/**
86 * @brief Copies a c-string to another. 86 * @brief Copies a c-string to another.
87 * 87 *
88 * @param dst The destination string. 88 * @param[out] dst The destination string.
89 * @param src The source string. 89 * @param[in] src The source string.
90 * @param siz The size of the destination string. 90 * @param[in] siz The size of the destination string.
91 * @return The length of the source string. 91 * @return The length of the source string.
92 * 92 *
93 * This function copies up to @p siz - 1 characters from the 93 * This function copies up to @p siz - 1 characters from the
@@ -105,9 +105,9 @@ EAPI size_t eina_strlcpy(char *dst, const char *src, size_t siz) EINA_A
105/** 105/**
106 * @brief Appends a c-string. 106 * @brief Appends a c-string.
107 * 107 *
108 * @param dst The destination string. 108 * @param[out] dst The destination string.
109 * @param src The source string. 109 * @param[in] src The source string.
110 * @param siz The size of the destination string. 110 * @param[in] siz The size of the destination string.
111 * @return The length of the source string plus MIN(siz, strlen(initial dst)) 111 * @return The length of the source string plus MIN(siz, strlen(initial dst))
112 * 112 *
113 * This function appends @p src to @p dst of size @p siz (unlike 113 * This function appends @p src to @p dst of size @p siz (unlike
@@ -123,8 +123,8 @@ EAPI size_t eina_strlcat(char *dst, const char *src, size_t siz) EINA_A
123/** 123/**
124 * @brief Checks if the given string has the given prefix. 124 * @brief Checks if the given string has the given prefix.
125 * 125 *
126 * @param str The string to work with. 126 * @param[in] str The string to work with.
127 * @param prefix The prefix to check for. 127 * @param[in] prefix The prefix to check for.
128 * @return #EINA_TRUE if the string has the given prefix, #EINA_FALSE otherwise. 128 * @return #EINA_TRUE if the string has the given prefix, #EINA_FALSE otherwise.
129 * 129 *
130 * This function returns #EINA_TRUE if @p str has the prefix 130 * This function returns #EINA_TRUE if @p str has the prefix
@@ -136,8 +136,8 @@ EAPI Eina_Bool eina_str_has_prefix(const char *str, const char *prefix) EI
136/** 136/**
137 * @brief Checks if the given string has the given suffix. 137 * @brief Checks if the given string has the given suffix.
138 * 138 *
139 * @param str The string to work with. 139 * @param[in] str The string to work with.
140 * @param suffix The suffix to check for. 140 * @param[in] suffix The suffix to check for.
141 * @return #EINA_TRUE if the string has the given suffix, #EINA_FALSE otherwise. 141 * @return #EINA_TRUE if the string has the given suffix, #EINA_FALSE otherwise.
142 * 142 *
143 * This function returns #EINA_TRUE if @p str has the suffix 143 * This function returns #EINA_TRUE if @p str has the suffix
@@ -149,8 +149,8 @@ EAPI Eina_Bool eina_str_has_suffix(const char *str, const char *suffix) EI
149/** 149/**
150 * @brief Checks if the given string has the given extension. 150 * @brief Checks if the given string has the given extension.
151 * 151 *
152 * @param str The string to work with. 152 * @param[in] str The string to work with.
153 * @param ext The extension to check for. 153 * @param[in] ext The extension to check for.
154 * @return #EINA_TRUE if the string has the given extension, #EINA_FALSE otherwise. 154 * @return #EINA_TRUE if the string has the given extension, #EINA_FALSE otherwise.
155 * 155 *
156 * This function does the same as eina_str_has_suffix(), except it's case 156 * This function does the same as eina_str_has_suffix(), except it's case
@@ -161,9 +161,9 @@ EAPI Eina_Bool eina_str_has_extension(const char *str, const char *ext) EI
161/** 161/**
162 * @brief Splits a string using a delimiter. 162 * @brief Splits a string using a delimiter.
163 * 163 *
164 * @param string The string to split. 164 * @param[in] string The string to split.
165 * @param delimiter The string which specifies the places at which to split the string. 165 * @param[in] delimiter The string which specifies the places at which to split the string.
166 * @param max_tokens The maximum number of strings to split string into, or a number less 166 * @param[in] max_tokens The maximum number of strings to split string into, or a number less
167 * than 1 to split as many times as possible. This parameter 167 * than 1 to split as many times as possible. This parameter
168 * IGNORES the added @c NULL terminator. 168 * IGNORES the added @c NULL terminator.
169 * @return A newly-allocated NULL-terminated array of strings or @c NULL if it 169 * @return A newly-allocated NULL-terminated array of strings or @c NULL if it
@@ -187,12 +187,12 @@ EAPI char **eina_str_split(const char *string, const char *delimiter, i
187/** 187/**
188 * @brief Splits a string using a delimiter and returns number of elements. 188 * @brief Splits a string using a delimiter and returns number of elements.
189 * 189 *
190 * @param string The string to split. 190 * @param[in] string The string to split.
191 * @param delimiter The string which specifies the places at which to split the string. 191 * @param[in] delimiter The string which specifies the places at which to split the string.
192 * @param max_tokens The maximum number of strings to split string into, or a number less 192 * @param[in] max_tokens The maximum number of strings to split string into, or a number less
193 * than 1 to split as many times as possible. This parameter 193 * than 1 to split as many times as possible. This parameter
194 * IGNORES the added @c NULL terminator. 194 * IGNORES the added @c NULL terminator.
195 * @param elements Where to return the number of elements in returned 195 * @param[out] elements Where to return the number of elements in returned
196 * array. This array is guaranteed to be no greater than @p max_tokens, and 196 * array. This array is guaranteed to be no greater than @p max_tokens, and
197 * it will NOT count the @c NULL terminator element. 197 * it will NOT count the @c NULL terminator element.
198 * @return A newly-allocated NULL-terminated array of strings or @c NULL if it 198 * @return A newly-allocated NULL-terminated array of strings or @c NULL if it
@@ -221,13 +221,13 @@ EAPI char **eina_str_split_full(const char *string, const char *delimit
221/** 221/**
222 * @brief Joins two strings of known length. 222 * @brief Joins two strings of known length.
223 * 223 *
224 * @param dst The buffer to store the result. 224 * @param[out] dst The buffer to store the result.
225 * @param size Size (in byte) of the buffer. 225 * @param[in] size Size (in byte) of the buffer.
226 * @param sep The separator character to use. 226 * @param[in] sep The separator character to use.
227 * @param a First string to use, before @p sep. 227 * @param[in] a First string to use, before @p sep.
228 * @param a_len Length of @p a. 228 * @param[in] a_len Length of @p a.
229 * @param b Second string to use, after @p sep. 229 * @param[in] b Second string to use, after @p sep.
230 * @param b_len Length of @p b. 230 * @param[in] b_len Length of @p b.
231 * @return The number of characters printed. 231 * @return The number of characters printed.
232 * 232 *
233 * This function joins the strings @p a and @p b (in that order) and 233 * This function joins the strings @p a and @p b (in that order) and
@@ -250,9 +250,9 @@ EAPI size_t eina_str_join_len(char *dst, size_t size, char sep, const c
250/** 250/**
251 * @brief Uses Iconv to convert a text string from one encoding to another. 251 * @brief Uses Iconv to convert a text string from one encoding to another.
252 * 252 *
253 * @param enc_from Encoding to convert from. 253 * @param[in] enc_from Encoding to convert from.
254 * @param enc_to Encoding to convert to. 254 * @param[in] enc_to Encoding to convert to.
255 * @param text The text to convert. 255 * @param[in] text The text to convert.
256 * @return The converted text. 256 * @return The converted text.
257 * 257 *
258 * This function converts @p text, encoded in @p enc_from. On success, 258 * This function converts @p text, encoded in @p enc_from. On success,
@@ -269,11 +269,11 @@ EAPI char *eina_str_convert(const char *enc_from, const char *enc_to,
269/** 269/**
270 * @brief Uses Iconv to convert a text string from one encoding to another. 270 * @brief Uses Iconv to convert a text string from one encoding to another.
271 * 271 *
272 * @param enc_from Encoding to convert from. 272 * @param[in] enc_from Encoding to convert from.
273 * @param enc_to Encoding to convert to. 273 * @param[in] enc_to Encoding to convert to.
274 * @param text The text to convert. 274 * @param[in] text The text to convert.
275 * @param len The size in bytes of the text to convert. 275 * @param[in] len The size in bytes of the text to convert.
276 * @param retlen The size in bytes of the converted text. 276 * @param[in] retlen The size in bytes of the converted text.
277 * @return The converted text. 277 * @return The converted text.
278 * 278 *
279 * This function converts @p text, encoded in @p enc_from. On success, 279 * This function converts @p text, encoded in @p enc_from. On success,
@@ -290,7 +290,7 @@ EAPI char *eina_str_convert_len(const char *enc_from, const char *enc_
290/** 290/**
291 * @brief Escapes slashes, spaces and apostrophes in strings. 291 * @brief Escapes slashes, spaces and apostrophes in strings.
292 * 292 *
293 * @param str The string to escape. 293 * @param[in] str The string to escape.
294 * @return The escaped string. 294 * @return The escaped string.
295 * 295 *
296 * Escaping is done by adding a slash "\" before any occurrence of slashes "\" 296 * Escaping is done by adding a slash "\" before any occurrence of slashes "\"
@@ -305,7 +305,7 @@ EAPI char *eina_str_escape(const char *str) EINA_WARN_UNUSED_RESULT EI
305/** 305/**
306 * @brief Lowercases all the characters in range [A-Z] in the given string. 306 * @brief Lowercases all the characters in range [A-Z] in the given string.
307 * 307 *
308 * @param str The string to lowercase. 308 * @param[in,out] str The string to lowercase.
309 * 309 *
310 * This function modifies the original string, changing all characters 310 * This function modifies the original string, changing all characters
311 * in [A-Z] to lowercase. If @p str is @c NULL or is an empty string, 311 * in [A-Z] to lowercase. If @p str is @c NULL or is an empty string,
@@ -316,7 +316,7 @@ EAPI void eina_str_tolower(char **str);
316/** 316/**
317 * @brief Uppercases all the characters in range [a-z] in the given string. 317 * @brief Uppercases all the characters in range [a-z] in the given string.
318 * 318 *
319 * @param str The string to uppercase. 319 * @param[in,out] str The string to uppercase.
320 * 320 *
321 * This function modifies the original string, changing all characters 321 * This function modifies the original string, changing all characters
322 * in [a-z] to uppercase. If @p str is @c NULL or is an empty string, 322 * in [a-z] to uppercase. If @p str is @c NULL or is an empty string,
@@ -330,10 +330,10 @@ static inline size_t eina_str_join(char *dst, size_t size, char sep, const char
330 * @def eina_str_join_static(dst, sep, a, b) 330 * @def eina_str_join_static(dst, sep, a, b)
331 * @brief Joins two static strings and store the result in a static buffer. 331 * @brief Joins two static strings and store the result in a static buffer.
332 * 332 *
333 * @param dst The buffer to store the result. 333 * @param[out] dst The buffer to store the result.
334 * @param sep The separator character to use. 334 * @param[in] sep The separator character to use.
335 * @param a First string to use, before @p sep. 335 * @param[in] a First string to use, before @p sep.
336 * @param b Second string to use, after @p sep. 336 * @param[in] b Second string to use, after @p sep.
337 * @return The number of characters printed. 337 * @return The number of characters printed.
338 * 338 *
339 * This function is similar to eina_str_join_len(), but will assume 339 * This function is similar to eina_str_join_len(), but will assume
@@ -348,9 +348,9 @@ static inline size_t eina_strlen_bounded(const char *str, size_t maxlen) EINA_PU
348 348
349/** 349/**
350 * @brief Memory duplication function with optional termination for strings 350 * @brief Memory duplication function with optional termination for strings
351 * @param mem The memory to copy 351 * @param[in] mem The memory to copy
352 * @param size The size of @p mem 352 * @param[in] size The size of @p mem
353 * @param terminate If true, the returned memory will be nul terminated with '\0' 353 * @param[in] terminate If true, the returned memory will be nul terminated with '\0'
354 * @return The copied memory, must be freed 354 * @return The copied memory, must be freed
355 * @since 1.13 355 * @since 1.13
356 */ 356 */
@@ -359,8 +359,8 @@ EAPI unsigned char *eina_memdup(unsigned char *mem, size_t size, Eina_Bool termi
359/** 359/**
360 * @brief Creates and update the buffer based on strftime output. 360 * @brief Creates and update the buffer based on strftime output.
361 * 361 *
362 * @param tm Pointer to a tm structure needed by strftime. 362 * @param[in] tm Pointer to a tm structure needed by strftime.
363 * @param format String containing format specifiers needed by strftime. 363 * @param[in] format String containing format specifiers needed by strftime.
364 * @return Updated buffer based on strftime output 364 * @return Updated buffer based on strftime output
365 * 365 *
366 * This will create a buffer of exact required size based on strftime output 366 * This will create a buffer of exact required size based on strftime output
diff --git a/src/lib/eina/eina_stringshare.h b/src/lib/eina/eina_stringshare.h
index 3c4b836486..ccb865075f 100644
--- a/src/lib/eina/eina_stringshare.h
+++ b/src/lib/eina/eina_stringshare.h
@@ -178,8 +178,8 @@ typedef const char Eina_Stringshare;
178 * @brief Retrieves an instance of a string with a specific size for use in a 178 * @brief Retrieves an instance of a string with a specific size for use in a
179 * program. 179 * program.
180 * 180 *
181 * @param str The string to retrieve an instance of. 181 * @param[in] str The string to retrieve an instance of.
182 * @param slen The string size (<= strlen(str)). 182 * @param[in] slen The string size (<= strlen(str)).
183 * @return A pointer to an instance of the string on success, 183 * @return A pointer to an instance of the string on success,
184 * @c NULL on failure. 184 * @c NULL on failure.
185 * 185 *
@@ -199,7 +199,7 @@ EAPI Eina_Stringshare *eina_stringshare_add_length(const char *str, unsigned in
199/** 199/**
200 * @brief Retrieves an instance of a string for use in a program. 200 * @brief Retrieves an instance of a string for use in a program.
201 * 201 *
202 * @param str The NULL-terminated string to retrieve an instance of. 202 * @param[in] str The NULL-terminated string to retrieve an instance of.
203 * @return A pointer to an instance of the string on success, 203 * @return A pointer to an instance of the string on success,
204 * @c NULL on failure. 204 * @c NULL on failure.
205 * 205 *
@@ -220,7 +220,7 @@ EAPI Eina_Stringshare *eina_stringshare_add(const char *str) EINA_WARN_UNUSED_R
220 * @brief Retrieves an instance of a string for use in a program 220 * @brief Retrieves an instance of a string for use in a program
221 * from a format string. 221 * from a format string.
222 * 222 *
223 * @param fmt The NULL-terminated format string to retrieve an instance of. 223 * @param[in] fmt The NULL-terminated format string to retrieve an instance of.
224 * @return A pointer to an instance of the string on success, 224 * @return A pointer to an instance of the string on success,
225 * @c NULL on failure. 225 * @c NULL on failure.
226 * 226 *
@@ -241,8 +241,8 @@ EAPI Eina_Stringshare *eina_stringshare_printf(const char *fmt, ...) EINA_WARN_
241 * @brief Retrieves an instance of a string for use in a program 241 * @brief Retrieves an instance of a string for use in a program
242 * from a format string. 242 * from a format string.
243 * 243 *
244 * @param fmt The NULL-terminated format string to retrieve an instance of. 244 * @param[in] fmt The NULL-terminated format string to retrieve an instance of.
245 * @param args The va_args for @p fmt 245 * @param[in] args The va_args for @p fmt
246 * @return A pointer to an instance of the string on success, 246 * @return A pointer to an instance of the string on success,
247 * @c NULL on failure. 247 * @c NULL on failure.
248 * 248 *
@@ -262,8 +262,9 @@ EAPI Eina_Stringshare *eina_stringshare_vprintf(const char *fmt, va_list args)
262/** 262/**
263 * @brief Retrieves an instance of a string for use in a program 263 * @brief Retrieves an instance of a string for use in a program
264 * from a format string with size limitation. 264 * from a format string with size limitation.
265 * @param len The length of the format string to use 265 *
266 * @param fmt The format string to retrieve an instance of. 266 * @param[in] len The length of the format string to use
267 * @param[in] fmt The format string to retrieve an instance of.
267 * @return A pointer to an instance of the string on success, 268 * @return A pointer to an instance of the string on success,
268 * @c NULL on failure. 269 * @c NULL on failure.
269 * 270 *
@@ -282,7 +283,7 @@ EAPI Eina_Stringshare *eina_stringshare_nprintf(unsigned int len, const char *f
282/** 283/**
283 * Increment references of the given shared string. 284 * Increment references of the given shared string.
284 * 285 *
285 * @param str The shared string. 286 * @param[in,out] str The shared string.
286 * @return A pointer to an instance of the string on success, 287 * @return A pointer to an instance of the string on success,
287 * @c NULL on failure. 288 * @c NULL on failure.
288 * 289 *
@@ -298,7 +299,7 @@ EAPI Eina_Stringshare *eina_stringshare_ref(Eina_Stringshare *str);
298/** 299/**
299 * @brief Notes that the given string has lost an instance. 300 * @brief Notes that the given string has lost an instance.
300 * 301 *
301 * @param str String the given string. 302 * @param[in,out] str String the given string.
302 * 303 *
303 * This function decreases the reference counter associated to @p str 304 * This function decreases the reference counter associated to @p str
304 * if it exists. If that counter reaches 0, the memory associated to 305 * if it exists. If that counter reaches 0, the memory associated to
@@ -313,7 +314,7 @@ EAPI void eina_stringshare_del(Eina_Stringshare *str);
313/** 314/**
314 * @brief Notes that the given string @b must be shared. 315 * @brief Notes that the given string @b must be shared.
315 * 316 *
316 * @param str The shared string to know the length. It is safe to 317 * @param[in] str The shared string to know the length. It is safe to
317 * give @c NULL, in that case @c 0 is returned. 318 * give @c NULL, in that case @c 0 is returned.
318 * @return The length of a shared string. 319 * @return The length of a shared string.
319 * 320 *
diff --git a/src/lib/eina/eina_thread.h b/src/lib/eina/eina_thread.h
index 076a36d247..15e522fc4c 100644
--- a/src/lib/eina/eina_thread.h
+++ b/src/lib/eina/eina_thread.h
@@ -77,8 +77,8 @@ EAPI Eina_Thread eina_thread_self(void) EINA_WARN_UNUSED_RESULT;
77 77
78/** 78/**
79 * @brief Checks if two thread identifiers are the same. 79 * @brief Checks if two thread identifiers are the same.
80 * @param t1 first thread identifier to compare. 80 * @param[in] t1 first thread identifier to compare.
81 * @param t2 second thread identifier to compare. 81 * @param[in] t2 second thread identifier to compare.
82 * @return #EINA_TRUE if they are equal, #EINA_FALSE otherwise. 82 * @return #EINA_TRUE if they are equal, #EINA_FALSE otherwise.
83 * @since 1.8 83 * @since 1.8
84 */ 84 */
@@ -88,10 +88,10 @@ EAPI Eina_Bool eina_thread_equal(Eina_Thread t1, Eina_Thread t2) EINA_WARN_UNUSE
88 * @brief Creates a new thread, setting its priority and affinity. 88 * @brief Creates a new thread, setting its priority and affinity.
89 * 89 *
90 * @param[out] t where to return the thread identifier. Must @b not be @c NULL. 90 * @param[out] t where to return the thread identifier. Must @b not be @c NULL.
91 * @param prio thread priority to use, usually EINA_THREAD_BACKGROUND 91 * @param[in] prio thread priority to use, usually EINA_THREAD_BACKGROUND
92 * @param affinity thread affinity to use. To not set affinity use @c -1. 92 * @param[in] affinity thread affinity to use. To not set affinity use @c -1.
93 * @param func function to run in the thread. Must @b not be @c NULL. 93 * @param[in] func function to run in the thread. Must @b not be @c NULL.
94 * @param data context data to provide to @a func as first argument. 94 * @param[in] data context data to provide to @a func as first argument.
95 * @return #EINA_TRUE if thread was created, #EINA_FALSE on errors. 95 * @return #EINA_TRUE if thread was created, #EINA_FALSE on errors.
96 * @since 1.8 96 * @since 1.8
97 */ 97 */
@@ -121,7 +121,7 @@ EAPI extern const void *EINA_THREAD_JOIN_CANCELED;
121 * and may be @c NULL on errors. See @ref Eina_Error_Group to identify 121 * and may be @c NULL on errors. See @ref Eina_Error_Group to identify
122 * problems. 122 * problems.
123 * 123 *
124 * @param t thread identifier to wait. 124 * @param[in] t thread identifier to wait.
125 * @return value returned by @a t creation function @c func() or 125 * @return value returned by @a t creation function @c func() or
126 * @c NULL on errors. Check error with @ref Eina_Error_Group. 126 * @c NULL on errors. Check error with @ref Eina_Error_Group.
127 * If the thread was canceled, it will return 127 * If the thread was canceled, it will return
@@ -139,8 +139,8 @@ EAPI void *eina_thread_join(Eina_Thread t);
139 * for debugging to name a thread so external tools can display a 139 * for debugging to name a thread so external tools can display a
140 * meaningful name attached to the thread. 140 * meaningful name attached to the thread.
141 * 141 *
142 * @param t thread to set the name of 142 * @param[in] t thread to set the name of
143 * @param name a string to name the thread - this cannot be NULL 143 * @param[in] name a string to name the thread - this cannot be NULL
144 * @return EINA_TRUE if it succeeds in setting the name or EINA_FALSE 144 * @return EINA_TRUE if it succeeds in setting the name or EINA_FALSE
145 * otherwise. 145 * otherwise.
146 * @since 1.16 146 * @since 1.16
@@ -160,7 +160,7 @@ EAPI Eina_Bool eina_thread_name_set(Eina_Thread t, const char *name);
160 * A thread that was canceled will return EINA_THREAD_JOIN_CANCELED 160 * A thread that was canceled will return EINA_THREAD_JOIN_CANCELED
161 * when eina_thread_join() is called. 161 * when eina_thread_join() is called.
162 * 162 *
163 * @param t Thread to cancel. 163 * @param[in] t Thread to cancel.
164 * 164 *
165 * @return EINA_FALSE if thread was not running, EINA_TRUE 165 * @return EINA_FALSE if thread was not running, EINA_TRUE
166 * otherwise. Note that if a thread is not cancellable and it 166 * otherwise. Note that if a thread is not cancellable and it
@@ -189,10 +189,10 @@ EAPI Eina_Bool eina_thread_cancel(Eina_Thread t);
189 * or the helper function eina_thread_cancellable_run() which does the 189 * or the helper function eina_thread_cancellable_run() which does the
190 * pair for you. 190 * pair for you.
191 * 191 *
192 * @param cancellable If EINA_TRUE, this thread will be accept 192 * @param[in] cancellable If EINA_TRUE, this thread will be accept
193 * cancellation requests. If EINA_FALSE -- the default, it will 193 * cancellation requests. If EINA_FALSE -- the default, it will
194 * ignore cancellation requests. 194 * ignore cancellation requests.
195 * @param was_cancellable If non-NULL, will return the previous state, 195 * @param[in] was_cancellable If non-NULL, will return the previous state,
196 * shall you want to restore. 196 * shall you want to restore.
197 * 197 *
198 * @return EINA_TRUE if it succeeds in setting the cancellable state 198 * @return EINA_TRUE if it succeeds in setting the cancellable state
@@ -246,8 +246,8 @@ EAPI void eina_thread_cancel_checkpoint(void);
246 * @b not be executed! To avoid problems prefer to use 246 * @b not be executed! To avoid problems prefer to use
247 * eina_thread_cancellable_run()! 247 * eina_thread_cancellable_run()!
248 * 248 *
249 * @param cleanup The function to execute on cancellation. 249 * @param[in] cleanup The function to execute on cancellation.
250 * @param data The context to give to cleanup function. 250 * @param[in] data The context to give to cleanup function.
251 * 251 *
252 * @see eina_thread_cancellable_run() 252 * @see eina_thread_cancellable_run()
253 * 253 *
@@ -276,7 +276,7 @@ EAPI void eina_thread_cancel_checkpoint(void);
276 * @b not be executed even if exec_cleanup is EINA_TRUE! To 276 * @b not be executed even if exec_cleanup is EINA_TRUE! To
277 * avoid problems prefer to use eina_thread_cancellable_run()! 277 * avoid problems prefer to use eina_thread_cancellable_run()!
278 * 278 *
279 * @param exec_cleanup if EINA_TRUE, the function registered with 279 * @param[in] exec_cleanup if EINA_TRUE, the function registered with
280 * EINA_THREAD_CLEANUP_PUSH() will be executed. 280 * EINA_THREAD_CLEANUP_PUSH() will be executed.
281 * 281 *
282 * @see eina_thread_cancellable_run() 282 * @see eina_thread_cancellable_run()
@@ -320,16 +320,16 @@ typedef void *(*Eina_Thread_Cancellable_Run_Cb)(void *data);
320 * return ret; 320 * return ret;
321 * @endcode 321 * @endcode
322 * 322 *
323 * @param cb a cancellable callback to possibly run. The callback @b 323 * @param[in] cb a cancellable callback to possibly run. The callback @b
324 * may not be executed if the thread had a pending cancellation 324 * may not be executed if the thread had a pending cancellation
325 * request. During its execution the callback may be canceled 325 * request. During its execution the callback may be canceled
326 * at explicit cancellation points using 326 * at explicit cancellation points using
327 * eina_thread_cancel_checkpoint(), as well as some syscalls 327 * eina_thread_cancel_checkpoint(), as well as some syscalls
328 * defined in man:pthreads(7). 328 * defined in man:pthreads(7).
329 * @param cleanup_cb a cleanup callback to be executed regardless of 329 * @param[in] cleanup_cb a cleanup callback to be executed regardless of
330 * the thread being canceled or not. This function will be 330 * the thread being canceled or not. This function will be
331 * executed even if @a cb wasn't. 331 * executed even if @a cb wasn't.
332 * @param data context to give to both @a cb and @a cleanup_cb. 332 * @param[in] data context to give to both @a cb and @a cleanup_cb.
333 * 333 *
334 * @return the return value of @a cb. If the thread was canceled, 334 * @return the return value of @a cb. If the thread was canceled,
335 * this function will not return. 335 * this function will not return.
diff --git a/src/lib/eina/eina_thread_queue.h b/src/lib/eina/eina_thread_queue.h
index 4009a0efb5..dd8f90d455 100644
--- a/src/lib/eina/eina_thread_queue.h
+++ b/src/lib/eina/eina_thread_queue.h
@@ -83,7 +83,7 @@ eina_thread_queue_new(void);
83 * on messages or sending them. Any pending messages will be freed without 83 * on messages or sending them. Any pending messages will be freed without
84 * being processed by a listener. 84 * being processed by a listener.
85 * 85 *
86 * @param thq The thread queue to free 86 * @param[in] thq The thread queue to free
87 * 87 *
88 * @since 1.11 88 * @since 1.11
89 */ 89 */
@@ -93,9 +93,9 @@ eina_thread_queue_free(Eina_Thread_Queue *thq) EINA_ARG_NONNULL(1);
93/** 93/**
94 * @brief Allocates a message to send down a thread queue. 94 * @brief Allocates a message to send down a thread queue.
95 * 95 *
96 * @param thq The thread queue to allocate the message on 96 * @param[in,out] thq The thread queue to allocate the message on
97 * @param size The size, in bytes, of the message, including standard header 97 * @param[in] size The size, in bytes, of the message, including standard header
98 * @param allocref A pointer to store a general reference handle for the message 98 * @param[out] allocref A pointer to store a general reference handle for the message
99 * @return A pointer to the message data to fill in 99 * @return A pointer to the message data to fill in
100 * 100 *
101 * This allocates space for a new message on the message queue, but does not 101 * This allocates space for a new message on the message queue, but does not
@@ -112,8 +112,8 @@ eina_thread_queue_send(Eina_Thread_Queue *thq, int size, void **allocref) EINA_A
112/** 112/**
113 * @brief Finishes sending the allocated message. 113 * @brief Finishes sending the allocated message.
114 * 114 *
115 * @param thq The thread queue the message was placed on 115 * @param[in,out] thq The thread queue the message was placed on
116 * @param allocref The allocref returned by eina_thread_queue_send() 116 * @param[in,out] allocref The allocref returned by eina_thread_queue_send()
117 * 117 *
118 * This completes the send and triggers the thread queue to wake up any 118 * This completes the send and triggers the thread queue to wake up any
119 * listeners. 119 * listeners.
@@ -126,8 +126,8 @@ eina_thread_queue_send_done(Eina_Thread_Queue *thq, void *allocref) EINA_ARG_NON
126/** 126/**
127 * @brief Fetches a message from a thread queue. 127 * @brief Fetches a message from a thread queue.
128 * 128 *
129 * @param thq The thread queue to fetch the message from 129 * @param[in,out] thq The thread queue to fetch the message from
130 * @param allocref A pointer to store a general reference handle for the message 130 * @param[out] allocref A pointer to store a general reference handle for the message
131 * @return A pointer to the message data 131 * @return A pointer to the message data
132 * 132 *
133 * This will fetch the next message to read from the thread queue and return 133 * This will fetch the next message to read from the thread queue and return
@@ -146,8 +146,8 @@ eina_thread_queue_wait(Eina_Thread_Queue *thq, void **allocref) EINA_ARG_NONNULL
146/** 146/**
147 * @brief Finishes fetching a message from a thread queue. 147 * @brief Finishes fetching a message from a thread queue.
148 * 148 *
149 * @param thq The thread queue the message was fetched from 149 * @param[in,out] thq The thread queue the message was fetched from
150 * @param allocref The allocref returned by eina_thread_queue_wait() 150 * @param[in,out] allocref The allocref returned by eina_thread_queue_wait()
151 * 151 *
152 * This should be used after eina_thread_queue_wait() or 152 * This should be used after eina_thread_queue_wait() or
153 * eina_thread_queue_poll() to indicate the caller is done with the message. 153 * eina_thread_queue_poll() to indicate the caller is done with the message.
@@ -160,8 +160,8 @@ eina_thread_queue_wait_done(Eina_Thread_Queue *thq, void *allocref) EINA_ARG_NON
160/** 160/**
161 * @brief Fetches a message from a thread queue, but return immediately if there is none with NULL. 161 * @brief Fetches a message from a thread queue, but return immediately if there is none with NULL.
162 * 162 *
163 * @param thq The thread queue to fetch the message from 163 * @param[in,out] thq The thread queue to fetch the message from
164 * @param allocref A pointer to store a general reference handle for the message 164 * @param[out] allocref A pointer to store a general reference handle for the message
165 * @return A pointer to the message data 165 * @return A pointer to the message data
166 * 166 *
167 * This is the same as eina_thread_queue_wait(), but if no messages are 167 * This is the same as eina_thread_queue_wait(), but if no messages are
@@ -178,7 +178,7 @@ eina_thread_queue_poll(Eina_Thread_Queue *thq, void **allocref) EINA_ARG_NONNULL
178/** 178/**
179 * @brief Gets the number of messages on a queue as yet unfetched. 179 * @brief Gets the number of messages on a queue as yet unfetched.
180 * 180 *
181 * @param thq The thread queue to query for pending count 181 * @param[in] thq The thread queue to query for pending count
182 * @return The number of messages waiting to be fetched 182 * @return The number of messages waiting to be fetched
183 * 183 *
184 * This returns the number of messages waiting to be fetched with 184 * This returns the number of messages waiting to be fetched with
@@ -192,8 +192,8 @@ eina_thread_queue_pending_get(const Eina_Thread_Queue *thq) EINA_ARG_NONNULL(1);
192/** 192/**
193 * @brief Sets the parent of a thread queue (make this one a child). 193 * @brief Sets the parent of a thread queue (make this one a child).
194 * 194 *
195 * @param thq The thread queue to alter the parent of 195 * @param[in,out] thq The thread queue to alter the parent of
196 * @param thq_parent The new parent to set 196 * @param[in] thq_parent The new parent to set
197 * 197 *
198 * This sets the parent queue where messages will be reported to. This is 198 * This sets the parent queue where messages will be reported to. This is
199 * how you can listen to multiple queues at once - set multiple queues to 199 * how you can listen to multiple queues at once - set multiple queues to
@@ -209,7 +209,7 @@ eina_thread_queue_parent_set(Eina_Thread_Queue *thq, Eina_Thread_Queue *thq_pare
209/** 209/**
210 * @brief Gets the parent of a thread queue. 210 * @brief Gets the parent of a thread queue.
211 * 211 *
212 * @param thq The thread queue to get the parent of 212 * @param[in] thq The thread queue to get the parent of
213 * @return The parent thread queue 213 * @return The parent thread queue
214 * 214 *
215 * This gets the parent set by eina_thread_queue_parent_get(). If no parent 215 * This gets the parent set by eina_thread_queue_parent_get(). If no parent
@@ -225,8 +225,8 @@ eina_thread_queue_parent_get(const Eina_Thread_Queue *thq) EINA_ARG_NONNULL(1);
225/** 225/**
226 * @brief Sets a file descriptor to write a byte to on a message send. 226 * @brief Sets a file descriptor to write a byte to on a message send.
227 * 227 *
228 * @param thq The thread queue to set the file descriptor of 228 * @param[in,out] thq The thread queue to set the file descriptor of
229 * @param fd The fd to set, or -1 to unset it 229 * @param[in] fd The fd to set, or -1 to unset it
230 * 230 *
231 * This sets a file descriptor to write to when a message is written to the 231 * This sets a file descriptor to write to when a message is written to the
232 * thread queue. This can be used to glue a thread queue to something like 232 * thread queue. This can be used to glue a thread queue to something like
@@ -245,7 +245,7 @@ eina_thread_queue_fd_set(Eina_Thread_Queue *thq, int fd) EINA_ARG_NONNULL(1);
245/** 245/**
246 * @brief Gets the file descriptor written to on message sends. 246 * @brief Gets the file descriptor written to on message sends.
247 * 247 *
248 * @param thq The thread queue to get the file descriptor of 248 * @param[in] thq The thread queue to get the file descriptor of
249 * @return The file descriptor set (or -1 if none is set). 249 * @return The file descriptor set (or -1 if none is set).
250 * 250 *
251 * This returns the file descriptor set by eina_thread_queue_fd_set() and 251 * This returns the file descriptor set by eina_thread_queue_fd_set() and
diff --git a/src/lib/eina/eina_tiler.h b/src/lib/eina/eina_tiler.h
index c6dd492d2f..28492efc4f 100644
--- a/src/lib/eina/eina_tiler.h
+++ b/src/lib/eina/eina_tiler.h
@@ -177,8 +177,8 @@ typedef struct _Eina_Tile_Grid_Slicer Eina_Tile_Grid_Slicer;
177/** 177/**
178 * @brief Creates a new tiler with @p w width and @p h height. 178 * @brief Creates a new tiler with @p w width and @p h height.
179 * 179 *
180 * @param w Width of the tiler 180 * @param[in] w Width of the tiler
181 * @param h Height of the tiler 181 * @param[in] h Height of the tiler
182 * @return The newly created tiler 182 * @return The newly created tiler
183 * 183 *
184 * @see eina_tiler_free() 184 * @see eina_tiler_free()
@@ -188,7 +188,7 @@ EAPI Eina_Tiler *eina_tiler_new(int w, int h);
188/** 188/**
189 * @brief Frees a tiler. 189 * @brief Frees a tiler.
190 * 190 *
191 * @param t The tiler to free. 191 * @param[in] t The tiler to free.
192 * 192 *
193 * This function frees @p t. It does not free the memory allocated for the 193 * This function frees @p t. It does not free the memory allocated for the
194 * elements of @p t. 194 * elements of @p t.
@@ -198,9 +198,9 @@ EAPI void eina_tiler_free(Eina_Tiler *t);
198/** 198/**
199 * @brief Sets the size of tiles for a tiler. 199 * @brief Sets the size of tiles for a tiler.
200 * 200 *
201 * @param t The tiler whose tile size will be set. 201 * @param[in,out] t The tiler whose tile size will be set.
202 * @param w Width of the tiles. 202 * @param[in] w Width of the tiles.
203 * @param h Height of the tiles. 203 * @param[in] h Height of the tiles.
204 * 204 *
205 * @warning @p w and @p h @b must be greater than zero, otherwise tile size 205 * @warning @p w and @p h @b must be greater than zero, otherwise tile size
206 * won't be changed. 206 * won't be changed.
@@ -211,9 +211,9 @@ EAPI void eina_tiler_tile_size_set(Eina_Tiler *t, int w, int h);
211/** 211/**
212 * @brief Changes the size of the area covered by the tiler. 212 * @brief Changes the size of the area covered by the tiler.
213 * 213 *
214 * @param t The tiler whose area size will be set. 214 * @param[in,out] t The tiler whose area size will be set.
215 * @param w Width of the area. 215 * @param[in] w Width of the area.
216 * @param h Height of the area. 216 * @param[in] h Height of the area.
217 * 217 *
218 * @since 1.8 218 * @since 1.8
219 * 219 *
@@ -224,9 +224,9 @@ EAPI void eina_tiler_area_size_set(Eina_Tiler *t, int w, int h);
224/** 224/**
225 * @brief Gets the size of the area covered by the tiler. 225 * @brief Gets the size of the area covered by the tiler.
226 * 226 *
227 * @param t The tiler whose area size will be fetched. 227 * @param[in] t The tiler whose area size will be fetched.
228 * @param w Width of the area. 228 * @param[out] w Width of the area.
229 * @param h Height of the area. 229 * @param[out] h Height of the area.
230 * 230 *
231 * @since 1.8 231 * @since 1.8
232 */ 232 */
@@ -235,8 +235,8 @@ EAPI void eina_tiler_area_size_get(const Eina_Tiler *t, int *w, in
235/** 235/**
236 * @brief Defines if we need to follow a strict grid of tile or a loose one. 236 * @brief Defines if we need to follow a strict grid of tile or a loose one.
237 * 237 *
238 * @param t The tiler to apply the strict rules to. 238 * @param[in,out] t The tiler to apply the strict rules to.
239 * @param strict Define if it will be strict or loose 239 * @param[in] strict Define if it will be strict or loose
240 * 240 *
241 * By default it will be loose. 241 * By default it will be loose.
242 * 242 *
@@ -247,7 +247,7 @@ EAPI void eina_tiler_strict_set(Eina_Tiler *t, Eina_Bool strict);
247/** 247/**
248 * @brief Tells if a tiler is empty or not. 248 * @brief Tells if a tiler is empty or not.
249 * 249 *
250 * @param t The tiler to apply the strict rules to. 250 * @param[in] t The tiler to apply the strict rules to.
251 * @return #EINA_TRUE when empty, #EINA_FALSE when not. 251 * @return #EINA_TRUE when empty, #EINA_FALSE when not.
252 * 252 *
253 * @since 1.8 253 * @since 1.8
@@ -257,8 +257,8 @@ EAPI Eina_Bool eina_tiler_empty(const Eina_Tiler *t);
257/** 257/**
258 * @brief Adds a rectangle to a tiler. 258 * @brief Adds a rectangle to a tiler.
259 * 259 *
260 * @param t The tiler in which to add a container. 260 * @param[in,out] t The tiler in which to add a container.
261 * @param r The rectangle to be added. 261 * @param[in] r The rectangle to be added.
262 * @return #EINA_TRUE on success, #EINA_FALSE on failure. 262 * @return #EINA_TRUE on success, #EINA_FALSE on failure.
263 * 263 *
264 * @see eina_tiler_rect_del() 264 * @see eina_tiler_rect_del()
@@ -268,8 +268,8 @@ EAPI Eina_Bool eina_tiler_rect_add(Eina_Tiler *t, const Eina_Rectangle
268/** 268/**
269 * @brief Removes a rectangle from a tiler. 269 * @brief Removes a rectangle from a tiler.
270 * 270 *
271 * @param t The tiler in which to add a container. 271 * @param[in,out] t The tiler in which to add a container.
272 * @param r The rectangle to be removed. 272 * @param[in] r The rectangle to be removed.
273 * 273 *
274 * @see eina_tiler_rect_add() 274 * @see eina_tiler_rect_add()
275 * @see eina_tiler_clear() 275 * @see eina_tiler_clear()
@@ -279,7 +279,7 @@ EAPI void eina_tiler_rect_del(Eina_Tiler *t, const Eina_Rectangle
279/** 279/**
280 * @brief Removes all rectangles from tiles. 280 * @brief Removes all rectangles from tiles.
281 * 281 *
282 * @param t The tiler to clear. 282 * @param[in,out] t The tiler to clear.
283 * 283 *
284 * @see eina_tiler_rect_del() 284 * @see eina_tiler_rect_del()
285 */ 285 */
@@ -288,7 +288,7 @@ EAPI void eina_tiler_clear(Eina_Tiler *t);
288/** 288/**
289 * @brief Creates a iterator to access the tilers calculated rectangles. 289 * @brief Creates a iterator to access the tilers calculated rectangles.
290 * 290 *
291 * @param t The tiler to iterate over. 291 * @param[in] t The tiler to iterate over.
292 * @return A iterator containing Eina_Rectangle. 292 * @return A iterator containing Eina_Rectangle.
293 */ 293 */
294EAPI Eina_Iterator *eina_tiler_iterator_new(const Eina_Tiler *t); 294EAPI Eina_Iterator *eina_tiler_iterator_new(const Eina_Tiler *t);
@@ -296,12 +296,12 @@ EAPI Eina_Iterator *eina_tiler_iterator_new(const Eina_Tiler *t);
296/** 296/**
297 * @brief Creates a new Eina_Iterator that iterates over a list of tiles. 297 * @brief Creates a new Eina_Iterator that iterates over a list of tiles.
298 * 298 *
299 * @param x X axis coordinate. 299 * @param[in] x X axis coordinate.
300 * @param y Y axis coordinate. 300 * @param[in] y Y axis coordinate.
301 * @param w Width. 301 * @param[in] w Width.
302 * @param h Height. 302 * @param[in] h Height.
303 * @param tile_w Tile width. 303 * @param[in] tile_w Tile width.
304 * @param tile_h Tile height. 304 * @param[in] tile_h Tile height.
305 * @return A pointer to the Eina_Iterator. @c NULL on failure. 305 * @return A pointer to the Eina_Iterator. @c NULL on failure.
306 * 306 *
307 * The region defined by @a x, @a y, @a w, @a h will be divided in to a grid of 307 * The region defined by @a x, @a y, @a w, @a h will be divided in to a grid of
@@ -317,8 +317,8 @@ EAPI Eina_Iterator *eina_tile_grid_slicer_iterator_new(int x, int y, int w,
317/** 317/**
318 * @brief Gets the union of two tilers. 318 * @brief Gets the union of two tilers.
319 * 319 *
320 * @param dst The first tiler, will store the result. 320 * @param[in,out] dst The first tiler, will store the result.
321 * @param src The second tiler. 321 * @param[in] src The second tiler.
322 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 322 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
323 * 323 *
324 * This function gets the union of tilers @p dst and @p src. 324 * This function gets the union of tilers @p dst and @p src.
@@ -330,8 +330,8 @@ EAPI Eina_Bool eina_tiler_union(Eina_Tiler *dst, Eina_Tiler *src);
330/** 330/**
331 * @brief Subtracts two tilers. 331 * @brief Subtracts two tilers.
332 * 332 *
333 * @param dst The first tiler, will store the result. 333 * @param[in,out] dst The first tiler, will store the result.
334 * @param src The second tiler. 334 * @param[in] src The second tiler.
335 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 335 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
336 * 336 *
337 * This function subtracts two tilers @p dst and @p src. 337 * This function subtracts two tilers @p dst and @p src.
@@ -343,8 +343,8 @@ EAPI Eina_Bool eina_tiler_subtract(Eina_Tiler *dst, Eina_Tiler *src);
343/** 343/**
344 * @brief Gets the intersection of two tilers. 344 * @brief Gets the intersection of two tilers.
345 * 345 *
346 * @param t1 The first tile. 346 * @param[in] t1 The first tile.
347 * @param t2 The second tiler. 347 * @param[in] t2 The second tiler.
348 * @return A pointer of intersection result. @c NULL if intersection doesn't exist. 348 * @return A pointer of intersection result. @c NULL if intersection doesn't exist.
349 * 349 *
350 * This function gets the intersection of two tilers @p t1 and @p t2. 350 * This function gets the intersection of two tilers @p t1 and @p t2.
@@ -356,8 +356,8 @@ EAPI Eina_Tiler *eina_tiler_intersection(Eina_Tiler *t1, Eina_Tiler *t2);
356/** 356/**
357 * @brief Gets whether two tilers are equal in rects or not. 357 * @brief Gets whether two tilers are equal in rects or not.
358 * 358 *
359 * @param t1 The first tiler. 359 * @param[in] t1 The first tiler.
360 * @param t2 The second tiler. 360 * @param[in] t2 The second tiler.
361 * @return #EINA_TRUE if equal, #EINA_FALSE if unequal. 361 * @return #EINA_TRUE if equal, #EINA_FALSE if unequal.
362 * 362 *
363 * This function gets result of comparison for @p t1 and @p t2. 363 * This function gets result of comparison for @p t1 and @p t2.
@@ -369,8 +369,8 @@ EAPI Eina_Bool eina_tiler_equal(const Eina_Tiler *t1, const Eina_Tiler
369/** 369/**
370 * @brief Iterates over the tiles set by eina_tile_grid_slicer_setup(). 370 * @brief Iterates over the tiles set by eina_tile_grid_slicer_setup().
371 * 371 *
372 * @param slc Pointer to an Eina_Tile_Grid_Slicer struct. 372 * @param[in,out] slc Pointer to an Eina_Tile_Grid_Slicer struct.
373 * @param rect Pointer to a struct Eina_Tile_Grid_Info *. 373 * @param[out] rect Pointer to a struct Eina_Tile_Grid_Info *.
374 * @return #EINA_TRUE if the current rect is valid. #EINA_FALSE if there 374 * @return #EINA_TRUE if the current rect is valid. #EINA_FALSE if there
375 * are no more rects to iterate over (and thus the current one isn't valid). 375 * are no more rects to iterate over (and thus the current one isn't valid).
376 * 376 *
@@ -385,13 +385,13 @@ static inline Eina_Bool eina_tile_grid_slicer_next(Eina_Tile_Grid_Slicer *slc, c
385/** 385/**
386 * @brief Sets up an Eina_Tile_Grid_Slicer struct. 386 * @brief Sets up an Eina_Tile_Grid_Slicer struct.
387 * 387 *
388 * @param slc Pointer to an Eina_Tile_Grid_Slicer struct. 388 * @param[out] slc Pointer to an Eina_Tile_Grid_Slicer struct.
389 * @param x X axis coordinate. 389 * @param[in] x X axis coordinate.
390 * @param y Y axis coordinate. 390 * @param[in] y Y axis coordinate.
391 * @param w Width. 391 * @param[in] w Width.
392 * @param h Height. 392 * @param[in] h Height.
393 * @param tile_w Tile width. 393 * @param[in] tile_w Tile width.
394 * @param tile_h Tile height. 394 * @param[in] tile_h Tile height.
395 * @return A pointer to the Eina_Iterator, @c NULL on failure. 395 * @return A pointer to the Eina_Iterator, @c NULL on failure.
396 * 396 *
397 * The region defined by @a x, @a y, @a w, @a h will be divided into a grid of 397 * The region defined by @a x, @a y, @a w, @a h will be divided into a grid of
diff --git a/src/lib/eina/eina_tmpstr.h b/src/lib/eina/eina_tmpstr.h
index f300be13c3..164fe43aa5 100644
--- a/src/lib/eina/eina_tmpstr.h
+++ b/src/lib/eina/eina_tmpstr.h
@@ -123,7 +123,7 @@ typedef const char Eina_Tmpstr;
123/** 123/**
124 * @brief Adds a new temporary string based on the input string. 124 * @brief Adds a new temporary string based on the input string.
125 * 125 *
126 * @param str This is the input string that is copied into the temp string. 126 * @param[in] str This is the input string that is copied into the temp string.
127 * @return A pointer to the tmp string that is a standard C string. 127 * @return A pointer to the tmp string that is a standard C string.
128 * 128 *
129 * When you add a temporary string (tmpstr) it is expected to have a very 129 * When you add a temporary string (tmpstr) it is expected to have a very
@@ -167,8 +167,8 @@ EAPI Eina_Tmpstr *eina_tmpstr_add(const char *str) EINA_WARN_UNUSED_RESULT;
167/** 167/**
168 * @brief Adds a new temporary string based on the input string and length. 168 * @brief Adds a new temporary string based on the input string and length.
169 * 169 *
170 * @param str This is the input string that is copied into the temp string. 170 * @param[in] str This is the input string that is copied into the temp string.
171 * @param length This is the maximum length and the allocated length of the temp string. 171 * @param[in] length This is the maximum length and the allocated length of the temp string.
172 * @return A pointer to the tmp string that is a standard C string. 172 * @return A pointer to the tmp string that is a standard C string.
173 * 173 *
174 * When you add a temporary string (tmpstr) it is expected to have a very 174 * When you add a temporary string (tmpstr) it is expected to have a very
@@ -213,7 +213,7 @@ EINA_DEPRECATED EAPI size_t eina_tmpstr_strlen(Eina_Tmpstr *tmpstr);
213/** 213/**
214 * @brief Returns the length of a temporary string. 214 * @brief Returns the length of a temporary string.
215 * 215 *
216 * @param tmpstr This is any C string pointer, but if it is a tmp string 216 * @param[in] tmpstr This is any C string pointer, but if it is a tmp string
217 * it will return the length faster. 217 * it will return the length faster.
218 * @return The length of the string. 218 * @return The length of the string.
219 * 219 *
@@ -224,7 +224,7 @@ EAPI size_t eina_tmpstr_len(Eina_Tmpstr *tmpstr);
224/** 224/**
225 * @brief Deletes the temporary string if it is one, or ignore it if it is not. 225 * @brief Deletes the temporary string if it is one, or ignore it if it is not.
226 * 226 *
227 * @param tmpstr This is any C string pointer, but if it is a tmp string 227 * @param[in] tmpstr This is any C string pointer, but if it is a tmp string
228 * it is freed. 228 * it is freed.
229 * 229 *
230 * This will delete the given temporary string @p tmpstr if it is a valid 230 * This will delete the given temporary string @p tmpstr if it is a valid
@@ -241,7 +241,7 @@ EAPI void eina_tmpstr_del(Eina_Tmpstr *tmpstr) EINA_ARG_NONNULL(1);
241 * @brief Adds a new temporary string using the passed string. The passed 241 * @brief Adds a new temporary string using the passed string. The passed
242 * string is used directly as the buffer. The passed string must be malloced. 242 * string is used directly as the buffer. The passed string must be malloced.
243 * 243 *
244 * @param str The input string to manage. 244 * @param[in] str The input string to manage.
245 * @return A pointer to the tmp string that is a standard C string. 245 * @return A pointer to the tmp string that is a standard C string.
246 * 246 *
247 * This function creates a new temporary string. On error, @c NULL is 247 * This function creates a new temporary string. On error, @c NULL is
@@ -256,8 +256,8 @@ EAPI Eina_Tmpstr *eina_tmpstr_manage_new(char *str) EINA_WARN_UNUSED_RESULT;
256 * @brief Adds a new temporary string using the passed string. The passed 256 * @brief Adds a new temporary string using the passed string. The passed
257 * string is used directly as the buffer. The passed string must be malloced. 257 * string is used directly as the buffer. The passed string must be malloced.
258 * 258 *
259 * @param str The input string to manage. 259 * @param[in] str The input string to manage.
260 * @param length The length of the string. 260 * @param[in] length The length of the string.
261 * @return A pointer to the tmp string that is a standard C string. 261 * @return A pointer to the tmp string that is a standard C string.
262 * 262 *
263 * This function creates a new temporary string. On error, @c NULL is 263 * This function creates a new temporary string. On error, @c NULL is
diff --git a/src/lib/eina/eina_trash.h b/src/lib/eina/eina_trash.h
index 549d9359c4..78935ec5f1 100644
--- a/src/lib/eina/eina_trash.h
+++ b/src/lib/eina/eina_trash.h
@@ -60,8 +60,8 @@ static inline void eina_trash_init(Eina_Trash **trash) EINA_ARG_NONNULL(1);
60 * you can push it in a trash for a later use. This function just 60 * you can push it in a trash for a later use. This function just
61 * provide a fast way to push a now unused pointer into a trash. 61 * provide a fast way to push a now unused pointer into a trash.
62 * 62 *
63 * @param[in] trash A pointer to an Eina_Trash 63 * @param[in,out] trash A pointer to an Eina_Trash
64 * @param data An unused pointer big enough to put a (void*) 64 * @param[in] data An unused pointer big enough to put a (void*)
65 * 65 *
66 * @note Do not use the pointer after insertion or bad things will 66 * @note Do not use the pointer after insertion or bad things will
67 * happens. 67 * happens.
@@ -90,8 +90,8 @@ static inline void *eina_trash_pop(Eina_Trash **trash) EINA_ARG_NONNULL(1) EINA_
90 * @details This macro allows the cleaning of @a trash in an easy way. It 90 * @details This macro allows the cleaning of @a trash in an easy way. It
91 * removes all the pointers from @a trash until it's empty. 91 * removes all the pointers from @a trash until it's empty.
92 * 92 *
93 * @param trash The trash to clean 93 * @param[in,out] trash The trash to clean
94 * @param data The pointer extracted from the trash 94 * @param[out] data The pointer extracted from the trash
95 * 95 *
96 * @note This macro can be used for freeing the data in the trash, like in 96 * @note This macro can be used for freeing the data in the trash, like in
97 * the following example: 97 * the following example:
diff --git a/src/lib/eina/eina_types.h b/src/lib/eina/eina_types.h
index 84979022c9..131003c61c 100644
--- a/src/lib/eina/eina_types.h
+++ b/src/lib/eina/eina_types.h
@@ -312,7 +312,7 @@
312 * @def EINA_ARG_NONNULL 312 * @def EINA_ARG_NONNULL
313 * Used to warn when the specified arguments of the function are @c NULL. 313 * Used to warn when the specified arguments of the function are @c NULL.
314 * 314 *
315 * @param ... Ordinals of the parameters to check for nullity (1..n) 315 * @param[in] ... Ordinals of the parameters to check for nullity (1..n)
316 * 316 *
317 * @return Nothing, but Doxygen will complain if it's not documented :-P 317 * @return Nothing, but Doxygen will complain if it's not documented :-P
318 * 318 *
@@ -343,21 +343,21 @@
343 343
344/** 344/**
345 * @def EINA_PRINTF 345 * @def EINA_PRINTF
346 * @param fmt The format to be used. 346 * @param[in] fmt The format to be used.
347 * @param arg The argument to be used. 347 * @param[in] arg The argument to be used.
348 */ 348 */
349# define EINA_PRINTF(fmt, arg) 349# define EINA_PRINTF(fmt, arg)
350 350
351/** 351/**
352 * @def EINA_SCANF 352 * @def EINA_SCANF
353 * @param fmt The format to be used. 353 * @param[in] fmt The format to be used.
354 * @param arg The argument to be used. 354 * @param[in] arg The argument to be used.
355 */ 355 */
356# define EINA_SCANF(fmt, arg) 356# define EINA_SCANF(fmt, arg)
357 357
358/** 358/**
359 * @def EINA_FORMAT 359 * @def EINA_FORMAT
360 * @param fmt The format to be used. 360 * @param[in] fmt The format to be used.
361 */ 361 */
362# define EINA_FORMAT(fmt) 362# define EINA_FORMAT(fmt)
363 363
@@ -375,13 +375,13 @@
375 375
376/** 376/**
377 * @def EINA_UNLIKELY 377 * @def EINA_UNLIKELY
378 * @param exp The expression to be used. 378 * @param[in] exp The expression to be used.
379 */ 379 */
380# define EINA_UNLIKELY(exp) exp 380# define EINA_UNLIKELY(exp) exp
381 381
382/** 382/**
383 * @def EINA_LIKELY 383 * @def EINA_LIKELY
384 * @param exp The expression to be used. 384 * @param[in] exp The expression to be used.
385 */ 385 */
386# define EINA_LIKELY(exp) exp 386# define EINA_LIKELY(exp) exp
387 387
diff --git a/src/lib/eina/eina_unicode.h b/src/lib/eina/eina_unicode.h
index e32d0591f3..1f798ef52e 100644
--- a/src/lib/eina/eina_unicode.h
+++ b/src/lib/eina/eina_unicode.h
@@ -47,8 +47,8 @@ EAPI size_t eina_unicode_strlen(const Eina_Unicode *ustr) EINA_ARG_NONNUL
47 * of n. If the terminating character is not found in the string, it returns 47 * of n. If the terminating character is not found in the string, it returns
48 * n. 48 * n.
49 * 49 *
50 * @param ustr String to search 50 * @param[in] ustr String to search
51 * @param n Max length to search 51 * @param[in] n Max length to search
52 * @return Number of characters or n. 52 * @return Number of characters or n.
53 */ 53 */
54EAPI size_t eina_unicode_strnlen(const Eina_Unicode *ustr, int n) EINA_ARG_NONNULL(1) EINA_WARN_UNUSED_RESULT EINA_PURE; 54EAPI size_t eina_unicode_strnlen(const Eina_Unicode *ustr, int n) EINA_ARG_NONNULL(1) EINA_WARN_UNUSED_RESULT EINA_PURE;
@@ -56,7 +56,7 @@ EAPI size_t eina_unicode_strnlen(const Eina_Unicode *ustr, int n) EINA_AR
56/** 56/**
57 * @brief Same as the standard strdup just with Eina_Unicode instead of char. 57 * @brief Same as the standard strdup just with Eina_Unicode instead of char.
58 * 58 *
59 * @param text The text to duplicate. 59 * @param[in] text The text to duplicate.
60 * @return The duplicated string. 60 * @return The duplicated string.
61 */ 61 */
62EAPI Eina_Unicode *eina_unicode_strdup(const Eina_Unicode *text) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC; 62EAPI Eina_Unicode *eina_unicode_strdup(const Eina_Unicode *text) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC;
@@ -64,8 +64,8 @@ EAPI Eina_Unicode *eina_unicode_strdup(const Eina_Unicode *text) EINA_WARN_UNUSE
64/** 64/**
65 * @brief Same as strdup but cuts on the given size. Assumes n < len 65 * @brief Same as strdup but cuts on the given size. Assumes n < len
66 * 66 *
67 * @param text The text to duplicate. 67 * @param[in] text The text to duplicate.
68 * @param n The maximum size of the text to duplicate. 68 * @param[in] n The maximum size of the text to duplicate.
69 * @return The duplicated string. 69 * @return The duplicated string.
70 * 70 *
71 * This function duplicates @p text. The resulting string is cut on @p 71 * This function duplicates @p text. The resulting string is cut on @p
@@ -79,8 +79,8 @@ EAPI Eina_Unicode *eina_unicode_strndup(const Eina_Unicode *text, size_t n) EINA
79/** 79/**
80 * @brief Same as the standard strcmp just with Eina_Unicode instead of char. 80 * @brief Same as the standard strcmp just with Eina_Unicode instead of char.
81 * 81 *
82 * @param a The text to be compared. 82 * @param[in] a The text to be compared.
83 * @param b The text to be compared. 83 * @param[in] b The text to be compared.
84 * @return An integer value indicating the ordinal relation of @p a to @p b. 84 * @return An integer value indicating the ordinal relation of @p a to @p b.
85 */ 85 */
86EAPI int eina_unicode_strcmp(const Eina_Unicode *a, const Eina_Unicode *b) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1, 2) EINA_PURE; 86EAPI int eina_unicode_strcmp(const Eina_Unicode *a, const Eina_Unicode *b) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1, 2) EINA_PURE;
@@ -88,8 +88,8 @@ EAPI int eina_unicode_strcmp(const Eina_Unicode *a, const Eina_Unicode
88/** 88/**
89 * @brief Same as the standard strcpy just with Eina_Unicode instead of char. 89 * @brief Same as the standard strcpy just with Eina_Unicode instead of char.
90 * 90 *
91 * @param dest The text which @p source is to be copied. 91 * @param[out] dest The text which @p source is to be copied.
92 * @param source The text to copy from. 92 * @param[in] source The text to copy from.
93 * @return @p dest is returned. 93 * @return @p dest is returned.
94 */ 94 */
95EAPI Eina_Unicode *eina_unicode_strcpy(Eina_Unicode *dest, const Eina_Unicode *source) EINA_ARG_NONNULL(1, 2); 95EAPI Eina_Unicode *eina_unicode_strcpy(Eina_Unicode *dest, const Eina_Unicode *source) EINA_ARG_NONNULL(1, 2);
@@ -97,8 +97,8 @@ EAPI Eina_Unicode *eina_unicode_strcpy(Eina_Unicode *dest, const Eina_Unicode *s
97/** 97/**
98 * @brief Same as the standard strstr just with Eina_Unicode instead of char. 98 * @brief Same as the standard strstr just with Eina_Unicode instead of char.
99 * 99 *
100 * @param haystack The text to be searched. 100 * @param[in] haystack The text to be searched.
101 * @param needle The text to search for 101 * @param[in] needle The text to search for
102 * @return The substring of @p haystack which starts with @p needle 102 * @return The substring of @p haystack which starts with @p needle
103 * when @p needle is founded in @p haystack, or NULL is returned. 103 * when @p needle is founded in @p haystack, or NULL is returned.
104 */ 104 */
@@ -107,9 +107,9 @@ EAPI Eina_Unicode *eina_unicode_strstr(const Eina_Unicode *haystack, const Eina_
107/** 107/**
108 * @brief Same as the standard strncpy just with Eina_Unicode instead of char. 108 * @brief Same as the standard strncpy just with Eina_Unicode instead of char.
109 * 109 *
110 * @param dest The text which @p source is to be copied. 110 * @param[out] dest The text which @p source is to be copied.
111 * @param source The text to copy from. 111 * @param[in] source The text to copy from.
112 * @param n Maximum number of characters to be copied from @p source. 112 * @param[in] n Maximum number of characters to be copied from @p source.
113 * @return @p dest is returned. 113 * @return @p dest is returned.
114 */ 114 */
115EAPI Eina_Unicode *eina_unicode_strncpy(Eina_Unicode *dest, const Eina_Unicode *source, size_t n) EINA_ARG_NONNULL(1, 2); 115EAPI Eina_Unicode *eina_unicode_strncpy(Eina_Unicode *dest, const Eina_Unicode *source, size_t n) EINA_ARG_NONNULL(1, 2);
@@ -117,7 +117,7 @@ EAPI Eina_Unicode *eina_unicode_strncpy(Eina_Unicode *dest, const Eina_Unicode *
117/** 117/**
118 * @see eina_str_escape() 118 * @see eina_str_escape()
119 * 119 *
120 * @param str The string to escape. 120 * @param[in] str The string to escape.
121 * @return The escaped string. 121 * @return The escaped string.
122 */ 122 */
123EAPI Eina_Unicode *eina_unicode_escape(const Eina_Unicode *str) EINA_ARG_NONNULL(1) EINA_MALLOC EINA_WARN_UNUSED_RESULT; 123EAPI Eina_Unicode *eina_unicode_escape(const Eina_Unicode *str) EINA_ARG_NONNULL(1) EINA_MALLOC EINA_WARN_UNUSED_RESULT;
@@ -133,8 +133,8 @@ EAPI Eina_Unicode *eina_unicode_escape(const Eina_Unicode *str) EINA_ARG_NONNULL
133 * On error: return a codepoint between DC80 to DCFF where the low 8 bits 133 * On error: return a codepoint between DC80 to DCFF where the low 8 bits
134 * are the byte's value. 134 * are the byte's value.
135 * 135 *
136 * @param buf the string 136 * @param[in] buf the string
137 * @param iindex the index to look at and return by. 137 * @param[in,out] iindex the index to look at and return by.
138 * @return the codepoint found, 0 if @p buf or @p iindex are NULL 138 * @return the codepoint found, 0 if @p buf or @p iindex are NULL
139 * 139 *
140 * @since 1.8.0 140 * @since 1.8.0
@@ -151,8 +151,8 @@ static inline Eina_Unicode eina_unicode_utf8_next_get(const char *buf, int *iind
151 * On error: return a codepoint between DC80 to DCFF where the low 8 bits 151 * On error: return a codepoint between DC80 to DCFF where the low 8 bits
152 * are the byte's value. 152 * are the byte's value.
153 * 153 *
154 * @param buf the string 154 * @param[in] buf the string
155 * @param iindex the index to look at and return by. 155 * @param[in,out] iindex the index to look at and return by.
156 * @return the codepoint found, 0 if @p buf or @p iindex are NULL 156 * @return the codepoint found, 0 if @p buf or @p iindex are NULL
157 * 157 *
158 * @since 1.1.0 158 * @since 1.1.0
@@ -168,8 +168,8 @@ EAPI Eina_Unicode eina_unicode_utf8_get_next(const char *buf, int *iindex) EINA_
168 * On error: return a codepoint between DC80 to DCFF where the low 8 bits 168 * On error: return a codepoint between DC80 to DCFF where the low 8 bits
169 * are the byte's value. 169 * are the byte's value.
170 * 170 *
171 * @param buf the string 171 * @param[in] buf the string
172 * @param iindex the index to look at and return by. 172 * @param[in,out] iindex the index to look at and return by.
173 * @return the codepoint found. 173 * @return the codepoint found.
174 * 174 *
175 * @since 1.1.0 175 * @since 1.1.0
@@ -181,7 +181,7 @@ EAPI Eina_Unicode eina_unicode_utf8_get_prev(const char *buf, int *iindex) EINA_
181 * the number of Eina_Unicodes it'll take to store this string in 181 * the number of Eina_Unicodes it'll take to store this string in
182 * an Eina_Unicode string. 182 * an Eina_Unicode string.
183 * 183 *
184 * @param buf the string 184 * @param[in] buf the string
185 * @return the number of unicode characters (not bytes) in the string 185 * @return the number of unicode characters (not bytes) in the string
186 * 186 *
187 * @since 1.1.0 187 * @since 1.1.0
@@ -191,9 +191,10 @@ EAPI int eina_unicode_utf8_get_len(const char *buf) EINA_ARG_NONNULL(1);
191/** 191/**
192 * Converts a utf-8 string to a newly allocated Eina_Unicode string. 192 * Converts a utf-8 string to a newly allocated Eina_Unicode string.
193 * 193 *
194 * @param utf the string in utf-8 194 * @param[in] utf the string in utf-8
195 * @param _len the length of the returned Eina_Unicode string. 195 * @param[out] _len the length of the returned Eina_Unicode string.
196 * @return the newly allocated Eina_Unicode string. 196 * @return the newly allocated Eina_Unicode string.
197 *
197 * @since 1.1.0 198 * @since 1.1.0
198 */ 199 */
199EAPI Eina_Unicode *eina_unicode_utf8_to_unicode(const char *utf, int *_len) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC; 200EAPI Eina_Unicode *eina_unicode_utf8_to_unicode(const char *utf, int *_len) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC;
@@ -201,9 +202,9 @@ EAPI Eina_Unicode *eina_unicode_utf8_to_unicode(const char *utf, int *_len) EINA
201/** 202/**
202 * Converts an Eina_Unicode string to a newly allocated utf-8 substring at given length. 203 * Converts an Eina_Unicode string to a newly allocated utf-8 substring at given length.
203 * 204 *
204 * @param uni the Eina_Unicode string 205 * @param[in] uni the Eina_Unicode string
205 * @param ulen the length in the unicode string to convert. 206 * @param[in] ulen the length in the unicode string to convert.
206 * @param _len the length byte length of the return utf8 substring. 207 * @param[out] _len the length byte length of the return utf8 substring.
207 * @return the newly allocated utf-8 substring. 208 * @return the newly allocated utf-8 substring.
208 * 209 *
209 * @since 1.17 210 * @since 1.17
@@ -213,8 +214,8 @@ EAPI char * eina_unicode_unicode_to_utf8_range(const Eina_Unicode *uni, int ulen
213/** 214/**
214 * Converts an Eina_Unicode string to a newly allocated utf-8 string. 215 * Converts an Eina_Unicode string to a newly allocated utf-8 string.
215 * 216 *
216 * @param uni the Eina_Unicode string 217 * @param[in] uni the Eina_Unicode string
217 * @param _len the length byte length of the return utf8 string. 218 * @param[out] _len the length byte length of the return utf8 string.
218 * @return the newly allocated utf-8 string. 219 * @return the newly allocated utf-8 string.
219 * 220 *
220 * @since 1.1.0 221 * @since 1.1.0
diff --git a/src/lib/eina/eina_ustringshare.h b/src/lib/eina/eina_ustringshare.h
index 7e74076611..5c92e5f67e 100644
--- a/src/lib/eina/eina_ustringshare.h
+++ b/src/lib/eina/eina_ustringshare.h
@@ -92,8 +92,8 @@
92/** 92/**
93 * @brief Retrieves an instance of a string for use in a program. 93 * @brief Retrieves an instance of a string for use in a program.
94 * 94 *
95 * @param str The string to retrieve an instance of. 95 * @param[in] str The string to retrieve an instance of.
96 * @param slen The string size (<= strlen(str)). 96 * @param[in] slen The string size (<= strlen(str)).
97 * @return A pointer to an instance of the string on success, 97 * @return A pointer to an instance of the string on success,
98 * @c NULL on failure. 98 * @c NULL on failure.
99 * 99 *
@@ -114,7 +114,7 @@ EAPI const Eina_Unicode *eina_ustringshare_add_length(const Eina_Unicode *str, u
114/** 114/**
115 * @brief Retrieves an instance of a string for use in a program. 115 * @brief Retrieves an instance of a string for use in a program.
116 * 116 *
117 * @param str The NULL-terminated string to retrieve an instance of. 117 * @param[in] str The NULL-terminated string to retrieve an instance of.
118 * @return A pointer to an instance of the string on success, 118 * @return A pointer to an instance of the string on success,
119 * @c NULL on failure. 119 * @c NULL on failure.
120 * 120 *
@@ -135,7 +135,7 @@ EAPI const Eina_Unicode *eina_ustringshare_add(const Eina_Unicode *str) EINA_WAR
135/** 135/**
136 * @brief Increments references of the given shared string. 136 * @brief Increments references of the given shared string.
137 * 137 *
138 * @param str The shared string. 138 * @param[in] str The shared string.
139 * @return A pointer to an instance of the string on success, 139 * @return A pointer to an instance of the string on success,
140 * @c NULL on failure. 140 * @c NULL on failure.
141 * 141 *
@@ -151,7 +151,7 @@ EAPI const Eina_Unicode *eina_ustringshare_ref(const Eina_Unicode *str);
151/** 151/**
152 * @brief Notes that the given string has lost an instance. 152 * @brief Notes that the given string has lost an instance.
153 * 153 *
154 * @param str String The given string. 154 * @param[in] str String The given string.
155 * 155 *
156 * This function decreases the reference counter associated to @p str 156 * This function decreases the reference counter associated to @p str
157 * if it exists. If that counter reaches 0, the memory associated to 157 * if it exists. If that counter reaches 0, the memory associated to
@@ -166,7 +166,7 @@ EAPI void eina_ustringshare_del(const Eina_Unicode *str);
166/** 166/**
167 * @brief Notes that the given string @b must be shared. 167 * @brief Notes that the given string @b must be shared.
168 * 168 *
169 * @param str The shared string to know the length. It is safe to 169 * @param[in] str The shared string to know the length. It is safe to
170 * give @c NULL, in that case @c -1 is returned. 170 * give @c NULL, in that case @c -1 is returned.
171 * @return The length of a shared string. 171 * @return The length of a shared string.
172 * 172 *
diff --git a/src/lib/eina/eina_util.h b/src/lib/eina/eina_util.h
index dacd9cdd65..6afd424921 100644
--- a/src/lib/eina/eina_util.h
+++ b/src/lib/eina/eina_util.h
@@ -52,8 +52,8 @@ EAPI const char *eina_environment_tmp_get(void);
52 52
53/** 53/**
54 * @brief Warningless comparison of doubles using == 54 * @brief Warningless comparison of doubles using ==
55 * @param a First member to compare 55 * @param[in] a First member to compare
56 * @param b Second member to compare 56 * @param[in] b Second member to compare
57 * 57 *
58 * @return @c true if two doubles match 58 * @return @c true if two doubles match
59 * @since 1.19 59 * @since 1.19
@@ -62,8 +62,8 @@ static inline Eina_Bool eina_dbl_exact(double a, double b);
62 62
63/** 63/**
64 * @brief Warningless comparison of floats using == 64 * @brief Warningless comparison of floats using ==
65 * @param a First member to compare 65 * @param[in] a First member to compare
66 * @param b Second member to compare 66 * @param[in] b Second member to compare
67 * 67 *
68 * @return @c true if two floats match 68 * @return @c true if two floats match
69 * @since 1.19 69 * @since 1.19
@@ -72,8 +72,8 @@ static inline Eina_Bool eina_flt_exact(float a, float b);
72 72
73/** 73/**
74 * @brief Safe comparison of float 74 * @brief Safe comparison of float
75 * @param a First member to compare 75 * @param[in] a First member to compare
76 * @param b Second member to compare 76 * @param[in] b Second member to compare
77 * @since 1.19 77 * @since 1.19
78 * 78 *
79 * @return @c true if two floats match 79 * @return @c true if two floats match
@@ -82,7 +82,7 @@ static inline Eina_Bool eina_flt_exact(float a, float b);
82 82
83/** 83/**
84 * @brief Determines if a float is not zero 84 * @brief Determines if a float is not zero
85 * @param a The float 85 * @param[in] a The float
86 * 86 *
87 * @return @c true if float is not zero 87 * @return @c true if float is not zero
88 * @since 1.19 88 * @since 1.19
@@ -91,8 +91,8 @@ static inline Eina_Bool eina_flt_exact(float a, float b);
91 91
92/** 92/**
93 * @brief Safe comparison of double 93 * @brief Safe comparison of double
94 * @param a First member to compare 94 * @param[in] a First member to compare
95 * @param b Second member to compare 95 * @param[in] b Second member to compare
96 * @since 1.19 96 * @since 1.19
97 * 97 *
98 * @return @c true if two double match 98 * @return @c true if two double match
@@ -101,7 +101,7 @@ static inline Eina_Bool eina_flt_exact(float a, float b);
101 101
102/** 102/**
103 * @brief Determines if a double is not zero 103 * @brief Determines if a double is not zero
104 * @param a The double 104 * @param[in] a The double
105 * 105 *
106 * @return @c true if double is not zero 106 * @return @c true if double is not zero
107 * @since 1.19 107 * @since 1.19
diff --git a/src/lib/eina/eina_value.h b/src/lib/eina/eina_value.h
index 7124cbf07d..b3a702456e 100644
--- a/src/lib/eina/eina_value.h
+++ b/src/lib/eina/eina_value.h
@@ -951,8 +951,8 @@ static inline Eina_Bool eina_value_vget(const Eina_Value *value,
951/** 951/**
952 * @brief Sets the generic value from pointer. 952 * @brief Sets the generic value from pointer.
953 * 953 *
954 * @param [in,out] value Source value object 954 * @param[in,out] value Source value object
955 * @param [in] ptr Pointer to specify the contents. 955 * @param[in] ptr Pointer to specify the contents.
956 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 956 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
957 * 957 *
958 * The pointer type is dependent on chosen value type. The list for 958 * The pointer type is dependent on chosen value type. The list for
@@ -1188,8 +1188,8 @@ struct _Eina_Value_Array
1188 1188
1189/** 1189/**
1190 * @brief Creates generic value storage of type array. 1190 * @brief Creates generic value storage of type array.
1191 * @param subtype How to manage this array members. 1191 * @param[in] subtype How to manage this array members.
1192 * @param step How to grow the members array. 1192 * @param[in] step How to grow the members array.
1193 * @return The new value or @c NULL on failure. 1193 * @return The new value or @c NULL on failure.
1194 * 1194 *
1195 * Create a new generic value storage of type array. The members are 1195 * Create a new generic value storage of type array. The members are
@@ -1208,9 +1208,9 @@ EAPI Eina_Value *eina_value_array_new(const Eina_Value_Type *subtype,
1208 1208
1209/** 1209/**
1210 * @brief Initializes generic value storage of type array. 1210 * @brief Initializes generic value storage of type array.
1211 * @param value Value object 1211 * @param[out] value Value object
1212 * @param subtype How to manage array members. 1212 * @param[in] subtype How to manage array members.
1213 * @param step How to grow the members array. 1213 * @param[in] step How to grow the members array.
1214 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1214 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1215 * 1215 *
1216 * Initializes new generic value storage of type array with the given 1216 * Initializes new generic value storage of type array with the given
@@ -1235,7 +1235,7 @@ static inline Eina_Bool eina_value_array_setup(Eina_Value *value,
1235 1235
1236/** 1236/**
1237 * @brief Queries number of elements in value of array type. 1237 * @brief Queries number of elements in value of array type.
1238 * @param value value object. 1238 * @param[in] value value object.
1239 * @return number of child elements. 1239 * @return number of child elements.
1240 * @since 1.2 1240 * @since 1.2
1241 */ 1241 */
@@ -1243,8 +1243,8 @@ static inline unsigned int eina_value_array_count(const Eina_Value *value);
1243 1243
1244/** 1244/**
1245 * @brief Removes element at given position in value of array type. 1245 * @brief Removes element at given position in value of array type.
1246 * @param value value object. 1246 * @param[in,out] value value object.
1247 * @param position index of the member 1247 * @param[in] position index of the member
1248 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1248 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1249 * @since 1.2 1249 * @since 1.2
1250 */ 1250 */
@@ -1253,8 +1253,8 @@ static inline Eina_Bool eina_value_array_remove(Eina_Value *value,
1253 1253
1254/** 1254/**
1255 * @brief Sets the generic value in an array member. 1255 * @brief Sets the generic value in an array member.
1256 * @param value Source value object 1256 * @param[in,out] value Source value object
1257 * @param position Index of the member 1257 * @param[in] position Index of the member
1258 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1258 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1259 * 1259 *
1260 * The variable argument is dependent on chosen subtype. The list for 1260 * The variable argument is dependent on chosen subtype. The list for
@@ -1312,8 +1312,8 @@ static inline Eina_Bool eina_value_array_set(Eina_Value *value,
1312 1312
1313/** 1313/**
1314 * @brief Gets the generic value from an array member. 1314 * @brief Gets the generic value from an array member.
1315 * @param value Source value object 1315 * @param[in] value Source value object
1316 * @param position Index of the member 1316 * @param[in] position Index of the member
1317 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1317 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1318 * 1318 *
1319 * The value is returned in the variable argument parameter, and the 1319 * The value is returned in the variable argument parameter, and the
@@ -1369,8 +1369,9 @@ static inline Eina_Bool eina_value_array_get(const Eina_Value *value,
1369 1369
1370/** 1370/**
1371 * @brief Inserts a generic value in an array member position. 1371 * @brief Inserts a generic value in an array member position.
1372 * @param value Source value object 1372 * @param[in] value Source value object
1373 * @param position Index of the member 1373 * @param[in] position Index of the member
1374 * @param[in] ... Variable arguments of data to insert
1374 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1375 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1375 * 1376 *
1376 * The variable argument is dependent on chosen subtype. The list for 1377 * The variable argument is dependent on chosen subtype. The list for
@@ -1429,7 +1430,8 @@ static inline Eina_Bool eina_value_array_insert(Eina_Value *value,
1429/** 1430/**
1430 * @brief Appends a generic value in an array. 1431 * @brief Appends a generic value in an array.
1431 * 1432 *
1432 * @param value Source value object 1433 * @param[in,out] value Source value object
1434 * @param[in] ... Variable arguments
1433 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1435 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1434 * 1436 *
1435 * The variable argument is dependent on chosen subtype. The list for 1437 * The variable argument is dependent on chosen subtype. The list for
@@ -1486,9 +1488,9 @@ static inline Eina_Bool eina_value_array_append(Eina_Value *value,
1486/** 1488/**
1487 * @brief Sets a generic value to an array member. 1489 * @brief Sets a generic value to an array member.
1488 * 1490 *
1489 * @param value Source value object 1491 * @param[in,out] value Source value object
1490 * @param position Index of the member 1492 * @param[in] position Index of the member
1491 * @param args Variable argument 1493 * @param[in] args Variable argument
1492 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1494 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1493 * 1495 *
1494 * @see eina_value_array_set() 1496 * @see eina_value_array_set()
@@ -1510,9 +1512,9 @@ static inline Eina_Bool eina_value_array_vset(Eina_Value *value,
1510/** 1512/**
1511 * @brief Gets the generic value from an array member. 1513 * @brief Gets the generic value from an array member.
1512 * 1514 *
1513 * @param value Source value object 1515 * @param[in] value Source value object
1514 * @param position Index of the member 1516 * @param[in] position Index of the member
1515 * @param args Variable argument 1517 * @param[out] args Variable argument
1516 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1518 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1517 * 1519 *
1518 * The value is returned in the variable argument parameter, the 1520 * The value is returned in the variable argument parameter, the
@@ -1532,9 +1534,9 @@ static inline Eina_Bool eina_value_array_vget(const Eina_Value *value,
1532/** 1534/**
1533 * @brief Inserts a generic value to an array member position. 1535 * @brief Inserts a generic value to an array member position.
1534 * 1536 *
1535 * @param value Source value object 1537 * @param[in,out] value Source value object
1536 * @param position Index of the member 1538 * @param[in] position Index of the member
1537 * @param args Variable argument 1539 * @param[in] args Variable argument
1538 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1540 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1539 * 1541 *
1540 * @see eina_value_array_set() 1542 * @see eina_value_array_set()
@@ -1556,8 +1558,8 @@ static inline Eina_Bool eina_value_array_vinsert(Eina_Value *value,
1556/** 1558/**
1557 * @brief Appends a generic value to an array. 1559 * @brief Appends a generic value to an array.
1558 * 1560 *
1559 * @param value Source value object 1561 * @param[in,out] value Source value object
1560 * @param args Variable argument 1562 * @param[in] args Variable argument
1561 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1563 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1562 * 1564 *
1563 * @see eina_value_array_set() 1565 * @see eina_value_array_set()
@@ -1579,9 +1581,9 @@ static inline Eina_Bool eina_value_array_vappend(Eina_Value *value,
1579/** 1581/**
1580 * @brief Sets a generic value to an array member from a pointer. 1582 * @brief Sets a generic value to an array member from a pointer.
1581 * 1583 *
1582 * @param value Source value object 1584 * @param[in,out] value Source value object
1583 * @param position Index of the member 1585 * @param[in] position Index of the member
1584 * @param ptr Pointer to specify the contents. 1586 * @param[in] ptr Pointer to specify the contents.
1585 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1587 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1586 * 1588 *
1587 * The pointer type is dependent on chosen value type. The list for 1589 * The pointer type is dependent on chosen value type. The list for
@@ -1643,9 +1645,9 @@ static inline Eina_Bool eina_value_array_pset(Eina_Value *value,
1643/** 1645/**
1644 * @brief Retrieves a generic value into a pointer from an array member. 1646 * @brief Retrieves a generic value into a pointer from an array member.
1645 * 1647 *
1646 * @param value Source value object 1648 * @param[in] value Source value object
1647 * @param position Index of the member 1649 * @param[in] position Index of the member
1648 * @param ptr Pointer to receive the contents. 1650 * @param[out] ptr Pointer to receive the contents.
1649 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1651 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1650 * 1652 *
1651 * The value is returned in pointer contents, the actual value is 1653 * The value is returned in pointer contents, the actual value is
@@ -1702,9 +1704,9 @@ static inline Eina_Bool eina_value_array_pget(const Eina_Value *value,
1702/** 1704/**
1703 * @brief Inserts a generic value to an array member position from a pointer. 1705 * @brief Inserts a generic value to an array member position from a pointer.
1704 * 1706 *
1705 * @param value Source value object 1707 * @param[in,out] value Source value object
1706 * @param position Index of the member 1708 * @param[in] position Index of the member
1707 * @param ptr Pointer to specify the contents. 1709 * @param[in] ptr Pointer to specify the contents.
1708 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1710 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1709 * 1711 *
1710 * The pointer type is dependent on chosen value type. The list for 1712 * The pointer type is dependent on chosen value type. The list for
@@ -1764,8 +1766,9 @@ static inline Eina_Bool eina_value_array_pinsert(Eina_Value *value,
1764 1766
1765/** 1767/**
1766 * @brief Appends a generic value to an array from a pointer. 1768 * @brief Appends a generic value to an array from a pointer.
1767 * @param value Source value object 1769 *
1768 * @param ptr Pointer to specify the contents. 1770 * @param[in,out] value Source value object
1771 * @param[in] ptr Pointer to specify the contents.
1769 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1772 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1770 * 1773 *
1771 * The pointer type is dependent on chosen value type. The list for 1774 * The pointer type is dependent on chosen value type. The list for
@@ -1825,9 +1828,9 @@ static inline Eina_Bool eina_value_array_pappend(Eina_Value *value,
1825/** 1828/**
1826 * @brief Retrieves a value from the array as an Eina_Value copy. 1829 * @brief Retrieves a value from the array as an Eina_Value copy.
1827 * 1830 *
1828 * @param src Source value object 1831 * @param[in] src Source value object
1829 * @param position Index of the member 1832 * @param[in] position Index of the member
1830 * @param dst Where to return the array member 1833 * @param[out] dst Where to return the array member
1831 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1834 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1832 * 1835 *
1833 * The argument @a dst is considered uninitialized and it's set to 1836 * The argument @a dst is considered uninitialized and it's set to
@@ -1844,10 +1847,10 @@ static inline Eina_Bool eina_value_array_value_get(const Eina_Value *src,
1844 * @brief Definition for the macro to iterate over an array contained in an Eina_Value. 1847 * @brief Definition for the macro to iterate over an array contained in an Eina_Value.
1845 * @since 1.21 1848 * @since 1.21
1846 * 1849 *
1847 * @param array The list to iterate over. 1850 * @param[in] array The list to iterate over.
1848 * @param length Contain the length of the array 1851 * @param[in] length Contain the length of the array
1849 * @param it Contain the current position walked over 1852 * @param[out] it Contain the current position walked over
1850 * @param value Contain the value at the current position. 1853 * @param[out] value Contain the value at the current position.
1851 * 1854 *
1852 * This macro iterates over @p array from the first element to 1855 * This macro iterates over @p array from the first element to
1853 * the last. @p value is the data related to the current element. 1856 * the last. @p value is the data related to the current element.
@@ -1916,7 +1919,7 @@ struct _Eina_Value_List
1916/** 1919/**
1917 * @brief Creates generic value storage of type list. 1920 * @brief Creates generic value storage of type list.
1918 * 1921 *
1919 * @param subtype How to manage this list members. 1922 * @param[in] subtype How to manage this list members.
1920 * @return The new value, or @c NULL on failure. 1923 * @return The new value, or @c NULL on failure.
1921 * 1924 *
1922 * Create a new generic value storage of type list. The members are 1925 * Create a new generic value storage of type list. The members are
@@ -1937,8 +1940,8 @@ EAPI Eina_Value *eina_value_list_new(const Eina_Value_Type *subtype) EINA_ARG_NO
1937/** 1940/**
1938 * @brief Initializes generic value storage of type list. 1941 * @brief Initializes generic value storage of type list.
1939 * 1942 *
1940 * @param value Value object 1943 * @param[out] value Value object
1941 * @param subtype How to manage this list members. 1944 * @param[in] subtype How to manage this list members.
1942 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1945 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1943 * 1946 *
1944 * Initializes new generic value storage of type list with the given 1947 * Initializes new generic value storage of type list with the given
@@ -1963,7 +1966,7 @@ static inline Eina_Bool eina_value_list_setup(Eina_Value *value,
1963/** 1966/**
1964 * @brief Queries number of elements in value of list type. 1967 * @brief Queries number of elements in value of list type.
1965 * 1968 *
1966 * @param value value object. 1969 * @param[in]value value object.
1967 * @return number of child elements. 1970 * @return number of child elements.
1968 * 1971 *
1969 * @since 1.2 1972 * @since 1.2
@@ -1973,8 +1976,8 @@ static inline unsigned int eina_value_list_count(const Eina_Value *value);
1973/** 1976/**
1974 * @brief Removes element at given position in value of list type. 1977 * @brief Removes element at given position in value of list type.
1975 * 1978 *
1976 * @param value value object. 1979 * @param[in,out] value value object.
1977 * @param position index of the member 1980 * @param[in] position index of the member
1978 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1981 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1979 * 1982 *
1980 * @since 1.2 1983 * @since 1.2
@@ -1985,8 +1988,8 @@ static inline Eina_Bool eina_value_list_remove(Eina_Value *value,
1985/** 1988/**
1986 * @brief Sets the generic value in a list member. 1989 * @brief Sets the generic value in a list member.
1987 * 1990 *
1988 * @param value Source value object 1991 * @param[in,out] value Source value object
1989 * @param position Index of the member 1992 * @param[in] position Index of the member
1990 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 1993 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
1991 * 1994 *
1992 * The variable argument is dependent on chosen subtype. The list for 1995 * The variable argument is dependent on chosen subtype. The list for
@@ -2044,8 +2047,8 @@ static inline Eina_Bool eina_value_list_set(Eina_Value *value,
2044/** 2047/**
2045 * @brief Gets the generic value from a list member. 2048 * @brief Gets the generic value from a list member.
2046 * 2049 *
2047 * @param value Source value object 2050 * @param[in] value Source value object
2048 * @param position Index of the member 2051 * @param[in] position Index of the member
2049 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2052 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2050 * 2053 *
2051 * The value is returned in the variable argument parameter, the 2054 * The value is returned in the variable argument parameter, the
@@ -2101,8 +2104,8 @@ static inline Eina_Bool eina_value_list_get(const Eina_Value *value,
2101/** 2104/**
2102 * @brief Inserts the generic value in a list member position. 2105 * @brief Inserts the generic value in a list member position.
2103 * 2106 *
2104 * @param value Source value object 2107 * @param[in,out] value Source value object
2105 * @param position Index of the member 2108 * @param[in] position Index of the member
2106 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2109 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2107 * 2110 *
2108 * The variable argument is dependent on chosen subtype. The list for 2111 * The variable argument is dependent on chosen subtype. The list for
@@ -2160,7 +2163,8 @@ static inline Eina_Bool eina_value_list_insert(Eina_Value *value,
2160/** 2163/**
2161 * @brief Appends the generic value in a list. 2164 * @brief Appends the generic value in a list.
2162 * 2165 *
2163 * @param value Source value object 2166 * @param[in,out] value Source value object
2167 * @param[in] ... Variable arguments
2164 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2168 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2165 * 2169 *
2166 * The variable argument is dependent on chosen subtype. The list for 2170 * The variable argument is dependent on chosen subtype. The list for
@@ -2216,9 +2220,9 @@ static inline Eina_Bool eina_value_list_append(Eina_Value *value,
2216/** 2220/**
2217 * @brief Sets the generic value in a list member. 2221 * @brief Sets the generic value in a list member.
2218 * 2222 *
2219 * @param value Source value object 2223 * @param[in,out] value Source value object
2220 * @param position Index of the member 2224 * @param[in] position Index of the member
2221 * @param args Variable argument 2225 * @param[in] args Variable argument
2222 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2226 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2223 * 2227 *
2224 * @see eina_value_list_set() 2228 * @see eina_value_list_set()
@@ -2240,9 +2244,9 @@ static inline Eina_Bool eina_value_list_vset(Eina_Value *value,
2240/** 2244/**
2241 * @brief Gets the generic value from a list member. 2245 * @brief Gets the generic value from a list member.
2242 * 2246 *
2243 * @param value Source value object 2247 * @param[in] value Source value object
2244 * @param position Index of the member 2248 * @param[in] position Index of the member
2245 * @param args Variable argument 2249 * @param[in] args Variable argument
2246 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2250 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2247 * 2251 *
2248 * The value is returned in the variable argument parameter, the 2252 * The value is returned in the variable argument parameter, the
@@ -2262,9 +2266,9 @@ static inline Eina_Bool eina_value_list_vget(const Eina_Value *value,
2262/** 2266/**
2263 * @brief Inserts the generic value in a list member position. 2267 * @brief Inserts the generic value in a list member position.
2264 * 2268 *
2265 * @param value Source value object 2269 * @param[in,out] value Source value object
2266 * @param position Index of the member 2270 * @param[in] position Index of the member
2267 * @param args Variable argument 2271 * @param[in] args Variable argument
2268 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2272 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2269 * 2273 *
2270 * @see eina_value_list_set() 2274 * @see eina_value_list_set()
@@ -2286,8 +2290,8 @@ static inline Eina_Bool eina_value_list_vinsert(Eina_Value *value,
2286/** 2290/**
2287 * @brief Appends the generic value in a list. 2291 * @brief Appends the generic value in a list.
2288 * 2292 *
2289 * @param value Source value object 2293 * @param[in,out] value Source value object
2290 * @param args Variable argument 2294 * @param[in] args Variable argument
2291 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2295 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2292 * 2296 *
2293 * @see eina_value_list_set() 2297 * @see eina_value_list_set()
@@ -2309,9 +2313,9 @@ static inline Eina_Bool eina_value_list_vappend(Eina_Value *value,
2309/** 2313/**
2310 * @brief Sets the generic value in a list member from pointer. 2314 * @brief Sets the generic value in a list member from pointer.
2311 * 2315 *
2312 * @param value Source value object 2316 * @param[in,out] value Source value object
2313 * @param position Index of the member 2317 * @param[in] position Index of the member
2314 * @param ptr Pointer to specify the contents. 2318 * @param[in] ptr Pointer to specify the contents.
2315 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2319 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2316 * 2320 *
2317 * The pointer type is dependent on chosen value type. The list for 2321 * The pointer type is dependent on chosen value type. The list for
@@ -2372,9 +2376,9 @@ static inline Eina_Bool eina_value_list_pset(Eina_Value *value,
2372/** 2376/**
2373 * @brief Gets the generic value to pointer from a list member. 2377 * @brief Gets the generic value to pointer from a list member.
2374 * 2378 *
2375 * @param value Source value object 2379 * @param[in] value Source value object
2376 * @param position Index of the member 2380 * @param[in] position Index of the member
2377 * @param ptr Pointer to receive the contents. 2381 * @param[out] ptr Pointer to receive the contents.
2378 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2382 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2379 * 2383 *
2380 * The value is returned in pointer contents, the actual value is 2384 * The value is returned in pointer contents, the actual value is
@@ -2430,9 +2434,9 @@ static inline Eina_Bool eina_value_list_pget(const Eina_Value *value,
2430/** 2434/**
2431 * @brief Inserts the generic value in a list member position from pointer. 2435 * @brief Inserts the generic value in a list member position from pointer.
2432 * 2436 *
2433 * @param value Source value object 2437 * @param[in,out] value Source value object
2434 * @param position Index of the member 2438 * @param[in] position Index of the member
2435 * @param ptr Pointer to specify the contents. 2439 * @param[in] ptr Pointer to specify the contents.
2436 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2440 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2437 * 2441 *
2438 * The pointer type is dependent on chosen value type. The list for 2442 * The pointer type is dependent on chosen value type. The list for
@@ -2492,8 +2496,8 @@ static inline Eina_Bool eina_value_list_pinsert(Eina_Value *value,
2492/** 2496/**
2493 * @brief Appends the generic value in a list from pointer. 2497 * @brief Appends the generic value in a list from pointer.
2494 * 2498 *
2495 * @param value Source value object 2499 * @param[in,out] value Source value object
2496 * @param ptr Pointer to specify the contents. 2500 * @param[in] ptr Pointer to specify the contents.
2497 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2501 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2498 * 2502 *
2499 * The pointer type is dependent on chosen value type. The list for 2503 * The pointer type is dependent on chosen value type. The list for
@@ -2583,8 +2587,8 @@ struct _Eina_Value_Hash
2583/** 2587/**
2584 * @brief Creates generic value storage of type hash. 2588 * @brief Creates generic value storage of type hash.
2585 * 2589 *
2586 * @param subtype How to manage this hash members. 2590 * @param[in] subtype How to manage this hash members.
2587 * @param buckets_power_size How to allocate hash buckets (2 ^ 2591 * @param[in] buckets_power_size How to allocate hash buckets (2 ^
2588 * buckets_power_size), if zero then a sane value is chosen. 2592 * buckets_power_size), if zero then a sane value is chosen.
2589 * @return The new value, or @c NULL on failure. 2593 * @return The new value, or @c NULL on failure.
2590 * 2594 *
@@ -2606,9 +2610,9 @@ EAPI Eina_Value *eina_value_hash_new(const Eina_Value_Type *subtype, unsigned in
2606/** 2610/**
2607 * @brief Initializes generic value storage of type hash. 2611 * @brief Initializes generic value storage of type hash.
2608 * 2612 *
2609 * @param value Value object 2613 * @param[in] value Value object
2610 * @param subtype How to manage this hash members. 2614 * @param[in] subtype How to manage this hash members.
2611 * @param buckets_power_size How to allocate hash buckets (2 ^ 2615 * @param[in] buckets_power_size How to allocate hash buckets (2 ^
2612 * buckets_power_size), if zero then a sane value is chosen. 2616 * buckets_power_size), if zero then a sane value is chosen.
2613 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2617 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2614 * 2618 *
@@ -2635,7 +2639,7 @@ static inline Eina_Bool eina_value_hash_setup(Eina_Value *value,
2635/** 2639/**
2636 * @brief Queries number of elements in value of hash type. 2640 * @brief Queries number of elements in value of hash type.
2637 * 2641 *
2638 * @param value value object. 2642 * @param[in] value value object.
2639 * @return number of child elements. 2643 * @return number of child elements.
2640 * 2644 *
2641 * @since 1.2 2645 * @since 1.2
@@ -2645,8 +2649,8 @@ static inline unsigned int eina_value_hash_population(const Eina_Value *value);
2645/** 2649/**
2646 * @brief Removes element at given position in value of hash type. 2650 * @brief Removes element at given position in value of hash type.
2647 * 2651 *
2648 * @param value value object. 2652 * @param[in,out] value value object.
2649 * @param key key to find the member 2653 * @param[in] key key to find the member
2650 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2654 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2651 * 2655 *
2652 * @since 1.2 2656 * @since 1.2
@@ -2657,8 +2661,9 @@ static inline Eina_Bool eina_value_hash_del(Eina_Value *value,
2657/** 2661/**
2658 * @brief Sets the generic value in an hash member. 2662 * @brief Sets the generic value in an hash member.
2659 * 2663 *
2660 * @param value Source value object 2664 * @param[in,out] value Source value object
2661 * @param key Key to find the member 2665 * @param[in] key Key to find the member
2666 * @param[in] ... Variable arguments of data to set
2662 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2667 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2663 * 2668 *
2664 * The variable argument is dependent on chosen subtype. The list for 2669 * The variable argument is dependent on chosen subtype. The list for
@@ -2709,8 +2714,9 @@ static inline Eina_Bool eina_value_hash_set(Eina_Value *value,
2709/** 2714/**
2710 * @brief Gets the generic value from an hash member. 2715 * @brief Gets the generic value from an hash member.
2711 * 2716 *
2712 * @param value Source value object 2717 * @param[in] value Source value object
2713 * @param key Key to find the member 2718 * @param[in] key Key to find the member
2719 * @param[out] ...
2714 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2720 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2715 * 2721 *
2716 * The value is returned in the variable argument parameter, the 2722 * The value is returned in the variable argument parameter, the
@@ -2765,9 +2771,9 @@ static inline Eina_Bool eina_value_hash_get(const Eina_Value *value,
2765/** 2771/**
2766 * @brief Sets the generic value in an hash member. 2772 * @brief Sets the generic value in an hash member.
2767 * 2773 *
2768 * @param value Source value object 2774 * @param[in,out] value Source value object
2769 * @param key Key to find the member 2775 * @param[in] key Key to find the member
2770 * @param args Variable argument 2776 * @param[in] args Variable argument
2771 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2777 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2772 * 2778 *
2773 * @see eina_value_hash_set() 2779 * @see eina_value_hash_set()
@@ -2783,9 +2789,9 @@ static inline Eina_Bool eina_value_hash_vset(Eina_Value *value,
2783/** 2789/**
2784 * @brief Gets the generic value from an hash member. 2790 * @brief Gets the generic value from an hash member.
2785 * 2791 *
2786 * @param value Source value object 2792 * @param[in] value Source value object
2787 * @param key Key to find the member 2793 * @param[in] key Key to find the member
2788 * @param args Variable argument 2794 * @param[out] args Variable argument
2789 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2795 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2790 * 2796 *
2791 * The value is returned in the variable argument parameter, the 2797 * The value is returned in the variable argument parameter, the
@@ -2806,9 +2812,9 @@ static inline Eina_Bool eina_value_hash_vget(const Eina_Value *value,
2806/** 2812/**
2807 * @brief Sets the generic value in an hash member from pointer. 2813 * @brief Sets the generic value in an hash member from pointer.
2808 * 2814 *
2809 * @param value Source value object 2815 * @param[in,out] value Source value object
2810 * @param key Key to find the member 2816 * @param[in] key Key to find the member
2811 * @param ptr Pointer to specify the contents. 2817 * @param[in] ptr Pointer to specify the contents.
2812 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2818 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2813 * 2819 *
2814 * The pointer type is dependent on chosen value type. The list for 2820 * The pointer type is dependent on chosen value type. The list for
@@ -2861,9 +2867,9 @@ static inline Eina_Bool eina_value_hash_pset(Eina_Value *value,
2861/** 2867/**
2862 * @brief Gets the generic value to pointer from an hash member. 2868 * @brief Gets the generic value to pointer from an hash member.
2863 * 2869 *
2864 * @param value Source value object 2870 * @param[in] value Source value object
2865 * @param key Key to find the member 2871 * @param[in] key Key to find the member
2866 * @param ptr Pointer to receive the contents. 2872 * @param[out] ptr Pointer to receive the contents.
2867 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 2873 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
2868 * 2874 *
2869 * The value is returned in pointer contents, the actual value is 2875 * The value is returned in pointer contents, the actual value is
@@ -3201,7 +3207,7 @@ struct _Eina_Value_Struct
3201/** 3207/**
3202 * @brief Creates generic value storage of type struct. 3208 * @brief Creates generic value storage of type struct.
3203 * 3209 *
3204 * @param desc How to manage this struct members. 3210 * @param[in] desc How to manage this struct members.
3205 * @return The new value, or @c NULL on failure. 3211 * @return The new value, or @c NULL on failure.
3206 * 3212 *
3207 * Create a new generic value storage of type struct. The members are 3213 * Create a new generic value storage of type struct. The members are
@@ -3222,8 +3228,8 @@ EAPI Eina_Value *eina_value_struct_new(const Eina_Value_Struct_Desc *desc) EINA_
3222/** 3228/**
3223 * @brief Initializes generic value storage of type struct. 3229 * @brief Initializes generic value storage of type struct.
3224 * 3230 *
3225 * @param value Value object 3231 * @param[out] value Value object
3226 * @param desc How to manage this struct members. 3232 * @param[in] desc How to manage this struct members.
3227 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3233 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3228 * 3234 *
3229 * Initializes new generic value storage of type struct with the given 3235 * Initializes new generic value storage of type struct with the given
@@ -3248,7 +3254,7 @@ static inline Eina_Bool eina_value_struct_setup(Eina_Value *value,
3248/** 3254/**
3249 * @brief Checks for a struct and get its description. 3255 * @brief Checks for a struct and get its description.
3250 * 3256 *
3251 * @param value Value object 3257 * @param[in] value Value object
3252 * @return structure description, with all members and size. 3258 * @return structure description, with all members and size.
3253 * on failure, #NULL is returned. 3259 * on failure, #NULL is returned.
3254 * 3260 *
@@ -3259,8 +3265,9 @@ static inline const Eina_Value_Struct_Desc *eina_value_struct_desc_get(const Ein
3259/** 3265/**
3260 * @brief Sets the generic value in a struct member. 3266 * @brief Sets the generic value in a struct member.
3261 * 3267 *
3262 * @param value Source value object 3268 * @param[in,out] value Source value object
3263 * @param name Name to find the member 3269 * @param[in] name Name to find the member
3270 * @param[in] ... Variable arguments
3264 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3271 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3265 * 3272 *
3266 * The variable argument is dependent on chosen member type. The list 3273 * The variable argument is dependent on chosen member type. The list
@@ -3326,8 +3333,9 @@ static inline Eina_Bool eina_value_struct_set(Eina_Value *value,
3326/** 3333/**
3327 * @brief Gets the generic value from a struct member. 3334 * @brief Gets the generic value from a struct member.
3328 * 3335 *
3329 * @param value Source value object 3336 * @param[in] value Source value object
3330 * @param name Name to find the member 3337 * @param[in] name Name to find the member
3338 * @param[out] ... Variable arguments
3331 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3339 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3332 * 3340 *
3333 * The value is returned in the variable argument parameter, the 3341 * The value is returned in the variable argument parameter, the
@@ -3398,9 +3406,9 @@ static inline Eina_Bool eina_value_struct_get(const Eina_Value *value,
3398/** 3406/**
3399 * @brief Sets the generic value in a struct member. 3407 * @brief Sets the generic value in a struct member.
3400 * 3408 *
3401 * @param value Source value object 3409 * @param[in,out] value Source value object
3402 * @param name Name to find the member 3410 * @param[in] name Name to find the member
3403 * @param args Variable argument 3411 * @param[in] args Variable argument
3404 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3412 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3405 * 3413 *
3406 * @see eina_value_struct_set() 3414 * @see eina_value_struct_set()
@@ -3416,9 +3424,9 @@ static inline Eina_Bool eina_value_struct_vset(Eina_Value *value,
3416/** 3424/**
3417 * @brief Gets the generic value from a struct member. 3425 * @brief Gets the generic value from a struct member.
3418 * 3426 *
3419 * @param value Source value object 3427 * @param[in] value Source value object
3420 * @param name Name to find the member 3428 * @param[in] name Name to find the member
3421 * @param args Variable argument 3429 * @param[in,out] args Variable argument
3422 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3430 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3423 * 3431 *
3424 * The value is returned in the variable argument parameter, the 3432 * The value is returned in the variable argument parameter, the
@@ -3439,9 +3447,9 @@ static inline Eina_Bool eina_value_struct_vget(const Eina_Value *value,
3439/** 3447/**
3440 * @brief Sets the generic value in a struct member from pointer. 3448 * @brief Sets the generic value in a struct member from pointer.
3441 * 3449 *
3442 * @param value Source value object 3450 * @param[in,out] value Source value object
3443 * @param name Name to find the member 3451 * @param[in] name Name to find the member
3444 * @param ptr Pointer to specify the contents. 3452 * @param[in] ptr Pointer to specify the contents.
3445 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3453 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3446 * 3454 *
3447 * The pointer type is dependent on chosen value type. The list for 3455 * The pointer type is dependent on chosen value type. The list for
@@ -3510,9 +3518,9 @@ static inline Eina_Bool eina_value_struct_pset(Eina_Value *value,
3510/** 3518/**
3511 * @brief Gets the generic value to pointer from a struct member. 3519 * @brief Gets the generic value to pointer from a struct member.
3512 * 3520 *
3513 * @param value Source value object 3521 * @param[in] value Source value object
3514 * @param name Name to find the member 3522 * @param[in] name Name to find the member
3515 * @param ptr Pointer to receive the contents. 3523 * @param[out] ptr Pointer to receive the contents.
3516 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3524 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3517 * 3525 *
3518 * The value is returned in pointer contents, the actual value is 3526 * The value is returned in pointer contents, the actual value is
@@ -3583,9 +3591,9 @@ static inline Eina_Bool eina_value_struct_pget(const Eina_Value *value,
3583/** 3591/**
3584 * @brief Gets the member as Eina_Value copy 3592 * @brief Gets the member as Eina_Value copy
3585 * 3593 *
3586 * @param src Source value object 3594 * @param[in] src Source value object
3587 * @param name Name to find the member 3595 * @param[in] name Name to find the member
3588 * @param dst Where to return the member value. 3596 * @param[out] dst Where to return the member value.
3589 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3597 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3590 * 3598 *
3591 * The argument @a dst is considered uninitialized and it's setup to 3599 * The argument @a dst is considered uninitialized and it's setup to
@@ -3600,9 +3608,9 @@ static inline Eina_Bool eina_value_struct_value_get(const Eina_Value *src,
3600/** 3608/**
3601 * @brief Sets the member from Eina_Value source. 3609 * @brief Sets the member from Eina_Value source.
3602 * 3610 *
3603 * @param dst destination value object 3611 * @param[in,out] dst destination value object
3604 * @param name name to find the member 3612 * @param[in] name name to find the member
3605 * @param src source value 3613 * @param[in] src source value
3606 * @return #EINA_TRUE on success, #EINA_FALSE on failure. 3614 * @return #EINA_TRUE on success, #EINA_FALSE on failure.
3607 * 3615 *
3608 * @since 1.2 3616 * @since 1.2
@@ -3614,9 +3622,9 @@ static inline Eina_Bool eina_value_struct_value_set(Eina_Value *dst,
3614/** 3622/**
3615 * @brief Gets the member as Eina_Value copy given its member description. 3623 * @brief Gets the member as Eina_Value copy given its member description.
3616 * 3624 *
3617 * @param src Source value object 3625 * @param[in] src Source value object
3618 * @param member The member description to use 3626 * @param[in] member The member description to use
3619 * @param dst Where to return the member value. 3627 * @param[out] dst Where to return the member value.
3620 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3628 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3621 * 3629 *
3622 * The argument @a dst is considered uninitialized and it's setup to 3630 * The argument @a dst is considered uninitialized and it's setup to
@@ -3631,9 +3639,9 @@ static inline Eina_Bool eina_value_struct_member_value_get(const Eina_Value *src
3631/** 3639/**
3632 * @brief Sets the member from Eina_Value source. 3640 * @brief Sets the member from Eina_Value source.
3633 * 3641 *
3634 * @param dst destination value object 3642 * @param[out] dst destination value object
3635 * @param member the member description to use 3643 * @param[in] member the member description to use
3636 * @param src source value 3644 * @param[in] src source value
3637 * @return #EINA_TRUE on success, #EINA_FALSE on failure. 3645 * @return #EINA_TRUE on success, #EINA_FALSE on failure.
3638 * 3646 *
3639 * @since 1.2 3647 * @since 1.2
@@ -3685,7 +3693,7 @@ struct _Eina_Value_Type
3685/** 3693/**
3686 * @brief Queries type name. 3694 * @brief Queries type name.
3687 * 3695 *
3688 * @param type type reference. 3696 * @param[in] type type reference.
3689 * @return string or @c NULL if type is invalid. 3697 * @return string or @c NULL if type is invalid.
3690 * 3698 *
3691 * @since 1.2 3699 * @since 1.2
@@ -3695,7 +3703,7 @@ EAPI const char *eina_value_type_name_get(const Eina_Value_Type *type) EINA_PURE
3695/** 3703/**
3696 * @brief Checks if type is valid. 3704 * @brief Checks if type is valid.
3697 * 3705 *
3698 * @param type Type reference. 3706 * @param[in] type Type reference.
3699 * @return #EINA_TRUE if valid, #EINA_FALSE otherwise. 3707 * @return #EINA_TRUE if valid, #EINA_FALSE otherwise.
3700 * 3708 *
3701 * A type is invalid if it's NULL or if version field is not the same 3709 * A type is invalid if it's NULL or if version field is not the same
@@ -3708,8 +3716,8 @@ EAPI Eina_Bool eina_value_type_check(const Eina_Value_Type *type) EINA_PURE EINA
3708/** 3716/**
3709 * @brief Initializes memory using type descriptor. 3717 * @brief Initializes memory using type descriptor.
3710 * 3718 *
3711 * @param type type reference. 3719 * @param[in] type type reference.
3712 * @param mem memory to operate, must be of size @c type->value_size. 3720 * @param[out] mem memory to operate, must be of size @c type->value_size.
3713 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3721 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3714 * 3722 *
3715 * @since 1.2 3723 * @since 1.2
@@ -3719,8 +3727,8 @@ static inline Eina_Bool eina_value_type_setup(const Eina_Value_Type *type, void
3719/** 3727/**
3720 * @brief Flushes (clears) memory using type descriptor. 3728 * @brief Flushes (clears) memory using type descriptor.
3721 * 3729 *
3722 * @param type type reference. 3730 * @param[in] type type reference.
3723 * @param mem memory to operate, must be of size @c type->value_size. 3731 * @param[out] mem memory to operate, must be of size @c type->value_size.
3724 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3732 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3725 * 3733 *
3726 * @since 1.2 3734 * @since 1.2
@@ -3730,9 +3738,9 @@ static inline Eina_Bool eina_value_type_flush(const Eina_Value_Type *type, void
3730/** 3738/**
3731 * @brief Copies memory using type descriptor. 3739 * @brief Copies memory using type descriptor.
3732 * 3740 *
3733 * @param type type reference. 3741 * @param[in] type type reference.
3734 * @param src memory to operate, must be of size @c type->value_size. 3742 * @param[in] src memory to operate, must be of size @c type->value_size.
3735 * @param dst memory to operate, must be of size @c type->value_size. 3743 * @param[out] dst memory to operate, must be of size @c type->value_size.
3736 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3744 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3737 * 3745 *
3738 * @since 1.2 3746 * @since 1.2
@@ -3742,9 +3750,9 @@ static inline Eina_Bool eina_value_type_copy(const Eina_Value_Type *type, const
3742/** 3750/**
3743 * @brief Compares memory using type descriptor. 3751 * @brief Compares memory using type descriptor.
3744 * 3752 *
3745 * @param type type reference. 3753 * @param[in] type type reference.
3746 * @param a memory to operate, must be of size @c type->value_size. 3754 * @param[in] a memory to operate, must be of size @c type->value_size.
3747 * @param b memory to operate, must be of size @c type->value_size. 3755 * @param[in] b memory to operate, must be of size @c type->value_size.
3748 * @return less than zero if a < b, greater than zero if a > b, zero if equal. 3756 * @return less than zero if a < b, greater than zero if a > b, zero if equal.
3749 * 3757 *
3750 * @since 1.2 3758 * @since 1.2
@@ -3754,10 +3762,10 @@ static inline int eina_value_type_compare(const Eina_Value_Type *type, const voi
3754/** 3762/**
3755 * @brief Converts memory using type descriptor. 3763 * @brief Converts memory using type descriptor.
3756 * 3764 *
3757 * @param type type reference of the source. 3765 * @param[in] type type reference of the source.
3758 * @param convert type reference of the destination. 3766 * @param[in] convert type reference of the destination.
3759 * @param type_mem memory to operate, must be of size @c type->value_size. 3767 * @param[in] type_mem memory to operate, must be of size @c type->value_size.
3760 * @param convert_mem memory to operate, must be of size @c convert->value_size. 3768 * @param[out] convert_mem memory to operate, must be of size @c convert->value_size.
3761 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3769 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3762 * 3770 *
3763 * @since 1.2 3771 * @since 1.2
@@ -3767,10 +3775,10 @@ static inline Eina_Bool eina_value_type_convert_to(const Eina_Value_Type *type,
3767/** 3775/**
3768 * @brief Converts memory using type descriptor. 3776 * @brief Converts memory using type descriptor.
3769 * 3777 *
3770 * @param type type reference of the destination. 3778 * @param[in] type type reference of the destination.
3771 * @param convert type reference of the source. 3779 * @param[in] convert type reference of the source.
3772 * @param type_mem memory to operate, must be of size @c type->value_size. 3780 * @param[out] type_mem memory to operate, must be of size @c type->value_size.
3773 * @param convert_mem memory to operate, must be of size @c convert->value_size. 3781 * @param[in] convert_mem memory to operate, must be of size @c convert->value_size.
3774 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3782 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3775 * 3783 *
3776 * @since 1.2 3784 * @since 1.2
@@ -3780,9 +3788,9 @@ static inline Eina_Bool eina_value_type_convert_from(const Eina_Value_Type *type
3780/** 3788/**
3781 * @brief Sets memory using type descriptor and variable argument. 3789 * @brief Sets memory using type descriptor and variable argument.
3782 * 3790 *
3783 * @param type type reference of the source. 3791 * @param[in] type type reference of the source.
3784 * @param mem memory to operate, must be of size @c type->value_size. 3792 * @param[out] mem memory to operate, must be of size @c type->value_size.
3785 * @param args input value. 3793 * @param[in] args input value.
3786 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3794 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3787 * 3795 *
3788 * @since 1.2 3796 * @since 1.2
@@ -3792,9 +3800,9 @@ static inline Eina_Bool eina_value_type_vset(const Eina_Value_Type *type, void *
3792/** 3800/**
3793 * @brief Sets memory using type descriptor and pointer. 3801 * @brief Sets memory using type descriptor and pointer.
3794 * 3802 *
3795 * @param type type reference of the source. 3803 * @param[in] type type reference of the source.
3796 * @param mem memory to operate, must be of size @c type->value_size. 3804 * @param[out] mem memory to operate, must be of size @c type->value_size.
3797 * @param ptr pointer to input value. 3805 * @param[in] ptr pointer to input value.
3798 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3806 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3799 * 3807 *
3800 * @since 1.2 3808 * @since 1.2
@@ -3804,9 +3812,9 @@ static inline Eina_Bool eina_value_type_pset(const Eina_Value_Type *type, void *
3804/** 3812/**
3805 * @brief Gets memory using type descriptor. 3813 * @brief Gets memory using type descriptor.
3806 * 3814 *
3807 * @param type type reference of the source. 3815 * @param[in] type type reference of the source.
3808 * @param mem memory to operate, must be of size @c type->value_size. 3816 * @param[in] mem memory to operate, must be of size @c type->value_size.
3809 * @param ptr pointer to output. 3817 * @param[out] ptr pointer to output.
3810 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3818 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3811 * 3819 *
3812 * @since 1.2 3820 * @since 1.2
@@ -3850,8 +3858,8 @@ static inline Eina_Value *eina_value_optional_empty_new(void);
3850/** 3858/**
3851 * @brief Creates an optional eina value with the passed value 3859 * @brief Creates an optional eina value with the passed value
3852 * 3860 *
3853 * @param subtype Eina_Value_Type of parameter value 3861 * @param[in] subtype Eina_Value_Type of parameter value
3854 * @param value The value to be used to construct optional eina value 3862 * @param[in] value The value to be used to construct optional eina value
3855 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3863 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3856 * 3864 *
3857 * @since 1.17 3865 * @since 1.17
@@ -3862,8 +3870,8 @@ EAPI Eina_Value *eina_value_optional_new(const Eina_Value_Type *subtype,
3862/** 3870/**
3863 * @brief Function to know if an eina optional is empty or not 3871 * @brief Function to know if an eina optional is empty or not
3864 * 3872 *
3865 * @param value Eina Value Optional 3873 * @param[in] value Eina Value Optional
3866 * @param is_empty #EINA_TRUE if optional is empty, #EINA_FALSE otherwise. 3874 * @param[out] is_empty #EINA_TRUE if optional is empty, #EINA_FALSE otherwise.
3867 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3875 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3868 * 3876 *
3869 * @since 1.17 3877 * @since 1.17
@@ -3874,9 +3882,9 @@ static inline Eina_Bool eina_value_optional_empty_is(const Eina_Value *value,
3874/** 3882/**
3875 * @brief Sets the optional with a value 3883 * @brief Sets the optional with a value
3876 * 3884 *
3877 * @param value Eina Value Optional to be set with subvalue 3885 * @param[in,out] value Eina Value Optional to be set with subvalue
3878 * @param subtype Type of subvalue 3886 * @param[in] subtype Type of subvalue
3879 * @param subvalue Value to be set in optional 3887 * @param[in] subvalue Value to be set in optional
3880 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3888 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3881 * 3889 *
3882 * @since 1.17 3890 * @since 1.17
@@ -3888,8 +3896,8 @@ EAPI Eina_Bool eina_value_optional_pset(Eina_Value *value,
3888/** 3896/**
3889 * @brief Gets the value from an optional 3897 * @brief Gets the value from an optional
3890 * 3898 *
3891 * @param value Eina Value Optional to get value from 3899 * @param[in] value Eina Value Optional to get value from
3892 * @param subvalue Pointer to where value is to be copied to. You must use 3900 * @param[out] subvalue Pointer to where value is to be copied to. You must use
3893 * the correct type according to eina_value_optional_type_get 3901 * the correct type according to eina_value_optional_type_get
3894 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3902 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3895 * 3903 *
@@ -3901,7 +3909,7 @@ EAPI Eina_Bool eina_value_optional_pget(Eina_Value *value,
3901/** 3909/**
3902 * @brief Resets eina optional to empty 3910 * @brief Resets eina optional to empty
3903 * 3911 *
3904 * @param value Eina Value Optional 3912 * @param[in,out] value Eina Value Optional
3905 * @return #EINA_TRUE on success, #EINA_FALSE otherwise. 3913 * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
3906 * 3914 *
3907 * @since 1.17 3915 * @since 1.17
@@ -3911,7 +3919,8 @@ EAPI Eina_Bool eina_value_optional_reset(Eina_Value *value) EINA_ARG_NONNULL(1);
3911/** 3919/**
3912 * 3920 *
3913 * @brief Gets type from value that is stored on Eina Value Optional 3921 * @brief Gets type from value that is stored on Eina Value Optional
3914 * @param value Eina Value Optional 3922 *
3923 * @param[in] value Eina Value Optional
3915 * @return The optional sub-type. 3924 * @return The optional sub-type.
3916 * 3925 *
3917 * @since 1.17 3926 * @since 1.17
diff --git a/src/lib/eina/eina_vector.h b/src/lib/eina/eina_vector.h
index 039114b8f1..df4508b675 100644
--- a/src/lib/eina/eina_vector.h
+++ b/src/lib/eina/eina_vector.h
@@ -64,9 +64,9 @@ struct _Eina_Vector3
64/** 64/**
65 * @brief Set parameters to vector. 65 * @brief Set parameters to vector.
66 * 66 *
67 * @param dst The resulting vector. 67 * @param[out] dst The resulting vector.
68 * @param x The x component. 68 * @param[in] x The x component.
69 * @param y The y component. 69 * @param[in] y The y component.
70 * 70 *
71 * @since 1.17 71 * @since 1.17
72 */ 72 */
@@ -75,8 +75,8 @@ static inline void eina_vector2_set(Eina_Vector2 *dst, double x, double y);
75/** 75/**
76 * @brief Set array to vector. 76 * @brief Set array to vector.
77 * 77 *
78 * @param dst The resulting vector. 78 * @param[out] dst The resulting vector.
79 * @param v The the array[2] for set. 79 * @param[in] v The the array[2] for set.
80 * 80 *
81 * Set to vector first 2 elements from array. 81 * Set to vector first 2 elements from array.
82 * 82 *
@@ -87,8 +87,8 @@ static inline void eina_vector2_array_set(Eina_Vector2 *dst, const double *v);
87/** 87/**
88 * @brief Copy vector. 88 * @brief Copy vector.
89 * 89 *
90 * @param dst The vector copy. 90 * @param[out] dst The vector copy.
91 * @param src The vector for copy. 91 * @param[in] src The vector for copy.
92 * 92 *
93 * @since 1.17 93 * @since 1.17
94 */ 94 */
@@ -97,8 +97,8 @@ static inline void eina_vector2_copy(Eina_Vector2 *dst, const Eina_Vector2 *src)
97/** 97/**
98 * @brief Make negative vector. 98 * @brief Make negative vector.
99 * 99 *
100 * @param out The resulting vector. 100 * @param[out] out The resulting vector.
101 * @param v The current vector. 101 * @param[in] v The current vector.
102 * 102 *
103 * @since 1.17 103 * @since 1.17
104 */ 104 */
@@ -107,9 +107,9 @@ static inline void eina_vector2_negate(Eina_Vector2 *out, const Eina_Vector2 *v)
107/** 107/**
108 * @brief Add two vectors. 108 * @brief Add two vectors.
109 * 109 *
110 * @param out The resulting vector. 110 * @param[out] out The resulting vector.
111 * @param a The first member of the add. 111 * @param[in] a The first member of the add.
112 * @param b The second member of the add. 112 * @param[in] b The second member of the add.
113 * 113 *
114 * @since 1.17 114 * @since 1.17
115 */ 115 */
@@ -118,9 +118,9 @@ static inline void eina_vector2_add(Eina_Vector2 *out, const Eina_Vector2 *a, co
118/** 118/**
119 * @brief Subtract two vectors 119 * @brief Subtract two vectors
120 * 120 *
121 * @param out The resulting vector 121 * @param[out] out The resulting vector
122 * @param a The first member of the subtract 122 * @param[in] a The first member of the subtract
123 * @param b The second member of the subtract 123 * @param[in] b The second member of the subtract
124 * 124 *
125 * @since 1.17 125 * @since 1.17
126 */ 126 */
@@ -129,9 +129,9 @@ static inline void eina_vector2_subtract(Eina_Vector2 *out, const Eina_Vector2 *
129/** 129/**
130 * @brief Scale vector. 130 * @brief Scale vector.
131 * 131 *
132 * @param out The resulting vector. 132 * @param[out] out The resulting vector.
133 * @param v The vector for scale. 133 * @param[in] v The vector for scale.
134 * @param scale The scale value. 134 * @param[in] scale The scale value.
135 * 135 *
136 * @since 1.17 136 * @since 1.17
137 */ 137 */
@@ -140,8 +140,8 @@ static inline void eina_vector2_scale(Eina_Vector2 *out, const Eina_Vector2 *v,
140/** 140/**
141 * @brief Return the dot product of the two vectors. 141 * @brief Return the dot product of the two vectors.
142 * 142 *
143 * @param a The first member. 143 * @param[in] a The first member.
144 * @param b The second member. 144 * @param[in] b The second member.
145 * @return The dot product. 145 * @return The dot product.
146 * 146 *
147 * @since 1.17 147 * @since 1.17
@@ -151,7 +151,7 @@ static inline double eina_vector2_dot_product(const Eina_Vector2 *a, const Eina_
151/** 151/**
152 * @brief Return the length of the given vector. 152 * @brief Return the length of the given vector.
153 * 153 *
154 * @param v The vector. 154 * @param[in] v The vector.
155 * @return The length. 155 * @return The length.
156 * 156 *
157 * @since 1.17 157 * @since 1.17
@@ -161,7 +161,7 @@ static inline double eina_vector2_length_get(const Eina_Vector2 *v);
161/** 161/**
162 * @brief Return the length in square of the given vector. 162 * @brief Return the length in square of the given vector.
163 * 163 *
164 * @param v The vector. 164 * @param[in] v The vector.
165 * @return The length in square. 165 * @return The length in square.
166 * 166 *
167 * @since 1.17 167 * @since 1.17
@@ -171,8 +171,8 @@ static inline double eina_vector2_length_square_get(const Eina_Vector2 *v);
171/** 171/**
172 * @brief Return the distance between of two vectors. 172 * @brief Return the distance between of two vectors.
173 * 173 *
174 * @param a The first vector. 174 * @param[in] a The first vector.
175 * @param b The second vector. 175 * @param[in] b The second vector.
176 * @return The distance. 176 * @return The distance.
177 * 177 *
178 * @since 1.17 178 * @since 1.17
@@ -182,8 +182,8 @@ static inline double eina_vector2_distance_get(const Eina_Vector2 *a, const Eina
182/** 182/**
183 * @brief Return the distance in square between of two vectors. 183 * @brief Return the distance in square between of two vectors.
184 * 184 *
185 * @param a The first vector. 185 * @param[in] a The first vector.
186 * @param b The second vector. 186 * @param[in] b The second vector.
187 * @return The distance in square. 187 * @return The distance in square.
188 * 188 *
189 * @since 1.17 189 * @since 1.17
@@ -193,8 +193,8 @@ static inline double eina_vector2_distance_square_get(const Eina_Vector2 *a, con
193/** 193/**
194 * @brief normalize vector. 194 * @brief normalize vector.
195 * 195 *
196 * @param out The resulting vector. 196 * @param[out] out The resulting vector.
197 * @param v The vector for normalize. 197 * @param[in] v The vector for normalize.
198 * 198 *
199 * @since 1.17 199 * @since 1.17
200 */ 200 */
@@ -203,9 +203,9 @@ static inline void eina_vector2_normalize(Eina_Vector2 *out, const Eina_Vector2
203/** 203/**
204 * @brief Transform vector. 204 * @brief Transform vector.
205 * 205 *
206 * @param out The resulting vector. 206 * @param[out] out The resulting vector.
207 * @param m The matrix for transform. 207 * @param[in] m The matrix for transform.
208 * @param v The vector for transform. 208 * @param[in] v The vector for transform.
209 * 209 *
210 * @since 1.17 210 * @since 1.17
211 */ 211 */
@@ -214,9 +214,9 @@ static inline void eina_vector2_transform(Eina_Vector2 *out, const Eina_Matrix2
214/** 214/**
215 * @brief Homogeneous position transform vector. 215 * @brief Homogeneous position transform vector.
216 * 216 *
217 * @param out The resulting vector. 217 * @param[out] out The resulting vector.
218 * @param m The matrix for transform. 218 * @param[in] m The matrix for transform.
219 * @param v The vector for transform. 219 * @param[in] v The vector for transform.
220 * 220 *
221 * @since 1.17 221 * @since 1.17
222 */ 222 */
@@ -225,9 +225,9 @@ static inline void eina_vector2_homogeneous_position_transform(Eina_Vector2 *out
225/** 225/**
226 * @brief Homogeneous direction transform vector. 226 * @brief Homogeneous direction transform vector.
227 * 227 *
228 * @param out The resulting vector. 228 * @param[out] out The resulting vector.
229 * @param m The matrix for transform. 229 * @param[in] m The matrix for transform.
230 * @param v The vector for transform. 230 * @param[in] v The vector for transform.
231 * 231 *
232 * @since 1.17 232 * @since 1.17
233 */ 233 */
@@ -236,10 +236,10 @@ static inline void eina_vector2_homogeneous_direction_transform(Eina_Vector2 *ou
236/** 236/**
237 * @brief Set parameters to vector. 237 * @brief Set parameters to vector.
238 * 238 *
239 * @param dst The resulting vector. 239 * @param[out] dst The resulting vector.
240 * @param x The x component. 240 * @param[in] x The x component.
241 * @param y The y component. 241 * @param[in] y The y component.
242 * @param z The z component. 242 * @param[in] z The z component.
243 * 243 *
244 * @since 1.18 244 * @since 1.18
245 */ 245 */
@@ -248,8 +248,8 @@ static inline void eina_vector3_set(Eina_Vector3 *dst, double x, double y, doubl
248/** 248/**
249 * @brief Set array to vector. 249 * @brief Set array to vector.
250 * 250 *
251 * @param dst The resulting vector. 251 * @param[out] dst The resulting vector.
252 * @param v The the array[3] for set. 252 * @param[in] v The the array[3] for set.
253 * 253 *
254 * Set to vector first 3 elements from array. 254 * Set to vector first 3 elements from array.
255 * 255 *
@@ -260,8 +260,8 @@ static inline void eina_vector3_array_set(Eina_Vector3 *dst, const double *v);
260/** 260/**
261 * @brief Copy vector. 261 * @brief Copy vector.
262 * 262 *
263 * @param dst The vector copy. 263 * @param[out] dst The vector copy.
264 * @param src The vector for copy. 264 * @param[in] src The vector for copy.
265 * 265 *
266 * @since 1.18 266 * @since 1.18
267 */ 267 */
@@ -270,8 +270,8 @@ static inline void eina_vector3_copy(Eina_Vector3 *dst, const Eina_Vector3 *src)
270/** 270/**
271 * @brief Make negative vector. 271 * @brief Make negative vector.
272 * 272 *
273 * @param out The resulting vector. 273 * @param[out] out The resulting vector.
274 * @param v The current vector. 274 * @param[in] v The current vector.
275 * 275 *
276 * @since 1.18 276 * @since 1.18
277 */ 277 */
@@ -280,9 +280,9 @@ static inline void eina_vector3_negate(Eina_Vector3 *out, const Eina_Vector3 *v)
280/** 280/**
281 * @brief Add two vectors. 281 * @brief Add two vectors.
282 * 282 *
283 * @param out The resulting vector. 283 * @param[out] out The resulting vector.
284 * @param a The first member of the add. 284 * @param[in] a The first member of the add.
285 * @param b The second member of the add. 285 * @param[in] b The second member of the add.
286 * 286 *
287 * @since 1.18 287 * @since 1.18
288 */ 288 */
@@ -292,9 +292,9 @@ static inline void eina_vector3_add(Eina_Vector3 *out, const Eina_Vector3 *a,
292/** 292/**
293 * @brief Subtract two vectors 293 * @brief Subtract two vectors
294 * 294 *
295 * @param out The resulting vector 295 * @param[out] out The resulting vector
296 * @param a The first member of the subtract 296 * @param[in] a The first member of the subtract
297 * @param b The second member of the subtract 297 * @param[in] b The second member of the subtract
298 * 298 *
299 * @since 1.18 299 * @since 1.18
300 */ 300 */
@@ -304,9 +304,9 @@ static inline void eina_vector3_subtract(Eina_Vector3 *out, const Eina_Vector3 *
304/** 304/**
305 * @brief Scale vector. 305 * @brief Scale vector.
306 * 306 *
307 * @param out The resulting vector. 307 * @param[out] out The resulting vector.
308 * @param v The vector for scale. 308 * @param[in] v The vector for scale.
309 * @param scale The scale value. 309 * @param[in] scale The scale value.
310 * 310 *
311 * @since 1.18 311 * @since 1.18
312 */ 312 */
@@ -315,9 +315,9 @@ static inline void eina_vector3_scale(Eina_Vector3 *out, const Eina_Vector3 *v,
315/** 315/**
316 * @brief Multiply two vectors 316 * @brief Multiply two vectors
317 * 317 *
318 * @param out The resulting vector 318 * @param[out] out The resulting vector
319 * @param a The first member 319 * @param[in] a The first member
320 * @param b The second member 320 * @param[in] b The second member
321 * 321 *
322 * @since 1.18 322 * @since 1.18
323 */ 323 */
@@ -327,8 +327,8 @@ static inline void eina_vector3_multiply(Eina_Vector3 *out, const Eina_Vector3 *
327/** 327/**
328 * @brief Return the dot product of the two vectors. 328 * @brief Return the dot product of the two vectors.
329 * 329 *
330 * @param a The first member. 330 * @param[in] a The first member.
331 * @param b The second member. 331 * @param[in] b The second member.
332 * @return The dot product. 332 * @return The dot product.
333 * 333 *
334 * @since 1.18 334 * @since 1.18
@@ -338,9 +338,9 @@ static inline double eina_vector3_dot_product(const Eina_Vector3 *a, const Eina_
338/** 338/**
339 * @brief Create the cross product of the two vectors. 339 * @brief Create the cross product of the two vectors.
340 * 340 *
341 * @param out The resulting vector. 341 * @param[out] out The resulting vector.
342 * @param a The first member. 342 * @param[in] a The first member.
343 * @param b The second member. 343 * @param[in] b The second member.
344 * 344 *
345 * @since 1.18 345 * @since 1.18
346 */ 346 */
@@ -350,7 +350,7 @@ static inline void eina_vector3_cross_product(Eina_Vector3 *out, const Eina_Vect
350/** 350/**
351 * @brief Return the length of the given vector. 351 * @brief Return the length of the given vector.
352 * 352 *
353 * @param v The vector. 353 * @param[in] v The vector.
354 * @return The length. 354 * @return The length.
355 * 355 *
356 * @since 1.18 356 * @since 1.18
@@ -360,7 +360,7 @@ static inline double eina_vector3_length_get(const Eina_Vector3 *v);
360/** 360/**
361 * @brief Return the length in square of the given vector. 361 * @brief Return the length in square of the given vector.
362 * 362 *
363 * @param v The vector. 363 * @param[in] v The vector.
364 * @return The length in square. 364 * @return The length in square.
365 * 365 *
366 * @since 1.18 366 * @since 1.18
@@ -370,8 +370,8 @@ static inline double eina_vector3_length_square_get(const Eina_Vector3 *v);
370/** 370/**
371 * @brief Return the distance between of two vectors. 371 * @brief Return the distance between of two vectors.
372 * 372 *
373 * @param a The first vector. 373 * @param[in] a The first vector.
374 * @param b The second vector. 374 * @param[in] b The second vector.
375 * @return The distance. 375 * @return The distance.
376 * 376 *
377 * @since 1.18 377 * @since 1.18
@@ -381,8 +381,8 @@ static inline double eina_vector3_distance_get(const Eina_Vector3 *a, const Eina
381/** 381/**
382 * @brief Return the distance in square between of two vectors. 382 * @brief Return the distance in square between of two vectors.
383 * 383 *
384 * @param a The first vector. 384 * @param[in] a The first vector.
385 * @param b The second vector. 385 * @param[in] b The second vector.
386 * @return The distance in square. 386 * @return The distance in square.
387 * 387 *
388 * @since 1.18 388 * @since 1.18
@@ -393,8 +393,8 @@ static inline double eina_vector3_distance_square_get(const Eina_Vector3 *a,
393/** 393/**
394 * @brief Return the angle between of two vectors. 394 * @brief Return the angle between of two vectors.
395 * 395 *
396 * @param a The first vector. 396 * @param[in] a The first vector.
397 * @param b The second vector. 397 * @param[in] b The second vector.
398 * @return The angle. 398 * @return The angle.
399 * 399 *
400 * @since 1.18 400 * @since 1.18
@@ -404,8 +404,8 @@ static inline double eina_vector3_angle_get(const Eina_Vector3 *a, const Eina_Ve
404/** 404/**
405 * @brief normalize vector. 405 * @brief normalize vector.
406 * 406 *
407 * @param out The resulting vector. 407 * @param[out] out The resulting vector.
408 * @param v The not NULL vector for normalize. 408 * @param[in] v The not NULL vector for normalize.
409 * 409 *
410 * @since 1.18 410 * @since 1.18
411 */ 411 */
@@ -414,9 +414,9 @@ static inline void eina_vector3_normalize(Eina_Vector3 *out, const Eina_Vector3
414/** 414/**
415 * @brief Transform vector. 415 * @brief Transform vector.
416 * 416 *
417 * @param out The resulting vector. 417 * @param[out] out The resulting vector.
418 * @param m The matrix for transform. 418 * @param[in] m The matrix for transform.
419 * @param v The vector for transform. 419 * @param[in] v The vector for transform.
420 * 420 *
421 * @since 1.18 421 * @since 1.18
422 */ 422 */
@@ -426,9 +426,9 @@ static inline void eina_vector3_transform(Eina_Vector3 *out, const Eina_Matrix3
426/** 426/**
427 * @brief Homogeneous direction transform vector. 427 * @brief Homogeneous direction transform vector.
428 * 428 *
429 * @param out The resulting vector. 429 * @param[out] out The resulting vector.
430 * @param m The matrix for transform. 430 * @param[in] m The matrix for transform.
431 * @param v The vector for transform. 431 * @param[in] v The vector for transform.
432 * 432 *
433 * @since 1.18 433 * @since 1.18
434 */ 434 */
@@ -438,9 +438,9 @@ static inline void eina_vector3_homogeneous_direction_transform(Eina_Vector3 *ou
438/** 438/**
439 * @brief Homogeneous position transform vector. 439 * @brief Homogeneous position transform vector.
440 * 440 *
441 * @param out The resulting vector. 441 * @param[out] out The resulting vector.
442 * @param m The matrix for transform. 442 * @param[in] m The matrix for transform.
443 * @param v The vector for transform. 443 * @param[in] v The vector for transform.
444 * 444 *
445 * @since 1.18 445 * @since 1.18
446 */ 446 */
@@ -451,9 +451,9 @@ static inline void eina_vector3_homogeneous_position_transform(Eina_Vector3 *out
451/** 451/**
452 * @brief Rotate vector. 452 * @brief Rotate vector.
453 * 453 *
454 * @param out The resulting vector. 454 * @param[out] out The resulting vector.
455 * @param v The vector for rotate. 455 * @param[in] v The vector for rotate.
456 * @param q The quaternion in radians for rotate. 456 * @param[in] q The quaternion in radians for rotate.
457 * 457 *
458 * @since 1.18 458 * @since 1.18
459 */ 459 */
@@ -463,9 +463,9 @@ static inline