From bd9a414f68a5dfa579fd665cc8fdb3cf31a9f181 Mon Sep 17 00:00:00 2001
From: Baptiste Mathus <batmat@batmat.net>
Date: Fri, 11 Jan 2019 22:41:41 +0100
Subject: [PATCH] Give more details about the expected Java version format

---
 core/src/main/java/jenkins/util/java/JavaUtils.java | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/core/src/main/java/jenkins/util/java/JavaUtils.java b/core/src/main/java/jenkins/util/java/JavaUtils.java
index 38a28e72c0..aa0e0084d0 100644
--- a/core/src/main/java/jenkins/util/java/JavaUtils.java
+++ b/core/src/main/java/jenkins/util/java/JavaUtils.java
@@ -65,6 +65,12 @@ public class JavaUtils {
 
     /**
      * Returns the JVM's current version as a {@link String}.
+     * See https://openjdk.java.net/jeps/223 for the expected format.
+     * <ul>
+     *     <li>Until Java 8 included, the expected format should be starting with <code>1.x</code></li>
+     *     <li>Starting with Java 9, cf. JEP-223 linked above, the version got simplified in 9.x, 10.x, etc.</li>
+     * </ul>
+     *
      * @see System#getProperty(String)
      */
     public static String getCurrentRuntimeJavaVersion() {