From: Arnaud Giersch <arnaud.giersch@univ-fcomte.fr>
Date: Fri, 18 Feb 2022 09:32:14 +0000 (+0100)
Subject: Deprecate sg_host_dump.
X-Git-Tag: v3.31~391
X-Git-Url: http://bilbo.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/commitdiff_plain/9aa28f17ea79d17a474e6648b35d3849385a32c6

Deprecate sg_host_dump.

It's unused since the removal of the simdag examples.
---

diff --git a/docs/source/app_s4u.rst b/docs/source/app_s4u.rst
index b1be68449c..666ac3f45b 100644
--- a/docs/source/app_s4u.rst
+++ b/docs/source/app_s4u.rst
@@ -1328,7 +1328,6 @@ Querying info
    .. group-tab:: C
 
       .. doxygenfunction:: sg_host_core_count(const_sg_host_t host)
-      .. doxygenfunction:: sg_host_dump(const_sg_host_t ws)
       .. doxygenfunction:: sg_host_get_name(const_sg_host_t host)
       .. doxygenfunction:: sg_host_get_load(const_sg_host_t host)
       .. doxygenfunction:: sg_host_get_speed(const_sg_host_t host)
diff --git a/include/simgrid/host.h b/include/simgrid/host.h
index 854412d480..8d709566b0 100644
--- a/include/simgrid/host.h
+++ b/include/simgrid/host.h
@@ -114,7 +114,8 @@ XBT_PUBLIC double sg_host_get_route_latency(const_sg_host_t from, const_sg_host_
 XBT_PUBLIC double sg_host_get_route_bandwidth(const_sg_host_t from, const_sg_host_t to);
 XBT_PUBLIC void sg_host_sendto(sg_host_t from, sg_host_t to, double byte_amount);
 
-XBT_PUBLIC void sg_host_dump(const_sg_host_t ws);
+XBT_ATTRIB_DEPRECATED_v335("Please manifest if you actually need this function") XBT_PUBLIC
+    void sg_host_dump(const_sg_host_t ws);
 
 XBT_PUBLIC void sg_host_get_actor_list(const_sg_host_t host, xbt_dynar_t whereto);
 SG_END_DECL
diff --git a/src/s4u/s4u_Host.cpp b/src/s4u/s4u_Host.cpp
index 53d3418baa..f90eba1eab 100644
--- a/src/s4u/s4u_Host.cpp
+++ b/src/s4u/s4u_Host.cpp
@@ -649,7 +649,7 @@ void sg_host_sendto(sg_host_t from, sg_host_t to, double byte_amount)
 }
 
 /** @brief Displays debugging information about a host */
-void sg_host_dump(const_sg_host_t host)
+void sg_host_dump(const_sg_host_t host) // XBT_ATTRIB_DEPRECATED_v335
 {
   XBT_INFO("Displaying host %s", host->get_cname());
   XBT_INFO("  - speed: %.0f", host->get_speed());