From 80701915842efacf5a40397675b83cd87c9b0184 Mon Sep 17 00:00:00 2001
From: navarro <navarro@caraja.(none)>
Date: Wed, 28 Mar 2012 11:03:16 +0200
Subject: [PATCH] Add a msg deprecated section on API

---
 doc/module-msg.doc      |  9 ++++++++-
 include/msg/datatypes.h |  2 +-
 src/msg/msg_gos.c       | 22 ++++++++++++----------
 3 files changed, 21 insertions(+), 12 deletions(-)

diff --git a/doc/module-msg.doc b/doc/module-msg.doc
index d94fd0d3ce..698d3f3e49 100644
--- a/doc/module-msg.doc
+++ b/doc/module-msg.doc
@@ -20,6 +20,7 @@
    - \ref m_file_management
    - \ref msg_actions_functions
    - \ref msg_gos_functions
+   - \ref msg_deprecated_functions
    - \ref msg_easier_life
    - \ref msg_simulation
 
@@ -68,7 +69,13 @@
  *  @brief This section describes the functions that can be used
  *         by an agent for handling some task.
  */
-
+ 
+/** @defgroup msg_deprecated_functions MSG Deprecated
+ *  @ingroup MSG_API
+ *  @brief This section describes the deprecated functions and. They
+ *	should be remove on next release.
+ */
+ 
 /** @defgroup msg_easier_life      Platform and Application management
  *  @ingroup MSG_API
  *  @brief This section describes functions to manage the platform creation
diff --git a/include/msg/datatypes.h b/include/msg/datatypes.h
index 50b6a669e8..5b171c1273 100644
--- a/include/msg/datatypes.h
+++ b/include/msg/datatypes.h
@@ -122,7 +122,7 @@ typedef struct s_smx_process *m_process_t;
 #ifdef MSG_USE_DEPRECATED
 /* ********************************* Channel ******************************** */
 /** @brief Channel datatype  
-    @ingroup m_datatypes_management 
+    @ingroup msg_deprecated_functions
 
     A <em>channel</em>  is a number and identifies a mailbox type (just as a 
     port number does).
diff --git a/src/msg/msg_gos.c b/src/msg/msg_gos.c
index 2340ac0950..45e9dd460f 100644
--- a/src/msg/msg_gos.c
+++ b/src/msg/msg_gos.c
@@ -920,7 +920,7 @@ const char *MSG_task_get_category (m_task_t task)
 }
 
 #ifdef MSG_USE_DEPRECATED
-/** \ingroup msg_gos_functions
+/** \ingroup msg_deprecated_functions
  *
  * \brief Return the last value returned by a MSG function (except
  * MSG_get_errno...).
@@ -930,7 +930,7 @@ MSG_error_t MSG_get_errno(void)
   return PROCESS_GET_ERRNO();
 }
 
-/** \ingroup msg_gos_functions
+/** \ingroup msg_deprecated_functions
  * \brief Put a task on a channel of an host and waits for the end of the
  * transmission.
  *
@@ -961,7 +961,7 @@ MSG_error_t MSG_task_put(m_task_t task, m_host_t dest, m_channel_t channel)
   return MSG_task_put_with_timeout(task, dest, channel, -1.0);
 }
 
-/** \ingroup msg_gos_functions
+/** \ingroup msg_deprecated_functions
  * \brief Does exactly the same as MSG_task_put but with a bounded transmition
  * rate.
  *
@@ -976,7 +976,9 @@ MSG_task_put_bounded(m_task_t task, m_host_t dest, m_channel_t channel,
   return MSG_task_put(task, dest, channel);
 }
 
-/** \ingroup msg_gos_functions \brief Put a task on a channel of an
+/** \ingroup msg_deprecated_functions
+ *
+ * \brief Put a task on a channel of an
  * host (with a timeout on the waiting of the destination host) and
  * waits for the end of the transmission.
  *
@@ -1019,7 +1021,7 @@ MSG_task_put_with_timeout(m_task_t task, m_host_t dest,
                                    (dest, channel), task, timeout);
 }
 
-/** \ingroup msg_gos_functions
+/** \ingroup msg_deprecated_functions
  * \brief Test whether there is a pending communication on a channel, and who sent it.
  *
  * It takes one parameter.
@@ -1046,7 +1048,7 @@ int MSG_task_probe_from(m_channel_t channel)
   return MSG_process_get_PID(task->simdata->sender);
 }
 
-/** \ingroup msg_gos_functions
+/** \ingroup msg_deprecated_functions
  * \brief Test whether there is a pending communication on a channel.
  *
  * It takes one parameter.
@@ -1067,7 +1069,7 @@ int MSG_task_Iprobe(m_channel_t channel)
                             (MSG_host_self(), channel));
 }
 
-/** \ingroup msg_gos_functions
+/** \ingroup msg_deprecated_functions
 
  * \brief Return the number of tasks waiting to be received on a \a
  channel and sent by \a host.
@@ -1094,7 +1096,7 @@ int MSG_task_probe_from_host(int channel, m_host_t host)
 
 }
 
-/** \ingroup msg_gos_functions
+/** \ingroup msg_deprecated_functions
  * \brief Listen on \a channel and waits for receiving a task from \a host.
  *
  * It takes three parameters.
@@ -1115,7 +1117,7 @@ MSG_task_get_from_host(m_task_t * task, m_channel_t channel, m_host_t host)
   return MSG_task_get_ext(task, channel, -1, host);
 }
 
-/** \ingroup msg_gos_functions
+/** \ingroup msg_deprecated_functions
  * \brief Listen on a channel and wait for receiving a task.
  *
  * It takes two parameters.
@@ -1134,7 +1136,7 @@ MSG_error_t MSG_task_get(m_task_t * task, m_channel_t channel)
   return MSG_task_get_with_timeout(task, channel, -1);
 }
 
-/** \ingroup msg_gos_functions
+/** \ingroup msg_deprecated_functions
  * \brief Listen on a channel and wait for receiving a task with a timeout.
  *
  * It takes three parameters.
-- 
2.20.1