From: gastal <gastal@7cbeb6ba-43b4-40fd-8cce-4c39aea84d33>
Date: Fri, 15 Jul 2011 18:37:44 +0000 (+0000)
Subject: Eina: Groups shouldn't be inside themselves, and both groups
X-Git-Tag: 2.0_alpha~69^2
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=ff1f3f1f7797a3b2d29719564d89071be491fe87;p=framework%2Fuifw%2Feina.git

Eina: Groups shouldn't be inside themselves, and both groups
 and conditionals need to be properly closed..



git-svn-id: svn+ssh://svn.enlightenment.org/var/svn/e/trunk/eina@61413 7cbeb6ba-43b4-40fd-8cce-4c39aea84d33
---

diff --git a/src/include/eina_accessor.h b/src/include/eina_accessor.h
index 62b2b03..cae7a5c 100644
--- a/src/include/eina_accessor.h
+++ b/src/include/eina_accessor.h
@@ -93,8 +93,6 @@
  * chosen elements of a container, use eina_accessor_over().
  *
  * See an example @ref eina_accessor_example_01_page "here".
- *
- * @{
  */
 
 /**
@@ -339,8 +337,4 @@ EAPI Eina_Bool eina_accessor_unlock(Eina_Accessor *accessor) EINA_ARG_NONNULL(1)
  * @}
  */
 
-/**
- * @}
- */
-
 #endif
diff --git a/src/include/eina_array.h b/src/include/eina_array.h
index 10503db..1e53392 100644
--- a/src/include/eina_array.h
+++ b/src/include/eina_array.h
@@ -188,8 +188,6 @@
  * See here some examples:
  * @li @ref array_01_example_page
  * @li @ref array_02_example_page
- *
- * @{
  */
 
 /**
@@ -443,9 +441,4 @@ static inline Eina_Bool    eina_array_foreach(Eina_Array  *array,
  * @}
  */
 
-
-/**
- * @}
- */
-
 #endif
diff --git a/src/include/eina_benchmark.h b/src/include/eina_benchmark.h
index c6b21c9..721e1c0 100644
--- a/src/include/eina_benchmark.h
+++ b/src/include/eina_benchmark.h
@@ -317,8 +317,6 @@
  * written in a gnuplot file.
  *
  * For more information, you can look at the @ref tutorial_benchmark_page.
- *
- * @{
  */
 
 /**
@@ -452,8 +450,4 @@ EAPI Eina_Array *eina_benchmark_run(Eina_Benchmark *bench);
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_BENCHMARK_H_ */
diff --git a/src/include/eina_binbuf.h b/src/include/eina_binbuf.h
index 5866ba3..92f788e 100644
--- a/src/include/eina_binbuf.h
+++ b/src/include/eina_binbuf.h
@@ -13,8 +13,6 @@
  *
  * The Binary Buffer data type is designed to be a mutable string,
  * allowing to append, prepend or insert a string to a buffer.
- *
- * @{
  */
 
 /**
@@ -216,8 +214,4 @@ EAPI size_t    eina_binbuf_length_get(const Eina_Binbuf *buf) EINA_ARG_NONNULL(1
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_STRBUF_H */
diff --git a/src/include/eina_binshare.h b/src/include/eina_binshare.h
index ab6464a..55b17a6 100644
--- a/src/include/eina_binshare.h
+++ b/src/include/eina_binshare.h
@@ -71,8 +71,6 @@
  * memory.
  *
  * For more information, you can look at the @ref tutorial_binshare_page.
- *
- * @{
  */
 
 /**
@@ -192,8 +190,4 @@ EAPI void        eina_binshare_dump(void);
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_STRINGSHARE_H_ */
diff --git a/src/include/eina_convert.h b/src/include/eina_convert.h
index b06d7d4..af839e2 100644
--- a/src/include/eina_convert.h
+++ b/src/include/eina_convert.h
@@ -144,8 +144,6 @@
  * @code
  * gcc -Wall -o test_eina_convert test_eina.c `pkg-config --cflags --libs eina` -lm
  * @endcode
- *
- * @{
  */
 
 /**
@@ -373,8 +371,4 @@ EAPI Eina_Bool eina_convert_atofp(const char  *src,
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_CONVERT_H_ */
diff --git a/src/include/eina_counter.h b/src/include/eina_counter.h
index c07f5fd..26bee06 100644
--- a/src/include/eina_counter.h
+++ b/src/include/eina_counter.h
@@ -100,8 +100,6 @@
  * @endverbatim
  *
  * Note that the displayed time is in nanosecond.
- *
- * @{
  */
 
 /**
@@ -212,8 +210,4 @@ EAPI char         *eina_counter_dump(Eina_Counter *counter) EINA_ARG_NONNULL(1);
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_COUNTER_H_ */
diff --git a/src/include/eina_error.h b/src/include/eina_error.h
index 5ca1fbe..2b0ae77 100644
--- a/src/include/eina_error.h
+++ b/src/include/eina_error.h
@@ -64,8 +64,6 @@
  *
  * A simple example of how to use this can be seen @ref tutorial_error_page
  * "here".
- *
- * @{
  */
 
 /**
@@ -197,8 +195,4 @@ EAPI Eina_Error  eina_error_find(const char *msg) EINA_ARG_NONNULL(1) EINA_PURE;
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_ERROR_H_ */
diff --git a/src/include/eina_file.h b/src/include/eina_file.h
index fbcc103..ca97440 100644
--- a/src/include/eina_file.h
+++ b/src/include/eina_file.h
@@ -373,8 +373,4 @@ EAPI void eina_file_map_free(Eina_File *file, void *map);
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_FILE_H_ */
diff --git a/src/include/eina_hamster.h b/src/include/eina_hamster.h
index 74bd69e..bea759d 100644
--- a/src/include/eina_hamster.h
+++ b/src/include/eina_hamster.h
@@ -35,8 +35,6 @@
 
 /**
  * @defgroup Eina_Hamster_Group Hamster
- *
- * @{
  */
 
 
@@ -57,8 +55,4 @@ EAPI int eina_hamster_count(void);
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_HAMSTER_H_ */
diff --git a/src/include/eina_hash.h b/src/include/eina_hash.h
index e846242..71de90b 100644
--- a/src/include/eina_hash.h
+++ b/src/include/eina_hash.h
@@ -260,8 +260,6 @@
  *      </ul>
  * <li> @ref eina_hash_08.c "Different add and delete functions"
  * </ul>
- *
- * @{
  */
 
 /**
@@ -1037,8 +1035,4 @@ static inline int eina_hash_int64(const unsigned long int *pkey,
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /*EINA_HASH_H_*/
diff --git a/src/include/eina_inlist.h b/src/include/eina_inlist.h
index 4c8c80e..b2d7e77 100644
--- a/src/include/eina_inlist.h
+++ b/src/include/eina_inlist.h
@@ -371,8 +371,6 @@
  * @li @ref inlist_01_example_page
  * @li @ref inlist_02_example_page
  * @li @ref inlist_03_example_page
- *
- * @{
  */
 
 /**
@@ -730,8 +728,4 @@ EAPI Eina_Inlist *eina_inlist_sort(Eina_Inlist *head, Eina_Compare_Cb func);
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /*EINA_INLIST_H_*/
diff --git a/src/include/eina_iterator.h b/src/include/eina_iterator.h
index 546340b..1c8e6ce 100644
--- a/src/include/eina_iterator.h
+++ b/src/include/eina_iterator.h
@@ -100,8 +100,6 @@
  * container, use eina_iterator_foreach().
  * 
  * Here an @ref eina_iterator_example "example"
- *
- * @{
  */
 
 /**
@@ -336,8 +334,4 @@ EAPI Eina_Bool eina_iterator_unlock(Eina_Iterator *iterator) EINA_ARG_NONNULL(1)
  * @}
  */
 
-/**
- * @}
- */
-
 #endif
diff --git a/src/include/eina_list.h b/src/include/eina_list.h
index de47560..aabe9bf 100644
--- a/src/include/eina_list.h
+++ b/src/include/eina_list.h
@@ -280,8 +280,6 @@
  * @li @ref list_02_example_page
  * @li @ref list_03_example_page
  * @li @ref list_04_example_page
- *
- * @{
  */
 
 /**
@@ -1630,8 +1628,4 @@ EAPI Eina_Accessor        *eina_list_accessor_new(const Eina_List *list) EINA_MA
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_LIST_H_ */
diff --git a/src/include/eina_log.h b/src/include/eina_log.h
index f76f985..5cd7c59 100644
--- a/src/include/eina_log.h
+++ b/src/include/eina_log.h
@@ -210,7 +210,6 @@
  * For more information, you can look at the @ref tutorial_log_page.
  *
  * @example eina_log_01.c
- * @{
  */
 
 /**
@@ -886,8 +885,4 @@ EAPI void eina_log_print_cb_file(const Eina_Log_Domain *d,
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_LOG_H_ */
diff --git a/src/include/eina_main.h b/src/include/eina_main.h
index 74d59d8..c2c3ffa 100644
--- a/src/include/eina_main.h
+++ b/src/include/eina_main.h
@@ -26,8 +26,6 @@
  *
  * @brief These functions provide general initialisation and shut down
  * functions.
- *
- * @{
  */
 
 /**
@@ -142,8 +140,4 @@ EAPI int eina_threads_shutdown(void);
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_MAIN_H_ */
diff --git a/src/include/eina_matrixsparse.h b/src/include/eina_matrixsparse.h
index 028f8e3..97d1ca5 100644
--- a/src/include/eina_matrixsparse.h
+++ b/src/include/eina_matrixsparse.h
@@ -33,8 +33,6 @@
  * @brief These functions provide matrix sparse management.
  *
  * For more information, you can look at the @ref tutorial_matrixsparse_page.
- *
- * @{
  */
 
 /**
@@ -398,8 +396,4 @@ EAPI Eina_Iterator *eina_matrixsparse_iterator_complete_new(const Eina_Matrixspa
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_MATRIXSPARSE_H_ */
diff --git a/src/include/eina_mempool.h b/src/include/eina_mempool.h
index e75b03c..796bc9e 100644
--- a/src/include/eina_mempool.h
+++ b/src/include/eina_mempool.h
@@ -56,8 +56,6 @@
  * @li @c one_big: It call just one time malloc for the requested number
  * of items. Useful when you know in advance how many object of some
  * type will live during the life of the mempool.
- *
- * @{
  */
 
 /**
@@ -122,8 +120,4 @@ EAPI unsigned int   eina_mempool_alignof(unsigned int size);
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_MEMPOOL_H_ */
diff --git a/src/include/eina_mmap.h b/src/include/eina_mmap.h
index 618b805..e9584d7 100644
--- a/src/include/eina_mmap.h
+++ b/src/include/eina_mmap.h
@@ -2,7 +2,7 @@
 #define EINA_MMAP_H_
 
 /**
- * @addtogroup Eina_Mmap_Group Group
+ * @addtogroup Eina_Mmap_Group Mmap Group
  *
  * @brief These functions provide helpers for safe mmap handling
  *
diff --git a/src/include/eina_module.h b/src/include/eina_module.h
index ca9a570..58e38f9 100644
--- a/src/include/eina_module.h
+++ b/src/include/eina_module.h
@@ -27,8 +27,6 @@
  * @addtogroup Eina_Module_Group Module
  *
  * @brief These functions provide module management.
- *
- * @{
  */
 
 /**
@@ -342,12 +340,4 @@ EAPI Eina_Module *
  * @}
  */
 
-/**
- * @}
- */
-
-/**
- * @}
- */
-
 #endif /*EINA_MODULE_H_*/
diff --git a/src/include/eina_prefix.h b/src/include/eina_prefix.h
index cdca08d..b59080b 100644
--- a/src/include/eina_prefix.h
+++ b/src/include/eina_prefix.h
@@ -2,7 +2,7 @@
 #define EINA_PREFIX_H_
 
 /**
- * @addtogroup Eina_Prefix_Group Group
+ * @addtogroup Eina_Prefix_Group Prefix Group
  *
  * @brief These functions provide the ability to determine the runtime
  * location of a software package
diff --git a/src/include/eina_rbtree.h b/src/include/eina_rbtree.h
index 9b2010a..c60984e 100644
--- a/src/include/eina_rbtree.h
+++ b/src/include/eina_rbtree.h
@@ -35,8 +35,6 @@
  * http://eternallyconfuzzled.com/tuts/datastructures/jsw_tut_rbtree.aspx . The
  * main difference is that this set of function never allocate any data, making
  * them particularly useful for memory management.
- *
- * @{
  */
 
 /**
@@ -270,8 +268,4 @@ EAPI Eina_Iterator        *eina_rbtree_iterator_postfix(const Eina_Rbtree *root)
  * @}
  */
 
-/**
- * @}
- */
-
 #endif
diff --git a/src/include/eina_rectangle.h b/src/include/eina_rectangle.h
index f37b8af..57e562c 100644
--- a/src/include/eina_rectangle.h
+++ b/src/include/eina_rectangle.h
@@ -25,8 +25,6 @@
  * @addtogroup Eina_Rectangle_Group Rectangle
  *
  * @brief These functions provide rectangle management.
- *
- * @{
  */
 
 /**
@@ -238,8 +236,4 @@ EAPI void            eina_rectangle_free(Eina_Rectangle *rect) EINA_ARG_NONNULL(
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /*_EINA_RECTANGLE_H_*/
diff --git a/src/include/eina_refcount.h b/src/include/eina_refcount.h
index f8cb36e..6650b01 100644
--- a/src/include/eina_refcount.h
+++ b/src/include/eina_refcount.h
@@ -29,8 +29,6 @@
  * set of macro do provide helper that will force to use the
  * correct code in most case and reduce the bug likeliness.
  * Of course this without affecting speed !
- *
- * @{
  */
 
 /**
@@ -75,8 +73,4 @@ typedef int Eina_Refcount;
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_REFCOUNT_H_ */
diff --git a/src/include/eina_safety_checks.h b/src/include/eina_safety_checks.h
index 79acf3e..4751e5f 100644
--- a/src/include/eina_safety_checks.h
+++ b/src/include/eina_safety_checks.h
@@ -60,8 +60,6 @@
  * #include "my_functions2.h"
  *
  * @endcode
- *
- * @{
  */
 
 /**
diff --git a/src/include/eina_simple_xml_parser.h b/src/include/eina_simple_xml_parser.h
index 8f96e8b..db9a4e1 100644
--- a/src/include/eina_simple_xml_parser.h
+++ b/src/include/eina_simple_xml_parser.h
@@ -48,8 +48,6 @@
  * will not tokenize this. If you want you can use
  * eina_simple_xml_tag_attributes_find() and then
  * eina_simple_xml_attributes_parse().
- *
- * @{
  */
 
 /**
@@ -385,8 +383,4 @@ EAPI char * eina_simple_xml_node_dump(Eina_Simple_XML_Node *node, const char *in
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_SIMPLE_XML_H_ */
diff --git a/src/include/eina_str.h b/src/include/eina_str.h
index d6b0446..8b52ab2 100644
--- a/src/include/eina_str.h
+++ b/src/include/eina_str.h
@@ -64,8 +64,6 @@
  * shared strings(eina_stringshare).
  *
  * See an example @ref tutorial_eina_string "here".
- *
- * @{
  */
 
 /**
@@ -324,8 +322,4 @@ static inline size_t eina_strlen_bounded(const char *str, size_t maxlen) EINA_PU
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_STR_H */
diff --git a/src/include/eina_strbuf.h b/src/include/eina_strbuf.h
index 226bf16..ac92f97 100644
--- a/src/include/eina_strbuf.h
+++ b/src/include/eina_strbuf.h
@@ -44,8 +44,6 @@
  * allowing to append, prepend or insert a string to a buffer.
  *
  * For more information see @ref tutorial_strbuf "this example".
- *
- * @{
  */
 
 /**
diff --git a/src/include/eina_stringshare.h b/src/include/eina_stringshare.h
index 366d44e..dd9e030 100644
--- a/src/include/eina_stringshare.h
+++ b/src/include/eina_stringshare.h
@@ -128,8 +128,6 @@
  *
  * For more information, see @ref eina_stringshare_example_01_page
  * "this example".
- *
- * @{
  */
 
 /**
@@ -314,8 +312,4 @@ static inline Eina_Bool eina_stringshare_replace_length(const char **p_str, cons
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_STRINGSHARE_H_ */
diff --git a/src/include/eina_ustrbuf.h b/src/include/eina_ustrbuf.h
index 4596c9d..9abe845 100644
--- a/src/include/eina_ustrbuf.h
+++ b/src/include/eina_ustrbuf.h
@@ -13,8 +13,6 @@
  *
  * The Unicode String Buffer data type is designed to be a mutable string,
  * allowing to append, prepend or insert a string to a buffer.
- *
- * @{
  */
 
 /**
@@ -426,8 +424,4 @@ eina_ustrbuf_length_get(const Eina_UStrbuf *buf) EINA_ARG_NONNULL(1) EINA_WARN_U
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_STRBUF_H */
diff --git a/src/include/eina_ustringshare.h b/src/include/eina_ustringshare.h
index 2bccfc2..1036573 100644
--- a/src/include/eina_ustringshare.h
+++ b/src/include/eina_ustringshare.h
@@ -74,8 +74,6 @@
  * memory fragmentation, so a win all-around.
  *
  * For more information, you can look at the @ref tutorial_ustringshare_page.
- *
- * @{
  */
 
 /**
@@ -199,8 +197,4 @@ static inline Eina_Bool  eina_ustringshare_replace_length(const Eina_Unicode **p
  * @}
  */
 
-/**
- * @}
- */
-
 #endif /* EINA_STRINGSHARE_H_ */
diff --git a/src/lib/eina_object.c b/src/lib/eina_object.c
index 1028a8e..afa2ab9 100644
--- a/src/lib/eina_object.c
+++ b/src/lib/eina_object.c
@@ -452,7 +452,7 @@ _eina_class_range_repack(void *dst, void *src, void *data)
 }
 
 /**
- * @}
+ * @endcond
  */
 
 Eina_Bool