score: Doxygen Clean Up Task #15

8 files changed, 59 insertions, 39 deletions

diff --git a/cpukit/score/cpu/m68k/rtems/asm.h b/cpukit/score/cpu/m68k/rtems/asm.h
index f6abbd6d32..cbd2a7f8b2 100644
--- a/cpukit/score/cpu/m68k/rtems/asm.h
+++ b/cpukit/score/cpu/m68k/rtems/asm.h
@@ -1,17 +1,20 @@
 /**
- * @file rtems/asm.h
+ * @file
+ * 
+ * @brief Address the Problems Caused by Incompatible Flavor of 
+ * Assemblers and Toolsets
  *
- *  This include file attempts to address the problems
- *  caused by incompatible flavors of assemblers and
- *  toolsets.  It primarily addresses variations in the
- *  use of leading underscores on symbols and the requirement
- *  that register names be preceded by a %.
+ * This include file attempts to address the problems
+ * caused by incompatible flavors of assemblers and
+ * toolsets.  It primarily addresses variations in the
+ * use of leading underscores on symbols and the requirement
+ * that register names be preceded by a %.
+ * 
+ * NOTE: The spacing in the use of these macros
+ *       is critical to them working as advertised.
  */
 
 /*
- *  NOTE: The spacing in the use of these macros
- *        is critical to them working as advertised.
- *
  *  COPYRIGHT:
  *
  *  This file is based on similar code found in newlib available
diff --git a/cpukit/score/cpu/m68k/rtems/m68k/m68302.h b/cpukit/score/cpu/m68k/rtems/m68k/m68302.h
index bcda554948..acf55f50c5 100644
--- a/cpukit/score/cpu/m68k/rtems/m68k/m68302.h
+++ b/cpukit/score/cpu/m68k/rtems/m68k/m68302.h
@@ -1,7 +1,7 @@
-/*
- *------------------------------------------------------------------
+/**
+ * @file
  *
- *	m68302.h - Definitions for Motorola MC68302 processor.
+ * @brief Definitions for Motorola MC68302 Processor
  *
  * Section references in this file refer to revision 2 of Motorola's
  * "MC68302 Integrated Multiprotocol Processor User's Manual".
@@ -9,7 +9,9 @@
  *
  * Based on Don Meyer's cpu68302.h that was posted in comp.sys.m68k
  * on 17 February, 1993.
- *
+ */
+
+/*
  * COPYRIGHT 1995 David W. Glessner.
  *
  * Redistribution and use in source and binary forms are permitted
diff --git a/cpukit/score/cpu/m68k/rtems/m68k/m68360.h b/cpukit/score/cpu/m68k/rtems/m68k/m68360.h
index 5c7b90691f..dc181d0cdf 100644
--- a/cpukit/score/cpu/m68k/rtems/m68k/m68360.h
+++ b/cpukit/score/cpu/m68k/rtems/m68k/m68360.h
@@ -1,3 +1,8 @@
+/**
+ * @file
+ *
+ * @brief Definitions for Motorola MC68360 Processor
+ */
 /*
  **************************************************************************
  **************************************************************************
@@ -707,7 +712,7 @@ typedef struct m360_ {
 	unsigned char		_pad14[0xF0-0xD0];
 	unsigned char		_pad15[0x100-0xF0];
 	unsigned char		_pad16[0x500-0x100];
-	
+
 	/*
 	 * IDMA1 Block
 	 */
@@ -725,7 +730,7 @@ typedef struct m360_ {
 	unsigned char		csr1;
 	unsigned char		_pad21;
 	unsigned short		_pad22;
-	
+
 	/*
 	 * SDMA Block
 	 */
@@ -733,7 +738,7 @@ typedef struct m360_ {
 	unsigned char		_pad23;
 	unsigned short		sdcr;
 	unsigned long		sdar;
-	
+
 	/*
 	 * IDMA2 Block
 	 */
@@ -750,7 +755,7 @@ typedef struct m360_ {
 	unsigned char		_pad28;
 	unsigned short		_pad29;
 	unsigned long		_pad30;
-	
+
 	/*
 	 * CPIC Block
 	 */
@@ -774,7 +779,7 @@ typedef struct m360_ {
 	unsigned short		pcint;
 	unsigned short		_pad32;
 	unsigned long		_pad33[5];
-	
+
 	/*
 	 * TIMER Block
 	 */
@@ -802,7 +807,7 @@ typedef struct m360_ {
 	unsigned short		ter3;
 	unsigned short		ter4;
 	unsigned long		_pad36[2];
-	
+
 	/*
 	 * CP Block
 	 */
diff --git a/cpukit/score/cpu/m68k/rtems/m68k/qsm.h b/cpukit/score/cpu/m68k/rtems/m68k/qsm.h
index 312dfa8325..32dbc1d5f9 100644
--- a/cpukit/score/cpu/m68k/rtems/m68k/qsm.h
+++ b/cpukit/score/cpu/m68k/rtems/m68k/qsm.h
@@ -1,7 +1,7 @@
-/*
- *-------------------------------------------------------------------
+/**
+ * @file
  *
- *   QSM -- Queued Serial Module
+ * @brief Motorola M68K Queued Serial Module
  *
  * The QSM contains two serial interfaces: (a) the queued serial
  * peripheral interface (QSPI) and the serial communication interface
@@ -15,7 +15,9 @@
  * For more information, refer to Motorola's "Modular Microcontroller
  * Family Queued Serial Module Reference Manual" (Motorola document
  * QSMRM/AD).
- *
+ */
+
+/*
  * This file was created by John S. Gwynne to support Motorola's 68332 MCU.
  *
  * Redistribution and use in source and binary forms are permitted
diff --git a/cpukit/score/cpu/m68k/rtems/m68k/sim.h b/cpukit/score/cpu/m68k/rtems/m68k/sim.h
index 42eae109d9..cec6b84cc1 100644
--- a/cpukit/score/cpu/m68k/rtems/m68k/sim.h
+++ b/cpukit/score/cpu/m68k/rtems/m68k/sim.h
@@ -1,7 +1,7 @@
-/*
- *-------------------------------------------------------------------
+/**
+ * @file
  *
- *   SIM -- System Integration Module
+ * @brief Motorola M68K System Integration Module
  *
  * The system integration module (SIM) is used on many Motorola 16-
  * and 32-bit MCUs for the following functions:
@@ -23,7 +23,9 @@
  * For more information, refer to Motorola's "Modular Microcontroller
  * Family System Integration Module Reference Manual" (Motorola document
  * SIMRM/AD).
- *
+ */
+
+/*
  * This file was created by John S. Gwynne to support Motorola's 68332 MCU.
  *
  * Redistribution and use in source and binary forms are permitted
diff --git a/cpukit/score/cpu/m68k/rtems/score/cpu.h b/cpukit/score/cpu/m68k/rtems/score/cpu.h
index fb970eb108..8575f90e19 100644
--- a/cpukit/score/cpu/m68k/rtems/score/cpu.h
+++ b/cpukit/score/cpu/m68k/rtems/score/cpu.h
@@ -1,11 +1,13 @@
 /**
- * @file rtems/score/cpu.h
+ * @file 
+ * 
+ * @brief Motorola M68K CPU Dependent Source
+ * 
+ * This include file contains information pertaining to the Motorola
+ * m68xxx processor family.
  */
 
 /*
- *  This include file contains information pertaining to the Motorola
- *  m68xxx processor family.
- *
  *  COPYRIGHT (c) 1989-2011.
  *  On-Line Applications Research Corporation (OAR).
  *
diff --git a/cpukit/score/cpu/m68k/rtems/score/m68k.h b/cpukit/score/cpu/m68k/rtems/score/m68k.h
index cc2f11dc40..2c646c5bcf 100644
--- a/cpukit/score/cpu/m68k/rtems/score/m68k.h
+++ b/cpukit/score/cpu/m68k/rtems/score/m68k.h
@@ -1,11 +1,13 @@
 /**
- * @file rtems/score/m68k.h
+ * @file
+ * 
+ * @brief Motorola M68K CPU Dependent Source
+ * 
+ * This include file contains information pertaining to the Motorola
+ * m68xxx processor family.
  */
 
 /*
- *  This include file contains information pertaining to the Motorola
- *  m68xxx processor family.
- *
  *  COPYRIGHT (c) 1989-1999.
  *  On-Line Applications Research Corporation (OAR).
  *
diff --git a/cpukit/score/cpu/m68k/rtems/score/types.h b/cpukit/score/cpu/m68k/rtems/score/types.h
index 8591511075..a901c90542 100644
--- a/cpukit/score/cpu/m68k/rtems/score/types.h
+++ b/cpukit/score/cpu/m68k/rtems/score/types.h
@@ -1,11 +1,13 @@
 /**
- * @file rtems/score/types.h
+ * @file
+ * 
+ * @brief Motorola M68K CPU Type Definitions
+ * 
+ * This include file contains type definitions pertaining to the Motorola
+ * m68xxx processor family.
  */
 
 /*
- *  This include file contains type definitions pertaining to the Motorola
- *  m68xxx processor family.
- *
  *  COPYRIGHT (c) 1989-1999.
  *  On-Line Applications Research Corporation (OAR).
  *