From 43c5b2752377aa092e2bf3eab5f16399424a7954 Mon Sep 17 00:00:00 2001
From: "7u83@mail.ru" <7u83@mail.ru@noemail.net>
Date: Tue, 3 Apr 2018 05:48:44 +0000
Subject: [PATCH] Improved doxy comments

FossilOrigin-Name: c10148fb3be6d967c8b4ca10ab647c8a04b7ca9427ac2f8a781c10526aa5c1ae
---
 actube.workspace |  4 ++--
 src/cw/capwap.h  | 47 ++++++++++++++++++++++++++++++-----------------
 2 files changed, 32 insertions(+), 19 deletions(-)

diff --git a/actube.workspace b/actube.workspace
index b8870938..e0162c79 100644
--- a/actube.workspace
+++ b/actube.workspace
@@ -3,9 +3,9 @@
   <Project Name="ac" Path="ac.project" Active="No"/>
   <Project Name="wtp" Path="wtp.project" Active="No"/>
   <Project Name="mod_cipwap" Path="mod_cipwap.project" Active="No"/>
-  <Project Name="mod_capwap" Path="mod_capwap.project" Active="Yes"/>
+  <Project Name="mod_capwap" Path="mod_capwap.project" Active="No"/>
   <Project Name="mod_cisco" Path="mod_cisco.project" Active="No"/>
-  <Project Name="libcw" Path="libcw.project" Active="No"/>
+  <Project Name="libcw" Path="libcw.project" Active="Yes"/>
   <Project Name="mod_capwap80211" Path="mod_capwap80211.project" Active="No"/>
   <Project Name="mod_fortinet" Path="mod_fortinet.project" Active="No"/>
   <BuildMatrix>
diff --git a/src/cw/capwap.h b/src/cw/capwap.h
index 44d75d44..163a8042 100644
--- a/src/cw/capwap.h
+++ b/src/cw/capwap.h
@@ -50,7 +50,7 @@
  */
 
 /**
- *@defgroup CAPWAPConstants CAPWAP General Constants 
+ *@defgroup CAPWAPConstants General Constants 
  *@brief General constants as defined in RFC5415
  *@{
  */
@@ -71,7 +71,8 @@
 /** CAPWAP Data Port */
 #define CAPWAP_DATA_PPORT 5247
 
-/** CAWPAP DataPort as String */
+/** CAWPAP DataPort as string constant.
+ * @see CAPWAP_DATA_PORT */
 #define CAPWAP_DATA_PORT_STR "5247"
 
 /**@}*/
@@ -79,7 +80,7 @@
 
 
 /**
- *@defgroup CAPWAPHeaderFlags CAPWAP Header Flags
+ *@defgroup CAPWAPHeaderFlags Header Flags
  *@brief The CAPWAP control header flags
  * 
  *@{
@@ -99,7 +100,7 @@
 
 
 /**
- * @defgroup CAPWAPWBIDS CAPWAP Wireless binding IDs
+ * @defgroup CAPWAPWBIDS Wireless binding IDs
  * @{
  */
 #define CAPWAP_WBID_RESERVED1	0
@@ -115,7 +116,7 @@
  
 
 /**
- * @defgroup CAPWAPMessages CAPWAP message types as defined in RFC 5416
+ * @defgroup CAPWAPMessages  Message types as defined in RFC 5416
  * @{
  */
 /**
@@ -186,7 +187,7 @@
 
 
 /**
- * @defgroup CAPWAPMsgElems CAPWAP Message Elements 
+ * @defgroup CAPWAPMsgElems Message Elements 
  * @brief CAPWAP message elements as defined in  RFC 5415
  * @{
  */   
@@ -297,26 +298,38 @@
 #define CW_FLAG_RMAC_SUPPORTED		1
 #define CW_FLAG_RMAC_NOT_SUPPORTED	2
 
-
+/**
+ * @defgroup DESCRIPTORSUBELEM Descriptor sub-elements
+ * @{
+ */
 #define CW_SUBELEM_WTP_HARDWARE_VERSION			0
 #define CW_SUBELEM_WTP_SOFTWARE_VERSION			1
 #define CW_SUBELEM_WTP_BOOTLOADER_VERSION		2
 #define CW_SUBELEM_WTP_OTHERSOFTWARE_VERSION		3
 
 #define CAPWAP_SUBELEM_AC_HARDWARE_VERSION		4
-#define CAPWAP_SUBELEM_AC_SOFTWARE_VERSION			5
-
-
-/* Frame tunnnel mode bits */
-#define CW_WTP_FRAME_TUNNEL_MODE_R	1	/* Reserved */
-#define CW_WTP_FRAME_TUNNEL_MODE_L	2	/* Local bridging */
-#define CW_WTP_FRAME_TUNNEL_MODE_E	4	/* 802.3 mode */
-#define CW_WTP_FRAME_TUNNEL_MODE_N	8	/* native mode */
-
+#define CAPWAP_SUBELEM_AC_SOFTWARE_VERSION		5
+/**
+ * @}
+ */
 
 
 /**
- * @defgroup CAPWAPDiscoveryTypes CAPWAP Discovery Types
+ * @defgroup FRAMETUNNELBITS Frame-tunnel-mode Bits
+ * @{
+ */
+ 
+#define CW_WTP_FRAME_TUNNEL_MODE_R	1	/**< Reserved */
+#define CW_WTP_FRAME_TUNNEL_MODE_L	2	/**< Local bridging */
+#define CW_WTP_FRAME_TUNNEL_MODE_E	4	/**< 802.3 mode */
+#define CW_WTP_FRAME_TUNNEL_MODE_N	8	/**< native mode */
+/**
+ * @}
+ */
+
+
+/**
+ * @defgroup CAPWAPDiscoveryTypes Discovery Types
  * @brief CAPWAP Discovery Types defined in RFC5415
  * @{
  */