Fix doxygen 1.8.17 warnings (ARMmbed#2546)

Fix warnings created by doxygen 1.8.17 that is used in Ubuntu 20.04.
artokin · Jan 15, 2021 · d59dc5d · d59dc5d
1 parent 1e0beb3
commit d59dc5d
Show file tree

Hide file tree

Showing 7 changed files with 390 additions and 197 deletions.
diff --git a/Doxyfile b/Doxyfile
diff --git a/nanostack/mac_api.h b/nanostack/mac_api.h
@@ -78,7 +78,7 @@ typedef enum {
 } mlme_primitive;
 
 /**
- * \struct mac_description_storage_size_t
+ * \struct mac_description_storage_size_s
  * \brief Container for MAC storage sizes.
  */
 typedef struct mac_description_storage_size_s {
@@ -305,7 +305,7 @@ struct mac_api_s {
 };
 
 /**
- * \struct mac_statistics_t
+ * \struct mac_statistics_s
  * \brief MAC statistics structure.
  */
 typedef struct mac_statistics_s {

diff --git a/nanostack/net_interface.h b/nanostack/net_interface.h
@@ -103,7 +103,7 @@ typedef enum arm_library_event_type_e {
 #define SOCKET_BIND_DONE                    SOCKET_CONNECT_DONE      /**< Backward compatibility */
 #define SOCKET_BIND_FAIL                    SOCKET_CONNECT_FAIL      /**< Backward compatibility */
 #define SOCKET_BIND_AUTH_FAIL               SOCKET_CONNECT_AUTH_FAIL /**< Backward compatibility */
-/* @} */
+/** @} */
 
 /** Network security levels. */
 typedef enum net_security_t {
@@ -1228,3 +1228,4 @@ extern const cca_threshold_table_s *arm_nwk_get_cca_threshold_table(int8_t inter
 }
 #endif
 #endif /* NET_INTERFACE_H_ */
+
diff --git a/nanostack/net_nvm_api.h b/nanostack/net_nvm_api.h
@@ -89,7 +89,7 @@ typedef enum pana_client_nvm_update_process_t {
 } pana_client_nvm_update_process_t;
 
 /*!
- * \struct wpan_nvm_params_t
+ * \struct wpan_nvm_params
  * \brief Network nvm parameters.
  */
 typedef struct wpan_nvm_params {

diff --git a/nanostack/net_polling_api.h b/nanostack/net_polling_api.h
@@ -52,7 +52,7 @@ extern "C" {
 #endif
 
 /*!
- * \enum net_host_mode_t
+ * \enum net_host_mode
  * \brief Sleepy host states.
  */
 typedef enum net_host_mode {

diff --git a/nanostack/ns_mdns_api.h b/nanostack/ns_mdns_api.h
@@ -36,7 +36,7 @@ typedef struct ns_mdns *ns_mdns_t;  /**< Instance */
 typedef struct ns_mdns_service *ns_mdns_service_t;  /**< Service instance */
 
 /*!
- * \struct ns_mdns_service_param_t
+ * \struct ns_mdns_service_param
  * \brief Structure for mDNS service parameters
  */
 typedef struct ns_mdns_service_param {

diff --git a/nanostack/socket_api.h b/nanostack/socket_api.h
@@ -196,7 +196,7 @@ typedef struct socket_callback_t {
 } socket_callback_t;
 
 /*!
- * \struct ns_msghdr_t
+ * \struct ns_msghdr
  * \brief Normal IP socket message structure for socket_recvmsg() and socket_sendmsg().
  */
 
@@ -211,7 +211,7 @@ typedef struct ns_msghdr {
 } ns_msghdr_t;
 
 /*!
- * \struct ns_cmsghdr_t
+ * \struct ns_cmsghdr
  * \brief Control messages.
  */
 typedef struct ns_cmsghdr {
@@ -242,7 +242,7 @@ typedef struct ns_cmsghdr {
 #define NS_MSG_LEGACY0  0x4000
 ///@}
 /*!
- * \struct ns_in6_pktinfo_t
+ * \struct ns_in6_pktinfo
  * \brief IPv6 packet info which is used for socket_recvmsg() socket_sendmsg().
  */
 typedef struct ns_in6_pktinfo {