Merge pull request #11437 from hugueskamba/hk-harmonize-doxygen-grouping

Harmonise Doxygen comments in drivers, events, platform and rtos dirs

Author: 0xc0170

drivers/AnalogIn.h

@@ -28,7 +28,7 @@
 namespace mbed {
 /** \defgroup mbed-os-public Public API */
 
-/** \addtogroup drivers-public-api Drivers
+/** \defgroup drivers-public-api Drivers
  * \ingroup mbed-os-public
  */
 

drivers/AnalogOut.h

@@ -25,8 +25,6 @@
 #include "platform/PlatformMutex.h"
 
 namespace mbed {
-/** \addtogroup drivers-public-api */
-
 /**
  * \defgroup drivers_AnalogOut AnalogOut class
  * \ingroup drivers-public-api-gpio

drivers/Ethernet.h

@@ -23,9 +23,10 @@
 #if DEVICE_ETHERNET || defined(DOXYGEN_ONLY)
 
 namespace mbed {
-/** \ingroup mbed-os-public */
+
 /** \addtogroup drivers-public-api */
 /** @{*/
+
 /**
  * \defgroup drivers_Ethernet Ethernet class
  * @{

drivers/FlashIAP.h

@@ -49,9 +49,9 @@ extern uint32_t Load$$LR$$LR_IROM1$$Limit[];
 
 namespace mbed {
 
-/** \ingroup mbed-os-public */
 /** \addtogroup drivers-public-api */
 /** @{*/
+
 /**
  * \defgroup drivers_FlashIAP FlashIAP class
  * @{

drivers/I2CSlave.h

@@ -25,7 +25,7 @@
 
 namespace mbed {
 /**
- * \addtogroup drivers_I2CSlave I2CSlave class
+ * \defgroup drivers_I2CSlave I2CSlave class
  * \ingroup drivers-public-api-i2c
  * @{
  */

drivers/LowPowerTimeout.h

@@ -27,7 +27,7 @@
 
 namespace mbed {
 /**
- * \addtogroup drivers_LowPowerTimeout LowPowerTimeout class
+ * \defgroup drivers_LowPowerTimeout LowPowerTimeout class
  * \ingroup drivers-public-api-ticker
  * @{
  */

drivers/LowPowerTimer.h

@@ -27,7 +27,7 @@
 
 namespace mbed {
 /**
- * \addtogroup drivers_LowPowerTimer LowPowerTimer class
+ * \defgroup drivers_LowPowerTimer LowPowerTimer class
  * \ingroup drivers-public-api-ticker
  * @{
  */

drivers/MbedCRC.h

@@ -40,7 +40,6 @@ but we check for ( width < 8) before performing shift, so it should not be an is
 #endif
 
 namespace mbed {
-/** \ingroup mbed-os-public */
 /** \addtogroup drivers-public-api */
 /** @{*/
 /**

drivers/ResetReason.h

@@ -22,9 +22,9 @@
 #include "reset_reason_api.h"
 
 namespace mbed {
-/** \ingroup mbed-os-public */
 /** \addtogroup drivers-public-api */
 /** @{*/
+
 /**
  * \defgroup drivers_ResetReason ResetReason class
  * @{

drivers/SPI.h

@@ -46,7 +46,7 @@
 
 namespace mbed {
 /**
- * \addtogroup drivers_SPI SPI class
+ * \defgroup drivers_SPI SPI class
  * \ingroup drivers-public-api-spi
  * @{
  */

drivers/Ticker.h

@@ -26,7 +26,7 @@
 
 namespace mbed {
 /**
- * \addtogroup drivers_Ticker Ticker class
+ * \defgroup drivers_Ticker Ticker class
  * \ingroup drivers-public-api-ticker
  * @{
  */

drivers/Timeout.h

@@ -22,7 +22,7 @@
 
 namespace mbed {
 /**
- * \addtogroup drivers_Timeout Timeout class
+ * \defgroup drivers_Timeout Timeout class
  * \ingroup drivers-public-api-ticker
  * @{
  */

drivers/Timer.h

@@ -23,7 +23,7 @@
 
 namespace mbed {
 /**
- * \addtogroup drivers_Timer Timer class
+ * \defgroup drivers_Timer Timer class
  * \ingroup drivers-public-api-ticker
  * @{
  */

drivers/TimerEvent.h

@@ -22,7 +22,7 @@
 
 namespace mbed {
 /**
- * \addtogroup drivers_TimerEvent TimerEvent class
+ * \defgroup drivers_TimerEvent TimerEvent class
  * \ingroup drivers-public-api-ticker
  * @{
  */

drivers/internal/MIDIMessage.h

@@ -43,7 +43,7 @@
 
 /**
  * \defgroup drivers_MIDIMessage MIDIMessage class
- * \ingroup drivers-internal-usb
+ * \ingroup drivers-internal-api-usb
  * @{
  */
 

drivers/internal/TableCRC.h

@@ -22,7 +22,6 @@
 
 namespace mbed {
 /** \addtogroup drivers-internal-api
- * \ingroup mbed-os-internal
  * @{
  */
 

events/Event.h

@@ -21,8 +21,7 @@
 #include "platform/mbed_assert.h"
 
 namespace events {
-/**
- * \addtogroup events-public-api Events
+/** \defgroup events-public-api Events
  * \ingroup mbed-os-public
  * @{
  */

events/UserAllocatedEvent.h

@@ -23,8 +23,7 @@
 
 namespace events {
 /**
- * \addtogroup events-public-api Events
- * \ingroup mbed-os-public
+ * \addtogroup events-public-api
  * @{
  */
 template <typename F, typename A>

events/mbed_shared_queues.h

@@ -19,7 +19,6 @@
 #include "events/EventQueue.h"
 
 namespace mbed {
-/** \ingroup mbed-os-public */
 /** \addtogroup events-public-api */
 /** @{*/
 

platform/ATCmdParser.h

@@ -27,8 +27,6 @@
 #include "platform/FileHandle.h"
 
 namespace mbed {
-
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api Platform */
 /** @{*/
 /**

platform/CThunk.h

@@ -1,18 +1,4 @@
-/** \ingroup mbed-os-public */
-/** \addtogroup platform-public-api */
-/** @{*/
-/**
- * \defgroup platform_CThunk CThunk class
- * @{
- */
-/* General C++ Object Thunking class
- *
- * - allows direct callbacks to non-static C++ class functions
- * - keeps track for the corresponding class instance
- * - supports an optional context parameter for the called function
- * - ideally suited for class object receiving interrupts (NVIC_SetVector)
- *
- * Copyright (c) 2014-2019 ARM Limited
+/* Copyright (c) 2014-2019 ARM Limited
  * SPDX-License-Identifier: Apache-2.0
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
@@ -28,6 +14,15 @@
  * limitations under the License.
  */
 
+
+/** \addtogroup platform-public-api */
+/** @{*/
+
+/**
+ * \defgroup platform_CThunk CThunk class
+ * @{
+ */
+
 /* General C++ Object Thunking class
  *
  * - allows direct callbacks to non-static C++ class functions

platform/Callback.h

@@ -24,7 +24,6 @@
 #include "platform/mbed_toolchain.h"
 
 namespace mbed {
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
 /**

platform/CircularBuffer.h

@@ -51,7 +51,6 @@ struct is_unsigned<unsigned long long> {
 };
 };
 
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
 /**

platform/CriticalSectionLock.h

@@ -21,8 +21,6 @@
 #include "platform/mbed_toolchain.h"
 
 namespace mbed {
-
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
 /**

platform/DeepSleepLock.h

@@ -21,8 +21,6 @@
 #include <stdint.h>
 
 namespace mbed {
-
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
 /**

platform/DirHandle.h

@@ -22,7 +22,6 @@
 #include "platform/NonCopyable.h"
 
 namespace mbed {
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
 /**

platform/FunctionPointer.h

@@ -23,7 +23,6 @@
 #include <stdint.h>
 
 namespace mbed {
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
 /**

platform/LocalFileSystem.h

@@ -26,7 +26,6 @@
 #include "platform/NonCopyable.h"
 
 namespace mbed {
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
 /**

platform/NonCopyable.h

@@ -24,9 +24,9 @@
 
 namespace mbed {
 
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
+
 /**
  * \defgroup platform_NonCopyable NonCopyable class
  * @{

platform/PlatformMutex.h

@@ -19,7 +19,6 @@
 
 #include "platform/NonCopyable.h"
 
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
 

platform/ScopedLock.h

@@ -21,9 +21,9 @@
 
 namespace mbed {
 
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
+
 /**
  * \defgroup platform_ScopedLock ScopedLock functions
  * @{

platform/ScopedRamExecutionLock.h

@@ -21,7 +21,6 @@
 
 namespace mbed {
 
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
 

platform/ScopedRomWriteLock.h

@@ -21,7 +21,6 @@
 
 namespace mbed {
 
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
 

platform/SingletonPtr.h

@@ -1,11 +1,3 @@
-
-/** \ingroup mbed-os-public */
-/** \addtogroup platform-public-api */
-/** @{*/
-/**
- * \defgroup platform_SingletonPtr SingletonPtr class
- * @{
- */
 /* mbed Microcontroller Library
  * Copyright (c) 2006-2019 ARM Limited
  * SPDX-License-Identifier: Apache-2.0
@@ -38,6 +30,14 @@
 extern osMutexId_t singleton_mutex_id;
 #endif
 
+/** \addtogroup platform-public-api */
+/** @{*/
+
+/**
+ * \defgroup platform_SingletonPtr SingletonPtr class
+ * @{
+ */
+
 /** Lock the singleton mutex
  *
  * This function is typically used to provide

platform/Span.h

@@ -26,9 +26,9 @@
 
 namespace mbed {
 
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
+
 /**
  * \defgroup platform_Span Span class
  * @{

platform/Stream.h

@@ -25,9 +25,9 @@
 #include <cstdarg>
 
 namespace mbed {
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
+
 /**
  * \defgroup platform_Stream Stream class
  * @{

platform/Transaction.h

@@ -20,9 +20,9 @@
 #include "platform/platform.h"
 
 namespace mbed {
-/** \ingroup mbed-os-public */
 /** \addtogroup platform-public-api */
 /** @{*/
+
 /**
  * \defgroup platform_Transaction Transaction class
  * @{

platform/internal/CThunkBase.h

@@ -18,7 +18,7 @@
 #ifndef __CTHUNK_BASE_H__
 #define __CTHUNK_BASE_H__
 
-/** \addtogroup platform-internal-api Platform
+/** \defgroup platform-internal-api Platform
  * \ingroup mbed-os-internal
  */