Rebalance our exposed headers such that everything is nested properly

  between extern "C" blocks and doxygen blocks, that we never include
  other headers within our own header's extern "C" block, that we always
  tag the entire file contents for doxygen (within the APR_HEADER_H
  only-once block), and generally clean up doxygen so that it is all
  consistent and generates respectable (although not yet 'great') results.

  Major TODO after 0.9.2 releases; fill in the apr.h APR_HAVE/APR_HAS
  and apr_type_t documentation!!!


git-svn-id: http://svn.apache.org/repos/asf/apr/apr/trunk@64397 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 9 insertions, 8 deletions

diff --git a/include/apr_ring.h b/include/apr_ring.h
index 39d144ba7..2f0984b2a 100644
--- a/include/apr_ring.h
+++ b/include/apr_ring.h
@@ -61,12 +61,14 @@
  * We'd use Dean's code directly if we could guarantee the
  * availability of inline functions.
  */
+
+#ifndef APR_RING_H
+#define APR_RING_H
+
 /**
  * @file apr_ring.h
  * @brief APR Rings
  */
-#ifndef APR_RING_H
-#define APR_RING_H
 
 /*
  * for offsetof()
@@ -74,14 +76,11 @@
 #include "apr_general.h"
 
 /**
- * @defgroup APR_Rings Rings
- * @ingroup APR
- * @{
- */
-
-/**
+ * @defgroup apr_ring Ring Macro Implementations
+ * @ingroup APR 
  * A ring is a kind of doubly-linked list that can be manipulated
  * without knowing where its head is.
+ * @{
  */
 
 /**
@@ -544,5 +543,7 @@
  */
 #define APR_RING_CHECK_ELEM(ep, elem, link, msg)
 #endif
+
 /** @} */ 
+
 #endif /* !APR_RING_H */