diff --git a/jps/model-api/src/org/jetbrains/jps/model/java/JdkVersionDetector.java b/jps/model-api/src/org/jetbrains/jps/model/java/JdkVersionDetector.java
index 9cca7dc6ea69..b4d2875313c1 100644
--- a/jps/model-api/src/org/jetbrains/jps/model/java/JdkVersionDetector.java
+++ b/jps/model-api/src/org/jetbrains/jps/model/java/JdkVersionDetector.java
@@ -30,6 +30,13 @@ public abstract class JdkVersionDetector {
     return JpsServiceManager.getInstance().getService(JdkVersionDetector.class);
   }
 
+  /**
+   * Returns java version for JDK located at {@code homePath} in format like<br>
+   * <tt>java version "1.8.0_40"</tt><br>
+   * by running '<tt>java -version</tt>' command
+   * @param homePath path to JDK home directory
+   * @return version string of {@code null} if version cannot be determined
+   */
   @Nullable
   public abstract String detectJdkVersion(String homePath);