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

41 files changed, 138 insertions, 115 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.
  *