JDK-8209032 : Update java.se module summary to reflect removal of java.se.ee module
  • Type: CSR
  • Component: core-libs
  • Priority: P3
  • Status: Closed
  • Resolution: Approved
  • Fix Versions: 11
  • Submitted: 2018-08-06
  • Updated: 2018-08-09
  • Resolved: 2018-08-08
Related Reports
CSR :  
Description
Summary
-------

Update the description of the java.se module summary to reflect the fact that it is the embodiment of the SE API.


Problem
-------

In JDK 10, we had the following module summaries:

    java.base   Defines the foundational APIs of the Java SE Platform
    java.se     Defines the core Java SE API.
    java.se.ee  Defines the full API of the Java SE Platform

The use of the terms "core" and "full" for java.se and java.se.ee may be surprising and potentially confusing.


Solution
--------

Now that the java.se.ee module has been removed, we may describe java.se in the way that most people would have assumed all along:

    java.base  Defines the foundational APIs of the Java SE Platform
    java.se    Defines the API of the Java SE Platform


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

    diff -r 331888ea4a78 src/java.se/share/classes/module-info.java
    --- a/src/java.se/share/classes/module-info.java        Tue Jul 31 14:04:29 2018 -0700
    +++ b/src/java.se/share/classes/module-info.java        Mon Aug 06 
    14:53:37 2018 -0700
    @@ -24,7 +24,7 @@
      */
    
     /**
    - * Defines the core Java SE API.
    + * Defines the API of the Java SE Platform.
      * <P>
      *
      * <dl>


Comments
Moving to Approved.
08-08-2018