Update documentation of PostJob extension

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/batch/PostJob.java b/sonar-plugin-api/src/main/java/org/sonar/api/batch/PostJob.java
index 52eff7acc68547839b0378e90078b5b59830d687..a01a83178e0cf68e1c145c1025d1123a7db93374 100644 (file)
--- a/sonar-plugin-api/src/main/java/org/sonar/api/batch/PostJob.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/batch/PostJob.java
@@ -23,11 +23,10 @@ import org.sonar.api.BatchExtension;
 import org.sonar.api.resources.Project;
 
 /**
- * PostJobs are executed when project is analysed.
- * <p/>
- * <p>
- * Note : executed only on root project, not on modules.
- * </p>
+ * PostJobs are executed at the very end of batch analysis. A PostJob can't do any modification
+ * since everything is already computed (issues, measures,...). <br/>
+ * WANRING: Do not rely on the fact that analysis results are available on server side. Even if it is true
+ * for now (synchronous storage) it will become an asynchronous processing on server side in 5.x series.
  *
  * @since 1.10
  */