Doc: Kill formating pragma that are unused since 10 years

diff --git a/doc/doxygen/module-msg.doc b/doc/doxygen/module-msg.doc
index eb7312f..67cf686 100644 (file)
--- a/doc/doxygen/module-msg.doc
+++ b/doc/doxygen/module-msg.doc
@@ -53,8 +53,6 @@ details).
     #MSG_function_register (and maybe #MSG_function_register_default)
  -# Launch your processes from a deployment file with #MSG_launch_application
  -# Run the simulation with #MSG_main
     #MSG_function_register (and maybe #MSG_function_register_default)
  -# Launch your processes from a deployment file with #MSG_launch_application
  -# Run the simulation with #MSG_main

-
-@htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Simulation Control" --> @endhtmlonly

 */
 
 /** @defgroup m_process_management Process Management Functions
 */
 
 /** @defgroup m_process_management Process Management Functions


@@ -73,16 +71,12 @@ details).
  *  @brief This section describes the task structure of MSG
  *         (#msg_task_t) and the functions for managing it. See
  *         \ref msg_task_usage to see how to put the tasks in action.
  *  @brief This section describes the task structure of MSG
  *         (#msg_task_t) and the functions for managing it. See
  *         \ref msg_task_usage to see how to put the tasks in action.

- *
- * \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Tasks" --> \endhtmlonly

  */
 
 /** @defgroup msg_mailbox_management Mailbox Management Functions
  *  @ingroup MSG_API
  *  @brief This section describes the mailbox structure of MSG
  *         (#msg_mailbox_t) and the functions for managing it.
  */
 
 /** @defgroup msg_mailbox_management Mailbox Management Functions
  *  @ingroup MSG_API
  *  @brief This section describes the mailbox structure of MSG
  *         (#msg_mailbox_t) and the functions for managing it.

- *
- * \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Mailbox" --> \endhtmlonly

  */
 
 /** @defgroup msg_task_usage Task Actions
  */
 
 /** @defgroup msg_task_usage Task Actions


@@ -135,8 +129,6 @@ details).
 @ingroup MSG_API
 @brief This section describes the functions allowing to build trace-driven simulations.
 
 @ingroup MSG_API
 @brief This section describes the functions allowing to build trace-driven simulations.
 

-\htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Trace-Driven" --> \endhtmlonly
-

 This is very handy when you want to test an algorithm or protocol that
 does nothing unless it receives some events from outside. For example,
 a P2P protocol reacts to requests from the user, but does nothing if
 This is very handy when you want to test an algorithm or protocol that
 does nothing unless it receives some events from outside. For example,
 a P2P protocol reacts to requests from the user, but does nothing if

diff --git a/doc/doxygen/module-sd.doc b/doc/doxygen/module-sd.doc
index 9452029..1a687db 100644 (file)
--- a/doc/doxygen/module-sd.doc
+++ b/doc/doxygen/module-sd.doc
@@ -14,9 +14,7 @@
     @ingroup SD_API
     @brief This section describes the different datatypes provided by SD.
  */
     @ingroup SD_API
     @brief This section describes the different datatypes provided by SD.
  */

-/** @addtogroup SD_datatypes_management
-    \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Data types" --> \endhtmlonly
-*/
+/** @addtogroup SD_datatypes_management */

 /**     \addtogroup SD_workstation_management
         \ingroup SD_API  */
 /**     \addtogroup SD_link_management
 /**     \addtogroup SD_workstation_management
         \ingroup SD_API  */
 /**     \addtogroup SD_link_management

diff --git a/doc/doxygen/module-surf.doc b/doc/doxygen/module-surf.doc
index 80e4652..8587e4e 100644 (file)
--- a/doc/doxygen/module-surf.doc
+++ b/doc/doxygen/module-surf.doc
@@ -85,86 +85,64 @@
 @defgroup SURF_c_bindings   SURF C bindings
 @ingroup SURF_API
 @brief Describes the c bindings of SURF
 @defgroup SURF_c_bindings   SURF C bindings
 @ingroup SURF_API
 @brief Describes the c bindings of SURF

-
-@htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Surf C bindings" --> @endhtmlonly

 */
 
 /**
 @defgroup SURF_interface   SURF Interface
 @ingroup SURF_API
 @brief Describes the general interface for all components (Cpu, Network, Storage, Host, VM)
 */
 
 /**
 @defgroup SURF_interface   SURF Interface
 @ingroup SURF_API
 @brief Describes the general interface for all components (Cpu, Network, Storage, Host, VM)

-
-@htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Surf Interface" --> @endhtmlonly

 */
 
 /**
 @defgroup SURF_routing_interface   SURF Routing Interface
 @ingroup SURF_API
 @brief Describes the routing interface
 */
 
 /**
 @defgroup SURF_routing_interface   SURF Routing Interface
 @ingroup SURF_API
 @brief Describes the routing interface

-
-@htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Surf Routing" --> @endhtmlonly

 */
 
 /**
 @defgroup SURF_cpu_interface   SURF Cpu Interface
 @ingroup SURF_API
 @brief Describes the general Cpu interface for all Cpu implementations
 */
 
 /**
 @defgroup SURF_cpu_interface   SURF Cpu Interface
 @ingroup SURF_API
 @brief Describes the general Cpu interface for all Cpu implementations

-
-@htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Cpu Interface" --> @endhtmlonly

 */
 
 /**
 @defgroup SURF_network_interface   SURF Network Interface
 @ingroup SURF_API
 @brief Describes the general Network interface for all Network implementations
 */
 
 /**
 @defgroup SURF_network_interface   SURF Network Interface
 @ingroup SURF_API
 @brief Describes the general Network interface for all Network implementations

-
-@htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Network Interface" --> @endhtmlonly

 */
 
 /**
 @defgroup SURF_storage_interface   SURF Storage Interface
 @ingroup SURF_API
 @brief Describes the general  interface for all Storage implementations
 */
 
 /**
 @defgroup SURF_storage_interface   SURF Storage Interface
 @ingroup SURF_API
 @brief Describes the general  interface for all Storage implementations

-
-@htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Storage Interface" --> @endhtmlonly

 */
 
 /**
 @defgroup SURF_host_interface   SURF Host Interface
 @ingroup SURF_API
 @brief Describes the general  interface for all Host implementations
 */
 
 /**
 @defgroup SURF_host_interface   SURF Host Interface
 @ingroup SURF_API
 @brief Describes the general  interface for all Host implementations

-
-@htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Host Interface" --> @endhtmlonly

 */
 
 /**
 @defgroup SURF_vm_interface   SURF VM Interface
 @ingroup SURF_API
 @brief Describes the general  interface for all VM implementations
 */
 
 /**
 @defgroup SURF_vm_interface   SURF VM Interface
 @ingroup SURF_API
 @brief Describes the general  interface for all VM implementations

-
-@htmlonly <!-- DOXYGEN_NAVBAR_LABEL="VM Interface" --> @endhtmlonly

 */
 
 /**
 @defgroup SURF_lmm   SURF Linear MaxMin
 @ingroup SURF_API
 @brief Describes how the linear MaxMin system work
 */
 
 /**
 @defgroup SURF_lmm   SURF Linear MaxMin
 @ingroup SURF_API
 @brief Describes how the linear MaxMin system work

-
-@htmlonly <!-- DOXYGEN_NAVBAR_LABEL="SURF Linear MaxMin" --> @endhtmlonly

 */
 
 /**
 @defgroup SURF_callbacks   SURF callbacks
 @ingroup SURF_API
 @brief Describes how to use the SURF callbacks
 */
 
 /**
 @defgroup SURF_callbacks   SURF callbacks
 @ingroup SURF_API
 @brief Describes how to use the SURF callbacks

-
-@htmlonly <!-- DOXYGEN_NAVBAR_LABEL="SURF callbacks" --> @endhtmlonly

 */
 
 /**
 @defgroup SURF_plugin_energy   SURF Energy Plugin
 @ingroup SURF_API
 @brief Describes how to use the energy plugin.
 */
 
 /**
 @defgroup SURF_plugin_energy   SURF Energy Plugin
 @ingroup SURF_API
 @brief Describes how to use the energy plugin.

-
-@htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Energy plugin" --> @endhtmlonly

 */
 */

diff --git a/examples/msg/README b/examples/msg/README
index 81b0b96..5bebc7a 100644 (file)
--- a/examples/msg/README
+++ b/examples/msg/README
@@ -1,3 +1,6 @@
+This file follows the Doxygen syntax to be included in the documentation.
+
+/** 

 MSG comes with an extensive set of examples. It is sometimes difficult
 to find the one you need. This list aims at helping you finding the
 example from which you can learn what you want to.
 MSG comes with an extensive set of examples. It is sometimes difficult
 to find the one you need. This list aims at helping you finding the
 example from which you can learn what you want to.


@@ -133,3 +136,6 @@ Examples of full applications
    constitute a fully working non-trivial example. In addition, its
    implementation is rather efficient, as demonstrated in
    [57]http://hal.inria.fr/inria-00602216/
    constitute a fully working non-trivial example. In addition, its
    implementation is rather efficient, as demonstrated in
    [57]http://hal.inria.fr/inria-00602216/

+
+
+*/
\ No newline at end of file

diff --git a/examples/msg/app-pingpong/app-pingpong.c b/examples/msg/app-pingpong/app-pingpong.c
index 8caacc6..acef93a 100644 (file)
--- a/examples/msg/app-pingpong/app-pingpong.c
+++ b/examples/msg/app-pingpong/app-pingpong.c
@@ -8,6 +8,8 @@
 
 /** @addtogroup MSG_examples
  *
 
 /** @addtogroup MSG_examples
  *

+ *  @example app-pingpong/app-pingpong.c
+ * 

  *  - <b>Ping-Pong: app-pingpong/app-pingpong.c</b>. It's hard to think of a simpler example. The tesh file
  *    laying in the directory is instructive concerning the way to pass options to the simulators (see \ref options).
  */
  *  - <b>Ping-Pong: app-pingpong/app-pingpong.c</b>. It's hard to think of a simpler example. The tesh file
  *    laying in the directory is instructive concerning the way to pass options to the simulators (see \ref options).
  */


@@ -19,14 +21,14 @@ static int pinger(int argc, char *argv[])
   XBT_INFO("Ping -> %s", argv[1]);
   xbt_assert(MSG_host_by_name(argv[1]) != NULL, "Unknown host %s. Stopping Now! ", argv[1]);
 
   XBT_INFO("Ping -> %s", argv[1]);
   xbt_assert(MSG_host_by_name(argv[1]) != NULL, "Unknown host %s. Stopping Now! ", argv[1]);
 

-  /** - Do the ping with a 1-Byte task (latency bound) ... */
+  /* - Do the ping with a 1-Byte task (latency bound) ... */

   double time = MSG_get_clock();
   msg_task_t ping_task = MSG_task_create("small communication (latency bound)", 0.0, 1, NULL);
   ping_task->data = xbt_new(double, 1);
   *(double *) ping_task->data = time;
   MSG_task_send(ping_task, argv[1]);
 
   double time = MSG_get_clock();
   msg_task_t ping_task = MSG_task_create("small communication (latency bound)", 0.0, 1, NULL);
   ping_task->data = xbt_new(double, 1);
   *(double *) ping_task->data = time;
   MSG_task_send(ping_task, argv[1]);
 

-  /** - ... then wait for the (large) pong */
+  /* - ... then wait for the (large) pong */

   msg_task_t pong_task = NULL;
   int a = MSG_task_receive(&pong_task,MSG_host_get_name(MSG_host_self()));
   xbt_assert(a == MSG_OK, "Unexpected behavior");
   msg_task_t pong_task = NULL;
   int a = MSG_task_receive(&pong_task,MSG_host_get_name(MSG_host_self()));
   xbt_assert(a == MSG_OK, "Unexpected behavior");

diff --git a/src/msg/msg_host.cpp b/src/msg/msg_host.cpp
index 63e06ce..917421d 100644 (file)
--- a/src/msg/msg_host.cpp
+++ b/src/msg/msg_host.cpp
@@ -13,7 +13,6 @@
 XBT_LOG_EXTERNAL_DEFAULT_CATEGORY(msg);
 
 /** @addtogroup m_host_management
 XBT_LOG_EXTERNAL_DEFAULT_CATEGORY(msg);
 
 /** @addtogroup m_host_management

- * \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Hosts" --> \endhtmlonly

  * (#msg_host_t) and the functions for managing it.
  *  
  *  A <em>location</em> (or <em>host</em>) is any possible place where  a process may run. Thus it may be represented
  * (#msg_host_t) and the functions for managing it.
  *  
  *  A <em>location</em> (or <em>host</em>) is any possible place where  a process may run. Thus it may be represented

diff --git a/src/msg/msg_io.cpp b/src/msg/msg_io.cpp
index 98c1348..efd19a7 100644 (file)
--- a/src/msg/msg_io.cpp
+++ b/src/msg/msg_io.cpp
@@ -10,7 +10,6 @@
 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(msg_io, msg, "Logging specific to MSG (io)");
 
 /** @addtogroup msg_file_management
 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(msg_io, msg, "Logging specific to MSG (io)");
 
 /** @addtogroup msg_file_management

- * \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Files" --> \endhtmlonly

  * (#msg_file_t) and the functions for managing it.
  *
  *  \see #msg_file_t
  * (#msg_file_t) and the functions for managing it.
  *
  *  \see #msg_file_t


@@ -414,7 +413,6 @@ void __MSG_file_destroy(msg_file_priv_t file) {
 
 /********************************* Storage **************************************/
 /** @addtogroup msg_storage_management
 
 /********************************* Storage **************************************/
 /** @addtogroup msg_storage_management

- * \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Storages" --> \endhtmlonly

  * (#msg_storage_t) and the functions for managing it.
  */
 
  * (#msg_storage_t) and the functions for managing it.
  */
 

diff --git a/src/msg/msg_process.cpp b/src/msg/msg_process.cpp
index 7ddd2c4..51b7929 100644 (file)
--- a/src/msg/msg_process.cpp
+++ b/src/msg/msg_process.cpp
@@ -13,7 +13,6 @@
 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(msg_process, msg, "Logging specific to MSG (process)");
 
 /** @addtogroup m_process_management
 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(msg_process, msg, "Logging specific to MSG (process)");
 
 /** @addtogroup m_process_management

- * \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Processes" --> \endhtmlonly

  *
  *  Processes (#msg_process_t) are independent agents that can do stuff on their own. They are in charge of executing
  *  your code interacting with the simulated world.
  *
  *  Processes (#msg_process_t) are independent agents that can do stuff on their own. They are in charge of executing
  *  your code interacting with the simulated world.