doxygen improvements

12 files changed, 9 insertions, 57 deletions

diff --git a/include/opkele/association.h b/include/opkele/association.h
index ef0df42..a8f3915 100644
--- a/include/opkele/association.h
+++ b/include/opkele/association.h
@@ -11,5 +11,2 @@
 
-/**
- * @brief the main opkele namespace
- */
 namespace opkele {
@@ -60,25 +57,7 @@ namespace opkele {
 
-	    /**
-	     * @overload association_t::server()
-	     */
 	    virtual string server() const { return _server; }
-	    /**
-	     * @overload association_t::handle()
-	     */
 	    virtual string handle() const { return _handle; }
-	    /**
-	     * @overload association_t::assoc_type()
-	     */
 	    virtual string assoc_type() const { return _assoc_type; }
-	    /**
-	     * @overload association_t::secret()
-	     */
 	    virtual secret_t secret() const { return _secret; }
-	    /**
-	     * @overload association_t::expires_in()
-	     */
 	    virtual int expires_in() const { return _expires-time(0); }
-	    /**
-	     * @overload association_t::stateless()
-	     */
 	    virtual bool stateless() const { return _stateless; }
diff --git a/include/opkele/consumer.h b/include/opkele/consumer.h
index f32509e..fdb6119 100644
--- a/include/opkele/consumer.h
+++ b/include/opkele/consumer.h
@@ -11,5 +11,2 @@
 
-/**
- * @brief the main opkele namespace
- */
 namespace opkele {
diff --git a/include/opkele/data.h b/include/opkele/data.h
index 7fc635b..d0b0516 100644
--- a/include/opkele/data.h
+++ b/include/opkele/data.h
@@ -3,4 +3,10 @@
 
+/**
+ * @brief the main opkele namespace
+ */
 namespace opkele {
 
+    /**
+     * @brief internal data opkele namespace
+     */
     namespace data {
diff --git a/include/opkele/exception.h b/include/opkele/exception.h
index 9fc9bd3..0150e6b 100644
--- a/include/opkele/exception.h
+++ b/include/opkele/exception.h
@@ -55,5 +55,2 @@
 
-/*
- * @brief the main opkele namespace
- */
 namespace opkele {
diff --git a/include/opkele/extension.h b/include/opkele/extension.h
index f547555..ea0c74c 100644
--- a/include/opkele/extension.h
+++ b/include/opkele/extension.h
@@ -10,5 +10,2 @@
 
-/**
- * @brief the main opkele namespace
- */
 namespace opkele {
diff --git a/include/opkele/extension_chain.h b/include/opkele/extension_chain.h
index 955f4d5..f0eea94 100644
--- a/include/opkele/extension_chain.h
+++ b/include/opkele/extension_chain.h
@@ -11,5 +11,2 @@
 
-/**
- * @brief the main opkele namespace
- */
 namespace opkele {
@@ -33,13 +30,4 @@ namespace opkele {
 
-	    /**
-	     * Implementation of consumer's checkid hook
-	     */
 	    virtual void checkid_hook(params_t& p,const string& identity);
-	    /**
-	     * Implementation of consumer's id_res hook
-	     */
 	    virtual void id_res_hook(const params_t& p,const params_t& sp,const string& identity);
-	    /**
-	     * Implementation of server's checkid_hook
-	     */
 	    virtual void checkid_hook(const params_t& pin,params_t& pout);
diff --git a/include/opkele/server.h b/include/opkele/server.h
index 598eb47..e7e5bb3 100644
--- a/include/opkele/server.h
+++ b/include/opkele/server.h
@@ -11,5 +11,2 @@
 
-/**
- * @brief the main opkele namespace
- */
 namespace opkele {
diff --git a/include/opkele/sreg.h b/include/opkele/sreg.h
index 6713ef7..df37a86 100644
--- a/include/opkele/sreg.h
+++ b/include/opkele/sreg.h
@@ -10,5 +10,2 @@
 
-/**
- * @brief the main opkele namespace
- */
 namespace opkele {
diff --git a/include/opkele/types.h b/include/opkele/types.h
index ba06776..757c0af 100644
--- a/include/opkele/types.h
+++ b/include/opkele/types.h
@@ -14,5 +14,2 @@
 
-/**
- * @brief the main opkele namespace
- */
 namespace opkele {
diff --git a/include/opkele/util.h b/include/opkele/util.h
index 2a7a859..edc1859 100644
--- a/include/opkele/util.h
+++ b/include/opkele/util.h
@@ -13,2 +13,5 @@ namespace opkele {
 
+    /**
+     * @brief opkele utils namespace
+     */
     namespace util {
diff --git a/include/opkele/xconsumer.h b/include/opkele/xconsumer.h
index 14a8aaa..42796c0 100644
--- a/include/opkele/xconsumer.h
+++ b/include/opkele/xconsumer.h
@@ -11,5 +11,2 @@
 
-/**
- * @brief the main opkele namespace
- */
 namespace opkele {
diff --git a/include/opkele/xserver.h b/include/opkele/xserver.h
index e29bfe6..c645d56 100644
--- a/include/opkele/xserver.h
+++ b/include/opkele/xserver.h
@@ -11,5 +11,2 @@
 
-/**
- * @brief the main opkele namespace
- */
 namespace opkele {