score: Doxygen Clean Up Task #5

6 files changed, 44 insertions, 30 deletions

diff --git a/cpukit/score/cpu/i386/rtems/score/cpu.h b/cpukit/score/cpu/i386/rtems/score/cpu.h
index 03d6209981..66676047f8 100644
--- a/cpukit/score/cpu/i386/rtems/score/cpu.h
+++ b/cpukit/score/cpu/i386/rtems/score/cpu.h
@@ -1,11 +1,13 @@
 /**
- * @file rtems/score/cpu.h
+ * @file
+ * 
+ * @brief Intel I386 CPU Dependent Source
+ * 
+ * This include file contains information pertaining to the Intel
+ * i386 processor.
  */
 
 /*
- *  This include file contains information pertaining to the Intel
- *  i386 processor.
- *
  *  COPYRIGHT (c) 1989-2011.
  *  On-Line Applications Research Corporation (OAR).
  *
diff --git a/cpukit/score/cpu/i386/rtems/score/i386.h b/cpukit/score/cpu/i386/rtems/score/i386.h
index 8b98f4ba28..b21fb93957 100644
--- a/cpukit/score/cpu/i386/rtems/score/i386.h
+++ b/cpukit/score/cpu/i386/rtems/score/i386.h
@@ -1,11 +1,13 @@
 /**
- * @file rtems/score/i386.h
+ * @file
+ * 
+ * @brief Intel I386 CPU Dependent Source
+ * 
+ * This include file contains information pertaining to the Intel
+ * i386 processor.
  */
 
 /*
- *  This include file contains information pertaining to the Intel
- *  i386 processor.
- *
  *  COPYRIGHT (c) 1989-1999.
  *  On-Line Applications Research Corporation (OAR).
  *
diff --git a/cpukit/score/cpu/i386/rtems/score/idtr.h b/cpukit/score/cpu/i386/rtems/score/idtr.h
index 401aebe2fa..8358fd5a16 100644
--- a/cpukit/score/cpu/i386/rtems/score/idtr.h
+++ b/cpukit/score/cpu/i386/rtems/score/idtr.h
@@ -1,19 +1,21 @@
 /**
- * @file rtems/score/idtr.h
- */
-
-/*
+ * @file
+ * 
+ * @brief Intel I386 Data Structures
+ * 
  * This file contains definitions for data structure related
  *          to Intel system programming. More information can be found
  *          on Intel site and more precisely in the following book :
  *
- *		Pentium Processor familly
- *		Developper's Manual
+ *              Pentium Processor familly
+ *              Developper's Manual
  *
- *		Volume 3 : Architecture and Programming Manual
+ *              Volume 3 : Architecture and Programming Manual
  *
  * Formerly contained in and extracted from libcpu/i386/cpu.h.
- *
+ */
+
+/*
  * COPYRIGHT (C) 1998  Eric Valette (valette@crf.canon.fr)
  *                     Canon Centre Recherche France.
  *
diff --git a/cpukit/score/cpu/i386/rtems/score/interrupts.h b/cpukit/score/cpu/i386/rtems/score/interrupts.h
index 08ad2b16c0..4787bcb663 100644
--- a/cpukit/score/cpu/i386/rtems/score/interrupts.h
+++ b/cpukit/score/cpu/i386/rtems/score/interrupts.h
@@ -1,12 +1,12 @@
 /**
- * @file rtems/score/interrupts.h
+ * @file
+ * 
+ * @brief Intel I386 Interrupt Macros
+ *
+ * Formerly contained in and extracted from libcpu/i386/cpu.h
  */
 
 /*
- *  i386 interrupt macros.
- *
- *  Formerly contained in and extracted from libcpu/i386/cpu.h
- *
  *  COPYRIGHT (c) 1998 valette@crf.canon.fr
  *
  *  The license and distribution terms for this file may be
@@ -28,8 +28,10 @@ typedef void (*rtems_raw_irq_enable)		(const struct __rtems_raw_irq_connect_data
 typedef void (*rtems_raw_irq_disable)		(const struct __rtems_raw_irq_connect_data__*);
 typedef int  (*rtems_raw_irq_is_enabled)	(const struct __rtems_raw_irq_connect_data__*);
 
-/*
- *  Interrupt Level Macros
+/**
+ * @name Interrupt Level Macros
+ * 
+ * @{
  */
 
 #define i386_disable_interrupts( _level ) \
@@ -73,5 +75,7 @@ typedef int  (*rtems_raw_irq_is_enabled)	(const struct __rtems_raw_irq_connect_d
 #define _CPU_ISR_Disable( _level ) i386_disable_interrupts( _level )
 #define _CPU_ISR_Enable( _level ) i386_enable_interrupts( _level )
 
+/** @} */
+
 #endif
 #endif
diff --git a/cpukit/score/cpu/i386/rtems/score/registers.h b/cpukit/score/cpu/i386/rtems/score/registers.h
index 2b8f7700cd..f9754dcedb 100644
--- a/cpukit/score/cpu/i386/rtems/score/registers.h
+++ b/cpukit/score/cpu/i386/rtems/score/registers.h
@@ -1,10 +1,12 @@
 /**
- * @file rtems/score/registers.h
+ * @file
+ * 
+ * @brief Intel CPU Constants and Definitions
+ * 
+ * This file contains definition and constants related to Intel Cpu
  */
 
 /*
- *  This file contains definition and constants related to Intel Cpu
- *
  *  COPYRIGHT (c) 1998 valette@crf.canon.fr
  *
  *  The license and distribution terms for this file may be
diff --git a/cpukit/score/cpu/i386/rtems/score/types.h b/cpukit/score/cpu/i386/rtems/score/types.h
index b2c9d3ec57..104b0fcc92 100644
--- a/cpukit/score/cpu/i386/rtems/score/types.h
+++ b/cpukit/score/cpu/i386/rtems/score/types.h
@@ -1,11 +1,13 @@
 /**
- * @file rtems/score/types.h
+ * @file
+ * 
+ * @brief Intel I386 CPU Type Definitions
+ * 
+ * This include file contains type definitions pertaining to the Intel
+ * i386 processor family.
  */
 
 /*
- *  This include file contains type definitions pertaining to the Intel
- *  i386 processor family.
- *
  *  COPYRIGHT (c) 1989-1999.
  *  On-Line Applications Research Corporation (OAR).
  *