1 files changed, 20 insertions, 35 deletions
diff --git a/cpukit/rtems/inline/rtems/rtems/asr.inl b/cpukit/rtems/inline/rtems/rtems/asr.inl
index bd3b37e060..43bbbea5b5 100644
--- a/cpukit/rtems/inline/rtems/rtems/asr.inl
+++ b/cpukit/rtems/inline/rtems/rtems/asr.inl
@@ -1,12 +1,11 @@
 /**
  * @file rtems/rtems/asr.inl
- */
-
-/*
+ *
  *  This include file contains the implemenation of all routines
  *  associated with the asynchronous signal handler which are inlined.
- *
- *  COPYRIGHT (c) 1989-1999.
+ */
+
+/*  COPYRIGHT (c) 1989-1999.
  *  On-Line Applications Research Corporation (OAR).
  *
  *  The license and distribution terms for this file may be
@@ -21,15 +20,16 @@
 
 #include <rtems/score/isr.h>
 
-/*PAGE
- *
- *  _ASR_Initialize
- *
- *  DESCRIPTION:
+/**
+ *  @addtogroup ClassicASR
+ *  @{
+ */
+
+/**
+ *  @brief ASR_Initialize
  *
  *  This routine initializes the given RTEMS_ASR information record.
  */
-
 RTEMS_INLINE_ROUTINE void _ASR_Initialize (
   ASR_Information *information
 )
@@ -42,17 +42,13 @@ RTEMS_INLINE_ROUTINE void _ASR_Initialize (
   information->nest_level      = 0;
 }
 
-/*PAGE
- *
- *  _ASR_Swap_signals
- *
- *  DESCRIPTION:
+/**
+ *  @brief ASR_Swap_signals
  *
  *  This routine atomically swaps the pending and posted signal
  *  sets.  This is done when the thread alters its mode in such a
  *  way that the RTEMS_ASR disable/enable flag changes.
  */
-
 RTEMS_INLINE_ROUTINE void _ASR_Swap_signals (
   ASR_Information *information
 )
@@ -67,16 +63,12 @@ RTEMS_INLINE_ROUTINE void _ASR_Swap_signals (
   _ISR_Enable( _level );
 }
 
-/*PAGE
- *
- *  _ASR_Is_null_handler
- *
- *  DESCRIPTION:
+/**
+ *  @brief ASR_Is_null_handler
  *
  *  This function returns TRUE if the given asr_handler is NULL and
  *  FALSE otherwise.
  */
-
 RTEMS_INLINE_ROUTINE boolean _ASR_Is_null_handler (
   rtems_asr_entry asr_handler
 )
@@ -84,16 +76,12 @@ RTEMS_INLINE_ROUTINE boolean _ASR_Is_null_handler (
   return asr_handler == NULL;
 }
 
-/*PAGE
- *
- *  _ASR_Are_signals_pending
- *
- *  DESCRIPTION:
+/**
+ *  @brief ASR_Are_signals_pending
  *
  *  This function returns TRUE if there are signals pending in the
  *  given RTEMS_ASR information record and FALSE otherwise.
  */
-
 RTEMS_INLINE_ROUTINE boolean _ASR_Are_signals_pending (
   ASR_Information *information
 )
@@ -101,18 +89,14 @@ RTEMS_INLINE_ROUTINE boolean _ASR_Are_signals_pending (
   return information->signals_posted != 0;
 }
 
-/*PAGE
- *
- *  _ASR_Post_signals
- *
- *  DESCRIPTION:
+/**
+ *  @brief ASR_Post_signals
  *
  *  This routine posts the given signals into the signal_set
  *  passed in.  The result is returned to the user in signal_set.
  *
  *  NOTE:  This must be implemented as a macro.
  */
-
 RTEMS_INLINE_ROUTINE void _ASR_Post_signals(
   rtems_signal_set  signals,
   rtems_signal_set *signal_set
@@ -125,6 +109,7 @@ RTEMS_INLINE_ROUTINE void _ASR_Post_signals(
   _ISR_Enable( _level );
 }
 
+/**@}*/
 
 #endif
 /* end of include file */