Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8216177

Clarify the singleton description in j.t.c.JapaneseEra class

    Details

    • Type: CSR
    • Status: Closed
    • Priority: P2
    • Resolution: Approved
    • Fix Version/s: 12
    • Component/s: core-libs
    • Labels:
      None
    • Subcomponent:
    • Compatibility Risk:
      minimal
    • Compatibility Risk Description:
      This is a clarification only change.
    • Interface Kind:
      Java API
    • Scope:
      SE

      Description

      Summary

      Clarify the language used for the public singleton definition in JapaneseEra class.

      Problem

      With the change to 8212941, the class is now proofed for future JapaneseEra additions without spec changes. However, it is not clear whether the "subsequent versions of this class" refers to a feature release or an update release.

      Solution

      Make it explicit that the singleton additions are intended for future platform releases.

      Specification

      Change the ambiguous sentence in the class description of j.t.c.JapaneseEra as follows:

      @@ -94,7 +94,7 @@
        * dates before Meiji 6, January 1 are not supported.
        * The number of the valid eras may increase, as new eras may be
        * defined by the Japanese government. Once an era is defined,
      - * subsequent versions of this class will add a singleton instance
      + * future versions of the platform may add a singleton instance
        * for it. The defined era is expected to have a consecutive integer
        * associated with it.
        *

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                naoto Naoto Sato
                Reporter:
                naoto Naoto Sato
                Reviewed By:
                Iris Clark, Roger Riggs
              • Votes:
                0 Vote for this issue
                Watchers:
                1 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: