Add some Javadocs

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/batch/Decorator.java b/sonar-plugin-api/src/main/java/org/sonar/api/batch/Decorator.java
index 68ff6fb30aca7bbe42007c3e43f7c2ea289ba9c8..f0dc71cec270660c0d336696e256d97daa3784ce 100644 (file)
--- a/sonar-plugin-api/src/main/java/org/sonar/api/batch/Decorator.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/batch/Decorator.java
@@ -27,6 +27,9 @@ import org.sonar.api.resources.Resource;
  */
 public interface Decorator extends BatchExtension, CheckProject {
 
+  /**
+   * @param resource resource that is currently decorated, equivalent of <code>context.getResource()</code>
+   */
   void decorate(Resource resource, DecoratorContext context);
 
 }

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/batch/SonarIndex.java b/sonar-plugin-api/src/main/java/org/sonar/api/batch/SonarIndex.java
index 4d8c033504188e540cd9733cf879f11330dc9660..44cf1a1d901f4e481953a3c0e297e0ca998b189b 100644 (file)
--- a/sonar-plugin-api/src/main/java/org/sonar/api/batch/SonarIndex.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/batch/SonarIndex.java
@@ -100,6 +100,7 @@ public abstract class SonarIndex implements DirectedGraphAccessor<Resource, Depe
   public abstract void setSource(Resource reference, String source) throws DuplicatedSourceException;
 
   /**
+   * @return source code associated with a specified resource, <code>null</code> if not available
    * @since 2.9
    */
   public abstract String getSource(Resource resource);
@@ -124,7 +125,7 @@ public abstract class SonarIndex implements DirectedGraphAccessor<Resource, Depe
 
   /**
    * Returns the violations that match the {@link ViolationQuery} parameters.
-   * 
+   *
    * @since 2.8
    * @param violationQuery
    *          the request parameters specified as a {@link ViolationQuery}
@@ -136,7 +137,7 @@ public abstract class SonarIndex implements DirectedGraphAccessor<Resource, Depe
    * Returns all the active (= non switched-off) violations found on the given resource. Equivalent to
    * {@link #getViolations(ViolationQuery)} called with <code>ViolationQuery.create().forResource(resource).ignoreSwitchedOff(true)</code>
    * as a parameter.
-   * 
+   *
    * @since 2.7
    * @return the list of violations
    */