Some doxygen related fixes

Nishanth Menon wrote:
> no signed off by and no diffstat?

Ups.

> can you use git-format-patch to send please? it is easier to review.

Sure. Here it comes:

jbe

------8<---------8<---------8<---------8<---------8<---------8<----

Subject: [PATCH] Some doxygen related fixes:
  - fix a few doxygen comments that are used in a wrong way
  - move some pages and their content to a better place in the
    generated documentation

Signed-off-by: Juergen Beisert <jbe@pengutronix.de>
Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>

5 files changed, 4 insertions, 14 deletions

diff --git a/arch/architecture.dox b/arch/architecture.dox
index 6ef5ba928d..238385275b 100644
--- a/arch/architecture.dox
+++ b/arch/architecture.dox
@@ -87,6 +87,7 @@ TODO
 @li @subpage dev_arm_mach
 @li @subpage dev_bf_mach
 @li @subpage dev_ppc_mach
+@li @subpage dev_m68k_mach
 
 */
 
diff --git a/arch/arm/cpu/cpu.c b/arch/arm/cpu/cpu.c
index 180f4583bd..154f8cc46d 100644
--- a/arch/arm/cpu/cpu.c
+++ b/arch/arm/cpu/cpu.c
@@ -162,12 +162,6 @@ int cleanup_before_linux (void)
  * required.
  */
 
-/**
- * @page arm_for_linux Preparing for Linux to run
- *
- * What's to do on ARM to run Linux after U-Boot did its job?
- */
-
 static int do_icache(cmd_tbl_t *cmdtp, int argc, char *argv[])
 {
 	if (argc == 1) {
diff --git a/arch/arm/cpu/interrupts.c b/arch/arm/cpu/interrupts.c
index 418da18b44..0557172fe3 100644
--- a/arch/arm/cpu/interrupts.c
+++ b/arch/arm/cpu/interrupts.c
@@ -198,9 +198,3 @@ void do_irq (struct pt_regs *pt_regs)
 	show_regs (pt_regs);
 	bad_mode ();
 }
-
-/**
- * @page arm_interrupts Interrupt handling on ARM
- *
- * Why U-boot doesn't use interrupts?
- */
diff --git a/arch/arm/mach-omap/syslib.c b/arch/arm/mach-omap/syslib.c
index 4f70abcd53..2b25dc153c 100644
--- a/arch/arm/mach-omap/syslib.c
+++ b/arch/arm/mach-omap/syslib.c
@@ -40,7 +40,7 @@
  *
  * Will be constant time as its generally used in bypass conditions only.
  * This is necessary until timers are accessible. if you need timed delays
- * use @ref mdelay or @udelay instead
+ * use @ref mdelay or @ref udelay instead
  *
  * @param[in] loops number of loops
  *
diff --git a/arch/m68k/lib/m68k-linuxboot.c b/arch/m68k/lib/m68k-linuxboot.c
index 63b0cc134d..b29e2d5c13 100644
--- a/arch/m68k/lib/m68k-linuxboot.c
+++ b/arch/m68k/lib/m68k-linuxboot.c
@@ -18,7 +18,8 @@
  * along with U-Boot V2.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/** @file Linux boot preparation code.
+/** @file
+ *  @brief Linux boot preparation code.
  *
  * This file is responsible to start a linux kernel on
  * Coldfire targets.