doc: add prefix to module descriptions

dlech · dlech · commit 3b77f700f0b1 · 2020-08-21T14:03:23.000-05:00
This makes it easier to see how modules are grouped in the HTML docs.
diff --git a/lib/pbio/include/pbdrv/adc.h b/lib/pbio/include/pbdrv/adc.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2018-2020 The Pybricks Authors
 
 /**
- * @addtogroup AnalogDriver Analog/digital converter I/O driver
+ * @addtogroup AnalogDriver Driver: Analog/digital converter (ADC)
  * @{
  */
 
diff --git a/lib/pbio/include/pbdrv/battery.h b/lib/pbio/include/pbdrv/battery.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2018-2020 The Pybricks Authors
 
 /**
- * @addtogroup BatteryDriver Battery I/O driver
+ * @addtogroup BatteryDriver Driver: Battery
  * @{
  */
 
diff --git a/lib/pbio/include/pbdrv/bluetooth.h b/lib/pbio/include/pbdrv/bluetooth.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2018-2020 The Pybricks Authors
 
 /**
- * @addtogroup ButtonDriver Button I/O driver
+ * @addtogroup BluetoothDriver Driver: Bluetooth
  * @{
  */
 
diff --git a/lib/pbio/include/pbdrv/button.h b/lib/pbio/include/pbdrv/button.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2018-2020 The Pybricks Authors
 
 /**
- * @addtogroup ButtonDriver Button I/O driver
+ * @addtogroup ButtonDriver Driver: Button
  * @{
  */
 
diff --git a/lib/pbio/include/pbdrv/counter.h b/lib/pbio/include/pbdrv/counter.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2019-2020 The Pybricks Authors
 
 /**
- * @addtogroup CounterDriver Counter driver
+ * @addtogroup CounterDriver Driver: Counter
  * @{
  */
 
diff --git a/lib/pbio/include/pbdrv/gpio.h b/lib/pbio/include/pbdrv/gpio.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2018-2020 The Pybricks Authors
 
 /**
- * @addtogroup GPIODriver GPIO driver
+ * @addtogroup GPIODriver Driver: General Purpose I/O (GPIO)
  * @{
  */
 
diff --git a/lib/pbio/include/pbdrv/ioport.h b/lib/pbio/include/pbdrv/ioport.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2018-2020 The Pybricks Authors
 
 /**
- * @addtogroup IOPortDriver I/O Port I/O driver
+ * @addtogroup IOPortDriver Driver: I/O Port
  * @{
  */
 
diff --git a/lib/pbio/include/pbdrv/led.h b/lib/pbio/include/pbdrv/led.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2020 The Pybricks Authors
 
 /**
- * @addtogroup LEDDriver LED I/O driver
+ * @addtogroup LEDDriver Driver: Light Emitting Diode (LED)
  * @{
  */
 
diff --git a/lib/pbio/include/pbdrv/motor.h b/lib/pbio/include/pbdrv/motor.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2018-2020 The Pybricks Authors
 
 /**
- * @addtogroup MotorDriver Motor I/O driver
+ * @addtogroup MotorDriver Driver: Motor
  * @{
  */
 
diff --git a/lib/pbio/include/pbdrv/pwm.h b/lib/pbio/include/pbdrv/pwm.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2020 The Pybricks Authors
 
 /**
- * @addtogroup PWMDriver Pulse width modulation (PWM) I/O driver
+ * @addtogroup PWMDriver Driver: Pulse width modulation (PWM)
  * @{
  */
 
diff --git a/lib/pbio/include/pbdrv/reset.h b/lib/pbio/include/pbdrv/reset.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2018-2020 The Pybricks Authors
 
 /**
- * @addtogroup ResetDriver System Power and Reset Driver
+ * @addtogroup ResetDriver Driver: System Power and Reset
  * @{
  */
 
diff --git a/lib/pbio/include/pbdrv/uart.h b/lib/pbio/include/pbdrv/uart.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2018-2020 The Pybricks Authors
 
 /**
- * @addtogroup UARTDriver UART I/O driver
+ * @addtogroup UARTDriver Driver: Universal Asynchronous Receiver/Transmitter (UART)
  * @{
  */
 
diff --git a/lib/pbio/include/pbsys/battery.h b/lib/pbio/include/pbsys/battery.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2020 The Pybricks Authors
 
 /**
- * @addtogroup SystemBattery System Battery Monitor
+ * @addtogroup SystemBattery System: Battery Monitor
  * @{
  */
 
diff --git a/lib/pbio/include/pbsys/hmi.h b/lib/pbio/include/pbsys/hmi.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2020 The Pybricks Authors
 
 /**
- * @addtogroup SystemHMI System Human Machine Interface (HMI)
+ * @addtogroup SystemHMI System: Human Machine Interface (HMI)
  * @{
  */
 
diff --git a/lib/pbio/include/pbsys/status.h b/lib/pbio/include/pbsys/status.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2020 The Pybricks Authors
 
 /**
- * @addtogroup SystemStatus System-wide Status
+ * @addtogroup SystemStatus System: Status
  * @{
  */
 
diff --git a/lib/pbio/include/pbsys/supervisor.h b/lib/pbio/include/pbsys/supervisor.h
@@ -2,7 +2,7 @@
 // Copyright (c) 2020 The Pybricks Authors
 
 /**
- * @addtogroup SystemSupervisor System Supervisor
+ * @addtogroup SystemSupervisor System: Supervisor
  * @{
  */
 
