[core] Update documentation about the parallel execution behavior of …

…the spawning functions.

Signed-off-by: Stéphane Galland <galland@arakhne.org>

main/apiplugins/io.sarl.core/src/io/sarl/core/bic.sarl

@@ -363,6 +363,10 @@ capacity Lifecycle {
 	 * This action must automatically register the newly created agent
 	 * within the default space of the context.
 	 *
+	 * <p>Caution: when this function returns, it replies the UUID of the spawned agent.
+	 * But, there is no warranty that the agent with this id is initialized at the time of the return.
+	 * Indeed, agent spawning is done in parallel to the calling thread.
+	 *
 	 * <p>This function does nothing if one of the following conditions evaluates to true:
 	 * <ul>
 	 * <li>the agent is not alive.</li>
@@ -381,6 +385,10 @@ capacity Lifecycle {
 	 * This action must automatically register the newly created agents
 	 * within the default space of the context.
 	 *
+	 * <p>Caution: when this function returns, it replies the UUIDs of the spawned agents.
+	 * But, there is no warranty that the agents with th ids are initialized at the time of the return.
+	 * Indeed, agent spawning is done in parallel to the calling thread.
+	 *
 	 * <p>This function does nothing if one of the following conditions evaluates to true:
 	 * <ul>
 	 * <li>the agent is not alive.</li>
@@ -399,6 +407,10 @@ capacity Lifecycle {
 	/**
 	 * Spawns a new member agent in the parent's context (parentID).
 	 *
+	 * <p>Caution: when this function returns, it replies the UUID of the spawned agent.
+	 * But, there is no warranty that the agent with this id is initialized at the time of the return.
+	 * Indeed, agent spawning is done in parallel to the calling thread.
+	 *
 	 * <p>This function does nothing if one of the following conditions evaluates to true:
 	 * <ul>
 	 * <li>the agent is not alive.</li>
@@ -415,6 +427,10 @@ capacity Lifecycle {
 	/**
 	 * Spawns a group of agents in the parent's context (parentID).
 	 *
+	 * <p>Caution: when this function returns, it replies the UUIDs of the spawned agents.
+	 * But, there is no warranty that the agents with th ids are initialized at the time of the return.
+	 * Indeed, agent spawning is done in parallel to the calling thread.
+	 *
 	 * <p>This function does nothing if one of the following conditions evaluates to true:
 	 * <ul>
 	 * <li>the agent is not alive.</li>
@@ -434,6 +450,10 @@ capacity Lifecycle {
 	/**
 	 * Spawns a new member agent in the parent's context (parentID).
 	 *
+	 * <p>Caution: when this function returns, it replies the UUID of the spawned agent.
+	 * But, there is no warranty that the agent with this id is initialized at the time of the return.
+	 * Indeed, agent spawning is done in parallel to the calling thread.
+	 *
 	 * <p>This function does nothing if one of the following conditions evaluates to true:
 	 * <ul>
 	 * <li>the agent is not alive.</li>