JDK-8222672 : Add @since tag to JapaneseEra.REIWA
  • Type: CSR
  • Component: core-libs
  • Sub-Component: java.time
  • Priority: P3
  • Status: Closed
  • Resolution: Withdrawn
  • Fix Versions: 13
  • Submitted: 2019-04-17
  • Updated: 2019-04-18
  • Resolved: 2019-04-18
Related Reports
CSR :  
Description
Summary
-------

Add `@since` tag for the field `JapaneseEra.REIWA`

Problem
-------

Without a `@since` tag, users would think `JapaneseEra.REIWA` field had been declared public since the class' inception (JDK8).

Solution
--------

Explicitly mention that the field is public since JDK13 with a `@since` tag.

Specification
-------------

Change the field description of `java.time.chrono.JapaneseEra.REIWA` from:

    /**
     * The singleton instance for the 'Reiwa' era (2019-05-01 - )
     * which has the value 3. The end date of this era is not specified, unless
     * the Japanese Government defines it.
     */

to:

    /**
     * The singleton instance for the 'Reiwa' era (2019-05-01 - )
     * which has the value 3. The end date of this era is not specified, unless
     * the Japanese Government defines it.
     *
     * @since 13
     */
Comments
No need for creating a CSR for this simple doc clarification.
18-04-2019