-XBT_PUBLIC(double) sg_host_speed(sg_host_t host);
-XBT_PUBLIC(double) sg_host_get_available_speed(sg_host_t host);
-
-XBT_PUBLIC(sg_host_t) sg_host_self();
-XBT_PUBLIC(const char*) sg_host_self_get_name();
-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_route(sg_host_t from, sg_host_t to, xbt_dynar_t links);
-XBT_PUBLIC(double) sg_host_route_latency(sg_host_t from, sg_host_t to);
-XBT_PUBLIC(double) sg_host_route_bandwidth(sg_host_t from, sg_host_t to);
-XBT_PUBLIC(void) sg_host_dump(sg_host_t ws);
+/** @brief Return the speed of the processor (in flop/s), regardless of the current load on the machine. */
+XBT_PUBLIC double sg_host_speed(sg_host_t host);
+XBT_PUBLIC double sg_host_get_pstate_speed(sg_host_t host, int pstate_index);
+
+XBT_PUBLIC double sg_host_get_available_speed(sg_host_t host);
+
+XBT_PUBLIC int sg_host_core_count(sg_host_t host);
+
+/** @brief Returns the current computation load (in flops per second).
+ * @param host a host
+ */
+XBT_PUBLIC double sg_host_load(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. See also @ref plugin_energy.
+ *
+ * @param host host to test
+ */
+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 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(sg_host_t host);
+XBT_ATTRIB_DEPRECATED_v325("Please use !sg_host_is_on()") XBT_PUBLIC int sg_host_is_off(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(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(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_route(sg_host_t from, sg_host_t to, xbt_dynar_t links);
+XBT_PUBLIC double sg_host_route_latency(sg_host_t from, sg_host_t to);
+XBT_PUBLIC double sg_host_route_bandwidth(sg_host_t from, sg_host_t to);
+XBT_PUBLIC void sg_host_dump(sg_host_t ws);
+
+XBT_PUBLIC void sg_host_get_actor_list(sg_host_t host, xbt_dynar_t whereto);