-XBT_PUBLIC(double) sg_host_speed(sg_host_t host);
-XBT_PUBLIC(double) sg_host_get_available_speed(sg_host_t host);
-
-XBT_PUBLIC(int) sg_host_get_nb_pstates(sg_host_t host);
-XBT_PUBLIC(int) sg_host_get_pstate(sg_host_t host);
-XBT_PUBLIC(void) sg_host_set_pstate(sg_host_t host,int pstate);
-XBT_PUBLIC(xbt_dict_t) sg_host_get_properties(sg_host_t host);
-XBT_PUBLIC(const char *) sg_host_get_property_value(sg_host_t host,
- const char *name);
-XBT_PUBLIC(void) sg_host_dump(sg_host_t ws);
-SG_END_DECL()
+/** @brief Return the speed of the processor (in flop/s), regardless of the current load on the machine. */
+XBT_PUBLIC double sg_host_get_speed(const_sg_host_t host);
+XBT_PUBLIC double sg_host_get_pstate_speed(const_sg_host_t host, unsigned long pstate_index);
+
+XBT_PUBLIC double sg_host_get_available_speed(const_sg_host_t host);
+
+XBT_PUBLIC int sg_host_core_count(const_sg_host_t host);
+
+/** @brief Returns the current computation load (in flops per second).
+ * @param host a host
+ */
+XBT_PUBLIC double sg_host_get_load(const_sg_host_t host);
+
+/** @brief Return the location on which the current process is running. */
+XBT_PUBLIC sg_host_t sg_host_self();
+
+XBT_PUBLIC const char* sg_host_self_get_name();
+
+/** @brief Return the total count of pstates defined for a host.
+ *
+ * @beginrst
+ * See also :ref:`plugin_host_energy`.
+ * @endrst
+ *
+ * @param host host to test
+ */
+XBT_PUBLIC unsigned long sg_host_get_nb_pstates(const_sg_host_t host);
+
+XBT_PUBLIC unsigned long sg_host_get_pstate(const_sg_host_t host);
+XBT_PUBLIC void sg_host_set_pstate(sg_host_t host, unsigned long pstate);
+
+XBT_PUBLIC void sg_host_turn_on(sg_host_t host);
+XBT_PUBLIC void sg_host_turn_off(sg_host_t host);
+XBT_PUBLIC int sg_host_is_on(const_sg_host_t host);
+
+/** @ingroup m_host_management
+ * @brief Returns a xbt_dict_t consisting of the list of properties assigned to this host
+ *
+ * @param host a host
+ * @return a dict containing the properties
+ */
+XBT_PUBLIC xbt_dict_t sg_host_get_properties(const_sg_host_t host);
+
+/** @ingroup m_host_management
+ * @brief Returns the value of a given host property
+ *
+ * @param host a host
+ * @param name a property name
+ * @return value of a property (or nullptr if property not set)
+ */
+XBT_PUBLIC const char* sg_host_get_property_value(const_sg_host_t host, const char* name);
+
+/** @ingroup m_host_management
+ * @brief Change the value of a given host property
+ *
+ * @param host a host
+ * @param name a property name
+ * @param value what to change the property to
+ */
+XBT_PUBLIC void sg_host_set_property_value(sg_host_t host, const char* name, const char* value);
+
+XBT_PUBLIC void sg_host_get_route(const_sg_host_t from, const_sg_host_t to, xbt_dynar_t links);
+XBT_PUBLIC double sg_host_get_route_latency(const_sg_host_t from, const_sg_host_t to);
+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_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