summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorQuinn Jensen <quinn.jensen@freescale.com>2007-05-24 18:13:31 -0600
committerQuinn Jensen <quinn.jensen@freescale.com>2007-05-24 18:13:31 -0600
commit057e4ecfe2eb6cf841e5c019cc2e498bb549bf14 (patch)
tree29868e251336775614090aab9c5daeb6776169c3
parent8315d2a76d9c2062242d95d5efff076c3ba3da9c (diff)
CR ENGR00025276: Fix doxygen
Fix doxygen for one set of documents for the supported mxc and imx platforms. http://www.bitshrine.org/gpp/linux-2.6.19.2-mx-unified_doxygen.patch
-rw-r--r--arch/arm/mach-mx27/clock.c9
-rw-r--r--arch/arm/mach-mx27/devices.c4
-rw-r--r--arch/arm/mach-mx27/dma.c4
-rw-r--r--arch/arm/mach-mx27/dpm.c4
-rw-r--r--arch/arm/mach-mx27/gpio_mux.c12
-rw-r--r--arch/arm/mach-mx27/gpio_mux.h4
-rw-r--r--arch/arm/mach-mx27/mm.c25
-rw-r--r--arch/arm/mach-mx27/mx27ads.c4
-rw-r--r--arch/arm/mach-mx27/mx27ads_gpio.c4
-rw-r--r--arch/arm/mach-mx27/mxc_pm.c8
-rw-r--r--arch/arm/mach-mx27/serial.c4
-rw-r--r--arch/arm/mach-mx27/serial.h5
-rw-r--r--arch/arm/mach-mx27/system.c11
-rw-r--r--arch/arm/mach-mx27/time.c8
-rw-r--r--arch/arm/mach-mx27/usb.c7
-rw-r--r--arch/arm/mach-mx3/clock.c6
-rw-r--r--arch/arm/mach-mx3/cpu.c4
-rw-r--r--arch/arm/mach-mx3/dpm.c4
-rw-r--r--arch/arm/mach-mx3/dvfs.c4
-rw-r--r--arch/arm/mach-mx3/iomux.c12
-rw-r--r--arch/arm/mach-mx3/iomux.h8
-rw-r--r--arch/arm/mach-mx3/mm.c4
-rw-r--r--arch/arm/mach-mx3/mx31ads.c4
-rw-r--r--arch/arm/mach-mx3/mx31ads_gpio.c4
-rw-r--r--arch/arm/mach-mx3/mxc_pm.c8
-rw-r--r--arch/arm/mach-mx3/sdma_script_code.h9
-rw-r--r--arch/arm/mach-mx3/sdma_script_code_pass2.h9
-rw-r--r--arch/arm/mach-mx3/serial.c4
-rw-r--r--arch/arm/mach-mx3/serial.h5
-rw-r--r--arch/arm/mach-mx3/system.c11
-rw-r--r--arch/arm/mach-mx3/time.c8
-rw-r--r--arch/arm/mach-mx3/time_priv.h4
-rw-r--r--arch/arm/mach-mx3/usb.c7
-rw-r--r--arch/arm/plat-mxc/cpu_common.c4
-rw-r--r--arch/arm/plat-mxc/dma_mx2.c4
-rw-r--r--arch/arm/plat-mxc/gpio.c4
-rw-r--r--arch/arm/plat-mxc/irq.c5
-rw-r--r--arch/arm/plat-mxc/sdma/dma_sdma.c2
-rw-r--r--arch/arm/plat-mxc/sdma/sdma.c2
-rw-r--r--arch/arm/plat-mxc/sdma/sdma_malloc.c2
-rw-r--r--arch/arm/plat-mxc/spba.c2
-rw-r--r--drivers/media/video/mxc/capture/mxc_v4l2_capture.c2
-rw-r--r--drivers/media/video/mxc/output/mxc_v4l2_output.c2
-rw-r--r--drivers/mxc/pm/dptc.c2
-rw-r--r--drivers/mxc/pm/dptc_mx27.c2
-rw-r--r--drivers/mxc/pm/dvfs_dptc.c2
-rw-r--r--drivers/mxc/pm/dvfs_dptc.h2
-rw-r--r--drivers/mxc/pm/dvfs_dptc_table_mx27.h2
-rw-r--r--drivers/mxc/pm/dvfs_dptc_table_mx31.h2
-rw-r--r--drivers/mxc/pm/dvfs_dptc_table_mx31_27ckih.h2
-rw-r--r--drivers/mxc/pm/dvfs_dptc_table_mx31_rev2.h2
-rw-r--r--drivers/mxc/pmic/mc13783/pmic_adc.c2
-rw-r--r--drivers/mxc/pmic/mc13783/pmic_adc_defs.h2
-rw-r--r--drivers/mxc/pmic/mc13783/pmic_audio.c2
-rw-r--r--drivers/mxc/pmic/mc13783/pmic_battery.c2
-rw-r--r--drivers/mxc/pmic/mc13783/pmic_battery_defs.h2
-rw-r--r--drivers/mxc/pmic/mc13783/pmic_convity.c2
-rw-r--r--drivers/mxc/pmic/mc13783/pmic_light.c2
-rw-r--r--drivers/mxc/pmic/mc13783/pmic_light_defs.h2
-rw-r--r--drivers/mxc/pmic/mc13783/pmic_power.c2
-rw-r--r--drivers/mxc/pmic/mc13783/pmic_power_defs.h2
-rw-r--r--drivers/mxc/pmic/mc13783/pmic_rtc.c2
-rw-r--r--drivers/mxc/pmic/mc13783/pmic_rtc_defs.h2
-rw-r--r--drivers/mxc/security/sahara2/fsl_shw_auth.c2
-rw-r--r--drivers/mxc/security/sahara2/fsl_shw_hash.c2
-rw-r--r--drivers/mxc/security/sahara2/fsl_shw_hmac.c2
-rw-r--r--drivers/mxc/security/sahara2/fsl_shw_rand.c2
-rw-r--r--drivers/mxc/security/sahara2/fsl_shw_sym.c2
-rw-r--r--drivers/mxc/security/sahara2/fsl_shw_user.c2
-rw-r--r--drivers/mxc/security/sahara2/fsl_shw_wrap.c2
-rw-r--r--drivers/mxc/security/sahara2/include/fsl_shw.h2
-rw-r--r--drivers/mxc/security/sahara2/sf_util.c2
-rw-r--r--drivers/serial/mxc_uart.c2
-rw-r--r--drivers/spi/mxc_spi.c4
-rw-r--r--drivers/spi/mxc_spi.h6
-rw-r--r--drivers/spi/mxc_spi_mx27.h12
-rw-r--r--drivers/usb/host/ehci-arc.c3
-rw-r--r--drivers/video/mxc/fs453.c5
-rw-r--r--drivers/video/mxc/fs453.h2
-rw-r--r--drivers/video/mxc/mx2fb.c4
-rw-r--r--include/asm-arm/arch-mxc/board-mx27ads.h8
-rw-r--r--include/asm-arm/arch-mxc/board-mx31ads.h15
-rw-r--r--include/asm-arm/arch-mxc/clock.h6
-rw-r--r--include/asm-arm/arch-mxc/dma.h2
-rw-r--r--include/asm-arm/arch-mxc/dpm.h9
-rw-r--r--include/asm-arm/arch-mxc/dptc.h4
-rw-r--r--include/asm-arm/arch-mxc/dvfs.h4
-rw-r--r--include/asm-arm/arch-mxc/dvfs_dptc_struct.h4
-rw-r--r--include/asm-arm/arch-mxc/gpio.h5
-rw-r--r--include/asm-arm/arch-mxc/hardware.h4
-rw-r--r--include/asm-arm/arch-mxc/io.h4
-rw-r--r--include/asm-arm/arch-mxc/ipu.h2
-rw-r--r--include/asm-arm/arch-mxc/irqs.h4
-rw-r--r--include/asm-arm/arch-mxc/memory.h12
-rw-r--r--include/asm-arm/arch-mxc/mx27.h13
-rw-r--r--include/asm-arm/arch-mxc/mx27_pins.h8
-rw-r--r--include/asm-arm/arch-mxc/mx2_dma.h8
-rw-r--r--include/asm-arm/arch-mxc/mx31.h6
-rw-r--r--include/asm-arm/arch-mxc/mx31_pins.h8
-rw-r--r--include/asm-arm/arch-mxc/mxc.h4
-rw-r--r--include/asm-arm/arch-mxc/mxc_i2c.h2
-rw-r--r--include/asm-arm/arch-mxc/mxc_pf.h2
-rw-r--r--include/asm-arm/arch-mxc/mxc_pm.h2
-rw-r--r--include/asm-arm/arch-mxc/mxc_scc.h2
-rw-r--r--include/asm-arm/arch-mxc/mxc_scc_driver.h2
-rw-r--r--include/asm-arm/arch-mxc/mxc_security_api.h2
-rw-r--r--include/asm-arm/arch-mxc/mxc_uart.h2
-rw-r--r--include/asm-arm/arch-mxc/mxc_v4l2.h2
-rw-r--r--include/asm-arm/arch-mxc/mxc_vpu.h2
-rw-r--r--include/asm-arm/arch-mxc/mxcfb.h2
-rw-r--r--include/asm-arm/arch-mxc/param.h4
-rw-r--r--include/asm-arm/arch-mxc/pm_api.h9
-rw-r--r--include/asm-arm/arch-mxc/pmic_adc.h2
-rw-r--r--include/asm-arm/arch-mxc/pmic_audio.h2
-rw-r--r--include/asm-arm/arch-mxc/pmic_battery.h2
-rw-r--r--include/asm-arm/arch-mxc/pmic_convity.h2
-rw-r--r--include/asm-arm/arch-mxc/pmic_external.h2
-rw-r--r--include/asm-arm/arch-mxc/pmic_light.h2
-rw-r--r--include/asm-arm/arch-mxc/pmic_power.h2
-rw-r--r--include/asm-arm/arch-mxc/pmic_rtc.h2
-rw-r--r--include/asm-arm/arch-mxc/pmic_status.h2
-rw-r--r--include/asm-arm/arch-mxc/sdma.h2
-rw-r--r--include/asm-arm/arch-mxc/spba.h4
-rw-r--r--include/asm-arm/arch-mxc/system.h13
-rw-r--r--include/asm-arm/arch-mxc/vmalloc.h4
-rw-r--r--sound/arm/mxc-alsa-common.h2
-rw-r--r--sound/arm/mxc-alsa-mixer.c2
-rw-r--r--sound/arm/mxc-alsa-pmic.c2
-rw-r--r--sound/arm/mxc-alsa-pmic.h2
129 files changed, 306 insertions, 259 deletions
diff --git a/arch/arm/mach-mx27/clock.c b/arch/arm/mach-mx27/clock.c
index 282b687f4ce0..b66a2da933ff 100644
--- a/arch/arm/mach-mx27/clock.c
+++ b/arch/arm/mach-mx27/clock.c
@@ -11,15 +11,6 @@
* http://www.gnu.org/copyleft/gpl.html
*/
-/*!
- * @file clock.c
- * @brief API for setting up and retrieving clocks.
- *
- * This file contains API for setting up and retrieving clocks.
- *
- * @ingroup CLOCKS
- */
-
#include <linux/module.h>
#include <linux/spinlock.h>
#include <linux/clk.h>
diff --git a/arch/arm/mach-mx27/devices.c b/arch/arm/mach-mx27/devices.c
index ae90cf38a91a..9f210f5dc5cd 100644
--- a/arch/arm/mach-mx27/devices.c
+++ b/arch/arm/mach-mx27/devices.c
@@ -22,10 +22,10 @@
#include <asm/arch/mmc.h>
/*!
- * @file devices.c
+ * @file mach-mx27/devices.c
* @brief device configurations including nor/nand/watchdog for mx27.
*
- * @ingroup MSL
+ * @ingroup MSL_MX27
*/
static void mxc_nop_release(struct device *dev)
diff --git a/arch/arm/mach-mx27/dma.c b/arch/arm/mach-mx27/dma.c
index e57598ebe5ff..e47acb8cc055 100644
--- a/arch/arm/mach-mx27/dma.c
+++ b/arch/arm/mach-mx27/dma.c
@@ -12,9 +12,9 @@
*/
/*!
- *@file dma.c
+ *@file mach-mx27/dma.c
*@brief This file contains the dma parameter which is depend on the platform .
- * @ingroup DMA
+ * @ingroup DMA_MX27
*/
#include <linux/module.h>
diff --git a/arch/arm/mach-mx27/dpm.c b/arch/arm/mach-mx27/dpm.c
index 6e5439a26e23..2a51d204a271 100644
--- a/arch/arm/mach-mx27/dpm.c
+++ b/arch/arm/mach-mx27/dpm.c
@@ -23,11 +23,11 @@
*/
/*!
- * @file dpm.c
+ * @file mach-mx27/dpm.c
*
* @brief This file provides DPM support hooks for the Freescale i.MX27
*
- * @ingroup DPM
+ * @ingroup DPM_MX27
*/
#include <linux/dpm.h>
diff --git a/arch/arm/mach-mx27/gpio_mux.c b/arch/arm/mach-mx27/gpio_mux.c
index 78e740870992..0d83383036ab 100644
--- a/arch/arm/mach-mx27/gpio_mux.c
+++ b/arch/arm/mach-mx27/gpio_mux.c
@@ -12,9 +12,15 @@
*/
/*!
- *@file gpio_mux.c
- *@brief This file contains the IOMUX implementation details.
- * @ingroup GPIO
+ * @defgroup GPIO_MX27 Board GPIO and Muxing Setup
+ * @ingroup MSL_MX27
+ */
+/*!
+ * @file mach-mx27/gpio_mux.c
+ *
+ * @brief I/O Muxing control functions
+ *
+ * @ingroup GPIO_MX27
*/
#include <linux/kernel.h>
diff --git a/arch/arm/mach-mx27/gpio_mux.h b/arch/arm/mach-mx27/gpio_mux.h
index 4d182426a913..cb31a25f3032 100644
--- a/arch/arm/mach-mx27/gpio_mux.h
+++ b/arch/arm/mach-mx27/gpio_mux.h
@@ -12,9 +12,9 @@
*/
/*!
- *@file gpio_mux.h
+ *@file mach-mx27/gpio_mux.h
*@brief This file contains the private definition .
- * @ingroup GPIO
+ * @ingroup GPIO_MX27
*/
#ifndef __ARCH_ARM_MACH_MX27_GPIO_MUX_H__
diff --git a/arch/arm/mach-mx27/mm.c b/arch/arm/mach-mx27/mm.c
index 73d7b5bf69ad..cbddcf2fdf61 100644
--- a/arch/arm/mach-mx27/mm.c
+++ b/arch/arm/mach-mx27/mm.c
@@ -11,21 +11,23 @@
* http://www.gnu.org/copyleft/gpl.html
*/
-/*!
- * @file mm.c
- *
- * @brief This file creates static mapping between physical to virtual memory.
- *
- * @ingroup Memory
- */
-
#include <linux/mm.h>
#include <linux/init.h>
-
#include <asm/hardware.h>
#include <asm/pgtable.h>
#include <asm/mach/map.h>
+/*!
+ * @file mach-mx27/mm.c
+ *
+ * @brief This file creates static mapping between physical to virtual memory.
+ *
+ * @ingroup Memory_MX27
+ */
+
+/*!
+ * This structure defines the MX27 memory map.
+ */
static struct map_desc mxc_io_desc[] __initdata = {
{
.virtual = AIPI_BASE_ADDR_VIRT,
@@ -49,6 +51,11 @@ static struct map_desc mxc_io_desc[] __initdata = {
.type = MT_DEVICE}
};
+/*!
+ * This function initializes the memory map. It is called during the
+ * system startup to create static physical to virtual memory map for
+ * the IO modules.
+ */
void __init mxc_map_io(void)
{
iotable_init(mxc_io_desc, ARRAY_SIZE(mxc_io_desc));
diff --git a/arch/arm/mach-mx27/mx27ads.c b/arch/arm/mach-mx27/mx27ads.c
index dd093cb8ef82..577c097dd347 100644
--- a/arch/arm/mach-mx27/mx27ads.c
+++ b/arch/arm/mach-mx27/mx27ads.c
@@ -50,10 +50,10 @@
#include "gpio_mux.h"
/*!
- * @file mx27ads.c
+ * @file mach-mx27/mx27ads.c
* @brief This file contains the board specific initialization routines.
*
- * @ingroup System
+ * @ingroup MSL_MX27
*/
extern void mxc_map_io(void);
diff --git a/arch/arm/mach-mx27/mx27ads_gpio.c b/arch/arm/mach-mx27/mx27ads_gpio.c
index cbc197550dcc..642656f22f42 100644
--- a/arch/arm/mach-mx27/mx27ads_gpio.c
+++ b/arch/arm/mach-mx27/mx27ads_gpio.c
@@ -25,11 +25,11 @@
static int g_uart_activated[MXC_UART_NR] = { 0, 0, 0, 0, 0, 0 };
/*!
- * @file mx27ads_gpio.c
+ * @file mach-mx27/mx27ads_gpio.c
*
* @brief This file contains all the GPIO setup functions for the board.
*
- * @ingroup GPIO
+ * @ingroup GPIO_MX27
*/
/*!
diff --git a/arch/arm/mach-mx27/mxc_pm.c b/arch/arm/mach-mx27/mxc_pm.c
index 70a3857cd85e..f44472424d26 100644
--- a/arch/arm/mach-mx27/mxc_pm.c
+++ b/arch/arm/mach-mx27/mxc_pm.c
@@ -12,13 +12,17 @@
*/
/*!
- * @file mxc_pm.c
+ * @defgroup DPM_MX27 Power Management
+ * @ingroup MSL_MX27
+ */
+/*!
+ * @file mach-mx27/mxc_pm.c
*
* @brief This file contains the implementation of the Low-level power
* management driver. It modifies the registers of the PLL and clock module
* of the i.MX27.
*
- * @ingroup LPMD
+ * @ingroup DPM_MX27
*/
/*
diff --git a/arch/arm/mach-mx27/serial.c b/arch/arm/mach-mx27/serial.c
index c00136407c64..a3172416bc0d 100644
--- a/arch/arm/mach-mx27/serial.c
+++ b/arch/arm/mach-mx27/serial.c
@@ -11,11 +11,11 @@
* http://www.gnu.org/copyleft/gpl.html
*/
/*!
- * @file serial.c
+ * @file mach-mx27/serial.c
*
* @brief This file contains the UART initiliazation.
*
- * @ingroup System
+ * @ingroup MSL_MX27
*/
#include <linux/module.h>
#include <linux/platform_device.h>
diff --git a/arch/arm/mach-mx27/serial.h b/arch/arm/mach-mx27/serial.h
index 08323851ac96..8f3e1a5b8e08 100644
--- a/arch/arm/mach-mx27/serial.h
+++ b/arch/arm/mach-mx27/serial.h
@@ -14,6 +14,11 @@
#ifndef __ARCH_ARM_MACH_MX27_SERIAL_H__
#define __ARCH_ARM_MACH_MX27_SERIAL_H__
+/*!
+ * @file mach-mx27/serial.h
+ *
+ * @ingroup MSL_MX27
+ */
#include <asm/arch/mxc_uart.h>
/* UART 1 configuration */
diff --git a/arch/arm/mach-mx27/system.c b/arch/arm/mach-mx27/system.c
index 0c72a712271d..13a1ee60f079 100644
--- a/arch/arm/mach-mx27/system.c
+++ b/arch/arm/mach-mx27/system.c
@@ -25,19 +25,14 @@
#include <asm/system.h>
/*!
- * @defgroup MSL Machine Specific Layer (MSL)
+ * @defgroup MSL_MX27 i.MX27 Machine Specific Layer (MSL)
*/
/*!
- * @defgroup System System-wide Misc Files for MSL
- * @ingroup MSL
- */
-
-/*!
- * @file system.c
+ * @file mach-mx27/system.c
* @brief This file contains idle and reset functions.
*
- * @ingroup System
+ * @ingroup MSL_MX27
*/
/*!
diff --git a/arch/arm/mach-mx27/time.c b/arch/arm/mach-mx27/time.c
index 557824278506..45ab4d19be17 100644
--- a/arch/arm/mach-mx27/time.c
+++ b/arch/arm/mach-mx27/time.c
@@ -17,12 +17,16 @@
*/
/*!
- * @file time.c
+ * @defgroup Timers_MX27 RTC, OS tick, Watchdog Timers
+ * @ingroup MSL_MX27
+ */
+/*!
+ * @file mach-mx27/time.c
* @brief This file contains OS tick implementations.
*
* This file contains OS tick implementations.
*
- * @ingroup Timers
+ * @ingroup Timers_MX27
*/
#include <linux/module.h>
diff --git a/arch/arm/mach-mx27/usb.c b/arch/arm/mach-mx27/usb.c
index 3caf31edcd95..735651583f42 100644
--- a/arch/arm/mach-mx27/usb.c
+++ b/arch/arm/mach-mx27/usb.c
@@ -15,14 +15,15 @@
*/
/*!
- *@defgroup USB ARC OTG USB Driver
+ * @defgroup USB_MX27 ARC OTG USB Driver for i.MX27
+ * @ingroup USB
*/
/*!
- * @file usb.c
+ * @file mach-mx27/usb.c
*
* @brief platform related part of usb driver.
- * @ingroup USB
+ * @ingroup USB_MX27
*/
/*!
diff --git a/arch/arm/mach-mx3/clock.c b/arch/arm/mach-mx3/clock.c
index 939e15daa78d..70baff4b8c84 100644
--- a/arch/arm/mach-mx3/clock.c
+++ b/arch/arm/mach-mx3/clock.c
@@ -11,12 +11,6 @@
* http://www.gnu.org/copyleft/gpl.html
*/
-/*!
- * @file mach-mx3/clock.c
- * @brief Low level clock structs and functions for MX31 clocks.
- * @ingroup CLOCKS
- */
-
#include <linux/module.h>
#include <linux/spinlock.h>
#include <linux/delay.h>
diff --git a/arch/arm/mach-mx3/cpu.c b/arch/arm/mach-mx3/cpu.c
index 6b61b483929f..917c9b8e2726 100644
--- a/arch/arm/mach-mx3/cpu.c
+++ b/arch/arm/mach-mx3/cpu.c
@@ -9,11 +9,11 @@
*/
/*!
- * @file cpu.c
+ * @file mach-mx3/cpu.c
*
* @brief This file contains the CPU initialization code.
*
- * @ingroup System
+ * @ingroup MSL_MX31
*/
#include <linux/types.h>
diff --git a/arch/arm/mach-mx3/dpm.c b/arch/arm/mach-mx3/dpm.c
index d004a4bb073d..a0257655d18e 100644
--- a/arch/arm/mach-mx3/dpm.c
+++ b/arch/arm/mach-mx3/dpm.c
@@ -23,11 +23,11 @@
*/
/*!
- * @file dpm.c
+ * @file mach-mx3/dpm.c
*
* @brief This file provides DPM support hooks for the Freescale i.MX31
*
- * @ingroup DPM
+ * @ingroup DPM_MX31
*/
#include <linux/dpm.h>
diff --git a/arch/arm/mach-mx3/dvfs.c b/arch/arm/mach-mx3/dvfs.c
index ad8d95c5490a..905fc91d581e 100644
--- a/arch/arm/mach-mx3/dvfs.c
+++ b/arch/arm/mach-mx3/dvfs.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file dvfs.c
+ * @file mach-mx3/dvfs.c
*
* @brief Driver for the Freescale Semiconductor MXC DVFS module.
*
@@ -27,7 +27,7 @@
* Driver ioctls are used to change driver parameters and enable/disable the
* DVFS operation.
*
- * @ingroup PM
+ * @ingroup PM_MX31
*/
/* Define to enable debug messages */
diff --git a/arch/arm/mach-mx3/iomux.c b/arch/arm/mach-mx3/iomux.c
index 5df68b6ff4d0..24ede6286b9c 100644
--- a/arch/arm/mach-mx3/iomux.c
+++ b/arch/arm/mach-mx3/iomux.c
@@ -11,6 +11,18 @@
* http://www.gnu.org/copyleft/gpl.html
*/
+/*!
+ * @defgroup GPIO_MX31 Board GPIO and Muxing Setup
+ * @ingroup MSL_MX31
+ */
+/*!
+ * @file mach-mx3/iomux.c
+ *
+ * @brief I/O Muxing control functions
+ *
+ * @ingroup GPIO_MX31
+ */
+
#include <linux/module.h>
#include <linux/spinlock.h>
#include <asm/hardware.h>
diff --git a/arch/arm/mach-mx3/iomux.h b/arch/arm/mach-mx3/iomux.h
index 2749fe9482be..e4706da91831 100644
--- a/arch/arm/mach-mx3/iomux.h
+++ b/arch/arm/mach-mx3/iomux.h
@@ -16,6 +16,14 @@
#include <linux/types.h>
/*!
+ * @file mach-mx3/iomux.h
+ *
+ * @brief I/O Muxing control definitions and functions
+ *
+ * @ingroup GPIO_MX31
+ */
+
+/*!
* various IOMUX output functions
*/
typedef enum iomux_output_config {
diff --git a/arch/arm/mach-mx3/mm.c b/arch/arm/mach-mx3/mm.c
index 33165abe237f..02cb51cc9a72 100644
--- a/arch/arm/mach-mx3/mm.c
+++ b/arch/arm/mach-mx3/mm.c
@@ -27,11 +27,11 @@
#include <asm/mach/map.h>
/*!
- * @file mm.c
+ * @file mach-mx3/mm.c
*
* @brief This file creates static mapping between physical to virtual memory.
*
- * @ingroup Memory
+ * @ingroup Memory_MX31
*/
/*!
diff --git a/arch/arm/mach-mx3/mx31ads.c b/arch/arm/mach-mx3/mx31ads.c
index 5ec0a5cf8efe..03508206bb3a 100644
--- a/arch/arm/mach-mx3/mx31ads.c
+++ b/arch/arm/mach-mx3/mx31ads.c
@@ -51,11 +51,11 @@
#include "crm_regs.h"
#include "iomux.h"
/*!
- * @file mx31ads.c
+ * @file mach-mx3/mx31ads.c
*
* @brief This file contains the board specific initialization routines.
*
- * @ingroup System
+ * @ingroup MSL_MX31
*/
extern void mxc_map_io(void);
diff --git a/arch/arm/mach-mx3/mx31ads_gpio.c b/arch/arm/mach-mx3/mx31ads_gpio.c
index 2c5f6675ffd4..8e3125af6d82 100644
--- a/arch/arm/mach-mx3/mx31ads_gpio.c
+++ b/arch/arm/mach-mx3/mx31ads_gpio.c
@@ -22,11 +22,11 @@
#include "iomux.h"
/*!
- * @file mx31ads_gpio.c
+ * @file mach-mx3/mx31ads_gpio.c
*
* @brief This file contains all the GPIO setup functions for the board.
*
- * @ingroup GPIO
+ * @ingroup GPIO_MX31
*/
void gpio_activate_audio_ports(void);
diff --git a/arch/arm/mach-mx3/mxc_pm.c b/arch/arm/mach-mx3/mxc_pm.c
index de44ca6bbbce..bd55eb0293ae 100644
--- a/arch/arm/mach-mx3/mxc_pm.c
+++ b/arch/arm/mach-mx3/mxc_pm.c
@@ -12,12 +12,16 @@
*/
/*!
- * @file mxc_pm.c
+ * @defgroup DPM_MX31 Power Management
+ * @ingroup MSL_MX31
+ */
+/*!
+ * @file mach-mx3/mxc_pm.c
*
* @brief This file provides all the kernel level and user level API
* definitions for the CRM_MCU and DPLL in mx3.
*
- * @ingroup LPMD
+ * @ingroup DPM_MX31
*/
/*
diff --git a/arch/arm/mach-mx3/sdma_script_code.h b/arch/arm/mach-mx3/sdma_script_code.h
index f857e82a9dd6..cb0db9a2a468 100644
--- a/arch/arm/mach-mx3/sdma_script_code.h
+++ b/arch/arm/mach-mx3/sdma_script_code.h
@@ -11,15 +11,6 @@
* http://www.gnu.org/copyleft/gpl.html
*/
-/*!
- * @file sdma_script_code.h
- * @brief This file contains functions of SDMA scripts code initialization
- *
- * The file was generated automatically. Based on sdma scripts library.
- *
- * @ingroup SDMA
- */
-
#ifndef __SDMA_SCRIPT_CODE_H__
#define __SDMA_SCRIPT_CODE_H__
diff --git a/arch/arm/mach-mx3/sdma_script_code_pass2.h b/arch/arm/mach-mx3/sdma_script_code_pass2.h
index 346b5d6c04f4..979868630df3 100644
--- a/arch/arm/mach-mx3/sdma_script_code_pass2.h
+++ b/arch/arm/mach-mx3/sdma_script_code_pass2.h
@@ -11,15 +11,6 @@
* http://www.gnu.org/copyleft/gpl.html
*/
-/*!
- * @file sdma_script_code.h
- * @brief This file contains functions of SDMA scripts code initialization
- *
- * The file was generated automatically. Based on sdma scripts library.
- *
- * @ingroup SDMA
- */
-
#ifndef __SDMA_SCRIPT_CODE_PASS2_H__
#define __SDMA_SCRIPT_CODE_PASS2_H__
diff --git a/arch/arm/mach-mx3/serial.c b/arch/arm/mach-mx3/serial.c
index bcb1815ccb00..42e9e41918ba 100644
--- a/arch/arm/mach-mx3/serial.c
+++ b/arch/arm/mach-mx3/serial.c
@@ -11,11 +11,11 @@
* http://www.gnu.org/copyleft/gpl.html
*/
/*!
- * @file serial.c
+ * @file mach-mx3/serial.c
*
* @brief This file contains the UART initiliazation.
*
- * @ingroup System
+ * @ingroup MSL_MX31
*/
#include <linux/module.h>
#include <linux/platform_device.h>
diff --git a/arch/arm/mach-mx3/serial.h b/arch/arm/mach-mx3/serial.h
index 2198c0a35796..e5bba51dec88 100644
--- a/arch/arm/mach-mx3/serial.h
+++ b/arch/arm/mach-mx3/serial.h
@@ -14,6 +14,11 @@
#ifndef __ARCH_ARM_MACH_MX3_SERIAL_H__
#define __ARCH_ARM_MACH_MX3_SERIAL_H__
+/*!
+ * @file mach-mx3/serial.h
+ *
+ * @ingroup MSL_MX31
+ */
#include <asm/arch/mxc_uart.h>
/* UART 1 configuration */
diff --git a/arch/arm/mach-mx3/system.c b/arch/arm/mach-mx3/system.c
index 057c6ae453bb..92e8f7d59cf6 100644
--- a/arch/arm/mach-mx3/system.c
+++ b/arch/arm/mach-mx3/system.c
@@ -26,19 +26,14 @@
#include "crm_regs.h"
/*!
- * @defgroup MSL Machine Specific Layer (MSL)
+ * @defgroup MSL_MX31 i.MX31 Machine Specific Layer (MSL)
*/
/*!
- * @defgroup System System-wide Misc Files for MSL
- * @ingroup MSL
- */
-
-/*!
- * @file system.c
+ * @file mach-mx3/system.c
* @brief This file contains idle and reset functions.
*
- * @ingroup System
+ * @ingroup MSL_MX31
*/
extern int mxc_jtag_enabled;
diff --git a/arch/arm/mach-mx3/time.c b/arch/arm/mach-mx3/time.c
index 730046033339..86c372c7bc40 100644
--- a/arch/arm/mach-mx3/time.c
+++ b/arch/arm/mach-mx3/time.c
@@ -17,12 +17,16 @@
*/
/*!
- * @file time.c
+ * @defgroup Timers_MX31 RTC, OS tick, Watchdog Timers
+ * @ingroup MSL_MX31
+ */
+/*!
+ * @file mach-mx3/time.c
* @brief This file contains OS tick and wdog timer implementations.
*
* This file contains OS tick and wdog timer implementations.
*
- * @ingroup Timers
+ * @ingroup Timers_MX31
*/
#include <linux/module.h>
diff --git a/arch/arm/mach-mx3/time_priv.h b/arch/arm/mach-mx3/time_priv.h
index 850e4927713c..76185fb50d38 100644
--- a/arch/arm/mach-mx3/time_priv.h
+++ b/arch/arm/mach-mx3/time_priv.h
@@ -13,12 +13,12 @@
#ifndef __MACH_MX31_TIME_PRIV_H__
#define __MACH_MX31_TIME_PRIV_H__
/*!
- * @file time_priv.h
+ * @file mach-mx3/time_priv.h
* @brief This file contains OS tick and wdog timer register definitions.
*
* This file contains OS tick and wdog timer register definitions.
*
- * @ingroup Timers
+ * @ingroup Timers_MX31
*/
#include <asm/hardware.h>
diff --git a/arch/arm/mach-mx3/usb.c b/arch/arm/mach-mx3/usb.c
index 65eb9290b010..3c651a60cd5f 100644
--- a/arch/arm/mach-mx3/usb.c
+++ b/arch/arm/mach-mx3/usb.c
@@ -15,14 +15,15 @@
*/
/*!
- *@defgroup USB ARC OTG USB Driver
+ * @defgroup USB_MX31 ARC OTG USB Driver for i.MX31
+ * @ingroup USB
*/
/*!
- * @file usb.c
+ * @file mach-mx3/usb.c
*
* @brief platform related part of usb driver.
- * @ingroup USB
+ * @ingroup USB_MX31
*/
/*!
diff --git a/arch/arm/plat-mxc/cpu_common.c b/arch/arm/plat-mxc/cpu_common.c
index e4e3ab2e679a..0709783b1a82 100644
--- a/arch/arm/plat-mxc/cpu_common.c
+++ b/arch/arm/plat-mxc/cpu_common.c
@@ -20,11 +20,11 @@
extern const u32 system_rev_tbl[SYSTEM_REV_NUM][2];
/*!
- * @file cpu_common.c
+ * @file plat-mxc/cpu_common.c
*
* @brief This file contains the common CPU initialization code.
*
- * @ingroup System
+ * @ingroup MSL_MX31
*/
static int system_rev_updated = 0;
diff --git a/arch/arm/plat-mxc/dma_mx2.c b/arch/arm/plat-mxc/dma_mx2.c
index 8091b70b2656..a2d165f86349 100644
--- a/arch/arm/plat-mxc/dma_mx2.c
+++ b/arch/arm/plat-mxc/dma_mx2.c
@@ -17,10 +17,10 @@
*/
/*!
- * @file dma_mx2.c
+ * @file plat-mxc/dma_mx2.c
* @brief This file contains functions for DMA API
*
- * @ingroup DMA
+ * @ingroup DMA_MX27
*/
#include <linux/module.h>
diff --git a/arch/arm/plat-mxc/gpio.c b/arch/arm/plat-mxc/gpio.c
index a651afbfec7e..8e7d9693d469 100644
--- a/arch/arm/plat-mxc/gpio.c
+++ b/arch/arm/plat-mxc/gpio.c
@@ -28,9 +28,9 @@
#include <asm/arch/gpio.h>
/*!
- * @file gpio.c
+ * @file plat-mxc/gpio.c
*
- * @brief This file contains the GPIO and IOMUX implementation details.
+ * @brief This file contains the GPIO implementation details.
*
* @ingroup GPIO
*/
diff --git a/arch/arm/plat-mxc/irq.c b/arch/arm/plat-mxc/irq.c
index 11fc091e9b58..ee6474185a87 100644
--- a/arch/arm/plat-mxc/irq.c
+++ b/arch/arm/plat-mxc/irq.c
@@ -21,6 +21,11 @@
#include <asm/irq.h>
#include <asm/mach/irq.h>
+/*!
+ * @file plat-mxc/irq.c
+ *
+ * @ingroup Interrupt
+ */
/*
*****************************************
* EDIO Registers *
diff --git a/arch/arm/plat-mxc/sdma/dma_sdma.c b/arch/arm/plat-mxc/sdma/dma_sdma.c
index 9f418193e004..2668daaaaf6b 100644
--- a/arch/arm/plat-mxc/sdma/dma_sdma.c
+++ b/arch/arm/plat-mxc/sdma/dma_sdma.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file dma_sdma.c
+ * @file plat-mxc/sdma/dma_sdma.c
* @brief Front-end to the DMA handling. This handles the allocation/freeing
* of DMA channels, and provides a unified interface to the machines
* DMA facilities. This file contains functions for Smart DMA.
diff --git a/arch/arm/plat-mxc/sdma/sdma.c b/arch/arm/plat-mxc/sdma/sdma.c
index d67d26871354..38a39f83b79a 100644
--- a/arch/arm/plat-mxc/sdma/sdma.c
+++ b/arch/arm/plat-mxc/sdma/sdma.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file sdma.c
+ * @file plat-mxc/sdma/sdma.c
* @brief This file contains functions for Smart DMA API
*
* SDMA (Smart DMA) is used for transferring data between MCU and peripherals
diff --git a/arch/arm/plat-mxc/sdma/sdma_malloc.c b/arch/arm/plat-mxc/sdma/sdma_malloc.c
index b10843c85227..e99c1ede1979 100644
--- a/arch/arm/plat-mxc/sdma/sdma_malloc.c
+++ b/arch/arm/plat-mxc/sdma/sdma_malloc.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file sdma_malloc.c
+ * @file plat-mxc/sdma/sdma_malloc.c
* @brief This file contains functions for SDMA non-cacheable buffers allocation
*
* SDMA (Smart DMA) is used for transferring data between MCU and peripherals
diff --git a/arch/arm/plat-mxc/spba.c b/arch/arm/plat-mxc/spba.c
index 6094c04c9ac5..cd9a01041ab5 100644
--- a/arch/arm/plat-mxc/spba.c
+++ b/arch/arm/plat-mxc/spba.c
@@ -18,7 +18,7 @@
#include <asm/arch/spba.h>
/*!
- * @file spba.c
+ * @file plat-mxc/spba.c
*
* @brief This file contains the SPBA API implementation details.
*
diff --git a/drivers/media/video/mxc/capture/mxc_v4l2_capture.c b/drivers/media/video/mxc/capture/mxc_v4l2_capture.c
index 1e92f6bc8c30..059e03bfff7e 100644
--- a/drivers/media/video/mxc/capture/mxc_v4l2_capture.c
+++ b/drivers/media/video/mxc/capture/mxc_v4l2_capture.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file mxc_v4l2_capture.c
+ * @file drivers/media/video/mxc/capture/mxc_v4l2_capture.c
*
* @brief Mxc Video For Linux 2 driver
*
diff --git a/drivers/media/video/mxc/output/mxc_v4l2_output.c b/drivers/media/video/mxc/output/mxc_v4l2_output.c
index 3d5890e32c75..651b8e986d47 100644
--- a/drivers/media/video/mxc/output/mxc_v4l2_output.c
+++ b/drivers/media/video/mxc/output/mxc_v4l2_output.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file mxc_v4l2_output.c
+ * @file drivers/media/video/mxc/output/mxc_v4l2_output.c
*
* @brief MXC V4L2 Video Output Driver
*
diff --git a/drivers/mxc/pm/dptc.c b/drivers/mxc/pm/dptc.c
index b161876fd605..6aee33af2f55 100644
--- a/drivers/mxc/pm/dptc.c
+++ b/drivers/mxc/pm/dptc.c
@@ -29,7 +29,7 @@
* Driver ioctls are used to change driver parameters and enable/disable the
* DPTC operation.
*
- * @ingroup PM
+ * @ingroup PM_MX31
*/
#include <linux/module.h>
diff --git a/drivers/mxc/pm/dptc_mx27.c b/drivers/mxc/pm/dptc_mx27.c
index 59f2ddce8184..e4e65090da08 100644
--- a/drivers/mxc/pm/dptc_mx27.c
+++ b/drivers/mxc/pm/dptc_mx27.c
@@ -28,7 +28,7 @@
* in-order to update the translation table. Driver ioctls are used to change
* driver parameters and enable/disable the DPTC operation.
*
- * @ingroup PM
+ * @ingroup PM_MX27
*/
#include <linux/module.h>
diff --git a/drivers/mxc/pm/dvfs_dptc.c b/drivers/mxc/pm/dvfs_dptc.c
index 5ac1f66bf83c..a279a8595e92 100644
--- a/drivers/mxc/pm/dvfs_dptc.c
+++ b/drivers/mxc/pm/dvfs_dptc.c
@@ -27,7 +27,7 @@
* into the driver (the voltage changes are done by calling some routines
* of the mc13783 driver).
*
- * @ingroup PM
+ * @ingroup PM_MX31
*/
#include <linux/module.h>
diff --git a/drivers/mxc/pm/dvfs_dptc.h b/drivers/mxc/pm/dvfs_dptc.h
index 2c0a28013914..a3d8b1b31a15 100644
--- a/drivers/mxc/pm/dvfs_dptc.h
+++ b/drivers/mxc/pm/dvfs_dptc.h
@@ -16,7 +16,7 @@
*
* @brief MXC dvfs & dptc header file.
*
- * @ingroup PM
+ * @ingroup PM_MX27 PM_MX31
*/
#ifndef __DVFS_DPTC_H__
#define __DVFS_DPTC_H__
diff --git a/drivers/mxc/pm/dvfs_dptc_table_mx27.h b/drivers/mxc/pm/dvfs_dptc_table_mx27.h
index dfbe6a6cec63..83438707ee92 100644
--- a/drivers/mxc/pm/dvfs_dptc_table_mx27.h
+++ b/drivers/mxc/pm/dvfs_dptc_table_mx27.h
@@ -16,7 +16,7 @@
*
* @brief i.MX27 dptc table file.
*
- * @ingroup PM
+ * @ingroup PM_MX27
*/
#ifndef __DVFS_DPTC_TABLE_MX27_H__
#define __DVFS_DPTC_TABLE_MX27_H__
diff --git a/drivers/mxc/pm/dvfs_dptc_table_mx31.h b/drivers/mxc/pm/dvfs_dptc_table_mx31.h
index 1fca1a55d4f9..81fe80f28af8 100644
--- a/drivers/mxc/pm/dvfs_dptc_table_mx31.h
+++ b/drivers/mxc/pm/dvfs_dptc_table_mx31.h
@@ -25,7 +25,7 @@
*
* @brief MX31 dvfs & dptc table file for CKIH clock 26MHz.
*
- * @ingroup PM
+ * @ingroup PM_MX31
*/
#ifndef __DVFS_DPTC_TABLE_MX31_H__
#define __DVFS_DPTC_TABLE_MX31_H__
diff --git a/drivers/mxc/pm/dvfs_dptc_table_mx31_27ckih.h b/drivers/mxc/pm/dvfs_dptc_table_mx31_27ckih.h
index 3dd4d4a762f1..ff8b520776c0 100644
--- a/drivers/mxc/pm/dvfs_dptc_table_mx31_27ckih.h
+++ b/drivers/mxc/pm/dvfs_dptc_table_mx31_27ckih.h
@@ -25,7 +25,7 @@
*
* @brief MX31 dvfs & dptc table file for CKIH clock 27MHz.
*
- * @ingroup PM
+ * @ingroup PM_MX31
*/
#ifndef __DVFS_DPTC_TABLE_MX31_27CKIH_H__
#define __DVFS_DPTC_TABLE_MX31_27CKIH_H__
diff --git a/drivers/mxc/pm/dvfs_dptc_table_mx31_rev2.h b/drivers/mxc/pm/dvfs_dptc_table_mx31_rev2.h
index aeb18cf40bc6..cb0f64c98749 100644
--- a/drivers/mxc/pm/dvfs_dptc_table_mx31_rev2.h
+++ b/drivers/mxc/pm/dvfs_dptc_table_mx31_rev2.h
@@ -25,7 +25,7 @@
*
* @brief MX31 dvfs & dptc table file for MX31 2.0
*
- * @ingroup PM
+ * @ingroup PM_MX31
*/
#ifndef __DVFS_DPTC_TABLE_MX3_REV2_H__
#define __DVFS_DPTC_TABLE_MX3_REV2_H__
diff --git a/drivers/mxc/pmic/mc13783/pmic_adc.c b/drivers/mxc/pmic/mc13783/pmic_adc.c
index 1cd58f29427f..5f72f0d43d2a 100644
--- a/drivers/mxc/pmic/mc13783/pmic_adc.c
+++ b/drivers/mxc/pmic/mc13783/pmic_adc.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file pmic_adc.c
+ * @file mc13783/pmic_adc.c
* @brief This is the main file of PMIC(mc13783) ADC driver.
*
* @ingroup PMIC_ADC
diff --git a/drivers/mxc/pmic/mc13783/pmic_adc_defs.h b/drivers/mxc/pmic/mc13783/pmic_adc_defs.h
index 77663c164ea1..5278814d9c0a 100644
--- a/drivers/mxc/pmic/mc13783/pmic_adc_defs.h
+++ b/drivers/mxc/pmic/mc13783/pmic_adc_defs.h
@@ -12,7 +12,7 @@
*/
/*!
- * @file pmic_adc_defs.h
+ * @file mc13783/pmic_adc_defs.h
* @brief This header contains all defines for PMIC(mc13783) ADC driver.
*
* @ingroup PMIC_ADC
diff --git a/drivers/mxc/pmic/mc13783/pmic_audio.c b/drivers/mxc/pmic/mc13783/pmic_audio.c
index a9af4422c7af..017902384175 100644
--- a/drivers/mxc/pmic/mc13783/pmic_audio.c
+++ b/drivers/mxc/pmic/mc13783/pmic_audio.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file pmic_audio.c
+ * @file mc13783/pmic_audio.c
* @brief Implementation of the PMIC(mc13783) Audio driver APIs.
*
* The PMIC Audio driver and this API were developed to support the
diff --git a/drivers/mxc/pmic/mc13783/pmic_battery.c b/drivers/mxc/pmic/mc13783/pmic_battery.c
index cac5609475dc..66f578c8a8c6 100644
--- a/drivers/mxc/pmic/mc13783/pmic_battery.c
+++ b/drivers/mxc/pmic/mc13783/pmic_battery.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file pmic_battery.c
+ * @file mc13783/pmic_battery.c
* @brief This is the main file of PMIC(mc13783) Battery driver.
*
* @ingroup PMIC_BATTERY
diff --git a/drivers/mxc/pmic/mc13783/pmic_battery_defs.h b/drivers/mxc/pmic/mc13783/pmic_battery_defs.h
index 047c21c436bf..9f66a185cd2f 100644
--- a/drivers/mxc/pmic/mc13783/pmic_battery_defs.h
+++ b/drivers/mxc/pmic/mc13783/pmic_battery_defs.h
@@ -12,7 +12,7 @@
*/
/*!
- * @file pmic_battery_defs.h
+ * @file mc13783/pmic_battery_defs.h
* @brief This is the internal header for PMIC(mc13783) Battery driver.
*
* @ingroup PMIC_BATTERY
diff --git a/drivers/mxc/pmic/mc13783/pmic_convity.c b/drivers/mxc/pmic/mc13783/pmic_convity.c
index 1d21657d1fa0..91eafd0f23aa 100644
--- a/drivers/mxc/pmic/mc13783/pmic_convity.c
+++ b/drivers/mxc/pmic/mc13783/pmic_convity.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file pmic_convity.c
+ * @file mc13783/pmic_convity.c
* @brief Implementation of the PMIC Connectivity driver APIs.
*
* The PMIC connectivity device driver and this API were developed to support
diff --git a/drivers/mxc/pmic/mc13783/pmic_light.c b/drivers/mxc/pmic/mc13783/pmic_light.c
index c0dc29944952..60999028b753 100644
--- a/drivers/mxc/pmic/mc13783/pmic_light.c
+++ b/drivers/mxc/pmic/mc13783/pmic_light.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file pmic_light.c
+ * @file mc13783/pmic_light.c
* @brief This is the main file of PMIC(mc13783) Light and Backlight driver.
*
* @ingroup PMIC_LIGHT
diff --git a/drivers/mxc/pmic/mc13783/pmic_light_defs.h b/drivers/mxc/pmic/mc13783/pmic_light_defs.h
index 172159fbb430..80082363d9ed 100644
--- a/drivers/mxc/pmic/mc13783/pmic_light_defs.h
+++ b/drivers/mxc/pmic/mc13783/pmic_light_defs.h
@@ -12,7 +12,7 @@
*/
/*!
- * @file pmic_light_defs.h
+ * @file mc13783/pmic_light_defs.h
* @brief This is the internal header PMIC(mc13783) Light and Backlight driver.
*
* @ingroup PMIC_LIGHT
diff --git a/drivers/mxc/pmic/mc13783/pmic_power.c b/drivers/mxc/pmic/mc13783/pmic_power.c
index 73dfc5a67a14..7d212b753937 100644
--- a/drivers/mxc/pmic/mc13783/pmic_power.c
+++ b/drivers/mxc/pmic/mc13783/pmic_power.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file pmic_power.c
+ * @file mc13783/pmic_power.c
* @brief This is the main file of PMIC(mc13783) Power driver.
*
* @ingroup PMIC_POWER
diff --git a/drivers/mxc/pmic/mc13783/pmic_power_defs.h b/drivers/mxc/pmic/mc13783/pmic_power_defs.h
index 17db8db5306e..38e554146a70 100644
--- a/drivers/mxc/pmic/mc13783/pmic_power_defs.h
+++ b/drivers/mxc/pmic/mc13783/pmic_power_defs.h
@@ -12,7 +12,7 @@
*/
/*!
- * @file pmic_power_defs.h
+ * @file mc13783/pmic_power_defs.h
* @brief This is the internal header define of PMIC(mc13783) Power driver.
*
* @ingroup PMIC_POWER
diff --git a/drivers/mxc/pmic/mc13783/pmic_rtc.c b/drivers/mxc/pmic/mc13783/pmic_rtc.c
index bcc42f3dc785..94ba4efacf60 100644
--- a/drivers/mxc/pmic/mc13783/pmic_rtc.c
+++ b/drivers/mxc/pmic/mc13783/pmic_rtc.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file pmic_rtc.c
+ * @file mc13783/pmic_rtc.c
* @brief This is the main file of PMIC(mc13783) RTC driver.
*
* @ingroup PMIC_RTC
diff --git a/drivers/mxc/pmic/mc13783/pmic_rtc_defs.h b/drivers/mxc/pmic/mc13783/pmic_rtc_defs.h
index 7832c51223ea..16e968dd9977 100644
--- a/drivers/mxc/pmic/mc13783/pmic_rtc_defs.h
+++ b/drivers/mxc/pmic/mc13783/pmic_rtc_defs.h
@@ -14,7 +14,7 @@
#define __MC13783_RTC_DEFS_H__
/*!
- * @file pmic_rtc_defs.h
+ * @file mc13783/pmic_rtc_defs.h
* @brief This is the internal header of PMIC(mc13783) RTC driver.
*
* @ingroup PMIC_RTC
diff --git a/drivers/mxc/security/sahara2/fsl_shw_auth.c b/drivers/mxc/security/sahara2/fsl_shw_auth.c
index f15748acad98..df45ee098b2d 100644
--- a/drivers/mxc/security/sahara2/fsl_shw_auth.c
+++ b/drivers/mxc/security/sahara2/fsl_shw_auth.c
@@ -11,7 +11,7 @@
* http://www.gnu.org/copyleft/gpl.html
*/
/*!
- * @file fsl_shw_auth.c
+ * @file drivers/mxc/security/sahara2/fsl_shw_auth.c
*
* @brief This file contains the routines which do the combined encrypt+authentication
* functions. For now, only AES-CCM is supported.
diff --git a/drivers/mxc/security/sahara2/fsl_shw_hash.c b/drivers/mxc/security/sahara2/fsl_shw_hash.c
index f4a01017f83d..bb144f53ee06 100644
--- a/drivers/mxc/security/sahara2/fsl_shw_hash.c
+++ b/drivers/mxc/security/sahara2/fsl_shw_hash.c
@@ -11,7 +11,7 @@
* http://www.gnu.org/copyleft/gpl.html
*/
/*!
- * @file fsl_shw_hash.c
+ * @file drivers/mxc/security/sahara2/fsl_shw_hash.c
*
* @brief This file implements Cryptographic Hashing functions of the FSL SHW API
* for Sahara. This does not include HMAC.
diff --git a/drivers/mxc/security/sahara2/fsl_shw_hmac.c b/drivers/mxc/security/sahara2/fsl_shw_hmac.c
index 07acb25339bd..14245d0f6a29 100644
--- a/drivers/mxc/security/sahara2/fsl_shw_hmac.c
+++ b/drivers/mxc/security/sahara2/fsl_shw_hmac.c
@@ -11,7 +11,7 @@
* http://www.gnu.org/copyleft/gpl.html
*/
/*!
- * @file fsl_shw_hmac.c
+ * @file drivers/mxc/security/sahara2/fsl_shw_hmac.c
*
* @brief This file implements Hashed Message Authentication Code functions of the FSL
* SHW API for Sahara.
diff --git a/drivers/mxc/security/sahara2/fsl_shw_rand.c b/drivers/mxc/security/sahara2/fsl_shw_rand.c
index 2b1fd6c261b1..ca213456457d 100644
--- a/drivers/mxc/security/sahara2/fsl_shw_rand.c
+++ b/drivers/mxc/security/sahara2/fsl_shw_rand.c
@@ -11,7 +11,7 @@
* http://www.gnu.org/copyleft/gpl.html
*/
/*!
- * @file fsl_shw_rand.c
+ * @file drivers/mxc/security/sahara2/fsl_shw_rand.c
*
* @brief This file implements Random Number Generation functions of the FSL SHW API for
* for Sahara.
diff --git a/drivers/mxc/security/sahara2/fsl_shw_sym.c b/drivers/mxc/security/sahara2/fsl_shw_sym.c
index a22daf115bf3..bb3ea836d83d 100644
--- a/drivers/mxc/security/sahara2/fsl_shw_sym.c
+++ b/drivers/mxc/security/sahara2/fsl_shw_sym.c
@@ -11,7 +11,7 @@
* http://www.gnu.org/copyleft/gpl.html
*/
/*!
- * @file fsl_shw_sym.c
+ * @file drivers/mxc/security/sahara2/fsl_shw_sym.c
*
* @brief This file implements Symmetric Cipher functions of the FSL SHW API for
* Sahara. This does not include CCM.
diff --git a/drivers/mxc/security/sahara2/fsl_shw_user.c b/drivers/mxc/security/sahara2/fsl_shw_user.c
index 2b914e5f04cc..7cbf45664a9a 100644
--- a/drivers/mxc/security/sahara2/fsl_shw_user.c
+++ b/drivers/mxc/security/sahara2/fsl_shw_user.c
@@ -11,7 +11,7 @@
* http://www.gnu.org/copyleft/gpl.html
*/
/*!
- * @file fsl_shw_user.c
+ * @file drivers/mxc/security/sahara2/fsl_shw_user.c
*
* @brief This file implements user and platform capabilities functions of the FSL SHW API
* API for Sahara
diff --git a/drivers/mxc/security/sahara2/fsl_shw_wrap.c b/drivers/mxc/security/sahara2/fsl_shw_wrap.c
index fdc48d7bb658..e8cd5ddc6606 100644
--- a/drivers/mxc/security/sahara2/fsl_shw_wrap.c
+++ b/drivers/mxc/security/sahara2/fsl_shw_wrap.c
@@ -11,7 +11,7 @@
* http://www.gnu.org/copyleft/gpl.html
*/
/*!
- * @file fsl_shw_wrap.c
+ * @file drivers/mxc/security/sahara2/fsl_shw_wrap.c
*
* @brief This file implements Key-Wrap (Black Key) functions of the FSL SHW API for
* Sahara.
diff --git a/drivers/mxc/security/sahara2/include/fsl_shw.h b/drivers/mxc/security/sahara2/include/fsl_shw.h
index 38b7ffc4c230..e3125db35a1b 100644
--- a/drivers/mxc/security/sahara2/include/fsl_shw.h
+++ b/drivers/mxc/security/sahara2/include/fsl_shw.h
@@ -1903,7 +1903,7 @@ extern fsl_shw_return_t fsl_shw_release_key(fsl_shw_uco_t * user_ctx,
*/
/*!
- * @example wrapped_key.c
+ * @example wrap.c
*/
#endif /* API_DOC */
diff --git a/drivers/mxc/security/sahara2/sf_util.c b/drivers/mxc/security/sahara2/sf_util.c
index 256edf69994a..a10b2fb304a1 100644
--- a/drivers/mxc/security/sahara2/sf_util.c
+++ b/drivers/mxc/security/sahara2/sf_util.c
@@ -11,7 +11,7 @@
* http://www.gnu.org/copyleft/gpl.html
*/
/*!
-* @file sf_util.c
+* @file drivers/mxc/security/sahara2/sf_util.c
*
* @brief Security Functions component API - Utility functions
*
diff --git a/drivers/serial/mxc_uart.c b/drivers/serial/mxc_uart.c
index 018f04bea45f..66bd87d33b0b 100644
--- a/drivers/serial/mxc_uart.c
+++ b/drivers/serial/mxc_uart.c
@@ -12,7 +12,7 @@
*/
/*!
- * @file mxc_uart.c
+ * @file drivers/serial/mxc_uart.c
*
* @brief Driver for the Freescale Semiconductor MXC serial ports based on
* drivers/char/serial.c, by Linus Torvalds, Theodore Ts'o.
diff --git a/drivers/spi/mxc_spi.c b/drivers/spi/mxc_spi.c
index b878652f0af4..f417fa649826 100644
--- a/drivers/spi/mxc_spi.c
+++ b/drivers/spi/mxc_spi.c
@@ -12,6 +12,10 @@
*/
/*!
+ * @defgroup SPI Configurable Serial Peripheral Interface (CSPI) Driver
+ */
+
+/*!
* @file mxc_spi.c
* @brief This file contains the implementation of the SPI master controller services
*
diff --git a/drivers/spi/mxc_spi.h b/drivers/spi/mxc_spi.h
index 894cc1de4845..6316282d6cff 100644
--- a/drivers/spi/mxc_spi.h
+++ b/drivers/spi/mxc_spi.h
@@ -12,12 +12,8 @@
*/
/*!
- * @defgroup SPI Configurable Serial Peripheral Interface (CSPI) Driver
- */
-
-/*!
* @file mxc_spi.h
- * @brief This header file contains SPI driver low level definition to access module registers.
+ * @brief This header file contains SPI driver low level register definitions.
*
* @ingroup SPI
*/
diff --git a/drivers/spi/mxc_spi_mx27.h b/drivers/spi/mxc_spi_mx27.h
index 80f4962caef5..2323cd96e494 100644
--- a/drivers/spi/mxc_spi_mx27.h
+++ b/drivers/spi/mxc_spi_mx27.h
@@ -12,16 +12,12 @@
*/
/*!
- * @defgroup SPI Configurable Serial Peripheral Interface (CSPI) Driver
+ * @file mxc_spi_mx27.h
+ * @brief This header file contains SPI driver low level register definitions for MX27.
+ *
+ * @ingroup SPI
*/
- /*!
- * @file mxc_spi_mx27.h
- * @brief This header file contains SPI driver low level definition to access module registers.
- *
- * @ingroup SPI
- */
-
#ifndef __MXC_SPI_MX27_H__
#define __MXC_SPI_MX27_H__
diff --git a/drivers/usb/host/ehci-arc.c b/drivers/usb/host/ehci-arc.c
index 6933c1a6a774..69637b8821aa 100644
--- a/drivers/usb/host/ehci-arc.c
+++ b/drivers/usb/host/ehci-arc.c
@@ -14,6 +14,9 @@
*/
/*!
+ * @defgroup USB ARC OTG USB Driver
+ */
+/*!
* @file ehci-arc.c
* @brief platform related part of usb host driver.
* @ingroup USB
diff --git a/drivers/video/mxc/fs453.c b/drivers/video/mxc/fs453.c
index 3fe9c6ec28b7..1e71c39c54e1 100644
--- a/drivers/video/mxc/fs453.c
+++ b/drivers/video/mxc/fs453.c
@@ -12,10 +12,13 @@
*/
/*!
+ * @defgroup FS453 Focus FS453 TV Encoder Driver
+ */
+/*!
* @file fs453.c
* @brief Driver for FS453/4 TV encoder
*
- * @ingroup Framebuffer
+ * @ingroup FS453
*/
#include <linux/kernel.h>
diff --git a/drivers/video/mxc/fs453.h b/drivers/video/mxc/fs453.h
index 4dba9416114e..1edd11481b76 100644
--- a/drivers/video/mxc/fs453.h
+++ b/drivers/video/mxc/fs453.h
@@ -15,7 +15,7 @@
* @file fs453.h
* @brief Driver for FS453/4 TV encoder
*
- * @ingroup Framebuffer
+ * @ingroup FS453
*/
#ifndef __FS453_H__
diff --git a/drivers/video/mxc/mx2fb.c b/drivers/video/mxc/mx2fb.c
index 0657c3c90621..8db83df1d6a9 100644
--- a/drivers/video/mxc/mx2fb.c
+++ b/drivers/video/mxc/mx2fb.c
@@ -12,7 +12,7 @@
*/
/*!
- * @defgroup Framebuffer Framebuffer Driver for MX27 ADS.
+ * @defgroup Framebuffer_MX27 Framebuffer Driver for MX27.
*/
/*!
@@ -20,7 +20,7 @@
*
* @brief Frame buffer driver for MX27 ADS.
*
- * @ingroup Framebuffer
+ * @ingroup Framebuffer_MX27
*/
#include <linux/module.h>
diff --git a/include/asm-arm/arch-mxc/board-mx27ads.h b/include/asm-arm/arch-mxc/board-mx27ads.h
index 8f00526a68b6..6a9ddde60692 100644
--- a/include/asm-arm/arch-mxc/board-mx27ads.h
+++ b/include/asm-arm/arch-mxc/board-mx27ads.h
@@ -15,18 +15,18 @@
#define __ASM_ARCH_MXC_BOARD_MX27ADS_H__
/*!
- * @defgroup BRDCFG Board Configuration Options
- * @ingroup MSL
+ * @defgroup BRDCFG_MX27 Board Configuration Options
+ * @ingroup MSL_MX27
*/
/*!
- * @file board-mx27ads.h
+ * @file arch-mxc/board-mx27ads.h
*
* @brief This file contains all the board level configuration options.
*
* It currently hold the options defined for MX27 ADS Platform.
*
- * @ingroup BRDCFG
+ * @ingroup BRDCFG_MX27
*/
/*
diff --git a/include/asm-arm/arch-mxc/board-mx31ads.h b/include/asm-arm/arch-mxc/board-mx31ads.h
index 4387d78ec78e..938c8085f6c1 100644
--- a/include/asm-arm/arch-mxc/board-mx31ads.h
+++ b/include/asm-arm/arch-mxc/board-mx31ads.h
@@ -14,6 +14,21 @@
#ifndef __ASM_ARCH_MXC_BOARD_MX31ADS_H__
#define __ASM_ARCH_MXC_BOARD_MX31ADS_H__
+/*!
+ * @defgroup BRDCFG_MX31 Board Configuration Options
+ * @ingroup MSL_MX31
+ */
+
+/*!
+ * @file arch-mxc/board-mx31ads.h
+ *
+ * @brief This file contains all the board level configuration options.
+ *
+ * It currently hold the options defined for MX31 ADS Platform.
+ *
+ * @ingroup BRDCFG_MX31
+ */
+
/*
* Include Files
*/
diff --git a/include/asm-arm/arch-mxc/clock.h b/include/asm-arm/arch-mxc/clock.h
index 1ffa62246c9b..f1600879e5cd 100644
--- a/include/asm-arm/arch-mxc/clock.h
+++ b/include/asm-arm/arch-mxc/clock.h
@@ -15,12 +15,10 @@
#define __ASM_ARCH_MXC_CLOCK_H__
/*!
- * @defgroup CLOCKS Clocking Setup and Retrieving
- * @ingroup MSL
+ * @defgroup CLOCKS Clock Control API
*/
-
/*!
- * @file clock.h
+ * @file arch-mxc/clock.h
*
* @brief API for setting up and retrieving clocks.
*
diff --git a/include/asm-arm/arch-mxc/dma.h b/include/asm-arm/arch-mxc/dma.h
index 7e671128bff2..c552b29236ca 100644
--- a/include/asm-arm/arch-mxc/dma.h
+++ b/include/asm-arm/arch-mxc/dma.h
@@ -15,7 +15,7 @@
#define __ASM_ARCH_MXC_DMA_H__
/*!
- * @file dma.h
+ * @file arch-mxc/dma.h
* @brief This file contains Unified DMA API for all MXC platforms.
* The API is platform independent.
*
diff --git a/include/asm-arm/arch-mxc/dpm.h b/include/asm-arm/arch-mxc/dpm.h
index ea67a12aecbb..6f007f957174 100644
--- a/include/asm-arm/arch-mxc/dpm.h
+++ b/include/asm-arm/arch-mxc/dpm.h
@@ -28,16 +28,11 @@
#include <asm/timex.h>
/*!
- * @defgroup DPM Dynamic Power Management
- * @ingroup MSL
- */
-
-/*!
- * @file dpm.h
+ * @file arch-mxc/dpm.h
*
* @brief This file provides DPM support hooks for the Freescale MXC
*
- * @ingroup DPM
+ * @ingroup DPM_MX27 DPM_MX31
*/
/*!
diff --git a/include/asm-arm/arch-mxc/dptc.h b/include/asm-arm/arch-mxc/dptc.h
index b1a8d9f73675..12d58e3f480b 100644
--- a/include/asm-arm/arch-mxc/dptc.h
+++ b/include/asm-arm/arch-mxc/dptc.h
@@ -13,11 +13,11 @@
*/
/*!
- * @file dptc.h
+ * @file arch-mxc/dptc.h
*
* @brief MXC dptc header file.
*
- * @ingroup PM
+ * @ingroup PM_MX31
*/
#ifndef __ASM_ARCH_MXC_DPTC_H__
#define __ASM_ARCH_MXC_DPTC_H__
diff --git a/include/asm-arm/arch-mxc/dvfs.h b/include/asm-arm/arch-mxc/dvfs.h
index ff2c898573d1..bb31a3876413 100644
--- a/include/asm-arm/arch-mxc/dvfs.h
+++ b/include/asm-arm/arch-mxc/dvfs.h
@@ -12,11 +12,11 @@
*/
/*!
- * @file dvfs.h
+ * @file arch-mxc/dvfs.h
*
* @brief MXC dvfs header file.
*
- * @ingroup PM
+ * @ingroup PM_MX31
*/
#ifndef __ASM_ARCH_MXC_DVFS_H__
#define __ASM_ARCH_MXC_DVFS_H__
diff --git a/include/asm-arm/arch-mxc/dvfs_dptc_struct.h b/include/asm-arm/arch-mxc/dvfs_dptc_struct.h
index 382a3c2cbf43..fed4fcc1f55c 100644
--- a/include/asm-arm/arch-mxc/dvfs_dptc_struct.h
+++ b/include/asm-arm/arch-mxc/dvfs_dptc_struct.h
@@ -12,11 +12,11 @@
*/
/*!
- * @file dvfs_dptc_struct.h
+ * @file arch-mxc/dvfs_dptc_struct.h
*
* @brief MXC dvfs & dptc structure definitions file.
*
- * @ingroup PM
+ * @ingroup PM_MX27 PM_MX31
*/
#ifndef __ASM_ARCH_MXC_DVFS_DPTC_STRUCT_H__
#define __ASM_ARCH_MXC_DVFS_DPTC_STRUCT_H__
diff --git a/include/asm-arm/arch-mxc/gpio.h b/include/asm-arm/arch-mxc/gpio.h
index 7ecd688c22b5..ffa1e441a8c0 100644
--- a/include/asm-arm/arch-mxc/gpio.h
+++ b/include/asm-arm/arch-mxc/gpio.h
@@ -15,12 +15,11 @@
/*!
* @defgroup GPIO General Purpose Input Output (GPIO)
- * @ingroup MSL
*/
/*!
- * @file gpio.h
- * @brief This file contains the GPIO and IOMUX configuration details.
+ * @file arch-mxc/gpio.h
+ * @brief This file contains the GPIO API functions.
*
* @ingroup GPIO
*/
diff --git a/include/asm-arm/arch-mxc/hardware.h b/include/asm-arm/arch-mxc/hardware.h
index d062fe4a5980..26d73f55a53a 100644
--- a/include/asm-arm/arch-mxc/hardware.h
+++ b/include/asm-arm/arch-mxc/hardware.h
@@ -12,10 +12,10 @@
*/
/*!
- * @file hardware.h
+ * @file arch-mxc/hardware.h
* @brief This file contains the hardware definitions of the board.
*
- * @ingroup System
+ * @ingroup MSL_MX27 MSL_MX31
*/
#ifndef __ASM_ARCH_MXC_HARDWARE_H__
#define __ASM_ARCH_MXC_HARDWARE_H__
diff --git a/include/asm-arm/arch-mxc/io.h b/include/asm-arm/arch-mxc/io.h
index 96c319948839..46a1f6aad35a 100644
--- a/include/asm-arm/arch-mxc/io.h
+++ b/include/asm-arm/arch-mxc/io.h
@@ -12,12 +12,12 @@
*/
/*!
- * @file io.h
+ * @file arch-mxc/io.h
* @brief This file contains some memory mapping macros.
* @note There is no real ISA or PCI buses. But have to define these macros
* for some drivers to compile.
*
- * @ingroup System
+ * @ingroup MSL_MX27 MSL_MX31
*/
#ifndef __ASM_ARCH_MXC_IO_H__
diff --git a/include/asm-arm/arch-mxc/ipu.h b/include/asm-arm/arch-mxc/ipu.h
index 88700095f3d5..9cbfe37168a7 100644
--- a/include/asm-arm/arch-mxc/ipu.h
+++ b/include/asm-arm/arch-mxc/ipu.h
@@ -15,7 +15,7 @@
* @defgroup IPU MXC Image Processing Unit (IPU) Driver
*/
/*!
- * @file ipu.h
+ * @file arch-mxc/ipu.h
*
* @brief This file contains the IPU driver API declarations.
*
diff --git a/include/asm-arm/arch-mxc/irqs.h b/include/asm-arm/arch-mxc/irqs.h
index b8f2acc085ce..83c3f50921c2 100644
--- a/include/asm-arm/arch-mxc/irqs.h
+++ b/include/asm-arm/arch-mxc/irqs.h
@@ -17,10 +17,10 @@
/*!
* @defgroup Interrupt Interrupt Controller (AVIC)
- * @ingroup MSL
*/
+
/*!
- * @file irqs.h
+ * @file arch-mxc/irqs.h
* @brief This file defines the number of normal interrupts and fast interrupts
*
* @ingroup Interrupt
diff --git a/include/asm-arm/arch-mxc/memory.h b/include/asm-arm/arch-mxc/memory.h
index 6af0b9091e3a..4d6264e0dccb 100644
--- a/include/asm-arm/arch-mxc/memory.h
+++ b/include/asm-arm/arch-mxc/memory.h
@@ -16,15 +16,19 @@
#include <asm/arch/hardware.h>
/*!
- * @defgroup Memory Memory Map
- * @ingroup MSL
+ * @defgroup Memory_MX27 Memory Map
+ * @ingroup MSL_MX27
+ */
+/*!
+ * @defgroup Memory_MX31 Memory Map
+ * @ingroup MSL_MX31
*/
/*!
- * @file memory.h
+ * @file arch-mxc/memory.h
* @brief This file contains macros needed by the Linux kernel and drivers.
*
- * @ingroup Memory
+ * @ingroup Memory_MX27 Memory_MX31
*/
/*!
diff --git a/include/asm-arm/arch-mxc/mx27.h b/include/asm-arm/arch-mxc/mx27.h
index b668dd2026eb..eb741a84f0ff 100644
--- a/include/asm-arm/arch-mxc/mx27.h
+++ b/include/asm-arm/arch-mxc/mx27.h
@@ -12,19 +12,10 @@
*/
/*!
- * @defgroup MSL Machine Specific Layer (MSL)
- */
-
-/*!
- * @defgroup System System-wide Misc Files for MSL
- * @ingroup MSL
- */
-
-/*!
- * @file mx27.h
+ * @file arch-mxc/mx27.h
* @brief This file contains register definitions.
*
- * @ingroup System
+ * @ingroup MSL_MX27
*/
#ifndef __ASM_ARCH_MXC_MX27_H__
diff --git a/include/asm-arm/arch-mxc/mx27_pins.h b/include/asm-arm/arch-mxc/mx27_pins.h
index 44528e5392a0..7724316d8c77 100644
--- a/include/asm-arm/arch-mxc/mx27_pins.h
+++ b/include/asm-arm/arch-mxc/mx27_pins.h
@@ -14,6 +14,14 @@
#ifndef __ASM_ARCH_MXC_MX27_PINS_H__
#define __ASM_ARCH_MXC_MX27_PINS_H__
+/*!
+ * @file arch-mxc/mx27_pins.h
+ *
+ * @brief MX27 I/O Pin List
+ *
+ * @ingroup GPIO_MX27
+ */
+
#ifndef __ASSEMBLY__
/*!
diff --git a/include/asm-arm/arch-mxc/mx2_dma.h b/include/asm-arm/arch-mxc/mx2_dma.h
index 011a91c85581..2cf3d1747727 100644
--- a/include/asm-arm/arch-mxc/mx2_dma.h
+++ b/include/asm-arm/arch-mxc/mx2_dma.h
@@ -15,14 +15,14 @@
#define __ASM_ARCH_MXC_MX2_H__
/*!
-*@defgroup DMA DMA driver
-*/
+ * @defgroup DMA_MX27 DMA driver for i.MX27
+ */
/*!
- *@file mx2_dma.h
+ *@file arch-mxc/mx2_dma.h
*@brief DMA driver header file
*
- * @ingroup DMA
+ * @ingroup DMA_MX27
*
*/
diff --git a/include/asm-arm/arch-mxc/mx31.h b/include/asm-arm/arch-mxc/mx31.h
index 053912adba6e..1c98fc65fe97 100644
--- a/include/asm-arm/arch-mxc/mx31.h
+++ b/include/asm-arm/arch-mxc/mx31.h
@@ -20,6 +20,12 @@
#include <asm/arch/mx31_pins.h>
/*!
+ * @file arch-mxc/mx31.h
+ * @brief This file contains register definitions.
+ *
+ * @ingroup MSL_MX31
+ */
+/*!
* defines the OS clock tick rate
*/
#define CLOCK_TICK_RATE 16625000
diff --git a/include/asm-arm/arch-mxc/mx31_pins.h b/include/asm-arm/arch-mxc/mx31_pins.h
index fea9276fd753..66642de1839f 100644
--- a/include/asm-arm/arch-mxc/mx31_pins.h
+++ b/include/asm-arm/arch-mxc/mx31_pins.h
@@ -13,6 +13,14 @@
#ifndef __ASM_ARCH_MXC_MX31_PINS_H__
#define __ASM_ARCH_MXC_MX31_PINS_H__
+/*!
+ * @file arch-mxc/mx31_pins.h
+ *
+ * @brief MX31 I/O Pin List
+ *
+ * @ingroup GPIO_MX31
+ */
+
#ifndef __ASSEMBLY__
/*!
diff --git a/include/asm-arm/arch-mxc/mxc.h b/include/asm-arm/arch-mxc/mxc.h
index fa8027cff47c..7051d230fcc3 100644
--- a/include/asm-arm/arch-mxc/mxc.h
+++ b/include/asm-arm/arch-mxc/mxc.h
@@ -19,6 +19,10 @@
#ifndef __ASSEMBLY__
#include <linux/types.h>
+
+/*!
+ * @ingroup MSL_MX27 MSL_MX31
+ */
/*!
* gpio port structure
*/
diff --git a/include/asm-arm/arch-mxc/mxc_i2c.h b/include/asm-arm/arch-mxc/mxc_i2c.h
index 46de3cc40501..97fee0f33d49 100644
--- a/include/asm-arm/arch-mxc/mxc_i2c.h
+++ b/include/asm-arm/arch-mxc/mxc_i2c.h
@@ -18,7 +18,7 @@
*/
/*!
- * @file mxc_i2c.h
+ * @file arch-mxc/mxc_i2c.h
*
* @brief This file contains the I2C chip level configuration details.
*
diff --git a/include/asm-arm/arch-mxc/mxc_pf.h b/include/asm-arm/arch-mxc/mxc_pf.h
index dd5f13d8bf9d..77a14d7bf79c 100644
--- a/include/asm-arm/arch-mxc/mxc_pf.h
+++ b/include/asm-arm/arch-mxc/mxc_pf.h
@@ -15,7 +15,7 @@
* @defgroup MXC_PF MPEG4/H.264 Post Filter Driver
*/
/*!
- * @file mxc_pf.h
+ * @file arch-mxc/mxc_pf.h
*
* @brief MXC IPU MPEG4/H.264 Post-filtering driver
*
diff --git a/include/asm-arm/arch-mxc/mxc_pm.h b/include/asm-arm/arch-mxc/mxc_pm.h
index 2d3675f97773..8c80938de5b1 100644
--- a/include/asm-arm/arch-mxc/mxc_pm.h
+++ b/include/asm-arm/arch-mxc/mxc_pm.h
@@ -17,7 +17,7 @@
*/
/*!
- * @file mxc_pm.h
+ * @file arch-mxc/mxc_pm.h
*
* @brief This file contains the chip level configuration details and
* public API declarations for CRM_AP module
diff --git a/include/asm-arm/arch-mxc/mxc_scc.h b/include/asm-arm/arch-mxc/mxc_scc.h
index 82306cb055ec..3116e60dc157 100644
--- a/include/asm-arm/arch-mxc/mxc_scc.h
+++ b/include/asm-arm/arch-mxc/mxc_scc.h
@@ -12,7 +12,7 @@
*/
/*!
- * @file mxc_scc.h
+ * @file arch-mxc/mxc_scc.h
*
* @brief This is intended to be the file which contains all of code or changes
* needed to port the driver.
diff --git a/include/asm-arm/arch-mxc/mxc_scc_driver.h b/include/asm-arm/arch-mxc/mxc_scc_driver.h
index 3d94f2cc13fb..e013d33d02b4 100644
--- a/include/asm-arm/arch-mxc/mxc_scc_driver.h
+++ b/include/asm-arm/arch-mxc/mxc_scc_driver.h
@@ -39,7 +39,7 @@ extern "C" {
*/
/*!
- * @file mxc_scc_driver.h
+ * @file arch-mxc/mxc_scc_driver.h
*
* @brief Header file to use the SCC driver.
*
diff --git a/include/asm-arm/arch-mxc/mxc_security_api.h b/include/asm-arm/arch-mxc/mxc_security_api.h
index 0d1c533a7d1e..930526a810b7 100644
--- a/include/asm-arm/arch-mxc/mxc_security_api.h
+++ b/include/asm-arm/arch-mxc/mxc_security_api.h
@@ -26,7 +26,7 @@
*/
/*!
- * @file mxc_security_api.h
+ * @file arch-mxc/mxc_security_api.h
*
* @brief MXC Security user header file.
*
diff --git a/include/asm-arm/arch-mxc/mxc_uart.h b/include/asm-arm/arch-mxc/mxc_uart.h
index 3fc1dfd22f6f..e62d354ed9ff 100644
--- a/include/asm-arm/arch-mxc/mxc_uart.h
+++ b/include/asm-arm/arch-mxc/mxc_uart.h
@@ -16,7 +16,7 @@
*/
/*!
- * @file mxc_uart.h
+ * @file arch-mxc/mxc_uart.h
*
* @brief This file contains the UART configuration structure definition.
*
diff --git a/include/asm-arm/arch-mxc/mxc_v4l2.h b/include/asm-arm/arch-mxc/mxc_v4l2.h
index 14123386449a..aba8d74fc908 100644
--- a/include/asm-arm/arch-mxc/mxc_v4l2.h
+++ b/include/asm-arm/arch-mxc/mxc_v4l2.h
@@ -12,7 +12,7 @@
*/
/*!
- * @file mxc_v4l2.h
+ * @file arch-mxc/mxc_v4l2.h
*
* @brief mxc V4L2 private structures
*
diff --git a/include/asm-arm/arch-mxc/mxc_vpu.h b/include/asm-arm/arch-mxc/mxc_vpu.h
index 9f730048ba19..a1e1d7b99557 100644
--- a/include/asm-arm/arch-mxc/mxc_vpu.h
+++ b/include/asm-arm/arch-mxc/mxc_vpu.h
@@ -16,7 +16,7 @@
*/
/*!
- * @file mxc_vpu.h
+ * @file arch-mxc/mxc_vpu.h
*
* @brief VPU system initialization and file operation definition
*
diff --git a/include/asm-arm/arch-mxc/mxcfb.h b/include/asm-arm/arch-mxc/mxcfb.h
index 92dd55de1d0a..6c7dc6a8b32b 100644
--- a/include/asm-arm/arch-mxc/mxcfb.h
+++ b/include/asm-arm/arch-mxc/mxcfb.h
@@ -12,7 +12,7 @@
*/
/*
- * @file mxcfb.h
+ * @file arch-mxc/ mxcfb.h
*
* @brief Global header file for the MXC Frame buffer
*
diff --git a/include/asm-arm/arch-mxc/param.h b/include/asm-arm/arch-mxc/param.h
index e37fd1ffd637..2218ae878c1f 100644
--- a/include/asm-arm/arch-mxc/param.h
+++ b/include/asm-arm/arch-mxc/param.h
@@ -18,9 +18,9 @@
*/
/*!
- * @file param.h
+ * @file arch-mxc/param.h
*
* @brief This file exists only because other kernel files include it.
*
- * @ingroup System
+ * @ingroup MSL_MX27 MSL_MX31
*/
diff --git a/include/asm-arm/arch-mxc/pm_api.h b/include/asm-arm/arch-mxc/pm_api.h
index ed9528698039..4b9c8a2ae147 100644
--- a/include/asm-arm/arch-mxc/pm_api.h
+++ b/include/asm-arm/arch-mxc/pm_api.h
@@ -12,15 +12,18 @@
*/
/*!
- * @defgroup PM Dynamic Process Temperature Compensation (DPTC) & Dynamic Voltage Frequency Scaling (DVFS) Drivers
+ * @defgroup PM_MX27 Dynamic Process Temperature Compensation (DPTC) for i.MX27
+ */
+/*!
+ * @defgroup PM_MX31 Dynamic Process Temperature Compensation (DPTC) & Dynamic Voltage Frequency Scaling (DVFS) Drivers for i.MX31
*/
/*!
- * @file pm_api.h
+ * @file arch-mxc/pm_api.h
*
* @brief MXC PM API header file.
*
- * @ingroup PM
+ * @ingroup PM_MX27 PM_MX31
*/
#ifndef __ASM_ARCH_MXC_PM_API_H__
#define __ASM_ARCH_MXC_PM_API_H__
diff --git a/include/asm-arm/arch-mxc/pmic_adc.h b/include/asm-arm/arch-mxc/pmic_adc.h
index 24ffa1d27b9b..30573861785c 100644
--- a/include/asm-arm/arch-mxc/pmic_adc.h
+++ b/include/asm-arm/arch-mxc/pmic_adc.h
@@ -20,7 +20,7 @@
*/
/*!
- * @file pmic_adc.h
+ * @file arch-mxc/pmic_adc.h
* @brief This is the header of PMIC ADC driver.
*
* @ingroup PMIC_ADC
diff --git a/include/asm-arm/arch-mxc/pmic_audio.h b/include/asm-arm/arch-mxc/pmic_audio.h
index f870ae7234d2..61c6235b4295 100644
--- a/include/asm-arm/arch-mxc/pmic_audio.h
+++ b/include/asm-arm/arch-mxc/pmic_audio.h
@@ -19,7 +19,7 @@
*/
/*!
- * @file pmic_audio.h
+ * @file arch-mxc/pmic_audio.h
* @brief External definitions for the PMIC Audio Client driver.
*
* The PMIC Audio driver and this API were developed to support the
diff --git a/include/asm-arm/arch-mxc/pmic_battery.h b/include/asm-arm/arch-mxc/pmic_battery.h
index fe7309413fdd..b3929910d516 100644
--- a/include/asm-arm/arch-mxc/pmic_battery.h
+++ b/include/asm-arm/arch-mxc/pmic_battery.h
@@ -19,7 +19,7 @@
*/
/*!
- * @file pmic_battery.h
+ * @file arch-mxc/pmic_battery.h
* @brief This is the header of PMIC Battery driver.
*
* @ingroup PMIC_BATTERY
diff --git a/include/asm-arm/arch-mxc/pmic_convity.h b/include/asm-arm/arch-mxc/pmic_convity.h
index 88327d5424ee..484abf0f3c56 100644
--- a/include/asm-arm/arch-mxc/pmic_convity.h
+++ b/include/asm-arm/arch-mxc/pmic_convity.h
@@ -19,7 +19,7 @@
*/
/*!
- * @file pmic_convity.h
+ * @file arch-mxc/pmic_convity.h
* @brief External definitions for the PMIC Connectivity Client driver.
*
* The PMIC Connectivity driver and this API were developed to support the
diff --git a/include/asm-arm/arch-mxc/pmic_external.h b/include/asm-arm/arch-mxc/pmic_external.h
index 3d60c993173a..f06e9e3a0ce7 100644
--- a/include/asm-arm/arch-mxc/pmic_external.h
+++ b/include/asm-arm/arch-mxc/pmic_external.h
@@ -27,7 +27,7 @@
*/
/*!
- * @file pmic_external.h
+ * @file arch-mxc/pmic_external.h
* @brief This file contains interface of PMIC protocol driver.
*
* @ingroup PMIC_CORE
diff --git a/include/asm-arm/arch-mxc/pmic_light.h b/include/asm-arm/arch-mxc/pmic_light.h
index e9d96b32a6d5..3465b1bf3090 100644
--- a/include/asm-arm/arch-mxc/pmic_light.h
+++ b/include/asm-arm/arch-mxc/pmic_light.h
@@ -19,7 +19,7 @@
*/
/*!
- * @file pmic_light.h
+ * @file arch-mxc/pmic_light.h
* @brief This is the header of PMIC Light driver.
*
* @ingroup PMIC_LIGHT
diff --git a/include/asm-arm/arch-mxc/pmic_power.h b/include/asm-arm/arch-mxc/pmic_power.h
index a3c80c8dadd2..25885ff9da88 100644
--- a/include/asm-arm/arch-mxc/pmic_power.h
+++ b/include/asm-arm/arch-mxc/pmic_power.h
@@ -19,7 +19,7 @@
*/
/*!
- * @file pmic_power.h
+ * @file arch-mxc/pmic_power.h
* @brief This is the header of PMIC power driver.
*
* @ingroup PMIC_POWER
diff --git a/include/asm-arm/arch-mxc/pmic_rtc.h b/include/asm-arm/arch-mxc/pmic_rtc.h
index 1325553d617a..83a29af21728 100644
--- a/include/asm-arm/arch-mxc/pmic_rtc.h
+++ b/include/asm-arm/arch-mxc/pmic_rtc.h
@@ -20,7 +20,7 @@
*/
/*!
- * @file pmic_rtc.h
+ * @file arch-mxc/pmic_rtc.h
* @brief This is the header of PMIC RTC driver.
*
* @ingroup PMIC_RTC
diff --git a/include/asm-arm/arch-mxc/pmic_status.h b/include/asm-arm/arch-mxc/pmic_status.h
index e20572951779..9b58b1fca4b6 100644
--- a/include/asm-arm/arch-mxc/pmic_status.h
+++ b/include/asm-arm/arch-mxc/pmic_status.h
@@ -14,7 +14,7 @@
#define __ASM_ARCH_MXC_PMIC_STATUS_H__
#include <asm-generic/errno-base.h>
/*!
- * @file pmic_status.h
+ * @file arch-mxc/pmic_status.h
* @brief PMIC APIs return code definition.
*
* @ingroup PMIC_CORE
diff --git a/include/asm-arm/arch-mxc/sdma.h b/include/asm-arm/arch-mxc/sdma.h
index 2cc4c90fe9c1..a101e7353136 100644
--- a/include/asm-arm/arch-mxc/sdma.h
+++ b/include/asm-arm/arch-mxc/sdma.h
@@ -20,7 +20,7 @@
*/
/*!
- * @file sdma.h
+ * @file arch-mxc/sdma.h
*
* @brief This file contains the SDMA API declarations.
*
diff --git a/include/asm-arm/arch-mxc/spba.h b/include/asm-arm/arch-mxc/spba.h
index 1d698411b2ce..52d26cf30c52 100644
--- a/include/asm-arm/arch-mxc/spba.h
+++ b/include/asm-arm/arch-mxc/spba.h
@@ -14,11 +14,11 @@
/*!
* @defgroup SPBA Shared Peripheral Bus Arbiter (SPBA)
- * @ingroup MSL
+ * @ingroup MSL_MX31
*/
/*!
- * @file spba.h
+ * @file arch-mxc/spba.h
* @brief This file contains the Shared Peripheral Bus Arbiter (spba) API.
*
* @ingroup SPBA
diff --git a/include/asm-arm/arch-mxc/system.h b/include/asm-arm/arch-mxc/system.h
index 493591d6e5c7..914d595bd9ae 100644
--- a/include/asm-arm/arch-mxc/system.h
+++ b/include/asm-arm/arch-mxc/system.h
@@ -22,19 +22,10 @@
#define __ASM_ARCH_MXC_SYSTEM_H__
/*!
- * @defgroup MSL Machine Specific Layer (MSL)
- */
-
-/*!
- * @defgroup System System-wide Misc Files for MSL
- * @ingroup MSL
- */
-
-/*!
- * @file system.h
+ * @file arch-mxc/system.h
* @brief This file contains idle and reset functions.
*
- * @ingroup System
+ * @ingroup MSL_MX27 MSL_MX31
*/
/*!
diff --git a/include/asm-arm/arch-mxc/vmalloc.h b/include/asm-arm/arch-mxc/vmalloc.h
index 2732fb4f62b4..9fcba5964d06 100644
--- a/include/asm-arm/arch-mxc/vmalloc.h
+++ b/include/asm-arm/arch-mxc/vmalloc.h
@@ -21,11 +21,11 @@
#define __ASM_ARCH_MXC_VMALLOC_H__
/*!
- * @file vmalloc.h
+ * @file arch-mxc/vmalloc.h
*
* @brief This file contains the macros for vmalloc.
*
- * @ingroup System
+ * @ingroup MSL_MX27 MSL_MX31
*/
/*!
diff --git a/sound/arm/mxc-alsa-common.h b/sound/arm/mxc-alsa-common.h
index 3de4526c0601..d2e3e996349d 100644
--- a/sound/arm/mxc-alsa-common.h
+++ b/sound/arm/mxc-alsa-common.h
@@ -14,7 +14,7 @@
/*!
* @file mxc-alsa-common.h
* @brief
- * @ingroup
+ * @ingroup SOUND_DRV
*/
#ifndef __MXC_ALSA_COMMON_H__
diff --git a/sound/arm/mxc-alsa-mixer.c b/sound/arm/mxc-alsa-mixer.c
index f7fb6291fcc3..f29f1ad2f25b 100644
--- a/sound/arm/mxc-alsa-mixer.c
+++ b/sound/arm/mxc-alsa-mixer.c
@@ -22,7 +22,7 @@
* Playback supports 8000, 11025, 16000, 22050, 24000, 32000,
* 44100 and 48000 khz for mono and stereo.
*
- * @ingroup SOUND_DRV
+ * @ingroup SOUND_DRV
*/
#include <sound/driver.h>
diff --git a/sound/arm/mxc-alsa-pmic.c b/sound/arm/mxc-alsa-pmic.c
index 1d11a4638cb4..0e51339b6258 100644
--- a/sound/arm/mxc-alsa-pmic.c
+++ b/sound/arm/mxc-alsa-pmic.c
@@ -31,7 +31,7 @@
* These mixer controls shall be accessible thru alsa as well as
* OSS emulation modes
*
- * @ingroup SOUND_DRV
+ * @ingroup SOUND_DRV
*/
#include <sound/driver.h>
diff --git a/sound/arm/mxc-alsa-pmic.h b/sound/arm/mxc-alsa-pmic.h
index be2e014aee5f..407c69f27836 100644
--- a/sound/arm/mxc-alsa-pmic.h
+++ b/sound/arm/mxc-alsa-pmic.h
@@ -19,7 +19,7 @@
/*!
* @file mxc-alsa-pmic.h
* @brief
- * @ingroup
+ * @ingroup SOUND_DRV
*/
#ifndef __MXC_ALSA_PMIC_H__