doc: apply one comment to all members of a group
authorThomas Monjalon <thomas.monjalon@6wind.com>
Wed, 17 Sep 2014 16:11:12 +0000 (18:11 +0200)
committerThomas Monjalon <thomas.monjalon@6wind.com>
Mon, 29 Sep 2014 14:34:58 +0000 (16:34 +0200)
A doxygen group begins with /**@{*/ and ends with /**@}*/.
By enabling DISTRIBUTE_GROUP_DOC, the first comment is applied
to each undocumented member of the group.

Signed-off-by: Thomas Monjalon <thomas.monjalon@6wind.com>
doc/doxy-api.conf
lib/librte_port/rte_port.h

index 63dc64d..124fc68 100644 (file)
@@ -63,6 +63,7 @@ ENABLE_PREPROCESSING    = YES
 MACRO_EXPANSION         = YES
 EXPAND_ONLY_PREDEF      = YES
 EXTRACT_STATIC          = YES
+DISTRIBUTE_GROUP_DOC    = YES
 HIDE_UNDOC_MEMBERS      = YES
 HIDE_UNDOC_CLASSES      = YES
 HIDE_SCOPE_NAMES        = YES
index 6bd5039..d84e5a1 100644 (file)
@@ -50,7 +50,7 @@ extern "C" {
 #include <stdint.h>
 #include <rte_mbuf.h>
 
-/**
+/**@{
  * Macros to allow accessing metadata stored in the mbuf headroom
  * just beyond the end of the mbuf data structure returned by a port
  */
@@ -71,6 +71,7 @@ extern "C" {
        (&RTE_MBUF_METADATA_UINT32(mbuf, offset))
 #define RTE_MBUF_METADATA_UINT64_PTR(mbuf, offset)         \
        (&RTE_MBUF_METADATA_UINT64(mbuf, offset))
+/**@}*/
 
 /*
  * Port IN