2008-04-18 Joel Sherrill <joel.sherrill@oarcorp.com>

	* rtems/include/rtems.h, rtems/include/rtems/rtems/asr.h,
	rtems/include/rtems/rtems/attr.h,
	rtems/include/rtems/rtems/barrier.h,
	rtems/include/rtems/rtems/barriermp.h,
	rtems/include/rtems/rtems/cache.h, rtems/include/rtems/rtems/clock.h,
	rtems/include/rtems/rtems/config.h,
	rtems/include/rtems/rtems/dpmem.h, rtems/include/rtems/rtems/event.h,
	rtems/include/rtems/rtems/eventmp.h,
	rtems/include/rtems/rtems/eventset.h,
	rtems/include/rtems/rtems/intr.h,
	rtems/include/rtems/rtems/message.h,
	rtems/include/rtems/rtems/modes.h, rtems/include/rtems/rtems/mp.h,
	rtems/include/rtems/rtems/msgmp.h,
	rtems/include/rtems/rtems/object.h,
	rtems/include/rtems/rtems/options.h,
	rtems/include/rtems/rtems/part.h, rtems/include/rtems/rtems/partmp.h,
	rtems/include/rtems/rtems/ratemon.h,
	rtems/include/rtems/rtems/region.h,
	rtems/include/rtems/rtems/regionmp.h,
	rtems/include/rtems/rtems/rtemsapi.h,
	rtems/include/rtems/rtems/sem.h, rtems/include/rtems/rtems/semmp.h,
	rtems/include/rtems/rtems/signal.h,
	rtems/include/rtems/rtems/signalmp.h,
	rtems/include/rtems/rtems/status.h,
	rtems/include/rtems/rtems/support.h,
	rtems/include/rtems/rtems/taskmp.h,
	rtems/include/rtems/rtems/tasks.h, rtems/include/rtems/rtems/timer.h,
	rtems/include/rtems/rtems/types.h, rtems/inline/rtems/rtems/asr.inl,
	rtems/inline/rtems/rtems/attr.inl,
	rtems/inline/rtems/rtems/barrier.inl,
	rtems/inline/rtems/rtems/dpmem.inl,
	rtems/inline/rtems/rtems/event.inl,
	rtems/inline/rtems/rtems/eventset.inl,
	rtems/inline/rtems/rtems/message.inl,
	rtems/inline/rtems/rtems/modes.inl,
	rtems/inline/rtems/rtems/options.inl,
	rtems/inline/rtems/rtems/part.inl,
	rtems/inline/rtems/rtems/ratemon.inl,
	rtems/inline/rtems/rtems/region.inl,
	rtems/inline/rtems/rtems/sem.inl,
	rtems/inline/rtems/rtems/status.inl,
	rtems/inline/rtems/rtems/support.inl,
	rtems/inline/rtems/rtems/tasks.inl,
	rtems/inline/rtems/rtems/timer.inl: Initial conversion of Classic API
	header files to Doxygen.
	* rtems/Doxyfile: New file.

1 files changed, 48 insertions, 14 deletions

diff --git a/cpukit/rtems/include/rtems/rtems/asr.h b/cpukit/rtems/include/rtems/rtems/asr.h
index 6fb7f3db91..4fcade6d28 100644
--- a/cpukit/rtems/include/rtems/rtems/asr.h
+++ b/cpukit/rtems/include/rtems/rtems/asr.h
@@ -1,13 +1,12 @@
 /**
  * @file rtems/rtems/asr.h
- */
-
-/*
+ *
  *  This include file contains all the constants and structures associated
  *  with the Asynchronous Signal Handler.  This Handler provides the low-level
  *  support required by the Signal Manager.
- *
- *  COPYRIGHT (c) 1989-1999.
+ */
+
+/*  COPYRIGHT (c) 1989-1999.
  *  On-Line Applications Research Corporation (OAR).
  *
  *  The license and distribution terms for this file may be
@@ -26,35 +25,36 @@ extern "C" {
 
 #include <rtems/rtems/modes.h>
 
-/*
+/**
+ *  @defgroup ClassicASR Classic API ASR Support
  *
+ *  This encapsulates functionality which XXX
+ */
+/**@{*/
+
+/**
  *  The following type defines the control block used to manage
  *  each signal set.
  */
-
 typedef uint32_t   rtems_signal_set;
 
-/*
+/**
  *  Return type for ASR Handler
  */
-
 typedef void rtems_asr;
 
-/*
+/**
  *  The following type corresponds to the applications asynchronous
  *  signal processing routine.
  */
-
 typedef rtems_asr ( *rtems_asr_entry )(
                  rtems_signal_set
              );
 
-/*
- *
+/**
  *  The following defines the control structure used to manage
  *  signals.  Each thread has a copy of this record.
  */
-
 typedef struct {
   boolean           is_enabled;       /* are ASRs enabled currently? */
   rtems_asr_entry   handler;          /* address of RTEMS_ASR */
@@ -69,37 +69,69 @@ typedef struct {
  *  be used to compose a signal set.
  */
 
+/** This defines the bit in the signal set associated with signal 0. */
 #define RTEMS_SIGNAL_0    0x00000001
+/** This defines the bit in the signal set associated with signal 1. */
 #define RTEMS_SIGNAL_1    0x00000002
+/** This defines the bit in the signal set associated with signal 2. */
 #define RTEMS_SIGNAL_2    0x00000004
+/** This defines the bit in the signal set associated with signal 3. */
 #define RTEMS_SIGNAL_3    0x00000008
+/** This defines the bit in the signal set associated with signal 4. */
 #define RTEMS_SIGNAL_4    0x00000010
+/** This defines the bit in the signal set associated with signal 5. */
 #define RTEMS_SIGNAL_5    0x00000020
+/** This defines the bit in the signal set associated with signal 6. */
 #define RTEMS_SIGNAL_6    0x00000040
+/** This defines the bit in the signal set associated with signal 7. */
 #define RTEMS_SIGNAL_7    0x00000080
+/** This defines the bit in the signal set associated with signal 8. */
 #define RTEMS_SIGNAL_8    0x00000100
+/** This defines the bit in the signal set associated with signal 9. */
 #define RTEMS_SIGNAL_9    0x00000200
+/** This defines the bit in the signal set associated with signal 10. */
 #define RTEMS_SIGNAL_10   0x00000400
+/** This defines the bit in the signal set associated with signal 11. */
 #define RTEMS_SIGNAL_11   0x00000800
+/** This defines the bit in the signal set associated with signal 12. */
 #define RTEMS_SIGNAL_12   0x00001000
+/** This defines the bit in the signal set associated with signal 13. */
 #define RTEMS_SIGNAL_13   0x00002000
+/** This defines the bit in the signal set associated with signal 14. */
 #define RTEMS_SIGNAL_14   0x00004000
+/** This defines the bit in the signal set associated with signal 15. */
 #define RTEMS_SIGNAL_15   0x00008000
+/** This defines the bit in the signal set associated with signal 16. */
 #define RTEMS_SIGNAL_16   0x00010000
+/** This defines the bit in the signal set associated with signal 17. */
 #define RTEMS_SIGNAL_17   0x00020000
+/** This defines the bit in the signal set associated with signal 18. */
 #define RTEMS_SIGNAL_18   0x00040000
+/** This defines the bit in the signal set associated with signal 19. */
 #define RTEMS_SIGNAL_19   0x00080000
+/** This defines the bit in the signal set associated with signal 20. */
 #define RTEMS_SIGNAL_20   0x00100000
+/** This defines the bit in the signal set associated with signal 21. */
 #define RTEMS_SIGNAL_21   0x00200000
+/** This defines the bit in the signal set associated with signal 22. */
 #define RTEMS_SIGNAL_22   0x00400000
+/** This defines the bit in the signal set associated with signal 23. */
 #define RTEMS_SIGNAL_23   0x00800000
+/** This defines the bit in the signal set associated with signal 24. */
 #define RTEMS_SIGNAL_24   0x01000000
+/** This defines the bit in the signal set associated with signal 25. */
 #define RTEMS_SIGNAL_25   0x02000000
+/** This defines the bit in the signal set associated with signal 26. */
 #define RTEMS_SIGNAL_26   0x04000000
+/** This defines the bit in the signal set associated with signal 27. */
 #define RTEMS_SIGNAL_27   0x08000000
+/** This defines the bit in the signal set associated with signal 28. */
 #define RTEMS_SIGNAL_28   0x10000000
+/** This defines the bit in the signal set associated with signal 29. */
 #define RTEMS_SIGNAL_29   0x20000000
+/** This defines the bit in the signal set associated with signal 30. */
 #define RTEMS_SIGNAL_30   0x40000000
+/** This defines the bit in the signal set associated with signal 31. */
 #define RTEMS_SIGNAL_31   0x80000000
 
 #ifndef __RTEMS_APPLICATION__
@@ -110,5 +142,7 @@ typedef struct {
 }
 #endif
 
+/**@}*/
+
 #endif
 /* end of include file */