-XBT_PUBLIC void simgrid_register_function(const char* name, int (*code)(int, char**));
-XBT_PUBLIC void simgrid_register_default(int (*code)(int, char**));
+/** Run the simulation until the specified date */
+XBT_PUBLIC void simgrid_run_until(double max_date);
+/** Registers the main function of an actor that will be launched from the deployment file */
+XBT_PUBLIC void simgrid_register_function(const char* name, void (*code)(int, char**));
+/** Registers a function as the default main function of actors
+ *
+ * It will be used as fallback when the function requested from the deployment file was not registered.
+ * It is used for trace-based simulations (see examples/cpp/replay-comms and similar).
+ */
+XBT_PUBLIC void simgrid_register_default(void (*code)(int, char**));
+/** Retrieve the simulation time (in seconds) */