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, 29 insertions, 44 deletions

diff --git a/cpukit/rtems/include/rtems/rtems/msgmp.h b/cpukit/rtems/include/rtems/rtems/msgmp.h
index 2b9b41da15..ea9568f639 100644
--- a/cpukit/rtems/include/rtems/rtems/msgmp.h
+++ b/cpukit/rtems/include/rtems/rtems/msgmp.h
@@ -1,12 +1,11 @@
 /**
  * @file rtems/rtems/msgmp.h
- */
-
-/*
+ *
  *  This include file contains all the constants and structures associated
  *  with the Multiprocessing Support in the Message 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
@@ -30,11 +29,17 @@ extern "C" {
 #include <rtems/score/thread.h>
 #include <rtems/score/watchdog.h>
 
-/*
+/**
+ *  @defgroup ClassicMsgMP Classic API Message Queue MP Support
+ *
+ *  This encapsulates functionality which XXX
+ */
+/**{*/
+
+/**
  *  The following enumerated type defines the list of
  *  remote message queue operations.
  */
-
 typedef enum {
   MESSAGE_QUEUE_MP_ANNOUNCE_CREATE             =  0,
   MESSAGE_QUEUE_MP_ANNOUNCE_DELETE             =  1,
@@ -53,11 +58,10 @@ typedef enum {
   MESSAGE_QUEUE_MP_GET_NUMBER_PENDING_RESPONSE = 14
 }   Message_queue_MP_Remote_operations;
 
-/*
+/**
  *  The following data structure defines the packet used to perform
  *  remote message queue operations.
  */
-
 typedef struct {
   rtems_packet_prefix                Prefix;
   Message_queue_MP_Remote_operations operation;
@@ -70,15 +74,12 @@ typedef struct {
   CORE_message_queue_Buffer          Buffer;
 }   Message_queue_MP_Packet;
 
-/*
- *  _Message_queue_MP_Send_process_packet
- *
- *  DESCRIPTION:
+/**
+ *  @brief _Message_queue_MP_Send_process_packet
  *
  *  This routine performs a remote procedure call so that a
  *  process operation can be performed on another node.
  */
-
 void _Message_queue_MP_Send_process_packet (
   Message_queue_MP_Remote_operations operation,
   Objects_Id                         message_queue_id,
@@ -86,15 +87,12 @@ void _Message_queue_MP_Send_process_packet (
   Objects_Id                         proxy_id
 );
 
-/*
- *  _Message_queue_MP_Send_request_packet
- *
- *  DESCRIPTION:
+/**
+ *  @brief _Message_queue_MP_Send_request_packet
  *
  *  This routine performs a remote procedure call so that a
  *  directive operation can be initiated on another node.
  */
-
 rtems_status_code _Message_queue_MP_Send_request_packet (
   Message_queue_MP_Remote_operations  operation,
   Objects_Id                          message_queue_id,
@@ -104,76 +102,63 @@ rtems_status_code _Message_queue_MP_Send_request_packet (
   Watchdog_Interval                   timeout
 );
 
-/*
- *  _Message_queue_MP_Send_response_packet
- *
- *  DESCRIPTION:
+/**
+ *  @brief _Message_queue_MP_Send_response_packet
  *
  *  This routine performs a remote procedure call so that a
  *  directive can be performed on another node.
  */
-
 void _Message_queue_MP_Send_response_packet (
   Message_queue_MP_Remote_operations  operation,
   Objects_Id                          message_queue_id,
   Thread_Control                     *the_thread
 );
 
-/*
- *
- *  _Message_queue_MP_Process_packet
+/**
  *
- *  DESCRIPTION:
+ @brief *  _Message_queue_MP_Process_packet
  *
  *  This routine performs the actions specific to this package for
  *  the request from another node.
  */
-
 void _Message_queue_MP_Process_packet (
   rtems_packet_prefix *the_packet_prefix
 );
 
-/*
- *  _Message_queue_MP_Send_object_was_deleted
- *
- *  DESCRIPTION:
+/**
+ *  @brief _Message_queue_MP_Send_object_was_deleted
  *
  *  This routine is invoked indirectly by the thread queue
  *  when a proxy has been removed from the thread queue and
  *  the remote node must be informed of this.
  */
-
 void _Message_queue_MP_Send_object_was_deleted (
   Thread_Control *the_proxy
 );
 
-/*
- *  _Message_queue_MP_Send_extract_proxy
- *
- *  DESCRIPTION:
+/**
+ *  @brief _Message_queue_MP_Send_extract_proxy
  *
  *  This routine is invoked when a task is deleted and it
  *  has a proxy which must be removed from a thread queue and
  *  the remote node must be informed of this.
  */
-
 void _Message_queue_MP_Send_extract_proxy (
   void           *argument
 );
 
-/*
- *  _Message_queue_MP_Get_packet
- *
- *  DESCRIPTION:
+/**
+ *  @brief _Message_queue_MP_Get_packet
  *
  *  This function is used to obtain a message queue mp packet.
  */
-
 Message_queue_MP_Packet *_Message_queue_MP_Get_packet ( void );
 
 #ifdef __cplusplus
 }
 #endif
 
+/**@}*/
+
 #endif
 /* end of file */