Youness Alaoui <kakaroto@kakaroto.homelinux.net>
billiob (Boris Faure) <billiob@gmail.com>
Sung W. Park <sungwoo@gmail.com>
+Guillaume Friloux <guillaume.friloux@asp64.com>
* Linux, BSD, Opensolaris and Windows (XP and CE).
*
* The data types that are available are (see @ref Eina_Data_Types_Group):
- * @li @ref Eina_Inarray_Group standard array of inlined members.
+ * @li @ref Eina_Inline_Array_Group standard array of inlined members.
* @li @ref Eina_Array_Group standard array of @c void* data.
* @li @ref Eina_Hash_Group standard hash of @c void* data.
* @li @ref Eina_Inline_List_Group list with nodes inlined into user type.
/**
- * @page array_01_example_page Basic array usage
+ * @page eina_array_01_example_page Basic array usage
* @dontinclude eina_array_01.c
*
* For this example we add stdlib.h, stdio.h and string.h for some
*/
/**
- * @page array_02_example_page Removing array elements
+ * @page eina_array_02_example_page Removing array elements
* @dontinclude eina_array_02.c
*
* Just the usual includes:
* of void pointers.
*
* See here some examples:
- * @li @ref array_01_example_page
- * @li @ref array_02_example_page
+ * @li @ref eina_array_01_example_page
+ * @li @ref eina_array_02_example_page
*/
/**
#include <stddef.h>
/**
- * @page inlist_01_example_page Eina_Inlist basic usage
+ * @page eina_inlist_01_example_page Eina_Inlist basic usage
* @dontinclude eina_inlist_01.c
*
* To see the full source for this example, click here: @ref
*/
/**
- * @page inlist_02_example_page Eina_Inlist advanced usage - lists and inlists
+ * @page eina_inlist_02_example_page Eina_Inlist advanced usage - lists and inlists
* @dontinclude eina_inlist_02.c
*
* This example describes the usage of @ref Eina_Inlist mixed with @ref
* from this normal list.
*
* The struct that is going to be used is the same used in @ref
- * inlist_01_example_page , since we still need the @ref EINA_INLIST macro to
+ * eina_inlist_01_example_page , since we still need the @ref EINA_INLIST macro to
* declare the inlist node info:
*
* @skip struct
*/
/**
- * @page inlist_03_example_page Eina_Inlist advanced usage - multi-inlists
+ * @page eina_inlist_03_example_page Eina_Inlist advanced usage - multi-inlists
* @dontinclude eina_inlist_03.c
*
* This example describes the usage of multiple inlists storing the same data.
* exactly what type this list is.
*
* A simple example demonstrating the basic usage of an inlist can be found
- * here: @ref inlist_01_example_page
+ * here: @ref eina_inlist_01_example_page
*
* @section inlist_algo Algorithm
*
* @ref inlist_03_example_page
*
* List of examples:
- * @li @ref inlist_01_example_page
- * @li @ref inlist_02_example_page
- * @li @ref inlist_03_example_page
+ * @li @ref eina_inlist_01_example_page
+ * @li @ref eina_inlist_02_example_page
+ * @li @ref eina_inlist_03_example_page
*/
/**
_EINA_INLIST_OFFSET(ref))
#endif
+/** Macro to iterate over an inlist */
#define EINA_INLIST_FOREACH(list, l) \
for (l = NULL, l = (list ? _EINA_INLIST_CONTAINER(l, list) : NULL); l; \
l = (EINA_INLIST_GET(l)->next ? _EINA_INLIST_CONTAINER(l, EINA_INLIST_GET(l)->next) : NULL))
#include "eina_magic.h"
/**
- * @page eina_iterator_example Eina_Iterator usage
+ * @page eina_iterator_example_page Eina_Iterator usage
* @dontinclude eina_iterator_01.c
*
* As always when using eina we need to include it:
* @until eina_init
*
* Next we populate both an array and a list with our strings, for more details
- * see @ref eina_list_01_example and @ref eina_array_01_example:
+ * see @ref eina_list_01_example_page and @ref eina_array_01_example_page :
* @until }
*
* And now we create an array and because the first element of the container
* iterator itself:
* @until eina_iterator_free
*
- * But so far you're not impressed in @ref eina_array_01_example an array is
+ * But so far you're not impressed in @ref eina_array_01_example_page an array is
* also printed, so now we go to the cool stuff and use an iterator to do same
* stuff to a list:
* @until eina_iterator_free
* eina_iterator_next(). To call a function on all the elements of a
* container, use eina_iterator_foreach().
*
- * Here an @ref eina_iterator_example "example"
+ * Here an @ref eina_iterator_example_page "example"
*/
/**
#include "eina_magic.h"
/**
- * @page list_01_example_page Adding elements to Eina_List
+ * @page eina_list_01_example_page Adding elements to Eina_List
* @dontinclude eina_list_01.c
*
* Creating an @ref Eina_List and adding elements to it is very easy and can be
*/
/**
- * @page list_02_example_page Sorting Eina_List elements
+ * @page eina_list_02_example_page Sorting Eina_List elements
* @dontinclude eina_list_02.c
*
* If you don't know how to create lists see
- * @ref list_01_example_page.
+ * @ref eina_list_01_example_page.
*
* @skip #include
* @until boomer
*/
/**
- * @page list_03_example_page Reordering Eina_List elments
+ * @page eina_list_03_example_page Reordering Eina_List elments
* @dontinclude eina_list_03.c
*
* If you don't know how to create lists see
- * @ref list_01_example_page.
+ * @ref eina_list_01_example_page.
*
* We start out with code that should be familiar by now:
* @skip #include
*/
/**
- * @page list_04_example_page Eina_List and memory allocation
+ * @page eina_list_04_example_page Eina_List and memory allocation
* @dontinclude eina_list_04.c
*
* If you don't know how to create lists see
- * @ref list_01_example_page. In this example we also use
+ * @ref eina_list_01_example_page. In this example we also use
* @ref Eina_Stringshare_Group, however it should be possible to understand the code
* regardless of previous knowledge about it.
*
* list as the list!
*
* Here are some examples of @ref Eina_List usage:
- * @li @ref list_01_example_page
- * @li @ref list_02_example_page
- * @li @ref list_03_example_page
- * @li @ref list_04_example_page
+ * @li @ref eina_list_01_example_page
+ * @li @ref eina_list_02_example_page
+ * @li @ref eina_list_03_example_page
+ * @li @ref eina_list_04_example_page
*/
/**
typedef enum _Eina_Simple_XML_Type
{
- EINA_SIMPLE_XML_OPEN = 0, /* <tag attribute="value"> */
- EINA_SIMPLE_XML_OPEN_EMPTY, /* <tag attribute="value" /> */
- EINA_SIMPLE_XML_CLOSE, /* </tag> */
- EINA_SIMPLE_XML_DATA, /* tag text data */
- EINA_SIMPLE_XML_CDATA, /* <![CDATA[something]]> */
- EINA_SIMPLE_XML_ERROR, /* error contents */
- EINA_SIMPLE_XML_PROCESSING, /* <?xml ... ?> <?php .. ?> */
- EINA_SIMPLE_XML_DOCTYPE, /* <!DOCTYPE html */
- EINA_SIMPLE_XML_COMMENT, /* <!-- something --> */
- EINA_SIMPLE_XML_IGNORED /* whatever is ignored by parser, like whitespace */
+ EINA_SIMPLE_XML_OPEN = 0, /*!< <tag attribute="value"> */
+ EINA_SIMPLE_XML_OPEN_EMPTY, /*!< <tag attribute="value" /> */
+ EINA_SIMPLE_XML_CLOSE, /*!< </tag> */
+ EINA_SIMPLE_XML_DATA, /*!< tag text data */
+ EINA_SIMPLE_XML_CDATA, /*!< <![CDATA[something]]> */
+ EINA_SIMPLE_XML_ERROR, /*!< error contents */
+ EINA_SIMPLE_XML_PROCESSING, /*!< <?xml ... ?> <?php .. ?> */
+ EINA_SIMPLE_XML_DOCTYPE, /*!< <!DOCTYPE html */
+ EINA_SIMPLE_XML_COMMENT, /*!< <!-- something --> */
+ EINA_SIMPLE_XML_IGNORED /*!< whatever is ignored by parser, like whitespace */
} Eina_Simple_XML_Type;
typedef Eina_Bool (*Eina_Simple_XML_Cb)(void *data, Eina_Simple_XML_Type type, const char *content, unsigned offset, unsigned length);
* @return The duplicated string.
*
* This function duplicates @p text. The resuting string is cut on @p
- * n. @p n is assumed to be lesser (<) than the length of @t
+ * n. @p n is assumed to be lesser (<) than the length of @p
* text. When not needed anymore, the returned string must be freed.
*
* @since 1.1.0