4 files changed, 29 insertions, 18 deletions
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