fix some javadoc

git-svn-id: https://svn.apache.org/repos/asf/sling/trunk@1790204 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/main/java/org/apache/sling/validation/model/spi/ValidationModelRetriever.java b/src/main/java/org/apache/sling/validation/model/spi/ValidationModelRetriever.java
index a3ed0e9..c75822d 100644
--- a/src/main/java/org/apache/sling/validation/model/spi/ValidationModelRetriever.java
+++ b/src/main/java/org/apache/sling/validation/model/spi/ValidationModelRetriever.java
@@ -29,9 +29,10 @@
 public interface ValidationModelRetriever {
     /**
      * A validation model for the given resourceType at the given resourcePath
-     * @param resourceType
+     * @param resourceType the resource type for which to retrieve the model
      * @param resourcePath may be {@code null} or empty
-     * @return a validation model which should be used for validation or null, if no validation model could be found
+     * @param considerResourceSuperTypeModels {@code true} if a merged validation model considering even the models of the super resource types should be returned, otherwise {@code false}
+     * @return a validation model which should be used for validation or {@code null}, if no validation model could be found
      * @throws IllegalStateException in case some error occurred during looking up models
      */
     public @CheckForNull ValidationModel getValidationModel(@Nonnull String resourceType, String resourcePath, boolean considerResourceSuperTypeModels);