Summary

The java.vendor.url.bug system property will be listed as one of the standard system properties in the documentation of java.lang.System.getProperties() method.

Problem

As noted in https://bugs.openjdk.org/browse/JDK-8232753, the java.vendor.url.bug system property has been defined in every JDK release for a long time now. However, it has never been specified.

Solution

The java.vendor.url.bug will be specified in the documentation of java.lang.System.getProperties() method to return the URL to the Java vendor's bug tracker. This will be a non-optional property, meaning, the value of this system property is expected to be set. There won't be any restrictions on the value of this system property to be a parseable URL.

Specification

diff --git a/src/java.base/share/classes/java/lang/System.java b/src/java.base/share/classes/java/lang/System.java
index e50858b26f1..0dc40733351 100644
--- a/src/java.base/share/classes/java/lang/System.java
+++ b/src/java.base/share/classes/java/lang/System.java
@@ -723,6 +723,8 @@ public static native void arraycopy(Object src,  int  srcPos,
      *     <td>Java Runtime Environment vendor</td></tr>
      * <tr><th scope="row">{@systemProperty java.vendor.url}</th>
      *     <td>Java vendor URL</td></tr>
+     * <tr><th scope="row">{@systemProperty java.vendor.url.bug}</th>
+     *     <td>Java vendor's bug tracker URL</td></tr>
      * <tr><th scope="row">{@systemProperty java.vendor.version}</th>
      *     <td>Java vendor version <em>(optional)</em> </td></tr>
      * <tr><th scope="row">{@systemProperty java.home}</th>