From 5523ec67f3ccd017728f090fb5d1244623f2e243 Mon Sep 17 00:00:00 2001
From: Ludwig Ortmann <ludwig.ortmann@fu-berlin.de>
Date: Sat, 25 Oct 2014 15:37:04 +0200
Subject: [PATCH] doc: make peripheral interfaces modules

also remove `@file` parameters
---
 drivers/include/periph/adc.h    | 1 +
 drivers/include/periph/cpuid.h  | 5 +++--
 drivers/include/periph/gpio.h   | 3 ++-
 drivers/include/periph/i2c.h    | 1 +
 drivers/include/periph/pwm.h    | 3 ++-
 drivers/include/periph/random.h | 1 +
 drivers/include/periph/rtc.h    | 3 ++-
 drivers/include/periph/rtt.h    | 4 +++-
 drivers/include/periph/spi.h    | 1 +
 drivers/include/periph/timer.h  | 3 ++-
 drivers/include/periph/uart.h   | 3 ++-
 11 files changed, 20 insertions(+), 8 deletions(-)

diff --git a/drivers/include/periph/adc.h b/drivers/include/periph/adc.h
index 386011b8d6..b7c0bb04b0 100644
--- a/drivers/include/periph/adc.h
+++ b/drivers/include/periph/adc.h
@@ -7,6 +7,7 @@
  */
 
 /**
+ * @defgroup    driver_periph_adc ADC
  * @ingroup     driver_periph
  * @brief       Low-level ADC peripheral driver
  * @{
diff --git a/drivers/include/periph/cpuid.h b/drivers/include/periph/cpuid.h
index fcae72b370..6b3f143ada 100644
--- a/drivers/include/periph/cpuid.h
+++ b/drivers/include/periph/cpuid.h
@@ -7,10 +7,11 @@
  */
 
 /**
- * @addtogroup  driver_periph
+ * @defgroup    driver_periph_cpuid CPUID
+ * @ingroup     driver_periph
  * @{
  *
- * @file        periph/cpuid.h
+ * @file
  * @brief       Provides access the CPU's serial number
  *
  * @author      Martine Lenders <mlenders@inf.fu-berlin.de>
diff --git a/drivers/include/periph/gpio.h b/drivers/include/periph/gpio.h
index 26c0c9afdc..f766f73d11 100644
--- a/drivers/include/periph/gpio.h
+++ b/drivers/include/periph/gpio.h
@@ -7,11 +7,12 @@
  */
 
 /**
+ * @defgroup    driver_periph_gpio GPIO
  * @ingroup     driver_periph
  * @brief       Low-level GPIO peripheral driver
  * @{
  *
- * @file        periph/gpio.h
+ * @file
  * @brief       Low-level GPIO peripheral driver interface definitions
  *
  * @author      Hauke Petersen <hauke.petersen@fu-berlin.de>
diff --git a/drivers/include/periph/i2c.h b/drivers/include/periph/i2c.h
index 326f387b35..860391d171 100644
--- a/drivers/include/periph/i2c.h
+++ b/drivers/include/periph/i2c.h
@@ -7,6 +7,7 @@
  */
 
 /**
+ * @defgroup    driver_periph_i2c I2C
  * @ingroup     driver_periph
  * @brief       Low-level I2C peripheral driver
  * @{
diff --git a/drivers/include/periph/pwm.h b/drivers/include/periph/pwm.h
index 1c628a6d1d..aae23e8495 100644
--- a/drivers/include/periph/pwm.h
+++ b/drivers/include/periph/pwm.h
@@ -7,11 +7,12 @@
  */
 
 /**
+ * @defgroup    driver_periph_pwm PWM
  * @ingroup     driver_periph
  * @brief       Low-level PWM peripheral driver
  * @{
  *
- * @file        periph/pwm.h
+ * @file
  * @brief       Low-level PWM peripheral driver interface definitions
  *
  * @author      Hauke Petersen <hauke.petersen@fu-berlin.de>
diff --git a/drivers/include/periph/random.h b/drivers/include/periph/random.h
index fe753a4d8d..e49c8381c4 100644
--- a/drivers/include/periph/random.h
+++ b/drivers/include/periph/random.h
@@ -7,6 +7,7 @@
  */
 
 /**
+ * @defgroup    driver_periph_random Random
  * @ingroup     driver_periph
  * @{
  *
diff --git a/drivers/include/periph/rtc.h b/drivers/include/periph/rtc.h
index 3e9add7cbc..128484d530 100644
--- a/drivers/include/periph/rtc.h
+++ b/drivers/include/periph/rtc.h
@@ -7,11 +7,12 @@
  */
 
 /**
+ * @defgroup    driver_periph_rtc RTC
  * @ingroup     driver_periph
  * @brief       Low-level RTC (Real Time Clock) peripheral driver
  * @{
  *
- * @file        rtc.h
+ * @file
  * @brief       Low-level RTC peripheral driver interface definitions
  *
  * @author      Thomas Eichinger <thomas.eichinger@fu-berlin.de>
diff --git a/drivers/include/periph/rtt.h b/drivers/include/periph/rtt.h
index 22e5fa1ae1..23884797e9 100644
--- a/drivers/include/periph/rtt.h
+++ b/drivers/include/periph/rtt.h
@@ -5,11 +5,13 @@
  * Public License v2.1. See the file LICENSE in the top level directory for more
  * details.
  */
+
 /**
+ * @defgroup    driver_periph_rtt RTT
  * @ingroup     driver_periph
  * @{
  *
- * @file        rtt.h
+ * @file
  * @brief       Low-level RTT (Real Time Timer) peripheral driver interface
  *              definitions
  *
diff --git a/drivers/include/periph/spi.h b/drivers/include/periph/spi.h
index aae03b47f5..0acf736dbd 100644
--- a/drivers/include/periph/spi.h
+++ b/drivers/include/periph/spi.h
@@ -7,6 +7,7 @@
  */
 
 /**
+ * @defgroup    driver_periph_spi SPI
  * @ingroup     driver_periph
  * @brief       Low-level SPI peripheral driver
  * @{
diff --git a/drivers/include/periph/timer.h b/drivers/include/periph/timer.h
index 3659724623..b4b1348a6d 100644
--- a/drivers/include/periph/timer.h
+++ b/drivers/include/periph/timer.h
@@ -7,11 +7,12 @@
  */
 
 /**
+ * @defgroup    driver_periph_timer Timer
  * @ingroup     driver_periph
  * @brief       Low-level timer peripheral driver
  * @{
  *
- * @file        periph/timer.h
+ * @file
  * @brief       Low-level timer peripheral driver interface definitions
  *
  * @author      Hauke Petersen <hauke.petersen@fu-berlin.de>
diff --git a/drivers/include/periph/uart.h b/drivers/include/periph/uart.h
index 991a519f9d..1ef0e4945c 100644
--- a/drivers/include/periph/uart.h
+++ b/drivers/include/periph/uart.h
@@ -7,11 +7,12 @@
  */
 
 /**
+ * @defgroup    driver_periph_uart UART
  * @ingroup     driver_periph
  * @brief       Low-level UART peripheral driver
  * @{
  *
- * @file        periph/uart.h
+ * @file
  * @brief       Low-level UART peripheral driver interface definitions
  *
  * @author      Hauke Petersen <hauke.petersen@fu-berlin.de>
-- 
GitLab