JDK-8315601 : Add java.vendor.url.bug to list of recognized standard system properties
  • Type: CSR
  • Component: core-libs
  • Sub-Component: java.lang
  • Priority: P4
  • Status: Draft
  • Resolution: Unresolved
  • Fix Versions: tbd
  • Submitted: 2023-09-04
  • Updated: 2024-01-17
Related Reports
CSR :  
Description
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>



Comments
Please change “vendor’s bug tracker” to “vendor bug-reporting” in the text. “vendor” rather than “vendor’s” to match the descriptions of the related properties. “bug-reporting” rather than “tracker” because this is the URL for reporting bugs, not (necessarily) the URL for the vendor’s bug database. The value for Oracle builds, e.g., is "https://bugreport.java.com/bugreport/" rather than "https://bugs.openjdk.org".
06-09-2023